Merge pull request #3220 from dsedivec/devel

Improve Markdown (and other) module doc output
This commit is contained in:
Michael DeHaan 2013-06-16 19:50:48 -07:00
commit af9b510769
2 changed files with 16 additions and 4 deletions

View file

@ -30,6 +30,7 @@ import optparse
import time
import datetime
import subprocess
import cgi
import ansible.utils
import ansible.utils.module_docs as module_docs
@ -62,11 +63,13 @@ def latex_ify(text):
def html_ify(text):
t = _ITALIC.sub("<em>" + r"\1" + "</em>", text)
t = cgi.escape(text)
t = _ITALIC.sub("<em>" + r"\1" + "</em>", t)
t = _BOLD.sub("<b>" + r"\1" + "</b>", t)
t = _MODULE.sub("<span class='module'>" + r"\1" + "</span>", t)
t = _URL.sub("<a href='" + r"\1" + "'>" + r"\1" + "</a>", t)
t = _CONST.sub("<code>" + r"\1" + "</code>", t)
return t
def json_ify(text):
@ -105,9 +108,13 @@ def rst_ify(text):
return t
_MARKDOWN = re.compile(r"[*_`]")
def markdown_ify(text):
t = _ITALIC.sub("_" + r"\1" + "_", text)
t = cgi.escape(text)
t = _MARKDOWN.sub(r"\\\g<0>", t)
t = _ITALIC.sub("_" + r"\1" + "_", t)
t = _BOLD.sub("**" + r"\1" + "**", t)
t = _MODULE.sub("*" + r"\1" + "*", t)
t = _URL.sub("[" + r"\1" + "](" + r"\1" + ")", t)

View file

@ -1,4 +1,4 @@
## @{ module }@
## @{ module | jpfunc }@
{# ------------------------------------------
#
@ -12,6 +12,7 @@ New in version @{ version_added }@.
{% for desc in description -%}
@{ desc | jpfunc }@
{% endfor %}
{% if options -%}
@ -35,6 +36,10 @@ New in version @{ version_added }@.
</table>
{% endif %}
{% if examples or plainexamples %}
#### Examples
{% endif %}
{% for example in examples %}
{% if example['description'] %}
* @{ example['description'] | jpfunc }@