Help:Cite

From mediawiki.org
This page is a translated version of the page Help:Cite and the translation is 62% complete.
PD Uwaga: Jeżeli edytujesz tę stronę, to umieszczając na niej treści wyrażasz nieodwołalną zgodę na udostępnianie Twojego materiału na podstawie wolnej licencji CC0. Aby uzyskać więcej informacji, przeczytaj Strony Pomocy w Domenie Publicznej.
Niektóre starsze wersje tej strony zostały zaimportowane na licencji CC BY-SA. Tylko nowe edycje należą do PD (domeny publicznej).
PD

Cite umożliwia dodawanie przypisów na stronie.

Sprawdź Cite extension , aby uzyskać szczegóły techniczne.

Użycie

Podstawową ideą tagu ‎<ref> jest wprowadzenie tekstu załączonego przez tag ref jako notatki/przypisu w wyznaczonej sekcji, którą wskazujesz przy użyciu tag ‎<references />. Ten format nie może być używany zamiennie ze starszym - musisz wybrać jeden lub drugi.

Dodatkowe tagi ‎<references /> mogą zostać wprowadzone do tekstu. Wszystkie tagi ‎<ref> do tego momentu, w tej grupie, zostaną tam wprowadzone.

Jeśli zapomnisz umieścić ‎<references /> w artykule, przypisy nie znikną, ale odniesienia będą wyświetlane domyślnie na końcu strony.

Na tej stronie również znajdują się przypisy, takie jak przypis na końcu tego zdania.[note 1] Jeśli wyświetlisz źródło tej strony, możesz zobaczyć przykładowe wykorzystanie przypisów.

Wikitekst Wynik
Słońce jest dość duże.<ref>E. Miller, "Słońce" (New York: Academic Press, 2005), 23-25.</ref> Natomiast Księżyc nie jest tak duży.<ref>R. Smith, "Wielkość Księżyca", "Scientific American", 46 (kwiecień 1978): 44-46.</ref>

==Przypisy==
<references />

Słońce jest dość duże.[1] Natomiast Księżyc nie jest tak duży.[2]

Przypisy
  1. E. Miller, "Słońce" (New York: Academic Press, 2005), 23-25.
  2. R. Smith, "Wielkość Księżyca", "Scientific American", 46 (kwiecień 1978): 44-46.

Wielokrotne użycie tego samego przypisu

Aby przypisać notce unikalny identyfikator, użyj ‎<ref name="nazwa">. Możesz teraz odwoływać się do tej samej notki, używając taga z tą samą nazwą. Tekst w drugim znaczniku nie ma znaczenia, ponieważ tekst notki istnieje już w pierwszym odniesieniu. Możesz skopiować cały tekst notki lub użyć pustego tagu referencyjnego, który wygląda tak: ‎<ref name="nazwa" />.

W poniższym przykładzie to samo źródło jest cytowane trzy razy.

Wikitekst Wynik
To jest przykład wielokrotnych odniesień do tego samego przypisu.<ref name="multiple">Pamiętaj, że gdy wielokrotnie odnosisz się do tego samego przypisu, używa się tekstu z pierwszego odniesienia.</ref>

Takie odniesienia są szczególnie przydatne, jeśli różne stwierdzenia pochodzą z tego samego źródła.<ref name="multiple" /> Każdy tag użyty ponownie nie powinien zawierać dodatkowej treści - to spowoduje błąd. W tej roli używaj tylko pustego taga.

Używanie pustego taga referencji to dobra metoda. Taki tag ma na końcu znak slash.
Chociaż może to zmniejszyć nakład pracy, należy pamiętać, że jeśli przyszły redaktor usunie pierwsze odniesienie, spowoduje to utratę wszystkich odniesień używających pustych tagów referencji.<ref name="multiple" />

== Przypisy ==
<references />

To jest przykład wielokrotnych odniesień do tego samego przypisu.[1]

Takie odniesienia są szczególnie przydatne, jeśli różne stwierdzenia pochodzą z tego samego źródła.[1] Każdy tag użyty ponownie nie powinien zawierać dodatkowej treści - to spowoduje błąd. W tej roli używaj tylko pustego taga.

Używanie pustego taga referencji to dobra metoda. Taki tag ma na końcu znak slash. Chociaż może to zmniejszyć nakład pracy, należy pamiętać, że jeśli przyszły redaktor usunie pierwsze odniesienie, spowoduje to utratę wszystkich odniesień używających pustych tagów referencji.[1]

Przypisy
  1. 1.0 1.1 1.2 Pamiętaj, że gdy wielokrotnie odnosisz się do tego samego przypisu, używa się tekstu z pierwszego odniesienia.
Należy pamiętać, że identyfikatory używane w parametrze name wymagają znaków alfabetu; używanie wyłącznie liczb wygeneruje błąd. Cudzysłowy są rekomendowane dla nazw, i są obowiązkowe, gdy nazwa zawiera spację lub znak interpunkcyjny. Zaleca się, aby nazwy były proste i ograniczone do zestawu znaków ASCII.


<span id="The_‎<references />_tag">

" data-mw-fallback-anchor="Tag_.3Creferences_.2F.3E" data-mw-thread-id="h-Tag_<references_/>-Użycie">Tag ‎<references />

Tag ‎<references /> wypisuje tekst wszystkich cytatów, które zostały zdefiniowane w tagach ‎<ref> do tego punktu na stronie. Na przykład, na podstawie powyższych cytatów powinno pojawić się odniesienie do grupy note.

Wikitekst Wynik
<references group="note"/>
  1. Ten przypis jest użyty jako przykład w sekcji "Użycie".

Lista odniesień może mieć zmienną szerokość, pokazującą odniesienia w kilku kolumnach. W takim przypadku parametr responsive używany jest do konfiguracji tego zachowania. Na wiki z domyślną konfiguracją będzie się to działo na każdej stronie, na innych należy skonfigurować takie zachowanie ręcznie.

Jeśli na stronie znajduje się więcej niż jedna lista ‎<references />, każda lista zawiera tagi ‎<ref> określone po poprzedniej liście referencji. Jeśli te listy odniesień są tworzone przez szablony, każda z nich wypisuje tagi zdefiniowane przed pierwszą listą referencji, i pojawia się wiadomość błędu mówiąca, że istnieje tag referencji, ale nie lista referencji.


Grupy odniesień

Jeśli chcesz, możesz to wyłączyć w $wgAllowCiteGroups = false;.

W poniższym przykładzie tworzą się oddzielne listy odniesienia do cytatów i przypisów "różnych":

Wikitekst Wynik
Według naukowców, Słońce jest dość duże.<ref>E. Miller, "Słońce" (New York: Academic Press, 2005), 23-25.</ref> Właściwie to jest bardzo duże.<ref group="footnotes"> Uwierz im na słowo. Nie patrz prosto na słońce!</ref>

==Uwagi==
<references group="footnotes" />

==Przypisy==
<references />
Według naukowców, Słońce jest dość duże.[1] Właściwie to jest bardzo duże.[footnotes 1]
Uwagi
  1. Uwierz im na słowo. Nie patrz prosto na słońce!
Przypisy
  1. E. Miller, "Słońce" (New York: Academic Press, 2005), 23-25.

Grupa bez zdefiniowanej nazwy działa tak samo, jak wcześniej, natomiast odniesienia w nazwanej grupie pojawiają się tylko w wyznaczonym elemencie ‎<references />.

Należy pamiętać, że identyfikatory używane w parametrze group wymagają znaków alfabetu; używanie wyłącznie liczb wygeneruje błąd. Cudzysłowy są rekomendowane dla nazw, i są obowiązkowe, gdy nazwa zawiera spację lub znak interpunkcyjny. Zaleca się, aby nazwy były proste i ograniczone do zestawu znaków ASCII.

The rendering of a given group can be customized across the wiki by creating MediaWiki:Cite_link_label_group-<name> and listing the used signs in the order they appear, separated by spaces or newlines.

Na przykład, jeśli MediaWiki:Cite_link_label_group-lower-alpha zostaje utworzony z zawartością

a b c d e f g h i j k l m n o p q r s t u v w x y z

, to pierwszy <ref group="lower-alpha">...</ref> daje [a], drugi [b], i tak dalej, aż 26. daje [z].

It is an error to use more footnotes in a custom-rendered group than the number of signs defined, so the 27th footnote in this group causes an error.

The following group names are often defined as custom groups by the following messages respectively:

group name message
upper-alpha MediaWiki:Cite link label group-upper-alpha
lower-alpha MediaWiki:Cite link label group-lower-alpha
upper-roman MediaWiki:Cite link label group-upper-roman
lower-roman MediaWiki:Cite link label group-lower-roman
lower-greek MediaWiki:Cite link label group-lower-greek
The Cite link label group pages are not created by default. If a wiki does not configure them, markup such as <ref group="lower-alpha">...</ref> will render as lower-alpha 1.

Citing different parts of the same source

When several parts from the same work are used as references in an article, you can cluster them in the reference section. This gives readers a way to identify which references originate from the same source. It also allows you to cite different parts of the same source without repeating the entire source every time.

Wikitekst Wynik
Według naukowców, Słońce jest dość duże.<ref name="Miller">E. Miller, "Słońce" (New York: Academic Press, 2005).</ref> Właściwie to jest bardzo duże.<ref extends="Miller">p. 123</ref> Uwierz im na słowo. Nie patrz prosto na słońce!<ref extends="Miller">p. 42</ref>

== Przypisy ==
<references />
Według naukowców, Słońce jest dość duże.[1] Właściwie to jest bardzo duże.[1.1] Uwierz im na słowo. Nie patrz prosto na słońce![1.2]
Przypisy

1. E. Miller, "Słońce" (New York: Academic Press, 2005).
   1.1 ↑ p. 123
   1.2 ↑ p. 42

This feature doesn't yet work on wikis outside the beta cluster, which is why the above example is a mock. You can follow the project update at m:WMDE Technical Wishes/Book referencing.

Separating references from text

In-text references make it easy to copy the text to another page; on the other hand, they make it hard to read. References containing a lot of data, quotes or elaborate citation templates can make up a significantly larger fraction of the source than the text that will actually be visible. To avoid this, recent versions of the extension allow moving some or all of the references into the ‎<references /> section, to the place where they will actually appear to the reader.

Wikitekst Wynik
Według naukowców, Słońce jest dość duże.<ref name="miller" /> Natomiast Księżyc nie jest tak duży.<ref name="smith" />

<span id="Notes"></span>
==Przypisy==
<references>
<ref name="miller">E. Miller, "Słońce" (New York: Academic Press, 2005), 23-25.</ref>
<ref name="smith">R. Smith, "Wielkość Księżyca", "Scientific American", 46 (kwiecień 1978): 44-46.</ref>
</references>

Według naukowców, Słońce jest dość duże.[1] Natomiast Księżyc nie jest tak duży.[2]

Przypisy
  1. E. Miller, "Słońce" (New York: Academic Press, 2005), 23-25.
  2. R. Smith, "Wielkość Księżyca", "Scientific American", 46 (kwiecień 1978): 44-46.

Thus, the code above will have the same output as the first example above, although the numbering and order of the references will not in general be the same.

Substitution and embedded parser functions

