devel:plugin_homepages
Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revision | |||
| devel:plugin_homepages [2016-01-24 18:49] – Aleksandr | devel:plugin_homepages [2023-09-19 11:30] (current) – superseded by namespace template andi | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== Explanation plugin homepages ====== | ||
| - | This page is both a template and a set of general guidelines for how to create a page for your plugin in the plugin namespace. Most of these guidelines are, of course, optional, but following them will make your plugin documentation more consistent with other entries on the web site. | ||
| - | |||
| - | Instructions for each section //will be in italics//. Example text is provided for most sections. You should remove all of the instructions and example text when you create your plugin page. | ||
| - | |||
| - | This structure of this template is primary specified for syntax plugins. However, please use your best judgement and adjust the content as necessary. For example, for most other plugins you would not need the Syntax or Example sections. | ||
| - | |||
| - | |||
| - | ====== < | ||
| - | |||
| - | |||
| - | < | ||
| - | ====== Example Plugin ====== | ||
| - | |||
| - | ---- plugin ---- | ||
| - | description: | ||
| - | author | ||
| - | email : joe@example.com | ||
| - | type : syntax, action, admin, helper, render | ||
| - | lastupdate : 2007-12-17 | ||
| - | compatible : Anteater, 2010-02-14 | ||
| - | depends | ||
| - | conflicts | ||
| - | similar | ||
| - | tags : example, sample | ||
| - | |||
| - | downloadurl: | ||
| - | bugtracker : https:// | ||
| - | sourcerepo : https:// | ||
| - | donationurl: | ||
| - | ---- | ||
| - | </ | ||
| - | //:!: **This section is required.**// | ||
| - | |||
| - | * // | ||
| - | |||
| - | * //**Data entry** Next you must supply the data entry. When you create your name plugin page, it will prefilled. Read the [[plugin: | ||
| - | |||
| - | ===== Description ===== | ||
| - | //A short description of what your plugin does... and why it's useful. It should be in more detail than ' | ||
| - | |||
| - | ===== Examples/ | ||
| - | //This section should be a compliment to the Description section above. Its purpose is to demonstrate the basic usage of your plugin. It is not intended to be the place to demonstrate every feature and option, nor show off all that your plugin can do. Save the details of your plugins capabilities for the Syntax section.// | ||
| - | |||
| - | //If you have screenshots of your plugin in action, this would be an ideal place to add them. Since dokuwiki.org does not host screenshots it is recommended that you upload your images to ImageShack by using the " | ||
| - | |||
| - | //Please be judicious when adding images to your plugin page. The content area of the plugin page is limited to approximately 680 pixels in width. If you need to add an image larger than 680x300, use a thumbnail to link to the original image. Limit the size of the thumbnail to 200x200.// | ||
| - | |||
| - | A simple box: | ||
| - | |||
| - | <box> the box contents </ | ||
| - | |||
| - | Some more complex boxes | ||
| - | |||
| - | <box 80% round orange|a title> the box contents</ | ||
| - | <box 50% left blue>the box contents</ | ||
| - | <box 60% round #f99 #fc9 #fcc # | ||
| - | |||
| - | {{http:// | ||
| - | {{ http:// | ||
| - | {{ http:// | ||
| - | |||
| - | |||
| - | ===== Installation ===== | ||
| - | //If your plugin requires more information to properly install it than merely pasting the download URL into the Plugin Manager, you should document the details in this section. If your plugin has dependencies beyond the stock DokuWiki installation, | ||
| - | |||
| - | //If the plugin can be installed using the Plugin Manager, it is safe to omit this section.// | ||
| - | |||
| - | :!: **External requirements: | ||
| - | * [[A banana]] | ||
| - | * [[Another banana]] | ||
| - | |||
| - | Install the plugin using the [[plugin: | ||
| - | |||
| - | ===== Syntax ===== | ||
| - | //Use this section to provide the detailed documentation for your plugin. Unlike the Examples or Usage section, you should use this section to fully document the operation of your plugin.// | ||
| - | |||
| - | Basic syntax: | ||
| - | < | ||
| - | * **action** can be one of this: | ||
| - | * // | ||
| - | * //history// --- old revisions | ||
| - | |||
| - | ===== Configuration and Settings ===== | ||
| - | //If your plugin can take advantage of specialized configuration then document it here. Examples would be options in the Configuration Manager and providing CSS style tips.// | ||
| - | |||
| - | ===== Development ===== | ||
| - | // | ||
| - | |||
| - | === Change Log === | ||
| - | // | ||
| - | |||
| - | * **2009-01-01** | ||
| - | * Initial release | ||
| - | |||
| - | //Example rss feed for '' | ||
| - | {{rss> | ||
| - | |||
| - | === Report Bugs and Issues === | ||
| - | //Be clear where you like to see bug and feature request. In the bugtracker (e.g. Github) or here in this section.// | ||
| - | * //You can follow the edits of others on this wikipage via the '' | ||
| - | |||
| - | |||
| - | === Known issues and roadmap === | ||
| - | // | ||
| - | |||
| - | ===== FAQ ===== | ||
| - | //Maintain any FAQs in this section. If this section becomes too long, consider improving your documentation or moving this section to a new page.// | ||
| - | |||
| - | === Is this a frequently asked question? === | ||
| - | Yes, it is. | ||
| - | |||
| - | ===== Discussion ===== | ||
| - | |||
| - | //The Discussion section should be added so as to maintain a distinction between user comments and author documentation. Discussions should ideally be deleted and turned into FAQ entries along the way. It's recommended that you subscribe to your plugin page so you can address any issues that end-users bring up.// | ||
| - | |||
| - | //If you prefer to maintain a discussion page off-site, such as in a forum or mailing list, indicate so in this section and provide the appropriate links or information for users to participate.// | ||
devel/plugin_homepages.1453657786.txt.gz · Last modified: 2016-01-24 18:49 by Aleksandr