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? -- AlexSchroeder