Special syntax in user help files¶
- As help files are just django fixture files
- all of the caveats there apply, with a few small conventions applied on top.
- For consistancy and readability, its encouraged to keep one help fixture per file.
- The body of the help file can be HTML, and this will be displayed to the user unchanged. It is up to documenters to ensure that help files are valid HTML that won’t break layout.
A few additional
Below is an example help file:
- model: aristotle_mdr_help.helppage
fields:
title: Advanced Search
language: en
body: >
<h2>Restricting search with the advanced search options</h2>
<p>
The <a href="/search/">search page</a> provides a form that gives
users control to filter and sort search results.</p>
<p>
<img src="{static}/aristotle_mdr/search_filters.png">
When searching, the "indexed text" refers to everything crawled by the search engine.