Add Formatting

In federated wiki we try to use a minimum of formatting. We're especially allergic to page formatting conventions associated with the printed-on-paper pages or the wide-screen-box-model associated with advertising optimized sites.

We have, however, noticed the need for a modest amount of emphasis to enhance the structure of even the small pages of our wiki. Here we describe using the html plugin. Similar capabilities are available through markdown.

Formatting Headings

We've found that <h3> headings look good on our small pages. We've found that in most cases (but not all) it is not necessary to match this with a closing </h3> tag.

We recommend confining headings to their own paragraphs. This will make it easy to move content in and out of sections using federated wiki's drag-and-drop refactoring.

Formatting Bullet Lists

We've found that bullet lists look best if they are all at a single level and that level is left justified with no indention.

Create a bullet list by adding <li> tags in front of each item. Experience shows that the lists look better if they are all in one paragraph but this breaks the drag-and-drop refactoring.

We're drifting away from the use of bullet lists. We make short paragraphs with single links to elaborating pages the norm for things that would normally appear in a list.

Formatting Italic and Bold

We're using the <i> and <b> tags to identify text that should be italic or bold. Here we need the closing tag to each span.

Before you add italic or bold, ask yourself, is this phrase properly a new paragraph? Or is this item so important that it should be its own page?

Formatting Math

Mathematical expressions look beautiful in LaTeX rendered by MathJax . Create a MathJax paragraph by selecting MathJax in the factory menu that appears after pressing the [+] button to create a new paragraph.

Within a MathJax paragraph LaTeX notation is enclosed within escaped parenthesis or escaped square-brackets. Both the left and right parenthesis or bracket must be escaped with a backslash.

Use escaped parenthesis to enclose mathematical expressions that should appear inline within the text of the paragraph.

Use escaped square-brackets to enclose mathematical expressions that should appear on their own line. If there is introductory explanation of the expression, it is customary to include it within the same wiki paragraph as the expression.