diff options
| author | Stefan Sauer <ensonic@users.sf.net> | 2018-05-13 14:23:40 +0200 |
|---|---|---|
| committer | Stefan Sauer <ensonic@users.sf.net> | 2018-05-13 14:23:40 +0200 |
| commit | 5ec9dd24b03e22fe47c19fabf625ca5beb15d7f1 (patch) | |
| tree | 2a52e912f5f4d5eedc5047ffb1d20de9d8c9b5a2 | |
| parent | a078d5009813e0a1b81b022370c0c10b2a7be538 (diff) | |
| download | gtk-doc-5ec9dd24b03e22fe47c19fabf625ca5beb15d7f1.tar.gz | |
mkhtml2: tag converter for 'figure' and 'graphics'
| -rw-r--r-- | gtkdoc/mkhtml2.py | 26 |
1 files changed, 26 insertions, 0 deletions
diff --git a/gtkdoc/mkhtml2.py b/gtkdoc/mkhtml2.py index a524dbd..e9b1590 100644 --- a/gtkdoc/mkhtml2.py +++ b/gtkdoc/mkhtml2.py @@ -40,6 +40,7 @@ TODO: 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 'glossentry' we're only handling 'glossterm' and 'glossdef' + - convert_{figure,table} need counters. - check each docbook tag if it can contain #PCDATA, if not don't check for xml.text/xml.tail and add a comment (# no PCDATA allowed here) - consider some perf-warnings flag @@ -572,6 +573,21 @@ def convert_entry(ctx, xml): return result +def convert_figure(ctx, xml): + result = ['<div class="figure">\n'] + append_idref(xml.attrib, result) + title_tag = xml.find('title') + if title_tag is not None: + # TODO(ensonic): Add a 'Figure X. ' prefix, needs a figure counter + result.append('<p><b>%s</b></p>' % ''.join(convert_title(ctx, title_tag))) + result.append('<div class="figure-contents">') + # TODO(ensonic): title can become alt on inner 'graphic' element + convert_inner(ctx, xml, result) + result.append('</div></div><br class="figure-break"/>') + append_text(ctx, xml.tail, result) + return result + + def convert_footnote(ctx, xml): footnotes = ctx.get('footnotes', []) # footnotes idx is not per page, but per doc @@ -656,6 +672,14 @@ def convert_glossterm(ctx, xml): ] +def convert_graphic(ctx, xml): + # TODO(ensonic): warn on missing fileref attr? + fileref = xml.attrib.get('fileref', '') + if fileref: + assets.add(fileref) + return ['<div><img src="%s"></div>' % fileref] + + def convert_indexdiv(ctx, xml): title_tag = xml.find('title') title = title_tag.text @@ -1092,6 +1116,7 @@ convert_tags = { 'entry': convert_entry, 'envar': convert_code, 'footnote': convert_footnote, + 'figure': convert_figure, 'filename': convert_code, 'firstterm': convert_em, 'formalpara': convert_formalpara, @@ -1100,6 +1125,7 @@ convert_tags = { 'glossdiv': convert_glossdiv, 'glossentry': convert_glossentry, 'glossterm': convert_glossterm, + 'graphic': convert_graphic, 'indexdiv': convert_indexdiv, 'indexentry': convert_ignore, 'indexterm': convert_skip, |