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

Per settings, you can just double click the page, or, click one of the Edit links. See Advanced Editing for detail on editing syntax.

Every edit, add a quick summary in the textbox at the bottom, because you can refer to them in the View History.

Kategorizovat stránku

Assuming you’ve installed the “CategoryTree” extension, add any page to a category by adding code like this somewhere on the page:

Diskutovat o stránce

MediaWiki has a convention of having a “talk” page for every wiki page, to allow its content to be discussed without messing up the main text.

See the “Discussion” tab at the top of every page? That’s the talk page. There is also a talk page for each person.

When you leave a comment on a talk page, the convention is to enter your comment with a signature. Use the signature button in the editor for that.

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

You can also delete, move or protect a page. Use the “more” menu near the search box.

Přidat obrázek nebo soubor

Click Upload File from the left link list. You can view [[Special:ListFiles]] to see all the files in the wiki.

Note the file’s filename (just upload it and copy from the screen that appears right after the upload), and use that to embed it in a page: [[File:MyChart-2015]]

If you don’t want to embed the file in the page, you can link to its description page by including a colon at the beginning, after the opening bracket: [[:File:MyChart-2015]]

Odkaz nebo reference

Learn the difference between entering links using curly and square brackets. For instance, on a test page try:

[[Special:ListFiles]]

… versus …

{{Special:ListFiles}}