Help:Editing

From Gentoo Linux Wiki

Jump to: navigation, search

Wiki Manual

Help Contents

Getting Started

Wiki Information

Translated Wiki

Other

Things To Do

edit

Copied From Wikipedia and specifically here

1 Gentoo Wiki specific introduction
2 The wiki markup

[edit] Gentoo Wiki specific introduction

The Gentoo Linux Wiki is a WikiWiki, meaning that anyone can easily edit any article and have those changes posted immediately.

[edit] The wiki markup

In the left column of the table below, you can see what effects are possible. In the right column, you can see how those effects were achieved. In other words, to make text look like it looks in the left column, type it in the format you see in the right column.

You may want to keep this page open in a separate browser window for reference. If you want to try out things without danger of doing any harm, you can do so in the Sandbox.

[edit] Sections, paragraphs, lists and lines

What it looks like	What you type
Start your sections as follows: New section Subsection Sub-subsection	== New section == === Subsection === ==== Sub-subsection ====
A single newline has no effect on the layout. These can be used to separate sentences within a paragraph. Some editors find that this aids editing and improves the diff function. But an empty line starts a new paragraph.	A single newline has no effect on the layout. These can be used to separate sentences within a paragraph. Some editors find that this aids editing and improves the ''diff'' function. But an empty line starts a new paragraph.
You can break lines without starting a new paragraph.	You can break lines<br /> without starting a new paragraph.
Lists are easy to do: start every line with a star more stars means deeper levels	* Lists are easy to do: start every line with a star * more stars means deeper levels
Numbered lists are also good very organized easy to follow	# Numbered lists are also good ## very organized ## easy to follow
You can even do mixed lists and nest them like this	* You can even do mixed lists # and nest them #* like this
Definition list list of definitions item the item's definition	; Definition list : list of definitions ; item : the item's definition One item per line, no hard NEWLINE.
A colon indents a line or paragraph. A manual newline starts a new paragraph. This is primarily for displayed material, but is also used for discussion on Talk pages.	: A colon indents a line or paragraph. A manual newline starts a new paragraph.
IF a line starts with a space THEN it will be formatted exactly as typed; in a fixed-width font; lines won't wrap; ENDIF this is useful for: * pasting preformatted text; * algorithm descriptions; * program source code; * ASCII art and chemical structures; WARNING If you make it wide, you force the whole page to be wide and hence less readable, especially for people who use lower resolutions. Never start ordinary lines with spaces.	IF a line starts with a space THEN it will be formatted exactly as typed; in a fixed-width font; lines won't wrap; ENDIF this is useful for: * pasting preformatted text; * algorithm descriptions; * program source code; * ASCII art and chemical structures;
Centered text.	<center>Centered text.</center>
A horizontal dividing line: this is above it and this is below it. Mainly useful for separating threads on Talk pages.	A horizontal dividing line: this is above it ---- and this is below it.
Note: This is a note Warning: This is a warning	{{Box_Note\|This is a note}} {{Box_Warning\|This is a warning}}

[edit] Links, URLs, images

