Creating, formatting and editing articles

---

This article shows each feature available for formatting articles, inserting images, maps, and tables. Directly following the example of each feature is the code needed to use it when editing an article.

This is about the publicly viewable Articles section.

Creating and editing articles

Click "Create an article" on Articles list. This gives a form with boxes:

• Title
• Licence - pre-filled with "(Temporarily) Not Published)" - followed by contributor name
• Publish date -automatically filled, can be amended later
• Category
• Relevant Grid Square
• Short Description
• Content (big box for main text, images and maps)
• Save Changes

The title is used to generate the web address of the article, e.g. "Glasgow Parks" gets an URL of www. geograph.org.uk/article/Glasgow-Parks. The contributor can change the title later, but should not change the URL once the article is published.

"Licence" has four options:

• (Temporarily) Not Published
• Public Domain
• Creative Commons BY-SA/2.0
• Copyright

Most Geograph articles are under Creative Commons Share-alike licence which allows others to copy, distribute, and transmit the work, also to adapt it, so long as the author is acknowledged. If Public Domain is chosen anyone can use the text of the article in any way, if Copyright is chosen others cannot copy or amend without the author's permission. These settings are about the legal status of the text of the article, not about whether other contributors can change the text of the article in Geograph.

Clicking "Save changes" does not automatically change the licence, it can be left on "(Temporarily) Not Published" while the article is developed. The article can then be seen by the author and by moderators, but not by other contributors or the public. When changed to one of the other licences, the article is brought to the attention of moderators. A moderator can approve, or send an email to the author suggesting changes, or can make edits which would usually be to correct obvious typos.

Publish Date is initially set to the date of first creation, if the article remains unpublished for some time the author can amend it to the date when the article is first made available to the public, but it should not be changed if the article is edited later.

The category box has a pull-down list of eight categories plus provision to ask for a new one. For example category "Exploring the Community" is used for articles about a particular place or route or river, etc.

"Relevant grid square" is used to:

1. show a link at the bottom of the article to the 'Location' grid square page. and
2. Plot the location in the RSS feed (for anyone with a compatible RSS reader).

"Short Description" is added to the "Meta" lines in the head section of the web page. It is shown when the mouse is moved over the name in a list of articles, and is used by search engines, but is not visible on the displayed page of the article.

"Content" is for the text of the article with links to images, maps, etc.

After clicking "Save changes" the article appears as it will be displayed to the public - with the addition of links at the top of the article, visible to author and moderators, for "Edit this article" "Article History" and "Article Listing". There is also now a box for the URL generated from the initial title - the URL should not be changed even if the title is changed.

Formatting

Headings

[h2]Headings[/h2]

Sub heading

[h3]Sub heading[/h3]

Sub sub heading

[h4]Sub sub heading[/h4]


Note that h2, h3 and h4 headings are put into a contents list, top right of the article.
Note also that [h1] and [h5] are not actioned as headings, and that h2 h3 h4 have to be lower case h to be actioned.

Text formatting

Appearance of text

Text and bold text and italics and big text and small text
Text and [b]bold text[/b] and [i]italics[/i] and [big]big text[/big] and [small]small text[/small]

Monospaced text

iiiii
MMMMM
12345

[tt]iiiii
MMMMM
12345[/tt]

Bullets

• Item one
• Item two
• Item three and if you keep on adding text and adding text and adding text and adding text and adding text and adding text and adding text and adding text this is how it looks.

Start each bullet line with an asterisk -
* Item one
* Item two
* Item three and if you keep on adding text and adding text and adding text and adding text and adding text and adding text and adding text and adding text this is how it looks.

Numbered list

