[gtk-doc] mkhtml2: planning update
- From: Stefan Sauer <stefkost src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtk-doc] mkhtml2: planning update
- Date: Fri, 11 May 2018 16:16:14 +0000 (UTC)
commit c6cdfb16cfaf1bd687317d8b00668437d24564a0
Author: Stefan Sauer <ensonic users sf net>
Date: Fri May 11 07:53:37 2018 +0200
mkhtml2: planning update
gtkdoc/mkhtml2.py | 11 ++++++++---
1 files changed, 8 insertions(+), 3 deletions(-)
---
diff --git a/gtkdoc/mkhtml2.py b/gtkdoc/mkhtml2.py
index e622b0b..736d2ea 100644
--- a/gtkdoc/mkhtml2.py
+++ b/gtkdoc/mkhtml2.py
@@ -37,7 +37,7 @@ simplicity.
TODO:
- tag converters:
- 'section'/'simplesect' - the first we convert as a chunk, the nested ones we
- need to convert as 'sect{2,3,4,...}
+ need to convert as 'sect{2,3,4,...}, we can track depth in 'ctx'
- inside 'footnote' one can have many tags, we only handle 'para'/'simpara'
- inside 'inlinemediaobject'/'mediaobject' a 'textobject' becomes the 'alt'
attr on the <img> tag of the 'imageobject'
@@ -48,12 +48,17 @@ TODO:
- find a better way to print context for warnings
- we use 'xml.sourceline', but this all does not help a lot due to xi:include
- copy images
- - do we need to find them on the respective tags and search them in the path
- setup by '--path'
+ - do we need to find them on the respective tags (inlinegraphic, imageobject)
+ and search them in the path setup by '--path'
- commandline options
- mkhtml:
--path 'Extra source directories' - used to find images
- fixxref:
+- consolidate title handling:
+ - always use the titles-dict
+ - there only store what we have (xml, tag, ...)
+ - when chunking generate 'id's and add entries to titles-dict
+ - add accessors for title and raw_title that lazily get them
DIFFERENCES:
- titles
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]