mirror of https://github.com/tLDP/LDP
new entry; LDP author guide
This commit is contained in:
parent
4490a7aa96
commit
8372c021ee
File diff suppressed because it is too large
Load Diff
|
@ -0,0 +1,93 @@
|
||||||
|
#!/bin/bash
|
||||||
|
#
|
||||||
|
# Compile DocBook documents into several output formats.
|
||||||
|
#
|
||||||
|
# Godoy.
|
||||||
|
# 19991230 - Initial release.
|
||||||
|
# 20000117 - Placed the options using "case" and parameters passed
|
||||||
|
# via command line. The pages on the Zope are already updated.
|
||||||
|
# --- Removed to public version (/home/ldp).
|
||||||
|
# 20000120 - Placed the call to use the books.dtd.
|
||||||
|
# 20000126 - Placed the commands for the index generation.
|
||||||
|
#
|
||||||
|
|
||||||
|
# If the jade is already installed, disconsider the line bellow.
|
||||||
|
<envar>JADE</envar>=/usr/bin/jade
|
||||||
|
|
||||||
|
# If the jade package is already installed, disconsider the line bellow.
|
||||||
|
# <envar>JADE</envar>=/usr/bin/openjade
|
||||||
|
|
||||||
|
<envar>DOCUMENT</envar>=<envar>$1</envar>
|
||||||
|
<command>shift</command> 1
|
||||||
|
<envar>TYPE</envar>=<envar>$1</envar>
|
||||||
|
|
||||||
|
<command>.</command> <filename>~/.bash_profile</filename>
|
||||||
|
<command>.</command> <filename>~/.bashrc</filename>
|
||||||
|
|
||||||
|
<command>case</command> <envar>$TYPE</envar> in
|
||||||
|
html)
|
||||||
|
<command>rm</command> <parameter class="option">-f</parameter> <literal>*.htm</literal>
|
||||||
|
<command>rm</command> <parameter class="option">-f</parameter> <literal>*.html</literal>
|
||||||
|
<command>perl</command> <filename>/home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl</filename> <parameter class="option">-N</parameter> <parameter class="option">-o</parameter> <filename>index.sgml</filename>
|
||||||
|
<command>jade</command> <parameter class="option">-t</parameter> <literal>sgml</literal> <parameter class="option">-V</parameter> <literal>html-index</literal> <parameter class="option">-d</parameter> <filename>/home/ldp/SGML/style/dsssl/docbook/html/docbook.dsl</filename> <envar>$DOCUMENT</envar><literal>.sgml</literal>
|
||||||
|
<command>perl</command> <filename>/home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl</filename> <parameter class="option">-o</parameter> <filename>index.sgml</filename> <filename>HTML.index</filename>
|
||||||
|
<envar>$JADE</envar> <parameter class="option">-t</parameter> <literal>sgml</literal> <parameter class="option">-i</parameter> <literal>html</literal> <parameter class="option">-d</parameter> <filename>/home/ldp/SGML/style/dsssl/docbook/html/docbook.dsl</filename> <parameter class="option">-d</parameter> <filename>/home/ldp/SGML/conectiva/livros.dsl</filename><literal>#html</literal> <envar>$DOCUMENT</envar><literal>.sgml</literal>
|
||||||
|
;;
|
||||||
|
rtf)
|
||||||
|
<command>rm</command> <parameter class="option">-f</parameter> <envar>$DOCUMENT</envar><literal>.rtf</literal>
|
||||||
|
<command>perl</command> <filename>/home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl</filename> <parameter class="option">-N</parameter> <parameter class="option">-o</parameter> <filename>index.sgml</filename>
|
||||||
|
<command>jade</command> <parameter class="option">-t</parameter> <literal>sgml</literal> <parameter class="option">-V</parameter> <literal>html-index</literal> <parameter class="option">-d</parameter> <filename>/home/ldp/SGML/style/dsssl/docbook/html/docbook.dsl</filename> <envar>$DOCUMENT</envar><literal>.sgml</literal>
|
||||||
|
<command>perl</command> <filename>/home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl</filename> <parameter class="option">-o</parameter> <filename>indice.sgml</filename> <filename>HTML.index</filename>
|
||||||
|
<envar>$JADE</envar> <parameter class="option">-t</parameter> <literal>rtf</literal> <parameter class="option">-V</parameter> <literal>rtf-backend</literal> <parameter class="option">-d</parameter> <filename>/home/ldp/SGML/style/dsssl/docbook/print/docbook.dsl</filename> <parameter class="option">-d</parameter> <filename>/home/ldp/SGML/conectiva/books.dsl</filename><literal>#print</literal> <envar>$DOCUMENT</envar><literal>.sgml</literal>
|
||||||
|
;;
|
||||||
|
xml)
|
||||||
|
<command>rm</command> <parameter class="option">-f</parameter> <envar>$DOCUMENT</envar><literal>.xml</literal>
|
||||||
|
<command>perl</command> <filename>/home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl</filename> <parameter class="option">-N</parameter> <parameter class="option">-o</parameter> <filename>index.sgml</filename>
|
||||||
|
<command>jade</command> <parameter class="option">-t</parameter> <literal>sgml</literal> <parameter class="option">-V</parameter> <literal>html-index</literal> <parameter class="option">-d</parameter> <filename>/home/ldp/SGML/style/dsssl/docbook/html/docbook.dsl</filename> <envar>$DOCUMENT</envar><literal>.sgml</literal>
|
||||||
|
<command>perl</command> <filename>/home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl</filename> <parameter class="option">-o</parameter> <filename>indice.sgml</filename> <filename>HTML.index</filename>
|
||||||
|
<envar>$JADE</envar> <parameter class="option">-t</parameter> <literal>sgml</literal> <parameter class="option">-i</parameter> <literal>xml</literal> <parameter class="option">-d</parameter> <filename>/home/ldp/SGML/style/xsl/docbook/html/docbook.xsl</filename> <envar>$DOCUMENT</envar><literal>.sgml</literal>
|
||||||
|
;;
|
||||||
|
tex)
|
||||||
|
<command>rm</command> <parameter class="option">-f</parameter> <envar>$DOCUMENT</envar><literal>.tex</literal>
|
||||||
|
<command>perl</command> <filename>/home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl</filename> <parameter class="option">-N</parameter> <parameter class="option">-o</parameter> <filename>indice.sgml</filename>
|
||||||
|
<command>jade</command> <parameter class="option">-t</parameter> <literal>sgml</literal> <parameter class="option">-V</parameter> <literal>html-index</literal> <parameter class="option">-d</parameter> <filename>/home/ldp/SGML/style/dsssl/docbook/html/docbook.dsl</filename> <envar>$DOCUMENT</envar><literal>.sgml</literal>
|
||||||
|
<command>perl</command> <filename>/home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl</filename> <parameter class="option">-o</parameter> <filename>indice.sgml</filename> <filename>HTML.index</filename>
|
||||||
|
<envar>$JADE</envar> <parameter class="option">-t</parameter> <literal>tex</literal> <parameter class="option">-V</parameter> <literal>tex-backend</literal> <parameter class="option">-d</parameter> <filename>/home/ldp/SGML/style/dsssl/docbook/print/docbook.dsl</filename> <parameter class="option">-d</parameter> <filename>/home/ldp/SGML/conectiva/livros.dsl</filename><literal>#print</literal> <envar>$DOCUMENT</envar><literal>.sgml</literal>
|
||||||
|
;;
|
||||||
|
dvi)
|
||||||
|
<command>rm</command> <parameter class="option">-f</parameter> <envar>$DOCUMENT</envar><literal>.tex</literal>
|
||||||
|
<command>rm</command> <parameter class="option">-f</parameter> <envar>$DOCUMENT</envar><literal>.dvi</literal>
|
||||||
|
<command>perl</command> <filename>/home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl</filename> <parameter class="option">-N</parameter> <parameter>-o</parameter> <filename>indice.sgml</filename>
|
||||||
|
<command>jade</command> <parameter class="option">-t</parameter> <literal>sgml</literal> <parameter class="option">-V</parameter> <literal>html-index</literal> <parameter class="option">-d</parameter> <filename>/home/ldp/SGML/style/dsssl/docbook/html/docbook.dsl</filename> <envar>$DOCUMENT</envar><literal>.sgml</literal>
|
||||||
|
<command>perl</command> <filename>/home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl</filename> <parameter class="option">-o</parameter> <filename>indice.sgml</filename> <filename>HTML.index</filename>
|
||||||
|
<envar>$JADE</envar> <parameter class="option">-t</parameter> <literal>tex</literal> <parameter class="option">-V</parameter> <literal>tex-backend</literal> <parameter class="option">-d</parameter> <filename>/home/ldp/SGML/style/dsssl/docbook/print/docbook.dsl</filename> <parameter class="option">-d</parameter> <filename>/home/ldp/SGML/conectiva/livros.dsl</filename><literal>#print</literal> <envar>$DOCUMENT</envar><literal>.sgml</literal>
|
||||||
|
<command>jadetex</command> <envar>$DOCUMENT</envar><literal>.tex</literal>
|
||||||
|
;;
|
||||||
|
mirror)
|
||||||
|
<command>rm</command> <parameter class="option">-f</parameter> <envar>$DOCUMENT</envar><literal>.tex</literal>
|
||||||
|
<command>rm</command> <parameter class="option">-f</parameter> <envar>$DOCUMENT</envar><literal>.dvi</literal>
|
||||||
|
<command>rm</command> <parameter class="option">-f</parameter> <envar>$DOCUMENT</envar><literal>.mirror.ps</literal>
|
||||||
|
<command>perl</command> <filename>/home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl</filename> <parameter class="option">-N</parameter> <parameter>-o</parameter> <filename>indice.sgml</filename>
|
||||||
|
<command>jade</command> <parameter class="option">-t</parameter> <literal>sgml</literal> <parameter class="option">-V</parameter> <literal>html-index</literal> <parameter class="option">-d</parameter> <filename>/home/ldp/SGML/style/dsssl/docbook/html/docbook.dsl</filename> <envar>$DOCUMENT</envar><literal>.sgml</literal>
|
||||||
|
<command>perl</command> <filename>/home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl</filename> <parameter class="option">-o</parameter> <filename>indice.sgml</filename> <filename>HTML.index</filename>
|
||||||
|
<envar>$JADE</envar> <parameter class="option">-t</parameter> <literal>tex</literal> <parameter class="option">-V</parameter> <literal>tex-backend</literal> <parameter class="option">-d</parameter> <filename>/home/ldp/SGML/style/dsssl/docbook/print/docbook.dsl</filename> <parameter class="option">-d</parameter> <filename>/home/ldp/SGML/conectiva/livros.dsl</filename><literal>#print</literal> <envar>$DOCUMENT</envar><literal>.sgml</literal>
|
||||||
|
<command>jadetex</command> <envar>$DOCUMENT</envar><literal>.tex</literal>
|
||||||
|
<command>dvips</command> <parameter>-h</parameter> <filename>/home/ldp/estilos/skel/mirr.hd</filename> <parameter class="option">-O</parameter> <literal>1.5cm,3cm</literal> <parameter class="option">-f</parameter> <envar>$DOCUMENT</envar><literal>.dvi</literal> <parameter class="option">-o</parameter> <envar>$DOCUMENT</envar><literal>.mirror.ps</literal>
|
||||||
|
;;
|
||||||
|
ps)
|
||||||
|
<command>rm</command> <parameter class="option">-f</parameter> <envar>$DOCUMENT</envar><literal>.tex</literal>
|
||||||
|
<command>rm</command> <parameter class="option">-f</parameter> <envar>$DOCUMENT</envar><literal>.dvi</literal>
|
||||||
|
<command>rm</command> <parameter class="option">-f</parameter> <envar>$DOCUMENT</envar><literal>.ps</literal>
|
||||||
|
<command>perl</command> <filename>/home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl</filename> <parameter class="option">-N</parameter> <parameter>-o</parameter> <filename>indice.sgml</filename>
|
||||||
|
<command>jade</command> <parameter class="option">-t</parameter> <literal>sgml</literal> <parameter class="option">-V</parameter> <literal>html-index</literal> <parameter class="option">-d</parameter> <filename>/home/ldp/SGML/style/dsssl/docbook/html/docbook.dsl</filename> <envar>$DOCUMENT</envar><literal>.sgml</literal>
|
||||||
|
<command>perl</command> <filename>/home/ldp/SGML/style/dsssl/docbook/bin/collateindex.pl</filename> <parameter class="option">-o</parameter> <filename>indice.sgml</filename> <filename>HTML.index</filename>
|
||||||
|
<envar>$JADE</envar> <parameter class="option">-t</parameter> <literal>tex</literal> <parameter class="option">-V</parameter> <literal>tex-backend</literal> <parameter class="option">-d</parameter> <filename>/home/ldp/SGML/style/dsssl/docbook/print/docbook.dsl</filename> <parameter class="option">-d</parameter> <filename>/home/ldp/SGML/conectiva/livros.dsl</filename><literal>#print</literal> <envar>$DOCUMENT</envar><literal>.sgml</literal>
|
||||||
|
<command>jadetex</command> <envar>$DOCUMENT</envar><literal>.tex</literal>
|
||||||
|
<command>dvips</command> <parameter class="option">-The</parameter> <literal>1.5cm,3cm</literal> <parameter class="option">-f</parameter> <envar>$DOCUMENT</envar><literal>.dvi</literal> <parameter class="option">-o</parameter> <envar>$DOCUMENT</envar><literal>.ps</literal>
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
<command>echo</command> <computeroutput>"How to use: $0 file {html|tex|rtf|xml|ps|dvi|mirror}"</computeroutput>
|
||||||
|
<command>exit</command> <returnvalue>1</returnvalue>
|
||||||
|
<command>esac</command>
|
||||||
|
|
||||||
|
<command>exit</command> <returnvalue>0</returnvalue>
|
|
@ -0,0 +1,95 @@
|
||||||
|
<!-- <!doctype section PUBLIC "-//OASIS//DTD DocBook V3.1//EN"> -->
|
||||||
|
|
||||||
|
<section id="conventions"><?dbhtml filename="conventions.html">
|
||||||
|
<title>Documents</title>
|
||||||
|
|
||||||
|
<indexterm zone="conventions">
|
||||||
|
<primary>conventions</primary>
|
||||||
|
</indexterm>
|
||||||
|
|
||||||
|
<para>This document uses the following conventions<footnote>
|
||||||
|
<para>Please, take a look at the <ulink
|
||||||
|
url="sgml/conventions.sgml">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're reading
|
||||||
|
this document: online appearance is slightly different from the
|
||||||
|
PostScript or PDF ones.</para></footnote>:</para>
|
||||||
|
|
||||||
|
<informaltable frame="none">
|
||||||
|
<tgroup cols="2">
|
||||||
|
<thead>
|
||||||
|
<row>
|
||||||
|
<entry>Descriptions</entry>
|
||||||
|
<entry>Appearance</entry>
|
||||||
|
</row>
|
||||||
|
</thead>
|
||||||
|
<tbody>
|
||||||
|
<row>
|
||||||
|
<entry>Warnings</entry>
|
||||||
|
<entry><caution>
|
||||||
|
<para>Warnings.</para>
|
||||||
|
</caution></entry>
|
||||||
|
</row>
|
||||||
|
<row>
|
||||||
|
<entry>Hint</entry>
|
||||||
|
<entry><tip>
|
||||||
|
<para>Hint.</para>
|
||||||
|
</tip></entry>
|
||||||
|
</row>
|
||||||
|
<row>
|
||||||
|
<entry>Notes</entry>
|
||||||
|
<entry><note>
|
||||||
|
<para>Note.</para>
|
||||||
|
</note></entry>
|
||||||
|
</row>
|
||||||
|
<row>
|
||||||
|
<entry>Information requiring special attention</entry>
|
||||||
|
<entry><warning>
|
||||||
|
<para>Warning.</para>
|
||||||
|
</warning></entry>
|
||||||
|
</row>
|
||||||
|
<row>
|
||||||
|
<entry>File Names</entry>
|
||||||
|
<entry><filename>file.extension</filename></entry>
|
||||||
|
</row>
|
||||||
|
<row>
|
||||||
|
<entry>Directory Names</entry>
|
||||||
|
<entry><filename class="directory">directory</filename></entry>
|
||||||
|
</row>
|
||||||
|
<row>
|
||||||
|
<entry>Commands to be typed</entry>
|
||||||
|
<entry><command>command</command></entry>
|
||||||
|
</row>
|
||||||
|
<row>
|
||||||
|
<entry>Applications Names</entry>
|
||||||
|
<entry><application>application</application></entry>
|
||||||
|
</row>
|
||||||
|
<row>
|
||||||
|
<entry><foreignphrase>Prompt</foreignphrase> of users command under bash shell</entry>
|
||||||
|
<entry>bash$</entry>
|
||||||
|
</row>
|
||||||
|
<row>
|
||||||
|
<entry><foreignphrase>Prompt</foreignphrase> of root users command under bash shell</entry>
|
||||||
|
<entry>bash#</entry>
|
||||||
|
</row>
|
||||||
|
<row>
|
||||||
|
<entry><foreignphrase>Prompt</foreignphrase> of user command under tcsh shell</entry>
|
||||||
|
<entry>tcsh$</entry>
|
||||||
|
</row>
|
||||||
|
<row>
|
||||||
|
<entry>Environment Variables</entry>
|
||||||
|
<entry><envar>VARIABLE</envar></entry>
|
||||||
|
</row>
|
||||||
|
<row>
|
||||||
|
<entry>Emphasized work</entry>
|
||||||
|
<entry><emphasis>word</emphasis></entry>
|
||||||
|
</row>
|
||||||
|
<row>
|
||||||
|
<entry>Code Example</entry>
|
||||||
|
<entry><programlisting><sgmltag class="starttag">para</sgmltag>Beginning and end of paragraph<sgmltag class="endtag">para</sgmltag></programlisting></entry>
|
||||||
|
</row>
|
||||||
|
</tbody>
|
||||||
|
</tgroup>
|
||||||
|
</informaltable>
|
||||||
|
|
||||||
|
</section>
|
|
@ -0,0 +1,161 @@
|
||||||
|
<section id="cvs">
|
||||||
|
<title> CVS </title>
|
||||||
|
<para> The LDP is in the process of providing CVS access to
|
||||||
|
authors. There are a few good reasons for this: </para>
|
||||||
|
|
||||||
|
<orderedlist inheritnum="ignore" continuation="restarts">
|
||||||
|
<listitem>
|
||||||
|
<para> CVS will keep an off-site backup of your documents. In
|
||||||
|
the event that you hand over a document to another author,
|
||||||
|
they can just retrieve the document from CVS and continue
|
||||||
|
on. In the event you need to go back to a previous version of
|
||||||
|
a document, you can retrieve it as well. </para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para> It's great if you have many people working on the same
|
||||||
|
document. You can have CVS tell you what changes were made
|
||||||
|
while you were editing your copy by another author, and
|
||||||
|
integrate those changes in. </para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para> Keeps a log of what changes were made. These logs (and
|
||||||
|
a date stamp) can be placed automatically inside the document
|
||||||
|
when you use some special tags that get processed before the
|
||||||
|
SGML processor. </para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para> Can provide for a way for a program to automatically
|
||||||
|
update the LDP web site with new documentation as it's written
|
||||||
|
and submitted. This is not in place yet, but is a potential
|
||||||
|
goal. Currently, CVS updates signal the HOWTO coordinator to
|
||||||
|
update the LDP web page, meaning that if you use CVS, you're not
|
||||||
|
required to e-mail your SGML code. </para>
|
||||||
|
</listitem>
|
||||||
|
</orderedlist>
|
||||||
|
|
||||||
|
<para> If you're completely new to CVS, there are a few web pages
|
||||||
|
you may want to look at which can help you out: </para>
|
||||||
|
|
||||||
|
<itemizedlist>
|
||||||
|
<listitem>
|
||||||
|
<para> <ulink
|
||||||
|
url="http://www.sourcegear.com/CVS/Docs/blandy">http://www.sourcegear.com/CVS/Docs/blandy</ulink>
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para> <ulink
|
||||||
|
url="https://wroclaw.art.pl/~ser/docs/cvs.html">https://wroclaw.art.pl/~ser/docs/cvs.html</ulink></para>
|
||||||
|
</listitem>
|
||||||
|
</itemizedlist>
|
||||||
|
|
||||||
|
<section id="getaccount">
|
||||||
|
<title> Getting a CVS account </title>
|
||||||
|
<para> First you'll need to get an account at the LDP's CVS
|
||||||
|
Repository. This is pretty much the root directory that is used
|
||||||
|
by CVS, with various projects (HOWTOs, mini HOWTOs, etc.)
|
||||||
|
created as subdirectories of that. </para>
|
||||||
|
<para> You will need to create a hashed password and userid for
|
||||||
|
your account. The hashed password allows you to send an
|
||||||
|
encrypted password to the CVS group without them needing to know
|
||||||
|
your password. You can do this with the following command, from
|
||||||
|
bash (or sh): </para>
|
||||||
|
|
||||||
|
<screen format="linespecific">
|
||||||
|
<prompt>bash$</prompt> <command>echo your_password | perl -e "print crypt(<>,\
|
||||||
|
join '',('.', '/', 0..9, 'A'..'Z', 'a'..'z')[rand 64, rand 64]),\"\n\""</command>
|
||||||
|
</screen>
|
||||||
|
|
||||||
|
<para>Take the output of this command, and send it with your
|
||||||
|
proposed userid to
|
||||||
|
<email>cvsadmin@cvslist.linuxdoc.org</email>. Your unique
|
||||||
|
CVSROOT directory will be created and you'll get an e-mail with
|
||||||
|
a response. When you get your response, log into your CVSROOT
|
||||||
|
and make sure everything is set up properly: </para>
|
||||||
|
|
||||||
|
<screen format="linespecific">
|
||||||
|
<prompt>bash$</prompt> <command>export CVSROOT=:pserver:<replaceable>your_userid</replaceable>@cvs.linuxdoc.org:/cvsroot</command>
|
||||||
|
<prompt>bash$</prompt> <command>cvs -d $CVSROOT login</command>
|
||||||
|
</screen>
|
||||||
|
|
||||||
|
<para> (Replace the <replaceable>your_userid</replaceable> with what
|
||||||
|
you were sent in the response e-mail). </para>
|
||||||
|
<para> You will be asked for your password, and then given
|
||||||
|
access to the CVS Repository in read-write mode. Once you've
|
||||||
|
used <command moreinfo="none">cvs login</command> once and have
|
||||||
|
been given access to the system, your password is stored in
|
||||||
|
<filename moreinfo="none">.cvspass</filename> and you will not
|
||||||
|
have to use <command moreinfo="none">cvs login</command>
|
||||||
|
again. Just set the CVSROOT and continue on. You can get the
|
||||||
|
entire LinuxDoc repository with this command: </para>
|
||||||
|
|
||||||
|
<screen>
|
||||||
|
<prompt>bash$</prompt> <command>cvs get LDP</command>
|
||||||
|
</screen>
|
||||||
|
|
||||||
|
<para> Or you can get the SGML source for your own document with
|
||||||
|
these commands: </para>
|
||||||
|
|
||||||
|
<screen format="linespecific">
|
||||||
|
<prompt>bash$</prompt> <command>cvs get howto/YOUR-HOWTO.sgml</command>
|
||||||
|
<prompt>bash$</prompt> <command>cvs get
|
||||||
|
minihowto/YOURDOC.sgml</command>
|
||||||
|
</screen>
|
||||||
|
</section>
|
||||||
|
|
||||||
|
<section id="othercvsnotes">
|
||||||
|
<title> Other CVS repository notes </title>
|
||||||
|
|
||||||
|
<section id="anoncvs">
|
||||||
|
<title> Anonymous CVS access </title>
|
||||||
|
<para> Anonymous CVS access is available for those who do not
|
||||||
|
require an account (such as those wishing to publish LDP
|
||||||
|
documents). This repository is read-only: </para>
|
||||||
|
|
||||||
|
<screen>
|
||||||
|
<prompt>bash$</prompt> <command>cvs -d :pserver:cvs@anoncvs.linuxdoc.org:/cvsroot login</command>
|
||||||
|
</screen>
|
||||||
|
|
||||||
|
<para> As a password, use cvs. You can then get LinuxDoc
|
||||||
|
modules as above. Note that changes to the anoncvs site may be
|
||||||
|
a half an hour behind the main site. </para>
|
||||||
|
</section>
|
||||||
|
|
||||||
|
<section id="cvsweb">
|
||||||
|
<title> CVS Files via web </title>
|
||||||
|
<para> You can access the CVS repository via the web at <ulink
|
||||||
|
url="http://cvsweb.linuxdoc.org/index.cgi/linuxdoc">http://cvsweb.linuxdoc.org/index.cgi/linuxdoc</ulink>.
|
||||||
|
</para>
|
||||||
|
</section>
|
||||||
|
|
||||||
|
<section id="cvsgraphics">
|
||||||
|
<title> Graphical access to CVS </title>
|
||||||
|
<para> There are graphical interfaces to CVS, and you can get
|
||||||
|
a list of them at <ulink
|
||||||
|
url="http://freshmeat.net/appindex">http://freshmeat.net/appindex</ulink>.
|
||||||
|
Search for CVS. </para>
|
||||||
|
</section>
|
||||||
|
</section>
|
||||||
|
|
||||||
|
<section id="updatefiles">
|
||||||
|
<title> Updating files and CVS </title>
|
||||||
|
<para> CVS has a special tag, <emphasis>$Id</emphasis>, that you
|
||||||
|
can use to automatically insert the date and version directly
|
||||||
|
into the document. After committing, CVS will turn this tag into
|
||||||
|
<emphasis>$Id: HOWTO-HOWTO.sgml,v 1.4 2000/06/12 20:49:54 markk
|
||||||
|
Exp $</emphasis>. By including this tag in your document, you
|
||||||
|
can have that automatically change each time you change the
|
||||||
|
file, allowing the revision mark to increment each time. </para>
|
||||||
|
<para> When you're ready to upload changes to the CVS server,
|
||||||
|
use the command <command moreinfo="none">cvs ci -m
|
||||||
|
"comment" YOUR-HOWTO.sgml</command>. The -m
|
||||||
|
"comment" isn't necessary, but if you don't include
|
||||||
|
it, you'll be brought into the editor (usually vi, or whatever
|
||||||
|
your <envar>EDITOR</envar> environment variable is) and be given
|
||||||
|
the chance to add a comment about the changes. </para>
|
||||||
|
<para> You can follow more of the CVS discussion on the
|
||||||
|
ldp-discuss list. For the time being, LDP submissions should
|
||||||
|
still be sent to
|
||||||
|
<email>ldp-submit@lists.linuxdoc.org</email>. </para>
|
||||||
|
</section>
|
||||||
|
</section>
|
||||||
|
|
|
@ -0,0 +1,25 @@
|
||||||
|
<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
|
||||||
|
<!entity html-docbook PUBLIC "-//Norman Walsh//DOCUMENT DocBook HTML Stylesheet//EN" CDATA DSSSL>
|
||||||
|
<!entity print-docbook PUBLIC "-//Norman Walsh//DOCUMENT DocBook Print Stylesheet//EN" CDATA DSSSL>
|
||||||
|
]>
|
||||||
|
|
||||||
|
<style-sheet>
|
||||||
|
<style-specification use="html">
|
||||||
|
<style-specification-body>
|
||||||
|
|
||||||
|
; Includes a summary at the beginning of an item.
|
||||||
|
(define %generate-article-toc% #t)
|
||||||
|
|
||||||
|
</style-specification-body>
|
||||||
|
</style-specification>
|
||||||
|
<style-specification use="print">
|
||||||
|
<style-specification-body>
|
||||||
|
|
||||||
|
; Includes a summary at the beginning of an item.
|
||||||
|
(define %generate-article-toc% #t)
|
||||||
|
|
||||||
|
</style-specification-body>
|
||||||
|
</style-specification>
|
||||||
|
<external-specification id="html" document="html-docbook">
|
||||||
|
<external-specification id="print" document="print-docbook">
|
||||||
|
</style-sheet>
|
|
@ -0,0 +1,45 @@
|
||||||
|
<article class="whitepaper" id="using -docbook" lang="pt-br"><?dbhtml filename="using-docbook.html">
|
||||||
|
|
||||||
|
<artheader>
|
||||||
|
<title>Como-Fazer DocBook</title>
|
||||||
|
<author>
|
||||||
|
<firstname>Jorge</firstname>
|
||||||
|
<othername>Luiz</othername>
|
||||||
|
<surname>Godoy</surname>
|
||||||
|
<othername>Filho</othername>
|
||||||
|
<affiliation>
|
||||||
|
<orgname><ulink url="http://www.conectiva.com">Conectiva S.A.</ulink></orgname>
|
||||||
|
<orgdiv>Publishing Departmentt;/orgdiv>
|
||||||
|
<address><email>godoy@conectiva.com</email></address>
|
||||||
|
</affiliation>
|
||||||
|
</author>
|
||||||
|
<revhistory>
|
||||||
|
<revision>
|
||||||
|
<revnumber>1.0</revnumber>
|
||||||
|
<date>27 de janeiro de 2000</date>
|
||||||
|
<authorinitials>godoy</authorinitials>
|
||||||
|
<revremark>Versão inicial.</revremark>
|
||||||
|
</revision>
|
||||||
|
</revhistory>
|
||||||
|
|
||||||
|
<legalnotice>
|
||||||
|
<para>This document can be freely translated and distributed. It's released
|
||||||
|
under the LDP License.</para>
|
||||||
|
</legalnotice>
|
||||||
|
|
||||||
|
<keywordset>
|
||||||
|
<keyword>SGML</keyword>
|
||||||
|
<keyword>DocBook</keyword>
|
||||||
|
<keyword>DTD</keyword>
|
||||||
|
<keyword>XML</keyword>
|
||||||
|
<keyword>catalogs</keyword>
|
||||||
|
<keyword>documents</keyword>
|
||||||
|
<keyword>Publishingdlt;/keyword>
|
||||||
|
<keyword>Conectiva</keyword>
|
||||||
|
<keyword>configuration</keyword>
|
||||||
|
<keyword>use</keyword>
|
||||||
|
<keyword>tools</keyword>
|
||||||
|
<keyword>HOWTO</keyword>
|
||||||
|
</keywordset>
|
||||||
|
|
||||||
|
</artheader>
|
|
@ -0,0 +1,39 @@
|
||||||
|
<book id="network-systems-administration><?dbhtml filename="html/networkadm.html">
|
||||||
|
<bookinfo>
|
||||||
|
<author>
|
||||||
|
<firstname>Jorge</firstname>
|
||||||
|
<surname>Godoy</surname>
|
||||||
|
<affiliation>
|
||||||
|
<orgname>&conectivasa;</orgname>
|
||||||
|
<orgdiv>Publishing Departmentlt;/orgdiv>
|
||||||
|
<address role="email">godoy@conectiva.com.br</address>
|
||||||
|
</affiliation>
|
||||||
|
</author>
|
||||||
|
<editor>
|
||||||
|
<firstname>Jorge</firstname>
|
||||||
|
<surname>Godoy</surname>
|
||||||
|
</editor>
|
||||||
|
<copyright>
|
||||||
|
<year>2000</year>
|
||||||
|
<holder>&conectiva;</holder>
|
||||||
|
</copyright>
|
||||||
|
<title>Network and Systems Administration Using Linux</title>
|
||||||
|
<legalnotice>
|
||||||
|
<para>The contents of this book can be freely used and distributed
|
||||||
|
as far as the source is mentioned as a reference that is, its bibliograph.</para>
|
||||||
|
</legalnotice>
|
||||||
|
<edition>INTERNAL Edition for comments</edition>
|
||||||
|
<publisher>
|
||||||
|
<publishername>Conectiva S/A</publishername>
|
||||||
|
<address><city>Curitiba</city><country>Brasil</country></address>
|
||||||
|
</publisher>
|
||||||
|
<revhistory>
|
||||||
|
<revision>
|
||||||
|
<revnumber>1.0</revnumber>
|
||||||
|
<date>Maio de 2000</date>
|
||||||
|
<revremark>First Edition</revremark>
|
||||||
|
</revision>
|
||||||
|
</revhistory>
|
||||||
|
<isbn>ISBN#</isbn>
|
||||||
|
<pubdate>$Data: 1999/12/30 $</pubdate>
|
||||||
|
</bookinfo>
|
|
@ -0,0 +1,60 @@
|
||||||
|
<table frame="all">
|
||||||
|
<title>Sample Table</title>
|
||||||
|
<tgroup cols="5">
|
||||||
|
<colspec colname="column1">
|
||||||
|
<colspec colname="column2">
|
||||||
|
<colspec colname="column3">
|
||||||
|
<colspec colnum="5" colname="column5">
|
||||||
|
<spanspec namest="column1" nameend="column2" spanname="span-horiz" align="center">
|
||||||
|
<spanspec namest="column2" nameend="column3" spanname="span-horiz-vert" align="center">
|
||||||
|
<thead>
|
||||||
|
<row>
|
||||||
|
<entry spanname="span-horiz">
|
||||||
|
<foreignphrase>Span</foreignphrase> horizontal
|
||||||
|
</entry>
|
||||||
|
<entry>Heading 2</entry>
|
||||||
|
<entry>Heading 3</entry>
|
||||||
|
<entry>Heading 4</entry>
|
||||||
|
</row>
|
||||||
|
</thead>
|
||||||
|
<tfoot>
|
||||||
|
<row>
|
||||||
|
<entry>Footing 1</entry>
|
||||||
|
<entry>Footing 2</entry>
|
||||||
|
<entry>Footing 3</entry>
|
||||||
|
<entry>Footing 4</entry>
|
||||||
|
<entry>Footing 5</entry>
|
||||||
|
</row>
|
||||||
|
</tfoot>
|
||||||
|
<tbody>
|
||||||
|
<row>
|
||||||
|
<entry>Data11</entry>
|
||||||
|
<entry>Data12</entry>
|
||||||
|
<entry>Data13</entry>
|
||||||
|
<entry>Data14</entry>
|
||||||
|
<entry>Data15</entry>
|
||||||
|
</row>
|
||||||
|
<row>
|
||||||
|
<entry>Data21</entry>
|
||||||
|
<entry>Data22</entry>
|
||||||
|
<entry>Data23</entry>
|
||||||
|
<entry>Data24</entry>
|
||||||
|
<entry morerows="1" valign="middle">
|
||||||
|
<foreignphrase>Span</foreignphrase> vertical
|
||||||
|
</entry>
|
||||||
|
</row>
|
||||||
|
<row>
|
||||||
|
<entry>Data31</entry>
|
||||||
|
<entry spanname="span-horiz-vert" morerows="1" valign="bottom">
|
||||||
|
<foreignphrase>Span</foreignphrase> duplo
|
||||||
|
</entry>
|
||||||
|
<entry>Data34</entry>
|
||||||
|
</row>
|
||||||
|
<row>
|
||||||
|
<entry>Data41</entry>
|
||||||
|
<entry>Data44</entry>
|
||||||
|
<entry>Data45</entry>
|
||||||
|
</row>
|
||||||
|
</tbody>
|
||||||
|
</tgroup>
|
||||||
|
</table>
|
|
@ -0,0 +1,155 @@
|
||||||
|
<!-- <!doctype glossary PUBLIC "-//OASIS//DTD DocBook V3.1//EN"> -->
|
||||||
|
|
||||||
|
<glossary id="glossary"><?dbhtml filename="glossary.html">
|
||||||
|
<title>Glossary</title>
|
||||||
|
<glossentry>
|
||||||
|
<glossterm>attribute</glossterm>
|
||||||
|
<glossdef>
|
||||||
|
<para>One attributte makes available extra information regarding the
|
||||||
|
element on which it appears. The attributes always appear as a
|
||||||
|
name-value pair on the initialization pointers. Example of an
|
||||||
|
attribute is <parameter
|
||||||
|
class="option">id="identification"</parameter>, which gives to the
|
||||||
|
attribute <parameter class="option">id</parameter> the value
|
||||||
|
<parameter class="option">identification</parameter>.</para>
|
||||||
|
</glossdef>
|
||||||
|
</glossentry>
|
||||||
|
<glossentry>
|
||||||
|
<glossterm>Document Type Definition
|
||||||
|
(<acronym>DTD</acronym>)</glossterm>
|
||||||
|
<glossdef>
|
||||||
|
<para> Group of statements that define element names and their attributes
|
||||||
|
specifying the rules for combinations and sequences. It's the
|
||||||
|
<acronym>DTD</acronym> that define which elements can or cannot
|
||||||
|
be inserted in the context on which the cursor is in.
|
||||||
|
</para>
|
||||||
|
</glossdef>
|
||||||
|
</glossentry>
|
||||||
|
<glossentry>
|
||||||
|
<glossterm><acronym>DSSSL</acronym></glossterm>
|
||||||
|
<glossdef>
|
||||||
|
<para><acronym>DSSSL</acronym> stands for Document Style Semantics and
|
||||||
|
Specification Language. It's an <acronym>ISO</acronym> standard
|
||||||
|
(ISO/IEC 10179:1996). The <acronym>DSSSL</acronym> standard is
|
||||||
|
internationally used as a language for documents stylesheets pages for
|
||||||
|
<acronym>SGML</acronym>.</para>
|
||||||
|
</glossdef>
|
||||||
|
</glossentry>
|
||||||
|
<glossentry>
|
||||||
|
<glossterm>element</glossterm>
|
||||||
|
<glossdef>
|
||||||
|
<para>The elements define the hierarchical structure of a document. The
|
||||||
|
majority of elements have opening and closing pointers. Among these
|
||||||
|
pointers, pieces of text or even the whole document being written can
|
||||||
|
be found. There are empty elements which contains only opening
|
||||||
|
pointers without any content.</para>
|
||||||
|
</glossdef>
|
||||||
|
</glossentry>
|
||||||
|
<glossentry>
|
||||||
|
<glossterm>entity</glossterm>
|
||||||
|
<glossdef>
|
||||||
|
<para>Entity is a name designated for some part of data so that it can be
|
||||||
|
referenced by a name. These designations are made by a statement and
|
||||||
|
the stored data might hold from simple characters to chapters or set
|
||||||
|
of statements of a <acronym>DTD</acronym>. There are parameter
|
||||||
|
entities generic, external, internal and of data on
|
||||||
|
the<acronym>SGML</acronym>.
|
||||||
|
</para>
|
||||||
|
</glossdef>
|
||||||
|
</glossentry>
|
||||||
|
<glossentry>
|
||||||
|
<glossterm>external entity</glossterm>
|
||||||
|
<glossdef>
|
||||||
|
<para>An external entity points to an external document. External entities
|
||||||
|
are used to include texts on certain locations of a
|
||||||
|
<acronym>SGML</acronym> document. Suggestions for its use includes
|
||||||
|
sample screens, legal notes and chapters.</para>
|
||||||
|
</glossdef>
|
||||||
|
</glossentry>
|
||||||
|
<glossentry>
|
||||||
|
<glossterm>generic entities</glossterm>
|
||||||
|
<glossdef>
|
||||||
|
<para>An entity referenced by a name which starts with
|
||||||
|
<quote>&</quote> and ends with semicolon is a generic
|
||||||
|
entity. Most of the time these type of entities are used on the
|
||||||
|
document and not on the <acronym>DTD</acronym>. There are two types
|
||||||
|
of entities: external and internal which refers either to special
|
||||||
|
characters or to text objects such as repeated sentences, names or
|
||||||
|
chapters.</para>
|
||||||
|
</glossdef>
|
||||||
|
</glossentry>
|
||||||
|
<glossentry>
|
||||||
|
<glossterm>internal entity</glossterm>
|
||||||
|
<glossdef>
|
||||||
|
<para>An internal entity refers to part of the text and is often used
|
||||||
|
as a schortcut for portions of a text frequently repeated.</para>
|
||||||
|
</glossdef>
|
||||||
|
</glossentry>
|
||||||
|
<glossentry>
|
||||||
|
<glossterm>paremeter entity</glossterm>
|
||||||
|
<glossdef>
|
||||||
|
<para>An entity often used on the <acronym>DTD</acronym>. The entity's
|
||||||
|
name starts with a percent sign (%) and it ends with a
|
||||||
|
semicolon.</para>
|
||||||
|
</glossdef>
|
||||||
|
</glossentry>
|
||||||
|
<glossentry>
|
||||||
|
<glossterm>float</glossterm>
|
||||||
|
<glossdef>
|
||||||
|
<para>Objects such as side bars, pictures, tables and charts are called
|
||||||
|
floats when they don't have a fixed placement on the text. For a
|
||||||
|
printed text, the chart can appear either at the top or at the
|
||||||
|
bottom of the page. It can also be placed on the next page if that's
|
||||||
|
too large.</para>
|
||||||
|
</glossdef>
|
||||||
|
</glossentry>
|
||||||
|
<glossentry>
|
||||||
|
<glossterm>processing instruction</glossterm>
|
||||||
|
<glossdef>
|
||||||
|
<para>A processing instruction is a command passed to the document
|
||||||
|
formatting tool. It starts with <quote><?</quote>. A sample
|
||||||
|
of instruction is used on this document for the generated file's
|
||||||
|
choice when the file is converted to
|
||||||
|
<acronym>HTML</acronym>: <sgmltag class="starttag">?dbhtml
|
||||||
|
filename="file.html"</sgmltag></para>
|
||||||
|
</glossdef>
|
||||||
|
</glossentry>
|
||||||
|
<glossentry>
|
||||||
|
<glossterm><acronym>SGML</acronym></glossterm>
|
||||||
|
<glossdef>
|
||||||
|
<para><foreignphrase>Standard Generalized Markup
|
||||||
|
Language</foreignphrase>.
|
||||||
|
It's also an international standard (<acronym>ISO</acronym>8879) which
|
||||||
|
specifies rules for the creation of electronic documents in markup
|
||||||
|
systems regardless the work platform used.</para>
|
||||||
|
</glossdef>
|
||||||
|
</glossentry>
|
||||||
|
<glossentry>
|
||||||
|
<glossterm>tag</glossterm>
|
||||||
|
<glossdef>
|
||||||
|
<para>An <acronym>SGML</acronym> element bounded by the marks
|
||||||
|
<quote><</quote> and <quote>></quote>. Tags are used
|
||||||
|
to mark the semantic or the structure of a document. A sample
|
||||||
|
is the tag <emphasis><sgmltag
|
||||||
|
class="starttag">title</sgmltag></emphasis> to mark the beginning
|
||||||
|
of a title.</para>
|
||||||
|
</glossdef>
|
||||||
|
</glossentry>
|
||||||
|
<glossentry>
|
||||||
|
<glossterm><acronym>XML</acronym></glossterm>
|
||||||
|
<glossdef>
|
||||||
|
<para>eXtensible Markup Language. A subproduct of <acronym>SGML</acronym>
|
||||||
|
created specifically for Internet use.</para>
|
||||||
|
</glossdef>
|
||||||
|
</glossentry>
|
||||||
|
<glossentry>
|
||||||
|
<glossterm><acronym>XSL</acronym></glossterm>
|
||||||
|
<glossdef>
|
||||||
|
<para><acronym>XML</acronym> Style
|
||||||
|
Language. XSL is to a <acronym>XML</acronym> document what a
|
||||||
|
<acronym>DSSSL</acronym> style is for a <acronym>SGML</acronym>
|
||||||
|
document. In fact, the style is a document
|
||||||
|
<acronym>XML</acronym>.</para>
|
||||||
|
</glossdef>
|
||||||
|
</glossentry>
|
||||||
|
</glossary>
|
File diff suppressed because one or more lines are too long
Binary file not shown.
After Width: | Height: | Size: 89 KiB |
File diff suppressed because one or more lines are too long
Binary file not shown.
After Width: | Height: | Size: 52 KiB |
File diff suppressed because one or more lines are too long
Binary file not shown.
After Width: | Height: | Size: 6.7 KiB |
File diff suppressed because one or more lines are too long
Binary file not shown.
After Width: | Height: | Size: 107 KiB |
File diff suppressed because it is too large
Load Diff
File diff suppressed because one or more lines are too long
Binary file not shown.
After Width: | Height: | Size: 116 KiB |
Loading…
Reference in New Issue