- Fix capitalization
- Mark up arguments for Jade in the examples with <replaceable> (to be consistent) - Mark up Jade, pdfTeX with <application> - Mark up pdfjadetex with <literal> - Unfold <abbrev>STDOUT</abbrev> to "standard output" - Mark up Jade error message with <errorname>
This commit is contained in:
Gabor Pali
parent
d3e9606f38
commit
e84c225de8
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=33728
1 changed files with 24 additions and 24 deletions
|
|
@ -90,12 +90,12 @@
|
|||
</preface>
|
||||
|
||||
<chapter>
|
||||
<title>My first chapter</title>
|
||||
<title>My First Chapter</title>
|
||||
|
||||
<para>This is the first chapter in my book.</para>
|
||||
|
||||
<sect1>
|
||||
<title>My first section</title>
|
||||
<title>My First Section</title>
|
||||
|
||||
<para>This is the first section in my book.</para>
|
||||
</sect1>
|
||||
|
|
@ -114,7 +114,7 @@
|
|||
|
||||
<article>
|
||||
<articleinfo>
|
||||
<title>An example article</title>
|
||||
<title>An Example Article</title>
|
||||
|
||||
<author>
|
||||
<firstname>Your first name</firstname>
|
||||
|
|
@ -135,12 +135,12 @@
|
|||
</articleinfo>
|
||||
|
||||
<sect1>
|
||||
<title>My first section</title>
|
||||
<title>My First Section</title>
|
||||
|
||||
<para>This is the first section in my article.</para>
|
||||
|
||||
<sect2>
|
||||
<title>My first sub-section</title>
|
||||
<title>My First Sub-Section</title>
|
||||
|
||||
<para>This is the first sub-section in my article.</para>
|
||||
</sect2>
|
||||
|
|
@ -150,7 +150,7 @@
|
|||
</sect1>
|
||||
|
||||
<sect1 id="examples-formatted">
|
||||
<title>Producing formatted output</title>
|
||||
<title>Producing Formatted Output</title>
|
||||
|
||||
<para>This section assumes that you have installed the software listed in
|
||||
the <filename role="package">textproc/docproj</filename> port, either by hand, or by
|
||||
|
|
@ -171,37 +171,37 @@
|
|||
-c /usr/local/share/sgml/docbook/catalog \
|
||||
-c /usr/local/share/sgml/jade/catalog \
|
||||
-d /usr/local/share/sgml/docbook/dsssl/modular/html/docbook.dsl \<co id="examples-co-jade-1-dsssl">
|
||||
-t sgml <co id="examples-co-jade-1-transform"> file.sgml > file.html <co id="examples-co-jade-1-filename"></userinput></screen>
|
||||
-t sgml <co id="examples-co-jade-1-transform"> <replaceable>file</replaceable>.sgml > <replaceable>file</replaceable>.html <co id="examples-co-jade-1-filename"></userinput></screen>
|
||||
|
||||
<calloutlist>
|
||||
<callout arearefs="examples-co-jade-1-nochunks">
|
||||
<para>Specifies the <literal>nochunks</literal> parameter to the
|
||||
stylesheets, forcing all output to be written to
|
||||
<abbrev>STDOUT</abbrev> (using Norm Walsh's stylesheets).</para>
|
||||
the standard output (using Norm Walsh's stylesheets).</para>
|
||||
</callout>
|
||||
|
||||
<callout arearefs="examples-co-jade-1-catalog">
|
||||
<para>Specifies the catalogs that Jade will need to process.
|
||||
<para>Specifies the catalogs that <application>Jade</application> will need to process.
|
||||
Three catalogs are required. The first is a catalog that
|
||||
contains information about the DSSSL stylesheets. The second
|
||||
contains information about the DocBook DTD. The third contains
|
||||
information specific to Jade.</para>
|
||||
information specific to <application>Jade</application>.</para>
|
||||
</callout>
|
||||
|
||||
<callout arearefs="examples-co-jade-1-dsssl">
|
||||
<para>Specifies the full path to the DSSSL stylesheet that Jade
|
||||
<para>Specifies the full path to the DSSSL stylesheet that <application>Jade</application>
|
||||
will use when processing the document.</para>
|
||||
</callout>
|
||||
|
||||
<callout arearefs="examples-co-jade-1-transform">
|
||||
<para>Instructs Jade to perform a
|
||||
<para>Instructs <application>Jade</application> to perform a
|
||||
<emphasis>transformation</emphasis> from one DTD to another. In
|
||||
this case, the input is being transformed from the DocBook DTD
|
||||
to the HTML DTD.</para>
|
||||
</callout>
|
||||
|
||||
<callout arearefs="examples-co-jade-1-filename">
|
||||
<para>Specifies the file that Jade should process, and redirects
|
||||
<para>Specifies the file that <application>Jade</application> should process, and redirects
|
||||
output to the specified <filename>.html</filename> file.</para>
|
||||
</callout>
|
||||
</calloutlist>
|
||||
|
|
@ -219,7 +219,7 @@
|
|||
|
||||
<calloutlist>
|
||||
<callout arearefs="examples-co-jade-2-catalog">
|
||||
<para>Specifies the catalogs that Jade will need to process.
|
||||
<para>Specifies the catalogs that <application>Jade</application> will need to process.
|
||||
Three catalogs are required. The first is a catalog that
|
||||
contains information about the DSSSL stylesheets. The second
|
||||
contains information about the DocBook DTD. The third contains
|
||||
|
|
@ -227,19 +227,19 @@
|
|||
</callout>
|
||||
|
||||
<callout arearefs="examples-co-jade-2-dsssl">
|
||||
<para>Specifies the full path to the DSSSL stylesheet that Jade
|
||||
<para>Specifies the full path to the DSSSL stylesheet that <application>Jade</application>
|
||||
will use when processing the document.</para>
|
||||
</callout>
|
||||
|
||||
<callout arearefs="examples-co-jade-2-transform">
|
||||
<para>Instructs Jade to perform a
|
||||
<para>Instructs <application>Jade</application> to perform a
|
||||
<emphasis>transformation</emphasis> from one DTD to another. In
|
||||
this case, the input is being transformed from the DocBook DTD
|
||||
to the HTML DTD.</para>
|
||||
</callout>
|
||||
|
||||
<callout arearefs="examples-co-jade-2-filename">
|
||||
<para>Specifies the file that Jade should process. The
|
||||
<para>Specifies the file that <application>Jade</application> should process. The
|
||||
stylesheets determine how the individual HTML files will be
|
||||
named, and the name of the <quote>root</quote> file (i.e., the
|
||||
one that contains the start of the document.</para>
|
||||
|
|
@ -256,7 +256,7 @@
|
|||
|
||||
<para>The source SGML file must be converted to a &tex; file.</para>
|
||||
|
||||
<screen>&prompt.user; <userinput>jade -Vtex-backend \ <co id="examples-co-jade-3-tex-backend">
|
||||
<screen>&prompt.user; <userinput>jade -V tex-backend \ <co id="examples-co-jade-3-tex-backend">
|
||||
-c /usr/local/share/sgml/docbook/dsssl/modular/catalog \ <co id="examples-co-jade-3-catalog">
|
||||
-c /usr/local/share/sgml/docbook/catalog \
|
||||
-c /usr/local/share/sgml/jade/catalog \
|
||||
|
|
@ -270,7 +270,7 @@
|
|||
</callout>
|
||||
|
||||
<callout arearefs="examples-co-jade-3-catalog">
|
||||
<para>Specifies the catalogs that Jade will need to process. Three
|
||||
<para>Specifies the catalogs that <application>Jade</application> will need to process. Three
|
||||
catalogs are required. The first is a catalog that contains
|
||||
information about the DSSSL stylesheets. The second contains
|
||||
information about the DocBook DTD. The third contains
|
||||
|
|
@ -279,11 +279,11 @@
|
|||
|
||||
<callout arearefs="examples-co-jade-3-dsssl">
|
||||
<para>Specifies the full path to the DSSSL stylesheet that
|
||||
Jade will use when processing the document.</para>
|
||||
<application>Jade</application> will use when processing the document.</para>
|
||||
</callout>
|
||||
|
||||
<callout arearefs="examples-co-jade-3-tex">
|
||||
<para>Instructs Jade to convert the output to &tex;.</para>
|
||||
<para>Instructs <application>Jade</application> to convert the output to &tex;.</para>
|
||||
</callout>
|
||||
</calloutlist>
|
||||
|
||||
|
|
@ -300,8 +300,8 @@
|
|||
on.</para>
|
||||
|
||||
<para>Do not be alarmed if you see warning messages such as
|
||||
<literal>LaTeX Warning: Reference `136' on page 5 undefined on input
|
||||
line 728.</literal> at this point.</para>
|
||||
<errorname>LaTeX Warning: Reference `136' on page 5 undefined on input
|
||||
line 728.</errorname> at this point.</para>
|
||||
|
||||
<para>The second run reprocesses the document now that certain pieces
|
||||
of information are known (such as the document's page length). This
|
||||
|
|
@ -328,7 +328,7 @@
|
|||
linkend="examples-docbook-postscript">).</para>
|
||||
|
||||
<para>When the <filename>.tex</filename> file has been generated you
|
||||
run pdfTeX. However, use the &pdfjadetex macro package
|
||||
run <application>pdfTeX</application>. However, use the <literal>&pdfjadetex</literal> macro package
|
||||
instead.</para>
|
||||
|
||||
<screen>&prompt.user; <userinput>pdftex "&pdfjadetex" <replaceable>file</replaceable>.tex</userinput></screen>
|
||||
|
|
|
|||
Loading…
Reference in a new issue