diff options
Diffstat (limited to 'en_US.ISO8859-1/books/fdp-primer/xhtml-markup/chapter.xml')
| -rw-r--r-- | en_US.ISO8859-1/books/fdp-primer/xhtml-markup/chapter.xml | 352 |
1 files changed, 175 insertions, 177 deletions
diff --git a/en_US.ISO8859-1/books/fdp-primer/xhtml-markup/chapter.xml b/en_US.ISO8859-1/books/fdp-primer/xhtml-markup/chapter.xml index eded9cac18..f0894d63fe 100644 --- a/en_US.ISO8859-1/books/fdp-primer/xhtml-markup/chapter.xml +++ b/en_US.ISO8859-1/books/fdp-primer/xhtml-markup/chapter.xml @@ -30,11 +30,10 @@ $FreeBSD$ --> - -<chapter id="xhtml-markup"> +<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="xhtml-markup"> <title><acronym>XHTML</acronym> Markup</title> - <sect1 id="xhtml-markup-introduction"> + <sect1 xml:id="xhtml-markup-introduction"> <title>Introduction</title> <para>This chapter describes usage of the <acronym>XHTML</acronym> @@ -43,7 +42,7 @@ <para><acronym>XHTML</acronym> is the <acronym>XML</acronym> version of the HyperText Markup Language, the markup language of choice on the World Wide Web. More information can be found at - <ulink url="http://www.w3.org/"></ulink>.</para> + <uri xlink:href="http://www.w3.org/">http://www.w3.org/</uri>.</para> <para><acronym>XHTML</acronym> is used to mark up pages on the &os; web site. It is usually not used to mark up other @@ -61,9 +60,8 @@ <para>The <acronym>XHTML</acronym> <acronym>DTDs</acronym> are available from the Ports Collection in - <filename role="package">textproc/xhtml</filename>. They are - automatically installed by the <filename - role="package">textproc/docproj</filename> port.</para> + <package>textproc/xhtml</package>. They are + automatically installed by the <package>textproc/docproj</package> port.</para> <note> <para>This is <emphasis>not</emphasis> an exhaustive list of @@ -85,7 +83,7 @@ </note> </sect1> - <sect1 id="xhtml-markup-fpi"> + <sect1 xml:id="xhtml-markup-fpi"> <title>Formal Public Identifier (<acronym>FPI</acronym>)</title> <para>There are a number of <acronym>XHTML</acronym> @@ -98,7 +96,7 @@ <programlisting>PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"</programlisting> </sect1> - <sect1 id="xhtml-markup-sectional-elements"> + <sect1 xml:id="xhtml-markup-sectional-elements"> <title>Sectional Elements</title> <para>An <acronym>XHTML</acronym> document is normally split into @@ -109,113 +107,113 @@ <emphasis>body</emphasis>, contains content that will be displayed to the user.</para> - <para>These sections are indicated with <sgmltag>head</sgmltag> - and <sgmltag>body</sgmltag> elements respectively. These + <para>These sections are indicated with <tag>head</tag> + and <tag>body</tag> elements respectively. These elements are contained within the top-level - <sgmltag>html</sgmltag> element.</para> + <tag>html</tag> element.</para> <example> <title>Normal <acronym>XHTML</acronym> Document Structure</title> - <programlisting><sgmltag class="starttag">html xmlns="http://www.w3.org/1999/xhtml"</sgmltag> - <sgmltag class="starttag">head</sgmltag> - <sgmltag class="starttag">title</sgmltag><replaceable>The Document's Title</replaceable><sgmltag class="endtag">title</sgmltag> - <sgmltag class="endtag">head</sgmltag> + <programlisting><tag class="starttag">html xmlns="http://www.w3.org/1999/xhtml"</tag> + <tag class="starttag">head</tag> + <tag class="starttag">title</tag><replaceable>The Document's Title</replaceable><tag class="endtag">title</tag> + <tag class="endtag">head</tag> - <sgmltag class="starttag">body</sgmltag> + <tag class="starttag">body</tag> … - <sgmltag class="endtag">body</sgmltag> -<sgmltag class="endtag">html</sgmltag></programlisting> + <tag class="endtag">body</tag> +<tag class="endtag">html</tag></programlisting> </example> </sect1> - <sect1 id="xhtml-markup-block-elements"> + <sect1 xml:id="xhtml-markup-block-elements"> <title>Block Elements</title> - <sect2 id="xhtml-markup-block-elements-headings"> + <sect2 xml:id="xhtml-markup-block-elements-headings"> <title>Headings</title> <para><acronym>XHTML</acronym> has tags to denote headings in the document at up to six different levels.</para> <para>The largest and most prominent heading is - <sgmltag>h1</sgmltag>, then <sgmltag>h2</sgmltag>, - continuing down to <sgmltag>h6</sgmltag>.</para> + <tag>h1</tag>, then <tag>h2</tag>, + continuing down to <tag>h6</tag>.</para> <para>The element's content is the text of the heading.</para> <example> - <title><sgmltag>h1</sgmltag>, <sgmltag>h2</sgmltag>, + <title><tag>h1</tag>, <tag>h2</tag>, and Other Header Tags</title> <para>Usage:</para> - <programlisting><sgmltag class="starttag">h1</sgmltag>First section<sgmltag class="endtag">h1</sgmltag> + <programlisting><tag class="starttag">h1</tag>First section<tag class="endtag">h1</tag> <!-- Document introduction goes here --> -<sgmltag class="starttag">h2</sgmltag>This is the heading for the first section<sgmltag class="endtag">h2</sgmltag> +<tag class="starttag">h2</tag>This is the heading for the first section<tag class="endtag">h2</tag> <!-- Content for the first section goes here --> -<sgmltag class="starttag">h3</sgmltag>This is the heading for the first sub-section<sgmltag class="endtag">h3</sgmltag> +<tag class="starttag">h3</tag>This is the heading for the first sub-section<tag class="endtag">h3</tag> <!-- Content for the first sub-section goes here --> -<sgmltag class="starttag">h2</sgmltag>This is the heading for the second section<sgmltag class="endtag">h2</sgmltag> +<tag class="starttag">h2</tag>This is the heading for the second section<tag class="endtag">h2</tag> <!-- Content for the second section goes here --></programlisting> </example> <para>Generally, an <acronym>XHTML</acronym> page should have - one first level heading (<sgmltag>h1</sgmltag>). This can - contain many second level headings (<sgmltag>h2</sgmltag>), + one first level heading (<tag>h1</tag>). This can + contain many second level headings (<tag>h2</tag>), which can in turn contain many third level headings. Do not leave gaps in the numbering.</para> </sect2> - <sect2 id="xhtml-markup-block-elements-paragraphs"> + <sect2 xml:id="xhtml-markup-block-elements-paragraphs"> <title>Paragraphs</title> <para><acronym>XHTML</acronym> supports a single paragraph - element, <sgmltag>p</sgmltag>.</para> + element, <tag>p</tag>.</para> <example> - <title><sgmltag>p</sgmltag></title> + <title><tag>p</tag></title> <para>Usage:</para> - <programlisting><sgmltag class="starttag">p</sgmltag>This is a paragraph. It can contain just about any - other element.<sgmltag class="endtag">p</sgmltag></programlisting> + <programlisting><tag class="starttag">p</tag>This is a paragraph. It can contain just about any + other element.<tag class="endtag">p</tag></programlisting> </example> </sect2> - <sect2 id="xhtml-markup-block-elements-block-quotations"> + <sect2 xml:id="xhtml-markup-block-elements-block-quotations"> <title>Block Quotations</title> <para>A block quotation is an extended quotation from another document that will appear in a separate paragraph.</para> <example> - <title><sgmltag>blockquote</sgmltag></title> + <title><tag>blockquote</tag></title> <para>Usage:</para> - <programlisting><sgmltag class="starttag">p</sgmltag>A small excerpt from the US Constitution:<sgmltag class="endtag">p</sgmltag> + <programlisting><tag class="starttag">p</tag>A small excerpt from the US Constitution:<tag class="endtag">p</tag> -<sgmltag class="starttag">blockquote</sgmltag>We the People of the United States, in Order to form +<tag class="starttag">blockquote</tag>We the People of the United States, in Order to form a more perfect Union, establish Justice, insure domestic Tranquility, provide for the common defence, promote the general Welfare, and secure the Blessings of Liberty to ourselves and our Posterity, do ordain and establish this Constitution for the - United States of America.<sgmltag class="endtag">blockquote</sgmltag></programlisting> + United States of America.<tag class="endtag">blockquote</tag></programlisting> </example> </sect2> - <sect2 id="xhtml-markup-block-elements-lists"> + <sect2 xml:id="xhtml-markup-block-elements-lists"> <title>Lists</title> <para><acronym>XHTML</acronym> can present the user with three @@ -227,79 +225,79 @@ section is the term being defined, and the second section is the definition.</para> - <para>Ordered lists are indicated by the <sgmltag>ol</sgmltag> - element, unordered lists by the <sgmltag>ul</sgmltag> - element, and definition lists by the <sgmltag>dl</sgmltag> + <para>Ordered lists are indicated by the <tag>ol</tag> + element, unordered lists by the <tag>ul</tag> + element, and definition lists by the <tag>dl</tag> element.</para> <para>Ordered and unordered lists contain listitems, indicated - by the <sgmltag>li</sgmltag> element. A listitem can + by the <tag>li</tag> element. A listitem can contain textual content, or it may be further wrapped in one - or more <sgmltag>p</sgmltag> elements.</para> + or more <tag>p</tag> elements.</para> <para>Definition lists contain definition terms - (<sgmltag>dt</sgmltag>) and definition descriptions - (<sgmltag>dd</sgmltag>). A definition term can only contain + (<tag>dt</tag>) and definition descriptions + (<tag>dd</tag>). A definition term can only contain inline elements. A definition description can contain other block elements.</para> <example> - <title><sgmltag>ul</sgmltag> and - <sgmltag>ol</sgmltag></title> + <title><tag>ul</tag> and + <tag>ol</tag></title> <para>Usage:</para> - <programlisting><sgmltag class="starttag">p</sgmltag>An unordered list. Listitems will probably be - preceded by bullets.<sgmltag class="endtag">p</sgmltag> + <programlisting><tag class="starttag">p</tag>An unordered list. Listitems will probably be + preceded by bullets.<tag class="endtag">p</tag> -<sgmltag class="starttag">ul</sgmltag> - <sgmltag class="starttag">li</sgmltag>First item<sgmltag class="endtag">li</sgmltag> +<tag class="starttag">ul</tag> + <tag class="starttag">li</tag>First item<tag class="endtag">li</tag> - <sgmltag class="starttag">li</sgmltag>Second item<sgmltag class="endtag">li</sgmltag> + <tag class="starttag">li</tag>Second item<tag class="endtag">li</tag> - <sgmltag class="starttag">li</sgmltag>Third item<sgmltag class="endtag">li</sgmltag> -<sgmltag class="endtag">ul</sgmltag> + <tag class="starttag">li</tag>Third item<tag class="endtag">li</tag> +<tag class="endtag">ul</tag> -<sgmltag class="starttag">p</sgmltag>An ordered list, with list items consisting of multiple +<tag class="starttag">p</tag>An ordered list, with list items consisting of multiple paragraphs. Each item (note: not each paragraph) will be - numbered.<sgmltag class="endtag">p</sgmltag> + numbered.<tag class="endtag">p</tag> -<sgmltag class="starttag">ol</sgmltag> - <sgmltag class="starttag">li</sgmltag><sgmltag class="starttag">p</sgmltag>This is the first item. It only has one paragraph.<sgmltag class="endtag">p</sgmltag><sgmltag class="endtag">li</sgmltag> +<tag class="starttag">ol</tag> + <tag class="starttag">li</tag><tag class="starttag">p</tag>This is the first item. It only has one paragraph.<tag class="endtag">p</tag><tag class="endtag">li</tag> - <sgmltag class="starttag">li</sgmltag><sgmltag class="starttag">p</sgmltag>This is the first paragraph of the second item.<sgmltag class="endtag">p</sgmltag> + <tag class="starttag">li</tag><tag class="starttag">p</tag>This is the first paragraph of the second item.<tag class="endtag">p</tag> - <sgmltag class="starttag">p</sgmltag>This is the second paragraph of the second item.<sgmltag class="endtag">p</sgmltag><sgmltag class="endtag">li</sgmltag> + <tag class="starttag">p</tag>This is the second paragraph of the second item.<tag class="endtag">p</tag><tag class="endtag">li</tag> - <sgmltag class="starttag">li</sgmltag><sgmltag class="starttag">p</sgmltag>This is the first and only paragraph of the third - item.<sgmltag class="endtag">p</sgmltag><sgmltag class="endtag">li</sgmltag> -<sgmltag class="endtag">ol</sgmltag></programlisting> + <tag class="starttag">li</tag><tag class="starttag">p</tag>This is the first and only paragraph of the third + item.<tag class="endtag">p</tag><tag class="endtag">li</tag> +<tag class="endtag">ol</tag></programlisting> </example> <example> - <title>Definition Lists with <sgmltag>dl</sgmltag></title> + <title>Definition Lists with <tag>dl</tag></title> <para>Usage:</para> - <programlisting><sgmltag class="starttag">dl</sgmltag> - <sgmltag class="starttag">dt</sgmltag>Term 1<sgmltag class="endtag">dt</sgmltag> + <programlisting><tag class="starttag">dl</tag> + <tag class="starttag">dt</tag>Term 1<tag class="endtag">dt</tag> - <sgmltag class="starttag">dd</sgmltag><sgmltag class="starttag">p</sgmltag>Paragraph 1 of definition 1.<sgmltag class="endtag">p</sgmltag> + <tag class="starttag">dd</tag><tag class="starttag">p</tag>Paragraph 1 of definition 1.<tag class="endtag">p</tag> - <sgmltag class="starttag">p</sgmltag>Paragraph 2 of definition 1.<sgmltag class="endtag">p</sgmltag><sgmltag class="endtag">dd</sgmltag> + <tag class="starttag">p</tag>Paragraph 2 of definition 1.<tag class="endtag">p</tag><tag class="endtag">dd</tag> - <sgmltag class="starttag">dt</sgmltag>Term 2<sgmltag class="endtag">dt</sgmltag> + <tag class="starttag">dt</tag>Term 2<tag class="endtag">dt</tag> - <sgmltag class="starttag">dd</sgmltag><sgmltag class="starttag">p</sgmltag>Paragraph 1 of definition 2.<sgmltag class="endtag">p</sgmltag><sgmltag class="endtag">dd</sgmltag> + <tag class="starttag">dd</tag><tag class="starttag">p</tag>Paragraph 1 of definition 2.<tag class="endtag">p</tag><tag class="endtag">dd</tag> - <sgmltag class="starttag">dt</sgmltag>Term 3<sgmltag class="endtag">dt</sgmltag> + <tag class="starttag">dt</tag>Term 3<tag class="endtag">dt</tag> - <sgmltag class="starttag">dd</sgmltag><sgmltag class="starttag">p</sgmltag>Paragraph 1 of definition 3.<sgmltag class="endtag">p</sgmltag><sgmltag class="endtag">dd</sgmltag> -<sgmltag class="endtag">dl</sgmltag></programlisting> + <tag class="starttag">dd</tag><tag class="starttag">p</tag>Paragraph 1 of definition 3.<tag class="endtag">p</tag><tag class="endtag">dd</tag> +<tag class="endtag">dl</tag></programlisting> </example> </sect2> - <sect2 id="xhtml-markup-block-elements-preformatted-text"> + <sect2 xml:id="xhtml-markup-block-elements-preformatted-text"> <title>Pre-formatted Text</title> <para>Pre-formatted text is shown to the user exactly as it is @@ -307,16 +305,16 @@ and line breaks are shown exactly as they are in the file.</para> - <para>Wrap pre-formatted text in the <sgmltag>pre</sgmltag> + <para>Wrap pre-formatted text in the <tag>pre</tag> element.</para> <example> - <title><sgmltag>pre</sgmltag></title> + <title><tag>pre</tag></title> - <para>For example, the <sgmltag>pre</sgmltag> tags could be + <para>For example, the <tag>pre</tag> tags could be used to mark up an email message:</para> - <programlisting><sgmltag class="starttag">pre</sgmltag> From: nik@FreeBSD.org + <programlisting><tag class="starttag">pre</tag> From: nik@FreeBSD.org To: freebsd-doc@FreeBSD.org Subject: New documentation available @@ -327,7 +325,7 @@ Comments appreciated. - N<sgmltag class="endtag">pre</sgmltag></programlisting> + N<tag class="endtag">pre</tag></programlisting> <para>Keep in mind that <literal><</literal> and <literal>&</literal> still are recognized as special @@ -341,139 +339,139 @@ </example> </sect2> - <sect2 id="xhtml-markup-block-elements-tables"> + <sect2 xml:id="xhtml-markup-block-elements-tables"> <title>Tables</title> <para>Mark up tabular information using the - <sgmltag>table</sgmltag> element. A table consists of one or - more table rows (<sgmltag>tr</sgmltag>), each containing one - or more cells of table data (<sgmltag>td</sgmltag>). Each + <tag>table</tag> element. A table consists of one or + more table rows (<tag>tr</tag>), each containing one + or more cells of table data (<tag>td</tag>). Each cell can contain other block elements, such as paragraphs or lists. It can also contain another table (this nesting can repeat indefinitely). If the cell only contains one paragraph - then the <sgmltag>p</sgmltag>element is not needed.</para> + then the <tag>p</tag>element is not needed.</para> <example> - <title>Simple Use of <sgmltag>table</sgmltag></title> + <title>Simple Use of <tag>table</tag></title> <para>Usage:</para> - <programlisting><sgmltag class="starttag">p</sgmltag>This is a simple 2x2 table.<sgmltag class="endtag">p</sgmltag> + <programlisting><tag class="starttag">p</tag>This is a simple 2x2 table.<tag class="endtag">p</tag> -<sgmltag class="starttag">table</sgmltag> - <sgmltag class="starttag">tr</sgmltag> - <sgmltag class="starttag">td</sgmltag>Top left cell<sgmltag class="endtag">td</sgmltag> +<tag class="starttag">table</tag> + <tag class="starttag">tr</tag> + <tag class="starttag">td</tag>Top left cell<tag class="endtag">td</tag> - <sgmltag class="starttag">td</sgmltag>Top right cell<sgmltag class="endtag">td</sgmltag> - <sgmltag class="endtag">tr</sgmltag> + <tag class="starttag">td</tag>Top right cell<tag class="endtag">td</tag> + <tag class="endtag">tr</tag> - <sgmltag class="starttag">tr</sgmltag> - <sgmltag class="starttag">td</sgmltag>Bottom left cell<sgmltag class="endtag">td</sgmltag> + <tag class="starttag">tr</tag> + <tag class="starttag">td</tag>Bottom left cell<tag class="endtag">td</tag> - <sgmltag class="starttag">td</sgmltag>Bottom right cell<sgmltag class="endtag">td</sgmltag> - <sgmltag class="endtag">tr</sgmltag> -<sgmltag class="endtag">table</sgmltag></programlisting> + <tag class="starttag">td</tag>Bottom right cell<tag class="endtag">td</tag> + <tag class="endtag">tr</tag> +<tag class="endtag">table</tag></programlisting> </example> <para>A cell can span multiple rows and columns by adding the - <sgmltag class="attribute">rowspan</sgmltag> or - <sgmltag class="attribute">colspan</sgmltag> attributes with + <tag class="attribute">rowspan</tag> or + <tag class="attribute">colspan</tag> attributes with values for the number of rows or columns to be spanned.</para> <example> <title>Using - <sgmltag class="attribute">rowspan</sgmltag></title> + <tag class="attribute">rowspan</tag></title> <para>Usage:</para> - <programlisting><sgmltag class="starttag">p</sgmltag>One tall thin cell on the left, two short cells next to - it on the right.<sgmltag class="endtag">p</sgmltag> + <programlisting><tag class="starttag">p</tag>One tall thin cell on the left, two short cells next to + it on the right.<tag class="endtag">p</tag> -<sgmltag class="starttag">table</sgmltag> - <sgmltag class="starttag">tr</sgmltag> - <sgmltag class="starttag">td rowspan="2"</sgmltag>Long and thin<sgmltag class="endtag">td</sgmltag> - <sgmltag class="endtag">tr</sgmltag> +<tag class="starttag">table</tag> + <tag class="starttag">tr</tag> + <tag class="starttag">td rowspan="2"</tag>Long and thin<tag class="endtag">td</tag> + <tag class="endtag">tr</tag> - <sgmltag class="starttag">tr</sgmltag> - <sgmltag class="starttag">td</sgmltag>Top cell<sgmltag class="endtag">td</sgmltag> + <tag class="starttag">tr</tag> + <tag class="starttag">td</tag>Top cell<tag class="endtag">td</tag> - <sgmltag class="starttag">td</sgmltag>Bottom cell<sgmltag class="endtag">td</sgmltag> - <sgmltag class="endtag">tr</sgmltag> -<sgmltag class="endtag">table</sgmltag></programlisting> + <tag class="starttag">td</tag>Bottom cell<tag class="endtag">td</tag> + <tag class="endtag">tr</tag> +<tag class="endtag">table</tag></programlisting> </example> <example> <title>Using - <sgmltag class="attribute">colspan</sgmltag></title> + <tag class="attribute">colspan</tag></title> <para>Usage:</para> - <programlisting><sgmltag class="starttag">p</sgmltag>One long cell on top, two short cells below it.<sgmltag class="endtag">p</sgmltag> + <programlisting><tag class="starttag">p</tag>One long cell on top, two short cells below it.<tag class="endtag">p</tag> -<sgmltag class="starttag">table</sgmltag> - <sgmltag class="starttag">tr</sgmltag> - <sgmltag class="starttag">td colspan="2"</sgmltag>Top cell<sgmltag class="endtag">td</sgmltag> - <sgmltag class="endtag">tr</sgmltag> +<tag class="starttag">table</tag> + <tag class="starttag">tr</tag> + <tag class="starttag">td colspan="2"</tag>Top cell<tag class="endtag">td</tag> + <tag class="endtag">tr</tag> - <sgmltag class="starttag">tr</sgmltag> - <sgmltag class="starttag">td</sgmltag>Bottom left cell<sgmltag class="endtag">td</sgmltag> + <tag class="starttag">tr</tag> + <tag class="starttag">td</tag>Bottom left cell<tag class="endtag">td</tag> - <sgmltag class="starttag">td</sgmltag>Bottom right cell<sgmltag class="endtag">td</sgmltag> - <sgmltag class="endtag">tr</sgmltag> -<sgmltag class="endtag">table</sgmltag></programlisting> + <tag class="starttag">td</tag>Bottom right cell<tag class="endtag">td</tag> + <tag class="endtag">tr</tag> +<tag class="endtag">table</tag></programlisting> </example> <example> - <title>Using <sgmltag class="attribute">rowspan</sgmltag> and - <sgmltag class="attribute">colspan</sgmltag> + <title>Using <tag class="attribute">rowspan</tag> and + <tag class="attribute">colspan</tag> Together</title> <para>Usage:</para> - <programlisting><sgmltag class="starttag">p</sgmltag>On a 3x3 grid, the top left block is a 2x2 set of - cells merged into one. The other cells are normal.<sgmltag class="endtag">p</sgmltag> + <programlisting><tag class="starttag">p</tag>On a 3x3 grid, the top left block is a 2x2 set of + cells merged into one. The other cells are normal.<tag class="endtag">p</tag> -<sgmltag class="starttag">table</sgmltag> - <sgmltag class="starttag">tr</sgmltag> - <sgmltag class="starttag">td colspan="2" rowspan="2"</sgmltag>Top left large cell<sgmltag class="endtag">td</sgmltag> +<tag class="starttag">table</tag> + <tag class="starttag">tr</tag> + <tag class="starttag">td colspan="2" rowspan="2"</tag>Top left large cell<tag class="endtag">td</tag> - <sgmltag class="starttag">td</sgmltag>Top right cell<sgmltag class="endtag">td</sgmltag> - <sgmltag class="endtag">tr</sgmltag> + <tag class="starttag">td</tag>Top right cell<tag class="endtag">td</tag> + <tag class="endtag">tr</tag> - <sgmltag class="starttag">tr</sgmltag> + <tag class="starttag">tr</tag> <!-- Because the large cell on the left merges into this row, the first <td> will occur on its right --> - <sgmltag class="starttag">td</sgmltag>Middle right cell<sgmltag class="endtag">td</sgmltag> - <sgmltag class="endtag">tr</sgmltag> + <tag class="starttag">td</tag>Middle right cell<tag class="endtag">td</tag> + <tag class="endtag">tr</tag> - <sgmltag class="starttag">tr</sgmltag> - <sgmltag class="starttag">td</sgmltag>Bottom left cell<sgmltag class="endtag">td</sgmltag> + <tag class="starttag">tr</tag> + <tag class="starttag">td</tag>Bottom left cell<tag class="endtag">td</tag> - <sgmltag class="starttag">td</sgmltag>Bottom middle cell<sgmltag class="endtag">td</sgmltag> + <tag class="starttag">td</tag>Bottom middle cell<tag class="endtag">td</tag> - <sgmltag class="starttag">td</sgmltag>Bottom right cell<sgmltag class="endtag">td</sgmltag> - <sgmltag class="endtag">tr</sgmltag> -<sgmltag class="endtag">table</sgmltag></programlisting> + <tag class="starttag">td</tag>Bottom right cell<tag class="endtag">td</tag> + <tag class="endtag">tr</tag> +<tag class="endtag">table</tag></programlisting> </example> </sect2> </sect1> - <sect1 id="xhtml-markup-inline-elements"> + <sect1 xml:id="xhtml-markup-inline-elements"> <title>In-line Elements</title> - <sect2 id="xhtml-markup-inline-elements-emphasizing-information"> + <sect2 xml:id="xhtml-markup-inline-elements-emphasizing-information"> <title>Emphasizing Information</title> <para>Two levels of emphasis are available in - <acronym>XHTML</acronym>, <sgmltag>em</sgmltag> and - <sgmltag>strong</sgmltag>. <sgmltag>em</sgmltag> is for a - normal level of emphasis and <sgmltag>strong</sgmltag> + <acronym>XHTML</acronym>, <tag>em</tag> and + <tag>strong</tag>. <tag>em</tag> is for a + normal level of emphasis and <tag>strong</tag> indicates stronger emphasis.</para> - <para><sgmltag>em</sgmltag> is typically rendered in italic - and <sgmltag>strong</sgmltag> is rendered in bold. This is + <para><tag>em</tag> is typically rendered in italic + and <tag>strong</tag> is rendered in bold. This is not always the case, and should not be relied upon. According to best practices, web pages only hold structural and semantical information, and stylesheets are later applied to @@ -481,47 +479,47 @@ tags.</para> <example> - <title><sgmltag>em</sgmltag> and - <sgmltag>strong</sgmltag></title> + <title><tag>em</tag> and + <tag>strong</tag></title> <para>Usage:</para> - <programlisting><sgmltag class="starttag">p</sgmltag><sgmltag class="starttag">em</sgmltag>This<sgmltag class="endtag">em</sgmltag> has been emphasized, while - <sgmltag class="starttag">strong</sgmltag>this<sgmltag class="endtag">strong</sgmltag> has been strongly emphasized.<sgmltag class="endtag">p</sgmltag></programlisting> + <programlisting><tag class="starttag">p</tag><tag class="starttag">em</tag>This<tag class="endtag">em</tag> has been emphasized, while + <tag class="starttag">strong</tag>this<tag class="endtag">strong</tag> has been strongly emphasized.<tag class="endtag">p</tag></programlisting> </example> </sect2> - <sect2 id="xhtml-markup-inline-elements-fixed-pitch-text"> + <sect2 xml:id="xhtml-markup-inline-elements-fixed-pitch-text"> <title>Indicating Fixed-Pitch Text</title> <para>Content that should be rendered in a fixed pitch - (typewriter) typeface is tagged with <sgmltag>tt</sgmltag> + (typewriter) typeface is tagged with <tag>tt</tag> (for <quote>teletype</quote>).</para> <example> - <title><sgmltag>tt</sgmltag></title> + <title><tag>tt</tag></title> <para>Usage:</para> - <programlisting><sgmltag class="starttag">p</sgmltag>Many system settings are stored in - <sgmltag class="starttag">tt</sgmltag>/etc<sgmltag class="endtag">tt</sgmltag>.<sgmltag class="endtag">p</sgmltag></programlisting> + <programlisting><tag class="starttag">p</tag>Many system settings are stored in + <tag class="starttag">tt</tag>/etc<tag class="endtag">tt</tag>.<tag class="endtag">p</tag></programlisting> </example> </sect2> - <sect2 id="xhtml-markup-inline-elements-links"> + <sect2 xml:id="xhtml-markup-inline-elements-links"> <title>Links</title> <note> <para>Links are also inline elements.</para> </note> - <sect3 id="xhtml-markup-inline-elements-linking"> + <sect3 xml:id="xhtml-markup-inline-elements-linking"> <title>Linking to Other Documents on the Web</title> <para>A link points to the <acronym>URL</acronym> of a document on the web. The link is indicated with - <sgmltag>a</sgmltag>, and the - <sgmltag class="attribute">href</sgmltag> attribute contains + <tag>a</tag>, and the + <tag class="attribute">href</tag> attribute contains the <acronym>URL</acronym> of the target document. The content of the element becomes the link, indicated to the user by showing it in a different color or with an @@ -529,28 +527,28 @@ <example> <title>Using - <sgmltag class="starttag">a href="..."</sgmltag></title> + <tag class="starttag">a href="..."</tag></title> <para>Usage:</para> - <programlisting><sgmltag class="starttag">p</sgmltag>More information is available at the - <sgmltag class="starttag">a href="http://www.&os;.org/"</sgmltag>&os; web site<sgmltag class="endtag">a</sgmltag>.<sgmltag class="endtag">p</sgmltag></programlisting> + <programlisting><tag class="starttag">p</tag>More information is available at the + <tag class="starttag">a href="http://www.&os;.org/"</tag>&os; web site<tag class="endtag">a</tag>.<tag class="endtag">p</tag></programlisting> </example> <para>This link always takes the user to the top of the linked document.</para> </sect3> - <sect3 id="xhtml-markup-inline-elements-specific-parts"> + <sect3 xml:id="xhtml-markup-inline-elements-specific-parts"> <title>Linking to Specific Parts of Documents</title> <para>To link to a specific point within a document, that document must include an <emphasis>anchor</emphasis> at the desired point. Anchors are included by setting the - <sgmltag class="attribute">id</sgmltag> attribute of an + <tag class="attribute">id</tag> attribute of an element to a name. This example creates an anchor by - setting the <sgmltag class="attribute">id</sgmltag> - attribute of a <sgmltag class="element">p</sgmltag> + setting the <tag class="attribute">id</tag> + attribute of a <tag class="element">p</tag> element.</para> <example> @@ -558,8 +556,8 @@ <para>Usage:</para> - <programlisting><sgmltag class="starttag">p id="samplepara"</sgmltag>This paragraph can be referenced - in other links with the name <sgmltag class="starttag">tt</sgmltag>samplepara<sgmltag class="endtag">tt</sgmltag>.<sgmltag class="endtag">p</sgmltag></programlisting> + <programlisting><tag class="starttag">p id="samplepara"</tag>This paragraph can be referenced + in other links with the name <tag class="starttag">tt</tag>samplepara<tag class="endtag">tt</tag>.<tag class="endtag">p</tag></programlisting> </example> <para>Links to anchors are similar to plain links, but include @@ -576,9 +574,9 @@ that specific paragraph in the document is constructed in this example.</para> - <programlisting><sgmltag class="starttag">p</sgmltag>More information can be found in the - <sgmltag class="starttag">a href="foo.html#samplepara"</sgmltag>sample paragraph<sgmltag class="endtag">a</sgmltag> of - <sgmltag class="starttag">tt</sgmltag>foo.html<sgmltag class="endtag">tt</sgmltag>.<sgmltag class="endtag">p</sgmltag></programlisting> + <programlisting><tag class="starttag">p</tag>More information can be found in the + <tag class="starttag">a href="foo.html#samplepara"</tag>sample paragraph<tag class="endtag">a</tag> of + <tag class="starttag">tt</tag>foo.html<tag class="endtag">tt</tag>.<tag class="endtag">p</tag></programlisting> </example> <para>To link to a named anchor within the same document, omit @@ -592,9 +590,9 @@ <para>The <literal>samplepara</literal> example resides in this document. To link to it:</para> - <programlisting><sgmltag class="starttag">p</sgmltag>More information can be found in the - <sgmltag class="starttag">a href="#samplepara"</sgmltag>sample paragraph<sgmltag class="endtag">a</sgmltag> of this - document.<sgmltag class="endtag">p</sgmltag></programlisting> + <programlisting><tag class="starttag">p</tag>More information can be found in the + <tag class="starttag">a href="#samplepara"</tag>sample paragraph<tag class="endtag">a</tag> of this + document.<tag class="endtag">p</tag></programlisting> </example> </sect3> </sect2> |