Tips & FAQ

Tips index

• FAQ
  • Q: Why can’t I move articles?
  • Q: Why do I keep getting “This slug conflicts with an existing URL.”
• Disqus comment embed
• Mediawiki
  • Usage
  • Further work and customizing

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