Differences between revisions 12 and 14 (spanning 2 versions)
Revision 12 as of 2014-06-01 05:30:52
Size: 7738
Editor: KaiJaeger
Comment:
Revision 14 as of 2014-06-01 06:06:10
Size: 9186
Editor: KaiJaeger
Comment:
Deletions are marked like this. Additions are marked like this.
Line 6: Line 6:
Line 23: Line 24:
This is not another line.

For
details how white space at the beginning of a line is processed see [[HelpOnBasicFormatting#Indentation | Indentation]]
This is not another line. details how white space at the beginning of a line is processed see [[HelpOnBasicFormatting#Indentation | Indentation]]
Line 76: Line 75:
== Numbered Lists == == Lists ==

For a detailed discussion see HelpOnLists.

=== Numbered Lists ===
Line 100: Line 103:
== Bulleted Lists == === Bulleted Lists ===
Line 120: Line 123:
For a detailed discussion see HelpOnTables.
Line 153: Line 158:
For a detailed discussion see HelpOnLinking.
Line 235: Line 242:
Alternatively with an optional text as in:
{{{
  [[attachment:APL-Logo.png | download the APL logo ]]
}}}

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

For how to display an image within a page (rather than linking to it) see [[#Images | 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, [[#links to images|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 {{attachment:APL-Logo.png || width=40}}

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:

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

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:

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

=== 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 [[attachment:sample.txt]].
Line 237: Line 309:
  [[attachment:APL-Logo.png | download the APL logo ]]   [[attachment:sample.txt | link to the attachment]]
Line 242: Line 314:
For how to display an image within a page (rather than linking to it) see [[#Images | 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, [[#links to images|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 || height=40,width=40}}
}}}

{{attachment:TRASH.BMP || height=40,width=40}}

which leads to {{attachment:APL-Logo.png || height=40,width=40}}

Tables are sometimes useful to arrange images. This:

{{{
|| {{attachment:trash.bmp || {{attachment:trash.bmp || {{attachment:trash.bmp ||
|| {{attachment:trash.bmp || {{attachment:trash.bmp || {{attachment:trash.bmp ||
}}}

leads to this:


|| {{attachment:trash.bmp}} || {{attachment:trash.bmp}} || {{attachment:trash.bmp}} ||
|| {{attachment:trash.bmp}} || {{attachment:trash.bmp}} || {{attachment:trash.bmp}} ||

=== 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 ==

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 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 [[attachment:sample.txt]].

Alternatively with an optional link text as in:
{{{
  [[attachment:sample.txt | link to the attachment]]
}}}

which leads to [[attachment:sample.txt | 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:

[[attachment:Fire/Fire_01.png]]

Alternatively with an optional link test:

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

This will result in:

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

=== 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.

Help on Basic Formatting

(Hide 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:

col1

col2

col3

cell A1

cell B1

cell C1

cell A2

cell B2

cell C2

cell A2

cell B2

cell C2

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!

For a detailed discussion see HelpOnLinking.

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

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

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

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.

See Attachments

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 APL-Logo.png

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:

The APL logo

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:

fish.jpg

fish.jpg

fish.jpg

fish.jpg

fish.jpg

fish.jpg

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>>

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.

HelpOnBasicFormatting (last edited 2014-06-01 06:06:10 by KaiJaeger)