Extension:Cite/Cite.php


 * ''This page is about the extension. See also Help:Footnotes, and Wikipedia:Footnotes for the use in the English Wikipedia.

Cite.php is a Cite extension that adds two parser hooks to MediaWiki,  and  ; these operate together to add citations to pages.

Installation

 * 1)  Hent snapshot, der matcher din version af MediaWiki og sætte det i  extensions -mappen.
 * 2) Tilføj følgende linje til bunden af   LocalSettings.php  (dog ikke efter afsluttende?>, Hvis det findes):

Usage
The basic concept of the &lt;ref> tag is that it inserts the text enclosed by the ref tags as a footnote in a designated section, which you indicate with the placeholder tag &lt;references />. The new format cannot be used interchangeably with the old format — you must pick one or the other.

If you forget to include &lt;references /> in the article, the footnotes will not appear, but a red error message will be displayed at the end of the page.

This page itself uses footnotes, such as the one at the end of this sentence. If you [ view the source] of this page by clicking "Edit this page", you can see a working example of footnotes.

Example
 According to scientists, the Sun is pretty big. &lt;ref>E. Miller, The Sun, (New York: Academic Press, 2005), 23-5.&lt;/ref> The Moon, however, is not so big. &lt;ref>R. Smith, "Size of the Moon", Scientific American, 46 (April 1978): 44-6.&lt;/ref> &#61;=Notes== '''&lt;references/> 

Multiple uses of the same footnote
To give a footnote a unique identifier, use &lt;ref name="name">. You can then refer to the same footnote again by using a ref tag with the same name. The text inside the second tag doesn't matter, because the text already exists in the first reference. You can either copy the whole footnote, or you can use a terminated empty ref tag that looks like this: &lt;ref name="name" />.

In the following example, the same source is cited three times.

 This is an example of multiple references to the same footnote. &lt;ref name&#61;"multiple">Remember that when you refer to the same footnote multiple times, the text from the first reference is used.&lt;/ref> Such references are particularly useful when citing sources, if different statements come from the same source. &lt;ref name&#61;"multiple">This text is superfluous, and won't show up anywhere. We may as well just use an empty tag.&lt;/ref> A concise way to make multiple references is to use empty ref tags, which have a slash at the end. Although this may reduce redundant work, please be aware that if a future editor removes the first reference, this will result in the loss of all references using the empty ref tags. &lt;ref name&#61;"multiple" /> &#61;=Notes== &lt;references/> 

The text above gives the following result in the article (see also section below): This is an example of multiple references to the same footnote. Such references are particularly useful when citing sources, when different statements come from the same source. A concise way to make multiple references is to use empty ref tags, which have a slash at the end. Although this may reduce redundant work, please be aware that if a future editor removes the first reference, this will result in the loss of all references using the empty ref tags.

Note: identifiers require alphabetic characters; solely relying on numerals will generate an error message

&lt;references /&gt;
Placing  inserts the full text of all pending inline citations defined by , anywhere on the page. For example, based on the citations above, the code:

will yield:

, which incorporates. It provides an optional parameter to display the reference list in multiple columns. For instance, the English, Hindi and Interlingua Wikipedias use the css selector  to make the reference text smaller than normal text.

In the case of multiple references-tags on a page, each gives the references defined in the ref-tags from the previous references-tag. In the case that these references-tags are produced by templates, each gives the references defined in the ref-tags before the first references-tag, and there is an error message that there is a ref-tag but not a references-tag.

Grouped references
This may be disabled by  if desired. However, it is enabled on the foundation wikis.

The following example generates separate reference lists for citations and miscellaneous footnotes:

 According to scientists, the Sun is pretty big &lt;ref>E. Miller, The Sun, (New York: Academic Press, 2005), 23-5.&lt;/ref>. In fact, it is very big &lt;ref group="footnotes">Take their word for it. Don't look directly at the sun!&lt;/ref>. &#61;=Notes== '''&lt;references group="footnotes"/> &#61;=References== '''&lt;references/>  The anonymous group works as before, while the named group reference will show up as, and the references will look like this: section, to the place where they will actually appear to the reader. Thus,

 According to scientists, the Sun is pretty big. &lt;ref name="miller"/> The Moon, however, is not so big. &lt;ref name="smith"/> &#61;=Notes== &lt;references> &lt;ref name="miller">E. Miller, The Sun, (New York: Academic Press, 2005), 23-5.&lt;/ref> &lt;ref name="smith">R. Smith, "Size of the Moon", Scientific American, 46 (April 1978): 44-6.&lt;/ref> &lt;/references> 

will have the same output as the first example above.

Customization
The format of the output of  and   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  and   and the values, if any, that are passed to them ($1, $2, $3 ...), see the code in CVS for an up-to-date listing of their default contents.

