Extension:CharInsert

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

CharInsert Stav rozšíření: stabilní
Implementace	Značka , Akce stránky , MyWiki
Popis	Umožňuje vytvářet pole pro vkládání znaků v JavaScriptu.
Autoři	Brion Vibber (Brooke Vibberdiskuse)
Nejnovější verze	continuous updates
Zásady kompatibility	Vydání snímků současně s MediaWiki. Hlavní vývojová větev není zpětně kompatibilní.
Značky ‎<charinsert>
Použité háčky (hooks) BeforePageDisplay ParserFirstCallInit
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řeložte rozšíření CharInsert, používá-li lokalizaci z translatewiki.net
Problémy	Otevřené úkoly · Nahlásit chybu

Rozšíření CharInsert umožňuje vytváření odkazů v jazyce JavaScript, které po kliknutí vloží předdefinovaný text do textového pole.

Tyto odkazy se obvykle používají v systémové zprávě MediaWiki:Edittools (příklad na této wiki).

Syntaxe

Použijte tagy ‎<charinsert> se seznamem znaků oddělených mezerami nebo tagy, pro které chcete povolit vkládání.

Znak + uvnitř tagu můžete použít k definování místa pro:

• vložit vybraný text nebo
• umístit kurzor, pokud nebyl vybrán žádný text.

Šablony a mezery musíte uzavřít do proměnné ‎<nowiki>:

<charinsert><nowiki>== + ==</nowiki> <nowiki>{{stub}}</nowiki></charinsert>

Použití a ukázkový výstup

Jednotlivé postavy

Jednotlivé znaky jsou uvedeny pouze mezi tagy "‎<charinsert>...‎</charinsert>".

<charinsert>Á á Ć ć É é Í í Ĺ ĺ Ń ń Ó ó Ŕ ŕ Ś ś Ú ú Ý ý Ź ź</charinsert>

výsledky v

Á á Ć ć É é Í í Ĺ ĺ Ń ń Ó ó Ŕ ŕ Ś ś Ú ú Ý ý Ź ź

Kliknutí na odkazy nebude mít žádný efekt, protože neexistuje žádné vstupní ani editační pole.

Kombinované znaky

Kombinované znaky jsou uvedeny mezi tagy "charinsert" a spojeny znaménkem "+".

<charinsert>“+” ‘+’ «+» ‹+› „+“ ‚+‘ [[+]] {{+}}</charinsert>

výsledky v

“” ‘’ «» ‹› „“ ‚‘ [[]] {{}}

Kliknutí na odkazy nebude mít žádný efekt, protože neexistuje žádné vstupní ani editační pole.

Přepsání zobrazovaného textu

Verze MediaWiki:

≥ 1.38 Gerrit change 748823

V atributu label lze zadat jiný zobrazovaný text (pokud jej použijete, měli byste pro každý znak použít samostatné tagy <charinsert>, abyste mohli zadat různé zobrazované texty).

<charinsert label="Latin A">A</charinsert> <charinsert label="Cyrillic А">А</charinsert> <charinsert label="Greek Alpha">Α</charinsert>

výsledky v

Latin A Cyrillic А Greek Alpha

Kliknutí na odkazy nebude mít žádný efekt, protože neexistuje žádné vstupní ani editační pole.

Poznámky

• Vygenerované odkazy JavaScript fungují i ​​v jiných oblastech kolem okna pro úpravy, např. v MediaWiki:Copyrightwarning nebo MediaWiki:Newarticletext, na stránce předem načtené s Inputbox a dokonce i z náhledu textu.
• Lze je také použít v MediaWiki:Uploadtext k vložení šablon popisů obrázků.
• Na rozdíl od tlačítek panelu nástrojů nahoře toto rozšíření neposkytuje způsob, jak zadat vložený "ukázkový text".
• Použijte 
 pro přidání nových řádků (\n).
• V případě potřeby uzavřete do tagů ‎<nowiki>...‎</nowiki> prázdné mezery.
• Přidejte tagy ‎<charinsert>...‎</charinsert> do MediaWiki:Edittools.

Instalace

• Stáhněte soubor/y a vložte je do adresáře pojmenovaného CharInsert 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/CharInsert
  

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

  wfLoadExtension( 'CharInsert' );
  

• Pokud používáte gadget Edittools , aktualizujte jeho kód na nejnovější verzi (≥ 3. dubna 2020)
• Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Pokročilá instalace

Důležité: Aby to fungovalo, musíte mít Rozšíření:Gadgets .

Styl

Chcete-li seznamům vložených znaků dodatečný styl, vložte obsah nástrojů pro úpravu mezi položky <div class="mw-charinsert-buttons"> a ‎</div> a přidejte pro ně styl do položky MediaWiki:Common.css. Tato stránka (www.mediawiki.org) to dělá proto, aby odkazy vypadaly jako tlačítka (jak je znázorněno na snímku obrazovky vedle). K tomu byl použit níže uvedený stylový list, zkopírujte ho do svého MediaWiki:Common.css a aplikujte stejný styl.

 
/**
 * Styling for links generated by [[MediaWiki:Edittools]]
 * @source https://www.mediawiki.org/wiki/Extension:CharInsert#Styling
 * @updated 2020-03-17
 */
.mw-charinsert-buttons {
	border: 1px solid #aaa;
	margin-top: 10px;
	padding: 1px;
	font-size: 1.1em;
	text-align: center;
}

.mw-charinsert-buttons a {
	background-color: #cde !important;
	color: #000;
	border: thin #069 outset;
	padding: 0 1px 1px;
	font-weight: bold;
	font-size: 0.9em;
	text-decoration: none;
}

.mw-charinsert-buttons a:hover,
.mw-charinsert-buttons a:active {
	background-color: #bcd;
	border-style: inset;
}

