M:Помощь:Ссылки

Материал из Электронная энциклопедия ТПУ
Перейти к: навигация, поиск


Шаблон:H:h

Гиперссылки дают пользователям возможность перемещаться между страницами. Для просмотра базовой информации по wiki-форматированию смотрите Помощь:Редактирование.

В MediaWiki нет возможности создавать гиперссылки при помощи HTML. Вместо этого есть три основных вида гиперссылок, каждый со своим CSS-форматированием: wiki-ссылки (wikilinks), interwiki-ссылки (interwiki links, ссылки между различными wiki) и внешние ссылки. Кроме линковки, каждый из видов ссылок обеспечивает дополнительный функционал, специфичный для wiki-движков, например, определение битых ссылок (ссылок на несуществующие страницы) для wiki-ссылок и автоматическая нумерация внешних ссылок, когда они используются в сносках.

Wiki-ссылки

Wiki-ссылка - это внутренняя ссылка на другую страницу или секцию страницы в пределах одной wiki. MediaWiki автоматически проверяет, существует ли цель wiki-ссылки ("определение существования"). Если страница не существует, то ссылка ведет к секции редактирования, и ей присваивается класс "новая". Такие wiki-ссылки называются "красными ссылками", т.к. они выделяются красным цветом шрифта в таблице стилей по умолчанию. "Красные ссылки" полезны для определения текущего статуса страницы (создана или не создана), создания ссылок на планируемые странцы и для поощрения создания новых страниц другими пользователями. Также, через пункт меню "Ссылки сюда" примененный к несуществующий странице можно обеспечить непрямые ссылки на другие страницы с той же красной ссылкой.

Ссылка на несуществующую страницу в пространстве имен MediaWiki для существующего системного сообщения считается ссылкой на существующую страницу.

Синтаксис

