mirror of https://github.com/tLDP/LDP
522 lines
17 KiB
XML
522 lines
17 KiB
XML
<!--
|
|
<!DOCTYPE book PUBLIC '-//OASIS//DTD DocBook XML V4.2//EN'>
|
|
-->
|
|
|
|
<!--
|
|
Sample Bibliography Entry. Please follow this format!
|
|
|
|
<biblioentry>
|
|
<title></title>
|
|
<bibliosource><ulink url="" /></bibliosource>
|
|
<author><firstname></firstname><surname></surname></author>
|
|
<copyright><year></year>
|
|
<holder></holder></copyright>
|
|
<editor><firstname></firstname><surname></surname></editor>
|
|
<isbn></isbn>
|
|
<publisher>
|
|
<publishername></publishername>
|
|
</publisher>
|
|
<abstract></abstract>
|
|
</biblioentry>
|
|
|
|
or for a short item (title + url)
|
|
<biblioentry>
|
|
<title></title>
|
|
<bibliosource><ulink url="" /></bibliosource>
|
|
</biblioentry>
|
|
-->
|
|
|
|
<bibliography id="bibliography">
|
|
<title>References</title>
|
|
|
|
<bibliodiv id="ref-markup">
|
|
<title>Markup and general information</title>
|
|
<biblioentry>
|
|
<title>Secret Life of Markup, The</title>
|
|
<bibliosource><ulink
|
|
url="http://hotwired.lycos.com/webmonkey/02/42/index4a.html" /></bibliosource>
|
|
<author><firstname>Steve</firstname><surname>Champeon</surname></author>
|
|
</biblioentry>
|
|
<biblioentry>
|
|
<title>Progressive Enhancement and the Future of Web Design</title>
|
|
<subtitle>
|
|
Where We Are Now
|
|
</subtitle>
|
|
<bibliosource><ulink
|
|
url="http://hotwired.lycos.com/webmonkey/03/21/index3a_page2.html" /></bibliosource>
|
|
<author><firstname>Steve</firstname><surname>Champeon</surname></author>
|
|
</biblioentry>
|
|
<biblioentry>
|
|
<title>SGML</title>
|
|
<bibliosource><ulink url="http://www.w3.org/MarkUp/SGML/" /></bibliosource>
|
|
</biblioentry>
|
|
</bibliodiv>
|
|
|
|
<bibliodiv id="ref-docbook">
|
|
<title>DocBook References</title>
|
|
<biblioentry>
|
|
<title>DocBook XML 4.1.2 Quick Start Guide</title>
|
|
<bibliosource><ulink url="http://www.jimweller.net/jim/dbxmlqs/index.html" /></bibliosource>
|
|
<author><firstname>Jim</firstname><surname>Weller</surname></author>
|
|
<abstract>
|
|
<para>
|
|
<blockquote>
|
|
<attribution>Jim Weller</attribution>
|
|
<para>Describes how to install, configure and use the tools and resources for
|
|
DocBook XML 4.1.2. The purpose of this quick start guide is to get new
|
|
docbook authors, editors, and contributors up and running fast with the
|
|
DoocBook tools. These are powerful tool in the hands of an author. It
|
|
assumes a fair knowledge of building and installing source packages.
|
|
There are probably a million and one ways to accomplish my ultimate
|
|
goal of installing and using these tools. This one works well for
|
|
me.
|
|
</para></blockquote>
|
|
</para>
|
|
</abstract>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>
|
|
Installing And Using An XML/SGML DocBook Editing Suite
|
|
Setting Up A Free XML/SGML DocBook Editing Suite For Windows And
|
|
Unix/Linux/BSD</title>
|
|
<bibliosource><ulink
|
|
url="http://supportweb.cs.bham.ac.uk/documentation/tutorials/docsystem/build/tutorials/docbooksys/docbooksys.html"
|
|
/>
|
|
</bibliosource>
|
|
<author><firstname>Ashley J.S.</firstname><surname>Mills</surname></author>
|
|
<copyright><year>2002</year>
|
|
<holder>The University Of Birmingham</holder></copyright>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>
|
|
Getting Upto Speed With DocBook</title>
|
|
<bibliosource><ulink url="http://supportweb.cs.bham.ac.uk/documentation/tutorials/docsystem/build/tutorials/UniDocBook/UniDocBook.html" /></bibliosource>
|
|
<author><firstname>Ashley J.S.</firstname><surname>Mills</surname></author>
|
|
<copyright><year>2002</year>
|
|
<holder>The University Of Birmingham</holder></copyright>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>DocBook: The Definitive Guide</title>
|
|
<bibliosource><ulink url="http://www.docbook.org/" /></bibliosource>
|
|
<author><firstname>Norman</firstname><surname>Walsh</surname></author>
|
|
<author><firstname>Leonard</firstname><surname>Muellner</surname></author>
|
|
<copyright><year>1999</year>
|
|
<holder>O'Reilly & Associates, Inc.</holder></copyright>
|
|
<isbn>1-56592-580-7</isbn>
|
|
<publisher>
|
|
<publishername>O'Reilly & Associates, Inc.</publishername>
|
|
</publisher>
|
|
<abstract>
|
|
<para>This book was released by O'Reilly in October 1999, and
|
|
is a great reference to DocBook. I have not found it to be a
|
|
great practical book. You can pick it up at the book vendor of
|
|
choice, and the entire book is also available online (in HTML and SGML
|
|
formats) at the above URL. </para>
|
|
</abstract>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>Simplified DocBook: The Definitive Guide</title>
|
|
<bibliosource><ulink
|
|
url="http://www.docbook.org/tdg/simple/en/html/sdocbook.html" /></bibliosource>
|
|
<author><firstname>Norman</firstname><surname>Walsh</surname></author>
|
|
<author><firstname>Leonard</firstname><surname>Muellner</surname></author>
|
|
<copyright><year>1999</year>
|
|
<holder>O'Reilly & Associates, Inc.</holder></copyright>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>Simplified DocBook</title>
|
|
<bibliosource><ulink url="http://www.oasis-open.org/docbook/xml/simple/" /></bibliosource>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>XML Matters: Getting started with the DocBook XML
|
|
dialect</title>
|
|
<bibliosource><ulink
|
|
url="http://www-106.ibm.com/developerworks/xml/library/xml-matters3.html" /></bibliosource>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>FAQ for DocBook markup</title>
|
|
<bibliosource><ulink url="http://www.dpawson.co.uk/docbook/markup.html" /></bibliosource>
|
|
</biblioentry>
|
|
|
|
|
|
<biblioentry>
|
|
<title>Single-Source Publishing with DocBook XML</title>
|
|
<abbrev></abbrev>
|
|
<bibliosource><ulink url="
|
|
http://www.lodestar2.com/people/dyork/talks/2002/ols/docbook-tutorial/frames/frames.html" /></bibliosource>
|
|
<author><firstname>Dan</firstname><surname>York</surname></author>
|
|
<copyright><year>2002</year>
|
|
<holder>Dan York</holder></copyright>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>
|
|
DocBook Install mini-HOWTO</title>
|
|
<bibliosource><ulink url="http://tldp.org/HOWTO/mini/DocBook-Install/" /></bibliosource>
|
|
<author><firstname>Robert</firstname><surname>Easter</surname></author>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>Exploring SGML DocBook</title>
|
|
<bibliosource><ulink url="http://lwn.net/2000/features/DocBook/" /></bibliosource>
|
|
<author><firstname>Giorgio</firstname><surname>Zoppi</surname></author>
|
|
</biblioentry>
|
|
</bibliodiv>
|
|
|
|
<bibliodiv id="ref-linuxdoc">
|
|
<title>LinuxDoc</title>
|
|
<biblioentry>
|
|
<title>Howtos-with-LinuxDoc-mini-HOWTO</title>
|
|
<bibliosource><ulink
|
|
url="http://www.tldp.org/HOWTO/Howtos-with-LinuxDoc.html" /></bibliosource>
|
|
<author><firstname>David</firstname><surname>Lawyer</surname></author>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>LinuxDoc-SGML User's Guide</title>
|
|
<bibliosource><ulink url="http://www.nmt.edu/tcc/doc/guide.html" /></bibliosource>
|
|
</biblioentry>
|
|
</bibliodiv>
|
|
|
|
<bibliodiv id="ref-x2docbook">
|
|
<title>Converting Other Formats to DocBook</title>
|
|
<biblioentry>
|
|
<title>
|
|
Converting HTML to Docbook SGML/XML Using html2db</title>
|
|
<bibliosource><ulink url="http://www.cise.ufl.edu/~ppadala/tidy/" /></bibliosource>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>5-Minute Review: Using LyX for Creating DocBook</title>
|
|
<bibliosource><ulink url="http://www.teledyn.com/help/XML/lyx2db/t1.html" /></bibliosource>
|
|
</biblioentry>
|
|
<biblioentry>
|
|
<title>Document processing with LyX and SGML</title>
|
|
<bibliosource><ulink url="http://www.karakas-online.de/mySGML/" /></bibliosource>
|
|
</biblioentry>
|
|
</bibliodiv>
|
|
|
|
<bibliodiv id="ref-templates">
|
|
<title>LDP templates, tools & links</title>
|
|
|
|
<biblioentry>
|
|
<title>LDP Templates</title>
|
|
<abbrev></abbrev>
|
|
<bibliosource><ulink url="http://www.tldp.org/authors/index.html#resources">http://www.tldp.org/authors/index.html#resources</ulink>
|
|
</bibliosource>
|
|
<abstract>
|
|
<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.
|
|
Also contains links to tools and other useful information.
|
|
</para>
|
|
</abstract>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>Linux Documentation Project HOWTO Generator, The</title>
|
|
<bibliosource><ulink
|
|
url="http://www.nyx.net/~sgjoen/The_LDP_HOWTO_Generator.html" /></bibliosource>
|
|
<abstract>
|
|
<para>
|
|
This is a standalone web page with a number of fields to fill in
|
|
and a few buttons. When ready the compile button starts the
|
|
compilation of all the input fields and wraps it all in proper
|
|
LinuxDoc SGML, ready to process with the LinuxDoc SGML tools.
|
|
</para>
|
|
|
|
<para>
|
|
The compiled output is outputted to a read-only text area near
|
|
the bottom of the webpage, so the text has to be copied and
|
|
pasted into a file for compilation.
|
|
</para>
|
|
|
|
<para>
|
|
DocBook is not currently supported.
|
|
</para>
|
|
</abstract>
|
|
</biblioentry>
|
|
|
|
</bibliodiv>
|
|
|
|
<bibliodiv id="ref-transform">
|
|
<title>DocBook Transformations</title>
|
|
|
|
<biblioentry>
|
|
<title>DocBook XML/SGML Processing Using OpenJade</title>
|
|
<abbrev></abbrev>
|
|
<bibliosource><ulink url="http://tldp.org/HOWTO/DocBook-OpenJade-SGML-XML-HOWTO/" /></bibliosource>
|
|
<author><firstname>Saqib</firstname><surname>Ali</surname></author>
|
|
</biblioentry>
|
|
|
|
</bibliodiv>
|
|
|
|
<bibliodiv id="ref-techwriting">
|
|
<title>General Writing Links and Style Guides</title>
|
|
|
|
<biblioentry>
|
|
<title>
|
|
Guide to Grammar and Style</title>
|
|
<bibliosource><ulink url="http://newark.rutgers.edu/~jlynch/Writing/" /></bibliosource>
|
|
<author><firstname>Jack</firstname><surname>Lynch</surname></author>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>Purdue's Online Writing Lab</title>
|
|
<bibliosource><ulink url="http://owl.english.purdue.edu/" /></bibliosource>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>
|
|
Chicago Manual of Style</title>
|
|
<bibliosource><ulink url="http://www.chicagomanualofstyle.org/" /></bibliosource>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>
|
|
Plain Language Resources</title>
|
|
<bibliosource><ulink url="http://www.plainlanguagenetwork.org/Resources/" /></bibliosource>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>Writing User-Friendly Documents</title>
|
|
<bibliosource><ulink url="http://www.blm.gov/nhp/NPR/pe_toc.html" /></bibliosource>
|
|
<abstract><para>
|
|
This is quite useful. It includes before and after writing samples.
|
|
</para></abstract>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>PlainTrain Writing Tutorial</title>
|
|
<bibliosource><ulink
|
|
url="http://www.web.net/~plain/PlainTrain/IntroducingPlainLanguage.html" /></bibliosource>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>Writing for the Web</title>
|
|
<bibliosource><ulink url="http://www.useit.com/papers/webwriting/" /></bibliosource>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>Information Pollution</title>
|
|
<bibliosource><ulink url="http://useit.com/alertbox/20030811.html" /></bibliosource>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>Be Succinct! (Writing for the Web)</title>
|
|
<bibliosource><ulink url="http://useit.com/alertbox/9703b.html" /></bibliosource>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>Politics and the English Language</title>
|
|
<bibliosource><ulink
|
|
url="http://www.k-1.com/Orwell/index.cgi/work/essays/language.html" /></bibliosource>
|
|
<author><firstname>George</firstname><surname>Orwell</surname></author>
|
|
<abstract>
|
|
<para>A classic text on writing.</para>
|
|
</abstract>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>Elements of Style, The</title>
|
|
<bibliosource><ulink url="http://www.bartleby.com/141/" /></bibliosource>
|
|
<author><firstname></firstname><surname>Strunk and White</surname></author>
|
|
<abstract>
|
|
<para>A classic text on writing.</para>
|
|
</abstract>
|
|
</biblioentry>
|
|
|
|
|
|
<biblioentry>
|
|
<title>A Short Handbook and Style Sheet</title>
|
|
<bibliosource><ulink
|
|
url="http://newark.rutgers.edu/~jlynch/Writing/m.html#mechanics" /></bibliosource>
|
|
<author><firstname>Thomas</firstname><surname>Pinney</surname></author>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>Technical Writing Links</title>
|
|
<bibliosource><ulink url="http://www.techcomplus.com/tips.htm" /></bibliosource>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>
|
|
Technical Writing Tutorial</title>
|
|
<bibliosource><ulink url="http://psdam.mit.edu/rise/tutorials/writing/technical-writing.html" /></bibliosource>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>
|
|
Strategies to succeed in technical writing</title>
|
|
<bibliosource><ulink url="http://www.school-for-champions.com/techwriting.htm" /></bibliosource>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>
|
|
User Guides Online Tutorial</title>
|
|
<bibliosource><ulink url="http://www.klariti.com/technical-writing/User-Guides-Tutorial.shtml" /></bibliosource>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>
|
|
DMOZ Technical Writing Links</title>
|
|
<bibliosource><ulink url="http://dmoz.org/Arts/Writers_Resources/Non-Fiction/Technical_Writing/" /></bibliosource>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>
|
|
techwr-L</title>
|
|
<bibliosource><ulink url="http://www.raycomm.com/techwhirl/magazine/" /></bibliosource>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>Technical Writing Links</title>
|
|
<bibliosource><ulink url="http://academic.middlesex.cc.ma.us/PeterHarbeson/links.html" /></bibliosource>
|
|
<abstract><para>
|
|
An omnibus of links--scrounge for goodies.
|
|
</para></abstract>
|
|
</biblioentry>
|
|
|
|
</bibliodiv>
|
|
|
|
<bibliodiv id="ref-relatedtldp">
|
|
<title>Related TLDP Documents</title>
|
|
<biblioentry>
|
|
<title>
|
|
Linux Documentation Project (LDP) FAQ</title>
|
|
<bibliosource><ulink url="http://tldp.org/FAQ/LDP-FAQ/index.html" /></bibliosource>
|
|
<author><firstname>Rahul</firstname><surname>Sundaram</surname></author>
|
|
</biblioentry>
|
|
<biblioentry>
|
|
<title>LDP HOWTO-INDEX</title>
|
|
<bibliosource><ulink
|
|
url="http://tldp.org/HOWTO/HOWTO-INDEX/" /></bibliosource>
|
|
<author><firstname>Guylhem</firstname><surname>Aznar</surname></author>
|
|
<author><firstname>Joshua</firstname><surname>Drake</surname></author>
|
|
<author><firstname>Greg</firstname><surname>Ferguson</surname></author>
|
|
</biblioentry>
|
|
</bibliodiv>
|
|
|
|
<bibliodiv id="ref-software-edit">
|
|
<title>Software: Emacs</title>
|
|
|
|
<biblioentry>
|
|
<title>Information about PSGML </title>
|
|
<bibliosource><ulink url="http://www.lysator.liu.se/~lenst/about_psgml/" /></bibliosource>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>Emacs: The Free Software IDE</title>
|
|
<bibliosource><ulink url="http://www.linuxjournal.com/article.php?sid=576" /></bibliosource>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>Emacs/PSGML Quick Reference</title>
|
|
<bibliosource><ulink url="http://www.snee.com/bob/sgmlfree/psgmqref.html" /></bibliosource>
|
|
<author><firstname>Bob</firstname><surname>Ducharme</surname></author>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>NT Emacs Installation</title>
|
|
<bibliosource><ulink url="http://www.charlescurley.com/emacs.html" /></bibliosource>
|
|
<author><firstname>Charles</firstname><surname>Curley</surname></author>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>Cygwin Packages for DocBook Authoring</title>
|
|
<bibliosource><ulink
|
|
url="http://www.docbook.org/wiki/moin.cgi/CygwinPackages/" /></bibliosource>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>SGML for Windows NT</title>
|
|
<subtitle>
|
|
Setting up a free SGML/XML editing and publishing system on
|
|
Windows/Cygwin
|
|
</subtitle>
|
|
<bibliosource><ulink
|
|
url="http://ourworld.compuserve.com/homepages/hoenicka_markus/cygbook1.html" /></bibliosource>
|
|
<author><firstname>Markus</firstname><surname>Hoenicka</surname></author>
|
|
<copyright><year>2000</year>
|
|
<holder>Markus Hoenicka</holder></copyright>
|
|
</biblioentry>
|
|
|
|
|
|
<biblioentry>
|
|
<title>Vim</title>
|
|
<bibliosource><ulink
|
|
url="http://www.newriders.com/books/opl/ebooks/0735710015.html" /></bibliosource>
|
|
<author><firstname>Steve</firstname><surname>Oualline</surname></author>
|
|
</biblioentry>
|
|
</bibliodiv>
|
|
|
|
<bibliodiv id="ref-xml">
|
|
<title>XML Authoring Tools</title>
|
|
<biblioentry>
|
|
<title>Saqib's list of XML Authoring Tools</title>
|
|
<bibliosource><ulink url="http://www.xml-dev.com/xml/editors.html" /></bibliosource>
|
|
</biblioentry>
|
|
</bibliodiv>
|
|
|
|
<bibliodiv id="ref-licenses">
|
|
<title>Documentation Licenses</title>
|
|
|
|
<biblioentry>
|
|
<title>Licensing HOWTO</title>
|
|
<bibliosource><ulink url="http://www.catb.org/~esr/Licensing-HOWTO.html" /></bibliosource>
|
|
<author><firstname>Eric</firstname><surname>Raymond</surname></author>
|
|
<author><firstname>Catherine</firstname><surname>Raymond</surname></author>
|
|
<abstract>
|
|
<para><blockquote>
|
|
<attribution>Eric Raymond and Catherine Raymond</attribution>
|
|
<para>
|
|
This document explains how U.S. copyright and licensing law applies to
|
|
open-source software projects. It compares the strengths and weaknesses of
|
|
the existing open-source licenses, and gives guidance on how to choose a
|
|
license for your project. It also explains the legalities of changing a
|
|
project's license. It suggests new practice for coping with today's
|
|
high-threat legal environment--this part is a must-read for all
|
|
project leaders.
|
|
</para>
|
|
</blockquote></para>
|
|
</abstract>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>OPL</title>
|
|
<bibliosource><ulink url="http://www.opencontent.org/openpub/" /></bibliosource>
|
|
<abstract><para>OpenContent officially closed June 30, 2003.
|
|
</para></abstract>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>Creative Commons</title>
|
|
<bibliosource><ulink url="http://creativecommons.org/licenses/by-sa/1.0/" /></bibliosource>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>GNU Free Documentation License</title>
|
|
<bibliosource><ulink url="http://www.gnu.org/copyleft/fdl.html" /></bibliosource>
|
|
</biblioentry>
|
|
|
|
<biblioentry>
|
|
<title>GNU General Public License</title>
|
|
<bibliosource><ulink url="http://www.gnu.org/licenses/licenses.html#GPL" /></bibliosource>
|
|
<abstract><para>
|
|
If you would like your documents to be included in the main Debian
|
|
distribution, you should use this license. It is not, however, the
|
|
LDP's license of choice.
|
|
</para></abstract>
|
|
</biblioentry>
|
|
|
|
</bibliodiv>
|
|
|
|
</bibliography>
|