Extension:Cite

Toto je dokumentace rozšíření. Pro to, jak ho používat, se podívejte na nápovědu k citacím.

Příručka k rozšířením MediaWiki

Cite Stav rozšíření: stabilní
Implementace	Značka
Popis	Umožňuje vkládat informace k citovaným zdrojům ve formě poznámek pod čarou, čímž umožňuje řádnou citaci offline médií.
Autoři	Ævar Arnfjörð Bjarmasondiskuse
Nejnovější verze	Průběžné aktualizace
Zásady kompatibility	Vydání snímků současně s MediaWiki. Hlavní vývojová větev není zpětně kompatibilní.
PHP	7.0+
Změny v databázi	Ne
Parametry $wgCiteDefaultBacklinkAlphabet $wgCiteReferencePreviewsConflictingNavPopupsGadgetName $wgCiteResponsiveReferencesThreshold $wgCiteResponsiveReferences $wgCiteSubReferencing $wgCiteUseLegacyBacklinkLabels $wgCiteBacklinkCommunityConfiguration $wgCiteRemoveSyntheticRefsUnsafe $wgCiteReferencePreviews $wgCiteSubRefMergeInDevelopment $wgCiteVisualEditorOtherGroup $wgCiteReferencePreviewsConflictingRefTooltipsGadgetName
Značky ‎<ref> ‎<references>
Použité háčky (hooks) APIQuerySiteInfoGeneralInfo CommunityConfigurationProvider_initList ContentHandlerDefaultModelFor EditPage::showEditForm:initial GetPreferences MakeGlobalVariablesScript ParserAfterParse ParserClearState ParserFirstCallInit ResourceLoaderGetConfigVars ResourceLoaderRegisterModules UserGetDefaultOptions
Licence	GNU General Public License 2.0 nebo novější
Stáhnout	Stáhněte si rozšíření Git [?]: Procházení úložiště (GitHub) Kontrola kódu Gerrit Zobrazení historie Git Stáhněte si zdrojový soubor tarball
Příklad	Wikipedia:Footnotes
Přeložte rozšíření Cite, používá-li lokalizaci z translatewiki.net
Problémy	Otevřené úkoly · Nahlásit chybu

Rozšíření Cite umožňuje uživateli vytvářet v rámci stránky poznámky pod čarou. Přidává proto do MediaWiki dva parsovací háčky, ‎<ref> a ‎<references>, které umožňují vkládat citace a poznámky rovnou do kódu stránek.

Použití

Pro další informace viz nápovědu k použití rozšíření Cite.

Instalace

Toto rozšíření je součástí MediaWiki 1.21 a vyšší. Zbývající konfigurační pokyny je stále nutné dodržovat.

• Stáhněte soubor/y a vložte je do adresáře pojmenovaného Cite ve vaší složce extensions/.
  Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Cite
  

• Na konec vašeho souboru LocalSettings.php přidejte následující kód:

  wfLoadExtension( 'Cite' );
  

• Úprava konfigurace je žádoucí.
• Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Instalace Vagrant:

• Pokud používáte Vagrant , instalujte s těmito parametry vagrant roles enable cite --provision

Nastavení

Name	Description	Default
$wgCiteSubReferencing	Povoluje subreferencing při nastavení na true, viz stránka s nápovědou.	false
$wgCiteReferencePreviews	Povolí náhledy referencí, když je nainstalován Extension:Popups a nastaven na true	true
$wgCiteReferencePreviewsConflictingRefTooltipsGadgetName	Název lokálního gadgetu Reference Tooltips použitý jako jeho identifikátor v MediaWiki:Gadgets-definition . Tento gadget není kompatibilní s náhledy referencí. Náhledy referencí se pro uživatele s povoleným gadgetem samy deaktivují.
$wgCiteResponsiveReferences	Výchozí nastavení pro responzivní zobrazení poznámek pod čarou. Je-li nastaveno na true, budou poznámky pod čarou zobrazovány ve více sloupcích. Viz dokumentace ohledně použití.	true
$wgCiteVisualEditorOtherGroup	Je-li tato proměnná nastavena na true, bude tlačítko pro nástroj Citovat (Cite) přesunut pod menu Vložit (Insert). Takto je to použito např. na stránkách Wikivoyage. Viz původní požadavek na tuto funkcionalitu.	false

Přidáním definice ve formátu JSON k MediaWiki:Cite-tool-definition.json lze citační menu naplnit nástroji, které vytvářejí reference obsahující specifické šablony. Obsah definice by měl být pole obsahující řadu objektů, jeden pro každý nástroj. Každý objekt musí obsahovat name, icon, template vlastností. Volitelnou vlastnost title lze také použít k definování názvu nástroje v prostém textu. Vlastnost name je jedinečný identifikátor nástroje a také poskytuje záložní název nástroje tím, že je transformována na klíč zprávy. Název má předponu visualeditor-cite-tool-name- a zprávy lze definovat na Wiki. Některé běžné zprávy jsou předdefinované pro názvy nástrojů, například web, book, news, journal, map.

Příklad:

[ { "name": "web", "icon": "browser", "template": "Cite web" }, ... ]

(Z: gerrit:plugins/gitiles/mediawiki/extensions/Cite/+/refs/heads/wmf/1.46.0-wmf.7/modules/ve-cite/ve.ui.MWReference.init.js#66)

Omezení

Řešeno přes Phabricator
Úkol T4700
Otevřeno

• Trik s pipe a další transformace před uložením nefungují v poznámkách pod čarou vytvořených s tímto rozšířením.

Související odkazy

• Nápověda:Citace – poznámky pod čarou
• Extension:Semantic Cite
• Extension:CiteThisPage