mirror of https://github.com/tLDP/LDP
395 lines
12 KiB
XML
395 lines
12 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
|
|
<!--
|
|
A note to future authors and editors of this document:
|
|
Thank you a hundred times over for contributing!
|
|
|
|
The latest version of this document was editing using
|
|
the following system configuration:
|
|
Textwidth: 74 characters
|
|
Tabstop: 3 characters
|
|
In vim (the only editor that matters) that's:
|
|
:set textwidth=74
|
|
:set tabstop=3
|
|
|
|
Things that need fixing should be marked as such with either "TODO"
|
|
or "FIXME".
|
|
|
|
Multiple file searching can be done with a variation of this:
|
|
find . -name "*xml" -exec grep -n "TODO" {} \; -print
|
|
-->
|
|
|
|
<!-- Chapter One: About this guide -->
|
|
<!ENTITY ag-about SYSTEM "ag-about.xml">
|
|
<!ENTITY tldp SYSTEM "tldp.xml">
|
|
<!ENTITY thankyous SYSTEM "thankyous.xml">
|
|
<!ENTITY conventions SYSTEM "conventions.xml">
|
|
|
|
<!-- Chapter Two: Authoring TLDP Documents: An Introduction -->
|
|
<!ENTITY ag-overview SYSTEM "ag-overview.xml">
|
|
|
|
<!-- Chapter Three: Propose -->
|
|
<!ENTITY ag-proposal SYSTEM "ag-proposal.xml">
|
|
|
|
<!-- Chapter Four: Write -->
|
|
<!ENTITY ag-writing SYSTEM "ag-writing.xml">
|
|
|
|
<!-- Chapter Four: Markup -->
|
|
<!ENTITY ag-markup SYSTEM "ag-markup.xml">
|
|
|
|
<!-- Chapter Five: Publish and Distribute -->
|
|
<!ENTITY ag-distribute SYSTEM "ag-distribute.xml">
|
|
|
|
<!-- Chapter Six: Maintain -->
|
|
<!ENTITY ag-maintain SYSTEM "ag-maintain.xml">
|
|
|
|
<!-- Appendix A. Resources for new authors -->
|
|
<!ENTITY references SYSTEM "references.xml">
|
|
|
|
<!-- Appendix B. Editors, Validation and System Setup -->
|
|
<!ENTITY tools SYSTEM "tools.xml">
|
|
<!-- editors -->
|
|
<!ENTITY tools-edit SYSTEM "tools-edit.xml">
|
|
<!ENTITY tools-word-processors SYSTEM "tools-word-processors.xml">
|
|
<!ENTITY tools-text-editors SYSTEM "tools-text-editors.xml">
|
|
<!ENTITY configure-emacs SYSTEM "tools-emacs.xml">
|
|
<!ENTITY emacs-psgml-mode SYSTEM "tools-emacs-psgml.xml">
|
|
<!-- validation -->
|
|
<!ENTITY tools-validate SYSTEM "tools-validate.xml">
|
|
<!-- transformation -->
|
|
<!ENTITY tools-transform SYSTEM "tools-transform.xml">
|
|
|
|
<!-- Appendix C. DocBook Samples, Document Components and Templates -->
|
|
<!-- Hey Tille: would you be willing to release your templates as an
|
|
open source GFL package? All zipped up and ready to go? It
|
|
would prevent people from having to copy and paste as is
|
|
currently required by the LDP Author Guide. I can't remember
|
|
what's on the LDP web site as I'm currently *gasp* offline. -->
|
|
<!ENTITY using-docbook SYSTEM "using-docbook.xml">
|
|
|
|
<!-- Appendix D. Transformations: Making HTML out of XML -->
|
|
<!ENTITY transformations SYSTEM "transformations.xml">
|
|
<!ENTITY ldp-dsssl SYSTEM "using-ldp-dsssl.xml">
|
|
<!ENTITY ldp-xsl SYSTEM "using-ldp-xsl.xml">
|
|
|
|
<!-- Appendix E. CVS -->
|
|
<!ENTITY cvs SYSTEM "cvs.xml">
|
|
<!ENTITY cvs-why SYSTEM "cvs-why.xml">
|
|
|
|
<!-- Appendix F. Converting Documents to DocBook XML -->
|
|
<!ENTITY x2docbook SYSTEM "x2docbook.xml">
|
|
|
|
<!-- Appendix G. Converting Documents to DocBook XML -->
|
|
<!ENTITY templates SYSTEM "templates.xml">
|
|
|
|
<!-- Appendix H. The License -->
|
|
<!ENTITY gfdl SYSTEM "fdl-appendix.xml">
|
|
|
|
<!-- etc The Glossary -->
|
|
<!ENTITY glossary SYSTEM "glossary.xml">
|
|
|
|
<!-- etc The Index
|
|
<!ENTITY theindex SYSTEM "index.xml">
|
|
-->
|
|
|
|
<!-- Include files -->
|
|
<!ENTITY example-article SYSTEM "example-article.xml">
|
|
<!ENTITY example-book SYSTEM "example-book.xml">
|
|
<!ENTITY example-compile-sgml SYSTEM "compiles-sgml.xml">
|
|
<!ENTITY example-table SYSTEM "example-table.xml">
|
|
<!ENTITY dsl-example SYSTEM "dsl-example.xml">
|
|
|
|
<!-- Missing and obsolete files -->
|
|
<!--
|
|
<!ENTITY doc-index SYSTEM "index.xml">
|
|
-->
|
|
|
|
<!-- Text Macros -->
|
|
<!ENTITY conectivasa '<ulink url="http://www.conectiva.com">Conectiva S.A.</ulink>'>
|
|
<!ENTITY conectiva "Conectiva">
|
|
|
|
]>
|
|
|
|
<book id="index">
|
|
<bookinfo>
|
|
<title>LDP Author Guide</title>
|
|
<pubdate>2002-04-25</pubdate>
|
|
<author>
|
|
<firstname>Mark</firstname>
|
|
<othername>F.</othername>
|
|
<surname>Komarinski</surname>
|
|
<affiliation>
|
|
<address><email>mkomarinski@wayga.org</email></address>
|
|
</affiliation>
|
|
</author>
|
|
<author>
|
|
<firstname>Jorge</firstname>
|
|
<surname>Godoy</surname>
|
|
<affiliation>
|
|
<orgname>&conectivasa;</orgname>
|
|
<orgdiv>Publishing Department</orgdiv>
|
|
<address><email>godoy@conectiva.com</email></address>
|
|
<address><email>godoy@metalab.unc.edu</email></address>
|
|
</affiliation>
|
|
</author>
|
|
<author>
|
|
<firstname>David</firstname>
|
|
<othername>C.</othername>
|
|
<surname>Merrill</surname>
|
|
<affiliation>
|
|
<address><email>dcmerrill@mindspring.com</email></address>
|
|
</affiliation>
|
|
</author>
|
|
|
|
<abstract>
|
|
<para>List the tools, procedures, and hints to get LDP authors
|
|
up to speed and writing. </para>
|
|
</abstract>
|
|
<revhistory>
|
|
<revision>
|
|
<revnumber>4.0</revnumber>
|
|
<date>2003-12-08</date>
|
|
<authorinitials>ejh</authorinitials>
|
|
<revremark>Revised the structure of the document and shuffled
|
|
elements into place (a floating date until the final version is
|
|
ready).</revremark>
|
|
</revision>
|
|
<revision>
|
|
<revnumber>3.15</revnumber>
|
|
<date>2002-12-16</date>
|
|
<authorinitials>gjf</authorinitials>
|
|
<revremark>Contribution by Jaime Irving Davila regarding ldp.dsl
|
|
usage. </revremark>
|
|
</revision>
|
|
<revision>
|
|
<revnumber>3.14</revnumber>
|
|
<date>2002-05-16</date>
|
|
<authorinitials>mfk</authorinitials>
|
|
<revremark>Added information about LDP Reviewer HOWTO. New reviewers are asked to read this document.</revremark>
|
|
</revision>
|
|
<revision>
|
|
<revnumber>3.14</revnumber>
|
|
<date>2002-04-25</date>
|
|
<authorinitials>gf</authorinitials>
|
|
<revremark>Update meta-data information, resources; add articleinfo content</revremark>
|
|
</revision>
|
|
<!--
|
|
<revision>
|
|
<revnumber>3.13</revnumber>
|
|
<date>2002-04-21</date>
|
|
<authorinitials>sp</authorinitials>
|
|
<revremark>We are now tldp.org</revremark>
|
|
</revision>
|
|
<revision>
|
|
<revnumber>3.12</revnumber>
|
|
<date>2002-03-11</date>
|
|
<authorinitials>mfk</authorinitials>
|
|
<revremark>Bug fixes, learning PSGML, update e-mail address</revremark>
|
|
</revision>
|
|
<revision>
|
|
<revnumber>3.11</revnumber>
|
|
<date>2002-01-26</date>
|
|
<authorinitials>sp</authorinitials>
|
|
<revremark>
|
|
Updated CVS information.
|
|
</revremark>
|
|
</revision>
|
|
<revision>
|
|
<revnumber>3.10</revnumber>
|
|
<date>2001-12-15</date>
|
|
<authorinitials>dcm</authorinitials>
|
|
<revremark>
|
|
Updated contacting LDP information.
|
|
</revremark>
|
|
</revision>
|
|
<revision>
|
|
<revnumber>3.9</revnumber>
|
|
<date>2001-11-27</date>
|
|
<authorinitials>sp</authorinitials>
|
|
<revremark>
|
|
Updated CVS information.
|
|
</revremark>
|
|
</revision>
|
|
<revision>
|
|
<revnumber>3.8</revnumber>
|
|
<date>2001-09-25</date>
|
|
<authorinitials>dy</authorinitials>
|
|
<revremark>
|
|
XML/XSLT information.
|
|
</revremark>
|
|
</revision>
|
|
<revision>
|
|
<revnumber>3.7</revnumber>
|
|
<date>2001-06-20</date>
|
|
<authorinitials>mfk</authorinitials>
|
|
<revremark>
|
|
Now under the GFDL.
|
|
</revremark>
|
|
</revision>
|
|
<revision>
|
|
<revnumber>3.62</revnumber>
|
|
<date>2001-03-13</date>
|
|
<authorinitials>mfk</authorinitials>
|
|
<revremark>
|
|
Spelling and grammar changes from Dave Edwards (amoamasam@sympatico.ca).
|
|
Also performed some housecleaning from comments of discuss@en.tldp.org.
|
|
</revremark>
|
|
</revision>
|
|
<revision>
|
|
<revnumber>3.6</revnumber>
|
|
<date>2001-01-10</date>
|
|
<authorinitials>mfk</authorinitials>
|
|
<revremark>
|
|
First revision in DocBook XML. Added section covering writing
|
|
in DB XML, since first rev is 4.1.
|
|
</revremark>
|
|
</revision>
|
|
<revision>
|
|
<revnumber>3.51</revnumber>
|
|
<date>2001-01-05</date>
|
|
<authorinitials>mfk</authorinitials>
|
|
<revremark>sgedit (now tksgml) is not free, included link for pricing, more XML info</revremark>
|
|
</revision>
|
|
<revision>
|
|
<revnumber>3.5</revnumber>
|
|
<date>Dec 4, 2000</date>
|
|
<authorinitials>mfk</authorinitials>
|
|
<revremark>Changed mailing list pointers to new lists.</revremark>
|
|
</revision>
|
|
<revision>
|
|
<revnumber>3.4</revnumber>
|
|
<date>Dec 1, 2000</date>
|
|
<authorinitials>dcm</authorinitials>
|
|
<revremark>Added Crediting Translators and Converters</revremark>
|
|
</revision>
|
|
<revision>
|
|
<revnumber>3.3</revnumber>
|
|
<date>Nov 11, 2000</date>
|
|
<authorinitials>mfk</authorinitials>
|
|
<revremark>Added links to SGML GPL and FDL</revremark>
|
|
</revision>
|
|
<revision>
|
|
<revnumber>3.1</revnumber>
|
|
<date>Oct 10, 2000</date>
|
|
<authorinitials>mfk</authorinitials>
|
|
<revremark>Spelling changes, changed list of LDP policies to now
|
|
accept DocBook XML. More information about how to use *jade
|
|
with XML will follow.
|
|
</revremark>
|
|
</revision>
|
|
<revision>
|
|
<revnumber>3.0</revnumber>
|
|
<date>Aug 24, 2000</date>
|
|
<authorinitials>gjf</authorinitials>
|
|
<revremark>Integrated David Merrill's style guide document. Further clean-up and additions.</revremark>
|
|
</revision>
|
|
<revision>
|
|
<revnumber>2.0</revnumber>
|
|
<date>Jul 13, 2000</date>
|
|
<authorinitials>mfk</authorinitials>
|
|
<revremark>Cleaned up using-docbook a bit. Moved some chapters</revremark>
|
|
</revision>
|
|
<revision>
|
|
<revnumber>1.9</revnumber>
|
|
<date>Jun 26, 2000</date>
|
|
<authorinitials>mfk</authorinitials>
|
|
<revremark>Integrated Jorge's using-docbook document.</revremark>
|
|
</revision>
|
|
<revision>
|
|
<revnumber>1.5</revnumber>
|
|
<date>Jun 14, 2000</date>
|
|
<authorinitials>mfk</authorinitials>
|
|
<revremark>Documented sgedit</revremark>
|
|
</revision>
|
|
<revision>
|
|
<revnumber>1.4</revnumber>
|
|
<date>Jun 12, 2000</date>
|
|
<authorinitials>mfk</authorinitials>
|
|
<revremark>Documented vim and sgedit. Spelling and other
|
|
changes from ldp list. Also added LDP guidelines under style
|
|
guide.</revremark>
|
|
</revision>
|
|
-->
|
|
|
|
</revhistory>
|
|
</bookinfo>
|
|
|
|
|
|
<!-- Chapter one: about this guide
|
|
This chapter includes:
|
|
-->
|
|
&ag-about;
|
|
|
|
<!-- Chapter two: authoring overview
|
|
This chapter includes:
|
|
-->
|
|
&ag-overview;
|
|
|
|
<!-- Chapter three: propose
|
|
This chapter includes:
|
|
-->
|
|
&ag-proposal;
|
|
|
|
<!-- Chapter four: write
|
|
This chapter includes:
|
|
-->
|
|
&ag-writing;
|
|
|
|
<!-- Final five: Publish and Distribute -->
|
|
&ag-distribute;
|
|
|
|
<!-- Final six: Maintain -->
|
|
&ag-maintain;
|
|
|
|
<!-- Appendix: References -->
|
|
<!--
|
|
TODO Requires markup
|
|
&references;
|
|
-->
|
|
|
|
|
|
<!-- Appendix: Editors, Validation and System Setup -->
|
|
&tools;
|
|
|
|
<!-- Appendix: CVS -->
|
|
&cvs;
|
|
|
|
<!-- Appendix: Converting to DocBook XML 4.x
|
|
-->
|
|
&using-docbook;
|
|
|
|
<!-- Appendix: Converting Documents 2 DocBook -->
|
|
&x2docbook;
|
|
|
|
<!-- Appendix: Sample Templates -->
|
|
<!-- TODO requires markup -->
|
|
&templates;
|
|
|
|
<!--
|
|
The sadly too short glossary
|
|
TODO: see the index terms? Add glossary items
|
|
for them. (see below re. index terms)
|
|
I'm stretching into the depths of my memory to remember
|
|
this...but...didn't Bin make a huge big "glossary" a few
|
|
months back? Should there be a link to that document?
|
|
-->
|
|
&glossary;
|
|
|
|
<!--
|
|
I /think/ this document is created at "run-time"
|
|
TODO: read the document and add index terms as
|
|
appropriate. Much thanks.
|
|
&theindex;
|
|
-->
|
|
|
|
<!--
|
|
The License
|
|
Print-wise it's a PITA to have Appendices after
|
|
the License...so I'm moving it to the very-very
|
|
end. Please move it back if you must.
|
|
-->
|
|
&gfdl;
|
|
|
|
</book>
|