diff --git a/LDP/guide/docbook/LDP-Author-Guide/ag-maintain.xml b/LDP/guide/docbook/LDP-Author-Guide/ag-maintain.xml index aef95033..bbeed8ef 100644 --- a/LDP/guide/docbook/LDP-Author-Guide/ag-maintain.xml +++ b/LDP/guide/docbook/LDP-Author-Guide/ag-maintain.xml @@ -58,7 +58,9 @@ If you find an error in someone else's document please contact the author of the document, or the LDP - coordinator at feedback@en.tldp.org and + coordinator at discuss@en.tldp.org (subscription + required) and mention the problem and how you think it needs to be fixed. diff --git a/LDP/guide/docbook/LDP-Author-Guide/ag-proposal.xml b/LDP/guide/docbook/LDP-Author-Guide/ag-proposal.xml index fe5605aa..a89ff86c 100644 --- a/LDP/guide/docbook/LDP-Author-Guide/ag-proposal.xml +++ b/LDP/guide/docbook/LDP-Author-Guide/ag-proposal.xml @@ -229,7 +229,9 @@ wishes to maintain the document in question. Note that the E-mail address shown may no longer be valid. In that case, try a search for the author. If the original author of a document cannot be found after a good-faith effort, -let us know (feedback@en.tldp.org). +let us know (discuss@en.tldp.org--subscription +required). diff --git a/LDP/guide/docbook/LDP-Author-Guide/tools-word-processors.xml b/LDP/guide/docbook/LDP-Author-Guide/tools-word-processors.xml index b2c7f552..d8ddbdbc 100644 --- a/LDP/guide/docbook/LDP-Author-Guide/tools-word-processors.xml +++ b/LDP/guide/docbook/LDP-Author-Guide/tools-word-processors.xml @@ -56,7 +56,7 @@ . -
+
Open Office 1.0.x OOo has been tested by LDP volunteers with mostly positive @@ -131,7 +131,7 @@ or whether
-
+
Open Office 1.1 Tabatha Marshall diff --git a/LDP/guide/docbook/LDP-Author-Guide/x2docbook.xml b/LDP/guide/docbook/LDP-Author-Guide/x2docbook.xml index a62bb4b5..29a29196 100644 --- a/LDP/guide/docbook/LDP-Author-Guide/x2docbook.xml +++ b/LDP/guide/docbook/LDP-Author-Guide/x2docbook.xml @@ -4,6 +4,16 @@ Converting Documents to DocBook XML + A variety of free and commercial tools exist for doing up conversion of non-XML formats to DocBook. A few are listed here for your convenience. A more comprehensive list is available from Convert Other Formats to DocBook. + +
+ Text to DocBook + + The txt2docbook tool allows one to convert a ascii (README-like) file to a valid docbook xml document. It simplifies the publishing of rather small papers significantly. The input format was inspired by the APT-Convert tool from . + + The script can be downloaded from . +
+
OpenOffice.org to DocBook @@ -13,7 +23,7 @@ Although OOo uses the full DocBook document type declaration, it does not actually export the full list of DocBook elements. It - uses a simplified DocBook tagset which is geared + uses a simplified DocBook tag set which is geared to on-the-fly rendering. (Although it is not the official Simplified DocBook which is described in .) The OpenOffice simplified (or special docbook) is available from @@ -227,8 +237,6 @@ to find conversion tools.
-
-
Microsoft Word to DocBook Even if you want to use MS Word to write your documents, you may @@ -236,7 +244,21 @@ to find conversion tools. useful. Note that this is not free software--the cost is around $130USD. There is, however, a trial version of the software.
- + +
+ LyX to DocBook + This section is contributed by Chris Karakas. + + You can use the LyX-to-X package to write your document conveniently in LyX (a visual editor originally developped as a graphical frontend to LaTeX), then export it to DocBook SGML and submit it to The LDP. This method is presented by Chris Karakas Document processing with LyX and SGML. + + In the LyX-to-X project, LyX is used as a comfortable graphical SGML editor. Once the document is exported to SGML from LyX, it undergoes a series of transformations through sed and awk scripts that correct the SGML code, computes the Index, inserts the Bibliography and the Appendix and takes care of the correct invocation of openjade, pdftex, pdfjadetex and all the other necessary programs for the generation of HTML (chunked or not), PDF (with images, bookmarks, thumbnails and hyperlinks), PS, RTF and TXT versions. + + All aspects of document processing are handled, + including automatic Index generation, display of Mathematics in TeX quality both online and in print formats, as well as the use of bibliographic databases with RefDB. Special care is taken so that the document processing is as transparent to the user as possible - the aim being that the user writes in LyX, then presses a button, and the LyX-to-X script does the rest. Download the documentation and the LyX-to-X package from the Formats section. + + +
+
XML and SGML DocBook