#
#
# add_file "TODO"
# content [7029fd573d318009b1c4862c4976cfab90be992f]
#
# add_file "converter_html.xslt"
# content [5190194e2a445177d3a35cdd7fbf3148b3cb2fcd]
#
# add_file "converter_mdwn.xslt"
# content [1c281777a4b2122a1ea85efb669eda5675b6f8c5]
#
# patch "CHANGELOG"
# from [431b17bfc31144e53685f35f28b1aad3cd50ce04]
# to [42b1d1030834708eee41780505cfc928bd1797dd]
#
# patch "README"
# from [638e4b603a293becb02cac11438485debdb5129c]
# to [81bf4c13463672de8644a1b7843643bc0e89cc92]
#
# patch "VERSION"
# from [1903abc97153c3cd4053ae3d24d3a7209e495811]
# to [32d528ac99586f2cd7ce508073d3c725ab60d495]
#
# patch "mtn_texml_to_wiki.xslt"
# from [ef51a926fa1776a63452bac70bf104b23e02a03c]
# to [d9bb39d135a626952c77b340324fdd67b45a0f5c]
#
============================================================
--- TODO 7029fd573d318009b1c4862c4976cfab90be992f
+++ TODO 7029fd573d318009b1c4862c4976cfab90be992f
@@ -0,0 +1,6 @@
+- Include licensing information, details to be resolved on IRC or mailing list
+- Clarify if MDWN files should include some common settings, maybe a "documentation" tag or something
+- Documentation in XML format and "toolchain" template for conversion to plain text and HTML
+- Specification of the basic layout of a plain output converter stylesheet, in case someone wants to write his/her own
+- Change XSLT variables to parameters (for override them per command line, if needed) and document them
+- Error checking on the input parameters
\ No newline at end of file
============================================================
--- converter_html.xslt 5190194e2a445177d3a35cdd7fbf3148b3cb2fcd
+++ converter_html.xslt 5190194e2a445177d3a35cdd7fbf3148b3cb2fcd
@@ -0,0 +1,37 @@
+
+
+
+
+
+
+ .html
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
============================================================
--- converter_mdwn.xslt 1c281777a4b2122a1ea85efb669eda5675b6f8c5
+++ converter_mdwn.xslt 1c281777a4b2122a1ea85efb669eda5675b6f8c5
@@ -0,0 +1,36 @@
+
+
+
+
+
+
+ .mdwn
+
+
+ [[tag original-documentation]]
+
+
+
+
+
+
+
+
+ #
+
+
+
+
+
+
+
+
+
+ [[[]]]
+
+
\ No newline at end of file
============================================================
--- CHANGELOG 431b17bfc31144e53685f35f28b1aad3cd50ce04
+++ CHANGELOG 42b1d1030834708eee41780505cfc928bd1797dd
@@ -1,3 +1,10 @@
+2009-02-25:
+
+- Several "output filter" template files, for allowing different target formats, which include the central converter stylesheet for basic functionality
+- First work on the MDWN and HTML converter stylesheets; these are just test files for showing the possibility of different output formats; many work has to be done to get them complete
+- Small adaptions on the Readme and Todo files
+
+
2009-02-15:
- Added basic documentation and readme
============================================================
--- README 638e4b603a293becb02cac11438485debdb5129c
+++ README 81bf4c13463672de8644a1b7843643bc0e89cc92
@@ -5,7 +5,7 @@
--------------------------------------------------------------------------------
Author: Philipp Groeschler
Mailto: address@hidden
- Last change: 2009-02-15
+ Last change: 2009-02-25
--------------------------------------------------------------------------------
PURPOSE & INTRODUCTION
@@ -27,10 +27,10 @@
directories and documents in a desired target format.
Currently available formats are MDWN (ikiwiki) and HTML. The latter one is for
-testing purposes only and its output filter will possibly never be finished. As
-the structure of the XSLT allows for pluggable output filters, each one could
-create his own filter as desired, without the need to touch the others filters
-or the basic template.
+testing purposes only and its output converter will possibly never be finished.
+As the structure of the XSLT allows inclusion and separation of stylesheets,
+each one could create his own format converter as desired, without the need to
+touch the other converters or the basic template.
USING THE CONVERTER
@@ -56,33 +56,36 @@
Second step: Generate document tree
Still using Saxon as example, type in
-$ java -jar saxon9.jar -xsl:mtn_texml_to_wiki.xslt monotone.xml
+$ java -jar saxon9.jar -xsl:converter_mdwn.xslt -s:monotone.xml
Any other XSLT processor should just get "monotone.xml" as input file and
-"mtn_texml_to_wiki.xslt" as template file. The converter then should do its
-work using default settings, like:
+"converter_mdwn.xslt" as template file. You can choose any other output
+converter stylesheet which is either delivered in the package or created by
+yourself.
-- output directory is set to ./wikifiles
-- output format is MDWN
+ The converter then should do its work using default settings with the output
+directory set to "./wikifiles". A later version should make it possible for you
+to override this destination at the command line when calling the processor.
-The output destination directory will be created if non existant, files will be
-overwritten silently on repetition of calling the converter.
+The output destination directory will be created if it does not exist, files
+will be overwritten silently on repetition of calls to the converter. Please
+notice that this behaviour could change when using a different XSLT processor.
BUGS AND ANNOTATIONS
The project has not even near production quality at the time of this writing.
-Future development should include at least one completely working filter plugin
-and also some sort of shell script to save you from typing in all commands at
-your shell. At least this latter issue could be a tricky one, as it is not
-intended to include a full XSLT processor and each one has a different manner
-of usage and calling parameters.
+Future development should include at least one completely working converter
+plugin and also some sort of shell script to save you from typing in all the
+commands at your console. At least this latter issue could be a tricky one, as
+it is not intended to include a full XSLT processor and each one has a
+different manner of usage and calling parameters.
Maybe this converter will be included into the distribution at some time, but
that is not my decision. Its purpose is definitely not aimed to the end user
but to help the people which maintain the release or rather the documentation.
The future use and direction of this project are therefore to be discussed by
-people in charge.
+the people in charge.
--------------------------------------------------------------------------------
\ No newline at end of file
============================================================
--- VERSION 1903abc97153c3cd4053ae3d24d3a7209e495811
+++ VERSION 32d528ac99586f2cd7ce508073d3c725ab60d495
@@ -1,2 +1,2 @@
-Current version: 2009-02-15
+Current version: 2009-02-25
Status: Testing and still basic development
\ No newline at end of file
============================================================
--- mtn_texml_to_wiki.xslt ef51a926fa1776a63452bac70bf104b23e02a03c
+++ mtn_texml_to_wiki.xslt d9bb39d135a626952c77b340324fdd67b45a0f5c
@@ -1,15 +1,24 @@
+
+
+
-
-
-
-
-
+ wikifiles
+
+
+
+
@@ -27,9 +36,8 @@
-
-
-
+
+
@@ -51,9 +59,9 @@
-
-
-
+
+
+
@@ -63,7 +71,7 @@
-
+
-
+
-
+
@@ -119,4 +127,15 @@
-
+
+
+
+
+
+
+
+
+
\ No newline at end of file