wiki:NumberedHeadlinesPlugin

Version 10 (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 two options can be added to select if headlines in outlines (PageOutline, TocMacro) should be numbered and if CSS should be used for the numbering. (Default values are shown)

[numberedheadlines]
numbered_outline      = true
use_css_for_numbering = true

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)