Start each line with a hash (#) - must have a space after it -

1. Item one
2. Item two
3. Item three and if you keep on adding text and adding text and adding text and adding text and adding text and adding text and adding text and adding text this is how it looks.

# Item one
# Item two
# Item three and if you keep on adding text and adding text and adding text and adding text and adding text and adding text and adding text and adding text this is how it looks.

Horizontal rule

---

[hr/]

Images

Please limit the number of displayed images in an article to 100. Map display takes more resources than thumbnail image display. As a rough guide the maximum should be 10 (or maybe 15) large maps, 50 small maps, 100 thumbnail images, or an appropriate mixture. If you want more images, please create several articles and link them together.

Geograph photographs and their titles

TQ1876 : Kew Gardens Temperate House from the Pagoda

[[[227173]]]
[[227173]]

You can display an image with the description supplied by the contributor:


[image id=1562709 text={description}]

You can also display an image in a box with text you have written for the article:

[image id=227173 text=View of the Temperate House at Kew Gardens from the top of the pagoda. The public cannot normally climb the pagoda, but it was opened for a few months in summer 2006]

You can insert into text a list of contributors of photographs used in the article.

Photos in this article are by David Hawgood and Andrew Curtis.
Photos in this article are by [imageCredits].

Note that there is a list of photographers generated automatically at the bottom of the article with a copyright notice and reference to the Creative Commons Licence.

External images

Peacock in Sri Lanka, copyright David Hawgood.
[img=http://www.hawgood.co.uk/photo/SriLanka/wild123t.jpg]

The example above has no Alt text (which displays if images are turned off), which also acts in most browsers as a tool tip (which displays as the mouse is moved over the image). This is added as text after the image address in the example below. It is good practice to add such a text.

Peacock in Sri Lanka, copyright David Hawgood.
[img=http://www.hawgood.co.uk/photo/SriLanka/wild123t.jpg Peacock in Sri Lanka, copyright David Hawgood]


If including an external image to display in an article you should make sure you have permission from the owner of the site referenced; the image used here is on the site of the original author of this article, David Hawgood.

Note that clicking the image does not link to the image on its external site. See next section for linking to the external site, either to the image or to the webpage on which it is held.

Links

Link external to Geograph

Peacock in Uda Walawe, Sri Lanka
[url=http://www.hawgood.co.uk/photo/SriLanka/peacock.htm]Peacock in Uda Walawe, Sri Lanka[/url]

Peacock in Sri Lanka, see photo Link
Peacock in Sri Lanka, see photo http://www.hawgood.co.uk/photo/SriLanka/peacock.htm

The link can be to an image:
link to external image of peacock
[url=http://www.hawgood.co.uk/photo/SriLanka/wild123t.jpg]link to external image of peacock[/url]

An internet link, starting http:// or www, appears with the word "Link"

Grid reference links within geograph

SD2605 Formby Point SD2605

Letters and numbers which can be a grid reference are interpreted as such, and are made into a link to the Geograph information for the relevant grid square.

Watch out for this if you happen to want to refer to an A or B road which has a 4 digit number.
B9212 Lough Barra B9212
A4000 (all at sea) A4000
To stop it happening put an exclamation mark before the grid reference:
!SD2605 !B9212 !A4000
The letters must be upper case to be treated as grid references - sd2605 b9212 a4000 are not treated as grid references.

Links within articles

To return to top of current article, it is necessary to put in the full external link to the article followed by #top
Return to top
[url=http://www.geograph.org.uk/article/Help_on_formatting_of_articles#top]Return to top [/url]

The table of contents at the top right of an article uses internal links, with all headings numbered in sequence from zero. Be aware that if a heading is inserted, the numbers of all headings further down the article are changed.
Return to first heading
[url=http://www.geograph.org.uk/article/Help_on_formatting_of_articles#p0]Return to first heading[/url]

Position of text after image - float

Without float codes, text starts after bottom right of image, and if there is enough text it continues below the image after reaching the right margin.
[[[227173]]] Without float codes, text starts after bottom right of image, and if there is enough text it continues below the image after reaching the right margin.

With float codes, text starts after top right of image, for several lines if there is enough text to fill up the text beyond one line,

a break code makes it continue below the image.
[float][[[227173]]][/float] With float codes, text starts after top right of image, for several lines if there is enough text to fill up the text beyond one line, [br/] a break code makes it continue below the image.

The [float] [/float] pair are around the code which calls the image. The [br/] is only needed to make the text continue below the image.

Hiding and revealing text

This is used for quiz answers and hints. To reveal, select the hidden text. In the example it is between the {} braces, but you can use any visible characters to show the user what to select.
Answer:{Hidden text}
Answer:{[reveal]Hidden text[/reveal]}

Table

heading 1	heading 2	heading 3
cell 1	cell 2	cell 3
cell 4	cell 5	cell 6

--------------------------------
* | heading 1 | heading 2 | heading 3 |
| cell 1 | cell 2 | cell 3 |
| cell 4 | cell 5 | cell 6 |
--------------------------------


The number of dashes starting/ending the table is not critical, but needs at least 7.
The spaces either side of the middle | are required.
Note that clicking on a heading sorts on that column - and clicking again reverses the order.
The number of columns and rows is effectively unlimited, but each row needs the same number of columns.
The * on the first row makes it a heading.

Leave out * before first line to stop it being a heading, this also removes lines. This can be convenient for layout.

	column 2	column 3
	cell 2	cell 3

--------------------------------
| [[[227173]]] | column 2 | column 3 |
| [[[1562709]]] | cell 2 | cell 3 |

--------------------------------

For example of use see Avon Ystwyth article

Maps

Sections of 1:50,000 Ordnance Survey maps can be displayed. The way of doing this is now in a separate article Maps in articles

Showing article syntax

Hopefully only needed in this article.
Precede each [ (opening square bracket) by ! (exclamation mark).
![b]
- and displaying that required two exclamation marks - !![b]

For bullets, put a space before the asterisk or hash symbol
For table, put a space before the line of hyphens to stop it functioning.

Tests

This section is for the author of this article to make syntax tests, entries in it it will probably be removed later.

Multiple images from lists and searches

mooflow - a way to display a set of thumbnails

[mooflow=3888400]

---