/[gentoo]/xml/htdocs/doc/en/xml-guide.xml
Gentoo

Diff of /xml/htdocs/doc/en/xml-guide.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.71 Revision 1.72
1<?xml version="1.0" encoding="UTF-8"?> 1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xml-guide.xml,v 1.71 2011/11/29 19:02:45 swift Exp $ --> 3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xml-guide.xml,v 1.72 2012/10/07 08:19:42 swift Exp $ -->
4 4
5<guide> 5<guide>
6<title>Gentoo GuideXML Guide</title> 6<title>Gentoo GuideXML Guide</title>
7 7
8<author title="Author"> 8<author title="Author">
33 33
34<!-- The content of this document is licensed under the CC-BY-SA license --> 34<!-- The content of this document is licensed under the CC-BY-SA license -->
35<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 35<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
36<license/> 36<license/>
37 37
38<version>12</version> 38<version>13</version>
39<date>2011-11-29</date> 39<date>2012-10-07</date>
40 40
41<chapter> 41<chapter>
42<title>GuideXML basics</title> 42<title>GuideXML basics</title>
43<section> 43<section>
44<title>GuideXML design goals</title> 44<title>GuideXML design goals</title>
93<pre caption="The initial part of a guide XML document"> 93<pre caption="The initial part of a guide XML document">
94&lt;?xml version="1.0" encoding="UTF-8"?&gt; 94&lt;?xml version="1.0" encoding="UTF-8"?&gt;
95&lt;!DOCTYPE guide SYSTEM "/dtd/guide.dtd"&gt; 95&lt;!DOCTYPE guide SYSTEM "/dtd/guide.dtd"&gt;
96&lt;!-- &#36;Header&#36; --&gt; 96&lt;!-- &#36;Header&#36; --&gt;
97 97
98&lt;guide link="<i>/doc/en/guide.xml</i>" lang="<i>en</i>"&gt; 98&lt;guide lang="<i>en</i>"&gt;
99&lt;title&gt;<i>Gentoo Documentation Guide</i>&lt;/title&gt; 99&lt;title&gt;<i>Gentoo Documentation Guide</i>&lt;/title&gt;
100 100
101&lt;author title="<i>Author</i>"&gt; 101&lt;author title="<i>Author</i>"&gt;
102 &lt;mail link="<i>yourname@gentoo.org</i>"&gt;<i>Your Name</i>&lt;/mail&gt; 102 &lt;mail link="<i>yourname@gentoo.org</i>"&gt;<i>Your Name</i>&lt;/mail&gt;
103&lt;/author&gt; 103&lt;/author&gt;
121On the first lines, we see the requisite tag that identifies this as an XML 121On the first lines, we see the requisite tag that identifies this as an XML
122document and specifies its DTD. The <c>&lt;!-- &#36;Header&#36; --&gt;</c> line 122document and specifies its DTD. The <c>&lt;!-- &#36;Header&#36; --&gt;</c> line
123will be automatically modified by the CVS server and helps to track revisions. 123will be automatically modified by the CVS server and helps to track revisions.
124Next, there's a <c>&lt;guide&gt;</c> tag -- the entire guide document is 124Next, there's a <c>&lt;guide&gt;</c> tag -- the entire guide document is
125enclosed within a <c>&lt;guide&gt; &lt;/guide&gt;</c> pair. 125enclosed within a <c>&lt;guide&gt; &lt;/guide&gt;</c> pair.
126<br/>
127The <c>link</c> attribute is optional and should preferably contain the
128absolute path to the document relatively to the document root even though the
129file name alone will work. It is only used to generate a link to a
130printer-friendly version of your document and check whether a translation is
131up-to-date. Our XSL back-engine passes the actual path to our XSL stylesheet.
132The link attribute is only used as a fall-back value in case the XML is
133processed by other means.
134<br/> 126<br/>
135The <c>lang</c> attribute should be used to specify the language code of your 127The <c>lang</c> attribute should be used to specify the language code of your
136document. It is used to format the date and insert strings like "<e>Note</e>", 128document. It is used to format the date and insert strings like "<e>Note</e>",
137"<e>Content</e>", etc. in the specified language. The default is English. 129"<e>Content</e>", etc. in the specified language. The default is English.
138</p> 130</p>

Legend:
Removed from v.1.71  
changed lines
  Added in v.1.72

  ViewVC Help
Powered by ViewVC 1.1.20