DokuWiki — Tips and Tricks

====== Tips and Tricks ======

NEEDSATTENTION

----

Steps for reorg :

* <del>Add all pages within the tips namespace here</del> <del>Done</del>

* Add a description to each page, and categorize within this page :!: Almost done.

* Review external links to remove broken ones, maybe integrate external link to have all content on dokuwiki.org

If possible please rewrite content, and remove old things.

^ NOTE to translators : When updating your tips page, please use the index button to see what pages are within your locale :tips namespace. And please do include them into the tips page. Thanks. ^

This is the place to collect all your Tips and Tricks for [[DokuWiki]] Usage.

===== Usage Tips =====

^ Link ^ Short Description ^

|[[tips:TailorWikiRules]] | Best-practices to follow after installing DokuWiki |

|[[http://www.robmeerman.co.uk/unix:unison|Syncing with Unison]] | Sync two wikis using unison |

|[[tips:timezone]] | Set the server's Timezone |

|[[tips:mailconfig]] | Tips on making mail work |

|[[tips:uploadcodedir]] | Uploading a directory of code to DokuWiki |

|[[tips:commonlogin]] | Sharing authentication data between wikis on the same server |

|[[tips:doc_to_wiki_syntax]] | Convert folders with Ms Word Doc files to DokuWiki Syntax |

|[[:tips:displaying-blank-rows-in-tables|Displaying blank rows in tables]] | Displaying blank rows in tables |

|[[:tips:good_style]] | Hints on how to have good styles on DokuWiki |

|[[:tips:table_editing]] | How to import your data into tables |

|[[:tips:upgrading_old_versions]] | How to upgrade from old DokuWiki (2005-*) |

|[[:tips:showmediafromexternalupload]] | How to make files uploaded by other ways than mediamanager to appear ]] |

===== Browser Issues =====

^ Link ^ Short Description ^

|[[tips:scrollposition]] | Why doesn't DokuWiki remember scroll position with Firefox |

|[[tips:preventing-postdata-has-expired]] | Preventing 'POSTDATA has expired' messages |

|[[tips:dom.disable_image_src_set]] | Why don't toolbar buttons of the edit window appear with Firefox |

===== Extending the Syntax =====

**Most** of these tips need to be adjusted for the new [[devel:Parser]] and will not work out of the box. They may be better implemented by using the new [[plugin]] system though. A list of plugins using the new plugin interface lives at the [[plugin]]-page.

^ Link ^ Short Description ^

|[[http://setiwiki.cybertux.de/latexrender|LatexRender]] | Render LaTeX-fragments to images, can be used as an alternative to MathML |

|[[tips:magnet links]] | Show DC<nowiki>++</nowiki> magnet links as external |

|[[:tips:links-to-dokuwiki-commands]] | make links to "DokuWiki actions" (?do=) from within your wiki content|

|[[:tips:tex_howto]] | This patch (to 2005-05-07 version) add AMSLaTeX mathematical expression support to DokuWiki. |

===== Extending Layout and Styling =====

Some of these tips may be implemented better by using the new [[template]] mechanism. You are encouraged to rewrite them accordingly.

^ Link ^ Short Description ^

|[[tips:CustomQuoting]] | Change the style of Quoting |

|[[tips:format_user]] | Using CN from client certificate when displaying username |

|[[http://ktyp.com/dev/doku/dokuwiki/hacks/prettyrecent|Pretty Recent]] | Changes the recently updated page to include day headers [[tips:prettyrecentfix|Fix for July 1 Revision]] |

|[[tips:prewithwrap|'pre' section with wrap]] | %%<pre>%% section with wrapping |

|[[tips:Disabling link icons]] | Disables interwiki and non-wiki link icons |

|[[tips:rss_description|Descriptions in RSS aggregator]] | Add the beginning of every RSS article in the list |

|[[tips:code_css|Code CSS]] | CSS for use with Syntax Highlighting |

|[[tips:geshi_style_builder]] | Geshi Style builder |

|[[tips:XHTML Strict]] | How to switch to XHTML 1.0 Strict |

|[[tips:image_nolink]] | Make inserted images default to no link |

|[[tips:Toc use position fixed]] | When the user scrolls the page, the TOC does not scroll with it, the TOC is fixed. |

|[[tips:numbered headings]] | Numbered headings per CSS only |

|[[tips:back to top]] | back to top before every header |

|[[tips:local-links-with-icons|Local links with icons]] | Local links with icons |

|[[tips:image-in-the-upper-right-corner]] | replace top right DokuWiki logo by your own |

|[[tips:code-in-ordered-lists]] | Including Code in Ordered Lists |

|[[tips:prettyrecentfix]] | This tips gives you a "Recents" page in a more pretty way. |

|[[tips:tableswithrowspans2]] | Tables with Rowspan Support |

|[[tips:Tables with Rowspan]] | Another way of providing Rowspan support in tables. |

|[[tips:rowspansfix]] | Yet another way to make rowspan possible |

|[[tips:rowspansfix2]] | Yet another way to make rowspan possible |

|[[tips:resizeiframes|Adjust iframe heights]] | An additional JavaScript for the [[plugin:iframe]] plugin to make iframes as high as needed for their content |

|[[tips:styling-headers|Using CSS to Style Headers]] | General tips, case uses and structure info for styling headers with CSS. |

|[[tips:show_changes_in_recents_list|Display the changes for each entry in the recent list]] | Display a diff of the last and the current version for each entry in the recent list]] |

===== Adding new Functionality =====

^ Link ^ Short Description ^

|[[tips:autosubscribemailinglist|Auto Subscribe a Mailinglist]] | Auto Subscribe a user to a mailinglist after registration|

|[[tips:betteremailnotifications|Better Email Notifications]] | Receive HTML-formatted email notifications for page changes |

|[[tips:CleanNotificationScheme|Clean Notification Scheme]] | Clarify notification scheme: namespace subscribers on new page, page subscribers on update |

|[[tips:IPACL|IP-based ACLs]] | Assign access rights based on IP or network of the connecting client. |

|[[tips:BrowserLanguageDetection]] | Change the UI language automatically |

|[[tips:transliteration]] | Transliterate Cyrillic texts to Latin |

|[[tips:pdfexport|PDF Export]] | PDF export using html2ps and pstopdf |

|[[http://wiki.erazor-zone.de/doku.php?id=wiki:projects:php:dokuwiki:print_view|Print View Button]] | make use of ?do=export_html |

|[[tips:printview|tpl_button for print view]] | Adds an tpl_button for print_view |

|[[http://wiki.erazor-zone.de/doku.php?id=wiki:projects:php:dokuwiki:user_link|User Link]] | use an extra wiki-page for users |

|[[tips:HtaccessAuth|.htaccess authentication]] | Use .htaccess authentication instead of the login form |

|[[tips:HtaccessAuth2|.htaccess authentication 2]] | As above with support for UserManager |

|[[tips:httpauth-passthru|HTTP-Auth Passthru]] | Adding http-auth-functionality to your existing ACL-setup |

|[[tips:chainedAuth|Chained Authentication]] | Use a sequence of authentication backends (e.g. LDAP then plain ) |

|[[tips:StickyExportHtml]] | Make do=export_html "sticky" for HTML-only browsing |

|[[tips:HtmlOnly|Html only view]] | Similar to previous. uses .htaccess rewrite for that |

|[[tips:discussion]] | Creates a link or button in your template that leads to a separate discussion-page (like e.g. Wikipedia does provide) |

|[[tips:safely include php code]] | Allow PHP code to be included in pages created by superuser only |

|[[tips:logging|Page Statistics]] | Add page and media file logging to DokuWiki |

|[[tips:tinylogging|Tiny Page Logging]] | Add simple logging to DokuWiki |

|[[tips:nls|NLS]] | Adding unofficial National Language Support (NLS) for DokuWiki |

|[[tips:Summary Enforcement]] | Require the user to enter a summary (or check minor edit) |

|[[devel:toolbar#extending_the_toolbar|ToolbarButton]] | How to add your own button to the toolbar |

|[[tips:homepages]] | Autocreate user homepages when add/modify user accounts |

|[[tips:wordcounter]] | Add a word-/charcounter to the edit form |

|[[tips:mediamanager_filesize|mediamanager and filesize]] | Append the size of the mediamanager selected file to the wikilink |

|[[tips:media_attached]] | media upload is attached to each page |

|[[tips:template_chooser]] | A simple dropdown box in editmode allows you to paste content from a template into the current document |

|[[tips:login_instead_of_forbidden]] | Show the login form when accessing a restricted page |

|[[tips:display_acls]] | Display ACLs in page footer |

|[[tips:action_menu]] | Action menu like in MoinMoin Wiki|

|[[http://half.luck.jp/toeic/doku.php?id=dokuwiki_original_tools|DELETE_THEM]] | Delete Apache owner:group files |

|[[tips:export_html]] | Export multiple pages to HTML |

|[[tips:multilingual_content]] | Multilingual content |

|[[tips:newssystem]] | A News System |