====== Croatica et Tyrolensia: text encoding guidelines ======
Useful links: [[http://www.tei-c.org/Guidelines/P5/|TEI XML Guidelines]], [[http://oxygenxml.com/|oXygen XML editor]].
===== Preparing text for XML =====
In word processor (e. g. Libre Office, Word):
  - learn the structure of the text
  - use predefined styles for titles (Heading 1, Heading 2 etc)
  - mark page breaks: ''[pb]''
  - avoid automatic numbering etc.

===== Converting from a word processor format to TEI XML =====
In oXygen:
  - open the prepared .odt file (it will be imported as an archive and opened in the left-hand pane)
  - in the left-hand pane, select ''content.xml'' file icon and name, double-click on it
  - click "Continue" on any warnings that will appear
  - select a Transformation scenario for the file that will open: either click on the wrench icon near the red triangle on the tool bar, or select ''Document / Transformation / Configure Transformation Scenario(s)'' from the menu bar
  - in the Scenario list, select the ODT TEI P5 predefined scenario (it is on top of the list)
  - select the ''Apply Associated'' button

===== Preparing the TEI Header =====
  - ''fileDesc'' element contains the ''xml:id'' attribute containing last name of author, first letter of the first name, and name of the work, separated by hyphens: ''rogacic-b-euthym''; this will be, at the same time, the name of XML file
  - ''title'' element contains name of the work, in Latin, with //versio electronica// added
  - ''author'' has the ''key'' attribute with author's unique ID (if there are several authors, each gets a separate ''author'' element
  - inside the ''author'' element is a ''name'' element listing (in ''xml:lang'') the language in which the name is given (in the form ''Lastname, Firstname'')
  - the ''author'' element also contains a ''date'', with author's years of birth, death, or floruit
  - ''editor'' field lists the editor
  - ''respStmt'' fields list the editor of the digital version and all transcribers (''resp'' describes the responsibility, ''name'' contains ''Firstname Lastname''); if necessary, persons can have the ''xml:id'' to be referred to when any changes to the text are noted (corrections, sic etc)
  - in the ''editionStmt'' field we note what was the basis for the electronic edition
  - the ''publicationStmt''
===== Editing XML =====