Welcome!

Linux Containers Authors: Pat Romanski, ManageEngine IT Matters, Elizabeth White, Liz McMillan, Gerardo A Dada

Related Topics: Open Source Cloud, Linux Containers, Eclipse

Open Source Cloud: Article

Dokuwiki - A Practical Open Source Knowledge Base Solution

Easy-to-use, intuitive and full-featured

(SYS-CON Media) - Whether you're a company of one or 100, managing knowledge is a core concern and implementing a knowledge base is a sensible way to capture your content. Dokuwiki is a practical open source Web application for creating a knowledge base that's easy for novice Webmasters to set up but flexible and full-featured.

The Dokuwiki Web site (www.splitbrain.org/projects/dokuwiki) describes the Dokuwiki as "a simple to use wiki aimed at a small company's documentation needs. It works on plain text files and thus needs no database. It has a simple but powerful syntax which makes sure the data files remain readable outside the wiki." Dokuwiki runs on a variety of Web servers, including Apache and IIS and requires PHP 4.3.x or higher. If you do not have your own Web server, you can install Dokuwiki on a hosted Web site, as long the Web host includes PHP access.

Features
Dokuwiki has many of the features you'd expect in a Web application, such as version control, templates, and plug-ins, and for the most part, you can quickly learn about them as you use the software. However, before you deploy Dokuwiki, you should learn how to use syntax, namespaces, and Access Control Lists (ACL), which will let you organize the site layout during installation, not three months from now.

The syntax is a text mark-up that formats the content on the wiki pages for display. For example, **text** displays as text. For me, typing the extra characters is easier than using a tool bar. For the point-and-click crowd, formatting can be inserted using quick buttons on the tool bar like a word processor.

Namespaces organize the page layout and the directory structure of the raw text files and do require specific syntax knowledge to implement when editing a page. The best way to explain namespaces is with an example. Suppose I want to organize my wiki into Support Documentation and Writing Projects. I'd edit my Dokuwiki start page and add the following text:

[[Support:Support Documentation]]
[[Writing:Writing Projects]]

This is Dokuwiki's simple syntax at work. The text in the double brackets signifies a link. The text that follows the colon is the page name, and the text preceding the colon is the namespace. When I save the edits, new hyperlinks to Support Documentation and Writing Projects are created. When I follow the links, and edit the new pages, Dokuwiki creates the dokuwiki/data/pages/support and dokuwiki/data/pages/writing directories. The text files for all pages created in the Support Documentation and Writing Projects pages will be stored in their respective directories, which let you easily retrieve the text files later.

If your wiki is going to have more than one user, you need to think about access control because Dokuwiki is wide open by default, which means that anyone can create or edit pages. That's the default wiki way but not necessarily the right way for you. Dokuwiki controls access with ACL, which can be used to grant levels of access based on users, groups, pages, or namespaces. The levels of access include read, edit, create, upload, and delete. Upload and delete access refer to media files.

Installation and Configuration
Assuming you already have a Web server configured, installation is straightforward and can be summarized in three steps. Download Dokuwiki to the Web server. Unzip the download file to the Web server's root directory. Configure the installation. For specific help, consult the installation instructions at http://wiki.splitbrain.org/wiki:Install for your server platform. You can have a functioning installation in 20 minutes, less if you skip the coffee break.

File permissions are the one sticking point of the installation, and every installation or upgrade I do ends up with a permission problem at some point. Dokuwiki, however, handles its errors well and if your data directory has insufficient write permissions or you're missing the changes.log file, the error will tell you that. To help troubleshoot page problems, append ?do=check to the end of the Dokuwiki URL to display the current page's permissions along with site installation details.

Even if you don't require users to register an account, you should set up ACL so you can specify a superuser. Only the superuser can access the administration page, which provides a graphical interface to manage users, plug-ins, access, and site configurations. Setting up ACL and assigning a superuser requires several extra configuration steps, and is the most convoluted process in a Dokuwiki installation.

