Skip to content

Latest commit

 

History

History
9 lines (7 loc) · 737 Bytes

README.restructured-text.md

File metadata and controls

9 lines (7 loc) · 737 Bytes

About

This system adds support for ReStructuredText syntax in both documents and docstrings. When this system is loaded, Staple will automatically scan for documents with the ending rst to use as primary documents on inferred pages. It also adds the source-compiler :restructured-text that can be used to markup documentation source.

To use ReStructuredText for docstrings as well, use a customisation like this on your page type:

(defmethod staple:format-documentation ((docstring string) (page my-page))
  (let ((*package* (first (staple:packages page))))
    (staple:markup-code-snippets-ignoring-errors
     (staple:compile-source docstring :restructured-text))))