[Fwd: [opensuse-doc] [ANN] Susedoc XML Build Environment]

classic Classic list List threaded Threaded
1 message Options
jdd
Reply | Threaded
Open this post in threaded view
|

[Fwd: [opensuse-doc] [ANN] Susedoc XML Build Environment]

jdd
somebody here can be interested by the following annoucement.

there is with the product a docbook to mediawiki translator.
Of course only for page like documents and it's a first draft.
jdd

-------- Message original --------
Sujet: [opensuse-doc] [ANN] Susedoc XML Build Environment
Date: Wed, 11 Oct 2006 13:49:30 +0200
De: Thomas Schraitle <[hidden email]>
Organisation: SUSE Linux
Pour: [hidden email]

Hi,

we like to announce the alpha release of "susedoc", a
toolkit the
SUSE doc team develops and uses to build the SUSE
documentation,
released under the GPL. The RPM package contains makefiles and
stylesheets for HTML, XSL-FO and Wiki. See

10.0
http://software.opensuse.org/download/home:/thomas-schraitle/SUSE_Linux_10.0/noarch/susedoc-4.2_20061011-5.1.noarch.rpm

10.1
http://software.opensuse.org/download/home:/thomas-schraitle/SUSE_Linux_10.1/noarch/susedoc-4.2_20061011-5.1.noarch.rpm


1. Features
-----------------------------------------------

* Validates your XML sources

* Contains Python script to create a working sandbox with all
   necessary files.

* Creates HTML, PDF and Wiki with a simple make command

* Supports handling of conditional text in XML (aka "profiling")

* Supports XEP, FOP planned


2. Requirements
-----------------------------------------------

* libxml2, libxslt
* inkscape
* transfig
* ImageMagick
* java
* xml-commons-resolver
* docbook-xsl-stylesheets
* svg-dtd
* freefont
* fop or xep


3. Restrictions
-----------------------------------------------

* At the moment you can not build PDFs with our customized
stylesheets
   due to restrictions on the FOP side (we use XEP.).
However, it is
   possible to use the original DocBook XSLT stylesheets.

* Wiki stylesheets are a "work in progress". Small chapters or
   articles should work but whole books needs more work.

* Documentation can be improved. ;)


4. Quickstart
-----------------------------------------------

With the help of susedoc-new.py after installation you can
create
a "Hello World" sandbox where you can play with, for example:

   $ susedoc-new.py -d docbook_44

This creates a directory "susedoc-xmltest" where you can
find all the
needed files. To create HTML, run "make html". For more
information,
see "susedoc-xmltest/README" or use "make help".


For the next weeks I am on vacation. If you have questions
please
contact Frank Sundermeyer. :)


Have fun!
Tom


--
Thomas Schraitle

----------------------------------------------------------------------
SUSE LINUX GmbH      >o)   Documentation Specialist
Maxfeldstrasse 5     /\\
90409 Nuernberg     _\_v
http://en.opensuse.org/Documentation_Team
---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]




--
http://www.dodin.net
http://dodin.org/galerie_photo_web/expo/index.html
http://lucien.dodin.net
http://fr.susewiki.org/index.php?title=Gérer_ses_photos
_______________________________________________
MediaWiki-l mailing list
[hidden email]
http://mail.wikipedia.org/mailman/listinfo/mediawiki-l