Encyclopedia > Wikipedia:Use line breaks

  Article Content

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:

  • If you want to indent a paragraph that includes single line breaks, you first have to remove them.
  • If you want to make a list item out of a paragraph that includes single line breaks, you first have to remove them.
  • If you want to turn a phrase that contains a line break into a link, or format it in bold or italics, you have to remove the line break first.
  • Many readers expect line breaks only where there is a logical, semantic break. Line breaks in source text will make them pause and search for such a break, and be frustrated when there is none. Consider this example:

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.

  • Text is no longer wrapped at the window edge of the text entry area, but where the author chose to make the linebreak. Thus, there will be a lot of whitespace within a paragraph, which may be considered a waste of space and visually distracting.
  • The appearance of the article source text becomes different from the appearance of the rendered output, it therefore becomes harder to find a sentence of the rendered output in the source text. Since writers often think in terms of paragraphs, it makes sense to organise the text that way.
  • Single line breaks in source texts may confuse new editors, who may think they are there for a special reason, and avoid editing these paragraphs because they fear to break something.

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 (/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.



All Wikipedia text is available under the terms of the GNU Free Documentation License

 
  Search Encyclopedia

Search over one million articles, find something about almost anything!
 
 
  
  Featured Article
Father Damien

... the disease, from which he died at the colony. He is the patron of lepers and outcasts, and was recently made the patron of AIDS patients. The world's only ...

 
 
 
This page was created in 35.8 ms