summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorStefan Sauer <ensonic@users.sf.net>2017-11-08 20:37:42 +0100
committerStefan Sauer <ensonic@users.sf.net>2017-11-08 20:58:28 +0100
commitdc8018a0a5940b387c21277a1068e8f86e5429f9 (patch)
tree81bf73b7aa387e36c11af924801b3a26a7a37d09 /doc
parent183414ce8b3a95c77f10e261894745a62caa9b79 (diff)
downloadgtk-doc-dc8018a0a5940b387c21277a1068e8f86e5429f9.tar.gz
design: more planning updates
Add some commandline experiements.
Diffstat (limited to 'doc')
-rw-r--r--doc/design-2.x.txt17
1 files changed, 16 insertions, 1 deletions
diff --git a/doc/design-2.x.txt b/doc/design-2.x.txt
index c4fd7c2..c413131 100644
--- a/doc/design-2.x.txt
+++ b/doc/design-2.x.txt
@@ -111,4 +111,19 @@ options for gtkdocize. Create a stub gtkdoc-mkhtml2 tool.
4.) [unassigned] write gtkdoc/mkhtml2.py
- create templates from the current html for the various page types (refentry,
- index, ...). \ No newline at end of file
+ index, ...).
+- we won't need content_files and expand_content_files in Makefile.am, mkhtml2
+ would read $(DOC_MODULE)-docs.md (rename to index.md?) and find local links
+ from it
+- convert all hand-written md files starting from the main-doc to html
+
+Open Issues:
+wkhtmltopdf html/*.html tester2.pdf
+Error: This version of wkhtmltopdf is build against an unpatched version of QT, and does not support more then one input document.
+
+pandoc -r docbook -w markdown_github -o tester-docs.md tester-docs.xml
+- pandoc has no xi:include support
+- if we pipe it through xmllint we convert everything.
+xmllint --noent --xinclude tester-docs.xml | pandoc -r docbook -w markdown -o tester-docs.md
+- the index.md would need to represent the structure the docbook chunker would
+ create \ No newline at end of file