X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=plugins%2Fmarkdown%2FREADME.md;h=196005e77327c61881ddeb76006825da3430a3bc;hb=266e3fe5c8961aaf089bad16b9e4c54de1aaff40;hp=defaacd1df567d7ad6ce6d327b0bac1cbc0597e9;hpb=b7acd6f4313139549a75327e03d7ce50cf28b240;p=github%2Fshaarli%2FShaarli.git diff --git a/plugins/markdown/README.md b/plugins/markdown/README.md index defaacd1..196005e7 100644 --- a/plugins/markdown/README.md +++ b/plugins/markdown/README.md @@ -2,33 +2,54 @@ Convert all your shaares description to HTML formatted Markdown. -Read more about Markdown syntax here. +[Read more about Markdown syntax](http://daringfireball.net/projects/markdown/syntax). + +Markdown processing is done with [Parsedown library](https://github.com/erusev/parsedown). ### Installation -Clone this repository inside your `tpl/plugins/` directory, or download the archive and unpack it there. +As a default plugin, it should already be in `tpl/plugins/` directory. +If not, download and unpack it there. + The directory structure should look like: ``` -??? plugins -    ??? markdown - ??? help.html - ??? markdown.css - ??? markdown.meta - ??? markdown.php - ??? Parsedown.php -    ??? README.md +--- plugins + |--- markdown + |--- help.html + |--- markdown.css + |--- markdown.meta + |--- markdown.php + |--- README.md ``` -To enable the plugin, add `markdown` to your list of enabled plugins in `data/config.php` -(`ENABLED_PLUGINS` array). +To enable the plugin, just check it in the plugin administration page. + +You can also add `markdown` to your list of enabled plugins in `data/config.json.php` +(`general.enabled_plugins` list). This should look like: ``` -$GLOBALS['config']['ENABLED_PLUGINS'] = array('qrcode', 'any_other_plugin', 'markdown') +"general": { + "enabled_plugins": [ + "markdown", + [...] + ], +} ``` +Parsedown parsing library is imported using Composer. If you installed Shaarli using `git`, +or the `master` branch, run + + composer update --no-dev --prefer-dist + +### No Markdown tag + +If the tag `nomarkdown` is set for a shaare, it won't be converted to Markdown syntax. + +> Note: this is a special tag, so it won't be displayed in link list. + ### Known issue #### Redirector