Documentation Tools

Changeset 262


Ignore:
Timestamp:
12/10/07 09:40:27 (4 years ago)
Author:
kate
Message:

Spruced up options and output formats.

Location:
trunk/doc/namespaces
Files:
2 edited

Legend:

Unmodified
Added
Removed

  • trunk/doc/namespaces/appendix.xml

    r261 r262  
    187187                <itemizedlist> 
    188188                        <listitem> 
    189                                 <para>dialect. xml/sgml/ps/pdf/dvi. xml/sgml are good for docbook output. xml/sgml are good for html,xhtml output. ps/pdf/dvi are good for latex,context,plaintex</para> 
    190                         </listitem> 
    191  
    192                         <listitem> 
    193                                 <para>locale</para> 
    194                         </listitem> 
    195  
    196                         <listitem> 
    197                                 <para>mode. screen/print (affects link generation for html and pdf, for example)</para> 
    198                         </listitem> 
    199  
    200                         <listitem> 
    201                                 <para>papersize. a4, letter, etc. probably only relevant for pdf</para> 
    202                         </listitem> 
    203  
    204                         <listitem> 
    205                                 <para>characterset (for html, plaintext)</para> 
     189                                <para><literal>dialect</literal>: 
     190                                        <literal>xml</literal>/<literal>sgml</literal>/<literal>ps</literal>/<literal>pdf</literal>/<literal>dvi</literal>. 
     191                                        <literal>xml</literal>/<literal>sgml</literal> are good for docbook, &html; and &xhtml; output. 
     192                                        <literal>ps</literal>/<literal>pdf</literal>/<literal>dvi</literal> 
     193                                        are good for &latex;, &context;, &plaintex; output.</para> 
     194                        </listitem> 
     195 
     196                        <listitem> 
     197                                <para><literal>locale</literal></para> 
     198                        </listitem> 
     199 
     200                        <listitem> 
     201                                <para><literal>mode</literal>: <literal>screen</literal>/<literal>print</literal> 
     202                                        (this affects link generation for &html; and &pdf;, for example)</para> 
     203                        </listitem> 
     204 
     205                        <listitem> 
     206                                <para><literal>papersize</literal>: <literal>a4</literal>, 
     207                                        <literal>letter</literal>, etc.  This is probably only 
     208                                        relevant for &pdf;.</para> 
     209                        </listitem> 
     210 
     211                        <listitem> 
     212                                <para><literal>characterset</literal>: for &html;, 
     213                                        plaintext.</para> 
    206214                        </listitem> 
    207215                </itemizedlist> 
    … …  
    211219                <title>Output formats</title> 
    212220 
    213                 <para>TODO Versioned.</para> 
    214  
    215                 <para>TODO explain that each format provides dialects. See <xref linkend="proposedoptions"/> 
    216                         for a list of proposed dialects.</para> 
     221                <para>Output formats are versioned.</para> 
     222 
     223                <para>Each format provides dialects. 
     224                        See <xref linkend="proposedoptions"/> for a list of proposed 
     225                        dialects.</para> 
    217226 
    218227                <itemizedlist> 
    219228                        <listitem> 
    220                                 <para>context (via texml)</para> 
    221                         </listitem> 
    222  
    223                         <listitem> 
    224                                 <para>plain tex (via texml). mostly as the guts behind context</para> 
    225                         </listitem> 
    226  
    227                         <listitem> 
    228                                 <para>latex (via texml)</para> 
    229                         </listitem> 
    230  
    231                         <listitem> 
    232                                 <para>xhtml (directly from xslt)</para> 
    233                         </listitem> 
    234  
    235                         <listitem> 
    236                                 <para>plaintext (via roff)</para> 
    237                         </listitem> 
    238  
    239                         <listitem> 
    240                                 <para>docbook-simple (and when it has more versions)</para> 
    241                         </listitem> 
    242  
    243                         <listitem> 
    244                                 <para>docbook. (various versions thereof)</para> 
    245                         </listitem> 
    246  
    247                         <listitem> 
    248                                 <para>manpages</para> 
    249                         </listitem> 
    250  
    251                         <listitem> 
    252                                 <para>fo (only because docbook provides it. this gives people a route to horrible pdf, still)</para> 
    253                         </listitem> 
    254  
    255                         <listitem> 
    256                                 <para>pretty-printing as-is</para> 
     229                                <para><literal>context</literal>: &context; (via texml)</para> 
     230                        </listitem> 
     231 
     232                        <listitem> 
     233                                <para><literal>plaintex</literal>: &plaintex; (via texml) 
     234                                        mostly as the guts behind &context;.</para> 
     235                        </listitem> 
     236 
     237                        <listitem> 
     238                                <para><literal>latex</literal>: &latex; (via texml)</para> 
     239                        </listitem> 
     240 
     241                        <listitem> 
     242                                <para><literal>xhtml</literal>: &xhtml; (directly from 
     243                                        &xslt;)</para> 
     244                        </listitem> 
     245 
     246                        <listitem> 
     247                                <para><literal>plaintext</literal> (via roff, perhaps)</para> 
     248                        </listitem> 
     249 
     250                        <listitem> 
     251                                <para><literal>docbook-simple</literal> (and when it 
     252                                        has more versions)</para> 
     253                        </listitem> 
     254 
     255                        <listitem> 
     256                                <para><literal>docbook</literal> (various versions 
     257                                        thereof)</para> 
     258                        </listitem> 
     259 
     260                        <listitem> 
     261                                <para><literal>man</literal>: manpages (via roff)</para> 
     262                        </listitem> 
     263 
     264                        <listitem> 
     265                                <para><literal>fo</literal> (only because Docbook happens 
     266                                        to provides it already. This gives people a route 
     267                                        to horrible &pdf;, still)</para> 
     268                        </listitem> 
     269 
     270                        <listitem> 
     271                                <para><literal>src</literal>: pretty-printing as-is.</para> 
    257272                        </listitem> 
    258273                </itemizedlist> 

  • trunk/doc/namespaces/entities.dtd

    r261 r262  
    1616<!ENTITY amstex "ams&tex;"> 
    1717<!ENTITY latex "La&tex;"> 
     18<!ENTITY plaintex "Plain &tex;"> 
    1819<!ENTITY context "Con&tex;t"> 
    1920<!ENTITY xml "<acronym>XML</acronym>"> 
Note: See TracChangeset for help on using the changeset viewer.