Recent changes to Home

Home modified by Grant Simpson

Grant Simpson — Thu, 04 Apr 2013 19:25:16 -0000

--- v53
+++ v54
@@ -1,113 +1,6 @@
+#TEI Boilerplate has moved to [Github](https://github.com/GrantLS/TEI-Boilerplate)
+
 #About TEI Boilerplate

 [TEI Boilerplate](http://teiboilerplate.org/) () is a lightweight solution for publishing styled [TEI](http://www.tei-c.org/) ([Text Encoding Initiative](http://www.tei-c.org/)) P5 content directly in modern browsers. With TEI Boilerplate, TEI XML files can be served directly to the web without server-side processing or translation to HTML. Our [TEI Boilerplate Demo](http://dcl.slis.indiana.edu/teibp/content/demo.xml) illustrates many TEI features rendered by TEI Boilerplate.

-#Browser Compatibility
-
-TEI Boilerplate requires a robust, modern browser to do its work. It is compatible with current versions of Firefox, Chrome, Safari, and Internet Explorer (IE 9).
-
-*Note:* For security reasons, some browsers (e.g., Chrome) will not process the XSLT transformation when the TEI document is opened from the local file system. Chrome does work fine when the TEI files are delivered through a Web server, including `localhost`. 
-
-If you have problems with TEI Boilerplate with a modern browser, please let us know by filing a bug report at .  
-
-#Introduction
-
-TEI is an XML-based language for describing and analyzing literary texts and other documents of interest to humanities scholars. Although TEI provides mechanisms for describing the design, presentational, and material features of the source document, projects and individual scholars that use TEI are responsible for developing their own methods, or implementing existing solutions, for converting the TEI to a presentation-ready state for the web or print (Rahtz, 2012). Two potential paths to reach this goal are:
-
-1. Transforming TEI to HTML using XSLT and styling the HTML output with CSS.
-2. Styling the TEI directly with CSS by referencing a CSS stylesheet from within the TEI document.
-
-Both of these approaches have advantages and disadvantages. Although HTML is the language of the web and, as such, is well supported by browsers, HTML’s descriptive capabilities are much less expressive than TEI’s. When TEI is transformed to HTML, much of the richness of the TEI is lost or obscured in the resulting HTML. However, the browser understands HTML very well and knows, for example, when to initiate retrieval of a document based on certain user events, such as clicking a link. The second option, CSS-styled TEI, delivers the TEI document directly to the browser. However, while the browser may apply CSS to format and style a TEI document, the browser doesnot understand the semantics of TEI. For instance, the browser does not understand that TEI's `` and `` elements are linking elements.  
-
-TEI Boilerplate bridges the gap between these two approaches by making use of the built-in XSLT (1.0) capabilities of browsers to embed the TEI XML, with minimal modifications, within an HTML5 shell document. Features expected of web documents, such as clickable links and display of linked images, are enabled through selective transformation of a very small number of TEI elements and attributes. Both the HTML5 shell and the embedded TEI are styled using CSS.
-
-TEI Boilerplate is not intended to be a replacement for the many excellent XSLT solutions for publishing and displaying TEI/XML on the web. It is intended to be a _simple and lightweight_ alternative to more complex XSLT solutions. There are both practical and theoretical advantages to this lightweight approach.
-
-##Practical Benefits 
-
-XSLT is far more powerful than CSS and can manipulate XML documents in ways that CSS cannot. XSLT can radically transform documents and can combine multiple XML data sources into a single output file or multiple output files. But the power of XSLT comes at a cost. XSLT is a far more complex language than CSS and has a far steeper learning curve. There are relatively few expert XSLT programmers compared to the numbers of expert Web developers with extensive knowledge of HTML/CSS/JavaScript.
-
-On the other hand, JavaScript is an extremely capable language for doing fancy things with XML content. JavaScript frameworks like JQuery and EXT JS, and the major browsers provide excellent support for manipulating the DOM (Document Object Model) of the web page. With TEI Boilerplate, the TEI document becomes part of the DOM, and JavaScript may then be used to perform more complex transformations, movements, and other manipulations of the TEI content than can be achieved with CSS alone. Our [TEI Boilerplate Demo](http://dcl.slis.indiana.edu/teibp/content/demo.xml) includes a simple example in the “Toolbox,” with a check box that uses JavaScript to hide and reveal the page breaks in a portion of the demo document.
-
-TEI Boilerplate gives HTML/CSS/JavaScript documents direct access to original TEI content, and it gives TEI documents direct access to the substantial capabilities of HTML, CSS, and JavaScript—the dominant document format, styling language, and (client-side) programming language of the web. TEI Boilerplate aims for simplicity and elegance, but it also facilitates complexity and innovation by exposing TEI content directly to the capabilities of JavaScript, the many powerful JavaScript frameworks, and CSS.
-
-In teaching contexts, TEI Boilerplate is a useful solution. Students and scholars new to TEI are rightly excited and enthused as they encode their first documents and experience the expressive power of TEI markup. But too often that initial excitement and enthusiasm dissipate when new TEI users inquire about publishing their documents on the web and are confronted with sometimes overwhelming details about an unfamiliar programming language, XSLT, and other information about server-side processing and transformation engines. With TEI Boilerplate, users can simply add a single line of code to their documents to instruct modern browsers to produce formatted output of their TEI content. And that default TEI Boilerplate output may be further tweaked and customized using CSS.
-
-###TEI Boilerplate and Omeka
-
-TEI Boilerplate also provides a simple solution for delivering TEI documents through [Omeka](http://www.omeka.org), the popular open-source web-publishing platform. No additional software or plugins are necessary. One can simply host the TEI Boilerplate XSLT, JavaScript, and CSS files on a server alongside Omeka and change a parameter in the TEI Boilerplate XSLT file to point to that server.
-
-Note: Some browsers apply the “same origin” security policy to XSLT stylesheets, which prohibits the use of XSLT from a different domain than the input document. For this reason, it is best to host the TEI Boilerplate files in the same domain as the Omeka installation.
-
-##Theoretical Motivations
-
-The power of TEI lies in the richness and expressiveness of its vocabulary. But much of that richness and expressiveness is lost in the translation to HTML. TEI Boilerplate largely preserves the integrity of the TEI document. Because the TEI document is delivered directly to the browser, that source TEI document—unchanged by any XSLT transformation—can be easily accessed and saved to the desktop or mobile device.
-
-Scholars labor over the intricate encoding of TEI documents, encoding that may represent sophisticated readings and analysis. But with the typical XSLT publishing solution, which transforms the TEI to HTML, much or all of the richness of the TEI content is lost. Furthermore, the presentation of the document is targeted at the HTML surrogate rather than the intricately encoded TEI document. This results in a conceptual disconnect between the design of the document and the original TEI encoding. By exposing the TEI directly to the browser, one may format the TEI directly, applying intentional design to a sophisticated model of a source document. If one wishes to manipulate the document using JavaScript, one may manipulate the TEI directly. Scholars are likely to be intimately familiar with their TEI documents, and their engagement with and understanding of these documents may benefit when the formatting and processing is targeted at the TEI itself, rather than at an HTML surrogate.
-
-TEI Boilerplate respects the integrity of the TEI document, and keeps the TEI document central throughout the publication process. TEI Boilerplate takes advantage of the separation of form and content inherent in XML, XSLT, CSS frameworks. However, like Liu (2004), Galey (2010), and others, the authors of TEI Boilerplate view that separation with suspicion. TEI Boilerplate attempts to weaken that separation of form and content in the typical TEI-to-web design and delivery model by largely removing the HTML layer, exposing the TEI-encoded text directly to the browser, and providing scholars with more immediate access to the readings, models, and analysis embedded in the TEI-encoded document.
-
-#How It Works 
-
-When a TEI document using TEI Boilerplate is accessed by a browser, the browser reads a line (the `xml-stylesheet` processing instruction) in the file that indicates that the XML should be processed by the TEI Boilerplate XSLT stylesheet. The browser then processes the TEI according to the rules of the stylesheet, which results in an HTML5 shell document within which the TEI document is embedded. A very small number of TEI elements and attributes (e.g. ``, ``, ``, and `@rend`) are converted to their closest HTML equivalents to enable features such as clickable links, display of images, and support for inline CSS. The HTML shell contains a link to the TEI Boilerplate CSS file, which tells the browser how to style the full document.
-
-#Using it in Your Project
-
-Download the [TEI Boilerplate files](http://sourceforge.net/projects/teiboilerplate/files/), and host the `teibp` directory on a web server.
-
-The simplest way to use TEI Boilerplate (TEIBP) is simply to add your TEI files to the `teibp/content` directory of TEI Boilerplate and include the following xml-stylesheet processing instruction at the top of your TEI documents, after the XML declaration and before the root `` element:
-
-
-
-You may then access your TEI files from a modern browser and see the resulting styled document.
-
-
-#TEI Boilerplate and CSS
-
-TEI Boilerplate makes extensive use of CSS to generate styled documents in the browser. The CSS is drawn from three possible sources:
-
-* External css stylesheets: 
-    * [`teibp.css`](http://dcl.slis.indiana.edu/teibp/css/teibp.css) includes default styles for the HTML shell and TEI document. 
-    * [`custom.css`](http://dcl.slis.indiana.edu/teibp/css/custom.css) is an empty stylesheet provided as a placeholder for user styles.
-* `` elements with `@scheme="css"`  within the TEI document are used to generate CSS declarations understood by the browser.
-* The global `@rend` attribute may be used to include inline CSS in TEI documents. The contents of `@rend` are copied to `@style`, which is understood by the browser.
-
-#Customizing the Look
-
-TEI Boilerplate includes a default “theme” and some alternative themes. These are provided mostly as an illustration of TEI Boilerplate's capabilities. Users may modify these supplied themes in the following ways:
-
-1. By supplying `` elements with `@scheme="css"` within the `` section of your TEI document. TEI Boilerplate will automatically convert the `` elements into CSS declarations  in a `

WikiPage Home modified by John A. Walsh

John A. Walsh — Thu, 31 May 2012 17:13:59 -0000

--- v52
+++ v53
@@ -31,7 +31,7 @@
 
 TEI Boilerplate gives HTML/CSS/JavaScript documents direct access to original TEI content, and it gives TEI documents direct access to the substantial capabilities of HTML, CSS, and JavaScript—the dominant document format, styling language, and (client-side) programming language of the web. TEI Boilerplate aims for simplicity and elegance, but it also facilitates complexity and innovation by exposing TEI content directly to the capabilities of JavaScript, the many powerful JavaScript frameworks, and CSS.
 
-In teaching contexts, TEI Boilerplate may be a useful solution. Students and scholars new to TEI are rightly excited and enthused as they encode their first documents and experience the expressive power of TEI markup. But too often that initial excitement and enthusiasm dissipate when new TEI users inquire about publishing their documents on the web and are confronted with sometimes overwhelming details about an unfamiliar programming language, XSLT, and other information about server-side processing and transformation engines. With TEI Boilerplate, users can simply add a single line of code to their documents to instruct modern browsers to produce formatted output of their TEI content. And that default TEI Boilerplate output may be further tweaked and customized using CSS.
+In teaching contexts, TEI Boilerplate is a useful solution. Students and scholars new to TEI are rightly excited and enthused as they encode their first documents and experience the expressive power of TEI markup. But too often that initial excitement and enthusiasm dissipate when new TEI users inquire about publishing their documents on the web and are confronted with sometimes overwhelming details about an unfamiliar programming language, XSLT, and other information about server-side processing and transformation engines. With TEI Boilerplate, users can simply add a single line of code to their documents to instruct modern browsers to produce formatted output of their TEI content. And that default TEI Boilerplate output may be further tweaked and customized using CSS.
 
 ###TEI Boilerplate and Omeka

WikiPage Home modified by John A. Walsh

John A. Walsh — Thu, 31 May 2012 04:07:38 -0000

--- v51
+++ v52
@@ -1,6 +1,6 @@
 #About TEI Boilerplate
 
-TEI Boilerplate is a lightweight solution for publishing styled [TEI](http://www.tei-c.org/) ([Text Encoding Initiative](http://www.tei-c.org/)) P5 content directly in modern browsers. With TEI Boilerplate, TEI XML files can be served directly to the web without server-side processing or translation to HTML. Our [TEI Boilerplate Demo](http://dcl.slis.indiana.edu/teibp/content/demo.xml) illustrates many TEI features rendered by TEI Boilerplate.
+[TEI Boilerplate](http://teiboilerplate.org/) () is a lightweight solution for publishing styled [TEI](http://www.tei-c.org/) ([Text Encoding Initiative](http://www.tei-c.org/)) P5 content directly in modern browsers. With TEI Boilerplate, TEI XML files can be served directly to the web without server-side processing or translation to HTML. Our [TEI Boilerplate Demo](http://dcl.slis.indiana.edu/teibp/content/demo.xml) illustrates many TEI features rendered by TEI Boilerplate.
 
 #Browser Compatibility
 
@@ -14,12 +14,12 @@
 
 TEI is an XML-based language for describing and analyzing literary texts and other documents of interest to humanities scholars. Although TEI provides mechanisms for describing the design, presentational, and material features of the source document, projects and individual scholars that use TEI are responsible for developing their own methods, or implementing existing solutions, for converting the TEI to a presentation-ready state for the web or print (Rahtz, 2012). Two potential paths to reach this goal are:
 
-1. Transforming TEI to HTML using XSLT. The output HTML is typically styled with CSS.
+1. Transforming TEI to HTML using XSLT and styling the HTML output with CSS.
 2. Styling the TEI directly with CSS by referencing a CSS stylesheet from within the TEI document.
 
-Both of these approaches have advantages and disadvantages. Although HTML is the language of the web and, as such, is well supported by browsers, HTML’s descriptive capabilities are much less expressive than TEI’s. When TEI is transformed to HTML, much of the richness of the TEI is lost or obscured in the resulting HTML. However, the browser understands HTML very well and knows, for example, when to initiate retrieval of a document based on certain user events, such as clicking a link. The second option, CSS-styled TEI, allows for the TEI data to be delivered directly to the browser. However, while the browser may apply CSS to format and style a TEI document, the browser doesnot understand the semantics of TEI. For instance, the browser does not understand that TEI's `` and `` elements are linking elements.  
+Both of these approaches have advantages and disadvantages. Although HTML is the language of the web and, as such, is well supported by browsers, HTML’s descriptive capabilities are much less expressive than TEI’s. When TEI is transformed to HTML, much of the richness of the TEI is lost or obscured in the resulting HTML. However, the browser understands HTML very well and knows, for example, when to initiate retrieval of a document based on certain user events, such as clicking a link. The second option, CSS-styled TEI, delivers the TEI document directly to the browser. However, while the browser may apply CSS to format and style a TEI document, the browser doesnot understand the semantics of TEI. For instance, the browser does not understand that TEI's `` and `` elements are linking elements.  
 
-TEI Boilerplate bridges the gap between these two approaches by making use of the built-in XSLT (1.0) capabilities of browsers to embed the TEI XML within a minimal HTML5 shell document. The TEI XML document is embedded, with minimal modifications, within this HTML5 shell. Features expected of web documents, such as clickable links and display of linked images, are enabled through selective transformation of a very small number of TEI elements and attributes. Both the HTML5 shell and the embedded TEI are styled using CSS.
+TEI Boilerplate bridges the gap between these two approaches by making use of the built-in XSLT (1.0) capabilities of browsers to embed the TEI XML, with minimal modifications, within an HTML5 shell document. Features expected of web documents, such as clickable links and display of linked images, are enabled through selective transformation of a very small number of TEI elements and attributes. Both the HTML5 shell and the embedded TEI are styled using CSS.
 
 TEI Boilerplate is not intended to be a replacement for the many excellent XSLT solutions for publishing and displaying TEI/XML on the web. It is intended to be a _simple and lightweight_ alternative to more complex XSLT solutions. There are both practical and theoretical advantages to this lightweight approach.
 
@@ -29,23 +29,23 @@
 
 On the other hand, JavaScript is an extremely capable language for doing fancy things with XML content. JavaScript frameworks like JQuery and EXT JS, and the major browsers provide excellent support for manipulating the DOM (Document Object Model) of the web page. With TEI Boilerplate, the TEI document becomes part of the DOM, and JavaScript may then be used to perform more complex transformations, movements, and other manipulations of the TEI content than can be achieved with CSS alone. Our [TEI Boilerplate Demo](http://dcl.slis.indiana.edu/teibp/content/demo.xml) includes a simple example in the “Toolbox,” with a check box that uses JavaScript to hide and reveal the page breaks in a portion of the demo document.
 
-TEI Boilerplate gives HTML/CSS/JavaScript documents direct access to original TEI content, and it gives TEI documents direct access to the substantial capabilities of HTML, CSS, and JavaScript—the dominant document format, styling language, and (client-side) programming language of the web. TEI Boilerplate aims for simplicity and elegance, but it also facilitates complexity and innovation by exposing TEI content directly to capabilities of JavaScript, the many powerful JavaScript frameworks, and CSS.
+TEI Boilerplate gives HTML/CSS/JavaScript documents direct access to original TEI content, and it gives TEI documents direct access to the substantial capabilities of HTML, CSS, and JavaScript—the dominant document format, styling language, and (client-side) programming language of the web. TEI Boilerplate aims for simplicity and elegance, but it also facilitates complexity and innovation by exposing TEI content directly to the capabilities of JavaScript, the many powerful JavaScript frameworks, and CSS.
 
 In teaching contexts, TEI Boilerplate may be a useful solution. Students and scholars new to TEI are rightly excited and enthused as they encode their first documents and experience the expressive power of TEI markup. But too often that initial excitement and enthusiasm dissipate when new TEI users inquire about publishing their documents on the web and are confronted with sometimes overwhelming details about an unfamiliar programming language, XSLT, and other information about server-side processing and transformation engines. With TEI Boilerplate, users can simply add a single line of code to their documents to instruct modern browsers to produce formatted output of their TEI content. And that default TEI Boilerplate output may be further tweaked and customized using CSS.
 
 ###TEI Boilerplate and Omeka
 
-TEI Boilerplate also provides a simple solution for delivering TEI documents through [Omeka](http://www.omeka.org), the popular open-source web-publishing platform. No additional software or plugins are necessary. One can simply simply host the TEI Boilerplate XSLT, JavaScript, and CSS files on a server alongside Omeka and change a parameter in the TEI Boilerplate XSLT file to point to that server.
+TEI Boilerplate also provides a simple solution for delivering TEI documents through [Omeka](http://www.omeka.org), the popular open-source web-publishing platform. No additional software or plugins are necessary. One can simply host the TEI Boilerplate XSLT, JavaScript, and CSS files on a server alongside Omeka and change a parameter in the TEI Boilerplate XSLT file to point to that server.
 
 Note: Some browsers apply the “same origin” security policy to XSLT stylesheets, which prohibits the use of XSLT from a different domain than the input document. For this reason, it is best to host the TEI Boilerplate files in the same domain as the Omeka installation.
 
 ##Theoretical Motivations
 
-The power of TEI lies in the richness and expressiveness of its vocabulary. But much of that richness and expressiveness is lost in the translation to HTML. TEI Boilerplate largely preserves the integrity of the TEI document. Since the original TEI document is delivered directly to the browser, the source TEI can be easily accessed and saved to the desktop or mobile device.
+The power of TEI lies in the richness and expressiveness of its vocabulary. But much of that richness and expressiveness is lost in the translation to HTML. TEI Boilerplate largely preserves the integrity of the TEI document. Because the TEI document is delivered directly to the browser, that source TEI document—unchanged by any XSLT transformation—can be easily accessed and saved to the desktop or mobile device.
 
 Scholars labor over the intricate encoding of TEI documents, encoding that may represent sophisticated readings and analysis. But with the typical XSLT publishing solution, which transforms the TEI to HTML, much or all of the richness of the TEI content is lost. Furthermore, the presentation of the document is targeted at the HTML surrogate rather than the intricately encoded TEI document. This results in a conceptual disconnect between the design of the document and the original TEI encoding. By exposing the TEI directly to the browser, one may format the TEI directly, applying intentional design to a sophisticated model of a source document. If one wishes to manipulate the document using JavaScript, one may manipulate the TEI directly. Scholars are likely to be intimately familiar with their TEI documents, and their engagement with and understanding of these documents may benefit when the formatting and processing is targeted at the TEI itself, rather than at an HTML surrogate.
 
-TEI Boilerplate respects the integrity of the TEI document, and keeps the TEI document central throughout the publication process. TEI Boilerplate takes advantage of the separation of form and content inherent in XML, XSLT, CSS frameworks. However, like Liu (2004), Galey (2010) and others, the authors of TEI Boilerplate view that separation with suspicion. TEI Boilerplate attempts to weaken the separation of form and content in the typical TEI-to-Web design and delivery model by largely removing the HTML layer, exposing the TEI-encoded text directly to the browser, and providing scholars with more immediate access to the digitally-encoded text.
+TEI Boilerplate respects the integrity of the TEI document, and keeps the TEI document central throughout the publication process. TEI Boilerplate takes advantage of the separation of form and content inherent in XML, XSLT, CSS frameworks. However, like Liu (2004), Galey (2010), and others, the authors of TEI Boilerplate view that separation with suspicion. TEI Boilerplate attempts to weaken that separation of form and content in the typical TEI-to-web design and delivery model by largely removing the HTML layer, exposing the TEI-encoded text directly to the browser, and providing scholars with more immediate access to the readings, models, and analysis embedded in the TEI-encoded document.
 
 #How It Works

WikiPage Home modified by John A. Walsh

John A. Walsh — Wed, 30 May 2012 13:13:10 -0000

--- v50
+++ v51
@@ -1,7 +1,9 @@
 #About TEI Boilerplate
+
 TEI Boilerplate is a lightweight solution for publishing styled [TEI](http://www.tei-c.org/) ([Text Encoding Initiative](http://www.tei-c.org/)) P5 content directly in modern browsers. With TEI Boilerplate, TEI XML files can be served directly to the web without server-side processing or translation to HTML. Our [TEI Boilerplate Demo](http://dcl.slis.indiana.edu/teibp/content/demo.xml) illustrates many TEI features rendered by TEI Boilerplate.
 
 #Browser Compatibility
+
 TEI Boilerplate requires a robust, modern browser to do its work. It is compatible with current versions of Firefox, Chrome, Safari, and Internet Explorer (IE 9).
 
 *Note:* For security reasons, some browsers (e.g., Chrome) will not process the XSLT transformation when the TEI document is opened from the local file system. Chrome does work fine when the TEI files are delivered through a Web server, including `localhost`. 
@@ -9,6 +11,7 @@
 If you have problems with TEI Boilerplate with a modern browser, please let us know by filing a bug report at .  
 
 #Introduction
+
 TEI is an XML-based language for describing and analyzing literary texts and other documents of interest to humanities scholars. Although TEI provides mechanisms for describing the design, presentational, and material features of the source document, projects and individual scholars that use TEI are responsible for developing their own methods, or implementing existing solutions, for converting the TEI to a presentation-ready state for the web or print (Rahtz, 2012). Two potential paths to reach this goal are:
 
 1. Transforming TEI to HTML using XSLT. The output HTML is typically styled with CSS.
@@ -21,6 +24,7 @@
 TEI Boilerplate is not intended to be a replacement for the many excellent XSLT solutions for publishing and displaying TEI/XML on the web. It is intended to be a _simple and lightweight_ alternative to more complex XSLT solutions. There are both practical and theoretical advantages to this lightweight approach.
 
 ##Practical Benefits 
+
 XSLT is far more powerful than CSS and can manipulate XML documents in ways that CSS cannot. XSLT can radically transform documents and can combine multiple XML data sources into a single output file or multiple output files. But the power of XSLT comes at a cost. XSLT is a far more complex language than CSS and has a far steeper learning curve. There are relatively few expert XSLT programmers compared to the numbers of expert Web developers with extensive knowledge of HTML/CSS/JavaScript.
 
 On the other hand, JavaScript is an extremely capable language for doing fancy things with XML content. JavaScript frameworks like JQuery and EXT JS, and the major browsers provide excellent support for manipulating the DOM (Document Object Model) of the web page. With TEI Boilerplate, the TEI document becomes part of the DOM, and JavaScript may then be used to perform more complex transformations, movements, and other manipulations of the TEI content than can be achieved with CSS alone. Our [TEI Boilerplate Demo](http://dcl.slis.indiana.edu/teibp/content/demo.xml) includes a simple example in the “Toolbox,” with a check box that uses JavaScript to hide and reveal the page breaks in a portion of the demo document.
@@ -30,7 +34,6 @@
 In teaching contexts, TEI Boilerplate may be a useful solution. Students and scholars new to TEI are rightly excited and enthused as they encode their first documents and experience the expressive power of TEI markup. But too often that initial excitement and enthusiasm dissipate when new TEI users inquire about publishing their documents on the web and are confronted with sometimes overwhelming details about an unfamiliar programming language, XSLT, and other information about server-side processing and transformation engines. With TEI Boilerplate, users can simply add a single line of code to their documents to instruct modern browsers to produce formatted output of their TEI content. And that default TEI Boilerplate output may be further tweaked and customized using CSS.
 
 ###TEI Boilerplate and Omeka
-
 
 TEI Boilerplate also provides a simple solution for delivering TEI documents through [Omeka](http://www.omeka.org), the popular open-source web-publishing platform. No additional software or plugins are necessary. One can simply simply host the TEI Boilerplate XSLT, JavaScript, and CSS files on a server alongside Omeka and change a parameter in the TEI Boilerplate XSLT file to point to that server.
 
@@ -44,7 +47,9 @@
 
 TEI Boilerplate respects the integrity of the TEI document, and keeps the TEI document central throughout the publication process. TEI Boilerplate takes advantage of the separation of form and content inherent in XML, XSLT, CSS frameworks. However, like Liu (2004), Galey (2010) and others, the authors of TEI Boilerplate view that separation with suspicion. TEI Boilerplate attempts to weaken the separation of form and content in the typical TEI-to-Web design and delivery model by largely removing the HTML layer, exposing the TEI-encoded text directly to the browser, and providing scholars with more immediate access to the digitally-encoded text.
 
-#How It Works When a TEI document using TEI Boilerplate is accessed by a browser, the browser reads a line (the `xml-stylesheet` processing instruction) in the file that indicates that the XML should be processed by the TEI Boilerplate XSLT stylesheet. The browser then processes the TEI according to the rules of the stylesheet, which results in an HTML5 shell document within which the TEI document is embedded. A very small number of TEI elements and attributes (e.g. ``, ``, ``, and `@rend`) are converted to their closest HTML equivalents to enable features such as clickable links, display of images, and support for inline CSS. The HTML shell contains a link to the TEI Boilerplate CSS file, which tells the browser how to style the full document.
+#How It Works 
+
+When a TEI document using TEI Boilerplate is accessed by a browser, the browser reads a line (the `xml-stylesheet` processing instruction) in the file that indicates that the XML should be processed by the TEI Boilerplate XSLT stylesheet. The browser then processes the TEI according to the rules of the stylesheet, which results in an HTML5 shell document within which the TEI document is embedded. A very small number of TEI elements and attributes (e.g. ``, ``, ``, and `@rend`) are converted to their closest HTML equivalents to enable features such as clickable links, display of images, and support for inline CSS. The HTML shell contains a link to the TEI Boilerplate CSS file, which tells the browser how to style the full document.
 
 #Using it in Your Project
 
@@ -58,6 +63,7 @@
 
 
 #TEI Boilerplate and CSS
+
 TEI Boilerplate makes extensive use of CSS to generate styled documents in the browser. The CSS is drawn from three possible sources:
 
 * External css stylesheets: 
@@ -67,12 +73,14 @@
 * The global `@rend` attribute may be used to include inline CSS in TEI documents. The contents of `@rend` are copied to `@style`, which is understood by the browser.
 
 #Customizing the Look
+
 TEI Boilerplate includes a default “theme” and some alternative themes. These are provided mostly as an illustration of TEI Boilerplate's capabilities. Users may modify these supplied themes in the following ways:
 
 1. By supplying `` elements with `@scheme="css"` within the `` section of your TEI document. TEI Boilerplate will automatically convert the `` elements into CSS declarations  in a `