What it looks like	What you type
London has public transport. First letter of target is automatically capitalized. Internally spaces are automatically represented as underscores (typing an underscore has the same effect as typing a space, but is not recommended). Thus the link above is to http://gentoo-wiki.com/Public_transport, which is the article with the name "Public transport". See also Wikipedia:Canonization.	London has [[public transport]].
Wikipedia:World Heritage Sites#New Zealand is an example link to a section name on a page, see == headers == above. Links to non-existent sections aren't broken, they are treated as links to the top of the page.	[[Wikipedia:World Heritage Sites#New Zealand]]
Same target, different name: answers. (This is a piped link.)	Same target, different name: [[wiki FAQ\|answers]]
Endings are blended into the link: sandboxes	Endings are blended into the link: [[sandbox]]es
When adding a comment to a Talk page, you should sign it. You can do this by adding three tildes for your user name: Thrasher or four for user name plus date/time: Thrasher 08:10 Oct 5, 2002 (UTC)	When adding a comment to a Talk page, you should sign it. You can do this by adding three tildes for your user name: : ~~~ or four for user name plus date/time: : ~~~~
How to hack gentoo is a page that doesn't exist yet. You can create it by clicking on the link. To create a new page: Create a link to it on some other page. Save that page. Click on the link you just made. The new page will open for editing. After creating a page, search for its title and make sure that everyone correctly links to it.	[[How to hack gentoo]] is a page that doesn't exist yet.
Help:Editing is this page. Self links appear as bold text when the article is viewed.	[[Help:Editing]] is this page.
net-im/pidgin is a link to portage on Gentoo-Portage.com	[[Gentoo-Portage:net-im/pidgin\|net-im/pidgin]] or [[Ebuild:net-im/pidgin\|net-im/pidgin]]
Redirect one article title to another by putting text like this in its first line. Note that redirects to sections do not work yet. #REDIRECT [[example#example]] will redirect to the example page, but not to any particular section on it. It is possible this feature will be implemented in future, so such redirects could be used now for future compatibility.	#REDIRECT [[example]]
To link to books, you can use Wikipedia:ISBN links. ISBN 0123456789X	ISBN 0123456789X
"What links here" and "Related changes" can be linked as: Special:Whatlinkshere/Wikipedia:How to edit a page and Special:Recentchangeslinked/Wikipedia:How to edit a page	[[Special:Whatlinkshere/Wikipedia:How to edit a page]] and [[Special:Recentchangeslinked/Wikipedia:How to edit a page]]

[edit] Character formatting

