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


DokuWiki Community News

DokuWiki lead developer Andreas Gohr recently attended WikiCamp. One of the most interesting sessions was about how to mix structured data with the unstructured approach of wikis. Oliver Krüger from the FOSWiki project talked about how FOSWiki lets you add forms to wiki pages for attaching structured data to pages which later can be queried and aggregated. Volker Friedel, a Semantic MediaWiki user explained that similar mechanisms are used in this system. If you're familiar with the
bureaucracy and data plugins for DokuWiki you would have recognized the mentioned features.

Andreas also held a short session about an experimental plugin to automatically measure the structural quality of a DokuWiki page to help users and Wiki gardeners. It doesn't analyse the page content but instead focuses on general good practices in formatting and structuring wiki pages. You can read more about that in a blog post.

Two weeks after the WikiCamp there was a small DokuWiki user meeting in Cologne. Andreas and some others met in a café and talked about the attendees various DokuWiki uses, their favourite plugins and lots of other stuff as well. A fun way to meet new people.

Taking about meetings - A developer meeting is planned again this year and everyone involved or interested in DokuWiki core, plugin or template development is invited to join us. There are currently two venues in consideration but no decision has been made, yet. You can still weigh in.

Recent Development Activity

It's the details that count! One of many submits recently was icons and mime-type definitions for Office Open documents and other formats (docx, pptx, xlsx, mp3, 7z). Besides more media link types, the media manager has been improved with a new link settings dialogue with options for alignment, target type and image size. Visit www.dokuwiki.org and try it out.

Link settings dialogue

The stability expectations for DokuWiki grow together with the community and plugins are no exception. DokuWiki developer Michael Klier has added unittest support for plugins. Plugin authors now have a test framework similar to the DokuWiki core test framework. Plugin tests are located in a dedicated directory _test/ within a plugin directory and the plugin tests are accessible via the web interface of the test suite and via the CLI interface.

Commits are made to the DokuWiki code almost every day and it's not possible to comment on all, but we like to mention the ongoing Arabic translation effort by DokuWiki translator Usama Akkad. This work sets focus on right-to-left (rtl) support which is also used by other languages. Some bugs have been squashed during last couple of weeks as well.

Featured Plugin: phpwikify

DokuWiki is a great tool to store documentation, with a simple syntax and powerful plugins that extend the functionality to include other pages and sources of content (such as RSS) dynamically. However, there is no generic tool to generate content "on-the-fly"; the closes thing is the "embed <php>" option that forces the editor to directly handle HTML syntax and hence breaks the flow, layout and visual design of the generated content. This is where the phpwikify plugin comes in.

This plugin released circa 2005 by Kasper Sandberg essentially allows an editor to feed PHP instructions on-the-fly, via a <phpwikify>...</phpwikify> block, but using actual DokuWiki syntax as an output format; then DokuWiki parses and renders the resulting content itself. Most PHP features are accessible via this plugin; in particular it is possible to access $_SERVER and $_REQUEST as well as invoke any available plugins, and with some careful design, external files can be included; "heredoc" syntax can not be used however, and any variable defined won't live beyond the actual PHP code block.

As such phpwikify is ideal to include short snippets of dynamically generated content. This snippet will display an interwiki link to historical events recorded in Wikipedia for the current day of year. More examples are available at this test page.

<phpwikify>
$months= array ("January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December");
$y= date('Y');
$d= date('d');
$m= date('m');
$d= intval($d);
$m= $months[intval($m)-1];
$today = "$m $d";

echo "^ About $m $d  | [[wp>$today|historical events]] |\n";
</phpwikify>



In short, the phpwikify plugin will allow you to do pretty much anything you can normally do in PHP, with the benefit of working with DokuWiki features such as syntax and (installed) plugins. As a result, any content generated will not only follow your installation's settings for templates and styling but also be available seamlessly to any renderer, search tool or feed as DokuWiki sees fit.

Of course, this being a particularly powerful plugin and giving access to system features, you should be careful to enable it only in a wiki with a strong ACL and trusted user base. Never should you allow this plugin in a publicly-editable wiki.

Tips & Tricks: dwpage

Sometimes you want to integrate data from automatic sources into your wiki. Maybe using the RSS syntax will be enough, but another time an automated page update will be better off. Scripts can access DokuWiki by using bin/dwpage.php which is a part of the command line interface tools. Available actions includes checkout, lock and submitting.

The result can be a build report for your software project or a config file archive for example. And of course dwpage can be used to edit a lot of pages by script when the batchedit plugin isn't enough.
Use-case: Employee List
Andrey 'lolmaus' Mikhaylov has written an article on how to set-up DokuWiki to manage a list of employees using the data, bureaucracy and wrap plugins. You get new employees added using a nice form and all employees displayed in a sortable table with first and last name, birthday etc.

Large Dev Team
"This is one of the largest open-source teams in the world, and is in the top 2% of all project teams on Ohloh."
Ohloh reports this interesting factoid about the DokuWiki developer team. Submits have been done by 144 individuals during last 12 months. Ohloh is a free public directory of open source software and people. By regularly monitoring the DokuWiki repository and about 400,000 other projects Ohloh creates reports on code and developers.

iPhone Template
It took a while, but here it is, the first touch mobile template. DokuWiki user 'hiflyer' claims he's not a coder but he has got the usability working for sure.

Dokumobile template

Newsletter team says: Next step could be a release using the isMobile flag serving both hand-held and PC's. 

Even More Templates
A number of templates has been updated lately, like Arctic and Sandy. And if you are looking for that nice blue and gray professional looking template, Mirko Windhoff recently created Drupal garland blue.

drupal template

Follower Counts
Get more DokuWiki news by following us on your favorite social network:
Facebook: 226 fans
Twitter: 88 followers
Identi.ca: 46 subscribers
LinkedIn: 37 members
Xing: 70 members

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

Unsubscribe &lt;&lt;Email Address>> from this list.

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