39 lines
1.1 KiB
ReStructuredText
39 lines
1.1 KiB
ReStructuredText
Tips & FAQ
|
|
==========
|
|
|
|
.. toctree::
|
|
:caption: Tips index
|
|
|
|
faq
|
|
disqus
|
|
mediawiki
|
|
|
|
Quick tips
|
|
----------
|
|
|
|
1. **Account handling:** There are simple views that handle login,
|
|
logout and signup. They are on by default. Make sure to set
|
|
``settings.LOGIN_URL`` to point to your login page as many wiki views
|
|
may redirect to a login page.
|
|
|
|
2. **Syntax highlighting:** Python-Markdown has a pre-shipped codehilite
|
|
extension which works perfectly, so add something like::
|
|
|
|
WIKI_MARKDOWN_KWARGS = {
|
|
'extensions': [
|
|
'footnotes',
|
|
'attr_list',
|
|
'headerid',
|
|
'extra',
|
|
'codehilite',
|
|
]
|
|
}
|
|
|
|
to your settings. Currently, django-wiki ships with a stylesheet
|
|
that already has the syntax highlighting CSS rules built-in. Oh, and
|
|
you need to ensure ``pip install pygments`` because Pygments is what
|
|
the codehilite extension is using!
|
|
|
|
3. **Project Templates:** Create new django-wiki projects quickly and easily using django-wiki project templates
|
|
https://github.com/django-wiki/django-wiki-project-template
|