সাহায্য:সম্পাদনা: সংশোধিত সংস্করণের মধ্যে পার্থক্য
বিষয়বস্তু বিয়োগ হয়েছে বিষয়বস্তু যোগ হয়েছে
আ হ ম সাকিব (আলোচনা | অবদান) "{{Wikibooks help}} {{shortcut|WB:EDIT}} {{TOC left|limit=3}} Wikibooks is a wiki, which means that anyone can easily edit any unprotected p..." দিয়ে পাতা তৈরি ট্যাগ: মোবাইল সম্পাদনা মোবাইল ওয়েব সম্পাদনা |
আ হ ম সাকিব (আলোচনা | অবদান) সম্পাদনা সারাংশ নেই ট্যাগ: মোবাইল সম্পাদনা মোবাইল ওয়েব সম্পাদনা |
||
৭ নং লাইন:
[[File:English Wikibooks editing.png|475px|thumb|center|What you'll see when you go to edit a page.]]
<br style="clear:left;" />
== Composition of an edit page ==
The editing page consists of these sections:
* [[#Edit toolbar|Edit toolbar]]
* Editing text box
* [[#Edit summary|Edit summary]] box
* [[#Minor edit checkbox|Minor edit]], [[Help:Tracking changes#Watching pages|Watch this page]] checkboxes
* Save page, [[#Show preview button|Show preview]], [[Help:Tracking changes#Viewing diffs|Show changes]] buttons
* Cancel, Editing help links
* A list of [[Help:Template|template]]s used on the page
* A preview, if you have requested one. Your preferences may place the preview at the top of the page instead.
===Edit toolbar===
The '''edit toolbar''' above the editing text box helps you produce '''wiki markup''', instructions used to stylize text on a wiki page. In the edit toolbar above the editing text box seen when editing a page, if you click ''Help'' you can see what effects are possible with wiki markup. Another way you can learn how to produce specific effects is to click ''Edit'' on a page that contains the effect you wish to copy and see what markup is used.
{| class="wikitable" style="width:100%;"
! width="26%" | Name
! width="36%" | Markup
! width="37%" | Displays
|-
! colspan="3" style="text-align:left; background-color:#cccccc;" | Basic
|-
| [[File:Toolbaricon_bold_B.png|link=]] Bold
| <syntaxhighlight lang="moin">Make text '''bold'''</syntaxhighlight>
| Make text '''bold'''
|-
| [[File:Toolbaricon_italic_I.png|link=]] Italic
| <syntaxhighlight lang="moin">Make text ''italic''</syntaxhighlight>
| Make text ''italic''
|-
| [[File:Button_underline_he.png|link=]] Underline
| <syntaxhighlight lang="html">Make text<u>underlined</u></syntaxhighlight>
| Make text <u>underlined</u>
|-
| [[File:Vector_strikeout.png|link=]] Strikeout
| <syntaxhighlight lang="html"><s>Strike out</s> text</syntaxhighlight>
| <s>Strike out</s> text
|-
| [[File:Vector_toolbar_insert_link_button.png|link=]] [[#Links|Link]]
| <syntaxhighlight lang="moin">Link to [[Help:Contents|a page]], [[#Sections|a section of a page]] or an [http://www.wikimedia.org external page].</syntaxhighlight>
| Link to [[Help:Contents|a page]], [[#Sections|a section of a page]] or an [http://www.wikimedia.org external page].
|-
| [[File:Vector toolbar insert image button.png|link=]] Embed [[Help:Files|file]]
| <syntaxhighlight lang="moin">[[File:Vector toolbar insert image button.png]]</syntaxhighlight>
| [[File:Vector toolbar insert image button.png]]
|-
| [[File:Vector toolbar insert reference button.png|link=]] Insert [[#References|references]]
| <syntaxhighlight lang="xml">Example text<ref>It is a note!</ref></syntaxhighlight>
| Example text<span style="color:#002bb8"><sup>[1]</sup></span>
|-
| [[File:Vector toolbar signature button.png|link=]] Signature
| <syntaxhighlight lang="text">Thanks guys --~~~~</syntaxhighlight>
| Thanks guys --[[User:Example|Example]] 07:46, 27 November 2005 (UTC)
|-
! colspan="3" style="text-align:left; background-color:#cccccc;" | Advanced
|-
| <span style="padding: 4px; color: #333; border:1px solid silver; background: white; cursor: pointer"> Heading [[File:MediaWiki_Vector_skin_action_arrow.png|link=]]</span> Dropdown list for headings of different levels
| <syntaxhighlight lang="moin">
== Level 2 (Section heading) ==
=== Level 3 ===
==== Level 4 ====
===== Level 5 =====</syntaxhighlight>
| {{hiddenh2|Level 2 (Section heading)}}{{hiddenh3|Level 3}}{{hiddenh4|Level 4}}{{hiddenh5|Level 5}}
|-
| <span style="padding: 4px; color: #333; border:1px solid silver; background: white; cursor: pointer"> Text Type [[File:MediaWiki_Vector_skin_action_arrow.png|link=]]</span> Dropdown list for text or programming code of different types
| <syntaxhighlight lang="xml"><tt>Teletype text</tt>, <code>inline code</code>, <source lang="text">generic source code</source></syntaxhighlight>
| <tt>Teletype text</tt>, <code>inline code</code>, <syntaxhighlight lang="text">generic source code</syntaxhighlight>
|-
| [[File:Vector toolbar bulleted list button.png|link=]] Insert a bulleted [[#Lists|list]] item
| <syntaxhighlight lang="text">* Bulleted list item</syntaxhighlight>
|
* Bulleted list item
|-
| [[File:Vector toolbar numbered list button.png|link=]] Insert a numbered [[#Lists|list]] item
| <syntaxhighlight lang="text"># Numbered list item</syntaxhighlight>
|
# Numbered list item
|-
| [[File:Vector toolbar indentation button.png|link=]] Text indentation
| <syntaxhighlight lang="text">:Indented line</syntaxhighlight>
|
:Indented line
|-
| [[File:Vector toolbar no wiki formatting button.png|link=]] Ignore wiki markup
| <syntaxhighlight lang="xml"><nowiki><math>2^3</math></nowiki></syntaxhighlight>
| <syntaxhighlight lang="text"><math>2^3</math></syntaxhighlight>
|-
| [[File:Vector toolbar insert new line button.png|link=]] Insert new line
| <syntaxhighlight lang="html"> example <br /> text</syntaxhighlight>
| example <br /> text
|-
| [[File:Vector toolbar big text button.png|link=]] Big text
| <syntaxhighlight lang="html"><big>Big text</big></syntaxhighlight>
| <big>Big text</big>
|-
| [[File:Vector toolbar small text button.png|link=]] Small text
| <syntaxhighlight lang="html"><small>Small text</small></syntaxhighlight>
| <small>Small text</small>
|-
| [[File:Vector toolbar superscript button.png|link=]] Superscript text
| <syntaxhighlight lang="html"><sup>Superscript text</sup></syntaxhighlight>
| <sup>Superscript text</sup>
|-
| [[File:Vector toolbar subscript button.png|link=]] Superscript text
| <syntaxhighlight lang="html"><sub>Subscript text</sub></syntaxhighlight>
| <sub>Subscript text</sub>
|-
| [[File:Vector toolbar insert picture gallery button.png|link=]] Insert picture [[Help:Files#Galleries|gallery]]
| <syntaxhighlight lang="xml">
<gallery>
File:Example.jpg|Caption1
File:Example.jpg|Caption2
</gallery></syntaxhighlight>
|
<gallery>
File:Example.jpg|Caption1
File:Example.jpg|Caption2
</gallery>
|-
| [[File:Vector toolbar insert table button.png|link=]] Insert [[Help:Tables|table]] (opens a configuration window to select the number of rows and columns and some other options)
| <syntaxhighlight lang="text">
{| class="wikitable"
|-
! Header text
|-
| Example
|}
</syntaxhighlight>
|
{| class="wikitable"
|-
! Header text
|-
| Example
|}
|-
| [[File:Vector toolbar redirect button.png|link=]] Page [[#Redirecting|redirect]]
| <syntaxhighlight lang="text">#REDIRECT [[WB:HELP]]</syntaxhighlight>
| [[File:Redirect arrow without text.svg|link=|#REDIRECT]] [[WB:HELP]]
|-
| [[File:Vector toolbar search-replace button.png|link=]] Search and replace
| Opens the search and replace window
|}
==={{anchor|Edit summaries}}Edit summary===
{{shortcut|WB:ES}}
An '''edit summary''' is a brief explanation of an edit to a Wikibooks page. When you edit a page there is a small text entry field, which is labeled "Edit summary", located under the main edit box and above the "Save page" button. Edit summaries are displayed in lists of changes (such as [[Help:Tracking changes#Page history|page histories]] and [[Help:Tracking changes#Watching pages|watchlists]]), and at the top of [[Help:Tracking changes#Viewing diffs|diff]] pages.
It is good practice to fill in the "Edit summary" field, or add to it in the case of [[#Sections|section editing]], as this helps others to understand the intention of your edit. To avoid accidentally leaving edit summaries blank, you can select "Prompt me when entering a blank edit summary" on the Editing tab of your [[Special:Preferences|user preferences]], if you have created an account.
====Always provide an edit summary====
It is considered good practice to always provide an edit summary, but it is especially important when [[#Reverting|reverting]] the actions of other editors, or if you delete any text; otherwise, people may question your motives for the edit.
Accurate summaries help other editors decide whether it is worthwhile for them to check a change, and to understand it if they choose to check it. Summaries are less essential for "[[#Minor edit|minor changes]]", but a summary like "fixed spelling" is helpful even then.
====Qualities of good summaries====
* ''Summarize''. Summarize the change, even if only briefly; even a short summary is better than no summary.
* ''Explain''. Give reasons for the change, if there is a reasonable chance that other editors may be unclear as to why it was made.
* ''Abbreviations''. Experienced users, especially those with many edits to make, will often use abbreviations in order to save time; for example, "rv" for "[[#Reverting|revert]]", or shortcuts for Wikibooks policies and related pages, e.g. "WB:WIW" for [[Wikibooks:What is Wikibooks]] (see [[Wikibooks:Shortcuts]]). Abbreviations should be used with care, although they save one editor time they may cost readers much more time to figure out what they mean, they can be confusing for inexperienced users, but they are generally fine for small edits such as formatting and grammar changes.
* ''Talk pages''. When editing [[WB:TALK|talk pages]], consider copying your comment to the edit summary, especially if it is brief; this allows users to check Recent changes, Page history and User contributions very efficiently. It also reduces the load on the servers.
* ''Harmony between text and edit summary''. Make sure that important information is not only included in the edit summary. This applies especially on talk pages. Readers who only see the text may miss that important information, and they may then respond inappropriately through no fault of their own. Try to prevent misunderstandings. If an edit requires more explanation than will fit in the edit summary box, use the ''Discussion'' page instead, and put in the edit summary "see talk" or "see discussion".
* ''Avoid misleading summaries''. Mentioning one change but not another one can be misleading to someone who finds the other one more important; add "and misc." to cover the other changes.
* ''Avoid inappropriate summaries''. Editors should explain their edits, but not be overly critical or harsh when editing or reverting others' work. This may be perceived as uncivil, and cause tension or bad feelings, which makes collaboration more difficult. Explain what you changed, and cite the relevant policies, guidelines, or principles of good writing, but try not to single out others in a way that may come across as an attack.
====Properties====
* ''Limited to 200 characters''. The edit summary box can hold one line of 200 characters. If you attempt to type or paste more, only the first 200 characters will be displayed—the rest will be discarded. For example attempting to add 10 new characters (at the end or in between) to a summary already containing 195 characters will result in the first 5 new characters being inserted and the second 5 being disregarded.
* ''Can be previewed''. The [[#Show preview button|"Show preview" button]] also provides a preview of the edit summary to facilitate checking links.
* ''Can't be changed after saving''. After you save the page, you cannot change the edit summary.
* ''Doesn't appear in searches''. The [[WB:SEARCH|search function]] cannot search edit summaries, and they are not indexed by external search engines.
* ''Wikilinks always rendered; other wikitext coding ignored''. Text in edit summaries renders internal links, including [[#Pipe links|piped links]], and [[#Interwiki links|interwiki links]], even when enclosed within <nowiki><nowiki> and </nowiki></nowiki>. Therefore, copying wikitext in the edit summary box may be preferable to copying text from the preview, except when one wants to save space. Other wikitext coding is not interpreted.
* ''URLs''. When copying an external link from the preview into the edit summary box then, depending on the operating system, the "printable version" is copied, i.e. how it is normally rendered, and in addition, between parentheses, the URL; hence the same information as in the wikitext, but in a different format, as well as a possible sequential number.
==={{anchor|Minor edits|Minor edit}}Minor edit checkbox===
{{shortcut|WB:MINOR}}
A check to the '''minor edit''' box signifies that only superficial differences exist between the current and previous versions. Examples include typographical corrections, formatting and presentational changes, rearrangement of text without modification of content, etc. A ''minor edit'' is one that the editor believes requires no review and could never be the subject of a dispute, such as changing "teh" to "the". An edit of this kind is marked in its page's [[Help:Tracking changes#Page history|revision history]] with a lower case, bolded "m" character ('''m''').
By contrast, a major edit is one that should be reviewed for its acceptability to all concerned editors. Therefore, any change that affects the ''meaning'' of a page is not minor, even if the edit concerns a single word; for example, the addition or removal of "not", which can change the meaning of a sentence, is a major edit.
Because editors may choose to ignore minor edits when reviewing [[Help:Tracking changes#Recent changes|recent changes]], the distinction between major and minor edits is significant. Logged-in users might even set their preferences to not display minor edits. If there is any chance that another editor might dispute a change, it is best not to mark the edit as minor.
Users who are not [[WB:LOGIN|logged in]] to Wikibooks are not permitted to mark changes as minor because of the potential for vandalism. The ability to mark changes as minor is one of many reasons to register.
A good rule of thumb is that edits consisting solely of spelling corrections, formatting changes, or rearrangement of text without modification of content should be flagged as minor edits.
==== When to mark an edit as a minor edit ====
* Spelling and grammatical corrections
* Simple formatting (''e.g.'', capitalization, punctuation, or properly adding italics to non-English words, like ''folie des grandeurs'')
* Formatting that does not change the meaning of the page (''e.g.'', moving a picture, splitting one paragraph into two—where this is not contentious)
* Obvious factual errors (''e.g.'', changing "Nixon resigned in 1874" to "Nixon resigned in 1974")
* Fixing layout errors
* Adding or correcting [[#Wikilinks|wikilinks]], or fixing broken references already present in the page
* Removing [[Wikibooks:Vandalism|vandalism]] and graffiti
==== Things to remember ====
* Any change to the source text, even if it does not affect the presentation of the page in [[HTML]] (if it involves adding a space or a line break, for example) will still be treated as a change according to the database.
* Marking a major change as a minor one is considered poor etiquette, especially if the change involves the deletion of some text.
* [[#Reverting|Reverting]] a page is not likely to be considered minor under most circumstances. When the status of a page is disputed, and particularly if an [[Help:Glossary#edit war|edit war]] is brewing, then it is better not to mark ''any'' edit as minor. Reverting blatant vandalism is an exception to this rule.
* If you ''accidentally'' mark an edit as minor when it was in fact a major edit, you should make a second edit, or dummy edit, noting in the dummy's edit summary that the previous edit was major. As a trivial edit to be made for this purpose, just opening the edit box and saving (''i.e.'' changing nothing) will not work; neither will adding a blank space at the end of a line or a blank line at the end of the page—in these cases the edit is cancelled and the edit summary discarded. However, one can, for example, add an extra space between two words. This will be preserved in the wikitext and recorded as a change, although it will not change the page's appearance when rendered.
* It may be worth communicating any disagreement about what is minor via Talk or a message to the contributor, being careful to avoid a flame war ("I thought your change was a bit more than minor—maybe I am being over-sensitive?"). There is a grey area, and many contributors will appreciate feedback on whether they've got it right.
* Marking your change as minor affects how it displays in some [[Help:Tracking changes#Watching pages|editors' watchlists]]. If, for example, you mark your talk page comments as "minor", then fewer editors are likely to notice your comment.
==== Exceptions ====
[[Wikibooks:Administrators|Administrators]] and [[Wikibooks:Reviewers|reviewers]] can semi-automatically revert the edits of the last editor of a page; all such [[#Rollback|rollback]] reversions are marked as minor by the wiki software. The intended use of the rollback feature is for cases of vandalism, where the act of reverting any vandalism should be considered minor (and can be ignored in the recent changes list).
==={{anchor|Showing previews|Show preview}}Show preview button===
{{shortcut|WB:PREVIEW}}
Below the edit box is a '''Show preview''' button. Pressing this will show you what the page will look like without actually saving it. It is strongly recommended that you use this prior to saving. This allows you to check what the page will look like first and to check that you haven't made any errors. It also prevents the need for multiple saves. Saving the same page a large number of times in quick succession makes it harder for people to check what changed, and clogs up the [[Help:Tracking changes#Page history|page history]].
It is helpful, to save the page before moving, breaking apart, or combining sections of the page, if you have been making small edits to the page. The difference display is not good at showing paragraph moves, and will not display the small edits clearly if sections are then moved around.
Saving only once is also a way of avoiding [[#Edit conflict|edit conflicts]], as people will not see the page on [[Help:Tracking changes#recent changes|recent changes]], and therefore they are less likely to try editing it at the same time as you.
If you are [[WB:LOGIN|logged in]], you can set your [[Special:Preferences|preferences]] to show the preview before the edit box instead of after it. If you select this option, the preview will be displayed above the edit box when you click the "Show preview" button while editing a page. See [[Help:Account management#Preferences]].
Using show preview also prevents your login timing out, which would mean your edits would not be attributed to your user name. Clicking preview regularly will restart the timer, so you remain logged in. Also, if you are no longer logged in, showing a preview will make you aware of this so you can log in and save your work after that. You can check this by seeing if your user name appears in the upper-right corner when you press preview. If you are not logged in, open [[Special:Userlogin]] in a separate window (right-click "Log in" and hit "Open link in new window" or similar). Log in, then go back to your editing and hit "preview" again to make sure all is well. Note that this will clear the minor edit and watch checkboxes, so make sure they're set appropriately again before you finally save the page.
When utilizing this feature during a major edit, consider copying the content into your [[w:clipboard (software)|clipboard]]. On extremely rare occasions, the Wikibooks servers have hiccups, and you could lose your work.
When pressing "Show preview", a preview of the [[#Edit summary|edit summary]] is also obtained; thus (for example) links can be checked.
==Composition of a book page==
{{shortcut|WB:SECTION}}
==={{anchor|Section}}Sections===
'''Sections''' are created by creating their headings, as below.
<pre>
==Section==
===Subsection===
====Sub-subsection====
</pre>
Please ''do not'' use only one equals sign on a side (<nowiki>=Heading=</nowiki>). This would cause a section heading to be as large as the page's name (title).
Heading names of sections (including subsections) should be unique on a page. Using the same heading more than once on a page causes problems:
* An [[#Wikilinks|internal link (wikilink)]] to a section, in the form <nowiki>[[Pagename#Section heading]]</nowiki>, will only link to the first section on the page with that name, which may not be the intended target of the link. See [[#Section linking (anchors)|section linking]] on linking to a section.
* When a section with a duplicate name is edited, the [[Help:Tracking changes#Page history|edit history]] and [[#Edit summary|summary]] will be ambiguous as to which section was edited.
* When saving the page after a section edit, the editor's browser may navigate to the wrong section.
===={{anchor|TOC|Table of contents}}Table of contents (TOC)====
{{Shortcut|WB:TOC}}
For each page with more than three section headings, a '''table of contents (TOC)''' is automatically generated from the section headings, unless:
*(for a user) [[WB:PREFS|preferences]] are set to turn it off
*(for a page) the [[Help:Variables|magic word]] <tt><nowiki>__NOTOC__</nowiki></tt> (with ''two underscores'' on either side of the word) is added to the page
{{anchor|Positioning the TOC}}'''Positioning the TOC'''
When either <tt><nowiki>__FORCETOC__</nowiki></tt> or <tt><nowiki>__TOC__</nowiki></tt> (with ''two underscores'' on either side of the word) is placed in the wikitext, a TOC is added even if the page has fewer than four headings.
With <tt><nowiki>__FORCETOC__</nowiki></tt>, the TOC is placed before the first section heading. With <tt><nowiki>__TOC__</nowiki></tt>, it is placed at the same position where this code is placed. There may be some introductory text before the TOC, known as the "lead". Although usually a heading after the TOC is preferable, <tt><nowiki>__TOC__</nowiki></tt> can be used to avoid being forced to insert a meaningless heading just to position the TOC correctly, i.e., not too low.
{{anchor|Floating the TOC}}'''Floating the TOC'''
The TOC can, in some instances, be floated either right or left using {{tl|TOC right}} or {{tl|TOC left}} when it is beneficial to the layout of the page, or when the default TOC gets in the way of other elements. Before changing the default TOC to a floated TOC, consider the following guidelines:
# If a page will be adversely affected by the change, don't float the TOC.
# When floating a TOC, check whether the page layout will be harmed if the TOC is hidden by the user.
# Long lists may create very long TOCs. The TOC should not be longer than necessary, whether it is floated or not. Limiting the depth of the TOC can be used to reduce the length of the TOC by hiding nested subsections, rather than using a floating TOC (see below).
# The default TOC is placed before the first headline, but after any introductory text (unless changed by the page's editors). If the introductory summary is long enough that a typical user has to scroll down to see the top of the TOC, you may float the TOC so it appears closer to the top of the page.
# Floating a wide TOC will produce a narrow column of text for users with low resolutions. If the TOC's width exceeds 30% of the user's visible screen (about twice the size of the Wikibooks navigation bar to the left), then it is not suitable for floating. (Percentages assume a typical user setup.)
# If the TOC is placed in the general vicinity of other floated images or boxes, it can be floated as long as the flowing text column does not become narrower than 30% of the average user's visible screen width.
# A left-floated TOC may affect bulleted or numbered lists.
{{anchor|Limiting the depth of the TOC}}'''Limiting the depth of the TOC'''
When a page has a very large number of subsections (such as this page), it may be appropriate to hide lower-level subsections from the TOC. You can specify a limit for the lowest-level section that should be displayed using {{tlx|TOC|limit{{=}}''n''}}, where ''n'' is the number of = signs that are used on each side of the lowest-level section header that should be displayed (e.g. 3 to show ===sections=== but hide ====sections====). The limit=''n'' parameter can also be given to {{tl|TOC left}} or {{tl|TOC right}} the same way.
{{anchor|Linking to the TOC}}'''Linking to the TOC'''
You can make a link to the TOC using the following:
* Same page:
** wikicode: <nowiki>[[#toc|Contents]]</nowiki>
** link: [[#toc|Contents]]
* Different page:
** wikicode: <nowiki>[[Help:Wiki markup#toc|Contents]]</nowiki>
** link: [[Help:Templates#toc|Contents of Templates Help page]]
====Sections vs. separate pages====
Advantages of separate pages:
# [[WB:WLH|what links here]] feature
# separate [[WB:PH|edit histories]]
# some [[Help:Templates|template]] limits apply ''per page''
# automatic [[#Redirect|redirect]] on renaming
# loading ''one'' small page is faster than loading ''one'' large page—but are readers more likely to want to use just one section or to browse many of the sections of the topic?—see advantages of combined pages
# ''one'' small page is easier to navigate than ''one'' large page—but see above
# can separately be put in [[Help:Categories|categories]]
Advantages of one combined page with sections:
# loading ''one combined'' page is ''faster and more convenient'' than loading ''several divided'' ones
# searching within one large page or its wikitext with a local search function is faster and has advantages over searching several pages using the site search engine or a web search engine
# the automatic table of contents provides for convenient navigation.
# more likelihood of editorial cohesion of a concept compared to having several pages likely to be independently edited
# duplication of items relevant to each section is avoided
==={{anchor|Link}}Links===
{{shortcut|WB:LINK}}
{{Meta|Help:Link}}
'''Links''' give readers one-click access to other Wikibooks pages, other [[w:Wikimedia project|Wikimedia project]]s, and external websites.
===={{anchor|Wikilink}}Wikilinks====
A '''wikilink''' or '''internal link''' links a page to another page within English Wikibooks.
*<nowiki>[[Main Page]]</nowiki> gives [[Main Page]] (link to ''Main Page'', labeled ''Main Page'').
*<nowiki>[[Main Page|Home]]</nowiki> gives [[Main Page|Home]] (link to ''Main Page'', labeled ''Home'').
*<nowiki>[[Main Page]]s</nowiki> gives [[Main Page]]s, just like <nowiki>[[Main Page|Main Pages]]</nowiki> does: [[Main Page|Main Pages]].
*<nowiki>[[Main Page|Home]]s</nowiki> gives [[Main Page|Home]]s, just like <nowiki>[[Main Page|Homes]]</nowiki> does: [[Main Page|Homes]].
*<nowiki>[[Main Page]]'s</nowiki> gives [[Main Page]]'s (''punctuation'' is not appended to the link).
*<nowiki>[[Main Page]]<</nowiki>nowiki>s</nowiki> gives [[Main Page]]<nowiki>s</nowiki>.
*<nowiki>[[Main Page]]''s''</nowiki> gives [[Main Page]]''s''.
*<nowiki>''[[Main Page]]s''</nowiki> gives ''[[Main Page]]''s.
*<nowiki>[[Cookbook|Cook]]book<</nowiki>nowiki>s</nowiki> gives [[Cookbook|Cook]]book<nowiki>s</nowiki>.
Links with a specified label are said to be "[[#Piped links|piped]]" because of the pipe symbol used ( | ). For certain types of link, the label will be generated automatically if a pipe is typed with no label after it (thus saving you typing). See [[#Piped links|piped links]] below.
The link target is ''case-sensitive except for the first character'' (so [[calculus]] links to [[Calculus]], but [[CAlculus]] does not).
If the target of a wikilink does not exist, it is displayed red, and is called a [[Help:Glossary#red link|red link]]. If a red link is clicked, the user is taken to a page where it is possible to create a page under the red-linked title. Red links to a particular (non-existent) title can be detected using the [[WB:WLH|What links here]] feature.
If the target of a link is the same as the page on which it appears (a self-link), it is displayed in bold, as in [[Help:Editing]].
Attempting to link normally to a [[Help:Files|file]] page, [[Help:Categories|category]] page or [[#Interlanguage links|interlanguage link]] will produce a different effect: it will place the image on the page, add the page to the category or create an interlanguage link at the edge of the page. To override this behavior, add an initial colon, as in <code><nowiki>[[:File:Mediawiki.png]]</nowiki></code>, <code><nowiki>[[:Category:Help]]</nowiki></code>, <code><nowiki>[[:fr:Help:Contents]]</nowiki></code>.
===={{anchor|Piped link|Pipe trick}}Piped links====
A '''piped link''' is an internal [[#Wikilinks|link]] or [[#Interwiki links|interwiki link]] where the link target and link label are both specified. This is needed in the case that they are not equal, while also the link label is not equal to the link target with the last word extended. This allows linking a word or phrase within the text of a page rather than using "see also", even if the wording does not exactly correspond with the name of the target page. With a suitable browser and depending on the [[WB:PREFS|preferences]] set, one can still see the link target: when you point at the link, the name shows up in a hover box and is also shown in the status bar.
For instance: <nowiki>[[Help:Contents|Help]]</nowiki> will show as [[Help:Contents|Help]].
If in a piped link the part after the "|" is left empty, it is converted to an abbreviated form of the page name on the left, as follows:
#any word before the first colon (:), as well as the colon itself, is removed. This word may or may not be a namespace prefix (such as "Help:") or an [[#Interwiki links|interwiki prefix]] (such as "commons:").
#if there is text in parentheses at the end it will be removed
#if there are no parentheses but there is a comma, the comma and everything after it is removed
#the link will be in whatever case is used.
Just like for the four tildes when adding a signature, in a preview, the result already shows up in the preview itself, but the conversion in the edit box is not yet shown. Press "Show changes" to see the change in the wikitext.
'''Colon'''
* <nowiki>[[Help:Templates|]]</nowiki> is converted to <nowiki>[[Help:Templates|Templates]]</nowiki>, which is rendered as [[Help:Templates|Templates]]
* <nowiki>[[Programming:C++|]]</nowiki> is converted to <nowiki>[[Programming:C++|C++]]</nowiki>, which is rendered as [[Programming:C++|C++]] - even though "Programming:" is not a [[Help:Pages#Namespaces|namespace]] the shortcut works anyway
* <nowiki>[[w:Key Largo (film)|]]</nowiki> is converted to <nowiki>[[w:Key Largo (film)|Key Largo]]</nowiki>, which is rendered as [[w:Key Largo (film)|Key Largo]]
'''Case'''
*<nowiki>[[w:pipeline (Unix)|]]</nowiki> is converted to <nowiki>[[w:pipeline (Unix)|pipeline]]</nowiki> which is rendered as [[w:pipeline (Unix)|pipeline]].
*<nowiki>[[w:Pipeline (Unix)|]]</nowiki> is converted to <nowiki>[[w:Pipeline (Unix)|]]</nowiki> which is rendered as [[w:Pipeline (Unix)|Pipeline]].
'''Comma'''
* <nowiki>[[commons:Boston, Massachusetts|]]</nowiki> is converted to <nowiki>[[commons:Boston, Massachusetts|Boston]]</nowiki>, which is rendered as [[commons:Boston, Massachusetts|Boston]].
===={{anchor|Relative link|Relative links|Subpage link}}Subpage links====
Subpages can be linked to with relative links, without giving the full page name. The following example shows how we link to various pages from the hypothetical <code>Snappy Title/Logical section</code>. Note that that the full page name in the link title can be suppressed by appending another slash. For more flexibility, use a [[#Piped links|piped link]] as normal.
{| class="wikitable"
! Full page name of the link target || Relative link || Displays as
|-
| <code>Snappy Title</code> || <code><nowiki>[[../]]</nowiki></code>
| <code>Snappy Title</code>
|-
| <code>Snappy Title/Sister page</code> || <code><nowiki>[[../Sister page]]</nowiki></code>
| <code>Snappy Title/Sister page</code>
|-
| <code>Snappy Title/Sister page</code> || <code><nowiki>[[../Sister page/]]</nowiki></code>
| <code>Sister page</code>
|-
| <code>Snappy Title/Logical section/interesting topic</code> || <code><nowiki>[[/interesting topic]]</nowiki></code>
| <code>Snappy Title/Logical section/interesting topic</code>
|-
| <code>Snappy Title/Logical section/interesting topic</code> || <code><nowiki>[[/interesting topic/]]</nowiki></code>
| <code>interesting topic</code>
|}
'''Note''' that the first character of sub-pages is case-sensitive.
===={{anchor|External link}}External links====
'''External links''' use absolute [[w:URL|URL]]s to link directly to any webpage. External links are in the form <code><nowiki>[http://www.example.org link name]</nowiki></code> (resulting in [http://www.example.org link name]), with the link name separated from the URL by a space. Links without link names appear numbered: <code><nowiki>[http://www.example.org]</nowiki></code> becomes [http://www.example.org]. Links with no square brackets display in their entirety: http://www.example.org .
[[Special:LinkSearch]] finds all pages linking to a given site.
The external link syntax can also be used to link to particular page versions within Wikibooks that are not accessible by wikilinks, such as page [[Help:Tracking changes#Page history|history]], edit view, an old version of a page, the [[Help:Tracking changes#Viewing diffs|diff]] between two versions, etc.
To display a link without the arrow icon, place the external link syntax between
<tt><span class="plainlinks">...</span></tt> tags.
===={{anchor|Section link|Section links}}Section links (anchors)====
To link to a section in the same page you can use: <tt><nowiki>[[#Section name|displayed text]]</nowiki></tt>, and to link to a section in another page: <tt><nowiki>[[Page Name#Section name|displayed text]]</nowiki></tt>.
The section title in fact points to an "anchor" on the target page. It is possible to define anchors other than explicit section titles, using the [[Help:Templates|template]] {{tlx|anchor|anchor name}}. However <code><nowiki>[[#top]]</nowiki></code> and <code><nowiki>[[#toc]]</nowiki></code> are reserved names that link to the top of a page and the table of contents, respectively.
Section links still work if the wikilink is a [[#Redirect|redirect]] (for example, if [[Help:About]] redirects to [[Wikibooks:Welcome]], then [[Help:About#General Information]] will link to the "General Information" section of [[Wikibooks:Welcome]]). It is also possible to put section links inside redirects. For example, [[WB:LINK]] redirects to [[Help:Editing#Links]]. Note that an explicit section link overrides any section link in a redirect, so [[WB:LINK#Interwiki links]] will go to the "Interwiki links" section of this page. Anchor links can also be added to [[#External links|external links]] and to [[#Interwiki links|interwiki links]], again using the # syntax.
===={{anchor|Interlanguage link}}Interlanguage links====
'''Interlanguage links''' are links from any page at here at the English language Wikibooks to nearly equivalent or exactly equivalent pages in another language Wikibooks.
The interlanguage links take the following form:
:<nowiki>[[language code:Title]]</nowiki>
where the language code is the two-letter code as per [[w:ISO 639-1|ISO 639-1]]. (See [[m:List of Wikibooks|Complete list of language Wikibooks available]]. English is "en", Japanese is "ja", etc.) So for example in the English language book on [[Calculus]], which is available on many other wikis, the interlanguage links might look like this:
:<nowiki>[[ja:解析学基礎]]</nowiki>
:<nowiki>[[nl:Analyse]]</nowiki>
:<nowiki>[[zh:微积分学]]</nowiki>
Note: These links are treated specially, and don't show up in the body of the text, but rather in a special sidebar section "in other languages" listed by language name. Technically they can go anywhere in the page; placement does not alter the visual appearance of the links on the rendered page except for the order. However, the convention is to put them at the bottom of the wikitext.
===={{anchor|Interwiki link}}Interwiki links====
{| class="wikitable sortable" style="margin-bottom:0; float:right;"
! Project !! Long form !! Shortcut
|-
| [[w:Wikipedia|Wikipedia]]
| <code>[[[[wikipedia:]]]]</code>
| <code>[[[[w:]]]]</code>
|-
| [[w:Wiktionary|Wiktionary]]
| <code>[[[[wiktionary:]]]]</code>
| <code>[[[[wikt:]]]]</code>
|-
| [[w:Wikinews|Wikinews]]
| <code>[[[[wikinews:]]]]</code>
| <code>[[[[n:]]]]</code>
|-
| [[w:Wikiquote|Wikiquote]]
| <code>[[[[wikiquote:]]]]</code>
| <code>[[[[q:]]]]</code>
|-
| [[w:Wikisource|Wikisource]]
| <code>[[[[wikisource:]]]]</code>
| <code>[[[[s:]]]]</code>
|-
| [[w:Wikispecies|Wikispecies]]
| <code>[[[[wikispecies:]]]]</code>
| <code>[[[[species:]]]]</code>
|-
| [[w:Wikiversity|Wikiversity]]
| <code>[[[[wikiversity:]]]]</code>
| <code>[[[[v:]]]]</code>
|-
| [[w:Wikivoyage|Wikivoyage]]
| <code>[[[[wikivoyage:]]]]</code>
| <code>[[[[voy:]]]]</code>
|}
An '''interwiki link''' links to a page on another Wikimedia project website, such as [[w:|Wikipedia]] or another language Wikibooks. Other sites are listed in the [[m:Interwiki map|interwiki map]]. These links have the same <nowiki>[[...]]</nowiki> syntax as [[#Wikilinks|wikilinks]] (see above), but take a prefix which specifies the target site. For example, <nowiki>[[w:Help:Contents]]</nowiki> links to the "Help:Contents" page on Wikipedia. Links can be piped as with wikilinks. Remember that an [[#Interlanguage links|interlanguage link]] should be preceded by a colon if it is to be displayed where it appears in the text; otherwise it will be listed at the side of the page (which is appropriate only if it is the most closely corresponding page in the other language Wikibooks).
Interwiki links (like external links) are displayed in a slightly paler blue than ordinary wikilinks. MediaWiki does not detect whether these target pages exist, so they are never displayed red. The interwiki links for the major Wikimedia projects are shown at right.
Some people prefer to use templates that wrap the above interwiki link syntax with some nice formatting --
{{tl|Wikipedia}}, {{tl|Wikipediapar}}, {{tl|Wikipedia-inline}}, {{tl|Wikiversity}}, {{tl|Wikisource}}, {{tl|Wikiquote}}, {{tl|Wikivoyage}}, etc.
{{clear}}
==={{anchor|Footnote|Footnotes|Reference}}References===
{{shortcut|WB:REFS}}
'''References''' present [[w:citation|citation]]s to reliable sources that support assertions. '''Footnotes''' add explanatory material and are useful if the added information would be distracting if written out in the main text.
====Inserting references====
{{anchor|Single citation of a reference or footnote}}'''Single citation of a reference or footnote'''
At the point of citation in the page, enter the footnote or reference like this:
:<code><nowiki><ref>Excel For Dummies, First Edition, Hungry Minds, Inc., 1980.</ref></nowiki></code>
You can include formatting and links in the footnote or reference in the usual way. The reference becomes visible in the <nowiki><references/></nowiki> list at the bottom, if there is one.
{{anchor|Creating the list of references or footnotes}}'''Creating the list of references or footnotes'''
At the point where you want the text of the footnotes or references to appear (usually at the end of the page in a '''Notes''' or '''References''' section), insert the tag:
:<code><nowiki><references/></nowiki></code>
The template {{tl|reflist}} is an alternative, mostly used if there are many footnotes.
{{anchor|Multiple citations of the same reference or footnote}}'''Multiple citations of the same reference or footnote'''
To cite the same reference or footnote several times, identify it using the <code>name</code> parameter of the <code><nowiki><ref></nowiki></code> tag.
At one of the citation points (it makes sense to choose the first), enter the reference like this:
:<code><nowiki><ref name="Perry">Perry's Handbook, Sixth Edition, McGraw-Hill Co., 1984.</ref></nowiki></code>
Then at all the other citation points, just enter:
:<code><nowiki><ref name="Perry"/></nowiki></code>
You are free to pick any footnote name, subject to a few rules. The footnote name is internal and will not be displayed anywhere when the page is viewed. Footnote names are case sensitive and may not be a numeric integer. Names and groups should be kept simple and restricted to the standard English alphabet and numerals.
{{anchor|Using templates to insert reference text}}'''Using templates to insert reference text'''
A number of [[Help:Templates|templates]], such as a generic {{tl|citation}}, or more specific {{tl|cite book}}, {{tl|cite web}}, etc., are available to format the text between <code><nowiki><ref></nowiki></code> and <code></ref></code> tags in a more structured way. These are listed at [[:Category:Citation templates]]. Their use is optional: they do aid with consistent formatting, but on the other hand they can make editing more cumbersome.
====Appearance of references====
The <code><nowiki><ref></nowiki></code> tags in the main text are converted to auto-numbered superscripts, like this:
{|class="wikitable"
|
The only reference to Excel For Dummies.<ref>Excel For Dummies, First Edition, Hungry Minds, Inc., 1980.</ref> The first reference to Perry's Handbook.<ref name="Perry">Perry's Handbook, Sixth Edition, McGraw-Hill Co., 1984.</ref> The second reference to Perry's Handbook and to another, related book.<ref name="Perry"/><ref>Nuclear Chemical Engineering (2nd Edition), McGraw-Hill Co., 1981.</ref> A statement that requires a reference. The only reference to Linux in a Nutshell.<ref>Linux in a Nutshell, O'Reily Co., 2003.</ref> And third reference to Perry's Handbook.<ref name="Perry"/>
|}
Clicking on a numbered superscript takes you straight to the text of the corresponding footnote or reference.
The <code><nowiki><references/></nowiki><code> tag is expanded to show the text of the footnotes or references against their corresponding numbers, like this:
{| class="wikitable"
|
<references/>
|}
For single citations, clicking on the arrow (<span style="color:blue;">'''↑'''</span>) takes you to the point of citation in the main text. For multiple citations, the links back to the main text are distinguished by letter superscripts (<span style="color:blue;">'''''a'''''</span>, <span style="color:blue;">'''''b'''''</span>, <span style="color:blue;">'''''c'''''</span> etc.). Clicking on a letter superscript takes you to the corresponding citation in the main text.
====Separate lists of references and footnotes====
Sometimes it is convenient to separate explanatory footnotes from references. This can be accomplished with the "group" parameter:
<syntaxhighlight lang="xml">
This part of the text requires clarification,<ref group="note">Listed separately from the citation</ref> whereas the entire text is cited.<ref>Citation.</ref>
;Notes
<references group="note"/>
;References
{{reflist|close=1}}
</syntaxhighlight>
This part of the text requires clarification,<ref group="note">Listed separately from the citation</ref> whereas the entire text is cited.<ref>Citation.</ref>
;Notes
<references group="note"/>
;References
{{Reflist|close=1}}
Note that, at present, such footnotes cannot themselves contain reference links.
Footnotes may also be listed at the ends of each section of text by closing the {{tl|reflist}} template with the "close" parameter, as shown in the box just above.
====List-defined references====
The software also allows named references to be defined within the reference list rather than in the main text. This can make editing pages much easier, particularly on heavily cited sections. For example:
<syntaxhighlight lang="xml">The quick brown fox jumps over the lazy dog.<ref name="LazyDog"/>
<references>
<ref name="LazyDog">This is the lazy dog reference.</ref>
</references></syntaxhighlight>
The quick brown fox jumps over the lazy dog.<ref name="LazyDog"/>
<references>
<ref name="LazyDog">This is the lazy dog reference.</ref>
</references>
This can also be done using the {{tl|reflist}} template with a {{para|refs}} parameter. If desired, the {{para|group}} parameter can be used to group references for the template:
<syntaxhighlight lang="xml">How razorback-jumping frogs<ref name="Batteries" group="note"/> can level six piqued gymnasts.<ref name="JumpingFrogs"/>
;Notes
{{reflist|group="note"|
refs=
<ref name="Batteries" group="note">Batteries not included.</ref>
}}
;References
{{reflist|
refs=
<ref name="JumpingFrogs">This is the jumping frogs reference.</ref>
}}</syntaxhighlight>
How razorback-jumping frogs<ref name="Batteries" group="note"/> can level six piqued gymnasts.<ref name="JumpingFrogs"/>
;Notes
{{reflist|group="note"|
refs=
<ref name="Batteries" group="note">Batteries not included.</ref>
}}
;References
{{reflist|
refs=
<ref name="JumpingFrogs">This is the jumping frogs reference.</ref>
}}
==={{anchor|List}}Lists===
{{shortcut|WB:LIST}}
There are three types of lists: '''unordered lists''', '''ordered lists''', and '''definition lists'''.
{|class="wikitable" style="width:80%;"
!wikitext!!rendering
|-
|
* Unordered lists are easy to do:
** start every line
* with a star
** more stars mean
*** deeper levels
||
* Unordered lists are easy to do:
** start every line
* with a star
** more stars mean
*** deeper levels
|-
|
* A newline
* in a list
marks the end of the list.
Of course
* you can
* start again.
|
* A newline
* in a list
marks the end of the list.
Of course
* you can
* start again.
|-
|
# Numbered (ordered) lists are good
## very organized
## easy to follow
|
# Numbered (ordered) lists are good
## very organized
## easy to follow
|-
|
* You can also
** break lines
** like this
|
* You can also
** break lines
** like this
|-
|
; Definition lists
; item : definition
; semicolon plus term
: colon plus definition
|
; Definition lists
; item : definition
; semicolon plus term
: colon plus definition
|-
|
* Or create mixed lists
*# and nest them
*#* like this
*#*; definitions
*#*: work:
*#*; apple
*#*; banana
*#*: fruits
|
* Or create mixed lists
*# and nest them
*#* like this
*#*; definitions
*#*: work:
*#*; apple
*#*; banana
*#*: fruits
|}
For simplicity, list items in wiki markup cannot be longer than a paragraph. A following blank line will end the list and reset the counter on ordered lists. Separating unordered list items with blank lines may look approximately normal on your screen, but it creates many separate one-item lists, which is a problem for people using [[w:screen readers|screen readers]], causing accessibility problems for people with disabilities.
===Other items===
* [[Help:Categories|Categories]]
* [[Help:Files|Files]]
* [[Help:Tables|Tables]]
* [[Help:Templates|Templates]]
==Common tasks==
==={{anchor|Revert}}Reverting===
{{shortcut|WB:REVERT}}
On Wikibooks, '''reverting''' means undoing the effects of one or more edits, which normally results in the page being restored to a version that existed sometime previously. More broadly, reverting may also refer to any action that in whole or in part reverses the actions of other editors.
This page contains technical information about making reverts. It should be borne in mind, however, that reverting good-faith actions of other editors (as opposed to [[Wikibooks:Vandalism|vandalism]]) is considered disruptive when done to excess, and can even lead to the reverter being [[Wikibooks:Blocking policy|blocked]] from editing.
====Manual reverting====
In some cases (for example, if a vandal added or removed text, and unrelated constructive edits have been made since), the easiest way to undo past edits may simply be to edit the current page, deleting wrongly added text or restoring wrongly deleted text (this can be copied and pasted from a past version of the page). However it may be more convenient to restore a particular old version of the page from prior to the changes you wish to revert. To do this:
* Click the "history" tab at the top of the page to display the [[Help:Tracking changes#Page history|page history]].
* Click the time and date of the earlier version to which you wish to revert. You will see a phrase similar to: "This is an old revision of this page, as edited by ***.***.***.*** (talk) at 15:47, January 24, {{CURRENTYEAR}}. It may differ significantly from the current revision."
** '''Important:''' in the case of [[Wikibooks:Vandalism|vandalism]], take the time to make sure that you are reverting to the last version without the vandalism; there may be multiple consecutive vandal edits or they may be interspersed between constructive edits.
* Click the ''Edit'' tab as you normally would to edit a page. (Above the edit box, you will see a warning similar to: "You are editing an old revision of this page. If you save it, any changes made since then will be removed.") If editing requires a registered account, log in first, or leave a note on the discussion page.
* Complete the [[#Edit summary|edit summary]] field (the abbreviation "rv" can be used to stand for "revert"; the edit summary "rvv" means "reverting vandalism").
* Save the page.
* If constructive edits had been made after those that you wished to revert, return to the page history to find those edits, and redo them by hand if reasonably possible.
If reverting vandalism, check the [[Help:Tracking changes#User contributions|contribution history]] of the user who vandalized the page. If this user is vandalizing many page, [[Wikibooks:Reading room/Administrative Assistance|report them]].
====Undo====
{{shortcut|WB:UNDO}}
The MediaWiki software sometimes enables editors to easily revert (or "undo") a single edit from the history of a page, without simultaneously undoing all constructive changes that have been made since. To do this, view the [[Help:Tracking changes#Page history|page history]] or the [[Help:Tracking changes#Viewing diffs|diff]] for the edit, then click on "undo" next to the edit in question. The software will attempt to create an edit page with a version of the page in which the undesirable edit has been removed, but all later edits are retained. There is a default edit summary, but this can be modified before saving.
It is also possible to undo several consecutive edits, even if they conflict among themselves: view the diff to be removed (by selecting the two extremal revisions in the history and clicking "compare selected revisions"), and click the "undo" link.
This feature removes the need to manually redo useful changes that were made after the edit which is being reverted. However, it will fail if undoing the edit would conflict with later edits. For example, if one edit adds a paragraph and a later edit modifies that paragraph, it will be impossible to automatically undo the earlier edit. In this case, you must determine how to resolve the problem manually.
====Rollback====
{{shortcut|WB:ROLL|WB:ROLLBACK}}
[[Wikibooks:Administrators|Administrators]] and [[Wikibooks:Reviewers|reviewers]] who have been granted access to the rollback feature have additional links which:
* appear only next to the top edit
* revert ''all'' top consequent edits made by last editor
* work immediately, without the intermediate confirmation diff page
* add automatic [[#Edit summary|edit summary]] "'''m''' Reverted edits by [[Special:Contributions/Example|Example]] ([[User talk:Example|talk]]) to last version by Example2", marking edit as minor
Rollback links appear on the [[Help:Tracking changes#User contributions|user contributions]] pages, [[Help:Tracking changes#Watching pages|user watchlists]], [[Help:Tracking changes#Page history|history pages]] and [[Help:Tracking changes#Viewing diffs|diff pages]]. Note that in the last case, rollback links can be misleading, since reversion is not necessarily to the old version shown (the diff page may show the combined result of edits, including some by other editors or only part of the edits the rollback button would revert). To see the changes the rollback button will revert, view the specific diff that compares the last version from the last editor with the last version from the previous editor.
Rollback works much quicker than undo, since it:
* allows reverting without even looking at the list of revisions or diff
* does not require loading an edit page and sending the wikitext back to the server
* does not require a click of the save button
On the other hand, it is not as versatile as undo, since it does not allow specification of which edits have to be undone. One may want to revert more or less edits than the rollback does or edits which do not include the last edit. It also does not allow adding an explanation to the automatic edit summary and it should only be used to revert obvious vandalism.
Rolling back a good-faith edit, without explanation, may be misinterpreted as "I think your edit was no better than vandalism and reverting it doesn't need an explanation". Some editors are sensitive to such perceived slights; if you use the rollback feature other than for vandalism (for example, because undo is impractical due to the large page size), it is courteous to leave an explanation on the book's discussion page or on the talk page of the user, whose edit(s) you have reverted.
If someone else edited or rolled back the page before you clicked the "rollback" link, or if there was no previous editor, you will get an error message.
==={{anchor|Redirect|Redirects}}Redirecting===
{{shortcut|WB:REDIRECT}}
'''Redirecting''' a page causes navigation to a given title to take the reader directly to a different page. The page the reader visits first is called the '''redirect''' page.
====Syntax of redirects====
A page will be treated as a redirect page if its wikitext begins with <tt>#REDIRECT</tt> followed by a valid [[#Wikilinks|wikilink]] or [[#Interwiki links|interwiki link]]. A space is usually left before the link. (Note that some alternative capitalizations of "REDIRECT" are possible.) The [[File:Vector toolbar redirect button.png|20px|link=]] button in the [[#Edit toolbar|edit toolbar]] can be used to produce this syntax.
Note that a redirect will only work as intended (i.e. take the reader directly to the target page) if the link is to an existing normal page (not a [[Special:SpecialPages|special page]]) on the same project (English Wikibooks). In other cases soft redirects are often used – see [[#Soft redirects|below]].
Examples:
*<tt><nowiki>#REDIRECT [[Help:Tracking changes]]</nowiki></tt> (redirects to the [[Help:Tracking changes]] page)
*<tt><nowiki>#REDIRECT [[Help:Tracking changes#Preferences]]</nowiki></tt> (redirects to the "Preferences" [[#Section|section]] of the [[Help:Tracking changes]] page)
*<tt><nowiki>#REDIRECT [[fr:Help:Tracking changes]]</nowiki></tt> (appears as a redirect to the [[Help:Tracking changes]] page on French Wikibooks, but will not work as a true redirect; this is called a "soft redirect")
Any text appearing after the redirect link will be ignored in the display, but may be used to add categories, comments, etc.
Note that the redirect link must be explicit – it cannot contain [[Help:Variables|variables]], [[Help:Templates|templates]], etc.
When redirecting to a [[Help:Categories|category]] page, prefix the target pagename with a colon to prevent the redirect from showing up in the category. (Redirects from one category page to another should use soft redirects—see [[#Soft redirects|below]].) Redirects to [[Help:Files|file]] pages also require the colon.
====Appearance of redirects====
If the redirect target is an existing page on English Wikibooks, then if a reader navigates to the redirect page—by means of a [[#Wikilinks|wikilink]] or a [[w:URL|URL]]—they will be taken directly to the target page. However, the browser still shows the URL of the redirect page, and the target page shows a small notice below the top title to indicate that you arrived by means of a redirect. For example, if you click [[WB:RR]], you will be redirected to the [[Wikibooks:Reading room]] page, and the top of the page will look like:
<blockquote style="background-color: white; color: black; border:1px solid black; padding: 1em;">
<h1 class="firstHeading">Wikibooks:Reading room</h1>
<div id="contentSub">(Redirected from <span class="plainlinks">[{{fullurl:WB:RR|redirect=no}} WB:RR]</span>)</div>
</blockquote>
To get the canonical URL of the target page in your browser's address bar, click the page's tab. To go to the redirect page itself (to edit it, view its history, etc.), click the link in the "(Redirected from...)" notice.
If the redirect target is a non-existing page ([[Help:Glossary#redlink|redlink]]), or a [[Special:SpecialPages|special page]], or a page in another project, then the redirect is not followed, and the reader sees the display of the redirect page (as illustrated below). If the target is a non-existent section of an existing page, then the redirect will take the reader to the top of the target page.
Note that chains of redirects are not followed. If title A redirects to B, and B is itself a redirect page, then a reader navigating to A will see the display of the redirect page B (as illustrated above). This situation is called a [[Help:Glossary#double redirect|double redirect]]. ([[Wikibooks:Bots|Bots]] fix such chains so that each redirect points directly to the final target page.)
====Creation of redirects====
A redirect page can be created like any other page. Simply type in the wikitext <tt><nowiki>#REDIRECT [[</nowiki>xxx]]</tt>, replacing "xxx" with the title of the target page (optionally followed by a "#" sign and the section title). The [[File:Vector toolbar redirect button.png|20px|link=]] button in the [[#Edit toolbar|edit toolbar]] above the edit window can be used to save typing (either click it and then insert the desired target, or else type the target, select it with the mouse, then click the button). Make sure that there is no text ''before'' the #REDIRECT keyword, or the redirect will not work. There is not usually any reason to place any text after the link either, although sometimes categories (or categorizing templates) are added.
Similarly, any existing page can be edited to turn it into a redirect. If a new redirect page is created or an existing page turned into a redirect page, an [[#Edit summary|edit summary]] will be automatically generated stating that the page has been redirected to the given target. (This is overridden if the editor supplies an edit summary.)
When a page is [[WB:MOVE|moved]] (renamed), a redirect is automatically created from the old to the new name, and also one for the corresponding talk page (if that was moved as well). [[Wikibooks:Administrators|Administrators]] can choose to suppress creation of the redirect.
If the new page name is occupied by a redirect that has only one edit in its history and targeted to the old page name, it is replaced by the page being moved. If the redirect has more than one history entry, or has a different target page, then the move must be made by an administrator.
To edit a page which is already a redirect (or to view its history, talk page, etc.), follow the redirect to the target page, then click on the link in the "(Redirected from ...)" notice at the top of the page. This will take you to the redirect page itself. Another way to get to a redirect page is to go to the target page, and click "[[WB:WLH|What links here]]" (in the toolbox on the left of the page). This will show you all the back-links from that page, including redirects. Clicking on a redirect in this list will take you to the redirect page, not the target.
==== Soft redirects ====
As an alternative to the normal "hard" redirects (which take the reader directly to the target page), it is possible to create [[Help:Glossary#soft redirect|"soft" redirects]], which leave the reader on the redirect page, giving them the option of clicking the link to the target page. This is usually done in the following situations:
*When the target is on another project ([[w:|Wikipedia]], other language Wikibooks, etc.) or is a [[Special:SpecialPages|special page]]. (In these situations a hard redirect would behave as a soft one in any case.)
*For redirects between categories. (Hard redirects will work for category pages, but soft ones are preferred because of the software's inability to recategorize pages from redirected categories.)
Soft redirects are created using the templates {{tl|soft redirect}} and {{tl|category redirect}}.
==Potential problems==
==={{anchor|Protected page|Protected pages}}Page protection ===
[[Wikibooks:Administrators|Administrators]] are able to '''protect''' a page to restrict editing or moving of that page, and remove such '''protection'''. Protection can be indefinite, or expire after a specified time.
*'''Full protection''' prevents editing by everyone except [[Wikibooks:Administrators|administrators]].
*'''Semi-protection''' prevents editing by unregistered contributors and contributors with accounts which are not autoconfirmed.
*'''Creation protection''' prevents a page (normally a previously [[Wikibooks:Deletion policy|deleted]] one) from being recreated.
*'''Move protection''' protects the page solely from [[WB:MOVE|moves]].
Any type of protection or unprotection may be requested at [[Wikibooks:Reading room/Administrative Assistance]]. Changes to a fully protected page should be proposed on the corresponding [[WB:TALK|talk page]]. See [[Wikibooks:Protected page]] for additional information.
==={{anchor|Edit conflict}}Edit conflicts ===
{{shortcut|WB:EC}}
If someone else makes an edit while you are making yours, the result is an edit conflict. Many conflicts can be automatically resolved by the Wiki. If it can't be resolved, however, you will need to resolve it yourself.
To understand what an edit conflict is, consider the following situation:
* Alice clicks ''Edit'' on a page.
* Bob clicks ''Edit'' on the same page, while Alice is editing.
* Alice finishes her edits and clicks "Save page". The page is saved with Alice's version while Bob is still editing.
* Bob finishes his edits and clicks "Save page". Bob gets an "edit conflict" page, because the software can't automatically reconcile the differences between Bob's and Alice's versions of the page. The edit conflict page gives Bob a chance to reconcile the differences manually.
==== Layout ====
At the top of the edit conflict page is an editing box containing Alice's version of the whole page, even if Bob is doing section editing.
At the bottom of the edit conflict page is a second editing box containing the text Bob was going to submit. This will be Bob's version of the page or section he was editing.
Between the two editing boxes is a [[Help:Tracking changes#Viewing diffs|diff]] that shows the difference between Alice's and Bob's version of the page. For the section Bob is editing it shows Bob's changes and Alice's possible changes, except for sections where Bob and Alice have both made the same change. For the other sections it shows the full new text as if all that text was added.
Bob can edit in the upper editing box and press Save.
==== Resolution ====
If Bob only made small changes, and Alice made large changes, he may choose to work from Alice's version, and re-merge his changes in. Bob might choose to add some text like "via edit conflict" to the edit summary to warn Alice and others that he had to do this—Alice can then review his merging for accuracy.
If Bob made large changes, and Alice made small changes, he may choose to work from his version. One option is for Bob to copy the bottom text into the top text (or just copy over the one section of the top text, if Bob was section editing), with an appropriate [[#Edit summary|edit summary]] (e.g., "via edit conflict, will remerge"). Then Bob can view the page history, determine Alice's changes, and re-apply them to his version, in a separate edit.
If both Alice and Bob made large changes, matters become complicated, and Alice and Bob just have to do the best they can. For example, if both Alice and Bob simultaneously add a large section of text on the same subject, then it may be best for Bob to submit his changes, and then for Alice and Bob to both have a look at the two versions and decide between themselves which version is better.
Bob should not just post his changes over the top of Alice's. We [[Wikibooks:Assume good faith|assume good faith]]—mistakes are occasionally made, and newcomers may not understand the edit conflict window. However, Bob must not routinely ignore edit conflicts. It is absolutely not acceptable for Bob to overwrite Alice out of laziness. We encourage contributors to double-check their merges by using the [[Help:Tracking changes#Viewing diffs|diff]] feature.
==== Prevention ====
Because edit conflicts are irritating and time-consuming, you may choose to alter your editing habits to render them less frequent.
One of the easiest ways is to edit the smallest portion of the page necessary. If you are only going to be editing a single section in the page , then click the "Edit" link for that section, rather than the "Edit" link for the entire page. Two people can be working on different sections at the same time, and there will be no edit conflict.
To reduce the chance of edit conflicts, Wikibooks also has an "In Use" notice in its [[Help:Templates|Template]] namespace that people may use when editing a page over a long period of time. Simply put {{tl|in use}} on a page before proceeding with a major edit, and remove the template when the editing is complete.
== See also ==
{{Meta|Help:Link}}
*[[Editing Wikitext]]
| |||