Remove leading and trailing whitespace from the Documentation Primer.
Translators can likely ignore this change. Approved by: jkois (mentor)
This commit is contained in:
parent
653f99ca4f
commit
e7f9c1620c
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=37426
1 changed files with 27 additions and 27 deletions
|
@ -32,19 +32,19 @@
|
|||
|
||||
<chapter id="tools">
|
||||
<title>Tools</title>
|
||||
|
||||
|
||||
<para>The FDP uses a number of different software tools to help
|
||||
manage the FreeBSD documentation, convert it to different output
|
||||
formats, and so on. You will need to use these tools yourself if
|
||||
you are to work with the FreeBSD documentation.</para>
|
||||
you are to work with the FreeBSD documentation.</para>
|
||||
|
||||
<para>All these tools are available as FreeBSD Ports and Packages,
|
||||
greatly simplifying the work you have to do to install
|
||||
them.</para>
|
||||
|
||||
them.</para>
|
||||
|
||||
<para>You will need to install these tools before you work through
|
||||
any of the examples in later chapters. The actual usage of these
|
||||
tools is covered in later chapters.</para>
|
||||
tools is covered in later chapters.</para>
|
||||
|
||||
<tip>
|
||||
<title>Use <filename role="package">textproc/docproj</filename> If Possible</title>
|
||||
|
@ -87,38 +87,38 @@
|
|||
|
||||
<sect2>
|
||||
<title>Software</title>
|
||||
|
||||
|
||||
<para>These programs are required before you can usefully work with the
|
||||
FreeBSD documentation, and they will allow you to convert the
|
||||
documentation to HTML, plain text, and RTF formats. They are all
|
||||
included in <filename role="package">textproc/docproj</filename>.</para>
|
||||
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><application>Jade</application>
|
||||
(<filename role="package">textproc/jade</filename>)</term>
|
||||
|
||||
|
||||
<listitem>
|
||||
<para>A DSSSL implementation. Used for converting marked up
|
||||
documents to other formats, including HTML and &tex;.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
|
||||
<varlistentry>
|
||||
<term><application>Tidy</application>
|
||||
(<filename role="package">www/tidy</filename>)</term>
|
||||
|
||||
|
||||
<listitem>
|
||||
<para>An HTML <quote>pretty printer</quote>, used to reformat some of the
|
||||
automatically generated HTML so that it is easier to
|
||||
follow.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
|
||||
<varlistentry>
|
||||
<term><application>Links</application>
|
||||
(<filename role="package">www/links</filename>)</term>
|
||||
|
||||
|
||||
<listitem>
|
||||
<para>A text-mode WWW browser that can also convert
|
||||
HTML files to plain text.</para>
|
||||
|
@ -128,7 +128,7 @@
|
|||
<varlistentry>
|
||||
<term><application>peps</application>
|
||||
(<filename role="package">graphics/peps</filename>)</term>
|
||||
|
||||
|
||||
<listitem>
|
||||
<para>Some of the documentation includes images, some of which are
|
||||
stored as EPS files. These must be converted to PNG before most
|
||||
|
@ -143,30 +143,30 @@
|
|||
|
||||
<para>These are the DTDs and entity sets used by the FDP. They need to
|
||||
be installed before you can work with any of the documentation.</para>
|
||||
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term>HTML DTD (<filename role="package">textproc/html</filename>)</term>
|
||||
|
||||
|
||||
<listitem>
|
||||
<para>HTML is the markup language of choice for the World Wide
|
||||
Web, and is used throughout the FreeBSD web site.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
|
||||
<varlistentry>
|
||||
<term>DocBook DTD (<filename role="package">textproc/docbook</filename>)</term>
|
||||
|
||||
|
||||
<listitem>
|
||||
<para>DocBook is designed for marking up technical documentation.
|
||||
All the FreeBSD documentation is written in DocBook.</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
|
||||
<varlistentry>
|
||||
<term>ISO 8879 entities
|
||||
(<filename role="package">textproc/iso8879</filename>)</term>
|
||||
|
||||
|
||||
<listitem>
|
||||
<para>19 of the ISO 8879:1986 character entity sets used by many
|
||||
DTDs. Includes named mathematical symbols, additional
|
||||
|
@ -182,12 +182,12 @@
|
|||
|
||||
<para>The stylesheets are used when converting and formatting the
|
||||
documentation for display on screen, printing, and so on.</para>
|
||||
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term>Modular DocBook Stylesheets
|
||||
(<filename role="package">textproc/dsssl-docbook-modular</filename>)</term>
|
||||
|
||||
|
||||
<listitem>
|
||||
<para>The Modular DocBook Stylesheets are used when converting
|
||||
documentation marked up in DocBook to other formats, such as
|
||||
|
@ -208,14 +208,14 @@
|
|||
|
||||
<sect2>
|
||||
<title>Software</title>
|
||||
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><application>JadeTeX</application> and
|
||||
<application>teTeX</application>
|
||||
(<filename role="package">print/jadetex</filename> and
|
||||
<filename role="package">print/teTeX</filename>)</term>
|
||||
|
||||
|
||||
<listitem>
|
||||
<para><application>Jade</application> and
|
||||
<application>teTeX</application> are used to convert DocBook
|
||||
|
@ -242,13 +242,13 @@
|
|||
</important>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
|
||||
<varlistentry>
|
||||
<term><application>Emacs</application> or
|
||||
<application>XEmacs</application>
|
||||
<application>XEmacs</application>
|
||||
(<filename role="package">editors/emacs</filename> or
|
||||
<filename role="package">editors/xemacs</filename>)</term>
|
||||
|
||||
|
||||
<listitem>
|
||||
<para>Both these editors include a special mode for editing
|
||||
documents marked up according to an SGML DTD. This mode
|
||||
|
@ -261,7 +261,7 @@
|
|||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
|
||||
<para>If anyone has recommendations for other software that is useful
|
||||
when manipulating SGML documents, please let &a.doceng; know, so they
|
||||
can be added to this list.</para>
|
||||
|
|
Loading…
Reference in a new issue