Package: txt2tei
TXT2TEIAn aid to encoding plays as XML-TEItxt2teiis a Python script to encode Spanish Siglo de Oro plays as XML-TEI files. It takes a minimally annotated tabular TXT file resembling the printed layout with a reduced set of simple tags. The script speeds up the process of encoding TEI files by automating their annotation, requiring just an (almost) visual edition of the sourceTXT files.These scripts are part of the research projectSound and Meaning in Spanish Golden Age Literature.RequirementsThe programme requires following libraries:BeautifulSoup 4pandasdatetimeunidecodelxml >= 4.9.2chardettxt2tei runs on lxml and tei2txt on BS4. They may be unified in the future though.InstallationDownload the python scripts and the files sexos.csv and authors.xml in the same directory. You can also install it as a pip package, in which case it is not necessary to save the data files in your working directory.pipinstalltxt2teiUseEdit the personalised section of txt2tei.py to suit your needs and run the following commands:./txt2tei.pytabularfile.txtIf installed with pip, the syntax differs:txt2teitabularfile.txtAdditionally, the script tei2txt.py performs the inverse operation./tei2txt.pyxmlteifile.xmlDescriptionThe tabular file must be encoded as UTF-8 Unicode text with LF terminators (Unix encoding). The script will end with error if used on a text with CRLF terminators (DOS encoding) or other exotic encodings. It should be no problem as any respectable editor lets you change  the encoding. Alternatively, there are simple one-liner tools around to convert from one format to another. In any case, the content must follow the following conventions:<x>Comment
<a>Author's name (Just one single word, e.g. Calderón, Lope, Tirso...
<t>Title
<g>Genre

Subgenre
<o>Source*URL
<f>Date
<x> The tag el marks the dramatis personae of  <castList>
<el>DRAMATIS PERSONAE (optional)|CHARACTER 1, a character*CHARACTER 2, another character*CHARACTER 3, a third one*CHARACTER 4, and just one more
<j>Act
<sc>Scene
<i>Stage direction
<x>Comment
CHARACTER ONE
<x>A tabulator marks the speeches
        Verse 1,
        verse 2.
CHARACTER 2
        <i>Internal stage direction
        Verse 3
        verse 4 (beginning)
CHARACTER 1
                Verse 4 (middle)
<x>An additional tab marks the continuation of a shared verse
CHARACTER 3
                        Verse 4 (end)
    verse 5,
    verse 6.
  ...
MUSIC
<e>Echo
CHARACTER 4
        <i>Reads:
<p>Prose
MULTIPLE CHARACTERS #character1 #character2
<x> Instead of letting the programme guess the characters in a collective parlamente, they can be indicated here explicitlyIn order toi assign sexes to the characters, there is a CSV file in the format:NAME,MALE,TrueThe first field is the name, the second the sex, and the third if was manully checked. This can be done with the provided script makelist.pyKnown issuesThe programme only recognises "Calderón", "Lope" and "Calderón (atri.)" as authors. Adding new authors is trivial, as they can just be added to the dictionary authors.Lope's ids are placeholders. Proper numbers should be given.Most important: The programme is aimed to Spanish 17th century plays. The language conventions (e.g., this is an issue concerning sex of collective characters or a shared parlament in which 'Y' will be parsed as 'AND') and structure (versified plays) may need some tinkering to be applied to other kind of plays.ContributionsFeel free to contribute using theGitHub Issue Trackerfor feedback, suggestions, or bug reports.Changelog1.0.6-2Added chardet to dependenciesSolved deprecated 'rU'1.0.6Solved empty date crash.Handling BOM and Hasefroch line terminatorsChangelog markdown syntax1.0.5Solved pronouns-related crashLicenceThis project is under GNU GPL 3. SeeLICENCEfor details.