What it looks like	What you type
Emphasize, strongly, very strongly. These are double and triple apostrophes (single-quote marks), not double-quote marks. Note that on almost all browsers, these appear as italic and bold; for semantic reasons, <i> and <b> are preferable in mathematical formulas.	''Emphasize'', '''strongly''', '''''very strongly'''''.
A typewriter font for `technical terms`. For semantic reasons, <code> should be used instead when writing computer programs	A typewriter font for <tt>technical terms</tt>.
You can use small text for captions.	You can use <small>small text</small> for captions.
You can ~~strike out deleted material~~ and underline new material.	You can <strike>strike out deleted material</strike> and <u>underline new material</u>.
Umlauts and accents: (See wikipedia:Special characters) � � � � � � À Á Â Ã Ä Å Æ Ç È É Ê Ë Ì Í Î Ï Ñ Ò Ó Ô Õ Ö Ø Ù Ú Û Ü ß à á â ã ä å æ ç è é ê ë ì í î ï ñ ò ó ô œ õ ö ø ù ú û ü ÿ	� � � � � � À Á Â Ã Ä Å Æ Ç È É Ê Ë Ì Í Î Ï Ñ Ò Ó Ô Õ Ö Ø Ù Ú Û Ü ß à á â ã ä å æ ç è é ê ë ì í î ï ñ ò ó ô &oelig; õ ö ø ù ú û ü ÿ
Punctuation: ¿ ¡ § ¶ † ‡ • — ‹ › « » ‘ ’ “ ”	¿ ¡ § ¶ &dagger; &Dagger; • — &lsaquo; &rsaquo; « » ‘ ’ “ ”
Commercial symbols: ™ © ® ¢ € ¥ £ ¤	™ © ® ¢ € ¥ £ ¤
Subscript: x₂ Superscript: x² or x² The latter method of superscript can't be used in the most general context, but is preferred when possible (as with units of measurement) because most browsers have an easier time formatting lines with it. ε₀ = 8.85 × 10⁻¹² C² / J m. 1 hectare = 1 E4 m�	Subscript: x<sub>2</sub> Superscript: x<sup>2</sup> or x² ε<sub>0</sub> = 8.85 × 10<sup>−12</sup> C² / J m. 1 hectare = 1 E4 m�
Greek characters: α β γ δ ε ζ η θ ι κ λ μ ν ξ ο π ρ σ ς τ υ φ χ ψ ω Γ Δ Θ Λ Ξ Π Σ Φ Ψ Ω	α β γ δ ε ζ η θ ι κ λ μ ν ξ ο π ρ σ &sigmaf; τ υ φ χ ψ ω Γ Δ Θ Λ Ξ Π Σ Φ Ψ Ω
Math characters: ∫ ∑ ∏ √ − ± ∞ ≈ ∝ ≡ ≠ ≤ ≥ → × · ÷ ∂ ′ ″ ∇ ‰ ° ∴ ℵ ø ∈ ∉ ∩ ∪ ⊂ ⊃ ⊆ ⊇ ¬ ∧ ∨ ∃ ∀ ⇒ ⇔ → ↔ (See also WikiProject Mathematics)	∫ ∑ ∏ √ − ± ∞ ≈ &prop; &equiv; ≠ ≤ ≥ → × · ÷ ∂ ′ ″ ∇ &permil; ° &there4; &alefsym; ø ∈ ∉ ∩ ∪ ⊂ ⊃ &sube; &supe; ¬ &and; &or; ∃ ∀ ⇒ ⇔ → ↔
x² ≥ 0 true. To space things out, use non-breaking spaces - ` `. ` ` also prevents line breaks in the middle of text, this is useful in formulas.	<i>x</i><sup>2</sup>  ≥  0 true.
Complicated formulae: <math>\sum_{n=0}^\infty \frac{x^n}{n!}</math> See Wikipedia:TeX markup	<math>\sum_{n=0}^\infty \frac{x^n}{n!}</math>
Suppressing interpretation of markup: Link → (<i>to</i>) the [[Gentoo-Portage Wiki FAQ]] Used to show literal data that would otherwise have special meaning. Escapes all Wikipedia:wiki markup, including that which looks like HTML tags. Does not escape HTML character references. To escape HTML character references such as `→` use `&rarr;`	<nowiki>Link → (<i>to</i>) the [[Wikipedia FAQ]]</nowiki>
Commenting page source: not shown in page Used to leave comments in a page for future editors.	<!-- comment here -->
ISO-8859-1 Code Character Set According to Hypertext Markup Language - 2.0 and HTML 4.01 Specification - Unused Horizontal tab Line feed - Unused Carriage Return - Unused Space ! Exclamation mark " Quotation mark # Number sign $ Dollar sign % Percent sign & Ampersand ' Apostrophe ( Left parenthesis ) Right parenthesis * Asterisk + Plus sign , Comma - Hyphen . Period (fullstop) / Solidus (slash) 0 - 9 Digits 0-9 : Colon ; Semi-colon < Less than = Equals sign > Greater than ? Question mark @ Commercial at A - Z Letters A-Z [ Left square bracket \ Reverse solidus (backslash) ] Right square bracket ^ Caret _ Horizontal bar (underscore) ` Acute accent a - z Letters a-z { Left curly brace \| Vertical bar } Right curly brace ~ Tilde Unused-Space Character € Unused-Euro Unused-Unknown ‚ Unused-Comma ƒ Unused-Franc „ Unused-Small Double Comma … Unused-Elipses † Unused-Cross ‡ Unused-Double Dagger ˆ Unused-Circumflex Accent ‰ Unused-Unknown Š Unused-Capital S with Inverted Circumflex ‹ Unused-Small Less Than Œ Unused-OE dipthong (ligature) Unused-Unknown Ž Unused-Capital Z with Inverted Circumflex Unused-Unknown Unused-Unknown ‘ Unused-Left Single Quote ’ Unused-Right Single Quote “ Unused-Left Double Quote ” Unused-Right Double Quote • Unused-Dot – Unused-Hyphen — Unused-Double Hyphen ˜ Unused-Small Tilde ™ Unused-Small Trade Mark š Unused-Small s with Inverted Circumflex › Unused-Small Greater Than œ Unused-oe dipthong (ligature) Unused-Unknown ž Unused-Small z with Inverted Circumflex Ÿ Unused-Capital Y Umlaut Non-breaking Space ¡ Inverted exclamation ¢ Cent sign £ Pound sterling ¤ General currency sign ¥ Yen sign ¦ Broken vertical bar § Section sign ¨ Umlaut (dieresis) © Copyright ª Feminine ordinal « Left angle quote, guillemotleft ¬ Not sign Soft hyphen ® Registered trademark ¯ Macron accent ° Degree sign ± Plus or minus ² Superscript two ³ Superscript three ´ Acute accent µ Micro sign ¶ Paragraph sign · Middle dot ¸ Cedilla ¹ Superscript one º Masculine ordinal » Right angle quote, guillemotright ¼ Fraction one-fourth ½ Fraction one-half ¾ Fraction three-fourths ¿ Inverted question mark À Capital A, grave accent Á Capital A, acute accent Â Capital A, circumflex accent Ã Capital A, tilde Ä Capital A, dieresis or umlaut mark Å Capital A, ring Æ Capital AE dipthong (ligature) Ç Capital C, cedilla È Capital E, grave accent É Capital E, acute accent Ê Capital E, circumflex accent Ë Capital E, dieresis or umlaut mark Ì Capital I, grave accent Í Capital I, acute accent Î Capital I, circumflex accent Ï Capital I, dieresis or umlaut mark Ð Capital Eth, Icelandic Ñ Capital N, tilde Ò Capital O, grave accent Ó Capital O, acute accent Ô Capital O, circumflex accent Õ Capital O, tilde Ö Capital O, dieresis or umlaut mark × Multiply sign Ø Capital O, slash Ù Capital U, grave accent Ú Capital U, acute accent Û Capital U, circumflex accent Ü Capital U, dieresis or umlaut mark Ý Capital Y, acute accent Þ Capital THORN, Icelandic ß Small sharp s, German (sz ligature) à Small a, grave accent á Small a, acute accent â Small a, circumflex accent ã Small a, tilde ä Small a, dieresis or umlaut mark å Small a, ring æ Small ae dipthong (ligature) ç Small c, cedilla è Small e, grave accent é Small e, acute accent ê Small e, circumflex accent ë Small e, dieresis or umlaut mark ì Small i, grave accent í Small i, acute accent î Small i, circumflex accent ï Small i, dieresis or umlaut mark ð Small eth, Icelandic ñ Small n, tilde ò Small o, grave accent ó Small o, acute accent ô Small o, circumflex accent õ Small o, tilde ö Small o, dieresis or umlaut mark ÷ Division sign ø Small o, slash ù Small u, grave accent ú Small u, acute accent û Small u, circumflex accent ü Small u, dieresis or umlaut mark ý Small y, acute accent þ Small thorn, Icelandic ÿ Small y, dieresis or umlaut mark	- Unused Horizontal tab Line feed - Unused Carriage Return - Unused Space ! Exclamation mark " Quotation mark # Number sign $ Dollar sign % Percent sign & Ampersand ' Apostrophe ( Left parenthesis ) Right parenthesis * Asterisk + Plus sign , Comma - Hyphen . Period (fullstop) / Solidus (slash) 0 - 9 Digits 0-9 : Colon ; Semi-colon < Less than = Equals sign > Greater than ? Question mark @ Commercial at A - Z Letters A-Z [ Left square bracket \ Reverse solidus (backslash) ] Right square bracket ^ Caret _ Horizontal bar (underscore) ` Acute accent a - z Letters a-z { Left curly brace \| Vertical bar } Right curly brace ~ Tilde Unused-Space Character Unused-Euro Unused-Unknown Unused-Comma Unused-Franc Unused-Small Double Comma Unused-Elipses Unused-Cross Unused-Double Dagger Unused-Circumflex Accent Unused-Unknown Unused-Capital S with Inverted Circumflex Unused-Small Less Than Unused-OE dipthong (ligature) Unused-Unknown Unused-Capital Z with Inverted Circumflex Unused-Unknown Unused-Unknown Unused-Left Single Quote Unused-Right Single Quote Unused-Left Double Quote Unused-Right Double Quote Unused-Dot Unused-Hyphen Unused-Double Hyphen Unused-Small Tilde Unused-Small Trade Mark Unused-Small s with Inverted Circumflex Unused-Small Greater Than Unused-oe dipthong (ligature) Unused-Unknown Unused-Small z with Inverted Circumflex Unused-Capital Y Umlaut   Non-breaking Space ¡ Inverted exclamation ¢ Cent sign £ Pound sterling ¤ General currency sign ¥ Yen sign ¦ Broken vertical bar § Section sign ¨ Umlaut (dieresis) © Copyright ª Feminine ordinal « Left angle quote, guillemotleft ¬ Not sign Soft hyphen ® Registered trademark ¯ Macron accent ° Degree sign ± Plus or minus ² Superscript two ³ Superscript three ´ Acute accent µ Micro sign ¶ Paragraph sign · Middle dot ¸ Cedilla ¹ Superscript one º Masculine ordinal » Right angle quote, guillemotright ¼ Fraction one-fourth ½ Fraction one-half ¾ Fraction three-fourths ¿ Inverted question mark À Capital A, grave accent Á Capital A, acute accent Â Capital A, circumflex accent Ã Capital A, tilde Ä Capital A, dieresis or umlaut mark Å Capital A, ring Æ Capital AE dipthong (ligature) Ç Capital C, cedilla È Capital E, grave accent É Capital E, acute accent Ê Capital E, circumflex accent Ë Capital E, dieresis or umlaut mark Ì Capital I, grave accent Í Capital I, acute accent Î Capital I, circumflex accent Ï Capital I, dieresis or umlaut mark Ð Capital Eth, Icelandic Ñ Capital N, tilde Ò Capital O, grave accent Ó Capital O, acute accent Ô Capital O, circumflex accent Õ Capital O, tilde Ö Capital O, dieresis or umlaut mark × Multiply sign Ø Capital O, slash Ù Capital U, grave accent Ú Capital U, acute accent Û Capital U, circumflex accent Ü Capital U, dieresis or umlaut mark Ý Capital Y, acute accent Þ Capital THORN, Icelandic ß Small sharp s, German (sz ligature) à Small a, grave accent á Small a, acute accent â Small a, circumflex accent ã Small a, tilde ä Small a, dieresis or umlaut mark å Small a, ring æ Small ae dipthong (ligature) ç Small c, cedilla è Small e, grave accent é Small e, acute accent ê Small e, circumflex accent ë Small e, dieresis or umlaut mark ì Small i, grave accent í Small i, acute accent î Small i, circumflex accent ï Small i, dieresis or umlaut mark ð Small eth, Icelandic ñ Small n, tilde ò Small o, grave accent ó Small o, acute accent ô Small o, circumflex accent õ Small o, tilde ö Small o, dieresis or umlaut mark ÷ Division sign ø Small o, slash ù Small u, grave accent ú Small u, acute accent û Small u, circumflex accent ü Small u, dieresis or umlaut mark ý Small y, acute accent þ Small thorn, Icelandic ÿ Small y, dieresis or umlaut mark