Much to my surprise, project founder Andreas Gohr published a release candidate as I was writing my review. The release candidate included an installer that automated the creation of a superuser login and specified a default access level. Run the install.php script in the dokuwiki installation directory, and a form like the one pictured in the screen shot will display. Enter the requested information and save the changes. Login as the superuser to access the administration page and fine-tune the configuration settings as needed. The documentation covers the configuration settings in detail.

You are now ready to add content.

Use
Dokuwiki is easy-to-use and intuitive, in part because users create, edit, and read pages from a browser. To create content, select "Edit this page" to display an editable page. When done adding and formatting content, save the page to make the changes live.

While the "Old revisions" button is easy to spot, the process to restore a previous version is not discernible while looking at the page. To go back to an old version, use the "Old revisions" button to view changes by date. Select the desired version to display it in the browser. Edit and save the page to restore the previous version.

At first glance, Dokuwiki's default view appears basic and lacks the side-navigation panels we've grown to expect from modern Web applications. Several templates are available from the Dokuwiki site, including one with a Wikipedia feel; however, I prefer the clean look of the default template because it puts the emphasis on my content, not graphics or panels.

Dokuwiki's navigation aids include backlinks, the wiki title, breadcrumbs, and a table of contents. Click on the page name to get a list of backlinks, or pages that refer to the current page. The page name displays left-aligned at the top of the page such as [[start]]. The wiki title displays right-aligned at the top of the page such as "Wiki on Coyote" (the current name of my site) and is a link that takes you back to the default start page, while the pages viewed most recently are available as "breadcrumbs" letting you trace the last few pages in your history. Each page builds a table of contents based on the header levels defined in the page, which facilitates navigation within the page itself.

Not all navigation is done with a mouse, and Dokuwiki includes several access keys that you can use as keyboard shortcuts. For example, use ALT + E to edit a page and ALT + H to return to the start page; use ALT + B to make text bold. Check out the documentation or hover your mouse over a button to get more access keys.

Final Review
As I leave you to build your knowledge base, remember that Dokuwiki is only a tool. It will not make your documentation better, but I've focused on the features that will help you deploy a well-organized and easy-to-manage knowledge base. Your wiki needs human attention and editorial control to grow into a useful resource for you, your teams, and your customers.

More Stories By Mike Badger

Mike Badger is a technical Ccmmunicator and author of 2 books - Zenoss Core Network and System Monitoring and Scratch 1.4 Beginner's Guide, available from Packt Publishing. He's also a project manager for MoJo Active, an marketing and web design firm in Central Pennsylvania.

He raise honeybees, pigs, and a family.

Michael Badger is a technical communicator who has devoted his career to translating technical concepts in a way that helps people learn, adapt, and troubleshoot their computer software. He wrote two books with Packt Publishing: Zenoss Core Network and System Monitoring and Scratch 1.4 Beginner's Guide.

For fun, he grows pigs, raises honeybees, fishes, and spends time with his family.

For more information visit, badgerfiles.com.

Comments (1) View Comments

Share your thoughts on this story.

Add your comment
You must be signed in to add a comment. Sign-in | Register

In accordance with our Comment Policy, we encourage comments that are on topic, relevant and to-the-point. We will remove comments that include profanity, personal attacks, racial slurs, threats of violence, or other inappropriate material that violates our Terms and Conditions, and will block users who make repeated violations. We ask all readers to expect diversity of opinion and to treat one another with dignity and respect.


Most Recent Comments
imho 01/04/07 03:12:33 PM EST

Dukowiki has a simple syntax which makes sure the datafiles remain readable outside the Wiki and eases the creation of structured texts.