Source: Wikipedia stylesheet --Wikinaut 03:02, 23 December 2009 (UTC)
 * cite_reference_link_key_with_num
 * key
 * num
 * cite_reference_link_prefix
 * cite_reference_link_suffix
 * cite_references_link_prefix
 * cite_references_link_suffix
 * cite_reference_link
 * ref ID
 * backlink ID
 * count to display
 * cite_references_link_one
 * Used to format the source list that and other skins you might be using. Note: $IP stands for the root directory of your MediaWiki installation, the same directory that holds LocalSettings.php.

Problemer MED cite.php
Jeg Administrator installeret MediaWiki 1.15.1 For at tabe problemet MED CITES OG henvisninger jeg lavede folgende, SOM jeg blev foreslået:


 * Download øjebliksbillede, der matcher din version AF MediaWiki OG sætte DET i extensions Biblioteket. (Gjört)
 * Tilføj folgende Linje Til LocalSettings.php:
 * $ IP / extensions / Cite / Cite.php (Gjört)
 * $ IP / includes / DefaultSettings.php (Gjört)

OG KAN ikke Brugge

Enhver antydning Eller hjælp? Tak forhånd i Coconuts34 18:15, 11. november 2009 (UTC)

Fjern Denne Linje. "$ IP / includes / DefaultSettings.php" Dette ER sandsynligvis allerede krævet i din LocalSettings.php. Alt du Skal Gore er i Sorge for, at "$ IP / extensions / Cite / Cite.php" Kommer Morgen, Lys "$ IP / includes / DefaultSettings.php". 192.75.172.1 16:17, 14 december 2009 (UTC)
 * -Tak for din hjælp! Coconuts34

Fatal benytter normalt: Hidkalde høne Til udefinerede Funktion wfloadextensionmessages
Fatal benytter normalt: Hidkalde høne Til udefinerede Funktion wfloadextensionmessages in / home / extensions / Cite / Cite.php on line 32.

Dette benytter normalt blev modtaget engang udvidelse blev tilføjet. [Http: / / www.mediawiki.org / wiki / Manual:% 24wgExtensionMessagesFiles $ wgExtensionMessagesFiles] virker Kun MED version 1,11. Opdater din version. eller download 1,10 filialer extensions

Apache benytter normalt
PHP logger en benytter normalt i Apache benytter normalt log: (MediaWiki 1.6.8, PHP 4.4.4, Apache 1.3.37) [Benytter normalt] PHP Bemærk: Brug AF udefinerede Konstant __METHOD__ - formodet '__METHOD__ »Jeg extensions / Cite / Cite.php on line 609 [Benytter normalt] PHP Bemærk: Brug AF udefinerede Konstant __METHOD__ - formodet '__METHOD__ »Jeg extensions / Cite / Cite.php on line 612
 * Jeg var i stand Til at miste dette ved at placere anførselstegn omkring  __METHOD__  i begge linier (609 & 612)
 * Dette ER fordi __METHOD__ ER Kun tilgængelig, da PHP 5, v hjælp AF '__METHOD__' er ikke en korrekt rettelse. - Lode

Version 1.6.8
DET fungerer ikke MED version 1.6.8! Jeg efterhånden FIK cite.php arbejder MED "13660", mænd ikke "13826" versioner. Min fejlmeddelelser syntes øverst i siden:


 * Advarsel: KAN ikke ændre header information - headers allerede sendt af (output startede i /****/ wiki/extensions/Cite.i18n.php: 399) i /****/ OutputPage.php on line 575
 * Advarsel: KAN ikke ændre header information - headers allerede sendt af (output startede i /****/ wiki/extensions/Cite.i18n.php: 399) i /****/ wiki / includes / OutputPage.php i line 576

[Denne benytter normalt KAN opstå, hvis der ER en Ekstra (ikke synlige) tegn i php blev slettet. DET synes jeg SKE massevis MED desktop redaktører, i hvert Fald i Windows. Prov. Jeg redigere blev slettet MED DIT råtanken i (pico Eller vi) OG fjerne eventuelle ledende Eller Afsluttende karakterer.]

Misrendered Anker link Karakter
??? Kortfilm i afsmeltede sider i stedet for ↑ - DET kunne være muligt Pa ved miste dette ved at erstatte den pil op Karakter MED ↑ (de tilsvarende HTML Enhed Gjört ↑). Alternativt KAN karet (^) sandsynligvis blive brugt SOM en Erstatning.

