Help on Basic Formatting

(Show (Hide table-of-contents) table-of-contents)

This page contains basic information about MoinMin's formatting capabilities. It covers only a small amount of the formatting features but these are possibly covering about 99% of every-day problems. If you need more detailed information start with HelpOnEditing or HelpOnMoinWikiSyntax.

Basics

White space

Note that white space most of the time is ignored. This:

The   only       exception is white space at the beginning of a line.
This is not another line.

leads to this:

The only exception is white space at the beginning of a line. This is not another line. details how white space at the beginning of a line is processed see Indentation

Line breaks

Insert a line break with the <<BR>>. This:

This goes onto the first line<<BR>>This goes onto the second line.

leads to this:

This goes onto the first line
This goes onto the second line

Indentation

This:

no space
 Line 1
 Line 2
   Line 3
 Line 4

leads to this:

no space

• Line 1 Line 2
  • Line 3
  Line 4

Titles

The different levels depend on the number of "=" signs:

= level 1 =
== level 2 ==
=== level 3 ===
==== level 4 ====

Notes:

• The first "=" char must be the first character on a line.
• To the right of the very last "=" char their must not be any white space.

A word of advice: try to avoid using level 4 headers, and never use headers of level 5 and 6!

Lists

For a detailed discussion see HelpOnLists.

Numbered Lists

 1. level1-1
 1. level1-2
   1. level2-1
   1. level2-2

  Normally this interrupts and therefore restart the numbering 

 1.#3 level1-3

leads to this:

1. level1-1
2. level1-2
   1. level2-1
   2. level2-1
   • Normally this interrupts and therefore restart the numbering
3. level1-3

Bulleted Lists

 * level1-1
 * level1-2
   * level2-1
   * level2-2
 * level1-3

leads to this:

• level1-1
• level1-2
  • level2-1
  • level2-2
• level1-3

Tables

For a detailed discussion see HelpOnTables.

This:

|| '''col1''' || '''col2''' || '''col3''' ||
|| cell A1 || cell B1 || cell C1 ||
|| cell A2 || cell B2 || cell C2 ||
|| cell A2 || cell B2 || cell C2 ||

leads to this:

Notes:

• The first "|" char must be the first character on a line.
• To the right of the very last "|" char their must not be any white space.

APL Code

This:

    {⍵/⍳⍴,⍵}
    {{⍵/⍨2=+⌿0=⍵∘.|⍵}⍳⍵}

leads to what you are looking at!

Links

For a detailed discussion see HelpOnLinking.

Page names or CamelCasing or internal links

Names of pages in a wiki more often than not use CamelCasing as in the name of this page: HelpOnBasicFormatting. CamelCase names are automatically converted into links within the realm of the current wiki.

If a page name contains blanks surround them with [[ and ]]. Therefore this:

[[Page name]]

leads to this: Page name

Alternatively with an optional link text:

[[Page name | link to some page]]

leads to this: link to some page

Prevent CamelCase links

Of course sometimes you don't want certain names to be converted into links. You can achieve that by prefixing the name with a "!" as in

  !JavaScript

That leads to JavaScript

Note that a link to a non-existent page is shown in italic: ThisPageDoesNotExist

External links

This:

  http://sandbox.aplwiki.com

results in this: http://sandbox.aplwiki.com

Alternatively you can use an optional link text:

  [[http://sandbox.aplwiki.com | Link to the APL wiki sandbaox]]

results in this: Link to the APL wiki sandbaox

Links within a page

You can link to another part of a page, but only to titles. For example, on a page "MyPage" with a level 3 title "My address" you could create a link somewhere on that page with

  [[ MyPage#My address]]

which leads to MyPage#My address.

Alternatively you can use an optional link text. This:

  [[ MyPage#My address | Link to my address]]

results in Link to my address.

Links to attachments

See Attachments

Links to images

Before you start linking to an image first upload it as an attachment; click the "Attachments" button and act accordingly.

Once the image is uploaded it is, among other things, available for link purposes. Since it is always associated with a certain page you can refer to it by its simple filename. For example, a link to the file "APL-Logo.png" which is attached to this page can be created with:

  [[attachment:APL-Logo.png]]

which leads to APL-Logo.png.

Alternatively with an optional text as in:

  [[attachment:APL-Logo.png | download the APL logo ]]

which leads to link to the attachment

For how to display an image within a page (rather than linking to it) see Images.

Images

First upload the image(s) as an attachment; click the "Attachments" button and act accordingly.

Once the image is uploaded and attached to a page it can be used, either in order to display it within the page or for download (= linking, see there). Since it is always associated with a certain page you can refer to it by its simple filename. Since linking to an image is discussed in the #Links to images chapter here we attempt to actually display the image.

  {{attachment:APL-Logo.png || width=40}}

which leads to

Note that the height is also changed so that the originally ratio between height and width is preserved.

Alternatively with an optional link text:

  {{attachment:APL-Logo.png | The APL logo | width=40}}

That's the result:

Hover the mouse over the image and you will see "The APL logo" text pop up.

Tables are sometimes useful to arrange images. This:

|| {{attachment:fish.jpg}} || {{attachment:fish.jpg}} || {{attachment:fish.jpg}} ||
|| {{attachment:fish.jpg}} || {{attachment:fish.jpg}} || {{attachment:fish.jpg}} ||

leads to this:

Limitations

While images of types "PNG", "JPG" and "GIF" work fine, "BMP" and "ICO" don't. BMPs should not be used anyway because they are much bigger then the same picture converted to a PNG.

Attachments

For a detailed discussion see HelpOnLinking.

Before you start linking to an attachment (for download purposes, for example) first upload the attachment; click the "Attachments" button and act accordingly.

Once the attachment is uploaded it is available for link purposes. Since it is always associated with a certain page you can refer to it from within that page by its simple filename. For example, a link to the file "sample.txt" which is attached to this page can be created with:

  [[attachment:sample.txt]]

which leads to sample.txt.

Alternatively with an optional link text as in:

  [[attachment:sample.txt | link to the attachment]]

which leads to link to the attachment

You can also link to an attachment that is attached to another page. This:

[[attachment:Fire/Fire_01.png]]

points to a screenshot attached to the page Fire. This will result in this:

Fire/Fire_01.png

Alternatively with an optional link test:

[[attachment:Fire/Fire_01.png | Link to Fire]]

This will result in:

Link to Fire

Table of contents

Insert this right after the = title = part of your page:

    <<TableOfContents>>

Offer "Hide table-of-contents" link

In case a table-of-contents is getting very large you might want to offer the user the opportunity to hide and show the toc at his will.

This can be achieved by putting this code onto the page, typically right after the level 1 header:

~-<<SeeSaw(section="table-of-contents", show="true", seesaw="false", toshow="<<(Show>> table-of-contents)", tohide="<<(Hide>> table-of-contents)", speed="Slow")>>-~

See this page as an example.