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í.
MediaWiki	1.34+
PHP	7.0+
Licence	GNU General Public License 2.0 nebo novější
Stáhnout	Stáhněte si rozšíření Git [?]: Procházení úložiště (Phabricator · GitHub) Kontrola kódu Gerrit Zobrazení historie Git Stáhněte si zdrojový soubor tarball
Příklad	Wikipedia:Footnotes
Parametry $wgCiteDefaultBacklinkAlphabet $wgCiteReferencePreviewsConflictingNavPopupsGadgetName $wgCiteResponsiveReferencesThreshold $wgCiteResponsiveReferences $wgCiteSubReferencing $wgCiteBacklinkCommunityConfiguration $wgCiteReferencePreviews $wgCiteUseLegacyBacklinkLabels $wgCiteVisualEditorOtherGroup $wgCiteReferencePreviewsConflictingRefTooltipsGadgetName
Použité háčky (hooks) APIQuerySiteInfoGeneralInfo CommunityConfigurationProvider_initList ContentHandlerDefaultModelFor EditPage::showEditForm:initial GetPreferences MakeGlobalVariablesScript ParserAfterParse ParserClearState ParserCloned ParserFirstCallInit ResourceLoaderGetConfigVars ResourceLoaderRegisterModules UserGetDefaultOptions
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í

$wgCiteBookReferencing

Touto proměnnou, je-li nastavena na true, lze aktivovat vnořené poznámky (viz nápověda). Jde o experimentální funkcionalitu. Výchozí hodnota: false

$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í. Výchozí hodnota: 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. Výchozí hodnota je: 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.

Příklad:

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

(Z: https://gerrit.wikimedia.org/r/plugins/gitiles/mediawiki/extensions/Cite/+/refs/heads/REL1_44/modules/ve-cite/ve.ui.MWReference.init.js#64)

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