User Tools

Site Tools


Twitter my Tweets    my YouTube

my Thingiverse    my GitHub    my Hackaday.io

Translations of this page:

Sidebar

I think it, i tinker it, i make it :-)



—-

Recent updates:


en:sysadmin:webpublishing:dokuwiki

Dokuwiki

Base setup

  • activated youarehere
  • added a user to superuser
  • in disableactions: activated Register (no registration possible, users only created by admins)

Plugins

Indexmenu

Official URL: https://www.dokuwiki.org/plugin:indexmenu

What is: allows you to customize the sidebar in dokuwiki, providing an automatic populated tree with the namespaces hierarchy

Setup example: after install it you must edit the page sidebar (or en:sidebar if you have the Translation plugin active). In order to provide an automatic populated tree i have put this on en:sidebar page:

{{indexmenu>.#1|js}}

it activate the javascript tree.

For escluding some items from index, you must go in Admin → Configuration Settings and insert in plugin»indexmenu»skip_file filed this, i.e. to exclude the sidebar page, it's a regular expression:

/(:sidebar$)/

Themes examples:

This code:

**thread**
{{indexmenu>.#1|js#thread}}
----
**thread2**
{{indexmenu>.#1|js#thread2}}
----
**default**
{{indexmenu>.#1|js}}
----
**doku**
{{indexmenu>.#1|js#doku}}
----
**drktheme**
{{indexmenu>.#1|js#drktheme}}
----
**indextheme**
{{indexmenu>.#1|js#indextheme}}
----
**kde**
{{indexmenu>.#1|js#kde}}
----
**kgs**
{{indexmenu>.#1|js#kgs}}
----
**pcc_dotted**
{{indexmenu>.#1|js#pcc_dotted}}
----
**repository**
{{indexmenu>.#1|js#repository}}
----
**simple**
{{indexmenu>.#1|js#simple}}

Make this:

thread


thread2


default


doku


drktheme


indextheme


kde


kgs


pcc_dotted


repository


simple

Translation

Official URL: https://www.dokuwiki.org/plugin:translation

What is: allows you to create a multi-language Dokuwiki, putting in the chain of namespaces a code composed of the ISO code of the language, for example it:start page will start in Italian while en:start page will start in English. They show the flags that allow you to select the language.

  • separate namespaces are used to store translations
  • translated pages need to have the same pagename as the main language page

Setup example: after install it you must edit the template, in order to display the flags for language choice. In example, for default template Dokuwiki, edit the file

lib/tpl/dokuwiki/tpl_header.php

by inserting this code:

<?php
$translation = &plugin_load('helper','translation');
if ($translation) echo $translation->showTranslations();
?>

i have inserted the code before

<hr class="a11y" />

To complete the setup, in

Admin -> Configuration Settings

in the field plugin»translation»display (Space separated list of translation languages (ISO codes).)

you must insert the 2 letter language code, in example

en it

i want that the Dokuwiki interface change the language according to the selection made in translation plugin, i flagged the field plugin»translation»translateui (Should the start page automatically redirect into a language namespace using browser language detection?)

Redirect

Official URL: https://www.dokuwiki.org/plugin:redirect

What is: allows to make the redirect from a namepace to another, eg. when a namespace becomes obsolete and you want to replace it with another

Setup example: after installing it, create in the directory

lib/plugins/redirect

a file called

redirect.conf

containing the list of redirects that you want to perform. For example, In example, i installed the plugin translation and I want the start page of the wiki be “it:start”, so I put this content:

start it:start

if you want to do other redirects, you can add more rows below

Note

Official URL: https://www.dokuwiki.org/plugin:note

What is: allows you to easily display boxes containing notes nice to see

Use example:

<note>
 Plain note
</note>

<note warning>
 Warning
</note>

<note tip>
 Tip
</note>

<note important>
 Important
</note>

Make this:

Plain note
Warning
Tip
Important

Video Share

Official URL: https://www.dokuwiki.org/plugin:vshare

What is: embed YouTube and other providers videos

Use example:

{{youtube>YYUzQBHgt0c}}

Changes

Official URL: https://www.dokuwiki.org/plugin:changes

What is: display changes on wiki

Setup example: after install it you must edit the page sidebar (or en:sidebar if you have the Translation plugin active). In order to provide an automatic populated changes list i have put this on en:sidebar page (excluding the root namespace for italian translations):

Recent updates:
{{changes>ns=-it}}

For showing also the changes regarding the media files, i have activated in Admin → Configuration S ettings → plugin»changes»listmedia checkbox.

Upload files with not allowed extensions

If you receive this message when trying to upload a file:

  Upload denied. This file extension is forbidden!

an edit on an Dokuwiki configuration file is needed, you can edit:

conf/mime.conf

for example i have added

stl 	application/sla

in order to enable the upload of the .stl files (3D printing binary file)

en/sysadmin/webpublishing/dokuwiki.txt · Last modified: 2017/12/26 17:52 by alessio.cavalieri