====== header2 Plugin ======

---- plugin ----
description: Allows markup syntax in the header
author     : danny0838
email      : danny0838@gmail.com
type       : syntax, renderer
lastupdate : 2016-02-02
compatible : 2013-03-06, 2012-10-13, 2012-01-25, 2011-05-25
depends    : 
conflicts  : include
similar    : wikiformatstyling
tags       : syntax, headings

downloadurl: https://github.com/danny0838/dokuwiki-plugin-header2/archive/master.zip
bugtracker : https://github.com/danny0838/dokuwiki-plugin-header2/issues
sourcerepo : https://github.com/danny0838/dokuwiki-plugin-header2/
donationurl: 

screenshot_img : 
----

:!: **This plugin (and [[plugin:header3|the plugin Header3]]) became unavailable** due to a technical reason ([[https://forum.dokuwiki.org/thread/16109|See this conversation]]).  You can consider using [[plugin:wikiformatstyling|Wiki-Style Script]] instead.

===== Installation and Usage =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

**If your DokuWiki version is before //2012-10-13 "Adora Belle"//, set 'renderer_xhtml' to "Header2" in the configuration manager after installation.** For versions since 2012-10-13, use the default xhtml renderer.

:!: The TOC is rendered by metadata renderer instead of xhtml renderer in general 'show' action. However in 'preview' mode the TOC is rendered by xhtml renderer. So in //few// situations you'll find the TOC different in preview and in show mode. (mostly it doesn't happen since metedata renderer renders 'abstract' for the article and what it does is to have all markups parsed except no html tags)

Here's the demo image for embedding syntax in the header with this plugin:

FIXME {{https://github.com/downloads/danny0838/dw-header2/header_syntax2.jpg?500|Header with syntax demo}}

===== Development =====

=== Change Log ===

{{rss>https://github.com/danny0838/dw-header2/commits/master.atom date}}

===== Discussion =====

==== Conflict ====

After activating this plugin and changing the xhtml renderer to header2 all my instances of the include plugin using "section" no longer work..the whole page is shown instead. Upon deactivating this plugin, the include works again. - Andy 2011/01/24

==== Angua RC1 bug====

Don't work with Angua RC1 (PHP Fatal Error) and can't be turned off.
You have to add 
  $plugins['header2'] = 0;
to ''conf/plugin.local.php'' to turn it off.

> It shouldn’t work with Rincewind or Anteater either. header2 tries to read a property from the xhtml renderer class which is private and always was private (a similar problem is the reason for the header2 renderer component).  --- [[user>adrianlang|Adrian Lang]] //2011/12/23 23:38//

>> This problem is fixed since 2012-10-13 “Adora Belle”, and we no more need to set the renderer to header2 in order to get this plugin work --- [[user>danny0838|danny0838]] //2013/03/17 05:35//
ake your first steps on the playground.
Draft autosaved on 2013/05/12 19:01
Media

==== tag-bug ====
when defining tags with [[tag]] containing mutated vowels (ä,ö,ü), the linked headings on this page won't show themselves after leaving the page and visiting it again. Instead the headings are shown like header2 is turned off. (Nait Sabes, 12.05.2013)