Copy
Email not displaying correctly? View it in your browser.
Hello <<First Name>>,

welcome to the DokuWiki Newsletter. In this issue we present:



Enjoy your reading,

DokuWiki Newsletter team


Anteater Released

Two weeks ago the new stable DokuWiki called Anteater was released. Changes include an improved quick search algorithm, improved email subscriptions, permalinks for diff views, prefilled section names in summary when editing a section and configurable filename encoding among a lot of other enhancements and bug fixes.

Some changes affect plugins and templates. For example parameters can be passed in internal links now (useful for plugins). Template authors need to check if they implement the correct subscription button, only tpl_button('subscribe') should be used. There is also support for custom section editors, now used by the table editor plugin and latest version of data plugin.

According to the new release plan with more frequent releases, the next one will be ready in April. But don't wait until then, get yourself and your users a better wiki experience with the several IE7, IE8 and Chrome fixes available in Anteater today!

Recent Development Activity

Last weekend DokuWiki developers got together in Berlin to work on an improved metadata system and continue with the new default template. Investigations on how to refactor the indexer has also begun, aiming for a cleaner code that could be easier replaced by other indexers like Xapian or Lucene.

Featured Plugin: Filelist and Medialist

DokuWiki is an excellent tool to create documentation systems, and its plugins and features make it easy to catalogue tools, media, code snippets, and changelogs. However there comes a time when your project needs to release files to the outside world: code, photographies or other media. You may want to automate the process somewhat so you won't have to edit pages and update all links every time you release.

This is where plugins such as filelist and medialist come into play. Both plugins, as their name would indicate, present a list of files. If you know the pagelist, these work pretty much the same. When their syntax is used in a page, they compile a list of files matching a certain criteria and present it to the user in a nicely formatted way, with links. All of this can of course be configured either via the Configuration Manager, or via explicit options added to the plugin syntax.

Let's review a standard use case: present downloads for our site's collection of plugins for DokuWiki (hey, DokuWiki plugins are be both easy and fun to develop!). The downloads are available in the '':projects:dokuwiki'' namespace so we invoke the medialist plugin as follows:

===Downloads===
{{medialist>:projects:dokuwiki:}}


medialist example

If we were to use the medialist syntax in a lot of places, or invoke it via a template, the plugin helps us too by supporting some standard DokuWiki macros:

{{medialist>@PAGE@}}       <-- for an individual page
{{medialist>@NAMESPACE@}}  <-- for our entire namespace


The filelist plugin is similar but overall more powerful. It can compile a list of files into a DokuWiki list or table, present us with information about the file size, age or type, present each file name with an alias, and more importantly, compile a file list from a directory outside of our current DokuWiki installation. All that it requires is that there is a filesystem path to access those files, and a corresponding web space where we can find them.

For an example, let's see what happens when we want to document the DokuWiki screenshots available on our server. First, we must tell DokuWiki, via the Configuration Manager, that there is a correspondence between the server's filesystem space and the webserver paths, by adding paired entries in the "filesystem" box (eg.: ''/var/images/dokuwiki/'') and "web path" box (eg.: ''http://myserver.com/files/dokuwiki/'').

Once those configurations are saved, we can invoke the adequate filelist syntax:

{{filelist>/var/images/dokuwiki/*&style=list}}



These plugins are fairly useful and can improve the usability of your wiki's archives and releases in several ways, in particular when combined with other plugins that handle media and data. For a special example, here is what a compiled filelist will look like with help of the dlcount plugin for statistics:




The Release Team

In an attempt to increase DokuWiki’s bus factor, Andi recently initiated the founding of teams. One of the core teams is the release management team – we are responsible for turning a great project into an even better release.

For the current release Anteater, we managed open tickets, kept track of the current codebase status and finally built the release candidates and the release. A newly written release plan will help us creating even better releases in the future. The most evident change is the time-based schedule DokuWiki now follows: Every April and October, there will be a new release.

If you'd like to help making DokuWiki better, why not join a team yourself?

ICKEWiki released

ICKEwikiBerlin-based company CosmoCode recently released ICKEWiki, a system based on DokuWiki which focuses on the use in the manufacturing industry. It bundles free form wiki editing with wizard-driven content creation and structured data (like customers, products, processes) into a well connected system.

Since ICKEWiki is fully compatible with DokuWiki, all the 15 plugins that were written for it – highlights include a table editor, a task manager and a favorites list – can also be used in a common DokuWiki install.

Tips & Tricks: Public Wiki With Member Only Pages

Setting up a wiki with public main page(s) but other parts requiring login is not difficult, just remember to handle your images and other media files correctly. The trick is DokuWiki ACL only controls media namespaces, not individual files. Create a special namespace for public media to protect your other content, ACL manager should look like:

ACL manager

Now both the page start as well as the namespace public is readable by all. Place public images and other media files and any other public wiki pages into the public namespace. Once logged in, users belong to the @user group and can edit all wiki pages except the start page and public namespace content. Read more about Access Control Lists in the DokuWiki manual.

DokuWiki on USB
An Anteater release of DokuWiki on a Stick is made available by DokuWiki user str. This preconfigured DokuWiki installation with a stripped down Apache webserver allows you to run DokuWiki from a portable device like an USB stick on any Windows computer without installing anything on the computer itself.

Russian Community
The Russian community has expanded the DokuWiki universe with it's own www.dokuwiki.ru. There's also a lot of activity in the russian user forum and translated namespace of dokuwiki.org. By the way, have you noticed that user interface translation now follows the namespace at dokuwiki.org?

One Click Upgrade
Andreas Gohr has released a DokuWiki upgrade plugin and you can help out with testing in different environments. It adds a new option to your admin interface called “Wiki Upgrade”. Follow the wizard and upgrade
your wiki to the most current stable release of DokuWiki in just a few steps.

Plugin Author?
Have you written one or more plugins? The subscription functionality of dokuwiki.org has been turned on to allow plugin authors to monitor their plugin homepages - just click the
Manage Subscriptions” button. And if your plugin is compatible, please explicitly state Anteater in the compatibility field.

Filename Encode
Users that
used the safe filename encode feature in the  release candidate Lazy Sunday should read this mail thread before installing Anteater. Pages were created in the release candidate with wrong names and will not work automatically, you need to rename them yourself.

Msg File Removed
The message counter file used for the update check has been removed in
Anteater. It is replaced by $updateVersion variable in doku.php The change was neccessary to improve DokuWiki's farm support.

Follower Counts
Get more DokuWiki news by following us on your favorite social network:


Facebook: 312 fans
Twitter: 163 followers
Identi.ca: 60 subscribers
LinkedIn: 49 members
Xing: 92 members
GitHub: 158 watchers
 Ohloh: 166 users


 



You get this mail, because you subscribed to the DokuWiki newsletter.

Unsubscribe <<Email Address>> from this list.

Forward this email to a friend
Update your profile
Email Marketing Powered by Mailchimp