Since Cite's ‎<ref> tag is parsed before MediaWiki's parser functions (e.g. {{#ifexpr:…}}) or variables (e.g. {{PAGENAME}}) or before subst:, these will not work inside of citation references. Instead, you have to use the magic word {{#tag:…}}.

Wikitekst Wynik
Foo<ref>To nie działa, zobacz {{cite journal|url=https://www.google.com |author= |date= |accessdate={{subst:#time:Y-m-d|now}}|title=Search}}</ref> bar baz…
Foo{{#tag:ref|Podczas gdy to robi, zobacz {{cite journal|url=https://www.google.com |author= |date= |accessdate={{subst:#time:Y-m-d|now}}|title=Search}}}} bar baz…
<references />

Foo[1] bar baz… Foo[2] bar baz…

  1. To nie działa, zobacz "Search" . Retrieved on [[{{subst:#time:Y-m-d|now}}]]. 
  2. Podczas gdy to robi, zobacz "Search" . Retrieved on 2021-03-11. 

Adding an automatic heading before the references list

Up to MediaWiki 1.28, one could use the system message MediaWiki:Cite references prefix to define a wiki-wide heading which would be automatically inserted before each references list. In MediaWiki 1.29, this system message was removed. A hacky way to enter a headline now is to add the following code to MediaWiki:Common.js:

$(document).ready(function(){
    $('.mw-references-wrap').before('<h2>Przypisy</h2>');
});

Note that this adds the header unconditionally, i.e. if you already have the header it gets added again thus creating duplicated headers.

If you only need a text heading (no link or other active elements) you could add the following to MediaWiki:Common.css (Chrome 4, IE9, FF 3.5, Safari 3.1, Opera 7):

.mw-references-wrap::before {
  content: "Blue references";
  color: #0645ad;
  text-decoration: none;
  background: none;
  font-style: italic;
  font-size: 100%;
  font-weight: bold;
  line-height: 1.6;
  direction: ltr;
  font-family: sans-serif;
}

Merging two texts into a single reference

A typical Wikisource issue are references that span multiple pages in the source material. These can be merged using a ‎<ref name="name"> tag for the first part of the reference, and tagging the following parts with a tag ‎<ref follow="name"> using the same name.

Przykład:

Wikitekst Wynik
This is an example of merging multiple texts into the same footnote.<ref name="main">Remember that all the texts will be included into the reference containing the name="…" attribute.</ref>

<ref follow="main">Simply include the additional text in a tag with the follow="…" attribute, matching the first ref's name.</ref>

<span id="References"></span>
==Przypisy==
<references/>

This is an example of merging multiple texts into the same footnote.[1]


Przypisy

  1. Remember that all the texts will be included in the reference containing the name="…" attribute. Simply include the additional text in a tag with the follow="…" attribute, matching the first ref's name.

When using this syntax, take care that the "follow" part of the footnote is included on the same page as the first part of the reference.

Note that reference names cannot start with a number, so always include some text like, <ref name="p32"> and <ref follow="p32">.


Dostosowywanie

The format of the output of ‎<ref> and ‎<references> is almost completely customizable through MediaWiki messages, that can be modified, for example, through the MediaWiki namespace depending on the configuration of the wiki.

For a list of messages that control the output of ‎<ref> and ‎<references> and the values, if any, that are passed to them ($1, $2, $3 ...), see an up-to-date listing of the default values that can be obtained directly from MediaWiki.

Incomplete list
  • cite_reference_link_key_with_num
    1. key
    2. num
  • cite_reference_link_prefix
  • cite_reference_link_suffix
  • cite_references_link_prefix
  • cite_references_link_suffix
  • cite_reference_link
    1. ref ID
    2. backlink ID
    3. count to display
  • cite_references_link_one
    • Used to format the source list that ‎<references /> outputs, it configures 3 things: the backlink ID, the ref ID, and text of note.
    1. backlink IDUsed for creating the number order of the source list.
    2. ref IDUsed to link back to the actual reference in the text, this is where you can configure the ^ symbol.
    3. text of notetext used above describing the source info
  • cite_references_link_many
    1. backlink ID
    2. list of links
    3. text of note
  • cite_references_link_many_format
    1. ref ID
    2. numeric value to use as a backlink
    3. custom value (as defined in cite_references_link_many_format_backlink_labels to use as a backlink)
  • cite_references_link_many_format_backlink_labels
  • cite_references_link_many_sep
  • cite_references_link_many_and
  • cite_references_suffix

Set references to use ^ and letters

To replace the default uparrow (↑) with caret (^), modify the following system message. All of these pages can be found on Special:AllMessages.

MediaWiki:Cite reference backlink symbol
From To
^
MediaWiki:Cite references link many format

Replacing $2 with $3 changes the links from 1.0, 1.1, 1.2 to a, b, c etc…

From To
<sup>[[#$1|$2]]</sup>
<sup>[[#$1|$3]]</sup>

Searching for these pages for the first time will result in no matches. Simply click "Create this page" to edit the code. The changes will not show up until a page with references is rebuilt.

Set reference and reference number highlighting

Starting with MediaWiki 1.26 the selectors for highlighting are now incorporated into Cite/modules/ext.cite.css. Thus the CSS code below no longer needs to be added manually.

Add the following code to the MediaWiki:Common.css page.

/* make the Cite extension list of references look smaller and highlight clicked reference in blue */
ol.references { font-size: 90%; }
ol.references li:target { background-color: #ddeeff; }
sup.reference:target { background-color: #ddeeff; }


Broken references

Jeżeli znaczniki ‎<ref> lub ‎<references /> nie będą użyte poprawnie, rozszerzenie Cite wyświetli na stronie komunikat błędu i doda stronę do kategorii "Strony z zepsutymi przypisami". These error messages will appear in the user interface language, either in the article content or in the References section. Na przykład:

Wikitekst Wynik
To jest przykład wiadomości błędu odniesień.<ref broken>Intended text.</ref>

==Przypisy==
<references />

To jest przykład wiadomości błędu odniesień.Cite error: Invalid parameter in <ref> tag

Uwagi

Zobacz też