@ThingsExpo Stories
"We've discovered that after shows 80% if leads that people get, 80% of the conversations end up on the show floor, meaning people forget about it, people forget who they talk to, people forget that there are actual business opportunities to be had here so we try to help out and keep the conversations going," explained Jeff Mesnik, Founder and President of ContentMX, in this SYS-CON.tv interview at 18th Cloud Expo, held June 7-9, 2016, at the Javits Center in New York City, NY.
Internet of @ThingsExpo, taking place November 1-3, 2016, at the Santa Clara Convention Center in Santa Clara, CA, is co-located with the 19th International Cloud Expo and will feature technical sessions from a rock star conference faculty and the leading industry players in the world and ThingsExpo Silicon Valley Call for Papers is now open.
The IoT is changing the way enterprises conduct business. In his session at @ThingsExpo, Eric Hoffman, Vice President at EastBanc Technologies, discussed how businesses can gain an edge over competitors by empowering consumers to take control through IoT. He cited examples such as a Washington, D.C.-based sports club that leveraged IoT and the cloud to develop a comprehensive booking system. He also highlighted how IoT can revitalize and restore outdated business models, making them profitable ...
"delaPlex is a software development company. We do team-based outsourcing development," explained Mark Rivers, COO and Co-founder of delaPlex Software, in this SYS-CON.tv interview at 18th Cloud Expo, held June 7-9, 2016, at the Javits Center in New York City, NY.
We all know the latest numbers: Gartner, Inc. forecasts that 6.4 billion connected things will be in use worldwide in 2016, up 30 percent from last year, and will reach 20.8 billion by 2020. We're rapidly approaching a data production of 40 zettabytes a day – more than we can every physically store, and exabytes and yottabytes are just around the corner. For many that’s a good sign, as data has been proven to equal money – IF it’s ingested, integrated, and analyzed fast enough. Without real-ti...
"There's a growing demand from users for things to be faster. When you think about all the transactions or interactions users will have with your product and everything that is between those transactions and interactions - what drives us at Catchpoint Systems is the idea to measure that and to analyze it," explained Leo Vasiliou, Director of Web Performance Engineering at Catchpoint Systems, in this SYS-CON.tv interview at 18th Cloud Expo, held June 7-9, 2016, at the Javits Center in New York Ci...
I wanted to gather all of my Internet of Things (IOT) blogs into a single blog (that I could later use with my University of San Francisco (USF) Big Data “MBA” course). However as I started to pull these blogs together, I realized that my IOT discussion lacked a vision; it lacked an end point towards which an organization could drive their IOT envisioning, proof of value, app dev, data engineering and data science efforts. And I think that the IOT end point is really quite simple…
A critical component of any IoT project is what to do with all the data being generated. This data needs to be captured, processed, structured, and stored in a way to facilitate different kinds of queries. Traditional data warehouse and analytical systems are mature technologies that can be used to handle certain kinds of queries, but they are not always well suited to many problems, particularly when there is a need for real-time insights.
Big Data, cloud, analytics, contextual information, wearable tech, sensors, mobility, and WebRTC: together, these advances have created a perfect storm of technologies that are disrupting and transforming classic communications models and ecosystems. In his session at @ThingsExpo, Erik Perotti, Senior Manager of New Ventures on Plantronics’ Innovation team, provided an overview of this technological shift, including associated business and consumer communications impacts, and opportunities it ...
You think you know what’s in your data. But do you? Most organizations are now aware of the business intelligence represented by their data. Data science stands to take this to a level you never thought of – literally. The techniques of data science, when used with the capabilities of Big Data technologies, can make connections you had not yet imagined, helping you discover new insights and ask new questions of your data. In his session at @ThingsExpo, Sarbjit Sarkaria, data science team lead ...
Extracting business value from Internet of Things (IoT) data doesn’t happen overnight. There are several requirements that must be satisfied, including IoT device enablement, data analysis, real-time detection of complex events and automated orchestration of actions. Unfortunately, too many companies fall short in achieving their business goals by implementing incomplete solutions or not focusing on tangible use cases. In his general session at @ThingsExpo, Dave McCarthy, Director of Products...
Is your aging software platform suffering from technical debt while the market changes and demands new solutions at a faster clip? It’s a bold move, but you might consider walking away from your core platform and starting fresh. ReadyTalk did exactly that. In his General Session at 19th Cloud Expo, Michael Chambliss, Head of Engineering at ReadyTalk, will discuss why and how ReadyTalk diverted from healthy revenue and over a decade of audio conferencing product development to start an innovati...
WebRTC is bringing significant change to the communications landscape that will bridge the worlds of web and telephony, making the Internet the new standard for communications. Cloud9 took the road less traveled and used WebRTC to create a downloadable enterprise-grade communications platform that is changing the communication dynamic in the financial sector. In his session at @ThingsExpo, Leo Papadopoulos, CTO of Cloud9, discussed the importance of WebRTC and how it enables companies to focus...
SYS-CON Events announced today that 910Telecom will exhibit at the 19th International Cloud Expo, which will take place on November 1–3, 2016, at the Santa Clara Convention Center in Santa Clara, CA. Housed in the classic Denver Gas & Electric Building, 910 15th St., 910Telecom is a carrier-neutral telecom hotel located in the heart of Denver. Adjacent to CenturyLink, AT&T, and Denver Main, 910Telecom offers connectivity to all major carriers, Internet service providers, Internet backbones and ...
SYS-CON Events announced today that LeaseWeb USA, a cloud Infrastructure-as-a-Service (IaaS) provider, will exhibit at the 19th International Cloud Expo, which will take place on November 1–3, 2016, at the Santa Clara Convention Center in Santa Clara, CA. LeaseWeb is one of the world's largest hosting brands. The company helps customers define, develop and deploy IT infrastructure tailored to their exact business needs, by combining various kinds cloud solutions.
Manufacturers are embracing the Industrial Internet the same way consumers are leveraging Fitbits – to improve overall health and wellness. Both can provide consistent measurement, visibility, and suggest performance improvements customized to help reach goals. Fitbit users can view real-time data and make adjustments to increase their activity. In his session at @ThingsExpo, Mark Bernardo Professional Services Leader, Americas, at GE Digital, discussed how leveraging the Industrial Internet a...
The cloud market growth today is largely in public clouds. While there is a lot of spend in IT departments in virtualization, these aren’t yet translating into a true “cloud” experience within the enterprise. What is stopping the growth of the “private cloud” market? In his general session at 18th Cloud Expo, Nara Rajagopalan, CEO of Accelerite, explored the challenges in deploying, managing, and getting adoption for a private cloud within an enterprise. What are the key differences between wh...
SYS-CON Events announced today that Venafi, the Immune System for the Internet™ and the leading provider of Next Generation Trust Protection, will exhibit at @DevOpsSummit at 19th International Cloud Expo, which will take place on November 1–3, 2016, at the Santa Clara Convention Center in Santa Clara, CA. Venafi is the Immune System for the Internet™ that protects the foundation of all cybersecurity – cryptographic keys and digital certificates – so they can’t be misused by bad guys in attacks...
The best-practices for building IoT applications with Go Code that attendees can use to build their own IoT applications. In his session at @ThingsExpo, Indraneel Mitra, Senior Solutions Architect & Technology Evangelist at Cognizant, provided valuable information and resources for both novice and experienced developers on how to get started with IoT and Golang in a day. He also provided information on how to use Intel Arduino Kit, Go Robotics API and AWS IoT stack to build an application tha...
Amazon has gradually rolled out parts of its IoT offerings in the last year, but these are just the tip of the iceberg. In addition to optimizing their back-end AWS offerings, Amazon is laying the ground work to be a major force in IoT – especially in the connected home and office. Amazon is extending its reach by building on its dominant Cloud IoT platform, its Dash Button strategy, recently announced Replenishment Services, the Echo/Alexa voice recognition control platform, the 6-7 strategic...