joseym/li3_markdown

Lithium PHP Markdown parser

dev-master 2012-05-26 02:24 UTC

Requires

• php: >=5.3
• joseym/li3_installer: master

GNU General Public License

• Josey Morton

• markdown
• lithium
• li3

README

Lithium library for parsing markdown, uses PHP Markdown Extra.

PHP Markdown Extra version: 1.2.4

Installation

Use Composer

Best Option

Modify your projects composer.json file

{
    "require": {
    	...
        "joseym/li3_markdown": "master"
        ...
    }
}

Run php composer.phar install (or php composer.phar update) and, aside from adding it to your Libraries, you should be good to go.

Submodule or Clone

Select one of the following

Clone/Download the plugin into your app's libraries directory.

Submodule

From your app directory:

git submodule add git://github.com/joseym/li3_markdown.git libraries/li3_markdown

Clone

From your app/libraries directory:

git clone git://github.com/joseym/li3_markdown.git

Usage:

To enable the library add the following line at the end of app/config/bootstrap/libraries.php:

Libraries::add('li3_markdown');

Markdown Views

To parse an entire view with markdown simply name your template something similar to:

view_name.md.php

the renderer will see that it's a markdown template and render it, otherwise it will render it like normal.

Selective Rendering

This is a helper method that allows you to selectively render text thru the markdown parser. To render the result within a template file simply call the markdown helper and run display:

<?php echo $this->markdown->display($markup) ?>

Collaborate

As always, I welcome your collaboration to make things "even more betterer", so fork and contribute if you feel the need.

Credits

• Original plugin by @sandelius