Cómo hacer el marcado
Tu nombre
Antes de comenzar, pon tu nombre en el lugar indicado en el encabezamiento TEI (<teiHeader>).
<respStmt>
<resp>Transcripción, marcado y edición</resp>
<name>Tu nombre</name>
</respStmt>
La representación del manuscrito
Las páginas
Usamos el elemento vacío <p/> para indicar el comienzo de cada párrafo. El valor del atributo n indica la paginación.
<pb n="1r"/>
Este elemento puede aparece dentro de un párrafo.
<p>
[...]
quanto estoy de partida p[ar]a la Ciudad de los Reyes y hallar me falto
<pb n="1v"/>
de salud y ser segun me significan los caminos desde aqui a Balparyzo
[...]
</p>
Los párrafos
Usamos <p> para marcar los párrafos. Es recomendable poner cada elemento <p> en su propio renglón.
<p>
Proponen dichos señores, en su memorial ynformando al
Rey los danos y menos cabos que dicho Comercio reconocia
de dia en dia, en sus factorias y navegaciones, no solo de la
Asia, mas tambien de la Africa por las partes de Guinea causados
de los olandeçces, que como poderosos en dhas partes les embarazan
[...]
</p>
Los renglones
Usamos el elemento vacío <lb/> para indicar el lugar donde cada renglón termina en el original.
conque se bive en ellas por cuyo defecto an padecido en ellas<lb/>
tantas y tan continuas calamidades ruynas y sacos de las costase las costas<lb/>
Cuando una palabra está dividida entre dos renglones usamos <lb break="no"/> y ponemos la segunda parte de la palabra justo detrás, sin espacio en medio.
autoridad y menos cabo del Thezoro de la Mag.d Catholica y gran
d<lb break="no"/>es
quibras de su real comercio mayores las podian ezperimentar<lb/>
La documentación de las dudas y las lagunas
Las dudas
Usamos
como puede subzeder naturalmente o por <unclear>desposiccion</unclear>
Las lagunas
Usamos
<gap reason="hay una mancha en el papel"/>
La regularización
La ortografía
Regularizamos la ortografía en lo que no afecta el sonido del texto usando <choice><orig></orig><reg></reg></choice>. (<orig> es la versión original, y <reg> es la versión regularizada.)
<choice><orig>quedava</orig><reg>quedaba</reg></choice>
(Si la regularización cambiaría el sonido, como en el caso de transformar subceder en suceder, dejamos la palabra como está en el original.)
La puntuación
Regularizamos la ortografía en lo que no afecta el sonido del texto usando <choice><orig></orig><reg></reg></choice>.
Para añadir la coma:
<choice><orig/><reg>,</reg></choice>
Para añadir el punto:
<choice><orig/><reg>.</reg></choice>
Para quitar la coma:
<choice><orig>,</orig><reg/></choice>
Para quitar el punto:
<choice><orig>.</orig><reg/></choice>
La abreviaturas
Expandimos las abreviaturas con <choice><abbr></abbr><expan></expan></choice>. (<abbr> es la forma abreviada, y <expan> es la forma expandida.)
<choice><abbr>dha</abbr><expan>dicha</expan></choice>
Cuando hay letras en superíndice, las marcamos con <hi rend="superscript">.
<choice><abbr>p<hi rend="superscript">a</hi></abbr><expan>para</expan></choice>
Se puede regularizar una abreviatura y regularizar la ortografía al mismo tiempo.
<choice><abbr>mag<hi rend="superscript">d</hi></abbr><expan>majestad</expan></choice>
Ver Abreviaturas comunes.
Los errores
Cuando hay un error en el original, usamos <choice><sic></sic><corr></corr></choice>. Un error sería una palabra que está mal escrita incluso para su época, no solo una cuestión de no conformarse a las expectativas modernas (para eso, usamos <choice><orig></orig><reg></reg></choice>.
<choice><sic>Callo</sic><corr>Callao</corr></choice>
<choice><sic>leys</sic><corr>leyes</corr></choice>
El marcado semántico
Los nombres de las personas
Marcamos los nombres de las personas con <name type="person">.
<name type="person">Pedro de Montoya</name>
No incluimos los tratamientos como don dentro de <name>.
don <name type="person">Pedro de Montoya</name>
Los nombres de los lugares
Marcamos los nombres de los lugares con <name type="place">. Dentro de esta categoría incluimos los nombres políticos (de las ciudades, los reinos, etc.):
a <name type="place">Panama</name> ganarle y fortificarle
También marcamos así los nombres geográficos, como de los mares, los estrechos, etc.
Nuebas Embarcasiones ynglesas que pasaron al <name type="place">Mar del Sur</name>
Las fechas
Marcamos las fechas con <date when="YYYY-MM-DD">.
<date when="1671-01-28">enero 28 de 1671</date>
Cuando solo se menciona el año, usamos <date when="YYYY">.
<date when="1671">1671</date>
Nota sobre los errores
Para poderse mostrar en un navegador (Chrome, Firefox, etc.), el archivo XML tiene que estar bien formado y ser válido.
Bien formado significa que cada elemento de apertura tiene un correspondiente elemento de cierre, como el este ejemplo:
<unclear>Eladio</unclear>
El siguiente ejemplo causaría un error, pues falta </unclear>.
<unclear>Eladio
Bien formado también quiere decir que el anidamiento de los elementos es correcto, como en el siguiente ejemplo, en que <unclear> está anidado dentro de <name>:
<name type="person><unclear>Eladio</unclear></name>
El siguiente ejemplo causaría un error, porque </unclear> debería colocarse antes de </name>:
<name type="person><unclear>Eladio</name></unclear>
Válido quiere decir que todos los elementos usados corresponden al estándar TEI. Un error en la ortografía del nombre de un elemento puede ser el problema:
<uclear>
El uso incorrecto de las letras mayúsculas y minúsculas en el nombre de un elemento también resulta en un error, ya que XML distingue entre mayúsculas y minúsculas. El siguiente ejemplo resultaría en un error:
<Unclear>
Si el archivo no está bien formado o no es válido, verás una de las siguientes notificaciones en la barra inferior de la pantalla en VS Code:
Después de arreglar el problema, verás:
Si el archivo es válido, también está bien formado.