About XML - Revision history

PBO at 08:33, 12 March 2018

2018-03-12T08:33:55Z

PBO at 09:34, 26 April 2017

2017-04-26T09:34:38Z

PBO at 12:07, 25 April 2017

2017-04-25T12:07:17Z

PBO at 11:56, 25 April 2017

2017-04-25T11:56:29Z

PBO at 11:46, 25 April 2017

2017-04-25T11:46:43Z

ASC at 09:02, 25 January 2017

2017-01-25T09:02:43Z

ASC at 08:50, 25 January 2017

2017-01-25T08:50:44Z

ASC at 12:15, 18 January 2017

2017-01-18T12:15:15Z

ASC at 12:13, 18 January 2017

2017-01-18T12:13:48Z

ASC at 12:11, 18 January 2017

2017-01-18T12:11:59Z

← Older revision		Revision as of 08:33, 12 March 2018
Line 90:		Line 90:

	The schemas will be placed on the web on e.g. (Mondrian example): http://xmlschema.huygens.knaw.nl/md.rng		The schemas will be placed on the web on e.g. (Mondrian example): http://xmlschema.huygens.knaw.nl/md.rng
		+
		+	===Chained schemas (in development)===
		+
		+	We will be working towards a situation where a single schema defines the Huygens TEI subset-with-additions. Project-specific schemas will be derived from the Huygens schema.
		+
		+	We start with the Mondrian (letter) schema, modified so as to use the correspDesc elements now available in TEI and to include the features needed for the ePistolarium.
		+
		+

	==See also==		==See also==

@@ Line 87: / Line 87: @@
 For each of our projects, we define a specific schema (or multiple specific schemas, if we have multiple types of documents).
 The schema is defined by the project's XML consultant. It is generated from a sourcefile (a so-called ODD-file) maintained in the project's
-repository.
+repository. The generated schema is stored there as well.
 ==See also==
 * [[XML Huygens]]
 [[Category:XML Huygens]]

@@ Line 47: / Line 47: @@
 					is too short.
-(The arrow (→) shows what an encoded text will look like when published)
+(The arrow (→) shows what an encoded text will usually look like when published)
 </pre>
@@ Line 79: / Line 79: @@
 ===Schema===
 [<u>Geldt zo alleen voor Mondriaan? Nog algemeen maken</u>] A schema was defined, in which we specify which elements and attributes are allowed. The schema uses the Relax NG schema language. The name is MD.rng.
 oXygen uses the schema to validate the file and suggest allowed elements and attributes.

@@ Line 13: / Line 13: @@
-==XML Basics==
+==XML basics==
 We clearly cannot provide a full introduction into XML here. Online training is available at many locations,
 e.g. at [https://www.w3schools.com/xml/ W3schools]. The TEI also maintains a page with information [http://www.tei-c.org/Support/Learn/ for learning TEI]. Or you can attend formal training, e.g. at the [http://www.dhoxss.net/ Oxford summer school in Digital Humanities].
@@ Line 47: / Line 47: @@
 					is too short.
-(The arrow (→) shows how an encoded text will look like when published)
+(The arrow (→) shows what an encoded text will look like when published)
 </pre>
@@ Line 68: / Line 68: @@
 ===Namespaces===
-Elements in XML documents can be placed in so-called namespaces. This is a way to be able to distinguish different XML vocabularies. The default namespace for elements in this document is http://www.tei-c.org/ns/1.0 (the TEI namespace). For new elements (normally borrowed from DALF), the namespace is http://mondrian.huygens.knaw.nl/. We refer to the namespace with the prefix 'md', for exemple <md:addressee>.
+Elements in XML documents can be placed in so-called [https://www.w3schools.com/xml/xml_namespaces.asp namespaces]. This is a way to be able to distinguish different XML vocabularies.
-Prefix and namespace are defined on the root level element of the XML document, as follows:
+(Existing projects still have there own namespaces, e.g. for Mondrian: http://mondrian.huygens.knaw.nl/. These project-specific namespaces will be phased out.
-<pre><TEI xmlns="http://www.tei-c.org/ns/1.0" xmlns:md="http://mondrian.huygens.knaw.nl/"></pre>
+We define prefix and namespaces on the root level element of the XML document, as follows:
 ===Schema===

@@ Line 1: / Line 1: @@
-==XML generalities==
+==XML at Huygens ING==
-Some generic rules of XML:
+Huygens ING uses XML to create many of its scholarly editions. XML is a plain text format that uses tags to delimit
-•	<starting tag>...</ending tag>   	(! attention to the position of  / ), i.e.
+This wiki documents the choices that we make in using the TEI Guidelines, which occasionally describe multiple ways of
 <pre><address>Prins Willem-Alexanderhof 5</address></pre>
-•	<tag without content/>, i.e.
+* <tag without content/>, i.e.
   <pre><lb/> linebreak</pre>
-•	An element can have an attribute. An attribute has a value “ ”:
+* An element can have an attribute. An attribute has a value " ":
 <pre>
-  	<hi rend=“super”>st</hi>
+  	<hi rend="super">st</hi>
 	hi 	is the element (highlight)
 	rend 	is the attribute
-	super 	is the value of the attribute.
+	super 	is the value of the attribute.</pre>
 </pre>
-•	@xml:id is an attribute that provides a unique identifier to an element. To point to it use #.
+* @xml:id is an attribute that provides a unique identifier for an element. To point to it use "#".
-•	In a XML document, linebreaks (also multiple linebreaks) don't matter.
+* In an XML document, physical linebreaks ('enters'), even multiple ones, don't matter.
-If you want a linebreak in a text you have to use <lb/>.
+If you want a linebreak in a text you have to encode one using <lb/>.
 <pre>
 The line is too			→	The line is too short
@@ Line 26: / Line 46: @@
 The line <lb/> is too short	→ 	The line
 					is too short.
 </pre>
-•	XML documents are whitespace sensitive (whitespace includes spaces, tabs and newlines):
+* XML documents are whitespace sensitive (whitespace includes spaces, tabs and newlines):
 <pre>
 normal<lb/>ly		→ 	normally
@@ Line 36: / Line 58: @@
 </pre>
-•	Any comment (if you want to take a note on something for you or for other transcribers) is encoded in this way:
+* Any comment (if you want to take a note on something for you or for other transcribers) is encoded in this way:
 <pre>
 <!--  This is a comment  -->

← Older revision		Revision as of 09:02, 25 January 2017
Line 62:		Line 62:

	For the writings, we use a separate schema: MDwritings.rng.		For the writings, we use a separate schema: MDwritings.rng.
		+
		+	==See also==
		+	* [[XML Huygens]]

	[[Category:XML Huygens]]		[[Category:XML Huygens]]

← Older revision		Revision as of 12:15, 18 January 2017
Line 62:		Line 62:

	For the writings, we use a separate schema: MDwritings.rng.		For the writings, we use a separate schema: MDwritings.rng.
		+
		+	[[Category:XML Huygens]]