Change Linebreak Markup Proposal

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 . It is not the current version, and thus it cannot be edited.
[Back to current version]   [Restore this version]

There was a proposal on Talk.Line breaks to change the line break markup from the "blog-like" one to the "wiki-like" approach.

Change now part of official Creole 0.4 proposal.

Unofficial poll can be seen at: Vote for Line Breaks

---

Blog-like line breaks#

Single line breaks in a paragraph, except for the last one, are converted into a <br> (or equivalent). Double line breaks mark the end of the paragraph. Nobody knows what triple (and more) line breaks do. Line breaks in lists are forbidden except for the end of list items, where they are ignored. Line breaks in tables end rows. Line breaks in preformatted blocks are copied as line breaks. To include a line break in a table cell, use separate markup (like \\). Single line break after a horizontal line, a heading or a placeholder is ignored.

Advantages#

• Easy to format text exactly the way one likes,
• easy to covey a sense of unique style,
• all other markup becomes optional, no need to learn it,
• Microsoft® Word™ does something that has a similar visual effect.

Disadvantages#

• Rarely needed with proper writing style:

for poems, for addresses, for code.

• Complicated to implement:

hard to detect when an user means <br> and when </p>, special cases for ignoring newlines at the beginning or end of blocks like <pre>.

• No way to have only one way for introducing <br>, because tables will need separate markup,
• impossible to convert automatically into wiki-style markup,
• wikis using this will be walled from all other wikis,
• copied text requires reformatting:

when copying from the wiki using this, when copying from e-mails, documents, etc. into a wiki using this.

• Possible clash with browser's automatic line wrapping, when the browser's window is too narrow,
• suggests (encourages) using <br> for layout,
• not used in existing wiki engines,
• not liked by existing wiki community (with exceptions),
• takes the control of page layout and spacing settings from the web designer,
• makes the user responsible for spacing and page layout,
• makes wiki less accessible for handicapped people,
• makes pages look inconsistent where several users contributed,
• line breaks are be hard to spot in wrapped text in narrow text areas,
• text editors often do automated line wrapping by default, inserting additional line breaks at wrap points, without the user noticing,
• users often wrap long lines unconsciously when the cursor reaches the edge of text area, even when they don't mean to end a line,
• scanned and OCR-ed text is likely to contain additional line breaks,
• e-mail and news posts contain additional line breaks,
• not even all blogs use this style,
• the blog-style cannot coexist with most wikis' native wiki-style, so mixed-mode is ruled out,
• existing wiki community uses wiki-style already, it will be harder for them to accept Creole if it used blog-style line breaks,
• some browsers still don't have support for wrapping text in text areas, the feature is not covered by standards,
• there is no way to patch all the browsers to play along with Creole,
• the markup has to be explained too, and it's harder to explain markup using no visible characters,
• it discourages use (and learning) of any other markup,
• makes users confuse line breaks with paragraph ends.

Wiki-like line breaks#

Single line breaks are treated as spaces everywhere except preformatted blocks. Double (or more) line breaks end paragraphs. In tables, a line break ends a row. To force a line break, use separate markup (like \\).

Advantages#

• Already in use in practically all wikis,
• comfortable for copywriters who can use them to structure the source,
• immune to all weird things that happen when using suspicious editors or text processors (like Microsoft® Notepad™ or Microsoft® Word™),
• doesn't require a modern browser with line wrapping in text area,
• can be easily converted to blog-style new lines when needed,
• leave the web designer in control of spacing and layout,
• makes it easy to change the layout without editing every page in a wiki,
• doesn't require the user to be experienced in typography or arts,
• allows the user to just type, without worrying how good the text looks,
• makes it easier to handle complicated things, like long urls or complicated plugins, by allowing to put them alone on a line,
• makes the source text easier to scan and find relevant fragments,
• keeps the paragraphs and line breaks as separate ideas,
• allows posting text with wrapped lines without the need of additional reformatting,
• makes users familiar with world-wide standards.

Disadvantages

• Requires a change in the Creole specification,
• requires enclosing pasted code, ascii-art, poems and addresses into additional markup (or using forced line break),
• users can try to use end-of-paragraph for overriding page layout,
• users have limited the way of expressing the unique style of their contributed text,
• web designer cannot leave it for the users to decide on the spacing,
• users need to learn the markup for the elements they want to use, instead of approximating them with line breaks and indentation,
• users can be surprised with the effect if they create their first wiki page without ever looking at and editing existing wiki pages,
• spam looks like spam,
• tables and preformatted blocks create an exception (but that's what they are for),
• list markup spec requires amending to make the line break treatment consistent,
• it removes one way of marking a pause in text, forcing the users to use both paragraphs and horizontal lines for that purpose.