initial

docs/tips/index.rst

@@ -0,0 +1,38 @@
+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