markdown

NP_Markdown

This plugin will give you the option to format your items using the Markdown Syntax using PHP Markdown class of Miche Fortin. The philosophy of original Markdown is to be as easy-to-read and easy-to-write and his syntax allows you to write text naturally and format it without using HTML tags. In Markdown documents you can mix HTML tags and Markdown Syntax easly, so you can use all the HTML tags not covered by the syntax of the program. (Isnspired by Lonnie Olson’s NP_Textile.)

General Plugin info
Author: Roberto "rbnet" Bolli
Current Version: NP_Markdown V 0.5.1
Download: download in zip, rar or tar.gz formats
Demo: see items on http://www.rbnet.it/blog/
Forum Thread: http://forum.nucleuscms.org/viewtopic.php?t=8548

see also NP_MarkdownViewer for extra options

Installing

  1. Download the archive, then untar and copy the NP_Markdown files and directory in your plugin directory;
  2. Download markdown.php (and smartypants.php if you want extra characters replacement, but is optional) from michelf.com site and copy to /path/to/nucleus/plugins/markdown/ directory; you can use PHP Markdown Extra too.
  3. Install the plugin;
  4. Set the plugin option;
  5. Check the Markdown box under Extra Plugin Options on your Add/Edit Item form.

How to use the plugin

The plugin is multilanguage (english and italian for now): during installation it stores its option in the DB, using the default language of the Nucleus Installation. The only option available is for setting the default behavior for new items to use or not the NP_Markdown plugin.

The plugin will parse the content item on-the-fly: the content of your item will be stored unparsed in DB. Your old item will be leaved untouched, and their contents will continue to be visible in normal way without the need to be converted in the Markdown Syntax.

When you add an item you’ll note a checkbox in the Extra Item Option section. When checkbox is selected your item will be parsed by NP_Markdown, when unchecked your item wil be parsed by the Nucleus Core.

Tips

For the Markdown Syntax, the SmartyPants functions and feautures/bugs of this system see these sites:

Try the syntax online:

History

  • V 0.5.1 (bug fix)
  • V 0.5 (first public release)

Roberto “rbnet” Bolli
rbnet.it

Plugin review

NP_Markdown version 0.5.1 works with Nucleus CMS version 3.31 - 2007-11-15 kg

 
markdown.txt · Last modified: 2007/12/08 17:21 by kg