📄 format.html
字号:
[]
--------------------------------------------
Verbatim text not contained in list item 3
--------------------------------------------
</pre></div><p>In the previous example, without the <tt>[]</tt>, the verbatim text (not indented as all displays) would have been contained in list item 3.</p><p>A single <tt>[]</tt> may be used to end several nested lists at the same time. The indentation of <tt>[]</tt> may be used to specify exactly which lists should be ended. Example:</p><div class="source"><pre> * List item 1.
* List item 2.
* Sub-list item 1.
* Sub-list item 2.
[]
-------------------------------------------------------------------
Verbatim text contained in list item 2, but not in sub-list item 2
-------------------------------------------------------------------
</pre></div><p>There are three kind of lists, the bulleted lists we have already described, the numbered lists and the definition lists.</p><div class="source"><pre> [[1]] Numbered item 1.
[[A]] Numbered item A.
[[B]] Numbered item B.
[[2]] Numbered item 2.
</pre></div><p>A numbered list item begins with a label beetween two square brackets. The label of the first item establishes the numbering scheme for the whole list:</p><dl><dt><tt>[[1]]</tt></dt><dd>Decimal numbering: 1, 2, 3, 4, etc.</dd><dt><tt>[[a]]</tt></dt><dd>Lower-alpha numbering: a, b, c, d, etc.</dd><dt><tt>[[A]]</tt></dt><dd>Upper-alpha numbering: A, B, C, D, etc.</dd><dt><tt>[[i]]</tt></dt><dd>Lower-roman numbering: i, ii, iii, iv, etc.</dd><dt><tt>[[I]]</tt></dt><dd>Upper-roman numbering: I, II, III, IV, etc.</dd></dl><p>The labels of the items other than the first one are ignored. It is recommended to take the time to type the correct label for each item in order to keep the APT source document readable.</p><div class="source"><pre> [Defined term 1] of definition list 2.
[Defined term 2] of definition list 2.
</pre></div><p>A definition list item begins with a defined term: text between square brackets.</p></div><div class="section"><h5>Verbatim text</h5><div class="source"><pre>----------------------------------------
Verbatim
text,
preformatted,
escaped.
----------------------------------------
</pre></div><p>A verbatim block is not indented. It begins with a non indented line containing at least 3 dashes (<tt>---</tt>). It ends with a similar line.</p><p><tt>+--</tt> instead of <tt>---</tt> draws a box around verbatim text.</p><p>Like in HTML, verbatim text is preformatted. Unlike HTML, verbatim text is escaped: inside a verbatim display, markup is not interpreted by the APT processor.</p></div><div class="section"><h5>Figure</h5><div class="source"><pre>[Figure name] Figure caption
</pre></div><p>A figure block is not indented. It begins with the figure name between square brackets. The figure name is optionally followed by some text: the figure caption.</p><p>The figure name is the pathname of the file containing the figure but without an extension. Example: if your figure is contained in <tt>/home/joe/docs/mylogo.jpeg</tt>, the figure name is <tt>/home/joe/docs/mylogo</tt>.</p><p>If the figure name comes from a relative pathname (recommended practice) rather than from an absolute pathname, this relative pathname is taken to be relative to the directory of the current APT document (a la HTML) rather than relative to the current working directory.</p><p>Why not leave the file extension in the figure name? This is better explained by an example. You need to convert an APT document to PostScript and your figure name is <tt>/home/joe/docs/mylogo</tt>. A APT processor will first try to load <tt>/home/joe/docs/mylogo.eps</tt>. When the desired format is not found, a APT processor tries to convert one of the existing formats. In our example, the APT processor tries to convert <tt>/home/joe/docs/mylogo.jpeg</tt> to encapsulated PostScript.</p></div><div class="section"><h5>Table</h5><p>A table block is not indented. It begins with a non indented line containing an asterisk and at least 2 dashes (<tt>*--</tt>). It ends with a similar line.</p><p>The first line is not only used to recognize a table but also to specify column justification. In the following example, </p><ul><li>the second asterisk (<tt>*</tt>) is used to specify that column 1 is centered,</li><li>the plus sign (<tt>+</tt>) specifies that column 2 is left aligned, </li><li>the colon (<tt>:</tt>) specifies that column 3 is right aligned.</li></ul><div class="source"><pre>*----------*--------------+----------------:
| Centered | Left-aligned | Right-aligned |
| cell 1,1 | cell 1,2 | cell 1,3 |
*----------*--------------+----------------:
| cell 2,1 | cell 2,2 | cell 2,3 |
*----------*--------------+----------------:
Table caption
</pre></div><p>Rows are separated by a non indented line beginning with <tt>*--</tt>.</p><p>An optional table caption (non indented text) may immediately follow the table.</p><p>Rows may contain single line or multiple line cells. Each line of cell text is separated from the adjacent cell by the pipe character (<tt>|</tt>). (<tt>|</tt> may be used in the cell text if quoted: <tt>\|</tt>.)</p><p>The last <tt>|</tt> is only used to make the table nicer. The first <tt>|</tt> is not only used to make the table nicer, but also to specify that a grid is to be drawn around table cells.</p><p>The following example shows a simple table with no grid and no caption.</p><div class="source"><pre>*-----*------*
cell | cell
*-----*------*
cell | cell
*-----*------*
</pre></div></div><div class="section"><h5>Horizontal rule</h5><div class="source"><pre>=====================
</pre></div><p>A non indented line containing at least 3 equal signs (<tt>===</tt>).</p></div><div class="section"><h5>Page break</h5><div class="source"><pre>^L
</pre></div><p>A non indented line containing a single form feed character (Control-L).</p></div></div><div class="section"><h4>Text level elements</h4><div class="section"><h5>Font</h5><div class="source"><pre> <Italic> font. <<Bold>> font. <<<Monospaced>>> font.
</pre></div><p>Text between < and > must be rendered in italic. Text between << and >> must be rendered in bold. Text between <<< and >>> must be rendered using a monospaced, typewriter-like font.</p><p>Font elements may appear anywhere except inside other font elements.</p><p>It is not recommended to use font elements inside titles, section titles, links and defined terms because a APT processor automatically applies appropriate font styles to these elements.</p></div><div class="section"><h5>Anchor and link</h5><div class="source"><pre> {Anchor}. Link to {{anchor}}. Link to {{http://www.pixware.fr}}.
Link to {{{anchor}showing alternate text}}.
Link to {{{http://www.pixware.fr}Pixware home page}}.
</pre></div><p>Text between curly braces (<tt>{}</tt>) specifies an anchor. Text between double curly braces (<tt>{{}}</tt>) specifies a link.</p><p>It is an error to create a link element that does not refer to an anchor of the same name. The name of an anchor/link is its text with all non alphanumeric characters stripped.</p><p>This rule does not apply to links to <i>external</i> anchors. Text beginning with <tt>http:/</tt>, <tt>https:/</tt>, <tt>ftp:/</tt>, <tt>file:/</tt>, <tt>mailto:</tt>, <tt>../</tt>, <tt>./</tt> (<tt>..\</tt> and <tt>.\</tt> on Windows) is recognized as an external anchor name.</p><p>When the construct <b>{{{</b><i>name</i><b>}</b><i>text</i><b>}}</b> is used, the link text <i>text</i> may differ from the link name <i>name</i>.</p><p>Anchor/link elements may appear anywhere except inside other anchor/link elements.</p><p>Section titles are implicitly defined anchors.</p></div><div class="section"><h5>Line break</h5><div class="source"><pre> Force line\
break.
</pre></div><p>A backslash character (<tt>\</tt>) followed by a newline character.</p><p>Line breaks must not be used inside titles and tables (which are line oriented blocks with implicit line breaks).</p></div><div class="section"><h5>Non breaking space</h5><div class="source"><pre> Non\ breaking\ space.
</pre></div><p>A backslash character (<tt>\</tt>) followed by a space character.</p></div><div class="section"><h5>Special character</h5><div class="source"><pre> Escaped special characters: \~, \=, \-, \+, \*, \[, \], \<, \>, \{, \}, \\.
</pre></div><p>In certain contexts, these characters have a special meaning and therefore must be escaped if needed as is. They are escaped by adding a backslash in front of them. The backslash may itself be escaped by adding another backslash in front of it.</p><p>Note that an asterisk, for example, needs to be escaped only if its begins a paragraph. (<tt>*</tt> has no special meaning in the middle of a paragraph.)</p><div class="source"><pre> Copyright symbol: \251, \xA9, \u00a9.
</pre></div><p>Latin-1 characters (whatever is the encoding of the APT document) may be specified by their codes using a backslash followed by one to three octal digits or by using the <tt>\x</tt><i>NN</i> notation, where <i>NN</i> are two hexadecimal digits.</p><p>Unicode characters may be specified by their codes using the <tt>\u</tt><i>NNNN</i> notation, where <i>NNNN</i> are four hexadecimal digits.</p></div><div class="section"><h5>Comment</h5><div class="source"><pre>~~Commented out.
</pre></div><p>Text found after two tildes (<tt>~~</tt>) is ignored up to the end of line.</p><p>A line of <tt>~</tt> is often used to ``underline'' section titles in order to make them stand out of other paragraphs.</p></div></div></div><div class="section"><h3>The APT format at a glance</h3><div class="source"><pre> ------
Title
------
Author
------
Date
Paragraph 1, line 1.
Paragraph 1, line 2.
Paragraph 2, line 1.
Paragraph 2, line 2.
Section title
* Sub-section title
** Sub-sub-section title
*** Sub-sub-sub-section title
**** Sub-sub-sub-sub-section title
* List item 1.
* List item 2.
Paragraph contained in list item 2.
* Sub-list item 1.
* Sub-list item 2.
* List item 3.
Force end of list:
[]
+------------------------------------------+
Verbatim text not contained in list item 3
+------------------------------------------+
[[1]] Numbered item 1.
[[A]] Numbered item A.
[[B]] Numbered item B.
[[2]] Numbered item 2.
List numbering schemes: [[1]], [[a]], [[A]], [[i]], [[I]].
[Defined term 1] of definition list.
[Defined term 2] of definition list.
+-------------------------------+
Verbatim text
in a box
+-------------------------------+
--- instead of +-- suppresses the box around verbatim text.
[Figure name] Figure caption
*----------*--------------+----------------:
| Centered | Left-aligned | Right-aligned |
| cell 1,1 | cell 1,2 | cell 1,3 |
*----------*--------------+----------------:
| cell 2,1 | cell 2,2 | cell 2,3 |
*----------*--------------+----------------:
Table caption
No grid, no caption:
*-----*------*
cell | cell
*-----*------*
cell | cell
*-----*------*
Horizontal line:
=======================================================================
^L
New page.
<Italic> font. <<Bold>> font. <<<Monospaced>>> font.
{Anchor}. Link to {{anchor}}. Link to {{http://www.pixware.fr}}.
Link to {{{anchor}showing alternate text}}.
Link to {{{http://www.pixware.fr}Pixware home page}}.
Force line\
break.
Non\ breaking\ space.
Escaped special characters: \~, \=, \-, \+, \*, \[, \], \<, \>, \{, \}, \\.
Copyright symbol: \251, \xA9, \u00a9.
~~Commented out.
</pre></div></div></div>
</div>
</div>
<div class="clear">
<hr/>
</div>
<div id="footer">
<div class="xright">©
2004-2006
</div>
<div class="clear">
<hr/>
</div>
</div>
</body>
</html>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -