Rozšíření:Lingo

Toto rozšíření je profesionálně spravováno týmem WikiTeq.

WikiTeq poskytuje oficiální podporu pouze pro verze MediaWiki LTS. Může fungovat s jinými verzemi MediaWiki.

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

Lingo Stav rozšíření: stabilní
Implementace	Rozšířená syntaxe , Vzhled , Značka
Popis	Poskytuje tipy nástrojů pro najetí kurzorem na stránky ze slov definovaných na stránce wiki
Autoři	Barry Coughlan Stephan Gambke
Správci	WikiTeq team
Nejnovější verze	3.3.0 (2026-01-01)
Zásady kompatibility	Pro každé vydání MediaWiki, které je vydáním dlouhodobé podpory, existuje v rozšíření odpovídající větev.
MediaWiki	1.45+
PHP	7.4+
Změny v databázi	Ne
Composer	mediawiki/lingo
Parametry $wgLingoPage $wgLingoWCAGStyle $wgLingoBackend $wgLingoDisplayOnce $wgLingoEnableApprovedRevs $wgLingoUseNamespaces $wgLingoCacheType
Použité háčky (hooks) ArticlePurge PageContentSave ContentAlterParserOutput ApiMakeParserOptions GetDoubleUnderscoreIDs ParserFirstCallInit SpecialPageBeforeExecute
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 README Release notes
Přeložte rozšíření Lingo, používá-li lokalizaci z translatewiki.net
Problémy	Otevřené úkoly · Nahlásit chybu

Lingo je rozšíření glosáře. Umožňuje definovat seznam zkratek a jejich definic na stránce a poté je zobrazit vždy, když na zkratku v článku najedete myší.

Kódování definic je v souladu s WCAG (Web Content Accessibility Guidelines) a mělo by být dostupné i ve čtečkách obrazovky.

Použití

Stránka s terminologií

Ve výchozím nastavení Lingo označí jakoukoli stránku termíny a definicemi definovanými na stránce Terminologie vaší wiki (nebo na příslušné stránce v jazyce vaší wiki). Vytvořte tuto stránku a vložte do ní některé položky pomocí následující syntaxe:

;FTP:File Transfer Protocol
;AAAAA:American Association Against Acronym Abuse
;ACK:Acknowledge
;AFAIK:As Far As I Know
;AWGTHTGTATA:Are We Going To Have To Go Through All This Again
;HTTP:HyperText Transfer Protocol

V termínu můžete použít libovolné znaky (včetně interpunkce, mezer a všech znaků UTF-8, samozřejmě s výjimkou dvojtečky (:)). Nejste omezeni pouze na písmena.

Pro strukturování stránky s terminologií je také povoleno mít termíny a definice na samostatných řádcích. Řádky, které nezačínají středníkem (;) nebo dvojtečkou (:), budou ignorovány, takže můžete vkládat prázdné řádky, nadpisy a vysvětlující text.

Pomocí tohoto formátu můžete přiřadit jednu definici více termínům, např. pro pokrytí gramatických variant (viz příklad USA níže), a více definic jednomu termínu, např. pro pokrytí různých významů (viz příklad ACK). Můžete to dokonce kombinovat, tj. mít více definic pro sadu více pojmů. Nakonec můžete také použít transkluzi, např. k vytvoření různých glosářů pro různá témata a jejich shrnutí na stránce Terminologie.

;FTP
:File Transfer Protocol

;AAAAA
:American Association Against Acronym Abuse

;ACK
:Acknowledge
:Acklington railway station

;U.S.A.
;USA
:United States of America

Pull in more terminology from elsewhere:
{{:MoreTerminology}}

Vyloučení textu ze značek

Článek můžete z označení vyloučit přidáním magického slova __NOGLOSSARY__ kamkoli do textu daného článku.

V některých případech může být nutné vyloučit pouze části stránky, např. protože Lingo narušuje některé JavaScripty. Toho lze dosáhnout zabalením této části do HTML elementu (např. span nebo div) a zadáním hodnoty class="noglossary". Jako zkratku pro ‎<span class="noglossary"> můžete použít pouze tag ‎<noglossary>.

ApprovedRevs

Lingo podporuje rozšíření Approved Revs pro stránku s terminologií. Viz #Přizpůsobení níže.

Internacionalizace

Rozšíření je nyní díky úsilí dobrovolníků na projektu https://translatewiki.net docela dobře internacionalizované. (Pokud váš jazyk ještě není podporován, založte si tam účet a pomozte si. Je to snadné!) Chcete-li zjistit název stránky Terminologie a magického slova __NOGLOSSARY__ v jazyce vaší wiki, podívejte se na soubory ve složce i18n a souboru Lingo.i18n.magic.php. Pokud chcete změnit název stránky Terminologie, můžete tak učinit úpravou stránky na vaší wiki s názvem MediaWiki:lingo-terminologypagename.

