How to style your text
General
- To create plain text, just type. You can make a paragraph break by adding a blank line.
- For preformatted text, you can use the HTML "pre" tag. You should rarely need this.
- For bold text, wrap it with three apostrophes on either side
'''like this''', or if you wish, use HTML<b>like this</b>. - For italic text, wrap it with two apostrophes on either side
''like this'', or if you wish, use HTML<i>like this</i>. - To create a block of indented text, start a line with a colon (:).
To create a horizontal line, type 4 or more dash (-) characters, like this:
----
Links
You can link to a guide page by putting two square brackets around one or more
words [[like this]]. It'll be displayed like this (although this demo link doesn't go anywhere, while
yours will).
If you add a link to a page that hasn't been created yet, it'll appear in square brackets with a question-mark link [like this]?. You can then follow the link to create and edit the page.
You can also give the link a title, which will be displayed instead of the
full name of the page you're linking to. Do this by adding a pipe
symbol (|) after the page name in the link, and then typing your title:
[[like this|test link]]. The resulting link will be displayed
as test link.
You can make a link to another site by just typing the web address:
http://london.openguides.org/ (which would produce http://london.openguides.org/).
If you want, you can give the link a title, like this:
[http://london.openguides.org/ example link]. It would appear
as [example link].
If a URL contains a pipe character (|) you will need to enter it as
"%7c" instead, since the pipe character has a special meaning in
links (as above).
Headings
Wrap text in equals (=) signs to make headings.
= Heading size 1 =
== Heading size 2 ==
=== Heading size 3 ===
==== Heading size 4 ====
===== Heading size 5 =====
====== Heading size 6 ======
This is what's produced by the above:
Heading size 1
Heading size 2
Heading size 3
Heading size 4
Heading size 5
Heading size 6
Note the spaces between the equals signs and the actual text of the heading. Also, if your numbers of equals signs are unbalanced it either won't work or won't work like you expected, so be careful.
Lists
Unordered lists:
* First-level unordered list item
** Second-level unordered list item
This produces:
- First-level unordered list item
- Second-level unordered list item
At present, only one level of nesting is supported. Ordered lists and definition lists have not been implemented yet.
Images
To display an image, use HTML's "img" tag, as in the example below. Please note that the image may need to be stored on a webserver somewhere, as many OpenGuides sites don't offer photo hosting yet.
<img src="http://openguides.org/img/example_image.png"
width="150" height="150" alt="Example Image">
Will produce this:
Whilst specifying the width and height of the image is optional, please make sure that you always include the "alt" description text for the image, so that people reading the site with text-only browsers aren't adversely affected. If you want the image to "float" on the left or the right of the page, you can use CSS, but that's too big a topic to get into here.
