/wiki/templatetags/restructuredtext.py

http://django-wikiapp.googlecode.com/ · Python · 106 lines · 100 code · 4 blank · 2 comment · 5 complexity · ff1645f3c55d35f21189b3e54f67d72c MD5 · raw file 

    

  1. from django import template

    2. 

  2. from django.conf import settings

    3. 

  3. 

    4. 

  4. register = template.Library()

    5. 

  5. 

    6. 

  6. @register.filter

    7. 

  7. def flatpagehist_diff_previous(self):

    8. 

  8.     return self.diff_previous()

    9. 

  9. 

    10. 

  10. @register.filter

    11. 

  11. def restructuredparts(value, **overrides):

    12. 

  12.     """return the restructured text parts"""

    13. 

  13.     try:

    14. 

  14.         from docutils.core import publish_parts

    15. 

  15.     except ImportError:

    16. 

  16.         if settings.DEBUG:

    17. 

  17.             raise template.TemplateSyntaxError, "Error in {% restructuredtext %} filter: The Python docutils library isn't installed."

    18. 

  18.         return value

    19. 

  19.     else:

    20. 

  20.         docutils_settings = dict(getattr(settings, "RESTRUCTUREDTEXT_FILTER_SETTINGS", {}))

    21. 

  21.         docutils_settings.update(overrides)

    22. 

  22.         if 'halt_level' not in docutils_settings:

    23. 

  23.             docutils_settings['halt_level'] = 6

    24. 

  24.         return publish_parts(source=value, writer_name="html4css1", settings_overrides=docutils_settings)

    25. 

  25. 

    26. 

  26. @register.filter

    27. 

  27. def restructuredtext(value, **overrides):

    28. 

  28.     """The django version of this markup filter has an issue when only one title or subtitle is supplied in that

    29. 

  29.     they are dropped from the markup. This is due to the use of 'fragment' instead of something like 'html_body'.

    30. 

  30.     We do not want to use 'html_body' either due to some header/footer stuff we want to prevent, but we want to

    31. 

  31.     keep the title and subtitle. So we include them if present."""

    32. 

  32.     parts = restructuredparts(value, **overrides)

    33. 

  33.     if not isinstance(parts, dict):

    34. 

  34.         return value

    35. 

  35.     return parts["html_body"]

    36. 

  36. 

    37. 

  37. @register.filter

    38. 

  38. def restructuredtext_has_errors(value, do_raise=False):

    39. 

  39.     ## RED_FLAG: need to catch the explicit exceptions and not a catch all...

    40. 

  40.     try:

    41. 

  41.         restructuredparts(value, halt_level=2, traceback=1)

    42. 

  42.         return False

    43. 

  43.     except:

    44. 

  44.         if do_raise:

    45. 

  45.             raise

    46. 

  46.     return True

    47. 

  47. 

    48. 

  48. class ReStructuredTextNode(template.Node):

    49. 

  49.     def __init__(self, nodelist):

    50. 

  50.         self.nodelist = nodelist

    51. 

  51. 

    52. 

  52.     def render(self, context):

    53. 

  53.         return restructuredtext(self.nodelist.render(context))

    54. 

  54. 

    55. 

  55. @register.tag("restructuredtext")

    56. 

  56. def rest_tag(parser, token):

    57. 

  57.     """

    58. 

  58.     Render the ReStructuredText into html. Will pre-render template code first.

    59. 

  59. 

    60. 

  60.     Example:

    61. 

  61.     ::

    62. 

  62. 

    63. 

  63.         {% restructuredtext %}

    64. 

  64.             ===================================

    65. 

  65.             To: {{ send_to }}

    66. 

  66.             ===================================

    67. 

  67.             {% include "email_form.rst" %}

    68. 

  68.         {% endrestructuredtext %}

    69. 

  69. 

    70. 

  70.     """

    71. 

  71.     nodelist = parser.parse(('endrestructuredtext',))

    72. 

  72.     parser.delete_first_token()

    73. 

  73.     return ReStructuredTextNode(nodelist)

    74. 

  74. 

    75. 

  75. @register.inclusion_tag("restructuredtext/dynamic.html", takes_context=True)

    76. 

  76. def rstflatpage(context):

    77. 

  77.     """

    78. 

  78.     The core content of the restructuredtext flatpage with history, editing,

    79. 

  79.     etc. for use in your 'flatpages/default.html' or custom template.

    80. 

  80. 

    81. 

  81.     Example:

    82. 

  82.     ::

    83. 

  83. 

    84. 

  84.         <html><head><title>{{ flatpage.title }}</title></head>

    85. 

  85.               <body>{% load restructuredtext %}{% rstflatpage %}</body>

    86. 

  86.         </html>

    87. 

  87. 

    88. 

  88. 

    89. 

  89.     This will inject one of 6 different page contents:

    90. 

  90. 

    91. 

  91.     * Just the flatpage.content for normal flatpages (so templates can be

    92. 

  92.       used with normal flatpages).

    93. 

  93.     * A custom 404 page (with optional create/restore form).

    94. 

  94.     * View current (with optional edit/history/delete form).

    95. 

  95.     * View version (with optional history/current/revert form).

    96. 

  96.     * Edit form (with preview/save/cancel).

    97. 

  97.     * History listing.

    98. 

  98.     """

    99. 

  99.     return context

    100. 

  100. 

    101. 

  101. @register.inclusion_tag("restructuredtext/feeds.html", takes_context=True)

    102. 

  102. def rstflatpage_feeds(context):

    103. 

  103.     """

    104. 

  104.     Optionally inserts the history feeds

    105. 

  105.     """

    106. 

  106.     return context
    107.