Talk.Headings

This is version 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 . It is not the current version, and thus it cannot be edited.
[Back to current version]   [Restore this version]

BrionVibber noted at the WMS Workshop that Wikipedia starts its headings with two equals signs because the page title itself is considered as the top level heading. I find this a useful assumption. Our LaTex converter for JSPWiki makes the same assumption, combining different Wikipages as chapters using the page titles.

It would also cleanly stand out of the text. Just to compare the two aproaches...

= Heading
- listelem 1
- listelem 2
- listelem 3

== Heading
- listelem 1
- listelem 2
- listelem 3

On the other hand, with one heading at the beginning it would be faster to type. Also the headings usually stand out cleanly in the text anyway because you create a new paragraph for them. I don't know how that is going with the rule of consistency. The rule could go something like this:

• all static elements that do not resize with incresing number or characters like bold, italic, links etc have always two characters
• all dynamic elements that resize with incresing number of charaters like headings and lists always start with one character.

-- Christoph 28-Aug-06

Does the proposal mean carriage return followed by the Heading characters in the first column of the new line? or will we be more tolerant than that? MarkGaved 30-Aug-06

You mean something like this?

                                 == I like to center with spaces

-- RadomirDopieralski 2006-08-30

Don't forget that it can also be the first characters on the page, in which case there is no carriage return in front of them. Just to be complete ;-)

-- JanneJalkanen, 2006-08-31

I believe we should also allow equal signs at the end of a header for those coming from MediaWiki and similar engines. -- ChuckSmith

I'm a little concerned about the additional cognitive overhead of remembering 2 equals (=) characters as Heading 1 ... I like one equals character means "Heading 1", 2 means Heading 2, 3 means Heading 3 etc. Though I suppose it works as 2 asterisks means bold, and 2 means italic... Maybe if we decide the top level heading is to have 2 equals symbols we change the naming to Heading, SubHeading, Sub-SubHeading?

so rather than

== Heading 1
=== Heading 2
==== Heading 3

we have

== Main Heading
=== Sub Heading
==== Sub Sub Heading

MarkGaved 02-Sept-06 It's just names, and I think it's up to the wiki that adopts the markup to choose the terminology. However, consider this:

======= Sub Sub Sub Sub Sub Heading

Of course, more descriptive names can be always used:

== Title
=== Chapter
==== Section
===== Sub Section
====== Sub Sub Section
======= Paragraph

But I suggest to stick to well-known and unambigous names for now. Since the markup is going to be converted into HTML, I think it's reasonable to use the HTML terms.

-- RadomirDopieralski, 2006-09-02

I think the page should clearly say whether we expect these to nest or not.

== [[link]]

Yes or no? Personally, I'd like to think that they do not nest, because I think it is bad style to place links in headings, or switch heading style using additional markup. We could at least be explicit about not deciding and say that it is implementation-dependent.

I was also surprised to see that now more levels are supported instead of what it said a few days ago. These changes might seem small, and I might be guilty of extending the recommendation in some places as well, but for a process that needs to gather support in code, this is frustrating. Do we need stronger gatekeeping? Do we need a 0.1 out so that we can put such changes in a 0.2?

I guess the reason I noticed was that I thought the limitation to three levels was a good thing. It would seem to me that a wiki page with more than two levels is already bad style. But six? The mind boggles.

-- AlexSchroeder

There is a discrepancy between the AllMarkup and Headings pages. On AllMarkup it says:

== Level 1 (Largest) ==
=== Level 2 ===
==== Level 3 ====

On the Headings page it says:

== Level 2 (largest) ==
=== Level 3 ===
==== Level 4 ====
===== Level 5 =====
====== Level 6 ======

Shall I just fix it?

-- MartinBudden

Heading Level 1 should be allowed#

= Level 1 =

has beed excluded. As far as I know, no other wiki excludes level 1 headings, so why is Creole different? Even MediaWiki allows level 1 headings: there is a convention that they are never used, because the same style is used for the page title, nevertheless they are allowed. If a wiki site wants, by convention, to disallow level 1 headings then that is fine, however this should be a matter of editorial policy for the wiki site and not something that is mandated by Creole.

-- MartinBudden, 2006-11-16

Can you point us to a link where you read about this convention?

-- ChristophSauer, 2006-11-16

See: http://meta.wikimedia.org/wiki/Help:Editing#Most_frequent_wiki_markup_explained under the "Section headings" cell in the table. In particular the statement: "Start with 2 equals signs not 1 because 1 creates H1 tags which should be reserved for page title."

-- MartinBudden, 2006-11-16

The question "Why does Creole exclude level 1 headings?" still has not been answered.

-- MartinBudden, 2006-12-06

I personally don't see why anyone would want to have level 1 headings if the title of a page is already level 1. Do you have a good reason to allow them?

-- ChuckSmith, 2006-12-06