Difference between revisions of "Semantic markup policy: Version One"

From MarineLives
Jump to: navigation, search
Line 5: Line 5:
 
06/11/12, created by CSG
 
06/11/12, created by CSG
 
----
 
----
'''Purpose of this page'''
+
'''To provide guidelines for the Semantic Markup'''
  
 
This page XXXX
 
This page XXXX
Line 20: Line 20:
 
==Semantic markup policy: Version One==
 
==Semantic markup policy: Version One==
 
----
 
----
===Section X: XXX===
+
===Section 1: General Points to be aware of===
 +
 
 +
'''Whilst marking up appears to be fairly straight forward there have been different views on some issues.  So here is some clarification.'''
 +
1. When marking up it is important to make sure there are no spaces at the beginning and end of the marking up brackets e.g. '''<place>Surrey </place>  It must be <place>Surrey</place>'''
 +
 
 +
2. When words are illegible because they are in the gutter, mark it up as a TO DO rather than a HELP.
 +
 
 +
3. ONLY markup dates, places, occupations, shipps and people.  IF you are not sure of anything write it as a NOTE.
  
 
----
 
----
===Section Y: XXXX===
+
===Section 2: What do we markup?===
 +
 
 +
1. '''Persons''' when they are cited with their name
 +
 
 +
2. '''Places''' (idem: 'London' or 'Callice', forget the 'same place' or similar)
 +
 
 +
3. '''Ships''' – Mark the name of a ship AND men of war AND man of war
 +
Do not include French or Brest or whatever place or name is in front of the men of war.  This can be marked up as a PLACE
 +
Do not include the type of ship e.g. <ship>Fortune, a frigatt</ship> OR the in front of it.
 +
It should be <ship>Fortune</ship>  OR <ship>man of warr</ship>
 +
 
 +
4. '''Occupation''' (normally this is by the name)
 +
 
 +
5. '''Dates''' markup the date and put the numerical value of the date in the  box that appears.  To be consistent it is best if we use hyphens to separate day, month etc.  Whilst we realise that the year may need to be changed in order to order the database a later date, we think this should be done at the editing stage.
 +
 
 +
6.
 +
 
  
 
----
 
----
 
[[Comments(Please leave your comments on using Version One of the semantic markup policy)]]
 
[[Comments(Please leave your comments on using Version One of the semantic markup policy)]]

Revision as of 09:04, November 6, 2012

Semantic markup policy: Version One

Editorial history

06/11/12, created by CSG



To provide guidelines for the Semantic Markup

This page XXXX






Suggested links

Semantic markup policy
Semantic markup general
Transcription & editorial policy



Semantic markup policy: Version One



Section 1: General Points to be aware of


Whilst marking up appears to be fairly straight forward there have been different views on some issues. So here is some clarification.
1. When marking up it is important to make sure there are no spaces at the beginning and end of the marking up brackets e.g. <place>Surrey </place> It must be <place>Surrey</place>

2. When words are illegible because they are in the gutter, mark it up as a TO DO rather than a HELP.

3. ONLY markup dates, places, occupations, shipps and people. IF you are not sure of anything write it as a NOTE.



Section 2: What do we markup?


1. Persons when they are cited with their name

2. Places (idem: 'London' or 'Callice', forget the 'same place' or similar)

3. Ships – Mark the name of a ship AND men of war AND man of war
Do not include French or Brest or whatever place or name is in front of the men of war. This can be marked up as a PLACE
Do not include the type of ship e.g. <ship>Fortune, a frigatt</ship> OR the in front of it.
It should be <ship>Fortune</ship> OR <ship>man of warr</ship>

4. Occupation (normally this is by the name)

5. Dates markup the date and put the numerical value of the date in the box that appears. To be consistent it is best if we use hyphens to separate day, month etc. Whilst we realise that the year may need to be changed in order to order the database a later date, we think this should be done at the editing stage.

6.




Comments(Please leave your comments on using Version One of the semantic markup policy)