~ Office Supplies ~~ Buy Posters ~~ A-Z Products ~~ Website Advertising


Wikipedia:Use line breaks - Wikipedia

<<Up     Contents

Wikipedia:Use line breaks

This rule is no longer considered a rule, in fact it is considered by most to be a bad thing. See the talk page for more information.

If you add two line breaks (by pressing return twice) to the source text, Wikipedia will create a new paragraph. It is uncontroversial that paragraphs should be used to make articles easy to read. This page, however, refers to single line breaks within article source texts.

Single line breaks in the source text are not translated to single line breaks in the output. If you want a single line break to appear in the rendered article, use a <br> tag. However, single line breaks in the source do have certain effects: Within a list, a single line break either starts the next item or a new paragraph; within an indentation, a single line break aborts the indentation and starts a new paragraph. Formatting instructions for bold and italics as well als links do not span line breaks. (This is intentional, so that authors do not accidentally turn an entire paragraph into a link etc.)

Regardless, some Wikipedians insert single line breaks into the source text of articles for various reasons, others oppose this practice. Readers do not need to care about this controversy since it does not affect the appearance of articles. The two positions are presented below, see the discussion page for the current head count for each position.

Don't use single line breaks

One of Wikipedia's rules to consider:

Don't use manually-entered hard line breaks within paragraphs when editing articles. Reasons for this include:

The consequences of this Amendment to American society have been profound. First Amendment questions have been raised with regard to the separation
of church and state; civil rights issues; pornography and obscenity; political speech and organizations; journalism and its restrictions; involuntary commitment laws; and many more.

Proponents of line breaks within paragraphs claim that they make diffs (the reports showing the differences between two revisions of an article) easier to read. The diff feture highlights the changes within each line break delimited block of text, and provides unchanged text for additional context up to the third line break below and above that text. This usually means that it highlights the entire paragraph, and also shows one paragraph above and below it for context. The changed characters are separately highlighted from the changed blocks in red color.

It is hard to see how individual line breaks help in any way in that comparison, since their only effect will be to reduce the amount of context provided when a line is changed. In fact, arbitrarily entered line breaks prevent the software from working correctly, as this diff (http://www.wikipedia.org/w/wiki.phtml?title=Ambrose_the_poet&diff=106339&oldid=40753) illustrates nicely: instead of providing the context of a full paragraph, it only shows changes in individual lines of text, respecting not even sentence boundaries.

One undeniable advantage of line breaks within paragraphs is that many Unix editors, including the venerable emacs, do not handle long lines well -- they can either wrap characters at the screen boundary, wrap words at a fixed length, or not wrap at all. However, by this logic, line breaks would have to be entered at a fixed width, such as 80 characters, something which most proponents of the "use single line breaks" rule do not want and which, as seen above, completely breaks the diff context feature. Just inserting line breaks into some paragraphs will not make them easier to edit with these tools. Arguably, those who use editors which cannot handle long lines properly should just get better ones; Microsoft Notepad, for example, has had this functionality since its very first version, and vi supports it with the "set lbr" option.

Use single line breaks

One of Wikipedia's rules to consider:

Use frequent manually-entered hard line breaks within paragraphs when editing articles, at least at the end of every sentence, but also in arbitrary places.

Manually entered hard line breaks arguably make the article much easier to edit when the lines of input text are short (to clarify, the input text is what you see in the text box of the page editing form; the displayed text is what is shown to the reader).

One benefit is that it makes diffs smaller and (arguably) easier to read. Also, if there's a line break at least at the end of every sentence, it makes it easier to locate, rearrange, or modify sentences within a long paragraph. Since writers often think in terms of sentences, it makes sense to organize the text that way. This section of the article, for instance, is broken into multiple lines.

There are a few exceptions: The current Wikipedia software will not allow line breaks within

list elements (using "*" or "#") or text using ":" for indentation:

This is an example of an indented paragraph. The second sentence must stay on the same line with the first, or it will not be indented properly.

wikipedia.org dumped 2003-03-17 with terodump




 
 
158 carats gray AGATE gem Polished slab rectangle block Cabbing cab cabochon rough gemstone 31 grams
 158 carats gray AGATE Polished slab rectangle block Cabbing cab cabochon 31 grams 
 
30 gram picture MOONSTONE feldspar orthoclase gem Cab cabochon raw rough jewelry gemstone 154 carat
 30 gram picture MOONSTONE feldspar orthoclase Cab cabochon raw jewelry 154 carat 
 
15 carats yellow Oregon SUNSTONE gem stones Semi Facet cabbing rough gemstones lot Faceting jewels
 15 carats yellow Oregon SUNSTONE Semi cabbing lot ing jewels 
 
Red green AMMOLITE gem stone Freeform cabochon cabbing jewelry rough Ammonite opal 10 carats 2 grams
 Red green AMMOLITE Freeform cabochon cabbing jewelry Ammonite opal 10 carats 2 grams 
 
22 carat green new jade Serpentine rough gemstone tumble polished nugget drilled necklace bead Nice
 22 carat green new jade Serpentine tumble polished nugget drilled necklace bead Nice