Skabeloner
((# Tag: ref | Template (((1 | substitution))) virker! | Navn = (((2 | default }}}}} 
 * Brug  i skabeloner pauser nummerering: Problem MED MediaWiki OM i hvilken rækkefølge tingene ER parset
 * Brug  i en skabelon VII, skabe korrekt nummererede reference mærke, mænd DET VII, Mangler i produktionen AF EN , OM afholdelse side ([http : / / en.wikipedia.org / wiki / Bruger: Pengo / pageusingref Eksempel]), medmindre Referencer tag er transcluded også!
 * DET ER umuligt at passere skabelon argumenter Til, f.eks   MED Ældre versioner AF MediaWiki, se  bug 4529. Søm i  1,12 + er DET muligt at gore skabelon argumenter MED    magiske ORD indersiden AF skabelonen:
 * Skabelon substitution misrenders uafhæn -tag.

HTML parameter

 * Begrundelsen links genereres AF OG backlinks genereret AF  vedhæftninger
 * Problem MED MediaWiki, ikke Denne side udvidelse. MediaWiki VII, generere output SOM, nar DET giveren input gerne


 * Manglende  Navn = </ tt> ankre for bagudkompatibilitet ( 5567 </ small>)
 * Den genererede  <a href="#_note-n"> </ tt> links bor have en  name = "_ref-n" </ tt>.
 * Den genererede  <a href="#_ref-n"> </ tt> links bor have en  name = "_note-n" </ tt>.
 * Denne Øjeblikket ser UD Til at VIRKE.

HTML kommenterede-out virker ikke
Udkommentere  MED HTML kommentarer   skjuler Citat mænd henvisningen stadig Kortfilm i lytte
 * Dette synes at være en parser benytter normalt ...
 * Synes i Skal hurtigt MED ny parser. -  81.241.208.92 14:16, den 2. februar 2008 (UTC)

ParserFunctions
cite.php KAN ikke indlejres korrekt i ParserFunctions. For Eksempel, " " VII, vende Tilbage Bade "true" og "falske" SOM henvisninger uanset resultatet AF ParserFunction. Mænd ParserFunctions fungerer perfekt uafhæn tags.
 * Finde MED Grav bevise " "? MC10 02:52, 21. April 2010 (UTC)

Blank Special: Version

 * DET lader Til kl folgende Kode årsager v1.9.2 's Special: version side Til i ga tom:

»OG Nyd '=>' Ævar Arnfjörð Bjarmason«
 * AEndring i Denne side fastsætter DET (undskyld hvis DET ER "oversat" forkert):

»OG Nyd '=>' Ævar Arnfjord Bjarmason«

Rendering
Indhold AF ikke-Forst nævnte  ikke ER pudset, SELV OM Allé tidligere tags MED samme Navn ER Tomme.

Manglende preview
Der ER Ingen preview for inline citater. Dette ER især irriterende, nar du redigerer Kun en del AF EN side. ( Bug 5984)

Brugere Uden redigere privilegier ikke KAN se Referencer, hvis systemoperatører KAN
Den folgende kombination AF $ wgGroupPermissions gor henvisninger usynlige for brugere, SOM ER ikke logget IND ( benytter normalt 11224). Dette benytter normalt startede engang Morgen, Lys Mediawiki 1.9.3. OG fortsætter Til 1.13.2

Løsning
Et Aktuelt work-around er i sætte OG ikke give Nøgen redigeringsrettigheder Til systemoperatører. Brugere, der ER systemoperatører VII, derefter skulle være en del AF en buffer Gruppe MED redigering privilegier.

Delvis fastsætte rådighed
Dette benytter normalt blev delvist fastsat i revision 36.333. Geninstaller Cite.php OG henvisningerne Ville bliver synlige (OG dermed ovenstående Løsning er ikke nødvendigt). Mænd nogle falske stadig opfører: Alle reference hyperlinks er knyttet Til den første fodnote nedenfor (i stedet for de tilsvarende tal), der Alle baglæns hyperlinks FRA fodnoter Hoppe Til den første henvisning i teksten (i stedet for de tilsvarende tal), OG Referencer i transcluded Siderne ER ikke håndteres korrekt.

Se diskussionsside for yderligere tankskib OM problemet.

Gruppering henvisninger
Hvis jeg gor DET  Blah foo </ ref> bar </ ref> baz </ ref> qux </ ref> Walla. </ Nowiki> </ tt>, Langt jeg:
 * Blah [1] [2] [3] [4] </ sup> </ font> Walla.

i stedet for
 * Blah [1] </ font> - [4] </ font> </ sup> Walla.

Kritik
Den største kritik af Cite.php er, at det gør redigering af henvisninger meget mere kedelig. Desuden, fordi mange casual Wikipedia-brugere ikke er familar med kryptiske Wikitext tags, de kan finde med brugen af Cite.php, er det sandsynligt, at nettoeffekten af Cite.php er ofte at afholde nye brugere fra at redigere reference sektioner. Selv om Wikipedia angiveligt fik sit navn fra Hawaii ordet "wiki-wiki", der betyder "hurtig-hurtig", Cite.php er nok hverken hurtig eller let for den gennemsnitlige Wikipedia bruger.


 * En mulig løsning ville være at have konkret henvisning sektion indeholder alle referencer med fornavne, så hele artiklen, skal du blot reference ved navn, i stedet for hele citatet. Dette ville også mindske forvirring om flere anvendelser af et reference med forskellige tekst, men kun viser de første instans (skaber forvirring med sektioner er flyttet rundt på, kan det viste reference forandring, mens teksten ikke har). Dvs:

Noget tekst, der kræver en ref. ((ref | foo)) En anden sætning, der bruger et ref ((ref | bar)) efterfulgt af en anden brug af den første ref. ((ref | foo)) </ Pre>


 * Brug af cite.php gør citere sidetal hårdere. Hver reference normalt henvist til en anden side af bogen / tidsskriftet / artiklen, men der er ingen måde at angive en anden side nummer, når du bruger en selvlukkende tag. Som sådan, al </ Nowiki> blot henvise til værket som en helhed, snarere end til en bestemt side nummer i arbejde (medmindre forfatteren gør hver side nummer et særskilt reference ). Måske en kommende revision af cite.php kan tillade et sidetal argument, der skal videregives til reference som så </ Nowiki>. Dette ville betyde en drastisk forværring af reputability af de citater, fordi de så kan kontrolleres / verificeres, og henvisningerne ville være et mere brugbar ressource.

Referencer
((Refs ((Ref | foo | Tekst af reference)) ((Ref | bar | En forskel reference)))) </ pre>


 * Selv ville dette kræver to går i fortolkeren, ville det i høj grad forenkle processen med sourcing. Dvs hvis jeg tilføjer noget til en artikel og ønsker at bruge en kilde, som jeg ved er allerede nævnt, jeg er nødt til at grave gennem teksten i artiklen for at finde, hvor det anvendes, (som kan være en stor smerte i store artikler, esp . dem, der har en masse referencer) i stedet for blot et blik på koden til henvisninger afsnittet og finde navnet.

Et andet kritikpunkt er, at i modsætning til Footnotes3 er det i øjeblikket umuligt at adskille bibliografiske oplysninger fra artiklen kopi.

Men mindst én editor, Ta bu shi da yu, har fundet det utroligt nyttigt at splitte artikler og skiftende tekst med fodnoter omkring artiklen. Før, til et stykke med en tiltrængt fodnote skal flyttes, og flere fodnoter i sektionen Noter flyttet. Det var meget vanskeligt at gøre. Med Cite.php, omstrukturering af teksten og opdele artikler er betydeligt lettere.

Tidligere problemer

 * Udvidelsen har ikke generere id attributter, der kan ensartet stylet med CSS2 attribut selektorer: Issue i Cite.php, se bug 4579
 * Brug multibyte tegn, koloner, mellemrum og andre værdier, som skal være kodet i henhold til HTML spec pauser interne links: Problem med MediaWiki, ikke denne forlængelse, se bug 4461.
 * Brug  i billedkommentarer bryder XHTML output: Problem med MediaWiki, ikke denne forlængelse, se  bug 1887.

Sammenligning ref / note stil og Cite.php stil
De er faktisk meget ens.


 * For at foretage et enkelt brug fodnote:
 * Ref / notat
 * < Nowiki> ((ref | foo)) </ Nowiki>på in-tekst plads.
 * < Nowiki> # ((note | foo)) </ Nowiki> tekst notepå rette sted i Notes listen.
 * Cite.php
 * < Nowiki> tekst note </ ref> </ Nowiki>på in-tekst plads.
 * # (Kun nødvendig én gang pr artikel) </ Nowiki>under bemærkninger til pos.
 * For at gøre flere anvendelser fodnote:
 * Ref / notat
 * Med strenge ref / note stil dette var umuligt, men en række alternative former var skabt, for som nærmere, henvises til de pågældende sider.
 * Cite.php
 * < Nowiki> tekst note </ ref> </ Nowiki>på hver tekst plads.
 * # # Alternativt </ Nowiki>A selvlukkende tag på hver bruger eftername = fooer blevet defineret.
 * # (Kun nødvendig én gang pr artikel) </ Nowiki>under Notes position nøjagtigt det samme som at gøre en enkelt anvendelse note.

Harvard references extension
There is an Extension:HarvardReferences that can be used to support "Harvard" ("author - date") system of references, e.g.  [Smith 2010:1] . This reference system is often used in scientific literature. Both extensions are compatible. Moreover, links in "Harvard" system can be inserted into body of ref-link, and vice versa. It may be helpful to support book-style comments/subnotes with a "scientific" source references. For example: