DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:snippeter

Snippeter Plugin

Compatible with DokuWiki

  • 2024-02-06 "Kaos" yes
  • 2023-04-04 "Jack Jackrum" yes
  • 2022-07-31 "Igor" yes
  • 2020-07-29 "Hogfather" yes

plugin Add document snippets into an existing page

Last updated on
2024-02-13
Provides
Action
Repository
Source

Similar to snippets

Tagged with editor, namespace, snippets

Description

This plugin adds a new button to editor toolbar. When clicking on it a popup shows up, showing a list of page templates which can be inserted into the editor window. The list of templates is defined using a special configureable namespace which contains pages which could be used as templates.

Installation

Search and install the plugin using the Extension Manager.

Refer to Plugins on how to install plugins manually. The local plugin directory must have the same name as the plugin is named, otherwise the plugin won't work properly. It seems to be necessary in some cases to reset DokuWikis cache after the manual installation. Please reset DokuWiki's cache: either press the save button in the Configuration Manager page or touch the file conf/local.php.

Examples/Usage

Configuration

After successful installation you will find an additional section in the wiki's Configuration Manager called “snippeter”. Within that section you can configure the namespace you want to use for your snippets.

The plugin provides a shortcut for each page created in that namespace.

Create snippets

In general you can use any wiki page placed in the namespace you configured for snippeter. To add an icon to identify the snippet within the editor toolbar, you have to add the picture you plan to use using the dokuwiki media manager right within the snippet page.

NOTE: Snippeter only supports PNG (.png) files in the current version. This might be changed in the future. Please refresh dokuwiki's cache to see your new icon! (touch the file conf/local.php)

Valid Example:

{{ :snippets:phone16.png |}}

==== Call: <project> - <description> ====

{{tag>}}
  * **Person:** 
  * **Time:** 

**Notes**
  * 

----

Usage

Snippeter create a shortcut within the default editor toolbar (the “+” icon). This icon will open up an overview of your snippets. Choosing one of them with a click on the related icon will insert your snippet without the media manager information for the icon on the current cursor position within your open wiki page.

Development

Changelog

A complete changelog is available here.

FAQ

I added a customized icon for my snipped, but snippeter still provide the default one in the toolbar.

Please reset DokuWikis cache while touch the file conf/local.php or press the save button within the Configuration Manager page.

Discussion

plugin/snippeter.txt · Last modified: 2024-02-19 09:04 by Aleksandr

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki