Difference between revisions of "Mondrian: Decisions during eDITem project"

From XML
Jump to: navigation, search
Line 38: Line 38:
 
We display salutation always full left, beneath the date/place after a white line and the first line of the letter immediately below the salutation, set full left.
 
We display salutation always full left, beneath the date/place after a white line and the first line of the letter immediately below the salutation, set full left.
  
−
'''Paragraphs''' are indented except for the first line of the letter text and after a white line.
+
 
 +
'''Paragraphs''" are indented except for the first line of the letter text and after a white line.
 +
 
  
 
'''Postscripts''' are shown after the signature and after one white line.
 
'''Postscripts''' are shown after the signature and after one white line.
 +
  
 
'''Superscript''' encoded as @rend='super'. @underline, when combined with superscript, removed in the site, but kept in the xml.   
 
'''Superscript''' encoded as @rend='super'. @underline, when combined with superscript, removed in the site, but kept in the xml.   
Line 46: Line 49:
  
 
Unusual abbreviations: to be coded as <choice><abbr><expan>. The usual abbreviations will be described in a list.
 
Unusual abbreviations: to be coded as <choice><abbr><expan>. The usual abbreviations will be described in a list.
 +
  
 
'''White lines:''' keep them in xml as they are encoded (vertical spaces) and display them as one white line when they occur within the body of the letters. After <opener> use the @rend=“norend” encoding. (The @rend=“norend” will be added through a stylesheet)
 
'''White lines:''' keep them in xml as they are encoded (vertical spaces) and display them as one white line when they occur within the body of the letters. After <opener> use the @rend=“norend” encoding. (The @rend=“norend” will be added through a stylesheet)
 +
  
 
'''Quotation marks:''' still under discussion.
 
'''Quotation marks:''' still under discussion.
 +
  
 
'''Comma and full stop:''' to be encoded with <orig> and <reg>  
 
'''Comma and full stop:''' to be encoded with <orig> and <reg>  
 +
  
 
'''Single underlining:''' encode as underlined and display in italics  
 
'''Single underlining:''' encode as underlined and display in italics  
 +
  
 
'''Multiple underlining:''' encode as multiple underlined and display in italics. Annotation when the underlining have a specific meaning.
 
'''Multiple underlining:''' encode as multiple underlined and display in italics. Annotation when the underlining have a specific meaning.
 +
  
 
'''Atypical writing, combinations, repeated quotes, quotations, lines and dots:''' not relevant or not present
 
'''Atypical writing, combinations, repeated quotes, quotations, lines and dots:''' not relevant or not present
 +
  
 
'''Parentheses:''' all parentheses are typed as written
 
'''Parentheses:''' all parentheses are typed as written
 +
  
 
'''Uncertainties:''' encode with <choice><unclear><unclear>.  
 
'''Uncertainties:''' encode with <choice><unclear><unclear>.  
 
Display content of first unclear element. (Perhaps visualise with mouse-over).
 
Display content of first unclear element. (Perhaps visualise with mouse-over).
 +
  
 
'''Additions in margins:''' encode with <add> and @place with values: “left margin” “right margin” “bottom margin” “top margin”  
 
'''Additions in margins:''' encode with <add> and @place with values: “left margin” “right margin” “bottom margin” “top margin”  
 +
  
 
'''Metamark''' coded as <metamark/>
 
'''Metamark''' coded as <metamark/>
 +
  
 
'''Appendices:''' encode as a separated division with @type="appendix", and a new <pb/>
 
'''Appendices:''' encode as a separated division with @type="appendix", and a new <pb/>
Line 72: Line 86:
 
We make explicit what is preprinted or pre-written by using the @rend with "preprinted" or "prewritten" values.  
 
We make explicit what is preprinted or pre-written by using the @rend with "preprinted" or "prewritten" values.  
 
We do that only when Mondrian fill in preprinted/prewritten address or forms and not for fixed parts of the letters (as letterheads).
 
We do that only when Mondrian fill in preprinted/prewritten address or forms and not for fixed parts of the letters (as letterheads).
 +
  
 
'''Table:''' encode as such when they occur (with <table>, <row> and <cell>).
 
'''Table:''' encode as such when they occur (with <table>, <row> and <cell>).
 +
 +
----
 +
  
 
'''Introductions:''' not provided at this stage: most of the letters don’t require introduction and when pieces of information are needed, they are provided within annotation. This point could be discuss again in the future.
 
'''Introductions:''' not provided at this stage: most of the letters don’t require introduction and when pieces of information are needed, they are provided within annotation. This point could be discuss again in the future.
 +
 +
----
  
 
   
 
   
Line 93: Line 113:
  
 
'''Refer to a portion of the letter''': we do this at a paragraph level, using <ref> and de paragraph id and adding the text "par. nn": (<ref target="#p.nl.1 #p.en.1">par. 1</ref>)
 
'''Refer to a portion of the letter''': we do this at a paragraph level, using <ref> and de paragraph id and adding the text "par. nn": (<ref target="#p.nl.1 #p.en.1">par. 1</ref>)
 +
 +
 
'''Pointing from the notes to text''': we decided to point to both the original and the translated text.
 
'''Pointing from the notes to text''': we decided to point to both the original and the translated text.
  

Revision as of 15:59, 24 August 2023


These are decisions taken during the eDITem project that have to be worked into the rest of the documentation. For the moment, we document them here.


We will not be using sic and corr, but orig and reg. We move the @type from the sic to the reg (not to the orig: not allowed).


Organizations:

We create a separated .xml file for organizations. In the text we use the following encoding: <rs type="org" ref="org.xml#xxx">

Sample of the Organizations file: 

  -listOrg
       org
         @ana (value: museum, gallery, artistassoc, firm, org) and @xml:id 
        orgName
        place
        country 
        settlement
        desc

Layout:

For now we regularise layout of postcards the way we do letters.


We display date/place always full left, on a single line, followed by one white line. We change the current encoding for address and date in dateline (to be added by a stylesheet):

<opener> 

  <dateline> … </dateline>
  <salute> … </salute>

</opener>


We display salutation always full left, beneath the date/place after a white line and the first line of the letter immediately below the salutation, set full left.


'Paragraphs" are indented except for the first line of the letter text and after a white line.


Postscripts are shown after the signature and after one white line.


Superscript encoded as @rend='super'. @underline, when combined with superscript, removed in the site, but kept in the xml.


Unusual abbreviations: to be coded as <choice><expan>. The usual abbreviations will be described in a list.


White lines: keep them in xml as they are encoded (vertical spaces) and display them as one white line when they occur within the body of the letters. After <opener> use the @rend=“norend” encoding. (The @rend=“norend” will be added through a stylesheet)


Quotation marks: still under discussion.


Comma and full stop: to be encoded with <orig> and <reg>


Single underlining: encode as underlined and display in italics


Multiple underlining: encode as multiple underlined and display in italics. Annotation when the underlining have a specific meaning.


Atypical writing, combinations, repeated quotes, quotations, lines and dots: not relevant or not present


Parentheses: all parentheses are typed as written


Uncertainties: encode with <choice><unclear><unclear>. Display content of first unclear element. (Perhaps visualise with mouse-over).


Additions in margins: encode with <add> and @place with values: “left margin” “right margin” “bottom margin” “top margin”


Metamark coded as <metamark/>


Appendices: encode as a separated division with @type="appendix", and a new <pb/>

We make explicit what is preprinted or pre-written by using the @rend with "preprinted" or "prewritten" values. We do that only when Mondrian fill in preprinted/prewritten address or forms and not for fixed parts of the letters (as letterheads).


Table: encode as such when they occur (with , <row> and <cell>).


Introductions: not provided at this stage: most of the letters don’t require introduction and when pieces of information are needed, they are provided within annotation. This point could be discuss again in the future.


We will make the XML freely available for users If Steering Committee agrees.


lb and hyphens: to be removed anywhere by a stylesheet.


Nationality: we decided to add (one or more) <nationality> for each person in the bio.xml file, before the date of birth: 


                   <persName><forename>xxx</forename> <surname>xxx</surname></persName>
                   <nationality from="xxxx" to="yyyy"></nationality>
                   <nationality from="xxxx" to="yyyy"></nationality>
                   <birth when="xxxx">

Refer to a portion of the letter: we do this at a paragraph level, using <ref> and de paragraph id and adding the text "par. nn": (<ref target="#p.nl.1 #p.en.1">par. 1</ref>)


Pointing from the notes to text: we decided to point to both the original and the translated text.


rs type=person' used (with type and ref attribute) also for names that occur in the opener, also with abbreviation: ex. when we have D.A. we encode D.<rs type="person" ref="#bio.xml#xxxx">A.</rs>


In case of letters with mutiple authors (co-signed by Mondrian), use multiple <rs> element (with @ref and @type=person) in <correspAction type=’sent’>

Retrieved from "https://xml.huygens.knaw.nl/index.php?title=Mondrian:_Decisions_during_eDITem_project&oldid=740"