MediaWiki - tipy

(Pramen: MediaWiki Tips)

Dokumentace

• Všeobecná nápověda: https://meta.wikimedia.org/wiki/Help:Contents
• Syntaxe pokročilého editování: https://meta.wikimedia.org/wiki/Help:Advanced_editing

Nastavení

Nastavení MediaWiki je nyní dostatečně rozvinuté a mnoho nastavení se provede automaticky. Na konci procesu se vytvoří LocalSettings.php, který si stáhneme a pak jej umístíme do kořenového adresáře své webové stránky. Potom v prohlížeči jen aktualizujeme zobrazení stránky a nastavení se ihned projeví.

Změna jména webové stránky

V LocalSettings.php, editujeme tuto hodnotu:

$wgSitename = "Acme Inc. Wiki";

Nastavení loga

Logo umístíme do /resources/assets, a pak v LocalSettings.php upravíme tuto hodnotu:

$wgLogo = "$wgResourceBasePath/resources/assets/mylogo.png";

Nastavení URL webové stránky

V LocalSettings.php, upravíme tuto hodntu:

$wgServer = "http://wiki.mydomain.com";

Nastavení email z: adresy

V LocalSettings.php upravíme tyto hodnoty:

$wgEmergencyContact = "user@mydomain.com";
$wgPasswordSender = "user@mydomain.com";

Nastavení textu Copyrightu a potlačení ikony

V LocalSettings.php upravíme tyto hodnoty:

$wgRightsText = "copyright Taro Tanaka, all rights reserved";
unset( $wgFooterIcons['copyright'] );

Nastavení limitní velikosti nahrávání

V LocalSettings.php upravíme tyto hodnoty:

$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg', 'doc', 'xls', 'mpp', 'pdf', 'ppt', 'tiff',
                                          'bmp', 'docx', 'xlsx', 'pptx', 'ps', 'mp3', 'odt', 'ods', 'odp', 'ogg', 'odg' );
$wgMaxUploadSize = array(
	'*' => 1024 * 1024 * 100, // 100 MB
	'url' => 1024 * 1024 * 100, // 100 MB
);

V php.ini nastavíme tyto hodnoty:

upload_max_filesize = 100M
post_max_size = 100M

Ochrana složky “images”

Ve složce images, do které se ukládají nahrané soubory, je soubor .htaccess, do kterého můžeme přidat jisté řádky, které ji ochrání před napadením (podle příručky MediaWiki). Soubor upravíme takto:

# Ochrana proti bugu 28235	
   RewriteEngine On
   RewriteCond %{QUERY_STRING} \.[^\\/:*?\x22<>|%]+(#|\?|$) [nocase]
   RewriteRule . - [forbidden]

# Fix for bug T64289
   Options +FollowSymLinks

# HTML ponechat jako obyčejný text, neprovádět SHTML
 AddType text/plain .html .htm .shtml .php .phtml .php5

# Starý způsob registrace php pomocí AddHandler
   RemoveHandler .php

# Nový způsob registrace php pomocí SetHandler
   SetHandler None

Nastavení editoru

V LocalSettings.php upravíme hodnoty, které řídí rozšíření “WikiEditor”:

$wgAllowUserJs = true;
$wgUseSiteJs = true;
$wgDefaultUserOptions['usebetatoolbar'] = 1;
$wgDefaultUserOptions['usebetatoolbar-cgd'] = 1;
$wgDefaultUserOptions['wikieditor-preview'] = 1;
$wgDefaultUserOptions['wikieditor-publish'] = 1;

Abychom umožnili práci některých funkcí lišty editoru, musíme přidat nějaký javascript. K tomu účelu upravíme speciální stránku ve jmenném prostoru MediaWiki. Vyhledáme tento soubor a přidáme do něj javascript: MediaWiki:Common.js

Například následující javascript přidá do lišty tlačítko pro přeškrtnutí textu:

/* Any JavaScript here will be loaded for all users on every page load. */
var customizeToolbar = function() {
     /* Sem vložíme svůj kód */
$('#wpTextbox1').wikiEditor('addToToolbar', {
   section: 'advanced',
   group: 'format',
   tools: {
      "strikethrough": {
        label: 'Strike',
        type: 'button',
        icon: '//upload.wikimedia.org/wikipedia/commons/3/30/Btn_toolbar_rayer.png',
        action: {
          type: 'encapsulate',
          options: {
            pre: "",
            post: ""
          }
        }
      }
    }
  });
};
/* Check if view is in edit mode and that the required modules are available. Then, customize the toolbar … */
if ($.inArray(mw.config.get('wgAction'), ['edit', 'submit']) !== -1) {
  mw.loader.using('user.options', function() {
    // This can be the string "0" if the user disabled the preference (phab:T54542#555387)
     if (mw.user.options.get('usebetatoolbar') == 1) {
       $.when(
        mw.loader.using('ext.wikiEditor.toolbar'), $.ready
      ).then(customizeToolbar);
    }
  });
}
// Add the customizations to LiquidThreads' edit toolbar, if available
mw.hook('ext.lqt.textareaCreated').add(customizeToolbar);

Praktické "Speciální stránky"

Administrace MediaWiki má po ruce spoustu nástrojů, kterým se říká "Speciální stránky", na které je odkaz v levém menu. Jestliže do každé stránky naší wiki vložíme odkaz na [[Special:SpecialPages]], pak máme k této sbírce přístup odkudkoliv.

Každá má jedinečné URL a zde je vyjmenováno několik nejčastěji používaných, které můžeme vkládat podle potřeby:

• Seznam všech nedávných změn ve wiki: [[Special:RecentChanges]]
• Seznam všech mediálních souborů ve wiki: [[Special:ListFiles]]
• Přidat uživatele: [[Special:CreateAccount]]
• Nastavit přístupová práva uživatele: [[Special:UserRights]]

Kategorie

Abychom mohli pracovat s kategoriemi, musíme do složky /extensions přidat rozšíření "CategoryTree". Pak můžeme každou stránku přiřadit k nějaké kategorii pomocí (například) [[Category:Procedury]]

Seznam stránek v kategorii pak můžeme zobrazit pomocí výrazu: <categorytree mode=all>Procedures</categorytree>

Seznamy stránek

Seznam stránek ve wiki můžeme zobrazit pomocí dvojitých svorek a určením jmenného prostoru.

{{Special:AllPages}}
{{Special:AllPages|namespace=12}}

Číslo jmenného prostoru zjistíme tak, že navštívíme Special:AllPages, rozbalíme seznam jmenných prostorů a poznamenáme si číslo jmenného prostoru z URL.

Úprava titulů a návěští

MediaWiki nám umožňuje upravit různé aspekty svého rozhraní pomocí úpravy stránek ve jmenném prostoru MediaWiki, Každou z těchto stránek můžeme vyhledat, upravit ji a uložit.

• Advanced Search title: MediaWiki:Search
• Browser Page title, for bookmarks: MediaWiki:Pagetitle
• Edit tab text: MediaWiki:Edit
• Sidebar structure: MediaWiki:Sidebar
• Upload text: MediaWiki:Uploadtext
• Copyright text: MediaWiki:Copyright
• Copyright warning when saving edits: MediaWiki:Copyrightwarning and MediaWiki:Copyrightwarning2
• Edit summary when reverting: MediaWiki:Revertpage
• Place to enter syntax help under edit form: MediaWiki:Edittools
• Default text in new articles: MediaWiki:Newarticletext
• Text under tabs on all pages: MediaWiki:Sitenotice
• Text under page title: MediaWiki:Tagline or, for specific languages, MediaWiki:Tagline/en
• Home page name: MediaWiki:Mainpage

Proměnné

MediaWiki has a bunch of variables that are used in various places. Read more: https://meta.wikimedia.org/wiki/Help:Variable

Každodenní práce

Následující akce mohou vyžadovat přihlášení, zvláště je-li naše MediaWiki nastavena jako soukromá. Také bývá nutné stisknut Uložit.

Nastavit osobní preference

V nastavení nastavíme skutečné jméno.

Ve vzhledu nastavíme požadovaný formát data, a časovou zónu na Evropa/Praha.

V editaci zvolíme "umožnit editaci části..." a "Editovat stránky dvojklikem". Také nastavíme "Zapnout vylepšený..." a "Používat průvodce...".

Vytvořit stránku

Stránku vytvoříme tak, že ji vyhledáme a stiskneme "Vytvořit stránku...". Tím vytvoříme stránku ve jmenném prostoru "Hlavní", což ve většině případů vyhovuje.

Stránku můžeme vytvořit také tak, že na ni vložíme odkaz, uložíme a stiskneme červený odkaz.

Vytvořit stránku ve jmenném prostoru

MediaWiki má zabudováno několik jmenných prostorů (představme si je jako složky/adresáře). K vytvoření stránky v nějakém jmenném prostoru ji vyhledáme, přičemž jejímu jménu předsadíme jmenný soubor, jako např. Help:FAQ.

Seznam jmenných prostorů zobrazíme pomocí Special:AllPages.

Upravit stránku

Podle nastavení můžeme zahájit úpravu stránky dvojitým kliknutím, nebo kliknutím na "editovat". Podrobnosti o syntaxi úprav najdeme na "Edvanced Editing".

Při každé úpravě přidáme krátké shrnutí do textového pole na dně stránky, abychom se na ně mohli odvolat při prohlížení historie úprav.

Kategorizovat stránku

Jestliže máme instalováno rozšíření "CategoryTree", můžeme každou stránku přidat k nějaké kategorii, když přidáme kód v této podobě:

[[Category:Procedures]]

Diskutovat o stránce

MediaWiki má podle konvence ke každé stránce "diskusní" stránku, kde můžeme o jejím obsahu diskutovat, aniž bychom rozrušili její text.

Také každá osoba má svou diskusní stránku.

Odstranit, přemístit, nebo ochránit stránku

Stránku můžeme smazat, přesunout, nebo zamknout. V menu jsou příslušné položky.

Přidat obrázek nebo soubor

V levém seznamu nástrojů použijeme Načíst soubor. Pomocí [[Special:ListFiles]] si můžeme prohlédnout seznam všech souborů v naší wiki.

Jméno nahraného souboru použijeme k jeho zahrnutí do stránky: [[File:MyChart-2015]].

Pokud nechceme soubor začlenit do stránky, můžeme odkázat na jeho popisnou stránku, když do výrazu po otvírací závorce vepíšeme dvojtečku: [[:File:MyChart-2015]]

Odkaz nebo reference

Osvojme si rozdíl mezi různými způsoby vstupu do odkazů pomocí kulatých závorek nebo svorkových závorek. Na testovací stránce si vyzkoušejme:

[[Special:ListFiles]]

… versus …

{{Special:ListFiles}}

Databáze znalostí - Mediawiki

Nachází se na webu HostKnox>Knowledgebase>Mediawiki.

Některé užitečné znalosti:

• Jak znemožnit či umožnit vytvoření uživatele

Kapitola