LDP
/
LDP
mirror of https://github.com/tLDP/LDP
0
1
Fork 0
Code Releases Activity

- /s/linuxdoc/tldp/

This commit is contained in:
serek 2002-04-21 09:40:16 +00:00
parent 55902c1d02
commit f32557e2b5
4 changed files with 34 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

56
LDP/guide/docbook/LDP-Author-Guide/LDP-Author-Guide.xml
View File

@ -68,6 +68,12 @@
up to speed and writing. </para>
</abstract>
<revhistory>
<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>
@ -121,7 +127,7 @@
<authorinitials>mfk</authorinitials>
<revremark>
Spelling and grammar changes from Dave Edwards (amoamasam@sympatico.ca).
Also performed some housecleaning from comments of discuss@linuxdoc.org.
Also performed some housecleaning from comments of discuss@en.tldp.org.
</revremark>
</revision>
<revision>
@ -215,7 +221,7 @@
<para>
The newest version of this document can be found at the LDP
homepage
<ulink url="http://www.linuxdoc.org/">http://www.linuxdoc.org</ulink>.
<ulink url="http://www.tldp.org/">http://www.tldp.org</ulink>.
The original DocBook, HTML, and other formats can be found there.
</para>
<para>There are many ways to contribute to the Linux movement
@ -230,7 +236,7 @@
<title>About the LDP</title>
<blockquote>
<attribution>LDP Manifesto located at <ulink
url="http://www.linuxdoc.org/manifesto.html">http://www.linuxdoc.org/manifesto.html</ulink></attribution>
url="http://www.tldp.org/manifesto.html">http://www.tldp.org/manifesto.html</ulink></attribution>
<para>The Linux Documentation Project (LDP) is working on
developing free, high-quality documentation for the GNU/Linux
operating system. The overall goal of the LDP is to
@ -244,7 +250,7 @@
The human readable version goes more like this: The LDP consists
of a large group of volunteers that are working on documentation
for the Linux OS. The most visible documentation are the HOWTOs
located at <ulink url="http://www.linuxdoc.org/">http://www.linuxdoc.org/"</ulink>.
located at <ulink url="http://www.tldp.org/">http://www.tldp.org/"</ulink>.
This Guide focuses primarily on how to write your own HOWTOs for
submission to the LDP.
</para>
@ -274,9 +280,9 @@
<para>Thanks to everyone that gave comments as I was writing
this. This includes David Lawyer, Deb Richardson, Daniel Barlow,
Greg Ferguson, Mark Craig and other members of the
<email>discuss@linuxdoc.org</email> list. Some
<email>discuss@en.tldp.org</email> list. Some
sections I got from the <ulink
url="http://www.linuxdoc.org/HOWTO/">HOWTO Index</ulink> and the
url="http://www.tldp.org/HOWTO/">HOWTO Index</ulink> and the
sgmltools documentation. The sections on network access to CVS
was partially written by Sergiusz Pawlowicz
(<email>ser@metalab.unc.edu</email>). Sections on DocBook
@ -300,10 +306,10 @@
number of smaller works on individual subjects, written by those
who have used it. If you want to find out about printing, you
get the <ulink
url="http://www.linuxdoc.org/HOWTO/Printing-HOWTO.html">Printing
url="http://www.tldp.org/HOWTO/Printing-HOWTO.html">Printing
HOWTO</ulink>. If you want to do find out if your Ethernet card
works with Linux, grab the <ulink
url="http://www.linuxdoc.org/HOWTO/Ethernet-HOWTO.html">Ethernet
url="http://www.tldp.org/HOWTO/Ethernet-HOWTO.html">Ethernet
HOWTO</ulink>, and so on. At first, many of these works were in
text or HTML. As time went on, there had to be a better way of
managing these documents. One that would let you read it from a
@ -396,13 +402,13 @@
<para>If you are a new to the LDP and want to pick up an
unmaintained HOWTO or write a new HOWTO document, join the discussion
list at
<ulink url="http://lists.linuxdoc.org">http://lists.linuxdoc.org</ulink> -
<ulink url="http://lists.tldp.org">http://lists.tldp.org</ulink> -
This is to make
sure the LDP knows who is working on what
documentation.</para>
<para>Once that part is complete, you may write your
documentation in the format of your choice and submit a draft to
<email>submit@linuxdoc.org</email> and the draft will
<email>submit@en.tldp.org</email> and the draft will
be reviewed by an LDP volunteer. In a few short days you will
get the draft and comments from the volunteer. After applying
the comments, you may send this version to the ldp-submit list
@ -416,11 +422,11 @@
are plenty of templates to get you started:</para>
<itemizedlist>
<listitem><para>
<ulink url="http://www.linuxdoc.org/authors/template-ld/big-howto-template-ld.sgml">http://www.linuxdoc.org/authors/template-ld/big-howto-template-ld.sgml</ulink> -
<ulink url="http://www.tldp.org/authors/template-ld/big-howto-template-ld.sgml">http://www.tldp.org/authors/template-ld/big-howto-template-ld.sgml</ulink> -
This template is written by Stein Gojen
and is based off the LinuxDoc template.</para>
</listitem>
<listitem><para><ulink url="http://www.linuxdoc.org/authors/template/big-howto-template.sgml">http://www.linuxdoc.org/authors/template/big-howto-template.sgml</ulink> - This template is based on Stein's work, but is much larger
<listitem><para><ulink url="http://www.tldp.org/authors/template/big-howto-template.sgml">http://www.tldp.org/authors/template/big-howto-template.sgml</ulink> - This template is based on Stein's work, but is much larger
and complicated than the above. It uses more features of DocBook.</para>
</listitem>
</itemizedlist>
@ -452,20 +458,20 @@
<title>Mailing Lists</title>
<para>There are a few mailing lists to subscribe to so you can
take part in how the LDP works. First is
<email>discuss@linuxdoc.org</email>, which is the main
<email>discuss@en.tldp.org</email>, which is the main
discussion group of the LDP. To subscribe, send a message with
the subject reading &quot;subscribe&quot; to
<email>discuss-subscribe@linuxdoc.org</email>. To
<email>discuss-subscribe@en.tldp.org</email>. To
unsubscribe, send an e-mail with the subject of
&quot;unsubscribe&quot; to
<email>discuss-unsubscribe@linuxdoc.org</email>.</para>
<email>discuss-unsubscribe@en.tldp.org</email>.</para>
<para>Another list is the
<email>docbook@linuxdoc.org</email> list, which is for
<email>docbook@en.tldp.org</email> list, which is for
markup or other questions about DocBook itself. If you run into
trouble with a particular markup tag, you can send your question
here for answers. You can subscribe to the DocBook list by
sending a "subscribe" message to
<email>docbook-subscribe@linuxdoc.org</email>.</para>
<email>docbook-subscribe@en.tldp.org</email>.</para>
<para>
There is also a mailing list run by OASIS that can also
answer DocBook questions. Please see <ulink url="http://docbook.org/mailinglist/index.html">http://docbook.org/mailinglist/index.html</ulink>
@ -510,7 +516,7 @@
<section id="ldpdsssl">
<title>LDP DSSSL</title>
<para><ulink
url="http://www.linuxdoc.org/authors/tools/ldp.dsl">http://www.linuxdoc.org/authors/tools/ldp.dsl</ulink></para>
url="http://www.tldp.org/authors/tools/ldp.dsl">http://www.tldp.org/authors/tools/ldp.dsl</ulink></para>
<para>The LDP DSSSL requires the Norman Walsh version (see
above) but is a slightly modified DSSSL to provide things like
a table of contents.</para>
@ -1235,7 +1241,7 @@ $_toolroot/dtd/docbook/catalog</command> <co id="export"/>
<section id="templates">
<title>SGML templates</title>
<para>Optional - <ulink url="http://www.linuxdoc.org/authors/index.html#resources">http://www.linuxdoc.org/authors/index.html#resources</ulink></para>
<para>Optional - <ulink url="http://www.tldp.org/authors/index.html#resources">http://www.tldp.org/authors/index.html#resources</ulink></para>
<para>Contains links to SGML templates and their resulting HTML output
to help you see what your document will look like. Many of the tags
just need to be replaced with information unique to your HOWTO.
@ -1503,7 +1509,7 @@ $_toolroot/dtd/docbook/catalog</command> <co id="export"/>
<para> In order for an LDP document to be accepted by the LDP,
it must be licensed to conform to the "LICENSE REQUIREMENTS"
section of the LDP Manifesto located at <ulink
url="http://www.linuxdoc.org/manifesto.html">http://www.linuxdoc.org/manifesto.html</ulink>.
url="http://www.tldp.org/manifesto.html">http://www.tldp.org/manifesto.html</ulink>.
As an author, you may retain the copyright and add other
restrictions (for example, you must approve any translations or
derivative works). </para>
@ -1542,7 +1548,7 @@ $_toolroot/dtd/docbook/catalog</command> <co id="export"/>
<para> Once your LDP document has been carefully reviewed, you
can release your document to the LDP. Send an e-mail with the
SGML source code as an attachment (you may gzip it if you like)
to <email>submit@linuxdoc.org</email>. </para>
to <email>submit@en.tldp.org</email>. </para>
<para> Be sure to include the name of your HOWTO in the subject
line, and use the body to outline changes you've made and attach
@ -1560,7 +1566,7 @@ $_toolroot/dtd/docbook/catalog</command> <co id="export"/>
<para>If you are using the LDP CVS tree while developing
your document, the LDP will still need to be notified when your
document is ready to be published. E-mail should be sent to
<email>submit@linuxdoc.org</email>. Indicate
<email>submit@en.tldp.org</email>. Indicate
the title of your document and the relative path to the
file(s) in the LDP CVS tree within your message. </para>
</section>
@ -1613,7 +1619,7 @@ $_toolroot/dtd/docbook/catalog</command> <co id="export"/>
</question>
<answer>
<para> Please see <ulink
url="http://www.linuxdoc.org/manifesto.html#pub">http://www.linuxdoc.org/manifesto.html#pub</ulink> for more information about publishing LDP documents.
url="http://www.tldp.org/manifesto.html#pub">http://www.tldp.org/manifesto.html#pub</ulink> for more information about publishing LDP documents.
</para>
</answer>
</qandaentry>
@ -1623,7 +1629,7 @@ $_toolroot/dtd/docbook/catalog</command> <co id="export"/>
</question>
<answer>
<para> Contact the author of the document, or the LDP
coordinator at <email>feedback@linuxdoc.org</email> and
coordinator at <email>feedback@en.tldp.org</email> and
mention the problem and how you think it needs to be
fixed. </para>
</answer>
@ -1641,7 +1647,7 @@ $_toolroot/dtd/docbook/catalog</command> <co id="export"/>
be easier for you to maintain the HOWTO. If you have
questions, you can always drop a line to the LDP volunteer or the
LDP Docbook list
at <email>docbook@linuxdoc.org</email>.</para>
at <email>docbook@en.tldp.org</email>.</para>
</answer>
</qandaentry>
</qandaset>

