Documentaci贸n

Presentaci贸n

Las categor铆as que utiliza la Biblioteca Digital del Pensamiento Novohispano son una aplicaci贸n espec铆fica de la versi贸n TEI Lite que se encuentra en esta direcci贸n: http://www.tei-c.org/Guidelines/Customization/Lite/teiu5_split_en.html.

La decisi贸n de utilizar esta versi贸n de TEI y no la m谩s amplia que ofrece la Text Encoding Iniciative se bas贸 en dos razones. Primero, presenta una versi贸n simplificada de TEI aplicable en su totalidad a las necesidades de la biblioteca. Y, dos, lo hace de tal manera que ilustra el procedimiento de marcado de texto con la suficiente claridad para ser seguido por quienes carecen de la experiencia suficiente en el uso de TEI y en el procedimiento de marcado. Su estructura abierta y la facilidad para agregar distintos tipos de atributos a las categor铆as, facilitan la generaci贸n de las variantes necesarias para marcar pr谩cticamente todo lo que dese谩bamos en el texto.

En la primera parte de este documento se encontrar谩n explicados los elementos de TEI y de TEI Lite que se utilizan en la Biblioteca. En la segunda parte, se describen los atributos creados para marcar palabras o funciones espec铆ficas dentro de los textos de la biblioteca.

Elementos TEI y TEI Lite

El marcado de cualquier texto de la biblioteca comienza con la declaraci贸n de que es un documento TEI en espa帽ol utilizando la siguiente referencia:

  • <TEI xmlns="http://www.tei-c.org/ns/1.0" xmlns:rng="http://relaxng.org/ns/structure/1.0" xml:lang="es">

1.- Schema

A continuaci贸n se debe agregar el esquema que servir谩 para validar el documento en XML. Respecto a las funciones y caracter铆sticas del schema, puede verse: http://www.tei-c.org/release/doc/tei-p5-doc/en/html/ST.html#STIN

En la Biblioteca utilizamos el esquema 鈥淭EI-minimal", que cubre por completo las categor铆as que utiliza TEI Lite.

  • <schemaSpec ident="TEI-minimal" start="TEI">
  • <moduleRef key="tei"/>
  • <moduleRef key="header"/>
  • <moduleRef key="core"/>
  • <moduleRef key="textstructure"/>
  • <moduleRef key="namesdates"/>
  • </schemaSpec>

2.- TEI Header

A continuaci贸n del esquema aparece el TEI Header. Respecto a las funciones y cualidades del TEI Header puede verse http://www.tei-c.org/release/doc/tei-p5-doc/en/html/HD.html.

El Header que presentamos a continuaci贸n corresponde al utilizado en la Especulaci贸n Astrol贸gica y F铆sica

  • <teiHeader>
  • <fileDesc>
  • <titleStmt>
  • <title>ESPECULACION ASTROLOGICA, Y PHYSICA DE LA NATURALEZA DE LOS COMETAS, Y JUIZIO DEL QUE ESTE A帽o de 1682 Se v猫 en todo el Mundo.</title>
  • <author>Gaspar Juan Evelino</author>
  • </titleStmt>
  • <publicationStmt>
  • <publisher>Universidad Nacional Aut贸noma de M茅xico. Facultad de Filosof铆a y Letras</publisher>
  • <distributor>Biblioteca Digital del Pensamiento Novohispano</distributor>
  • <respStmt>
  • <name>Ernesto Priani Sais贸</name>
  • <resp>Marcado XML/TEI</resp>
  • </respStmt>
  • <respStmt>
  • <name>Al铆 Mart铆nez Albarran</name>
  • <resp>Transcripci贸n</resp>
  • </respStmt>
  • </publicationStmt>
  • <sourceDesc>
  • <bibl>ESPECULACION
  • ASTROLOGICA, Y PHYSICA DE LA NATURALEZA DE LOS COMETAS, Y JUIZIO DEL QUE ESTE A de 1682 Se v猫 en todo el Mundo
  • Por Gaspar Juan Evelino (Por la Viuda de Bernardo Calderon, 1682.)</bibl>
  • </sourceDesc>
  • </fileDesc>
  • </teiHeader>