[edit] Common Formatting

To keep a consistant look throughout the wiki we have setup some templates to help keep things familiar; use these wherever appropriate.

Template Listing

[edit] Tables

[edit] Placement of the Table of Contents (TOC)

At the current status of the wiki markup language, at least four headers trigger the TOC in front of the first header (or after introductory sections). Putting __NOTOC__ anywhere forces the TOC to disappear.

[edit] Tables

There are two ways to build tables:

in special Wiki-markup (see Using tables)
with the usual HTML elements: <table>, <tr>, <td> or <th>.

[edit] Variables

Code	Effect
{{CURRENTMONTH}}	05
{{CURRENTMONTHNAME}}	May
{{CURRENTMONTHNAMEGEN}}	May
{{CURRENTDAY}}	16
{{CURRENTDAYNAME}}	Friday
{{CURRENTYEAR}}	2008
{{CURRENTTIME}}	11:21
{{NUMBEROFARTICLES}}	3,275

NUMBEROFARTICLES is the number of pages in the main namespace which contain a link and are not a redirect, i.e. number of articles, stubs containing a link, and disambiguation pages).

[edit] Transclusion

The MediaWiki software used by Wikipedia has limited support for transclusion. This means standardized text chunks (such as boilerplate text) can be inserted into articles. For example, typing {{msg:stub}} will appear as This article is a stub. You can help Wikipedia by expanding it. when the page is saved. Other commonly used ones are {{msg:disambig}} for disambiguation pages and {{msg:spoiler}} for spoiler warnings.

Retrieved from "http://www.gentoo-wiki.com/Help:Editing"

Category: Wiki Help

Help:Editing

From Gentoo Linux Wiki

Contents

[edit] Gentoo Wiki specific introduction

[edit] The wiki markup

[edit] Sections, paragraphs, lists and lines

[edit] Links, URLs, images

[edit] Character formatting

[edit] Common Formatting

[edit] Tables

[edit] Placement of the Table of Contents (TOC)

[edit] Tables

[edit] Variables

[edit] Transclusion

Views

Personal tools

Navigation

Search

Indexes

Toolbox

In other languages