Convert Typewriter Quotes to Typographic Quotes: Difference between revisions

From Scribus Wiki
Jump to navigation Jump to search
Line 38: Line 38:


"""
"""
import scribus
import scribus


Line 95: Line 94:
         scribus.insertText(lead_double, c, textbox)
         scribus.insertText(lead_double, c, textbox)
     elif (ord(char) == 34):
     elif (ord(char) == 34):
         if (prevchar == ' ') or (nextchar != ' '):
         if ((ord(prevchar) == 39) and ((nextchar != ' ') and (nextchar != ',') and (nextchar != '.'))):
            scribus.deleteText(textbox)
            scribus.insertText(lead_double, c, textbox)
 
        elif (prevchar == ' '):
             scribus.deleteText(textbox)
             scribus.deleteText(textbox)
             scribus.insertText(lead_double, c, textbox)
             scribus.insertText(lead_double, c, textbox)
Line 106: Line 109:
         scribus.insertText(lead_single, c, textbox)
         scribus.insertText(lead_single, c, textbox)
     elif (ord(char) == 39):
     elif (ord(char) == 39):
         if (prevchar == ' '):
         if ((ord(prevchar) == 34) and ((nextchar != ' ') and (nextchar != ',') and (nextchar != '.'))):
            scribus.deleteText(textbox)
            scribus.insertText(lead_single, c, textbox)
        elif (prevchar == ' '):
             scribus.deleteText(textbox)
             scribus.deleteText(textbox)
             scribus.insertText(lead_single, c, textbox)
             scribus.insertText(lead_single, c, textbox)

Revision as of 19:41, 29 August 2010

Here is a script in progress at the moment.

I'm posting this now since it does have some functionality, and will at least sometimes, maybe most of the time work. Current language implementations are only English and German, but more will follow, since it's just a matter of adding the lines for codifying lead_double, follow_double, lead_single, and follow_single.

The Logic

This is always an important issue, since regardless of what algorithms you might use, there will be exceptions. In this example script, there is no allowing for maintaining " or ' as something you might want to preserve. In English, I don't think that writing 3' 6" for 3ft 6in or even 3 feet, 6 inches would be preferable anyway, at least when you are wanting to be using typographic quotes. An exception might be for geographical coordinates, but these are uncommon.

The logic here mostly focuses on leading or following spaces, with consideration for the special situations of a quote at the very beginning or end of a frame. There also had to be some adjustments for the beginning or end of a paragraph. At the moment, there is no allowance for nested quotes – single quotes inside doubles, or vice versa, but the problem will likely only be where a single quote sits next to a double, and I think this is fixable though maybe a bit more sophisticated than just using prevchar and nextchar. For single quotes there are contractions to deal with, so an English use approach was used, but I'm not sure that's accurate for German, let alone other languages that might be added. It also will fail for something like 'twas, and needs a fix for a quote between and letter and following comma or period, something which is sometimes done in American English.

This first version also will not track through linked frames, so you'll have to do that manually. One could, of course, change the logic to automatically scan the document for all text frames rather than just operate on the currently selected frame, but I had misgivings about this.

The logic goes something like this:

  • First we check to see if we're on the last character, so that getText doesn't fail on getting the character following the current one, and we can artificially set a nextchar value.
  • After we get the current character we have to check that it isn't a non-printing character that might have a length of 0 or greater than 1. If it is, we skip over it.
  • A double quote that is the first character will be a lead_double
  • A quote preceded by space or not followed by a space will be a lead_double – if you accidentally put double quotes between letters, I'm not sure what's right, but this is something like the situation with a following period or comma.
  • Everything else will be follow_double
  • There is a similar logic for single quotes, except that a single between non-spaces will be a follow_single.
  • The main thing about following periods and commas will be where to put the if statement.

quotes.py

#!/usr/bin/env python
# -*- coding: utf-8 -*-
# File: quotes.py - changes typewriter quotes to typographic quotes
# © 2010.08.28 Gregory Pittman
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
"""
USAGE

You must have a document open, and a text frame selected.
There will be a valueDialog asking for your language for the quotes, 
the default is 'en', but change the default to suit your needs.
Detected errors shut down the script with an appropriate message.

"""
import scribus

if scribus.haveDoc():
    c = 0
    lang = scribus.valueDialog("Choose language", 'Language: en, de are current choices','en')
    if (lang == 'en'):
        lead_double = u"\u201c"
        follow_double = u"\u201d"
        lead_single = u"\u2018"
        follow_single = u"\u2019"
    elif (lang == 'de'):
        lead_double = u"\u201e"
        follow_double = u"\u201c"
        lead_single = u"\u2019"
        follow_single = u"\u201a"
    else:
        scribus.messageBox('Language Error', 'You need to choose an available language', icon=0, button1=1)
        sys.exit(2)
        
else:
    scribus.messageBox('Usage Error', 'You need a Document open', icon=0, button1=1)
    sys.exit(2)

if scribus.selectionCount() == 0:
    scribus.messageBox('Scribus - Usage Error',
        "There is no object selected.\nPlease select a text frame and try again.",
        scribus.ICON_WARNING, scribus.BUTTON_OK)
    sys.exit(2)
if scribus.selectionCount() > 1:
    scribus.messageBox('Scribus - Usage Error',
        "You have more than one object selected.\nPlease select one text frame and try again.", scribus.ICON_WARNING, scribus.BUTTON_OK)
    sys.exit(2)
textbox = scribus.getSelectedObject()
pageitems = scribus.getPageItems()
boxcount = 1
for item in pageitems:
    if (item[0] == textbox):
        if (item[1] != 4):
            scribus.messageBox('Scribus - Usage Error', "This is not a textframe. Try again.", scribus.ICON_WARNING, scribus.BUTTON_OK)
            sys.exit(2)
contents = scribus.getTextLength(textbox)
while c <= (contents -1):
    if ((c + 1) > contents - 1):
        nextchar = ' '
    else:
        scribus.selectText(c+1, 1, textbox)
        nextchar = scribus.getText(textbox)
    scribus.selectText(c, 1, textbox)
    char = scribus.getText(textbox)
    if (len(char) != 1):
        c += 1
        continue
    if ((ord(char) == 34) and (c == 0)):
        scribus.deleteText(textbox)
        scribus.insertText(lead_double, c, textbox)
    elif (ord(char) == 34):
        if ((ord(prevchar) == 39) and ((nextchar != ' ') and (nextchar != ',') and (nextchar != '.'))):
            scribus.deleteText(textbox)
            scribus.insertText(lead_double, c, textbox)

        elif (prevchar == ' '):
            scribus.deleteText(textbox)
            scribus.insertText(lead_double, c, textbox)
        else:
            scribus.deleteText(textbox)
            scribus.insertText(follow_double, c, textbox)
            
    if ((ord(char) == 39) and (c == 0)):
        scribus.deleteText(textbox)
        scribus.insertText(lead_single, c, textbox)
    elif (ord(char) == 39):
        if ((ord(prevchar) == 34) and ((nextchar != ' ') and (nextchar != ',') and (nextchar != '.'))):
            scribus.deleteText(textbox)
            scribus.insertText(lead_single, c, textbox)
        elif (prevchar == ' '):
            scribus.deleteText(textbox)
            scribus.insertText(lead_single, c, textbox)
        else:
            scribus.deleteText(textbox)
            scribus.insertText(follow_single, c, textbox)
            
    c += 1
    prevchar = char

scribus.setRedraw(1)
endmessage = 'Successfully ran script\n Last character read was '+str(char) # Change this message to your liking
scribus.messageBox("Finished", endmessage,icon=0,button1=1)