DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:header3

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
plugin:header3 [2015-03-21 11:30]
37.200.79.20
plugin:header3 [2019-08-20 14:50]
Aleksandr
Line 1: Line 1:
-====== ​header3 ​Plugin ======+====== ​Header3 ​Plugin ======
  
 ---- plugin ---- ---- plugin ----
-description:​ Allows markup syntax in the header and keeps your linebreaks like you entered them in the editscreen.+description:​ Allows markup syntax in the header and keeps your linebreaks like you entered them in the editscreen
 author ​    : Max Westen ​ author ​    : Max Westen ​
 email      : max@dlmax.org ​ email      : max@dlmax.org ​
 type       : syntax, renderer type       : syntax, renderer
 lastupdate : 2013-02-04 lastupdate : 2013-02-04
-compatible : adora belle+compatible : Adora Belle
 depends ​   :  depends ​   : 
-conflicts ​ : include +conflicts ​ : include, tcycle 
-similar ​   : header2, xbr, linebreak+similar ​   : header2, xbr, linebreak, wikiformatstyling
 tags       : syntax, headings, typography tags       : syntax, headings, typography
  
-downloadurl: ​http://​github.com/​mwesten/​dokuwiki-plugin-header3/​zipball/​master +downloadurl: ​https://​github.com/​mwesten/​dokuwiki-plugin-header3/​zipball/​master 
-bugtracker : http://​github.com/​mwesten/​dokuwiki-plugin-header3/​issues +bugtracker : https://​github.com/​mwesten/​dokuwiki-plugin-header3/​issues 
-sourcerepo : http://​github.com/​mwesten/​dokuwiki-plugin-header3/​+sourcerepo : https://​github.com/​mwesten/​dokuwiki-plugin-header3/​
 donationurl: ​ donationurl: ​
 ---- ----
 +
 +:!: **This plugin (and [[plugin:​header2|the plugin Header2]]) 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.
  
 ===== Description ===== ===== Description =====
 +
 This plugin enables the preservation of line breaks from the raw wiki text through to the html output and allows links and other markup in headers/​headlines. This plugin enables the preservation of line breaks from the raw wiki text through to the html output and allows links and other markup in headers/​headlines.
  
 Note, the plugin does not preserve multiple consecutive line breaks, but it will preserve single line breaks. Note, the plugin does not preserve multiple consecutive line breaks, but it will preserve single line breaks.
- 
- 
  
 ===== Installation and Usage ===== ===== Installation and Usage =====
  
-Download ​and install the plugin using the [[plugin:plugin|Plugin ​Manager]] ​using the URL given above. Refer to [[:​Plugins]] on how to install plugins manually.+Search ​and install the plugin using the [[plugin:extension|Extension ​Manager]]. Refer to [[:​Plugins]] on how to install plugins manually.
  
-After installation,​ **set '​renderer_xhtml'​ to "​Header3"​ in the configuration manager**.+:!: After installation,​ **set '[[config:renderer_xhtml]]' to "​Header3"​ in the configuration manager.**
  
 :!: 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) :!: 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)
Line 50: Line 51:
   [[:​start|Start]]   [[:​start|Start]]
  
-This is due to a problem in the core metadata renderer in and before //​dokuwiki-2010-11-07a “Anteater”//,​ which is already reported [[dokubug>​2144|here]].+This is due to a problem in the core metadata renderer in and before //​dokuwiki-2010-11-07a “Anteater”//,​ which is already reported [[bug>​2144|here]].
  
-==== Conflict ​====+==== Conflicts ​====
  
 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 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
  
-Conflict with [[tcycle]] ​- tcycle can't show animation ​without ​pauses+Conflict with [[tcycle]] ​because of Header3's renderer include br-tags between pairs of a-tags and tCycle try to switch css display:​none/​block on it, so an animation ​would have a pauses, equals to measures, choosed in tCycle syntax options.
  
-==== How to make it work with DokuWiki's (2014-09-29a "​Hrun"​====+==== How to make it work with DokuWiki ​version ​2014-09-29a "​Hrun" ​and above ====
  
 I've found one provisional solution that worked for me! - //Guenther, Oct. 10th, 2014// I've found one provisional solution that worked for me! - //Guenther, Oct. 10th, 2014//
  
-Change in DokuWiki'​s ​(2014-09-29a "​Hrun"​) ​XHTML-Renderer /​inc/​parser/​xhtml.php some methods from '​protected'​ to '​public':​+Change in DokuWiki'​s XHTML-Renderer /​inc/​parser/​xhtml.php some methods from '​protected'​ to '​public':​
  
 Line 30: protected $sectionedits = array();\\ Line 30: protected $sectionedits = array();\\
Line 73: Line 74:
 change to: public $node = array(0, 0, 0, 0, 0); change to: public $node = array(0, 0, 0, 0, 0);
  
 +**PS**. [[plugin:​xbr]] preserves (though only single) linebreaks; use it instead.
plugin/header3.txt · Last modified: 2019-08-20 14:50 by Aleksandr