people to make announcements and suggestions and to discuss
issues in the comments section.
</fo:block>
- <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2759914">
+ <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2778354">
<fo:block font-size="14pt" font-weight="bold" keep-with-next="always">Note</fo:block>
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
Note that the information in the
source nature of SGML. To contribute to the GDP you should
learn to use DocBook.
</fo:block>
- <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2760000">
+ <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2778442">
<fo:block font-size="14pt" font-weight="bold" keep-with-next="always">NOTE</fo:block>
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
To get started writing for the GDP you do not need to rush
DTD's. To install the GDP custom DTD with PNG image support
by hand:
</fo:block>
- <fo:list-block id="id2760410" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" provisional-distance-between-starts="1.5em" provisional-label-separation="0.2em">
- <fo:list-item id="id2760422" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-block id="id2778818" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" provisional-distance-between-starts="1.5em" provisional-label-separation="0.2em">
+ <fo:list-item id="id2778830" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
</fo:block>
</fo:list-item-body>
</fo:list-item>
- <fo:list-item id="id2760596" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2778991" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
distribution. (On Red Hat it is usually in
/usr/lib/sgml/CATALOG.) Add the following line to this
file:
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.0//EN" "png-support-3.0.dtd"
</fo:block>
If you are using the 3.1 DTD, use:
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN" "png-support-3.1.dtd"
</fo:block>
</fo:block>
</fo:block>
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
Articles:
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
<!DOCTYPE Article PUBLIC "-//GNOME//DTD DocBook PNG Variant
V1.1//EN"[]>
</fo:block>
</fo:block>
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
Books:
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
<!DOCTYPE Book PUBLIC "-//GNOME//DTD DocBook PNG Variant
V1.1//EN"[]>
</fo:block>
mydocument.sgml</fo:inline>, after which you can print out or
view the resulting .ps file.
</fo:block>
- <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2882612">
+ <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2778910">
<fo:block font-size="14pt" font-weight="bold" keep-with-next="always">NOTE</fo:block>
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
The html files you get will not look quite the same as the
include the extension of the image file, since DocBook
Tools will automatically insert it for you. For example:
</fo:block>
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
<figure>
<title>My Image</title>
The following resources on the web are useful for learning
DocBook:
</fo:block>
- <fo:list-block id="id2882902" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" provisional-distance-between-starts="1.5em" provisional-label-separation="0.2em">
- <fo:list-item id="id2882900" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-block id="id2901550" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" provisional-distance-between-starts="1.5em" provisional-label-separation="0.2em">
+ <fo:list-item id="id2901547" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
</fo:block>
</fo:list-item-body>
</fo:list-item>
- <fo:list-item id="id2882955" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2901602" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
</fo:block>
</fo:list-item-body>
</fo:list-item>
- <fo:list-item id="id2882995" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2901643" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
</fo:block>
</fo:list-item-body>
</fo:list-item>
- <fo:list-item id="id2883035" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2901682" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
The following sections of this document are designed to help
documentation authors write correct and consistent DocBook:
</fo:block>
- <fo:list-block id="id2883104" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" provisional-distance-between-starts="1.5em" provisional-label-separation="0.2em">
- <fo:list-item id="id2883101" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-block id="id2901752" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" provisional-distance-between-starts="1.5em" provisional-label-separation="0.2em">
+ <fo:list-item id="id2901749" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
advised</fo:inline> that the documentation writers conform to XML
syntax rules. Here are most important differences:
</fo:block>
- <fo:list-block id="id2885600" provisional-distance-between-starts="1in" provisional-label-separation="0.25in" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
- <fo:list-item id="id2885606" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-block id="id2904247" provisional-distance-between-starts="1in" provisional-label-separation="0.25in" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2904253" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>
<fo:inline> <fo:inline font-style="italic">Minimization</fo:inline></fo:inline>
</fo:block>
</fo:list-item-body>
</fo:list-item>
- <fo:list-item id="id2885739" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2904386" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>
<fo:inline> <fo:inline font-style="italic">Self-closing tags</fo:inline></fo:inline>
</fo:block>
</fo:list-item-body>
</fo:list-item>
- <fo:list-item id="id2885822" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2904469" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>
<fo:inline> <fo:inline font-style="italic">Case sensitive tags</fo:inline></fo:inline>
<fo:inline font-family="Courier"><note></fo:inline>, <fo:inline font-family="Courier"><tip></fo:inline>,
<fo:inline font-family="Courier"><warning></fo:inline>,
<fo:inline font-family="Courier"><important></fo:inline> respectively. For example:
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
<tip>
<title>TIP</title>
To include screenshots and other figures, use the following
tags:
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
<figure id="shot1">
<title>Screenshot</title>
replacing <fo:inline font-family="Courier">example_screenshot</fo:inline> with the
actual file name (without extension). The result will look like this:
- <fo:block id="shot1" space-before.minimum="1em" space-before.optimum="1.5em" space-before.maximum="2em" space-after.minimum="1em" space-after.optimum="1.5em" space-after.maximum="2em" keep-with-previous.within-column="always"><fo:block font-weight="bold" font-size="12pt" hyphenate="false" keep-with-next.within-column="always">Screenshot</fo:block><fo:block><fo:block><fo:external-graphic src="url(file:figures/example_screenshot)" content-width="auto" content-height="auto" width="auto" height="auto"/></fo:block></fo:block></fo:block>
+ <fo:block id="shot1" space-before.minimum="1em" space-before.optimum="1.5em" space-before.maximum="2em" space-after.minimum="1em" space-after.optimum="1.5em" space-after.maximum="2em" keep-with-previous.within-column="always"><fo:block font-weight="bold" font-size="12pt" hyphenate="false" keep-with-next.within-column="always" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">Screenshot</fo:block><fo:block><fo:block><fo:external-graphic src="url(file:figures/example_screenshot)" content-width="auto" content-height="auto" width="auto" height="auto"/></fo:block></fo:block></fo:block>
</fo:block>
- <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2886350">
+ <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2904997">
<fo:block font-size="14pt" font-weight="bold" keep-with-next="always">NOTE</fo:block>
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
Notice in this example that the screenshot file name does
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
To show a file fragment--for example, program
listing--use <fo:inline font-family="Courier"><programlisting></fo:inline> tag:
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
<programlisting>
[Desktop Entry]
</programlisting>
</fo:block>
which produces
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
[Desktop Entry]
Name=Gnumeric spreadsheet
Exec=gnumeric
To show a record of terminal session--i.e., sequence of
commands entered at the command line--use
<fo:inline font-family="Courier"><screen></fo:inline> tag:
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
<screen>
<prompt>bash$</prompt><userinput>make love</userinput>
</screen>
</fo:block>
which produces
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
<fo:inline font-family="Courier">bash$</fo:inline><fo:inline font-weight="bold" font-family="Courier">make love</fo:inline>
make: *** No rule to make target `love'. Stop.
</fo:block>
Note the use of tags <fo:inline font-family="Courier"><prompt></fo:inline> and
<fo:inline font-family="Courier"><userinput></fo:inline> for marking system prompt
and commands entered by user.
- <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2886594"><fo:block font-size="14pt" font-weight="bold" keep-with-next="always">NOTE</fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2905241"><fo:block font-size="14pt" font-weight="bold" keep-with-next="always">NOTE</fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
Note that both <fo:inline font-family="Courier"><programlisting></fo:inline>
and <fo:inline font-family="Courier"><screen></fo:inline> preserve linebreaks,
but interpret SGML tags (unlike LaTeX
<fo:inline font-family="Courier"><orderedlist></fo:inline>, and
<fo:inline font-family="Courier"><variablelist></fo:inline>.
</fo:block>
- <fo:list-block id="id2886706" provisional-distance-between-starts="1in" provisional-label-separation="0.25in" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
- <fo:list-item id="id2886713" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-block id="id2905354" provisional-distance-between-starts="1in" provisional-label-separation="0.25in" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2905360" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>
<fo:inline> <fo:inline font-family="Courier"><itemizedlist></fo:inline></fo:inline>
<fo:block>
This is the simplest unnumbered list, parallel to
<fo:inline font-family="Courier"><ul></fo:inline> in HTML. Here is an example:
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
<itemizedlist>
<listitem>
</fo:block>
and output:
</fo:block>
- <fo:list-block id="id2886772" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" provisional-distance-between-starts="1.5em" provisional-label-separation="0.2em">
- <fo:list-item id="id2886750" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-block id="id2905419" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" provisional-distance-between-starts="1.5em" provisional-label-separation="0.2em">
+ <fo:list-item id="id2905398" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
</fo:block>
</fo:list-item-body>
</fo:list-item>
- <fo:list-item id="id2886824" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2905471" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
</fo:block>
</fo:list-item-body>
</fo:list-item>
- <fo:list-item id="id2886856" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2905503" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
</fo:block>
</fo:list-item-body>
</fo:list-item>
- <fo:list-item id="id2887032" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2905680" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>
<fo:inline> <fo:inline font-family="Courier"><orderedlist></fo:inline></fo:inline>
</fo:block>
</fo:list-item-body>
</fo:list-item>
- <fo:list-item id="id2887131" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2905779" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>
<fo:inline> <fo:inline font-family="Courier"><variablelist></fo:inline></fo:inline>
computer to search. The lines you are reading now were
produced by <fo:inline font-family="Courier"><variablelist></fo:inline>. The
source looked liked this:
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
<variablelist>
<varlistentry>
</fo:block>
</fo:block>
</fo:block>
- <fo:list-block id="id2887307" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" provisional-distance-between-starts="1.5em" provisional-label-separation="0.2em">
- <fo:list-item id="id2887313" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-block id="id2905955" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" provisional-distance-between-starts="1.5em" provisional-label-separation="0.2em">
+ <fo:list-item id="id2905962" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
</fo:block>
</fo:list-item-body>
</fo:list-item>
- <fo:list-item id="id2887339" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2905987" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
</fo:block>
</fo:list-item-body>
</fo:list-item>
- <fo:list-item id="id2887388" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2906036" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
</fo:block>
</fo:list-item-body>
</fo:list-item>
- <fo:list-item id="id2887414" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2906062" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
</fo:block>
</fo:list-item-body>
</fo:list-item>
- <fo:list-item id="id2887438" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2906086" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
</fo:block>
</fo:list-item-body>
</fo:list-item>
- <fo:list-item id="id2887463" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2906111" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
Main Menu->Utilities->GNOME
terminal
there is a special construction for this, too:
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
<menuchoice>
<guimenu>Main Menu</guimenu> <guisubmenu>Utilities</guisubmenu>
automatically inserts the full name of the element you refer
to (section, figure, etc.), while the second just creates a
link (in HTML output). Here is an example:
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
An example of a <link linkend="extip">tip</link> was given in
<xref linkend="notes" />.
</fo:block>
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> To produce a link to an external source, such as a
Web page or a local file, use <fo:inline font-family="Courier"><ulink></fo:inline>
tag, for example:
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
To find more about GNOME, please visit <ulink type="http"
url="http://www.gnome.org">GNOME Web page</ulink>
</fo:block>
Here are some tags used to describe operating system-related
things:
</fo:block>
- <fo:list-block id="id2887860" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" provisional-distance-between-starts="1.5em" provisional-label-separation="0.2em">
- <fo:list-item id="id2887867" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-block id="id2906509" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" provisional-distance-between-starts="1.5em" provisional-label-separation="0.2em">
+ <fo:list-item id="id2906515" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
</fo:block>
</fo:list-item-body>
</fo:list-item>
- <fo:list-item id="id2887922" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2906570" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
</fo:block>
</fo:list-item-body>
</fo:list-item>
- <fo:list-item id="id2887983" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2906631" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
</fo:block>
</fo:list-item-body>
</fo:list-item>
- <fo:list-item id="id2888038" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2906686" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
</fo:block>
</fo:list-item-body>
</fo:list-item>
- <fo:list-item id="id2888079" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2906727" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
</fo:block>
</fo:list-item-body>
</fo:list-item>
- <fo:list-item id="id2888134" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2906782" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
To mark up a combination of keystrokes, use the
<fo:inline font-family="Courier"><keycombo></fo:inline> wrapper:
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
<keycombo>
<keycap>Ctrl</keycap>
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
Finally, if you want to show a shortcut for some menu
command, here are the appropriate tags (rather long):
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
<menuchoice>
<shortcut>
</fo:block>
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> To mark up e-mail
address, use <fo:inline font-family="Courier"><email></fo:inline>:
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
The easiest way to get in touch with me is by e-mail
(<email>me@mydomain.com</email>)
</fo:block>
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
here is partial list of most commonly used enitites:
</fo:block>
- <fo:list-block id="id2888605" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" provisional-distance-between-starts="1.5em" provisional-label-separation="0.2em">
- <fo:list-item id="id2888611" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-block id="id2907253" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" provisional-distance-between-starts="1.5em" provisional-label-separation="0.2em">
+ <fo:list-item id="id2907259" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
</fo:block>
</fo:list-item-body>
</fo:list-item>
- <fo:list-item id="id2888630" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2907278" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
</fo:block>
</fo:list-item-body>
</fo:list-item>
- <fo:list-item id="id2888649" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2907297" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
</fo:block>
</fo:list-item-body>
</fo:list-item>
- <fo:list-item id="id2888668" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2907316" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
</fo:block>
</fo:list-item-body>
</fo:list-item>
- <fo:list-item id="id2888687" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
+ <fo:list-item id="id2907335" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
<fo:list-item-label end-indent="label-end()">
<fo:block>•</fo:block>
</fo:list-item-label>
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
Application documentation should identify the version of the
application for which the documentation is written:
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
<sect1 id="intro">
<title>Introduction</title>
PNG format only) when appropriate. They should also describe
each feature and preference option available.
</fo:block>
- <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2889151">
+ <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2907799">
<fo:block font-size="14pt" font-weight="bold" keep-with-next="always">Documentation Availability</fo:block>
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
Applications and applets should not rely on documentation
versions 1.x and the templates in <fo:basic-link internal-destination="template2-2x">the section called “Template 2: Applet Manual For GNOME 2.x”</fo:basic-link>
for GNOME versions 2.x.
</fo:block>
- <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2889191">
+ <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2907839">
<fo:block font-size="14pt" font-weight="bold" keep-with-next="always">Manuals For Large Applications</fo:block>
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
Manuals for very large applications, such as GNOME Workshop
<fo:inline font-family="Courier"><sect1></fo:inline>).
</fo:block>
</fo:block>
- <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2889306">
+ <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2907954">
<fo:block font-size="14pt" font-weight="bold" keep-with-next="always">Applet Manuals in GNOME 2.0</fo:block>
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
Note that applet manuals in GNOME 2.0 are treated in a special
</fo:block>
</fo:block>
</fo:block>
- <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2889430">
+ <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2908079">
<fo:block font-size="14pt" font-weight="bold" keep-with-next="always">Developer Information</fo:block>
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
This section is for developers. Documentation authors
Help menu at the top right of the
application. To do this, you must first write a
<fo:inline font-family="Courier">topic.dat</fo:inline> file. The format for this file is:
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
One line for each 'topic'.
Two columns, as defined by perl -e 'split(/\s+/,$aline,2)'
</fo:block>
For example, Gnumeric's
<fo:inline font-family="Courier">topic.dat</fo:inline> file is:
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
gnumeric.html Gnumeric manual
function-reference.html Gnumeric function reference
</fo:block>
from SGML into HTML with <fo:inline font-weight="bold">db2html</fo:inline>) should be
placed in this directory too.
</fo:block>
- <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2889621">
+ <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2908268">
<fo:block font-size="14pt" font-weight="bold" keep-with-next="always">Note</fo:block>
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
If the help files are not present in the correct directory, the
The <fo:inline font-family="Courier">topic.dat</fo:inline> file is used by the GNOME
menu building code to generate the Help
menu. When you define your menu:
-<fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+<fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
GnomeUIInfo helpmenu[] = {
{GNOME_APP_UI_ITEM,
N_("About"), N_("Info about this program"),
</fo:block>
</fo:block>
</fo:block>
- <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2889790">
+ <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2908437">
<fo:block font-size="14pt" font-weight="bold" keep-with-next="always">Developer Information</fo:block>
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
This section is for developers. Documentation authors
To make the Help buttons call the correct document in the GNOME Help
Browser the developer should add code based on the following example:
</fo:block>
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
gchar *tmp;
tmp = gnome_help_file_find_file ("module", "page.html");
if (tmp) {
g_free(tmp);
}
</fo:block>
- <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2889927">
+ <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2908575">
<fo:block font-size="14pt" font-weight="bold" keep-with-next="always">NOTE</fo:block>
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
The example above is in the C language, please refer to other
</fo:block>
</fo:block>
</fo:block>
- <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2890179">
+ <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" id="id2908826">
<fo:block font-size="14pt" font-weight="bold" keep-with-next="always">Developer Information</fo:block>
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
This section is for developers. Documentation authors
</fo:block>
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
To add an applet's manual to its applet menu, use:
-<fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+<fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
/* add an item to the applet menu */
applet_widget_register_callback(APPLET_WIDGET(applet), "manual",
_("Manual"), &open_manual, NULL);
You will also want to add an About menu
item to the applet's menu. This is a
stock menu item and is done:
-<fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+<fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
applet_widget_register_stock_callback (APPLET_WIDGET(applet), "about",
GNOME_STOCK_MENU_ABOUT, _("About"), &my_applet_cb_about,
NULL);
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
Just as you need to juggle expert and novice readers,
you'll have to juggle a number of other extremes as you write:
- <fo:list-block id="id2890724" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" provisional-distance-between-starts="1.5em" provisional-label-separation="0.2em"><fo:list-item id="id2890730" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"><fo:list-item-label end-indent="label-end()"><fo:block>•</fo:block></fo:list-item-label><fo:list-item-body start-indent="body-start()"><fo:block>
+ <fo:list-block id="id2909371" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" provisional-distance-between-starts="1.5em" provisional-label-separation="0.2em"><fo:list-item id="id2909377" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"><fo:list-item-label end-indent="label-end()"><fo:block>•</fo:block></fo:list-item-label><fo:list-item-body start-indent="body-start()"><fo:block>
Documents should be complete, yet concise. You should
describe every feature, but you'll have decide how much
detail is really necessary. It's not, for example,
you spend fewer words on the obvious, you can spend more
time clarifying the ambiguous labels and explaining
items that are more complex.
- </fo:block></fo:list-item-body></fo:list-item><fo:list-item id="id2890757" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"><fo:list-item-label end-indent="label-end()"><fo:block>•</fo:block></fo:list-item-label><fo:list-item-body start-indent="body-start()"><fo:block>
+ </fo:block></fo:list-item-body></fo:list-item><fo:list-item id="id2909404" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"><fo:list-item-label end-indent="label-end()"><fo:block>•</fo:block></fo:list-item-label><fo:list-item-body start-indent="body-start()"><fo:block>
Be engaging and friendly, yet professional. Games
documents may be less formal than productivity
application documents (people don't
maintain a standard of style which holds the reader's
interest without resorting to jokes and untranslatable
allusions or puns.
- </fo:block></fo:list-item-body></fo:list-item><fo:list-item id="id2890796" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"><fo:list-item-label end-indent="label-end()"><fo:block>•</fo:block></fo:list-item-label><fo:list-item-body start-indent="body-start()"><fo:block>
+ </fo:block></fo:list-item-body></fo:list-item><fo:list-item id="id2909443" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"><fo:list-item-label end-indent="label-end()"><fo:block>•</fo:block></fo:list-item-label><fo:list-item-body start-indent="body-start()"><fo:block>
Examples, tips, notes, and screenshots are useful to
break up long stretches of text, but too many can get in
the way, and make your documents too choppy to read.
It's good to provide a screenshot of any dialog windows
a user might run into, but if a dialog box has several
tabs, it's not usually necessary to have one for each.
- </fo:block></fo:list-item-body></fo:list-item><fo:list-item id="id2890820" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"><fo:list-item-label end-indent="label-end()"><fo:block>•</fo:block></fo:list-item-label><fo:list-item-body start-indent="body-start()"><fo:block>
+ </fo:block></fo:list-item-body></fo:list-item><fo:list-item id="id2909467" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"><fo:list-item-label end-indent="label-end()"><fo:block>•</fo:block></fo:list-item-label><fo:list-item-body start-indent="body-start()"><fo:block>
The GDP strives to have all of its documentation conform
to certain standards of style and content, but every
document (and every writer) is different. You will need
manuals. You can always get the latest copy of this
template from <fo:basic-link external-destination="http://developer.gnome.org/projects/gdp/templates.html">GDP
Documentation Templates</fo:basic-link><fo:inline hyphenate="false"> [http://developer.gnome.org/projects/gdp/templates.html]</fo:inline>.
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
<!DOCTYPE Article PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[
where
<fo:inline font-family="Courier"><fo:inline xmlns:fo="http://www.w3.org/1999/XSL/Format" font-style="italic" font-family="Courier">appletname</fo:inline></fo:inline> is
the name of the applet.
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
<!DOCTYPE Article PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[
</fo:block>
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
<!-- Template Version: 1.0.1 (do not remove this line) -->
the applet document.
</fo:block>
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
<!DOCTYPE book PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[
<!ENTITY TEMPLATE-APPLET SYSTEM "gnome-applet-template.sgml.part">
</fo:block>
- <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt">
+ <fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em">
<!-- Please replace everywhere below GNOMEAPPLET with the name of -->