2
LDP/guide/docbook/LDP-Author-Guide/conventions.xml
View File

@ -9,7 +9,7 @@
<para>This document uses the following conventions<footnote>
<para>Please, take a look at the <ulink
url="http://cvsweb.linuxdoc.org/index.cgi/LDP/guide/docbook/LDP-Author-Guide/">
url="http://cvsview.tldp.org/index.cgi/LDP/guide/docbook/LDP-Author-Guide/">
source</ulink> to see how to get
similar results on your documents. You should also remember that
the way this appears to you depends on the format you are reading

2
LDP/guide/docbook/LDP-Author-Guide/using-ldp-dsssl.xml
View File

@ -4,7 +4,7 @@
white background and automatic generation of the table of
contents you see at the beginning of HOWTOs. You can find the
latest copy of the file at <ulink
url="http://www.linuxdoc.org/authors/tools/ldp.dsl">http://www.linuxdoc.org/authors/tools/ldp.dsl</ulink>.</para>
url="http://www.tldp.org/authors/tools/ldp.dsl">http://www.tldp.org/authors/tools/ldp.dsl</ulink>.</para>
<para>Once you have the file, you may need to do some editing of
the first few lines based on the location of your DocBook DSSSL
files. My example uses the Cygnus tool set.</para>

2
LDP/guide/docbook/LDP-Author-Guide/using-ldp-xsl.xml
View File

@ -65,7 +65,7 @@
</orderedlist>
<para>
You can find the latest copy of the files at <ulink
url="http://www.linuxdoc.org/authors/tools/ldp-xsl.zip">http://www.linuxdoc.org/authors/tools/ldp-xsl.zip</ulink>.</para>
url="http://www.tldp.org/authors/tools/ldp-xsl.zip">http://www.tldp.org/authors/tools/ldp-xsl.zip</ulink>.</para>
<para>Once you have the file, you may need to do some editing of
the first few lines based on the location of your DocBook XSL
files.</para>