aboutsummaryrefslogtreecommitdiffhomepage
path: root/doc/Plugins.md
diff options
context:
space:
mode:
authornodiscc <nodiscc@gmail.com>2017-01-26 18:52:54 +0100
committernodiscc <nodiscc@gmail.com>2017-06-18 00:19:49 +0200
commit53ed6d7d1e678d7486337ce67a2f17b30bac21ac (patch)
treef8bef0164a70bd03d2b9781951c01bdd018f1842 /doc/Plugins.md
parentd5d22a6d07917865c44148ad76f43c65a929a890 (diff)
downloadShaarli-53ed6d7d1e678d7486337ce67a2f17b30bac21ac.tar.gz
Shaarli-53ed6d7d1e678d7486337ce67a2f17b30bac21ac.tar.zst
Shaarli-53ed6d7d1e678d7486337ce67a2f17b30bac21ac.zip
Generate HTML documentation using MkDocs (WIP)
MkDocs is a static site generator geared towards building project documentation. Documentation source files are written in Markdown, and configured with a single YAML file. * http://www.mkdocs.org/ * http://www.mkdocs.org/user-guide/configuration/ Ref. #312 * remove pandoc-generated HTML documentation * move markdown doc to doc/md/, * mkdocs.yml: * generate HTML doc in doc/html * add pages TOC/ordering * use index.md as index page * Makefile: remove execute permissions from generated files * Makefile: rewrite htmlpages GFM to markdown conversion using sed: awk expression aslo matched '][' which causes invalid output on complex links with images or code blocks * Add mkdocs.yml to .gitattributes, exclude this file from release archives * Makefile: rename: htmldoc -> doc_html target * run make doc: pull latest markdown documentation from wiki * run make htmlpages: update html documentation
Diffstat (limited to 'doc/Plugins.md')
-rw-r--r--doc/Plugins.md76
1 files changed, 0 insertions, 76 deletions
diff --git a/doc/Plugins.md b/doc/Plugins.md
deleted file mode 100644
index e3192a60..00000000
--- a/doc/Plugins.md
+++ /dev/null
@@ -1,76 +0,0 @@
1#Plugins
2## Plugin installation
3
4There is a bunch of plugins shipped with Shaarli, where there is nothing to do to install them.
5
6If you want to install a third party plugin:
7
8 * Download it.
9 * Put it in the `plugins` directory in Shaarli's installation folder.
10 * Make sure you put it correctly:
11
12```
13| index.php
14| plugins/
15|---| custom_plugin/
16| |---| custom_plugin.php
17| |---| ...
18
19```
20
21 * Make sure your webserver can read and write the files in your plugin folder.
22
23## Plugin configuration
24
25In Shaarli's administration page (`Tools` link), go to `Plugin administration`.
26
27Here you can enable and disable all plugins available, and configure them.
28
29![administration screenshot](https://camo.githubusercontent.com/5da68e191969007492ca0fbeb25f3b2357b748cc/687474703a2f2f692e696d6775722e636f6d2f766837544643712e706e67)[](.html)
30
31## Plugin order
32
33In the plugin administration page, you can move enabled plugins to the top or bottom of the list. The first plugins in the list will be processed first.
34
35This is important in case plugins are depending on each other. Read plugins README details for more information.
36
37**Use case**: The (non existent) plugin `shaares_footer` adds a footer to every shaare in Markdown syntax. It needs to be processed *before* (higher in the list) the Markdown plugin. Otherwise its syntax won't be translated in HTML.
38
39## File mode
40
41Enabled plugin are stored in your `config.php` parameters file, under the `array`:
42
43```php
44$GLOBALS['config'['ENABLED_PLUGINS']]('ENABLED_PLUGINS'].html)
45```
46
47You can edit them manually here.
48Example:
49
50```php
51$GLOBALS['config'['ENABLED_PLUGINS'] = array(]('ENABLED_PLUGINS']-=-array(.html)
52 'qrcode',
53 'archiveorg',
54 'wallabag',
55 'markdown',
56);
57```
58
59### Plugin usage
60
61#### Official plugins
62
63Usage of each plugin is documented in it's README file:
64
65 * `addlink-toolbar`: Adds the addlink input on the linklist page
66 * `archiveorg`: For each link, add an Archive.org icon
67 * [`markdown`](https://github.com/shaarli/Shaarli/blob/master/plugins/markdown/README.md): Render shaare description with Markdown syntax.[](.html)
68 * [`playvideos`](https://github.com/shaarli/Shaarli/blob/master/plugins/playvideos/README.md): Add a button in the toolbar allowing to watch all videos.[](.html)
69 * `qrcode`: For each link, add a QRCode icon.
70 * [`wallabag`](https://github.com/shaarli/Shaarli/blob/master/plugins/wallabag/README.md): For each link, add a Wallabag icon to save it in your instance.[](.html)
71
72
73
74#### Third party plugins
75
76See [Community & related software](https://github.com/shaarli/Shaarli/wiki/Community-%26-Related-software#third-party-plugins)[](.html)