Source string Read only

(itstool) path: example/title
50/500
Context English State
Introduction
This chapter describes usage of the <acronym>XHTML</acronym> markup language used for the FreeBSD web site.
<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 <uri xlink:href="http://www.w3.org/">http://www.w3.org/</uri>.
<acronym>XHTML</acronym> is used to mark up pages on the FreeBSD web site. It is usually not used to mark up other documentation, since DocBook offers a far richer set of elements from which to choose. Consequently, <acronym>XHTML</acronym> pages will normally only be encountered when writing for the web site.
<acronym>HTML</acronym> has gone through a number of versions. The <acronym>XML</acronym>-compliant version described here is called <acronym>XHTML</acronym>. The latest widespread version is <acronym>XHTML</acronym> 1.0, available in both <emphasis>strict</emphasis> and <emphasis>transitional</emphasis> variants.
The <acronym>XHTML</acronym> <acronym>DTDs</acronym> are available from the Ports Collection in <package>textproc/xhtml</package>. They are automatically installed by the <package>textproc/docproj</package> port.
This is <emphasis>not</emphasis> an exhaustive list of elements, since that would just repeat the documentation for <acronym>XHTML</acronym>. The aim is to list those elements most commonly used. Please post questions about elements or uses not covered here to the <link xlink:href="http://lists.FreeBSD.org/mailman/listinfo/freebsd-doc">FreeBSD documentation project mailing list</link>.
Inline Versus Block
In the remainder of this document, when describing elements, <emphasis>inline</emphasis> means that the element can occur within a block element, and does not cause a line break. A <emphasis>block</emphasis> element, by comparison, will cause a line break (and other processing) when it is encountered.
Formal Public Identifier (<acronym>FPI</acronym>)
There are a number of <acronym>XHTML</acronym> <acronym>FPI</acronym>s, depending upon the version, or <emphasis>level</emphasis> of <acronym>XHTML</acronym> to which a document conforms. Most <acronym>XHTML</acronym> documents on the FreeBSD web site comply with the transitional version of <acronym>XHTML</acronym> 1.0.
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
Sectional Elements
An <acronym>XHTML</acronym> document is normally split into two sections. The first section, called the <emphasis>head</emphasis>, contains meta-information about the document, such as its title, the name of the author, the parent document, and so on. The second section, the <emphasis>body</emphasis>, contains content that will be displayed to the user.
These sections are indicated with <tag>head</tag> and <tag>body</tag> elements respectively. These elements are contained within the top-level <tag>html</tag> element.
Normal <acronym>XHTML</acronym> Document Structure
<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>

<tag class="starttag">body</tag>



<tag class="endtag">body</tag>
<tag class="endtag">html</tag>
Block Elements
Headings
<acronym>XHTML</acronym> has tags to denote headings in the document at up to six different levels.
The largest and most prominent heading is <tag>h1</tag>, then <tag>h2</tag>, continuing down to <tag>h6</tag>.
The element's content is the text of the heading.
<tag>h1</tag>, <tag>h2</tag>, and Other Header Tags
Usage:
<tag class="starttag">h1</tag>First section<tag class="endtag">h1</tag>

&lt;!-- Document introduction goes here --&gt;

<tag class="starttag">h2</tag>This is the heading for the first section<tag class="endtag">h2</tag>

&lt;!-- Content for the first section goes here --&gt;

<tag class="starttag">h3</tag>This is the heading for the first sub-section<tag class="endtag">h3</tag>

&lt;!-- Content for the first sub-section goes here --&gt;

<tag class="starttag">h2</tag>This is the heading for the second section<tag class="endtag">h2</tag>

&lt;!-- Content for the second section goes here --&gt;
Generally, an <acronym>XHTML</acronym> page should have 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.
Paragraphs
<acronym>XHTML</acronym> supports a single paragraph element, <tag>p</tag>.
<tag>p</tag> Example
<tag class="starttag">p</tag>This is a paragraph. It can contain just about any
other element.<tag class="endtag">p</tag>
Block Quotations

Loading…

No matching activity found.

Browse all component changes

Glossary

English English
No related strings found in the glossary.

Source information

Source string comment
(itstool) path: example/title
Flags
read-only
Source string location
book.translate.xml:3559
String age
a year ago
Source string age
a year ago
Translation file
books/fdp-primer.pot, string 587