Difference between revisions of "Help:Wiki markup"
(bread crumb) |
(bread crumb) |
||
Line 1: | Line 1: | ||
− | {| cellspacing="1" cellpadding="1" border="0" align="right" width=" | + | {| cellspacing="1" cellpadding="1" border="0" align="right" width="200" |
|- | |- | ||
− | | [[Help: | + | | [[Help:Contributor Help|Return to Contributor Help]] |
|}<br><br><br> | |}<br><br><br> | ||
Revision as of 02:11, 24 July 2012
Return to Contributor Help |
![]() |
This help article will guide you as you edit in the Wiki. See Contributor Help for more help articles. |
Wiki markup is the text you use to format a FamilySearch Wiki page.
Contents
Links and URLs
The following characters are used to create links: [[ ]], [ ], ~~~~, ~~~, http, ISBN, RFC & {{ }}
, as denoted by the following sections:
To Do: Change the examples to be more relevant to FamilySearch Wiki |
![]() |
Questions? Visit the Wiki Contributor Help Forum to receive help with contributing to the Wiki. |
---|
What it looks like | What you type |
---|---|
London has Public transport. (Article link)
|
|
San Francisco also has public transportation. (Renamed link)
|
|
San Francisco also has Public transportation. (Blend link) Examples include Buses, Taxicabs, and Trams.
|
|
See the wikipedia:Manual of Style. (Other page link)
|
|
wikipedia:Manual of Style is a link to a section within another page. #Links_and_URLs is a link to another section on the current page. Italics is a piped link to a section within another page.
|
|
(Example renamed links) Automatically hide stuff in parentheses: kingdom. Automatically hide namespace: Village pump. Or both: Manual of Style But not: [[Wikipedia:Manual of Style#Links|]]
|
|
(Create page link) Links to pages that don’t exist yet look red: wikipedia:Community portal/Opentask/Requested articles
|
|
(Signing comments) The character tilde (~) is used when adding a comment to a Talk page. You should sign your comment by appending four tildes (~~~~) to the comment so as to add your user name plus date/time:
Adding three tildes (~~~) will add just your user name:
and adding five tildes (~~~~~) gives the date/time alone:
|
|
(Redirects)
|
|
(Wikimedia link) To connect, via interwiki link, to a page on the same subject in another language, put a link of the form: [[language code:Title]] near the bottom of the article. For example, in article "Plankton", which is available on a lot of other wikis, the interwiki link to the German Wikipedia looks like:
where the "de" is the language-code for "Deutsch" (the German language).
|
|
(Linked and why) What links here and Related changes pages can be linked as: |
|
Use links for dates, so everyone can set their own display order. Use Special:Preferences to change your own date display setting. |
[[July 20]] [[1969]] [[20 July]] [[1969]] and [[1969]]-[[07-20]] |
External link function is used for these as [[page]] will not work. |
[http://en.wikipedia.org/w/index.php? title=Help:Wiki_markup&diff=330350877&oldid=330349143 previous edit] |
(User edits) A user's Contributions page can be linked as: Special:Contributions/UserName or Special:Contributions/192.0.2.0 |
|
(Categorize)
|
|
(Category page link)
|
|
(External links) Three ways to link to external (non-wiki) sources:
|
|
(Wikimedia text link) Linking to other wikis:
Linking to another language's wiktionary:
|
|
(Book sources) Link to a book using alternate text, such as its title.
|
|
(RFC number) Text mentioning an RFC number anywhere, e.g. RFC 4321. |
|
(“As of” tag) “As of” tags like "As of April 2009" and "as of April 2009" categorize info that will need updating. |
|
(Media link)
Some uploaded sounds are listed at commons:Sound. |
|
(Edit links) Link directly to edit for an existing page, or apply other link attributes.
|
|
Images
Only images that have been uploaded to Wikipedia can be used. To upload images, use the upload page. You can find the uploaded image on the image list.
What it looks like | What you type |
---|---|
A picture: | A picture: [[Image:wiki.png]] |
With alternative text: | With alternative text: [[Image:wiki.png|alt=Puzzle globe logo]]
|
Floating to the right side of the page using the frame attribute and a caption:
|
Floating to the right side of the page using the ''frame'' attribute and a caption: [[Image:wiki.png|frame|alt=Puzzle globe logo|Wikipedia Encyclopedia]]
|
Floating to the right side of the page using the thumb attribute and a caption:
|
Floating to the right side of the page using the ''thumb'' attribute and a caption: [[Image:wiki.png|thumb|alt=Puzzle globe logo|Wikipedia Encyclopedia]]
|
Floating to the right side of the page without a caption: | Floating to the right side of the page ''without'' a caption: [[Image:wiki.png|right|Wikipedia Encyclopedia]]
|
A picture resized to 30 pixels... | A picture resized to 30 pixels... [[Image:wiki.png|30 px|Wikipedia Encyclopedia]]
|
Linking directly to the description page of an image: | Linking directly to the description page of an image: [[:Image:wiki.png]]
|
Linking directly to an image without displaying it: | Linking directly to an image without displaying it: [[Media:wiki.png|Image of the jigsaw globe logo]]
|
Using the span and div tag to separate images from text (note that this may allow images to cover text): | Example: <div style="display:inline; width:220px; float:right;"> Place images here </div> |
Using wiki markup to make a table in which to place a vertical column of images (this helps edit links match headers, especially in Firefox browsers): | Example: {| align=right |- | Place images here |} |
See the Wikipedia's image use policy as a guideline used on Wikipedia.
For further help on images, including some more versatile abilities, see the picture tutorial.
Section headings
- Further information: [[Help:Section]] Use headings to split articles into sections. Put a heading on a separate line. A level-two heading is the highest level editors use in an article.
What it looks like | What you type |
---|---|
Section headings
Headings organize your writing into sections. The Wiki software can automatically generate a table of contents from them. Subsection
Using more equals signs creates a subsection. A smaller subsection
Start with 2 equals signs. Don't skip levels, like from two to four equals signs. |
==Section headings== ''Headings'' organize your writing into sections. The Wiki software can automatically generate a table of contents from them. ==Subsection== Using more equals signs creates a subsection. ===A smaller subsection=== Start with 2 equals signs. Don't skip levels, like from two to four equals signs. |
Horizontal line
Separating with a horizontal dividing line:
If you don't use a section header, you don't get a TOC entry. |
A horizontal dividing line: this is above it... ---- ...and this is below it. |
Text formatting
What it looks like | What you type |
---|---|
A single newline has no effect on the layout. But an empty line starts a new paragraph, or ends a list or indented part. (<p> disables this paragraphing until </p> or the end of the section) A semicolon at the start of a line is not displayed, but has the effect of rendering the newline. A colon in such a line is not rendered, but has the effect of starting a new, indented line. You can make the wikitext more readable by putting in newlines, but see wikipedia:Don't use line breaks for possible problems.
|
A single newline has no effect on the layout. But an empty line starts a new paragraph. |
You can break lines without starting a new paragraph. (The HTML tag <br /> is sufficient. The system produces the XHTML code <br />.)
|
You can break lines<br /> without starting a new paragraph. |
When there is a need for separating a block of text the blockquote command will indent both margins when needed instead of the left margin only as the colon does. This is useful for (as the name says) inserting blocks of quoted (and cited) text. |
<blockquote> The '''blockquote''' command will indent both margins when needed instead of the left margin only as the colon does. </blockquote> |
|
<center>Centered text.</center> |
Lists
What it looks like | What you type |
---|---|
marks the end of the list.
|
* ''Unordered lists'' are easy to do: ** Start every line with a star. *** More stars indicate a deeper level. *: Previous item continues. ** A new line * in a list marks the end of the list. * Of course you can start again. |
A new line marks the end of the list.
|
# ''Numbered lists'' are: ## Very organized ## Easy to follow #: Previous item continues A new line marks the end of the list. # New numbering starts with 1. |
Character formatting
What it looks like | What you type |
---|---|
You can italicize text by putting 2
apostrophes on each side. 3 apostrophes will bold the text. 5 apostrophes will bold and italicize the text. |
You can ''italicize text'' by putting 2 apostrophes on each side. 3 apostrophes will '''bold the text'''. 5 apostrophes will '''bold''' and ''italicize'' '''''the text'''''. |
Syntax highlighting for source code. Computer code has a colored background and more stringent formatting. Suppose we want to define std::cout << "Hello World!"; return 0; }</source> |
Computer code has a colored background and more stringent formatting. Suppose we want to define <code>int main()</code>: <source lang=cpp>#include <iostream> int main ( int argc, char **argv ) { std::cout << "Hello World!"; return 0; }</source> |
You can use small text for captions. |
You can use <small>small text</small> for captions. |
Better stay away from big text, unless it's within small text. |
Better stay away from <big>big text</big>, unless <small> it's <big>within</big> small</small> text. |
You can You can also mark
|
You can <s>strike out deleted material</s> and <u>underline new material</u>. You can also mark <del>deleted material</del> and <ins>inserted material</ins> using logical markup. For backwards compatibility better combine this potentially ignored new <del>logical</del> with the old <s><del>physical</del></s> markup. |
You can include a non-breaking space (sometimes called non-printing character) where you require two words to always appear together on the same line, such as Mr. Smith or 400 km/h using |
Mr. Smith or 400 km/h. |
Extra spacing within text can best be achieved using the pad template: Mary Template:Pad had a little lamb. |
Mary {{pad|4em}} had a little lamb. |
Typewriter font (does not work beyond the end of a paragraph): italics Link New paragraph. |
<tt>arrow →</tt> <tt>''italics''</tt> <tt>[[link]] New paragraph.</tt> |
Special characters
What it looks like | What you type |
---|---|
Diacritical marks: |
À Á Â Ã Ä Å Æ Ç È É Ê Ë Ì Í Î Ï Ñ Ò Ó Ô Õ Ö Ø Ù Ú Û Ü ß à á â ã ä å æ ç è é ê ë ì í î ï ñ ò ó ô œ õ ö ø ù ú û ü ÿ |
Punctuation: |
¿ ¡ § ¶ † ‡ • – — ‹ › « » ‘ ’ “ ” |
Commercial symbols: |
™ © ® ¢ € ¥ £ ¤ |
Subscripts: Superscripts: Combined:
|
x<sub>1</sub> x<sub>2</sub> x<sub>3</sub> or x₀ x₁ x₂ x₃ x₄ x₅ x₆ x₇ x₈ x₉ x<sup>1</sup> x<sup>2</sup> x<sup>3</sup> or ε<sub>0</sub> = 8.85 × |
Greek characters: |
α β γ δ ε ζ η θ ι κ λ μ ν ξ ο π ρ σ ς τ υ φ χ ψ ω Γ Δ Θ Λ Ξ Π Σ Φ Ψ Ω |
Mathematical characters:
|
∫ ∑ ∏ √ − ± ∞ ≈ ∝ ≡ ≠ ≤ ≥ × · ÷ ∂ ′ ″ ∇ ‰ ° ∴ ℵ ø ∈ ∉ ∩ ∪ ⊂ ⊃ ⊆ ⊇ ¬ ∧ ∨ ∃ ∀ ⇒ ⇐ ⇓ ⇑ ⇔ → ↓ ↑ ← ↔ |
Mathematical formulae: <math>\mathbf{x} = \mathbf{0}</math>
|
<math>\,\! \sin x + \ln y</math><br> {{math|sin ''x'' + ln ''y''}} <math>\mathbf{x} = \mathbf{0}</math><br> {{math|<b>x</b> {{=}} <b>0</b>}} |
Spacing in simple math formulae:
|
Obviously, {{math|''x<''<sup>2</sup> ≥ 0}} is true when {{math|<VAR >x</VAR >}} is a real number. |
Complicated formulae:
|
: <math>\sum_{n=0}^\infty \frac{x^n}{n!}</math> |
(see also: Chess symbols in Unicode)
No or limited formatting
—showing exactly what is being typed A few different kinds of formatting will tell the Wiki to display things as you typed them — what you see, is what you get!
What it looks like | What you type |
---|---|
<nowiki> tag: The nowiki tag ignores [[Wiki]] ''markup''. It reformats text by removing newlines and multiple spaces. It still interprets special characters: → |
<nowiki> The nowiki tag ignores [[Wiki]] ''markup''. It reformats text by removing newlines and multiple spaces. It still interprets special characters: → </nowiki> |
<pre> tag:The pre tag ignores [[Wiki]] ''markup''. It also doesn't reformat text. It still interprets special characters: → |
<pre> The pre tag ignores [[Wiki]] ''markup''. It also doesn't reformat text. It still interprets special characters: → </pre> |
Leading space: Leading spaces are another way to preserve formatting.
Putting a space at the beginning of each line stops the text from being reformatted. It still interprets Wiki markup and special characters: → |
Leading spaces are another way to preserve formatting. Putting a space at the beginning of each line stops the text from being reformatted. It still interprets [[Wiki]] ''markup'' and special characters: → |
Invisible text (comments)
It's uncommon, but on occasion acceptable for notes to other editors ( see MOS ), to add a hidden comment within the text of an article. These comments are only visible when editing or viewing the source of a page. Most comments should go on the appropriate Talk page. The format is to surround the hidden text with and may cover several lines, e.g.:
<!-- An example of hidden comments This won't be visible except in "edit" mode. -->
Table of contents
When a page has at least four headings, a table of contents (TOC) will appear in front of the first header (after the lead). Putting __TOC__ anywhere forces the TOC to appear at that point (instead of just before the first heading). Putting __NOTOC__ anywhere forces the TOC to disappear. See also Compact TOC for alphabet and year headings.
Tables
There are two ways to build tables:
- in special Wiki-markup (see Table)
- Using HTML elements: <table>, <tr>, <td> or <th>.
For the latter, and a discussion on when tables are appropriate, see When to use tables.
Variables
(See also Variable)
Code | Effect |
---|---|
{{CURRENTWEEK}} | 16 |
{{CURRENTDOW}} | 5 |
{{CURRENTMONTH}} | 04 |
{{CURRENTMONTHNAME}} | April |
{{CURRENTMONTHNAMEGEN}} | April |
{{CURRENTDAY}} | 20 |
{{CURRENTDAYNAME}} | Friday |
{{CURRENTYEAR}} | 2018 |
{{CURRENTTIME}} | 22:44 |
{{NUMBEROFARTICLES}} | 87,791 |
{{NUMBEROFUSERS}} | 150,561 |
{{PAGENAME}} | Wiki markup |
{{NAMESPACE}} | Help |
{{REVISIONID}} | 1067987 |
{{localurl:pagename}} | /wiki/en/Pagename |
{{localurl:Wikipedia:Sandbox|action=edit}} | http://en.wikipedia.org/wiki/Sandbox?action=edit |
{{fullurl:pagename}} | https://www.familysearch.org/wiki/en/Pagename |
{{fullurl:pagename|query_string}} | https://www.familysearch.org/wiki/en/index.php?title=Pagename&query_string |
{{SERVER}} | https://www.familysearch.org |
{{ns:1}} | Talk |
{{ns:2}} | User |
{{ns:3}} | User talk |
{{ns:4}} | FamilySearch Wiki |
{{ns:5}} | FamilySearch Wiki talk |
{{ns:6}} | File |
{{ns:7}} | File talk |
{{ns:8}} | MediaWiki |
{{ns:9}} | MediaWiki talk |
{{ns:10}} | Template |
{{ns:11}} | Template talk |
{{ns:12}} | Help |
{{ns:13}} | Help talk |
{{ns:14}} | Category |
{{ns:15}} | Category talk |
{{SITENAME}} | FamilySearch Wiki |
NUMBEROFARTICLES is the number of pages in the main namespace which contain a link and are not a redirect, in other words number of articles, stubs containing a link, and disambiguation pages.
CURRENTMONTHNAMEGEN is the genitive (possessive) grammatical form of the month name, as used in some languages; CURRENTMONTHNAME is the nominative (subject) form, as usually seen in English.
In languages where it makes a difference, you can use constructs like {{grammar:case|word}} to convert a word from the nominative case to some other case. For example, {{grammar:genitive|{{CURRENTMONTHNAME}}}} means the same as {{CURRENTMONTHNAMEGEN}}.
Templates and Transcluding Pages
- Main article: Wikipedia:Transclusion
Templates are segments of Wiki markup that are meant to be copied automatically ("transcluded") into a page. You add them by putting the template's name in {{double braces}}. It is also possible to transclude other pages by using {{:colon and double braces}}.
There are three pairs of tags that can be used in Wikitext to control how transclusion affects parts of a template or article. They determine whether or not wikitext renders, either in its own article, which we will call "here", or in another article where it is transcluded, which we will call "there".
- <noinclude>: the content will not be rendered there. These tags have no effect here.
- <includeonly>: the content will render only there, and will not render here (like Invisible ink made visible by means of transclusion).
- <onlyinclude>: the content will render here and will render there, but it will only render there what is between these tags.
There can be several such section "elements". Also, they can be nested. All possible renderings are achievable. For example, to render there one or more sections of the page here use <onlyinclude> tags. To append text there, wrap the addition in <includeonly> tags above, within, or below the section. To omit portions of the section, nest <noinclude> tags within it.
If a page is transcluded without transclusion markup, it may cause an unintentional categorization. Any page transcluding it will contain the same category as the original page. Wrap the category markup with <noinclude> tags to prevent incorrect categorization.
Some templates take parameters, as well, which you separate with the pipe character.
What it looks like | What you type |
---|---|
{{Transclusion demo}} | |
{{Help:Transclusion Demo}} | |
This template takes two parameters, and creates underlined text with a hover box for many modern browsers supporting CSS: Hover your mouse over this text Go to this page to see the H:title template itself: {{H:title}} |
This template takes two parameters, and creates underlined text with a hover box for many modern browsers supporting CSS: {{H:title|This is the hover text| Hover your mouse over this text}} Go to this page to see the H:title template itself: {{tl|H:title}} |
HTML
Many HTML tags can be used in in Wiki markup, see Help:HTML in wikitext for a list.