Las categor铆as utilizadas dentro del Header son las siguientes:

  • <teiHeader></teiHeader> Declara que se trata del encabezado del documento.
  • <fileDesc> </fileDesc> Declara el inicio de la descripci贸n del documento.
  • <titleStmt></titleStmt> (title statement). Declara el grupo de informaci贸n sobre el t铆tulo de la obra y quienes son los responsables de su contenido intelectual.
  • <title></title> Declara que es el t铆tulo de la obra. S贸lo se utiliza en el caso del t铆tulo de la obra marcada, y no en el del resto de t铆tulos de obras evocados dentro de la obra. Para ellos se utiliza la categor铆a refTitle></1title>
  • <author></author> Declara al autor de la obra. S贸lo se usa en el caso del autor de la obra marcada.
  • <publicationStmt></publicationStmt> (publication statement) Declara el grupo de informaci贸n sobre la publicaci贸n de la obra marcada y tanto a su publicaci贸n electr贸nica como a su fuente impresa.
  • <publisher></publisher> Se refiere a qui茅n publica la obra electr贸nica. En todos los casos ser谩 la Universidad Nacional Aut贸noma de M茅xico. Facultad de Filosof铆a y Letras
  • <distributor></distributor> Se refiere al distribuidor de la obra. En este caso ser谩 siempre la Biblioteca Digital del Pensamiento Novohispano.
  • <respStmt></respStmt> Establece una responsabilidad en la publicaci贸n.
  • <name></name> Establece el nombre del responsable
  • <resp></resp> Establece la responsabilidad
  • <sourceDesc></sourceDesc> Se refiere a la descripci贸n de la fuente impresa del texto marcado.
  • <bibl></bibl> Corresponde a la referencia bibliogr谩fica del texto marcado. Debe ir toda la ficha catalogr谩fica del texto鈥

3.- Marcado del texto

Para marcar el texto se utilizan las siguientes categor铆as, que encontraremos en el siguiente orden.

a) El texto <text></text> Declara el inicio y el fin de el texto marcado.

b) La portada <front></front> Declara que lo que sigue corresponde a la portada o frente del documento impreso.

<titlePage></titlePage> Declara que se trata de la p谩gina de titulo, que puede corresponder a la portada del texto.

<docTitle></docTitle> Marca el t铆tulo del documento marcado en la portada.

<docImprint><docImprint> Declara el lugar y el impresor del texto.

<docDate></docDate> Marca la fecha del texto.

c) El cuerpo del documento

<body></body> Corresponde al cuerpo del texto. Abre y cierra la totalidad de este.

<p></p> Es una categor铆a central. Marca el inicio y el final de cada p谩rrafo. En lo documentos de la biblioteca, cuando los p谩rrafos no cierran en la p谩gina sino que contin煤a en la siguiente, debe cerrarse el p谩rrafo al terminar la p谩gina, justo antes de </div> y abrirse de nuevo en la siguiente, despu茅s de <div>.

<div></div> declara el inicio de una divisi贸n. En la biblioteca se utiliza para establecer el inicio y el final de un folio. El folio es, junto con el p谩rrafo, la unidad de referencia de los textos de la biblioteca.

<term></term> Marca una palabra, varias palabras, una designaci贸n simb贸lica o el uso de un t茅rmino t茅cnico. Es una categor铆a de marcado central, porque permite identificar cierto tipo de palabras y expresiones en el texto cuyo estudio y recuperaci贸n es relevante. Acepta 7 atributos Type: M茅dico (Med), Astrol贸gico (Astro) Astron贸mico (Astron), Filos贸fico (Philo), Matem谩tico (Mathe), Theol贸gico (Theolo) y Espa帽ol antiguo (OldSp). En todos los caso, se puede incluir un 鈥渞eg" para unificar los t茅rminos a partir de la ortograf铆a moderna. Esto es especialmente importante en el caso de las palabras en espa帽ol antiguo, donde el uso del 鈥渞eg" es obligatorio.

