Skip to content

elemental-lf/dokuwiki-plugin-markdownextra

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

About this fork

This fork integrates some commits from all the other forks for use in my personal DokuWiki installation. Mainly it replaces Markdown Classic with Markdown Lib and also updates it to the latest version. It also updates the Meltdown editor.

Notable missing features:

  • No shortcut syntax for internal links
  • No GeSHi syntax highlighting

Regarding the syntax highlighting I think this could be implemented cleanly by using the code_block_content_func callback. The same goes for interal links by using url_filter_func. But I'm currently using the CodeMirror plugin for syntax highlighting which does the highlighting in the browser via JavaScript. I've a fork of the CodeMirror plugin which apart from a CodeMirror update contains a small jQuery tweak so that it works with this plugin. The Meltdown editor setup and the CodeMirror editor currently don't play well with each other. I've disabled the Meltdown editor in my setup.

PHP Markdown Extra plugin for DokuWiki

---- plugin ----
description: Parses PHP Markdown Extra blocks.
author     : Joonas Pulakka, Jiang Le
email      : joonas.pulakka@iki.fi, smartynaoki@gmail.com
type       : syntax
lastupdate : 2013-01-14
compatible : 2012-10-13 “Adora Belle” and newer
depends    : 
conflicts  :
similar    : markdown 
tags       : formatting, markup_language
downloadurl: 
----

##Download and Installation

Download and install the plugin using the Plugin Manager using the following URL. Refer to [[:Plugins]] on how to install plugins manually.

##Usage

If the page name ends with ''.md'' suffix, it gets automatically parsed using PHP Markdown Extra. To use that markup in other pages, the content must be embedded in a markdown block. For example:

<markdown>
Header 1
========

~~~
some code
~~~

Paragraph

Header 2
--------

- A
- simple
- list

1. And
2. numbered
3. list

Quite intuitive? *emphasis*, **strong**, etc.
</markdown>

###Front matter Front matter is a text block at the top of dokuwiki page with .md suffix. It begins and ends with '—'. Looks like this:

---
{{tag>test}}
---

Why front matter?

I love this markdown extra plugin, the best feature is .md suffix. And I love tag plugin too, but I can't use it with page with .md suffix as {{tag>tat1 tag2 tag3}} syntax will not work within . So I added this front matter feature.

For syntax, refer to http://michelf.com/projects/php-markdown/extra/

About

Parses PHP Markdown Extra blocks for dokuwiki with backlinks, header parser, toc support

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 53.8%
  • PHP 40.9%
  • CSS 5.3%