Instalace

Composer

Lingo by se mělo nainstalovat pomocí balíčku Composer . Název balíčku je mediawiki/lingo. Pokyny k instalaci Composeru naleznete v Uživatelské příručce Composeru na MediaWiki.

1. Spusťte COMPOSER=composer.local.json php composer.phar require --no-update mediawiki/lingo ^3.0 z instalačního adresáře MediaWiki.
2. Spusťte php composer.phar update --no-dev mediawiki/lingo z instalačního adresáře MediaWiki.

   Jakákoli budoucí aktualizace je pak jen volání na php composer.phar update --no-dev mediawiki/lingo.

3. Přidat na konec LocalSettings.php : wfLoadExtension('Lingo');
4. V případě potřeby proveďte úpravy (viz níže).
5. Přejděte na stránku Special:Version vaší wiki a ověřte, zda existuje záznam o Lingu.
6. Z Lingova hesla na stránce Special:Version klikněte na odkaz na stránku Terminologie vaší wiki a vložte tam nějaké hesla NEBO (pokud tato stránka již existuje) ji upravte a znovu uložte, čímž spustíte obnovení glosáře.

Používání stahovaných balíčků

Pokud Composer není k dispozici, můžete jej nainstalovat také takto:

1. Stáhněte si Lingo 3.2.0 nebo aktuální vývojovou verzi (Alternativně můžete naklonovat Lingo pomocí gitu .)
2. Rozbalte soubory do adresáře $IP/extensions
3. V případě potřeby přejmenujte nově vytvořený adresář na Lingo
4. Přidat na konec LocalSettings.php : wfLoadExtension('Lingo');
5. V případě potřeby proveďte úpravy (viz níže)
6. Přejděte na stránku Special:Version vaší wiki a ověřte, zda existuje záznam o Lingu.
7. Z Lingova hesla na stránce Special:Version klikněte na odkaz na stránku Terminologie vaší wiki a vložte nějaké hesla NEBO (pokud tato stránka již existuje) ji upravte a znovu uložte, čímž spustíte obnovení glosáře.

Přizpůsobení

Přidejte k LocalSettings.php následující a podle potřeby odkomentujte/upravte:

// zadejte jiný název pro stránku s terminologií (výchozí: 'Terminologie' (nebo lokalizovaná verze). (Podívejte se na stránku MediaWiki:Lingo-terminologypagename.)
//$wgexLingoPage = 'Terminology';

// určete, že každý termín by měl být anotován pouze jednou na stránku (výchozí: false)
//$wgexLingoDisplayOnce = false;

// specifikujte, které jmenné prostory by se měly nebo neměly používat (výchozí: Prázdné, tj. použijte všechny jmenné prostory)
//$wgexLingoUseNamespaces[NS_SPECIAL] = false;

// nastavit výchozí typ mezipaměti (výchozí: null, tj. použít hlavní mezipaměť)
//$wgexLingoCacheType = CACHE_NONE;

// použijte rozšíření ApprovedRevs na stránce Terminologie (výchozí: false)
 //$wgexLingoEnableApprovedRevs = true;

Hodnota MobileFrontend potlačí stylizaci jazyka Lingo, což způsobí, že se všechny definice použité v článku zobrazí na konci stránky. Abyste tomu předešli, přidejte při použití MobileFrontend k LocalSettings.php následující:

$wgMFRemovableClasses = [ 'base' => [ '.mw-lingo-tooltip' ] ];

Lingo také poskytuje rozhraní pro připojení alternativních slovníků (backendů). Pokud vás to zajímá, podívejte se na příklad v Semantic Glossary . Můžete mi také napsat e-mail.

Nakonec si můžete vytvořit vlastní styl. Třídy používané Lingem pro různé HTML prvky naleznete v souboru Lingo.less.

Vitríny

• NORA online – webové stránky referenční architektury nizozemské vlády
• Helminthic Therapy Wiki – informační databáze o substituční terapii proti helmintům
• https://www.wissensmanagement.gv.at – webové stránky pro znalostní management v rakouské státní správě

Přidejte sem svou wiki stránku!

Historie verzí

• Historii verzí naleznete v sekci release-notes.md.

Kredity

Lingo je přepsání rozšíření Terminology , napsaného programem BarkerJr s úpravami programem Benjamin Kahn. Lingo původně napsal uživatel Barry Coughlan a v současné době jej spravuje uživatel WikiTeq.

Lingo využívá knihovnu jQuery qTip2.

Hlášení chyb

Chyby a požadavky na nové funkce by měly být nejlépe hlášeny na sledovač chyb Wikimedie.

Připomínky, dotazy a návrhy zasílejte nebo poštou na adresu:

• Extension talk:Lingo – diskusní stránka Lingo
• https://www.wikiteq.com/contact – údržbář

Související odkazy

• Extension:Semantic Glossary