plugin:numberedheadings
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
plugin:numberedheadings [2019-01-02 03:49] – new lease, plugin adopted s.sahara | plugin:numberedheadings [2023-09-13 08:34] (current) – update version s-sahara | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== | + | ====== Numbered Headings |
---- plugin ---- | ---- plugin ---- | ||
Line 6: | Line 6: | ||
email : sahara.satoshi@gmail.com | email : sahara.satoshi@gmail.com | ||
type : syntax | type : syntax | ||
- | lastupdate : 2019-01-02 | + | lastupdate : 2023-09-12 |
- | compatible : 2013-06-03, 2009-12-25, 2014-09-29 " | + | compatible : 2018-04-22, 2020-07-29, 2022-08-02, 2023-04-04 |
depends | depends | ||
conflicts | conflicts | ||
Line 27: | Line 27: | ||
===== Usage ===== | ===== Usage ===== | ||
- | To use this plugin just add a ' | + | Adding |
====== - Level 1 Headline ====== | ====== - Level 1 Headline ====== | ||
===== - Level 2 Headline ===== | ===== - Level 2 Headline ===== | ||
+ | ==== -#5 Level 3 Headline ==== | ||
==== - Level 3 Headline ==== | ==== - Level 3 Headline ==== | ||
+ | ===== -#7 Level 2 Headline ===== | ||
==== - Level 3 Headline ==== | ==== - Level 3 Headline ==== | ||
- | ===== - Level 2 Headline ===== | ||
- | ==== - Level 3 Headline ==== | ||
- | ... | ||
- | The output should then look like this: | ||
- | 1. Level 1 Headline | ||
- | 1.1 Level 2 Headline | ||
- | 1.1.1 Level 3 Headline | ||
- | 1.1.2 Level 3 Headline | ||
- | 1.2 Level 2 Headline | ||
- | 1.2.1 Level 3 Headline | ||
- | ... | ||
+ | When the config **tier1** is set to 2, the headings are interpreted as if you have written: | ||
+ | ====== Level 1 Headline ====== | ||
+ | ===== 1. Level 2 Headline ===== | ||
+ | ==== 1.5 Level 3 Headline ==== | ||
+ | ==== 1.6 Level 3 Headline ==== | ||
+ | ===== 7. Level 2 Headline ===== | ||
+ | ==== 7.1 Level 3 Headline ==== | ||
+ | | ||
+ | === Experimental: | ||
+ | Character variables can be incremented in PHP, like A0, A1, A2 ... You can use '' | ||
- | The user can also set the outline level with the following markup (Thanks to [[martin@idea-games.com|Martin Klima]]): | + | ==== -" |
+ | === - headline === | ||
- | === - #< | ||
- | For example: | + | ===== Configuration ===== |
- | ====== - #3 Level 1 Headline ====== | + | The plugin can be configured within the DokuWiki configuration manager available through the admin menu. |
- | ===== - Level 2 Headline ===== | + | |
- | will be rendered | + | ^ tier1 | heading level corresponding to the 1st tier | default = **2**((As I use a sidebar-index showing the first heading instead of the filename, I configured the plugin to start with the numbered headings from **H2** on. Otherwise the numbers would be shown in the index... but feel free to change the level to **1**.)) | |
+ | ^ format | ||
+ | ^ fancy | styled heading numbers | default = **off** | | ||
- | 3 Level 1 Headline | + | ==== Auto-Detect first-tier level ==== |
- | 3.1 Level 2 Headline | + | |
+ | When the config **tier1** is '' | ||
- | ===== Configuration ===== | + | ==== Numbering format |
- | The plugin can be configured within | + | The config **format** defines tiered numbering style. Each tier format is the formatting string of [[phpfn> |
+ | Some format examples:< | ||
+ | [" | ||
+ | [" | ||
+ | [" | ||
+ | </ | ||
- | ^ startlevel | level to start with numbered headings | default | + | ==== Control numbering feature ==== |
- | ^ tailingdot | show tailing dot after numbers (e.g. 1.2.) | default | + | |
- | The example above generates the following output when '' | + | The numbered headings that are prefixed with "'' |
- | | + | < |
- | 1. Level 2 Headline | + | assume config tier1 is set to 0 |
- | 1.1. Level 3 Headline | + | === --#1000 [" |
- | 1.2. Level 3 Headline | + | === - item 1 === → (1001) item 1 |
- | 2. Level 2 Headline | + | === -- === ... initialize tier1, format, headings counter |
- | 2.1. Level 3 Headline | + | ==== - item 2 ==== → 1. item 2 |
- | ... | + | </ |
- | You can also override the startlevel | + | You can also override the first-tier level in a per-page basis. Just insert this code to your page: |
< | < | ||
~~HEADLINE NUMBERING FIRST LEVEL = n~~ | ~~HEADLINE NUMBERING FIRST LEVEL = n~~ | ||
- | {{startlevel> | ||
</ | </ | ||
Where '' | Where '' | ||
- | |||
- | |||
- | |||
Line 96: | Line 99: | ||
Since 2019-01-02, the plugin code has moved to github repository to provide better accessibility for install and further development opportunity. Thanks Lars J. Metz for your early work and encouraging me to move the code to github. | Since 2019-01-02, the plugin code has moved to github repository to provide better accessibility for install and further development opportunity. Thanks Lars J. Metz for your early work and encouraging me to move the code to github. | ||
- | |||
Line 104: | Line 106: | ||
- | === Revision List === | + | === Old Revision List === |
* 2006-08-25 --- Published Plugin | * 2006-08-25 --- Published Plugin | ||
Line 111: | Line 113: | ||
* 2010-05-12 --- Brought '' | * 2010-05-12 --- Brought '' | ||
* 2019-01-02 --- Added new macro to set startlevel in a page | * 2019-01-02 --- Added new macro to set startlevel in a page | ||
+ | * 2019-01-03 --- Allow css for tiered numbers in headings | ||
- | ===== Discussion | + | ===== Tips ===== |
- | Feel free to make any comments regarding my plugin... or write me an email ([[dokuwiki@meistermetz.de|Lars J. Metz]]). | + | For your information: |
- | This is so basic, it should be in the basic installation of DokuWiki IMHO... diftong@gmx.net | + | ---- |
- | Would be good to bring the start level out to configuration. | ||
- | > Done. --- // | + | ===== Old Discussion ===== |
- | + | ||
- | ---- | + | |
Could a similar system be used to format the numbered lists in nested decimal style instead of the crazy roman numerals and stuff? Better with just changing the css maybe? If so any ideas how best to do that? Armin. | Could a similar system be used to format the numbered lists in nested decimal style instead of the crazy roman numerals and stuff? Better with just changing the css maybe? If so any ideas how best to do that? Armin. | ||
---- | ---- | ||
- | |||
Great thing, just what I was looking for, there is just one issue in combination with page-includes ([[plugin: | Great thing, just what I was looking for, there is just one issue in combination with page-includes ([[plugin: | ||
Line 145: | Line 144: | ||
---- | ---- | ||
- | For your information: | + | Seems like the changes in Rincewind metadata handling means that the numbering sometimes doesn' |
---- | ---- | ||
- | ** Per page start level ** | + | ==== Per page start level ==== |
I've just merged the code for adding the ability to set the startlevel in a per-page basis. Just added the first line of '' | I've just merged the code for adding the ability to set the startlevel in a per-page basis. Just added the first line of '' | ||
- | + | Also, added the instructions for using. --- // | |
- | Also, added the instructions for using. | + | |
- | + | ||
- | --- // | + | |
> Thanks | > Thanks | ||
---- | ---- | ||
+ | |||
+ | ==== Set outline level for each heading ==== | ||
I have added the ability for the user to set the outline level with the following markup: | I have added the ability for the user to set the outline level with the following markup: | ||
Line 180: | Line 178: | ||
---- | ---- | ||
+ | |||
+ | ==== Css for heading numbers ==== | ||
+ | |||
+ | **Fantastic plugin!** I was wondering if anyone knows what I would need to modify to add tags like < | ||
+ | |||
+ | I have tried messing with the code myself, but any html I add shows as text, and not interpreted as real html code. Could anyone figure this out? - // [[kououken@gmail.com|kououken]] 2012/02/07 14:32 // | ||
+ | |||
+ | ---- | ||
+ | ===== Suggestion / Request ===== | ||
+ | |||
+ | > **Great plugin** | ||
+ | > - Include an option by wiki, to do this automatically (without the hyphens) for all pages | ||
+ | > - Disable option by page, when enabled at wiki level | ||
+ | > - Enable the option by page by a setting at the top of the page | ||
+ | > | ||
+ | > Thanks! | ||
+ | |||
+ | I just developed this feature for my own needs. The code is available from [[https:// | ||
+ | * an option to enable numbering by default on every page | ||
+ | * the possibility to use ''< | ||
+ | |||
+ | |||
+ | ==== Start pages with sub level ==== | ||
+ | |||
+ | I would like to break up longer pages into subpages. These new pages then should to start numbering at a sub level. | ||
+ | |||
+ | For example: | ||
+ | |||
+ | ====== - #3.1 Level 1 Headline ====== | ||
+ | ===== - Level 2 Headline ===== | ||
+ | |||
+ | should be rendered as: | ||
+ | |||
+ | 3.1 Level 1 Headline | ||
+ | 3.1.1 Level 2 Headline | ||
+ | |||
+ | What changes to '' | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ==== More flexible numbering ==== | ||
Some modification. For example: | Some modification. For example: | ||
Line 218: | Line 257: | ||
--- // | --- // | ||
- | ---- | ||
- | Seems like the changes in Rincewind metadata handling means that the numbering sometimes doesn' | ||
- | |||
- | ---- | ||
- | |||
- | **Fantastic plugin!** I was wondering if anyone knows what I would need to modify to add tags like < | ||
- | |||
- | I have tried messing with the code myself, but any html I add shows as text, and not interpreted as real html code. Could anyone figure this out? - // [[kououken@gmail.com|kououken]] 2012/02/07 14:32 // | ||
- | |||
- | ---- | ||
- | ===== Suggestion / Request ===== | ||
- | > **Great plugin** | ||
- | > - Include an option by wiki, to do this automatically (without the hyphens) for all pages | ||
- | > - Disable option by page, when enabled at wiki level | ||
- | > - Enable the option by page by a setting at the top of the page | ||
- | > | ||
- | > Thanks! | ||
- | |||
- | I just developed this feature for my own needs. The code is available for download [[https:// | ||
- | * an option to enable numbering by default on every page | ||
- | * the possibility to use ''< | ||
- | |||
- | ===== Frusterick Manners: frustrating problem ===== | ||
- | It is so nice, but: | ||
- | |||
- | Warning: Declaration of syntax_plugin_numberedheadings:: | ||
- | |||
- | Warning: Declaration of syntax_plugin_numberedheadings:: | ||
- | |||
- | Warning: Cannot modify header information - headers already sent by (output started at / | ||
- | |||
- | Warning: Cannot modify header information - headers already sent by (output started at / | ||
- | |||
- | Only with the downloaded version are these problems, the version of the syntax.php shown here seems to be updated and ok: | ||
- | Doku_Handler $handler; | ||
- | Doku_Renderer $renderer; are the trouble preventers. | ||
- | |||
- | ===== Start pages with sub level ===== | ||
- | |||
- | I would like to break up longer pages into subpages. These new pages then should to start numbering at a sub level. | ||
- | |||
- | For example: | ||
- | |||
- | ====== - #3.1 Level 1 Headline ====== | ||
- | ===== - Level 2 Headline ===== | ||
- | |||
- | should be rendered as: | ||
- | |||
- | 3.1 Level 1 Headline | ||
- | 3.1.1 Level 2 Headline | ||
- | |||
- | What changes to '' |
plugin/numberedheadings.1546397361.txt.gz · Last modified: 2019-01-02 03:49 by s.sahara