Extension:Replace Text/cs

Replace Text (nahradit text) je rozšíření MediaWiki, které poskytuje speciální stránku, stejně jako skript příkazového řádku, umožňující administrátorům provádět globální hledání a nahrazování řetězce na straně serveru v textu i názvech obsahových stránek wiki.

Operace nahrazení textu je odložená operace a je zařazena do fronty úloh. Můžete spustit  ze složky   a okamžitě provést změnu a zpracovat frontu úloh.

Použití
Replace text definuje speciální stránku na "Special:ReplaceText" (nebo její ekvivalent v jiném jazyce), která zpracovává globální vyhledávání a nahrazování. Také definuje skript replaceAll.php, který dělá totéž z příkazového řádku. Tato dokumentace nejprve pokryje speciální stránku a poté skript příkazového řádku.

Na stránce Special:ReplaceText se nejdříve zobrazí formulář pro administrátora, aby vyplnil podrobnosti o hledání a nahrazení: Administrátor zadá hledaný řetězec a jeho nahrazení, sadu jmenných prostorů, ve kterých se má hledat, a také volbu, zda má být textem na stránce nahrazen obsah, názvy stránek nebo obojí. Volitelně může správce také přidat dva další filtry: Název kategorie, do které musí patřit všechny stránky, a předponu, kterou musí všechny názvy stránek začínat. Když je tento formulář odeslán, zobrazí se seznam buď všech stránek, které obsahují daný hledaný řetězec, nebo všech stránek, jejichž názvy obsahují hledaný řetězec, nebo obojí. Vedle názvu každé stránky je zaškrtávací políčko pro každou stránku, takže lze zrušit výběr stránek, které uživatel nahradit nechce. Uživatel pak může kliknout na "Replace" a provést skutečnou změnu. Jakmile je nahrazení textu provedeno, nelze jej přímo vrátit zpět. I když vždy můžete spustit "reverzní" nahrazení, nahrazující nový řetězec původním řetězcem. Z tohoto důvodu, pokud je náhradní řetězec prázdný nebo se jedná o řetězec, který již na wiki existuje, se zobrazí uživateli varovná zpráva.

Pokud je hledaný řetězec na stránce obsažen vícekrát, bude nahrazen každý takový výskyt. Nahrazení každé stránky se zobrazí jako (malá) úprava wiki, přičemž správce, který provedl nahrazení textu, je uživatel, který provedl úpravu, a shrnutí úprav, které se zobrazí jako "Text replace: ' search string ' to ' replacement string '" (nahrazení textu: 'hledaný řetězec' na 'náhradní řetězec').

Název stránky nelze přesunout do názvu, který již na wiki existuje, nebo do titulku, který má více řádků. Stránky, které nelze přesunout, budou jednoduše uvedeny na stránce "select" (vybrat) jako nepřemístitelné, bez zaškrtávacího políčka vedle nich.

Vyhledávání rozlišuje malá a velká písmena. Viz níže, jak nastavit, aby se nerozlišovala malá a velká písmena.



Důležité poznámky

 * 1) ReplaceText ve výchozím nastavení zpracovává pouze 250 stránek najednou. Chcete-li to změnit, můžete v LocalSettings.php nastavit   na vyšší hodnotu. Můžete však být omezeni   PHP. Pokud rozšíření hlásí takové varování, možná ho budete muset změnit.
 * 2) Všechny náhrady jsou umístěny do fronty úloh. Pokud tedy musíte zpracovat velké množství stránek, budete muset spustit Replace Text a poté spustit " " (potenciálně vícekrát).



Použití regulárních výrazů
Pokud používáte databázi MySQL nebo PostgreSQL, uvidíte ve formuláři Special:ReplaceText zaškrtávací políčko "Use regular expressions" (použít regulární výrazy). Toto zaškrtávací políčko se nezobrazuje u databází SQLite, protože SQLite postrádá nativní operátor "REGEXP".

Pokud kliknete na toto zaškrtávací políčko, můžete v rámci vyhledávacích a nahrazovacích řetězců použít regular expressions neboli regulární výrazy. Sada povolených regulárních výrazů je v podstatě malá podmnožina sady regulárních výrazů PHP a MySQL/PostgreSQL. Speciální znaky, které lze použít ve vyhledávacím řetězci, jsou " . * + ? [ ] |" a v rámci náhradního řetězce lze použít hodnoty jako $1, $2 atd. (Chcete-li je použít jako běžné znaky, stačí je nejprve opustit přidáním "\" – což byste také museli udělat se znakem "/".) Tato část nebude poskytovat návod na používání regulárních výrazů (článek na Wikipedii je dobrým místem, kde začít, stejně jako tato stránka na MySQL regexps), ale zde je základní příklad uvedený v inline vysvětlení:


 * Vyhledávací řetězec -
 * Náhradní řetězec -

To bude hledat stránky obsahující písmeno 'a', písmeno 'c' a jakýkoli text mezi nimi (označený ".*"). It would then put that middle text after the 'a' and 'c' - the "$1" in the replacement string refers to the first element of the search string contained within parentheses (in this case, there's only one).

Pro každou stránku, pro kterou je nahrazení skutečně voláno, by nahrazení nastalo pro každý výskyt hledaného řetězce, nejen pro jeden – stejně jako se to děje u běžného vyhledávání s neregulárními výrazy.



Složitější regulární výrazy

 * Vyhledávací řetězec -
 * Náhradní řetězec -

To by nahradilo "hello222.555" slovy "222,555" a "hello2.55" with "2,55"

Nejprve se shoduje slovo "hello". V závorkách následuje výraz pro hledání libovolných číslic "0-9". Následující hvězdička najde více shod předchozího prvku. Závorky a hvězdička jsou uzavřeny v závorkách, shodujeme se s úplným výrazem a převedeme jej na $1. "\." znamená, že se jedná o skutečnou tečku, nikoli o speciální znak. Druhý výraz v závorkách je porovnán a vložen do $2.



Náhrady následované čísly
Následující nebude fungovat:


 * Vyhledávací řetězec -
 * Náhradní řetězec -

That's because the search will think the number of the replacement is 1123456, not 1. Místo toho byste měli mít následující:


 * Náhradní řetězec -

Obecně platí, že očíslované hodnoty můžete vždy uzavřít do složených závorek.



Vyhledávání bez rozlišení malých a velkých písmen
Chcete-li, aby se ve vyhledávání nerozlišovala malá a velká písmena, použijte regulární výraz a modifikátor bez ohledu na velikost písmen :
 * Vyhledávací řetězec -
 * Náhradní řetězec -

Výše uvedené sjednotí obal všech zmínek o iPhone/iphone/IPHONE na iPhone.



Skript příkazového řádku: replaceAll.php
Nahradit text nabízí skript replaceAll.php v adresáři, který lze spustit z příkazového řádku a který provádí všechny stejné náhrady jako stránka Special:ReplaceText. První dva argumenty pro tento skript by měly být hledaný text a nahrazující text. Tento můžete skript nazvat jednoduše takto:

php replaceAll.php "Leningrad" "St. Petersburg"

If you use numbered values like $1 in the replacement string, you have to either escape them inside double quotes like  or use single quotes. Jinak shell na jejich místo umístí mezery, protože si myslí, že jde o proměnné.

Další možné argumenty/příznaky pro tento skript jsou:

Kromě toho existují dva příznaky, které striktně vypisují užitečné informace, které nesouvisejí s konkrétní náhradou textu:

(Všechny tyto možnosti můžete zobrazit také voláním "php replaceAll.php --help".)



Přiřazení náhrad uživateli
Ve výchozím nastavení jsou všechna nahrazení připsána v historii stránek uživateli, který je inicioval. Místo toho však můžete nechat náhrady připsat předem nastavenému uživateli – například účtu robota – přidáním řádku jako je tento do LocalSettings.php pod zahrnutím Replace Text:

Zadané uživatelské jméno již musí mít účet na wiki. Bude přidáno do pole MediaWiki s uživatelskými jmény, ve kterých nemusí být zaregistrováno nebo přihlášeno.

Autoři
Replace Text byl většinou napsán Yaronem Korenem, dosažitelný na yaron57@undefinedgmail.com. Důležitými příspěvateli byli také Niklas Laxström, Ankit Garg (který přispěl velkou částí kódu regulárního výrazu), Mark Hershberger (který napsal skript příkazového řádku), Brent Laabs, Cindy Cicalese, Nikhil Kumar, Umherirrender, James Forrester, Fomafix, Marijn Khandel van Wezel a další



Historie verzí
Replace Text je aktuálně ve verzi 1.7. See the entire.

Snímky obrazovky
Níže jsou obrázky pracovního postupu Replace Text. Nejprve je na Discourse DB zadána počáteční stránka, na které jsou zadány "George F. Will" a "George Will" pro cílový řetězec a nahrazující řetězec, a také nahrazující text v názvech stránek:



Poznámka: zaškrtávací políčka "Vše" a "Žádné" se zobrazí pouze při použití vzhledu Vector nebo vzhledů na něm založených.

A takto vypadá stránka poté, co uživatel klikne na "Pokračovat":



Stisknutím tlačítka "Nahradit" nahradíte tuto hodnotu na všech uvedených stránkách a stránku na konci přesunete na novou hodnotu.



Známé problémy

 * Samotné výměnné akce jsou strukturovány jako "úkoly" MediaWiki, aby se zajistilo, že systém nebude přetížen, pokud jich chce uživatel dělat více najednou. To znamená, že velká sada výměn nebude provedena okamžitě a jejich dokončení může trvat minuty, hodiny nebo i déle. Normally, jobs get activated every time a page is viewed on the wiki; to speed up the process (or slow it down), you can change the number of jobs run when a page is viewed; the default is 1. Požadavek Replace Text se tedy může zastavit brzy po svém spuštění, pokud na wiki není dostatek front-endové aktivity, aby překonala ostatní zdroje nových dávkových úloh. Informace o tom, jak změnit výchozí nastavení, naleznete na stránce . Chcete-li přinutit wiki, aby okamžitě spouštěla všechny úlohy, přejděte do shellu a spusťte skript . Obecně neexistuje způsob, jak to udělat z frontendu wiki.
 * Chcete-li, aby se úlohy spouštěly na zřídka používané wiki, například pracovní wiki pro malý hobby projektový tým, můžete například vynutit obnovení speciální stránky "Všechny stránky". To lze provést například pomocí následujícího shell skriptu na Unixu:
 * Pokud máte stále problém se spuštěním úloh Replace Text, můžete problém vyřešit přidáním následujícího do LocalSettings.php:
 * Pokud máte stále problém se spuštěním úloh Replace Text, můžete problém vyřešit přidáním následujícího do LocalSettings.php:


 * Aby se při přesunech stránek nevytvářela přesměrování (tj. pokud není zaškrtnuté políčko "Uložit staré názvy jako přesměrování na nové názvy"), budete muset příslušnému uživateli udělit oprávnění 'potlačit přesměrování'. Assuming you've given the 'replacetext' permission to a "trusted-editor" user group, you would need to add the following to LocalSettings.php:


 * Pokud jsou vaše revize komprimované (tj. pokud je v povoleno  nebo byl skript  proveden s volbou  ), pak ReplaceText nebude fungovat, protože využívá dotazy SQL, které nemohou hledat komprimovaný text. (see the  extension as an alternative in this case.)
 * Pokud máte velký počet náhrad, některé z nich nemusí být hotové, nebo se může zobrazit chybová zpráva "Musíte vybrat alespoň jeden jmenný prostor". V obou případech je to kvůli omezení počtu formulářových vstupů, které PHP akceptuje. To lze opravit několika způsoby:
 * Pokud máte na svém serveru nainstalované rozšíření PHP Suhosin, může to být zdrojem problému. Můžete zvýšit hodnotu proměnných  a  . Nebo jednoduše zkuste dočasně deaktivovat Suhosin, zatímco budete provádět výměny.
 * Nastavení PHP  (dostupné od PHP 5.3.9) také ovlivňuje počet nahrazení, které můžete kdykoli provést - můžete zkusit nastavit velmi velké číslo, například 3000.

Překlad
Překlad Replace Text se provádí prostřednictvím translatewiki.net. Překlad tohoto rozšíření lze nalézt zde. Chcete-li přidat jazykové hodnoty nebo změnit stávající, měli byste si vytvořit účet na translatewiki.net a poté požádat administrátory o povolení k překladu určitého jazyka nebo jazyků na této stránce (toto je velmi jednoduchý proces). Jakmile budete mít oprávnění pro daný jazyk, můžete se přihlásit a přidávat nebo upravovat jakékoli zprávy, které chcete v tomto jazyce.



Související odkazy

 * - Podobné rozšíření využívající regulární výrazy k úpravě více stránek najednou