wiki:HarriotConventions

Version 3 (modified by Klaus Thoden, 11 years ago) (diff)

--

Harriot online conventions taken from trunk/texts/Harriot/Documents

xml-conventions

  • [ ] The name of the div containing the one manuscript bundle is

"bundle"

  • [ ] No further divs used

Tags and keys used

TRANSLATIONS

  • [ ] always semantic-unit-wise, i.e. put into <s></s>,

<h></h>

  • [ ] always put within <t> </t>

COMMENTARY

  • [ ] semantic-unit-wise
    • [ ] put <sc> </sc> within <s> </s> or <h> </h>; put

it right after the <s> or <h>, respectively!

  • [ ] paragraph-wise
    • [ ] put <pc> </pc> within <p> </p> but outside of all

<s> </s>; put it right after the <p>!

  • [ ] page-wise
    • [ ] put <c> </c> after <pb/>
  • [ ] If a commentary relates to a part on the folio where

there is nothing to be transcribed, insert an editorial insertion <emph style="edins"></emph> and attach the commentary to it.

  • [ ] <head></head> headings
  • [ ] <lb/> line breaks
  • [ ] <p></p> paragraphs
  • [ ] <s></s> semantic unit
  • [ ] xml:lang="lat" Latin text (within <p>, <s> tags, if

applying to single words, use the <foreign> tag)

  • [ ] <unsure>within space</unsure> (should come out as [¬ø]

within space ?)

  • [ ] <illegible/> for illegible passages (should come out as

???)

  • [ ] <omission/> for left out passages (should come out as [‚Ķ])
  • [ ] <emph style="st"></emph> for deletions
  • [ ] <emph style="ins"></emph> for insertions
  • [ ] <emph style="super"></emph> for superscripts
  • [ ] <emph style="edins"></emph> for editor's insertions

(should come out as [editor's completion])

  • [ ] &amp; for &
  • [ ] &lt; for <
  • [ ] &gt; for >
  • [ ] &apos; for '
  • [ ] &quot; for "
  • [ ] <mml:mi></mml:mi> for marking
  • [ ] $ /$ for algebraic symbols (variables in a text)
  • [ ] <num value="5">five</num> for transcribing five (or v or

V etc.)

  • [ ] <reg norm="tempus" type="abbr">temp.</reg> for

regularisations (here temp. = abbreviation fortempus) use only abbr (for abbreviations) and typo (for misspellings)

  • [ ] No lb/ needed at end of paragraph
  • [ ] space before lb/ needed within a semantic unit (so that the

space is seen when linebreaks are not displayed)

  • [ ] space before end of semantic unit should actually always be

entered, because it is most often needed.

MATH TRANSCRIPTION

  • [ ] LaTeX math environment can be used which is then converted

to MathML (http://www.w3.org/TR/MathML3/)

Transcription

  • [ ] Numbers in the text are transcribed with commata.
  • [ ] y for th is transcribed as th
  • [ ] Proportions are transcribed as a , b : c , d
  • [ ] Arrangement entangling many proportions may be transcribed as

several proportions

  • [ ] Calculations (+ - * /) are transcribed in $ /$ environment
  • [ ] ye for the etc.
  • [ ] For Latin: tildes, crosses, are expanded, ae is written as a

ligature

  • [ ] Open questions

Maps

Colours to be used with specific topics

  1. Notes, letters, correspondence: (Orange Red, #99330)
  2. Sources: (Purple, #800080)
  3. Arithmetic: (Red, #FF0000)
  4. Combinations: (Blue, #0000FF)
  5. Algebra: (Green, #008000)
  6. Geometry: (Green yellow, #99CC00)
  7. Navigation: (Light blue, #3366FF)
  8. Mechanics: (Grey, #808080)
  9. Optics: (Cyan, #33CCCC)
  10. Astronomy: (Dark blue, #000080)
  11. Alchemy: (Orange yellow, #FFCC00)