| 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.56 2005/12/31 17:17:13 neysx Exp $ --> |
2 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xml-guide.xml,v 1.57 2006/01/09 14:44:14 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"> |
| … | |
… | |
| 694 | keep the <e>rendered</e> content of <c><pre></c> elements within 80 |
694 | keep the <e>rendered</e> content of <c><pre></c> elements within 80 |
| 695 | columns to help console users. |
695 | columns to help console users. |
| 696 | </p> |
696 | </p> |
| 697 | |
697 | |
| 698 | <p> |
698 | <p> |
| 699 | <b>Indentation</b> may not be used, except with the XML-constructs of which the |
699 | <b>Indentation</b> may not be used, except with the XML-constructs of which the |
| 700 | parent XML-tags are <c><tr></c> (from <c><table></c>), |
700 | parent XML-tags are <c><tr></c> (from <c><table></c>), |
| 701 | <c><ul></c>, <c><ol></c>, <c><dl></c>, and |
701 | <c><ul></c>, <c><ol></c>, <c><dl></c>, and |
| 702 | <c><author></c>. If indentation is used, it <e>must</e> be two spaces for |
702 | <c><author></c>. If indentation is used, it <e>must</e> be two spaces for |
| 703 | each indentation. That means <e>no tabs</e> and <e>not</e> more spaces. |
703 | each indentation. That means <e>no tabs</e> and <e>not</e> more spaces. |
| 704 | Besides, tabs are not allowed in GuideXML documents. |
704 | Besides, tabs are not allowed in GuideXML documents. |
| 705 | </p> |
705 | </p> |
| 706 | |
706 | |
| 707 | <p> |
707 | <p> |
| 708 | In case word-wrapping happens in <c><ti></c>, <c><th></c>, |
708 | In case word-wrapping happens in <c><ti></c>, <c><th></c>, |
| 709 | <c><li></c> or <c><dd></c>constructs, indentation must be used for |
709 | <c><li></c> or <c><dd></c> constructs, indentation must be used for |
| 710 | the content. |
710 | the content. |
| 711 | </p> |
711 | </p> |
| 712 | |
712 | |
| 713 | <p> |
713 | <p> |
| 714 | An example for indentation is: |
714 | An example for indentation is: |
| 715 | </p> |
715 | </p> |
| 716 | |
716 | |
| 717 | <pre caption="Indentation Example"> |
717 | <pre caption="Indentation Example"> |
| 718 | <table> |
718 | <table> |
| 719 | <tr> |
719 | <tr> |
| 720 | <th>Foo</th> |
720 | <th>Foo</th> |
| 721 | <th>Bar</th> |
721 | <th>Bar</th> |
| 722 | </tr> |
722 | </tr> |
| 723 | <tr> |
723 | <tr> |
| 724 | <ti>This is an example for indentation</ti> |
724 | <ti>This is an example for indentation</ti> |