![[LWN Logo]](/images/lcorner.png) |
|
![[LWN.net]](/images/Included.png) |
From: David Merrill <david@lupercalia.net>
To: LDP Weekly News <news@linuxdoc.org>, Linux Weekly News <lwn@lwn.net>,
Michael Hall <mhall@internet.com>
Subject: LDPWN for 2002-01-15
Date: Tue, 15 Jan 2002 22:33:14 -0500
LDP Weekly News
2002-01-15
by David Merrill
Online Editing, Wiki-style
We are working to provide simple online editing functions for authors
who desire to use it, something similar to a WikiWikiWeb. It won't
have all the functionality that a true Wiki has, but it will provide
tracking of recent changes and the ability to diff between versions as
well as a diff from the authoritative cvs version.
Because we have had feedback from authors who are concerned about
having to learn something new, or having to track changes to two
versions, the web interface will be completely optional at the request
of the author. Authors who like using the cvs or mailing their updates
by email may continue to do so as usual.
I hope to have at least some minimal functionality to report in next
week's LDPWN. Thanks go to Martin Wheeler for the original idea.
Is It DocBook, Or Is It Text?
A side project that came out of the original "Wiki" idea is a utility
that converts from a very simple Wiki-style text format into DocBook,
the very large and complex XML DTD that we use to store our
documentation. It's hard to explain, so here is an example. Here is a
trivial DocBook fragment in standard DocBook format:
<sect1><title id='intro'>Introduction</title>
<para>
Welcome to the
<ulink url='http://www.linuxdoc.org'>
<citetitle>Linux Documentation Project</citetitle>
</ulink>
</para>
</sect1>
Even in this extremely simple example, you can see that DocBook can be
verbose. Some would say that is a great understatement. :-) That's one
of the reasons many authors continue to work in LinuxDoc, which is
simpler but less powerful.
In the simplified text format, this becomes:
=Introduction|intro=
Welcome to the [[http://www.linuxdoc.org|Linux Documentation Project]]
The simplified text format will not even begin to cover all of the
many tags that DocBook provides. That would be a losing battle. Rather
than fight that losing battle, we're allowing for DocBook to be
inserted inline into the text. Unfortunately we have not yet figured
out a way to do it the other way around -- you won't be able to insert
the text hints inside any DocBook structures.
New Documents
* Linux IPv6 HOWTO
http://linuxdoc.org/HOWTO/Linux+IPv6-HOWTO/
Version 0.15, Peter Bieringer
* Linux+Win9x+Grub HOWTO
http://www.linuxdoc.org/HOWTO/Linux+Win9x+Grub-HOWTO/
Version 1.0, Joel Rosen
* The Indic Fonts HOWTO
http://www.linuxdoc.org/HOWTO/Indic-Fonts-HOWTO/
Version 0.1, Maninder Bali
Updated Documents
* Apache Compile HOWTO (Linux edition)
http://www.linuxdoc.org/HOWTO/Apache-Compile-HOWTO/
Version 1.9.7, Luc de Louw, luc@delouw.ch
* C++ Programming HOW-TO
http://www.linuxdoc.org/HOWTO/C++Programming-HOWTO.html
Version 40.9, Al Dev, alavoor@yahoo.com
* C-C++ Beautifier HOW-TO
http://www.linuxdoc.org/HOWTO/C-C++Beautifier-HOWTO.html
Version 15.3, Al Dev, alavoor@yahoo.com
* CDServer-HOWTO
http://www.linuxdoc.org/HOWTO/CDServer-HOWTO/
Version 1.40, Randolph Tata, randy@talcon.com
* CPU Design HOW-TO
http://www.linuxdoc.org/HOWTO/CPU-Design-HOWTO.html
Version 12.0, Al Dev, alavoor@yahoo.com
* CVS-RCS- HOW-TO document for Linux (Source Code Control System)
http://www.linuxdoc.org/HOWTO/CVS-RCS-HOWTO.html
Version 21.7, Al Dev, alavoor@yahoo.com
* Diskless Nodes HOW-TO document for Linux
http://www.linuxdoc.org/HOWTO/Diskless-HOWTO.html
Version 22.4, Al Dev, alavoor@yahoo.com, Gero Kuhlmann,
gero@gkmniix.han.de, Ken Yap, ken.yap@acm.org, Markus Gutschke,
markus+etherboot@gutschke.com, Robert Nemkin, buci@math.klte.hu
* Java Decompiler HOW-TO
http://www.linuxdoc.org/HOWTO/Java-Decompiler-HOWTO.html
Version 4.0, Al Dev, alavoor@yahoo.com
* LILO, Linux Crash Rescue HOW-TO
http://www.linuxdoc.org/HOWTO/LILO-crash-rescue-HOWTO.html
Version 10.1, Al Dev, alavoor@yahoo.com
* Linux Assembly HOWTO
http://www.linuxdoc.org/HOWTO/Assembly-HOWTO/
Version 2002/01/12, Konstantin Boldyshev, konst@linuxassembly.org
* Linux Frequently Asked Questions with Answers
http://www.linuxdoc.org/FAQ/Linux-FAQ/
Version 1.20, Robert Kiesling, rkiesling@mainmatter.com
* Linux IP Masquerade HOWTO
http://www.linuxdoc.org/HOWTO/IP-Masquerade-HOWTO.html
Version 2.00.010502, David Ranch, dranch@trinnet.net
* Linux RAID FAQ
http://www.linuxdoc.org/FAQ/Linux-RAID-FAQ/
Version 0.0.10, Gregory Leblanc, gleblanc (at) cu-portland.edu
* Modem Dialup NT HOWTO
http://linuxdoc.org/HOWTO/Modem-Dialup-NT-HOWTO.html
Version 1.2, Al Dev, alavoor@yahoo.com
* PHP HOW-TO
http://www.linuxdoc.org/HOWTO/PHP-HOWTO.html
Version 25.9, Al Dev, alavoor@yahoo.com
* Process Monitor HOW-TO for Linux
http://www.linuxdoc.org/HOWTO/Process-Monitor-HOWTO.html
Version 11.1, Al Dev, alavoor@yahoo.com
* RPM for Unix HOW-TO
http://linuxdoc.org/HOWTO/RPM-for-Unix-HOWTO.html
Version 1.5, Al Dev, alavoor@yahoo.com
* Secure Programming for Linux and Unix HOWTO
http://www.linuxdoc.org/HOWTO/Secure-Programs-HOWTO/
Version 2.92, David A. Wheeler
* The Linux Bootdisk HOWTO
http://www.linuxdoc.org/HOWTO/Bootdisk-HOWTO/
Version 4.5, Tom Fawcett, bootdisk-howto@linuxdoc.org
* The Linux Gamers HOWTO
http://www.linuxdoc.org/HOWTO/Linux-Gamers-HOWTO/
Version 0.9.4, Peter Jay Salzman, p@dirac.org
* The Linux Kernel HOWTO
http://www.linuxdoc.org/HOWTO/Kernel-HOWTO.html
Version 3.1, Brian Ward, bri@cs.uchicago.edu
* Transparent Proxy with Linux and Squid mini-HOWTO
http://linuxdoc.org/HOWTO/mini/TransparentProxy.html
Version 1.13, Daniel Kiracofe, drk@unxsoft.com
* Vim Color Editor HOW-TO (Vi Improved with syntax color
highlighting
http://www.linuxdoc.org/HOWTO/Vim-HOWTO.html
Version 17.3, Al Dev, alavoor@yahoo.com
Unmaintained Documents
These documents have been abandoned by their maintainers and many of
them have not been updated in some time. If you're willing to become
the maintainer for one of them, please join the LDP discussion list at
lists.linuxdoc.org and post a message indicating your interest.
* Battery Powered Linux Mini-HOWTO
http://www.linuxdoc.org/HOWTO/mini/Battery-Powered.html
Version
* Brief Introduction to Alpha Systems and Processors
http://www.linuxdoc.org/HOWTO/Alpha-HOWTO.html
Version 0.11
* Enterprise Java for Linux HOWTO
http://www.linuxdoc.org/HOWTO/Enterprise-Java-for-Linux-HOWTO.html
Version 0.2
* HOW-TO for inHouse IntraNet
http://www.linuxdoc.org/HOWTO/mini/Netscape+Proxy.html
Version
* Installing Linux on ZIP disk using ppa ZIP Drive Mini-Howto
http://www.linuxdoc.org/HOWTO/mini/Install-From-ZIP.html
Version 0.7
* LINUX PLIP MINI-HOWTO
http://www.linuxdoc.org/HOWTO/mini/PLIP.html
Version 2.1
* Linux Benchmarking HOWTO
http://www.linuxdoc.org/HOWTO/Benchmarking-HOWTO.html
Version 0.12
* Linux Swap Space Mini-HOWTO
http://www.linuxdoc.org/HOWTO/mini/Swap-Space.html
Version 1.42
* Linux Threads Frequently Asked Questions (FAQ)
http://www.linuxdoc.org/FAQ/Threads-FAQ/
Version
* Linux simple fax printer server mini-HOWTO (faxsrv-mini-HOWTO)
http://www.linuxdoc.org/HOWTO/mini/Fax-Server.html
Version 1.0
* NFS-Root Mini-Howto
http://www.linuxdoc.org/HOWTO/mini/NFS-Root.html
Version 8
* News Leafsite mini-HOWTO
http://www.linuxdoc.org/HOWTO/mini/News-Leafsite.html
Version 0.4
* SoundBlaster AWE 32/64 HOWTO
http://www.linuxdoc.org/HOWTO/mini/Soundblaster-AWE.html
Version 1.2
* Spanish Linux HOWTO
http://www.linuxdoc.org/HOWTO/Spanish-HOWTO.html
Version 0.1
* The Ftape FAQ
http://www.linuxdoc.org/FAQ/Ftape-FAQ.html
Version 0.2
* The Hebrew HOWTO
http://www.linuxdoc.org/HOWTO/Hebrew-HOWTO.html
Version 0.4
* The LBX Mini-HOWTO
http://www.linuxdoc.org/HOWTO/mini/LBX.html
Version 1.04
* The Linux ""Linux-DOS-Win95-OS2"" mini-HOWTO
http://www.linuxdoc.org/HOWTO/mini/Linux+DOS+Win95+OS2.html
Version 1.3.1
* The Linux 3Dfx HOWTO
http://www.linuxdoc.org/HOWTO/3Dfx-HOWTO.html
Version 1.16
* The Linux Busmouse HOWTO
http://www.ibiblio.org/pub/Linux/docs/HOWTO/unmaintained/Busmouse-
HOWTO/
Version 2.0
* The Linux Intranet Server HOWTO
http://www.linuxdoc.org/HOWTO/Intranet-Server-HOWTO.html
Version 2.12
* The dosemu HOWTO
http://www.linuxdoc.org/HOWTO/DOSEMU-HOWTO.html
Version
* Token-Ring mini-HOWTO
http://www.linuxdoc.org/HOWTO/mini/Token-Ring.html
Version 4.1
* UMSDOS HOW-TO
http://www.linuxdoc.org/HOWTO/UMSDOS-HOWTO.html
Version 1.2
* Visible bell mini-Howto
http://www.linuxdoc.org/HOWTO/mini/Visual-Bell.html
Version 2.3
* X11-big-cursor MINIHOWTO
http://www.linuxdoc.org/HOWTO/mini/X-Big-Cursor.html
Version 2
* mini-HOWTO install qmail with MH
http://www.linuxdoc.org/HOWTO/mini/Qmail+MH.html
Version 1.4
About the LDP
The Linux Documentation Project is developing free, high quality
documentation for the GNU/Linux operating system. This includes the
creation of HOWTOs and Guides, and collaboration with other
documentation groups.
If you've always wanted to help Linux reach Total World
Domination(tm), but you're not a programmer, there's still something
you can do. Help the LDP!
The LDP keeps a page of resources for authors at
http://www.linuxdoc.org/authors/. Contributions are always welcome.
For more LDP Weekly News, go to http://www.linuxdoc.org/ldpwn/
--
David C. Merrill http://www.lupercalia.net
Linux Documentation Project david@lupercalia.net
Collection Editor & Coordinator http://www.linuxdoc.org
Arrakis teaches the attitude of the knife -- chopping off what's
incomplete and saying: "Now, it's complete because it's ended here."
-- from "Collected Sayings of Muad'Dib"
by the Princess Irulan