MediaWiki определяет wiki-ссылку как закрывающийся набор пар квадратных скобок '[[ ]]'. Цель ссылки - последовательность символов, расположенная между первой парой скобок и каналом (pipe, '|') или закрывающей парой скобок ']]'. Целью ссылки может быть другая страница wiki , секция той же страницы, на которой расположена ссылка, или секция другой страницы wiki.

  • Межстраничные ссылка: ссылка вида [[имя_страницы]], ведет на страницу с именем "имя_страницы"
  • Внутристраничная ссылка: ссылка вида [[#имя_ссылки]] ведет на первую секцию текущей страницы, которая имеет заголовок (или якорь), с именем "имя_ссылки".
  • Межстраничная "интра" ссылка: ссылка вида [[имя_страницы#имя_ссылки]] ведет на соответствующую секцию страницы с именем "имя_страницы", см. ссылки на секции.

Синтаксис wiki-ссылок также включает в себя различные опции форматирования, определяющие внешний вид ссылок.


Основы синтаксиса wiki-ссылок

Шаблон:Wikilink syntax tbl

Шаблон:Wikilink syntax tbl

Шаблон:Wikilink syntax tbl

Шаблон:Wikilink syntax tbl

Шаблон:Wikilink syntax tbl

Шаблон:Wikilink syntax tbl

Шаблон:Wikilink syntax tbl

Шаблон:Wikilink syntax tbl

Шаблон:Wikilink syntax tbl

Шаблон:Wikilink syntax tbl

Шаблон:Wikilink syntax tbl

Шаблон:Wikilink syntax tbl


Wikilink Tricks & Demos

Шаблон:Wikilink syntax tbl

Шаблон:Wikilink syntax tbl

Шаблон:Wikilink syntax tbl

Шаблон:Wikilink syntax tbl

Шаблон:Wikilink syntax tbl

Шаблон:Wikilink syntax tbl

Шаблон:Wikilink syntax tbl

Шаблон:Wikilink syntax tbl

Шаблон:Wikilink syntax tbl

* Англоязычный термин для ссылок, оформленных таким образом, через текст ссылки в качестве параметра — piped links.

** Вне зависимости от вида префикса — ведет он в другую вики (интервики), в другое пространство имен, или просто текст ссылки содержит двоеточие.

*** Не работает с внутристраничными #-викиссылками (intra-page): отображает [[#xxxx|]] как текст.


Note that the image, category, and interlanguage syntax are the same as the wikilink syntax. Attempting to link normally will place the image on the page, add the page to the category and create an interlanguage link at the edge of the page. This can be prevented by prefixing a colon, which escapes the specific syntax. For example, [[:Category:Help]], [[:fr:Help:Link]], and [[:File:Mediawiki.png]].

In the case of a link to a local, non-existing, dynamically generated image description page of an image on Commons, this page is counted as existing for links on pages, e.g. File:Cow-on pole, with horns.jpeg, but not for links in edit summaries and logs.

The existence of an internal link from a page to an existing or non-existing page is recorded in the pagelinks table.

Заготовки статей

A wikilink to an existing page will be in class 'stub' if the page is in the main namespace, it is not a redirect, and the number of bytes of the wikitext is less than the "threshold for stub display" set in the user's preferences.

This allows users to immediately identify links to very short pages that probably need to be expanded, and links to short disambiguation pages. Alternately, a user may set a very high threshold to achieve any of the following:

  • Identify links to very large pages. However, the criterion is the size of the wikitext; possible inclusion of templates and images can make the rendered page large, even if the amount of wikitext is small.
  • Determine at a glance whether a link leads to the main namespace or not. However, this does not take into account redirects to the main namespace (even if the redirect itself is in the main namespace).
  • Identify links to redirects, for clean-up work such as bypassing redirects.

However, section linking to a "stub" does not work. Although this is normally a minor issue, this may cause problems with users who set a very high threshold.

Интервики

Шаблон:Main An interwiki link links to a page on another website. Unlike the name suggests, the target site need not be a wiki, but it has to be on the interwiki map specified for the source wiki. These links have the associated CSS class "extiw". These are in the same form as wikilinks above but take a prefix which specifies the target site. For example, on Wikimedia projects (except Wikipedias) and many other wikis [[wikipedia:Main Page]] links to the main page of the English Wikipedia. The prefix can be hidden using the same piped syntax as wikilinks.

An interwiki can also link to a section or other anchor, see section linking.

Интервики в тот же проект

Although interwiki links can be used to point to a wiki from itself, this is not generally recommended. MediaWiki does not detect whether or not the target page of an interwiki list exists, so there is no special formatting and the link is always to the view page. Further, MediaWiki does not check if the page is linking to itself. A self wikilink is bolded (like M:Помощь:Ссылки), whereas a self interwiki link is normal (m::M:Помощь:Ссылки).

Pros:

  • A copy of the wikitext on a sister project may still point to the same page. Sometimes two prefixes are needed for that purpose, e.g. w:de:a.

Cons:

  • Link has non-standard appearance
  • No existence-detection for target page

Внешние ссылки

External links use absolute URLs to link directly to any webpage. These links have the associated CSS class "external". External links are in the form [http://www.example.org link name] (resulting in link name), with the link name separated from the URL by a space. Links without link names will be automatically numbered: [http://www.example.org] becomes [1]. Links with no square brackets will be displayed in their entirety: http://www.example.org.

To show a URL without link use e.g. <nowiki>http://www.example.org</nowiki> giving http://www.example.org.

Unlike in the case of internal links, characters immediately after the closing bracket are not added to the link label: [http://www.example.org a]s gives as.

See URLs in external links for more detailed information.

Ссылки на e-mail

Links to an E-mail address work the same way that external links do, except they require the prefix mailto:. E-mail links are in the form of [mailto:anyone@example.org address name] (resulting in address name), with the link name separated from the address by a space. Addresses without names will automatically be numbered: [mailto:anyone@example.org] becomes [2]. Addresses without square brackets will not be rendered as link, e.g. anyone@example.com. It's possible to make CC with [mailto:anyone@example.org?cc=anyone2@example.org address name] (resulting in address name).

Ссылки на специальные страницы того же проекта

External links support various special optional URL parameters in their linking-code. These allow links directly to the edit history of a page, to a page in edit view, a diff of two versions, et cetera. They can also be used to create a navigational image.

For portability, use "fullurl" where the URL should depend on the project.

Иконки после ссылки

MonoBook skin produces an arrow icon after every external link. This can be suppressed with class="plainlinks":

  • [http://a a] gives a
  • <span class="plainlinks">[http://a a]</span> gives a

With some special code on MediaWiki:Common.css such as on m:MediaWiki:Common.css, external links to PDF files have their own icon Файл:Icons-mini-file acrobat.gif. On this site with your current settings http://a.pdf gives http://a.pdf .

Пропуск номера ссылки

To skip a number in the automatically numbered external links (for whatever reason), use e.g. <span style="display:none">[http://a]</span>: [3][4][5].

Note that a false condition of a ParserFunction, or a template like Шаблон:Links-small does not work, because counting the links is done after expansion of templates and parser functions.

Поиск по внешним ссылкам

Special:Linksearch (an extension installed on Wikimedia wikis, [6]) finds all pages linking to a given URL. Using the externallinks table it provides for a given external link pattern a list of source page names on the wiki concerned (linked) with for each the full link target (also as a link). One can either search all namespaces or a selected one. A leading wildcard * can be used to search links to a whole top-level domain (e.g. [7]), or a second-level domain (e.g. [8]), etc. In the case that a full domain name is specified, one can additionally specify the rest of the URL, or the first part of that (a wildcard at the end is implied), e.g. [9].

Remarks:

  • Do not put "http://".
  • The colon in the URL may cause the program return no results.
  • A MediaWiki page name in a URL has underscores instead of spaces. Also the URL specified in Linksearch requires writing underscores.
  • Even if multiple URLs lead to the same target, with regard to capitalisation, multiple underscores, and using "index.php" or not, Linksearch is case-sensitive and also does not find alternatively written URLs. Therefore, when creating an external link, for optimal use of Linksearch, use a canonical form for the URL. In particular, if after following a link the address bar shows a modified URL, change the URL in the link to that.
  • The list is Шаблон:Ml in the URL. Note that an underscore, unlike a blank space, is alphabetically positioned between "Z" and "a".

Обратные ссылки

Commonly, a link to a normal page on the same project is in internal link style. An advantage is the existence detection. Also, if some links are in internal and some in external link style, we need both "What links here" and Linksearch for finding all backlinks. However, especially for a link to a section or explicitly-set anchor, one could put an internal link and also, with CSS style "display=none", an external link, to provide backlinks.

External link style is also superior to interwiki link style. The URL specified for Linksearch can even contain an anchor (see below), or the first part of an anchor. Therefore Linksearch can find backlinks of sections and explicit anchors. In this regard external links are even superior to internal links. We can combine the advantages of internal and external link style by putting both, but hiding the external links: <span style="display:none">http://...</span>


Якоря

Шаблон:Seealso

Ссылки на якоря

Links of the form [[#anchor_name]] will link to the first anchor on the page matching that "anchor_name", usually the first identical section heading.

An #anchor_name can also be appended to the page name in any type of link, thus linking to the first identical section heading (or anchor) of the named page:

[[Help:Editing#Links]], [[m:Help:Editing#Links]],

http://meta.wikimedia.org/wiki/Help:Editing#Links

Якоря, расставляемые автоматически

Section headings automatically act as anchors, with the heading text as the "anchor_name". In the case of multiple sections with identical headings, the anchor name of each has "_2", "_3", etc. appended, starting from the second occurrence.

The anchor #toc links to the table of content of the page, unless there is a section titled "toc".

Якоря, расставляемые вручную

Manually-set anchors are useful for linking to "unlinkable" things like a table (title or cell), a section of plain text, etc. For example, in the Wikilink Tricks & Demos table above, though the "Wikilink Tricks & Demos" title-text appears like a (minor) heading, it is not, and the otherwise perfectly normal wikilink [[#Wikilink Tricks & Demos]] will not work.

There are a number of ways to set an anchor at an arbitrary position:

  • Generic anchor: <span id="anchor_name">some text</span>. For a hidden anchor, omit the text.
  • Manual HTML headings (discouraged): <h2>How to Edit</h2>. Text is anchor_name.
  • In some cases, inserting an HTML-like ID attribute into an (existing) Wiki-element. For example, from the Wikilink Tricks & Demos

table above:
!colspan="5" align="left" id="Wiki-link Tricks"|Wikilink Tricks & Demos


See also Help:Section#Section_linking.

Якоря для поиска по внешним ссылкам

As mentioned above, if external link style is used, e.g. [10], we can use Special:Linksearch: [11].

Since Linksearch allows specifying the first part of an anchor, it is useful, if anchor names are numerical or have a numerical end, to use leading zeros. Otherwise, when searching for links to e.g. "1", we also get links to "10", etc. This is e.g. applied in w:Portal:Current events/DateHeader2. More generally, if there are anchors "a" and "ab", it may or may not be desired that a search for links to "a" also gives links to "ab"; if not, use an anchor "_a".

«Каталожные» якоря

If anchor names have multiple components, it is useful to put the most significant component first, e.g. if anchors indicate months or dates, we could have the format YYYY-MM, or YYYY-MM-DD, or in a year page MM-DD (see also [12]), with leading zeros (see also [13]). This applies also for page names, but since these are highly visible, as opposed to anchors, other considerations play a role too. In the case of sections, if for link targets another naming scheme is desired than for display of section headings, explicitly put anchors instead of using section names. This is applied in w:Portal:Current events/DateHeader2, where the use in links of the names of explicitly put anchors is enforced by using pseudo sections, with displayed headings that cannot be used as anchors.

Якоря во внешних ссылках (anchorencode)

In an external link, an anchor can be created conveniently with the parser function anchorencode, for example, Шаблон:Xpdoc, which can be used to form the link http://wiki.tpu.ru/wiki/M:%D0%9F%D0%BE%D0%BC%D0%BE%D1%89%D1%8C:%D0%A1%D1%81%D1%8B%D0%BB%D0%BA%D0%B8#Anchors_in_external_links_.28anchorencode.29

Подстраницы

MediaWiki has a subpage feature, although activation depends on project and namespace. If activated, the following applies (if not, "A/b" is just a page with that name).

A tree structure of pages is established by using forward slashes in pagenames: A/b is a child of A, hence A is a parent of A/b; also A/b/c is a child of A/b; while A/a, A/b, and A/c are siblings.

At the top of the subpage body links to all ancestor pages are shown automatically, without any corresponding wikitext. The links show up even if the parent page does not exist, but the sequence of ancestors stops before any non-existing ancestor page (e.g., if the grandparent page does not exist, the parent page is not shown either). Like most letters of a page name, the first letter after the slash is case-sensitive; "/subpage" and "/Subpage" are different pages.

What links here and Related changes ignore these automatic links.

In the namespace where the subpage feature is activated, any slash in a page name causes a subpage structure, even if unintended.

A list of subpages can be obtained using Special:PrefixIndex.

Переменные

On page A:B/c/d, where A is a namespace with the subpage feature enabled, {{BASEPAGENAME}} gives B/c and {{SUBPAGENAME}} gives d

Относительные ссылки

Inside a subpage hierarchy the following relative links can be used:

  • [[../]] links to the parent of the current subpage, e.g., on A/b it links to A, on A/b/c it links to A/b.
  • [[../../]] links to the grandparent of the current subpage, e.g., on A/b/c it links to A.
  • [[../s]] links to a sibling of the current subpage, e.g., on A/b, it links to A/s.
  • [[../../s]] links to an "uncle" of the current subpage, e.g., on A/b/c, it links to A/s.
  • [[/s]] links to a subpage, e.g. on A it is the same as [[A/s]]. Because of this, linking from a namespace where the subpage feature is enabled to a page in the main namespace with a name starting with "/", requires a workaround: put a colon before the pagename.

Linking to an anchor of an ancestor does not work; attempting that gives a link to a page with the name consisting of the name of the ancestor followed by "/".

Relative links still work if all pages of a tree are renamed according a name change of the root, including making it a child of a new root.

See also w:Wikipedia:Subpages, and the example pages m:Link/a/b and m:Help:Link/a/b. The subpage feature works in both namespaces.

Активация подстраниц

Wikipedia has this feature activated in all talk namespaces and the user and project namespace. The Meta-Wiki also has it in the main namespace. The default is set in DefaultSettings.php[14]. As of revision 1.21, the following namespaces have it activated by default: Special, Main talk, User and User_talk, Meta_talk, and Image_talk. Settings per project are changed in LocalSettings.php[15].

See also Шаблон:Mlmw.

Личное пространство участника

Subpages of a user page ([[User:Username/Subpage]]) are considered to be in that user's "user space".

Преобразование символов

In accordance with the rules explained in Help:Page name, conversions are automatically made to non-literal characters in wiki and interwiki links. For example, "[[Help:Page%20name]]" becomes "Help:Page name". However, the opposite is true for external links; literal characters are converted into non-literal characters. For example, most browsers will convert ".../wiki/!" to ".../wiki/%21".

A code like %70 in a redirect disables it, although the link works from the redirect page. For a redirect that works, the redirect page shows the canonical form of the target, unlike its preview page, which renders the link in the usual way.

Разное

Дополнительное форматирование ссылок

Всплывающие подсказки на ссылках

On some browsers, holding the cursor over a link will show a hover box ("tooltip") containing the text of the link's HTML title attribute. MediaWiki sets this to the target page name (without the possible section indication) if it's a wikilink (the Шаблон:Msg if the page does not exist), the page name with prefix if it's an interwiki link, and the URL if it's an external link.

This can be switched off in the user preferences. The browser may also show similar info, but with the possible section indication, in the status bar.

For these effects a piped link is useful even if it not followed to the target; for example, for displaying the meaning of an acronym (e.g. NPOV) or any other remark. It is possible to produce a hover box without a link, see Шаблон:Links-small. It is also possible to change the contents of the hover box, using markup similar to [[Link title|<span title="hoverbox">Display text</span>]], e.g.

Шаблон:Xpdplain

Ссылки со страницы

With the Query API the links from page pagename, sorted by namespace, and for each namespace alphabetically, are given by {{SERVER}}{{SCRIPTPATH}}/query.php?what=links&titles=pagename , e.g. http://wiki.tpu.ru/query.php?what=links&titles=M:Помощь:Ссылки .

Изображение-ссылка на страницу

It is possible to use images as links to other pages. For more information, see use an image as a link to a page.

Смотри также

Шаблон:H:f