mirror of https://github.com/tLDP/LDP
A few notes on setting up "your" system (i.e. specific distributions).
This commit is contained in:
emmajane
parent
9fb8c82fb7
commit
aa6642061c
|
|
@ -7,10 +7,10 @@
|
|||
|
||||
The latest version of this document was editing using
|
||||
the following system configuration:
|
||||
Textwidth: 70 characters
|
||||
Textwidth: 74 characters
|
||||
Tabstop: 3 characters
|
||||
In vim (the only editor that matters) that's:
|
||||
:set textwidth=70
|
||||
:set textwidth=74
|
||||
:set tabstop=3
|
||||
|
||||
Things that need fixing should be marked as such with either "TODO"
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
<!--
|
||||
<!--
|
||||
<!DOCTYPE book PUBLIC '-//OASIS//DTD DocBook XML V4.2//EN'>
|
||||
-->
|
||||
-->
|
||||
<appendix id="tools">
|
||||
<title>System Setup: Editors, Validation and
|
||||
Transformations</title>
|
||||
|
|
@ -8,36 +8,105 @@
|
|||
<para>In this section, we will cover some of the tools
|
||||
that you may want to use to create your own LDP documentation.
|
||||
If you use some other tool to assist you in writing
|
||||
documents for the LDP, please drop us a line and we'll
|
||||
add a blurb for it here. <xref linkend="feedback" />
|
||||
has contact information.</para>
|
||||
documents for the LDP, please drop us a line and we'll add
|
||||
a blurb for it here. <xref linkend="feedback" /> has contact
|
||||
information.</para>
|
||||
|
||||
<!--
|
||||
Tools to edit your document.
|
||||
Pretty straight forward stuff. I'd like to update
|
||||
the screen shots so that they're a printer-friendly
|
||||
size. And add screen shots for VIM *hearts to vi*
|
||||
and Morphon and whoever else is missing pretty
|
||||
pictures.
|
||||
-->
|
||||
&tools-edit;
|
||||
<section id="tools-distro"> <title>Tools for your operating
|
||||
system</title>
|
||||
|
||||
<!--
|
||||
Tools to validate your XML/SGML
|
||||
There will be some duplication in here as
|
||||
editing and validation may or may not be
|
||||
considered the same thing. Mostly I'm keeping
|
||||
them separate because I use VIM and all the
|
||||
stuff on emacs is useless to me. ;)
|
||||
-->
|
||||
&tools-validate;
|
||||
<para>
|
||||
A few notes on setting up your system for DocBook
|
||||
publishing. These tools focus more on the transformation
|
||||
of documents from DocBook to XHTML (for example).
|
||||
</para>
|
||||
|
||||
<!--
|
||||
Tools to Transform DocBook to other formats
|
||||
Mostly this is a Jade/DSSSL section; but I'd
|
||||
like to add some XSLT stuff because...well...
|
||||
I found it about 100 times easier to install.
|
||||
-->
|
||||
&tools-transform;
|
||||
<variablelist> <title>Tools For Your Operating System</title>
|
||||
<!-- TODO: alphabetize this list -->
|
||||
|
||||
<varlistentry> <term><filename>Debian</filename></term>
|
||||
<listitem> <para>
|
||||
<ulink
|
||||
url="http://www.docbook.org/wiki/moin.cgi/DebianGnuLinuxPackages">
|
||||
http://www.docbook.org/wiki/moin.cgi/DebianGnuLinuxPackages
|
||||
</ulink>
|
||||
</para> </listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry> <term><filename>Fedora (aka the new
|
||||
RedHat)</filename></term>
|
||||
<listitem> <para>
|
||||
Notes contributed by <ulink
|
||||
url="http://www.charlescurley.com">Charles
|
||||
Curley</ulink>.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
The only way to get a list of packages is to
|
||||
pull in the ISOs
|
||||
and make your own. Some packages are described in the
|
||||
Release Notes, <ulink
|
||||
url="http://fedora.redhat.com/docs/release-notes/">http://fedora.redhat.com/docs/release-notes/</ulink>.
|
||||
</para>
|
||||
|
||||
<para> Installation instructions: none; use Red Hat 9
|
||||
until they are written: <ulink
|
||||
url="http://www.redhat.com/docs/manuals/linux/RHL-9-Manual/">
|
||||
http://www.redhat.com/docs/manuals/linux/RHL-9-Manual/</ulink>
|
||||
<para> </listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry> <term><filename>Mandrake</filename></term>
|
||||
<listitem> <para>
|
||||
Notes contributed by <ulink
|
||||
url="http://www.artemio.net">Artemio</ulink>.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
In Mandrake (as of my current 9.2), all the
|
||||
stuff including openjade, xmlto, docbook-utils
|
||||
etc. comes as standard.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
So I just needed to get the TLDP XSL sheet and
|
||||
that's all. Didn't ever have any dependency
|
||||
or other problems, everything works fine (knock
|
||||
on wood :-)).
|
||||
</para> </listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry> <term><filename>RedHat</filename></term>
|
||||
<listitem> <para>
|
||||
According to Hal Burgiss, your system is likely
|
||||
already ready to edit and process DocBook
|
||||
documents without installing any additional
|
||||
packages.
|
||||
</para> </listitem>
|
||||
</varlistentry>
|
||||
|
||||
</variablelist>
|
||||
|
||||
</section> <!-- end of tools-distro -->
|
||||
|
||||
<!--
|
||||
Tools to edit your document. Pretty straight forward
|
||||
stuff. I'd like to update the screen shots so that they're a
|
||||
printer-friendly size. And add screen shots for VIM *hearts to
|
||||
vi* and Morphon and whoever else is missing pretty pictures.
|
||||
--> &tools-edit;
|
||||
|
||||
<!--
|
||||
Tools to validate your XML/SGML There will be some duplication
|
||||
in here as editing and validation may or may not be considered
|
||||
the same thing. Mostly I'm keeping them separate because I use
|
||||
VIM and all the stuff on emacs is useless to me. ;)
|
||||
--> &tools-validate;
|
||||
|
||||
<!--
|
||||
Tools to Transform DocBook to other formats Mostly this is
|
||||
a Jade/DSSSL section; but I'd like to add some XSLT stuff
|
||||
because...well... I found it about 100 times easier to install.
|
||||
--> &tools-transform;
|
||||
|
||||
</appendix>
|
||||
|
|
|
|||
Loading…
Reference in New Issue