.client-js .mw-edittools-section {
	display: inline;
}

.client-js .mw-edittools-section input[type="button"] {
	font-size: 0.9em;
	margin-left: 1px;
	padding-left: 1px;
	padding-right: 1px;
}

Případně si můžete zvolit styl bližší Průvodce stylem vývoje Wikimedie a Šablona WikimediaUI:

 
/**
 * Styling for links generated by [[MediaWiki:Edittools]] in WikimediaUI inspired theme.
 * @source https://www.mediawiki.org/wiki/Extension:CharInsert#Styling
 * @updated 2020-03-17
 */
.mw-charinsert-buttons {
	margin-top: 8px;
	border: 1px solid #c8ccd1;
	padding: 2px 4px 4px;
	font-size: 1.1em;
	text-align: center;
}

.mw-charinsert-buttons a {
	background-color: #f8f9fa !important;
	color: #202122;
	border: thin #36c outset;
	padding: 0 1px 2px;
	font-size: 0.9em;
	font-weight: bold;
	text-decoration: none;
}

.mw-charinsert-buttons a:hover {
	background-color: #fff;
    color: #404244;
}

.mw-charinsert-buttons a:active {
	background-color: #c8ccd1;
	border-style: inset;
}

.client-js .mw-edittools-section {
	display: inline;
}

.client-js .mw-edittools-section input[type="button"] {
	background-color: #f8f9fa;
	color: #202122;
	margin-left: 1px;
    border-radius: 2px;
	padding: 1px 6px;
	font-size: 0.9em;
    /* Apply pointer cursor to all interactive elements. */
    cursor: pointer;
}

.client-js .mw-edittools-section input[type="button"]:hover {
	background-color: #fff;
    color: #404244;
}

.client-js .mw-edittools-section input[type="button"]:active {
	background-color: #c8ccd1;
    color: #000;
}

Skriptování

Pokud máte mnoho odkazů CharInsert, můžete je pomocí JavaScriptu rozdělit do samostatných skupin a umožnit dynamické přepínání pomocí rozbalovací nabídky. Například k oddělení diakritických znaků od wikisyntaxe atd. Několik stránek (například mediawiki.org, de.wikipedia.org a en.wikipedia.org) to udělalo. Všichni to ale implementovali různými způsoby. Níže je popsán způsob, jakým se to dělá na mediawiki.org:

1. Zabalte všechny tagy charinsert na MediaWiki:Edittools do kontejneru ‎<div> a přiřaďte mu popisné, jedinečné ID (například "mw-edittools-charinsert").:

<div id="mw-edittools-charinsert" class="mw-charinsert-buttons" title="Click on the wanted special character.">
...
</div>

2. Zabalte každý jednotlivý blok vložených znaků do tagů ‎<p> takto:

<p class="mw-edittools-section" data-section-title="Wiki-Syntax" style="display: none;">
...
</p>

 Poznámka:

• Neměňte slovo 'mw-edittools-section'
• Text za "data-section-title=" bude tuto skupinu identifikovat v rozbalovací nabídce.
• Ujistěte se, že existuje jedna skupina bez direktivy 'style="display: none;"': To bude výchozí volba v rozbalovací nabídce. Na tomto webu se nazývá 'Standard', zatímco ostatní skupiny jsou pojmenovány podle jazyka, pro který jsou dané znaky významné.

3. Zkopírujte obsah MediaWiki:Gadget-Edittools.js na stránku se stejným názvem na vaší vlastní wiki

4. Přidejte následující kód do svého MediaWiki:Gadgets-definition:

* Edittools[ResourceLoader|default]|Edittools.js

Nabídka CharInsert na anglické Wikipedii

Pro implementaci menu CharInsert, jako je to na anglické Wikipedii, buď exportujte miniaplikace: Charinsert-core, Charinsert-styles a Charinsert a poté je importujte na svou vlastní wiki pomocí Special:Import, nebo pokud to chcete udělat ručně, zkopírujte následující čtyři stránky rozhraní do své wiki:

• MediaWiki:Gadget-charinsert-core.js (Wikipedia) – hlavní JavaScriptový soubor.
• MediaWiki:Gadget-charinsert-styles.css (Wikipedia) – vytvoří obklopující rámečky kolem symbolů/znaků, které jim dodávají vzhled tlačítek.
• MediaWiki:Gadget-charinsert.js (Wikipedia) – zavaděč CharInsert.
• MediaWiki:Gadget-charinsert (Wikipedia) – pro text zobrazený v sekci gadgetů v uživatelských preferencích Special:Preferences#mw-prefsection-gadgets|v sekci gadgetů.

• Do souboru MediaWiki:Gadgets-definition přidejte následující definice:

  * charinsert[ResourceLoader|default|peers=charinsert-styles]|charinsert.js
  * charinsert-core[ResourceLoader|hidden|dependencies=jquery.textSelection,user,mediawiki.storage]|charinsert-core.js
  * charinsert-styles[ResourceLoader|hidden|type=styles]|charinsert-styles.css
  

• MediaWiki:Edittools (Wikipedia) – Pouze pro uživatele s vypnutým nebo nepodporovaným JavaScriptem (což také deaktivuje rozšíření WikiEditor), proto není ani skutečně nutné, ani užitečné. Zobrazuje symboly/znaky pouze jako jednoduchý text pod oknem editoru, který lze poté zkopírovat a vložit, a tím pomoci editorům. Zdá se, že se v anglické Wikipedii neaktivuje, pokud je JavaScript vypnutý.

 Poznámka: Tato konkrétní anglická znaková sada Wikipedie obsahuje také šablony, které bude nutné definovat samostatně, pokud je chcete použít na vaší wiki.

Řešení anglické Wikipedie zkontrolováno: 6. listopadu 2018