Ejemplos:

  • <term type="astro" Reg="Juicio">juizio</term>
  • <term type="astro" Reg="Ven茅reo">Venereo</term>
  • <term type="med">peste</term> (No utiliza 鈥渞eg" porque no es necesario estandarizar la ortograf铆a de la palabra)

<foreign></foreign> Identifica t茅rminos o grupos de t茅rminos en un idioma diferente al de la redacci贸n del texto. Acepta el atributo lang (Idioma). Para el idioma que m谩s aparece, el lat铆n, se utiliza el atributo lat.

Ejemplo:

  • <foreign lang="lat">Laus Deo</foreign>

<date></date> Sirve para marcar una fecha. Se marca s贸lo el a帽o en numeral, cuando aparecen expresiones como "a帽o del se帽or de 1654" o "el a帽o de 1204". Cuando en el texto se hace una referencia si expresarla en numeral como: 鈥渆l a帽o pasado", 鈥渉ace dos a帽os", se marcar谩 la expresi贸n completa como fecha, pero deber谩 incluirse un 鈥渞eg", para fijar el a帽o en numeral. Cuando la expresi贸n de la fecha indique d铆a y mes, o d铆a, mes y a帽o, mes y a帽o, se incluyen todos estos elementos.

Ejemplos:

  • Este a帽o de <date>1682</date>
  • 鈥帽o del Se帽or de <date>396</date>

Como la gran mayor铆a de los cometas son nombrados por la fecha en que pasan. Utilizaremos 鈥渢ype" y 鈥渃omet" para se帽alar que se trata de un cometa.

Ejemplos:

  • como el del a帽o del se帽or de <date type="comet">396</date>

<abbr></abbr>Marca una abreviatura. La abreviaturas no se regularizan ni se expanden en el marcado es decir, se etiqueta la abreviatura tal cual est谩 en el texto:

  • <abbr>Vmd.</abbr>
  • <abbr>N.S.R.E.</abbr>

<pb></pb> Marca el numeral del folio o el n煤mero de p谩gina, si existe.

<name></name> Marca los nombres propios de personas, dioses, lugares acepta el uso del atributo 鈥渢ype" con los siguientes elementos: person (persona); planet (Planeta); god (Dios); place (lugar); inst (instituci贸n); constelation (Constelaci贸n); zodiacal (Signo del zodiaco); CathDiv (Divinidad cat贸lica) Utiliza 鈥渞eg" para estandarizar el nombre a su uso contempor谩neo.

Ejemplos:

  • <name type="person" reg="Arist贸teles">Aristoteles</name>
  • <name type="constelation"">Capricorno</name>
  • <name type="planet">Saturno</name> En todos los casos se marcan como planeta Luna y Sol, adem谩s del resto de los planetas mencionados
  • <name type="place" reg="Holanda">Olanda</name>

<q></q> Identifica las citas textuales dentro de los textos, en las que no aparece la referencia bibliogr谩fica. Deben colocarse al iniciar y al terminar la cita.

<cit></cit> Se utiliza para citas textuales claramente identificadas con su referencia bibliogr谩fica.

<refTitle></refTitle> Se utiliza para marcar el titulo de una obra dentro de un texto. Acepta reg para estandarizar el nombre moderno de la obra.

<head></head> Se usa para identificar subtitulos en la obra.

Definici贸n del uso atributos

4.- Atributos de las etiquetas

Reg: sirve para regularizar los nombres o los t茅rminos. Se utiliza tambi茅n en los siguientes casos.

  1. Cuando se marca una palabra que est谩 cortada en el texto (Por ejemplo: Agus- t铆n) debe incluirse 鈥渞eg" y en 茅l debe ponerse entre comillas, el nombre completo sin corte.
  2. Cuando las citas rebasen un rengl贸n hay que incluir 鈥渞eg" y en 茅l poner la cita completa de la forma como deber谩 aparecer al recuperar la informaci贸n.
  3. Los reg de los t茅rminos en plural van en singular

Type: establece atributos espec铆ficos para termino o una palabra y se utiliza para identificar con m谩s precisi贸n que clase de nombre o t茅rmino es el que se ha marcado. Ver ejemplo de usos en los casos de nonbres y t茅rminos.

5.- Estandarizaci贸n de nombres

Para la estandarizaci贸n de nombres estamos siguiendo estos criterios:

Nombres propios:

Apellido y nombre. Los "de", "von" etc... van entre par茅ntesis despu茅s del apellido. Si se trata de santos, el san se coloca antes del nombre. Se utilizar谩 siempre la ortograf铆a contempor谩nea del nombre.

  • Hipona (de), San Agust铆n
  • Aquino (de), Santo Tom谩s
  • Escobar Salmer贸n y Castro, Jos茅 (de)
  • Arist贸teles
  • S茅neca
  • J煤piter
  • Real Universidad se regulariza siempre como Real y Pontificia Universidad de M茅xico a menos que se trate de otra universidad.
  • Febo y Phoebo se regularizan siempre como Apolo
  • Ptolomeo se regulariza como Ptolomeo, Claudio

En el caso de nombres de obras o de instituciones, se regularizan utilizando el nombre por el que son conocidas actualmente

Salvo excepciones los plurales se regularizan en el singular. Los verbos conjugados en el infinitivo.

6.- Criterios para marcar palabras como Espa帽ol Antiguo <OldSp>

  1. Primero, habr谩 que leer el texto completo para familiarizarse con el vocabulario y saber qu茅 tipo de palabras utiliza el autor de cada uno de ellos y c贸mo las utiliza.
  2. Para la selecci贸n de palabras que se tendr谩n que marcar, se podr铆an se帽alar las que no parezcan comunes dentro del vocabulario cotidiano.
  3. Despu茅s de eso, se podr铆a revisar la palabra en el Diccionario de la Real Academia Espa帽ola (se encuentra en l铆nea); si no est谩 en el Diccionario habr谩 que marcarla; si s铆 est谩, habr谩 que valorarla seg煤n el criterio de quien la haya revisado, y lo poco o muy frecuente que sea utilizar dicha palabra.
  4. Para saber si la palabra es com煤nmente utilizada o no, pueden meterla en el buscador de 鈥楪oogle鈥 y, as铆, revisar los contextos en los que aparece.

Usos de 鈥渦" y de 鈥渧" hay que respetar c贸mo aparecen en el original鈥

7.- Criterios para marcar palabras como astrol贸gicas <astro> o astron贸micas <astron>

Aunque el criterio no es preciso, marcaremos como astrol贸gicas todos aquellos t茅rminos que no son utilizados por la astronom铆a moderna para caracterizar a los fen贸menos celestes, como pueden serlo, por ejemplo, los relativos al tipo de cometas o a la definici贸n de algunos de sus atributos. Reservaremos el marcado de t茅rminos astron贸micos a aquellos que son utilizados contempor谩neamente por la astronom铆a. por ejemplo, t茅rminos como eclipse, cometa, paralaje, meteoros se etiqutar谩 como astron贸mico como sigue:

  • <term type="Astron">Cometa</term>

O en el caso de las estrellas s铆 se hace referencia al nombre de la estrella:

  • la <term type="Astro">Estrella <foreing lang="lat">Capud Medusae</foreing></term>, en que feneci貌 el Cometa

En cambio si el t茅rmino no es utilizado por la ciencia astron贸mica contempor谩nea y en su defecto hace referencia a la divisi贸n del cosmos, se etiquetar谩 como astrol贸gico, por ejemplo regi贸n de fuego, juicio del a帽o, conjunci贸n magna; se marcar谩n como sigue:

  • <term type="Astro" reg="Regi贸n de fuego">region de fuego</term>

Existen otros t茅rminos, principalmente astrol贸gicos, que tienen que etiquetarse completos como se muestra en el ejemplo:

  • <term type="Astro">Cometa Sublunar</term>

8.- Criterios para marcar alusiones

Las alusiones, como por ejemplo, El fil贸sofo, el profeta, etc茅tera, se marcan como nombre, com type person y se regularizan con el nombre del aludido. Por ejemplo:

  • como se帽al <name type="peroson" ref="Arist贸teles">el fil贸sofo</name> en Metaf铆sica.

9.- Criterios para utilizar las etiquetas <q> (quote) <cit> (citation)

Criterios para utilizar las etiquetas <q> (quote) <cit> (citation)

<q> corresponde a una referencia en el texto que no es expl铆cita, esto es, puede haber referencias que hagan s贸lo menci贸n del autor o menci贸n de la fuente pero no sea de manera exacta. He aqu铆 un ejemplo:

  • A cuyo intento <name type="person" reg="Ovidio">el Poeta</name>:
  • <q reg="Ovidio. Metamorifosis. Libro I. 80-85 ><foreign lang="Lat">Pronaque; cum soectent animalia cetera terram, Os homini sublime dedit, coelumque, uidere Iussit, & erectos ad sydera tollere ultus</foreign>.</q>

Como vemos en este caso hay una referencia a "el Poeta", sabemos que es Ovidio y por eso se regulariza el nombre, y luego hay una cita en lat铆n (etiquetada con <foreign lang="Lat"></foreign>) pero no dice ni de qu茅 texto ni en qu茅 parte del texto est谩 tomada la cita. En este caso, como sabemos cu谩l es la fuente, la ponemos en un "reg" dentro de la etiqueta <q> como referencia moderna, es decir, autor, obra, y parte espec铆fica de la obra; en caso de que no se tengan los datos simplemente se dejar谩 la etiqueta <q> sin el atributo "reg".

Otro ejemplo del uso de la etiqueta <q> es el siguiente:

  • Y la <name type="person" reg="Sibila Eritrea">Sibyla Erithrea</name> en estos sus versos.
  • <q reg="Or谩culos sibilinos. Libro III. 334-336" ><foreign lang="lat">Sole sub neciduo ver茅 vocitata Cometes stella refulgebit Galdij mortalibus index;
  • Et Fames; & mortes, preclarorumque virorum
  • Adque Ducum interitus marnorum nobilium que
  • Maxima praeterea mortales signa monebunt.</foreign></q>

Como vemos en estos dos ejemplos hay una menci贸n a alg煤n personaje y una cita en lat铆n, pero en ning煤n momento se nos dice de d贸nde se toma esta cita o de qu茅 parte de la obra se retomo. Por ello este tipo de menciones se etiquetar谩n como <q>

En cuanto al uso de la etiqueta <cit> los siguentes ejemplos lo muestran:

  • lo dizen muchos Autores, y principalmente el venerable <cit reg="Beda, el Venerable. De Natura Rerum Liber. Cap XXIV"> <name type="person" reg="Beda, el Venerable">Beda</name>
  • <refTitle reg="De Natura Rerum Liber">lib de natura rerum</refTitle>. <foreign lang="lat" reg="Cometae sunt stellae flamis Crinitae repente nascentes regni mutationem aut pestilentiam; aut bella; aut ventos aestus ve portendentes">Cometae sunt stella flamis Crinitae repente nascen-
  • tes regni mutationem aut pestilentiam; aut bella; aut ventos aestus ve por-
  • tendentes</foreign></cit>

En este ejemplo tenemos varias etiquetas. Como principal tenemos la etiqueta <cit> que tiene el atributo "reg" porque tenemos la fuente de la cita (en este caso es Beda el Venerable y se pone como Autor, T铆tulo y referencia exacta de la obra), luego tenemos la etiqueta <name>, despu茅s la etiqueta <refTitle>, ambas etiquetas est谩n regularizadas porque conocemos a la persona que se nombra y conocemos el nombre completo de la obra a la que se hace referencia. Por 煤ltimo tenemos la etiqueta <foreign lang> con el "reg" esto se hace porque la cita est谩 dividida en renglones y para que el sistema de 铆ndices la pueda recuperar de manera completa sin las particiones, necesitamos juntarla toda en el atributo "reg".

  • servido de disponer, precedan primero estas se-帽ales Cometicas: como doctamente nos lo ense帽a el eruditis-
  • simo<cit> Maestro<name type="person"> Fray Juan de Santo Thoma</name> <refTitle>lib. primero de Me-
  • theoris cap. de Cometis</refTitle>: <foreign lang="Lat">sed verius est mortem Principum in
  • speciaeli significare ex beneplacito Dei, qui Comet(a)m tanquam sig-
  • num Mortis exhibet, ut ait Damascenus 2. de fide c. 27. aut sal-
  • tem ex usu, quia videmus frequenter sic accidere mortem Prin-
  • cipum ex apparientia Cometarum</foreign>.</cit>

Aqu铆 tenemos otro ejemplo de la etiqueta <cit>, excepto que ninguno de los elementos que est谩n dentro de ella tiene el atributo "reg" debido a que desconocemos la fuente exacta.

En el caso de que una cita se encuentre en dos folios, es decir, partida con la etiqueta <div> se pondr谩 el atributo cont="1" en la parte donde continua

  • el Angelico Doctor <cit> <name type="person" reg="Santo Tom谩s">Santo
  • Thomas</name>, como verdadero <term type="OldSp" reg="Fil贸sofo">Philosofo</term>, y Astrologo, en la 2.a 2.ae
  • quest. 95.artic. I. in corpore, & 2. sentent. distinct. 17. q. ad
  • secund . <foreign lang="Lat">Si autem determinentur (conviene 脿 saber los futuros)
  • in causis,ut ex quibus frequenter contingunt, cu potestate tamen,
  • deficiendi in minori parte propter impedimentu ex parte agentis,
  • vel ex parte recipientis actione, eoru cognitio non certitudinalis,
  • sed coniecturalis haberi potest. Et hoc modo Astrologus dicit, quae-
  • dam futura, quae consequutur ex motu coelesti in istis interioribus:
  • quae tamen impediri possunt propter deffectu inferiori causarum
  • & baecpraecognitio tanto magis ad certitudin? accedit, quanto ad
  • vnum </foreign></cit> A2
  • </p>
  • </div>
  • <div>
  • <pb>2 vuelta</pb>
  • <p>
  • <cit cont="1"><foreign lang="Lat">unum effectu cognoseuntur & quanto virtus causae mellius scitur</foreign></cit>.
  • Y assimesmo el Santo, en estas palabras, me defiende y es-
  • cusa de temeroso

Igualmente para el caso de la etiqueta <q>, o alg煤n nombre, o alg煤n <refTitle> se pone el atributo cont="1"

10.- Uso de la etiqueta de subt铆tulos:

<head></head>

En caso de que haya m谩s niveles dentro de los subt铆tulos se utilizar谩 la siguiente etiqueta:

  • <head type ="subtitle1"></head>

Y dependiendo del nivel se pondr谩 el n煤mero consecutivo.

  • <head type ="subtitle2"></head>

La ficha bibliogr谩fica, esto es, en la etiqueta <bibl> se pondr谩 el estandar bibliogr谩fico

de Autor, T铆tulo y Datos de la publicaci贸n. En el t铆tulo se pondr谩 la etiqueta <abrTitle></abrTitle> para abreviar el t铆tulo y que no aparezca

m谩s que una parte del t铆tulo completo.