wiki:NumberedHeadlinesPlugin

Version 11 (modified by martin_s, 5 years ago) (diff)

--

Wiki syntax for numbered headlines

Description

This plug-in provides a new TracWiki syntax for numbered headlines (h1-h6 HTML tags).

New Wiki Syntax

The wiki syntax for numbered headlines is a follows:

Instead of:
== Unnumbered Headline ==
or
== Unnumbered Headline ==#ownID

write:
## Numbered Headline ##
or
## Numbered Headline ##=ownID

You can mix both unnumbered and numbered headlines on the same wiki page. Headlines from first order (1x# on each side) to sixth order (6x# on each side) are supported. An own ID can be given by adding "=idname", which should be an valid XHTML name.

Configuration

To enable this plugin put the following into your trac.ini configuration file:

[components]
tracnumberedheadlines.* = enabled

The following options can be added to select if

  • headlines in outlines (PageOutline, TocMacro) should be numbered (#4521, #5241)
  • CSS should be used for the numbering
  • numbering should start at the second level (##/h2) not at the first level (#4907)

(Default values are shown)

[numberedheadlines]
numbered_outline      = true
use_css_for_numbering = true
numbering_starts_at_level_two = false

Bugs/Feature Requests

Existing bugs and feature requests for NumberedHeadlinesPlugin are here.

If you have any issues, create a new ticket.

Download

Download the zipped source from here.

Source

You can check out NumberedHeadlinesPlugin from here using Subversion, or browse the source with Trac.

Example

The following wiki text:

= Introduction =
# Chapter 1 #
## Section 1.1 ##
### Subsection 1.1.1 ###
### Subsection 1.1.2 ###
## Section 1.2 ##
### Subsection 1.2.1 ###
=== Unnumbered ===
### Subsection 1.2.2 ###
# Chapter 2 #
## Section 2.1 ##
### SubSubsection 2.1.1 ###
#### SubSubsection 2.1.1.1 ####
##### Paragraph 2.1.1.1.1 #####
###### Subparagraph 2.1.1.1.1 ######

will be displayed like this:

Introduction

1. Chapter 1

1.1. Section 1.1

1.1.1. Subsection 1.1.1

1.1.2. Subsection 1.1.2

1.2. Section 1.2

1.2.1. Subsection 1.2.1

Unnumbered

1.2.2. Subsection 1.2.2

2. Chapter 2

2.1. Section 2.1

2.1.1. SubSubsection 2.1.1

2.1.1.1. SubSubsection 2.1.1.1

2.1.1.1.1. Paragraph 2.1.1.1.1
2.1.1.1.1. Subparagraph 2.1.1.1.1

Recent Changes

[10976] by rjollos on 2011-12-01 11:26:01
Added plugin revision info to webadmin page.
[8551] by martin_s on 2010-08-30 23:57:52
Added encoding meta-comment and declared SVN keywords as unicode to avoid issues with non-english locales.
[8427] by martin_s on 2010-08-23 13:12:08
Removed outdated variable rev from setup file.

Author/Contributors

Author: martin_s
Contributors: JoshuaH (Page Outline support, see #4521)