/[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.55 Revision 1.56
1<?xml version="1.0" encoding="UTF-8"?> 1<?xml version="1.0" encoding="UTF-8"?>
2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xml-guide.xml,v 1.55 2005/12/19 17:57:43 neysx Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xml-guide.xml,v 1.56 2005/12/31 17:17:13 neysx Exp $ -->
3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
4 4
5<guide link="/doc/en/xml-guide.xml"> 5<guide link="/doc/en/xml-guide.xml">
6<title>Gentoo XML Guide</title> 6<title>Gentoo XML Guide</title>
7 7
8<author title="Author"> 8<author title="Author">
9 <mail link="drobbins@gentoo.org">Daniel Robbins</mail> 9 <mail link="drobbins@gentoo.org">Daniel Robbins</mail>
10</author> 10</author>
11<author title="Author"><!-- zhen@gentoo.org --> 11<author title="Author"><!-- zhen@gentoo.org -->
12 John P. Davis 12 John P. Davis
13</author> 13</author>
14<author title="Editor"> 14<author title="Editor">
15 <mail link="peesh@gentoo.org">Jorge Paulo</mail> 15 <mail link="peesh@gentoo.org">Jorge Paulo</mail>
16</author> 16</author>
17<author title="Editor"> 17<author title="Editor">
837&lt;abstract&gt; 837&lt;abstract&gt;
838 ... 838 ...
839&lt;/abstract&gt; 839&lt;/abstract&gt;
840 840
841&lt;!-- The content of this document is licensed under the CC-BY-SA license --&gt; 841&lt;!-- The content of this document is licensed under the CC-BY-SA license --&gt;
842&lt;!-- See http://creativecommons.org/licenses/by-sa/2.5 --&gt; 842&lt;!-- See http://creativecommons.org/licenses/by-sa/2.5 --&gt;
843&lt;license/&gt; 843&lt;license/&gt;
844 844
845&lt;version&gt;...&lt;/version&gt; 845&lt;version&gt;...&lt;/version&gt;
846&lt;date&gt;...&lt;/date&gt; 846&lt;date&gt;...&lt;/date&gt;
847</pre> 847</pre>
848 848
849<p> 849<p>
850So far no real differences (except for the <c>&lt;book&gt;</c> instead of 850So far no real differences (except for the <c>&lt;book&gt;</c> instead of
851<c>&lt;guide&gt;</c> tag). Instead of starting with the individual 851<c>&lt;guide&gt;</c> tag). Instead of starting with the individual
852<c>&lt;chapter&gt;</c>'s, you define a <c>&lt;part&gt;</c>, which is the 852<c>&lt;chapter&gt;</c>s, you define a <c>&lt;part&gt;</c>, which is the
853equivalent of a separate part in a book: 853equivalent of a separate part in a book:
854</p> 854</p>
855 855
856<pre caption="Defining a part"> 856<pre caption="Defining a part">
857&lt;part&gt; 857&lt;part&gt;
858&lt;title&gt;Part One&lt;/title&gt; 858&lt;title&gt;Part One&lt;/title&gt;
859&lt;abstract&gt; 859&lt;abstract&gt;
860 ... 860 ...
861&lt;/abstract&gt; 861&lt;/abstract&gt;
862 862
863<comment>(Defining the several chapters)</comment> 863<comment>(Defining the several chapters)</comment>
864&lt;/part&gt; 864&lt;/part&gt;
865</pre> 865</pre>
866 866
867<p> 867<p>
868Each part is accompanied by a <c>&lt;title&gt;</c> and an 868Each part is accompanied by a <c>&lt;title&gt;</c> and an
869<c>&lt;abstract&gt;</c> which gives a small introduction to the part. 869<c>&lt;abstract&gt;</c> which gives a small introduction to the part.
870</p> 870</p>
871 871
872<p> 872<p>
873Inside each part, you define the individual <c>&lt;chapter&gt;</c>'s. Each 873Inside each part, you define the individual <c>&lt;chapter&gt;</c>s. Each
874chapter <e>must</e> be a separate document. As a result it is no surprise that a 874chapter <e>must</e> be a separate document. As a result it is no surprise that
875special tag (<c>&lt;include&gt;</c>) is added to allow including the separate 875a special tag (<c>&lt;include&gt;</c>) is added to allow including the separate
876document. 876document.
877</p> 877</p>
878 878
879<pre caption="Defining a chapter"> 879<pre caption="Defining a chapter">
880&lt;chapter&gt; 880&lt;chapter&gt;
881&lt;title&gt;Chapter One&lt;/title&gt; 881&lt;title&gt;Chapter One&lt;/title&gt;
882&lt;abstract&gt; 882&lt;abstract&gt;
883 This is a small explanation on chapter one. 883 This is a small explanation on chapter one.
884&lt;/abstract&gt; 884&lt;/abstract&gt;
885 885
886 &lt;include href="path/to/chapter-one.xml"/&gt; 886 &lt;include href="path/to/chapter-one.xml"/&gt;
887 887
888&lt;/chapter&gt; 888&lt;/chapter&gt;
889</pre> 889</pre>
890 890
905 905
906&lt;!-- The content of this document is licensed under the CC-BY-SA license --&gt; 906&lt;!-- The content of this document is licensed under the CC-BY-SA license --&gt;
907&lt;!-- See http://creativecommons.org/licenses/by-sa/2.5 --&gt; 907&lt;!-- See http://creativecommons.org/licenses/by-sa/2.5 --&gt;
908 908
909&lt;sections&gt; 909&lt;sections&gt;
910 910
911&lt;version&gt;...&lt;/version&gt; 911&lt;version&gt;...&lt;/version&gt;
912&lt;date&gt;...&lt;/date&gt; 912&lt;date&gt;...&lt;/date&gt;
913 913
914<comment>(Define the several &lt;section&gt; and &lt;subsection&gt;)</comment> 914<comment>(Define the several &lt;section&gt; and &lt;subsection&gt;)</comment>
915 915
916&lt;/sections&gt; 916&lt;/sections&gt;
917</pre> 917</pre>
918 918
919<p> 919<p>
920Inside each chapter you can define <c>&lt;section&gt;</c>'s (equivalent of 920Inside each chapter you can define <c>&lt;section&gt;</c>s (equivalent of
921<c>&lt;chapter&gt;</c> in a Guide) and <c>&lt;subsection&gt;</c>'s (equivalent 921<c>&lt;chapter&gt;</c> in a Guide) and <c>&lt;subsection&gt;</c>s (equivalent
922of <c>&lt;section&gt;</c> in a Guide). 922of <c>&lt;section&gt;</c> in a Guide).
923</p> 923</p>
924 924
925<p> 925<p>
926Each individual chapter should have its own date and version elements. The 926Each individual chapter should have its own date and version elements. The
927latest date of all chapters and master document will be displayed when a user 927latest date of all chapters and master document will be displayed when a user
928browses through all parts of the book. 928browses through all parts of the book.
929</p> 929</p>
930 930
931</body> 931</body>
932</section> 932</section>
933</chapter> 933</chapter>
934 934
935<chapter> 935<chapter>
936<title>Resources</title> 936<title>Resources</title>

Legend:
Removed from v.1.55  
changed lines
  Added in v.1.56

  ViewVC Help
Powered by ViewVC 1.1.20