s5:regiowiki
Table of Contents
DokuWiki
An Introduction
(with a slight focus on RegioWikis)
by Andreas Gohr
CosmoCode GmbH
http://www.cosmocode.de · gohr [at] cosmocode [dot] de
Agenda
- About me
- What are typical RegioWiki requirements?
- What is DokuWiki and can it fulfill these requirements?
- What plugins might be especially useful for RegioWikis?
- Your questions answered.
About me
- Andreas Gohr gohr [at] cosmocode [dot] de
- DokuWiki creator and lead developer
- CosmoCode GmbH
- IT Service Provider based in Berlin
- Focused on CMS, Wikis and Custom Solutions
- Consulting and Support for Wikis (esp. DokuWiki)
- Makers of www.wikimatrix.org Wiki comparison portal
RegioWiki requirements
(I'm just guessing these, correct me if I'm wrong)
- Small target group
- usually just a few thousand people
- Even smaller group of people involved as editors
- Editors might not be technically versatile
- Users might not be comfortable with English speaking software
- Low to no funding
DokuWiki
- PHP based
- Free and Open Source (GPL Version 2)
- Created in 2004
- Originally focused on documentation (hence the name)
- Quite popular today (in the top 5 league)
Low Requirements
- no external requirements
- does not need a database
- runs everywhere where PHP runs
- a $5 hoster usually works just fine
- there are even free PHP hosters nowadays
- for the French: free.fr sucks
Wait! No Database?
- All page data is saved in .txt files
- Filesystems optimize read/write by memory caching → fast!
- Easy Backup → just copy or zip the folder
- Easy Migration → copy to new server, set file permissions, done.
- Accessible → data can be read and written outside the wiki (for the pros: scripting!)
- Final page HTML is stored in cache files
- Word based fulltext index for fast search even in large wikis
Ease of Use
- Easy, intuitive syntax that is readable!
- Extensive formatting toolbar for most common syntax
- Keyboard shortcuts
- We're permanently improving
- Intelligent context sensitive editor
- Keep list indentions
- List indentions with a single key
- Relative headline level insertions
- Link Wizard
Completely Localized
- The whole interface is translatable
- Comes with translations for more than 40 languages
- UTF-8 everywhere and Support for Right-to-Left languages
- Optional page name transliteration for Russian, Korean, Japanese, …
- Your language missing? → http://translate.dokuwiki.org
Content Organization
- Namespaces allow hierarchical content organization
- Group pages (and media files) to the same topic in their own namespace
- Examples:
- a namespace for each district in your city
- namespaces for different topics (eg. governance, culture, sports, sightseeing)
- Namespaces can be used with access restriction
Access Controls
- DokuWiki supports users and groups
- can use different auth backends
- Example: reuse the logins from your forum
- Access Control Lists (ACL)
- groups and users
- pages and namespaces
- read, write, create, upload, delete
Media Support
- Upload images, documents to a central repository
- Use media files in any page
- Organize in namespaces
- Insert with a single click
- Image resizing support
Templates aka. Skins
- DokuWiki can be styled through templates
- Similar to how Wordpress themes work
- http://www.dokuwiki.org/template has a lot of ready made ones
- WikiPedia look and feel is possible
Plugins
- DokuWiki itself is relatively basic
- Focuses on the core wiki functionality
- Nearly everything beyond can be done through plugins
- More than 500 plugins available at http://www.dokuwiki.org/plugins
- Plugins can be dowloaded and installed with built in plugin manager
- A few that might be interesting for RegioWikis:
Plugin: Gallery
- Display all images uploaded to a namespace as a nice gallery
- Creates thumbnails, reads image titles and dates from EXIF
- Can use Lightbox JavaScript
- Can also load images from a Media RSS feed (eg. from Flickr)
Plugin: VShare
- Adds simple syntax to embed videos from popular video sharing sites
- About 30 sites supported, including Youtube, Vimeo, Dailymotion, …
- New sites can easily be added through a config file
Plugin: Google Maps
- Embed a Google map in any page
- Lets you set points of interest in the syntax
Plugin: OSM
- Similar to the Google Maps plugin
- Uses the free and open service Open Street Maps
Plugin: CSV
- Display data from an uploaded CSV file (eg. exported from Excel)
- Useful for publishing official numbers
Plugin: Wrap
- Add boxes with various styles to your wiki
- information, hint, warning
- Create multiple columns
- Or add your own styles
RegioWikis using DokuWiki
- Pekela (Netherlands) http://www.wikipekela.nl
- Beauvais (France) http://urbibus.org/beauvais/
- Eckelsdorf (Germany) http://www.eckelsheim.de/
- Sechtem (Germany) http://www.sechtem-wiki.de
- Wunstorf (Germany) http://www.wiki-wunstorf.de/
- Speichersdorf (Germany) http://www.projekt297.de.vu/
- Planebruch (Germany) http://planebruch.de/
- Your town soon?
More Info
- Main site: http://www.dokuwiki.org
- many translations already
- Forums: http://forum.dokuwiki.org
- sub forums for German, French, Chinese and Arabic speaking users
- IRC: #dokuwiki at freenode.net
- Ask me for a Leaflet in English or German
Questions?
Thanks!
Thank you very much
- Stickers and leaflets here
s5/regiowiki.txt · Last modified: 2009/09/26 07:16 by andi