From afa467e975617c9c343b2a993b794c5c47ff98d9 Mon Sep 17 00:00:00 2001 From: Jan-Piet Mens Date: Wed, 24 Oct 2012 19:42:52 +0200 Subject: [PATCH] DOCUMENTATION: LaTeX template is back ongoing work for the Booklet --- hacking/module_formatter.py | 4 +- hacking/templates/latex.j2 | 76 +++++++++++++++++++++++++++++++++++++ 2 files changed, 78 insertions(+), 2 deletions(-) create mode 100644 hacking/templates/latex.j2 diff --git a/hacking/module_formatter.py b/hacking/module_formatter.py index 8653d994a88..7e8894830c3 100755 --- a/hacking/module_formatter.py +++ b/hacking/module_formatter.py @@ -259,8 +259,8 @@ def main(): env.filters['jpfunc'] = latex_ify template = env.get_template('latex.j2') outputname = "%s.tex" - includecmt = "% generated code\n" - includefmt = "\\input %s\n" + includecmt = "" + includefmt = "%s\n" if options.type == 'html': env.filters['jpfunc'] = html_ify template = env.get_template('html.j2') diff --git a/hacking/templates/latex.j2 b/hacking/templates/latex.j2 new file mode 100644 index 00000000000..d02ffa8677f --- /dev/null +++ b/hacking/templates/latex.j2 @@ -0,0 +1,76 @@ +{# ------------------------------------------------------------------- + template for module_formatter.py for LaTeX output (Ansible Booklet) + by Jan-Piet Mens. + Note: nodes & code examples are omitted on purpose. + -------------------------------------------------------------------- #} +%--- @{ module | upper }@ ---- from @{ filename }@ --- + +%: -- module header +\mods{@{module}@}{@{docuri}@}{ + {% for desc in description -%} + @{ desc | jpfunc }@ + {% endfor -%} + {% if version_added is defined -%} + (\I{* new in version @{ version_added }@}) + {% endif -%} + } + +%: -- module options + + + +{% if options %} +\begin{xlist}{abcdefghijklmno} + {% for (opt,v) in options.iteritems() %} + {% if v['required'] %} + \item[\man\,\C{@{ opt }@}] + {% else %} + \item[\opt\,\C{@{ opt }@}] + {% endif %} + + {# -------- option description ----------#} + {% for desc in v.description %} + @{ desc | jpfunc }@ + {% endfor %} + {% if v['choices'] %} + \B{Choices}:\, + {% for choice in v['choices'] %}\C{@{ choice }@}{% if not loop.last %},{% else %}.{% endif %} + {% endfor %} + {% endif %} + {% if v['default'] %} + (default \C{@{ v['default'] }@}) + {% endif %} + {% if v['version_added'] is defined %} + (\I{* version @{ v['version_added'] }@}) + {% endif %} + {% endfor %} +\end{xlist} +{% endif %} + +{# --------------------------------------- +{% if notes %} + + {% for note in notes %} + \I{@{ note | jpfunc }@} + {% endfor %} +{% endif %} + ----------------------------- #} + +{#------------------------------------------- + +{% if examples is defined -%} + {% for e in examples %} + \begin{extymeta} +@{ e['code'] }@ + \end{extymeta} + {% endfor %} +{% endif %} +----------------------------------- #} + +{% if extradata is defined %} +%--- BEGIN-EXTRADATA +\begin{extymeta} +@{ extradata }@ +\end{extymeta} +%----- END-EXTRADATA +{% endif %}