modules/export_docbook/README.txt

Export_DocBook module
=====================

Description:
------------
        
This module allows the export of Drupal books, in DocBook
XML format.  It is assumed that the input is HTML; this
input is cleaned using Tidy to generate XHTML, which is
then transformed via XSLT into DocBook.

Version:
________

This version of export_docbook depends on book.module
v1.334 or later (CVS HEAD on Nov 30, 2005)


Pre-requisites:
_______________

The module assumes that you are running PHP5, and have
Tidy support enabled.


Bugs:
_____

The way in which the generated XML is supplied to the user is
unfriendly.  Perhaps a better approach would be to take the
user to a page with a generated link to download the 
requested XML.

The output transformation is not terribly well tested yet.
It's not complete, though it should cover most of the 
commonly used HTML constructs. 

Please report bugs via Drupal's issue tracker: 
http://drupal.org/project/issues


Credits
-------

The XSLT script is based on HTML2DocBook, by Jeff Beal, as found
on wiki.docbook.org.


History
-------

2005-07-22: First (alpha) release.
2005-11-22: Beta release.


Author
-------

Djun Kim (puregin@puregin.org)

1	Export_DocBook module
2	=====================
3
4	Description:
5	------------
6
7	This module allows the export of Drupal books, in DocBook
8	XML format. It is assumed that the input is HTML; this
9	input is cleaned using Tidy to generate XHTML, which is
10	then transformed via XSLT into DocBook.
11
12	Version:
13	________
14
15	This version of export_docbook depends on book.module
16	v1.334 or later (CVS HEAD on Nov 30, 2005)
17
18
19	Pre-requisites:
20	_______________
21
22	The module assumes that you are running PHP5, and have
23	Tidy support enabled.
24
25
26	Bugs:
27	_____
28
29	The way in which the generated XML is supplied to the user is
30	unfriendly. Perhaps a better approach would be to take the
31	user to a page with a generated link to download the
32	requested XML.
33
34	The output transformation is not terribly well tested yet.
35	It's not complete, though it should cover most of the
36	commonly used HTML constructs.
37
38	Please report bugs via Drupal's issue tracker:
39	http://drupal.org/project/issues
40
41
42	Credits
43	-------
44
45	The XSLT script is based on HTML2DocBook, by Jeff Beal, as found
46	on wiki.docbook.org.
47
48
49	History
50	-------
51
52	2005-07-22: First (alpha) release.
53	2005-11-22: Beta release.
54
55
56	Author
57	-------
58
59	Djun Kim (puregin@puregin.org)
60