Skip to content
  • Peter Krempa's avatar
    xsl tooling for format*->rst conversion · 3d7e2394
    Peter Krempa authored
    This patch along with following steps were used to convert
    formatdomain.html.in to rst.
    
    The change from h1 to h2 is so that there's one less level of nesting as
    pandoc used spaces for underbars of h6. The output also looks better
    this way.
    
    The heading is restored by adding an overbar manually.
    
    1) Apply patch to tweak xslt rules
    
    2) cd docs
    
    3) xsltproc --stringparam pagename formatdomain.html --stringparam pagesrc formatdomain.html.in --stringparam timestamp asdf --nonet site.xsl  formatdomain.html.in > ble.xml
    
    4) pandoc --from html --to rst --toc --columns 80 --standalone ble.xml -o formatdomain.rst
    
    5) sed -i -e 's/@/`/g' -e 's/\(.*\)$/`<a id="\1"\/>`/g' -e '/^ \+$/d' formatdomain.rst
    (look out for files containing @)
    
    6) Tweak header:
    
    Add:
    .. role:: since
    .. role:: anchor(raw)
       :format: html
    
    Move and fix ToC specification.
    
    Add overbar on top headline.
    
    7) manually add newline before table overbar (pandoc doesn't do that and
       docutils then don't recognize the table)
    
    8) rm formatdomain.html.in
    3d7e2394