Difference between revisions of "Help:Markup reference"
(→Headers (subtitles)) |
(→Lists) |
||
Line 44: | Line 44: | ||
Lists are remarkably easy. There are two kinds, unordered (not numbered) and ordered (numbered). | Lists are remarkably easy. There are two kinds, unordered (not numbered) and ordered (numbered). | ||
+ | |||
+ | {| | ||
+ | |- valign="top" | ||
+ | ! What it looks like | ||
+ | ! What you type | ||
+ | ! Comments | ||
+ | |- | ||
+ | | Unordered: | ||
+ | *This | ||
+ | *That | ||
+ | *The other | ||
+ | | <pre>*This | ||
+ | *That | ||
+ | *The other</pre> | ||
+ | | asterisks | ||
+ | |- | ||
+ | | Ordered: | ||
+ | #This | ||
+ | #That | ||
+ | #The other | ||
+ | | <pre>#This | ||
+ | #That | ||
+ | #The other</pre> | ||
+ | | hash marks | ||
+ | |- | ||
+ | |} | ||
+ | |||
+ | Lists may be nested, and in any combination: an ordered/unordered list may be nested within an ordered/unordered list. An example: | ||
+ | |||
+ | {| | ||
+ | |- valign="top" | ||
+ | ! What it looks like | ||
+ | ! What you type | ||
+ | ! Comments | ||
+ | |- | ||
+ | | Unordered within ordered: | ||
+ | #Prewar | ||
+ | #Postwar film | ||
+ | #*35mm and smaller | ||
+ | #*Larger than 35mm | ||
+ | #Digital | ||
+ | | <pre>#Prewar | ||
+ | #Postwar film | ||
+ | #*35mm and smaller | ||
+ | #*Larger than 35mm | ||
+ | #Digital</pre> | ||
+ | | A hash mark for every item, and not just for every top-level item | ||
+ | |- | ||
+ | |} | ||
==Character formatting== | ==Character formatting== |
Revision as of 07:14, 3 April 2011
This may eventually grow into something worth moving into a new "Help:" ... but it has a hell of a long way to go first.
This page explains Mediawiki markup. Mediawiki is the software behind not only Camera-wiki.org but also Wikipedia (for which it was created) and many other wikis; you may find what follows familiar from one of these. And if you happen to be used to HTML or XHTML, the explanation will be easy to follow, as Mediawiki is a preprocessor for XHTML and its markup is thus similar.
Contents
Characters
Characters on your keyboard
You should be able to type just about any character that's on your keyboard, and in the normal way. Exceptions are:
- combinations of characters that most people would never want (such as pairs of single quotation marks)
- the two inequality signs "<" and ">"
The last pair will seldom be useful in the context of cameras; but if you do need them, type "<" and ">" respectively. (Mnemonics: "lt" and "gt" for "less than" and "greater than" respectively.)
Characters not on your keyboard
As for all the characters that aren't on most people's keyboards and that are occasionally useful — áàäâāăãåą and more — you can either:
- copy them from elsewhere and paste them
- insert them via the "numeric references" (eg "ō" for "ō") or named "character entities" (eg "ü" for "ü") that are standard for HTML or XHTML in regular web pages
Many web resources help with the latter; one of these is Alan Wood’s Unicode resources.
Page organization
Paragraphs
Single line breaks do nothing (usually). To separate one paragraph from the following paragraph, insert a blank line between them (hit the Enter key twice).
Don't attempt to indent the first line of a paragraph.
To indent a block quotation, start the block with "<blockquote>" and end it with "</blockquote>".
There's convention whereby a comment in a talk page is indented further from the left than is the comment that prompted it. For each level of indentation from the left, add one colon : at the very start of your comment.
Headers (subtitles)
Think of an article as having a hierarchy of organization. Any article that is not particularly short needs subdivision by headers. As an example of this in action, we'll look at the article "Pearlette".
The very start rightly has no header. (Don't add headers such as "Introduction", "Preamble", or similar.)
There follows a table of contents, which the software has generated automatically. Note within it:
- 3 Second generation: hinged back
- 3.1 1933 model
and take a quick look at these sections. The former is the topmost level of classification; it was added with a pair of double equals signs: "==Second generation: hinged back==". The latter is one stage below this, and uses a pair of treble equals signs: "===1933 model===". Note that they're not numbered: the numbering too is generated automatically.
For a further depth of subdivision, a greater number of equals signs can be used.
Lists
Lists are remarkably easy. There are two kinds, unordered (not numbered) and ordered (numbered).
What it looks like | What you type | Comments |
---|---|---|
Unordered:
|
*This *That *The other |
asterisks |
Ordered:
|
#This #That #The other |
hash marks |
Lists may be nested, and in any combination: an ordered/unordered list may be nested within an ordered/unordered list. An example:
What it looks like | What you type | Comments |
---|---|---|
Unordered within ordered:
|
#Prewar #Postwar film #*35mm and smaller #*Larger than 35mm #Digital |
A hash mark for every item, and not just for every top-level item |
Character formatting
The way that text appears within a paragraph, list item, etc, can be altered via either Mediawiki-specific use of apostrophes[1] or certain XHTML tags. First, the apostrophes:
What it looks like | What you type | Comments |
---|---|---|
Italics: Asahi Camera is helpful | ''Asahi Camera'' is helpful |
Two (plain) apostrophes to start, two to finish. |
Bold: It is marked SP | It is marked '''SP''' |
Three (plain) apostrophes to start, three to finish. |
And yes, you can combine italics and bold.
Secondly, the XHTML tags. You mark the start of an area needing some change with "<XXX>" and you mark its end with "</XXX>" -- though not with "XXX" but instead with something else, as explained below:
What it looks like | What you type | Comments |
---|---|---|
Superscript: marketed as the "330D" in Europe | marketed as the "330<sup>D</sup>" in Europe |
|
Subscript: marketed as the "A41" in Japan | marketed as the "<sub>A</sub>41" in Japan |
|
Small: [not verified] | <small>[not verified]</small> |
Rarely helpful in the text of an article. |
(Editors familiar with CSS can also format within <span style="[CSS rules]"> and </span>.)
Notes
- ↑ These must be standard, straight-from-the-keyboard apostrophes: ' . "Typographic quotes" — opening- and closing-specific quotation marks ‘ and ’ — won't work for this.