X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=plugins%2Fmarkdown%2FREADME.md;h=4f021871e47d6827118b223cdffd2902e819f3b5;hb=340252ae5de67f46ad43793858532da0cce8b4e2;hp=22d0af356b92daa493aaa9abd60acaa880b0088f;hpb=893338f0d407a0989454d5e3c0e43c97f7eface5;p=github%2Fshaarli%2FShaarli.git diff --git a/plugins/markdown/README.md b/plugins/markdown/README.md index 22d0af35..4f021871 100644 --- a/plugins/markdown/README.md +++ b/plugins/markdown/README.md @@ -1,51 +1,63 @@ -## Markdown Shaarli plugin - -Convert all your shaares description to HTML formatted Markdown. - -Read more about Markdown syntax here. - -### Installation - -Clone this repository inside your `tpl/plugins/` directory, or download the archive and unpack it there. -The directory structure should look like: - -``` -??? plugins -    ??? markdown - ??? help.html - ??? markdown.css - ??? markdown.meta - ??? markdown.php - ??? Parsedown.php -    ??? README.md -``` - -To enable the plugin, add `markdown` to your list of enabled plugins in `data/config.php` -(`ENABLED_PLUGINS` array). - -This should look like: - -``` -$GLOBALS['config']['ENABLED_PLUGINS'] = array('qrcode', 'any_other_plugin', 'markdown') -``` - -### Known issue - -#### Redirector - -If you're using a redirector, you *need* to add a space after a link, -otherwise the rest of the line will be `urlencode`. - -``` -[link](http://domain.tld)-->test -``` - -Will consider `http://domain.tld)-->test` as URL. - -Instead, add an additional space. - -``` -[link](http://domain.tld) -->test -``` - -> Won't fix because a `)` is a valid part of an URL. +## Markdown Shaarli plugin + +Convert all your shaares description to HTML formatted Markdown. + +[Read more about Markdown syntax](http://daringfireball.net/projects/markdown/syntax). + +Markdown processing is done with [Parsedown library](https://github.com/erusev/parsedown). + +### Installation + +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 +``` + +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.php` +(`ENABLED_PLUGINS` array). + +This should look like: + +``` +$GLOBALS['config']['ENABLED_PLUGINS'] = array('qrcode', 'any_other_plugin', 'markdown') +``` + +### No Markdown tag + +If the tag `.nomarkdown` is set for a shaare, it won't be converted to Markdown syntax. + +> Note: it's a private tag (leading dot), so it won't be displayed to visitors. + +### Known issue + +#### Redirector + +If you're using a redirector, you *need* to add a space after a link, +otherwise the rest of the line will be `urlencode`. + +``` +[link](http://domain.tld)-->test +``` + +Will consider `http://domain.tld)-->test` as URL. + +Instead, add an additional space. + +``` +[link](http://domain.tld) -->test +``` + +> Won't fix because a `)` is a valid part of an URL.