Zobrazení zdroje stránky MediaWiki - tipy

[[Kategorie:Znalosti]]
('''Pramen''': [http://rick.cogley.info/post/mediawiki-tips/ 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ří <tt>LocalSettings.php</tt>, 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 <tt>LocalSettings.php</tt>, editujeme tuto hodnotu:
 $wgSitename = "Acme Inc. Wiki";
=== Nastavení loga ===

Logo umístíme do <tt>/resources/assets</tt>, a pak v <tt>LocalSettings.php</tt> upravíme tuto hodnotu:
 $wgLogo = "$wgResourceBasePath/resources/assets/mylogo.png";

=== Nastavení URL webové stránky ===
V <tt>LocalSettings.php</tt>, upravíme tuto hodntu:
 $wgServer = "http://wiki.mydomain.com";

=== Nastavení email z: adresy ===
V <tt>LocalSettings.php</tt> upravíme tyto hodnoty:
 $wgEmergencyContact = "user@mydomain.com";
 $wgPasswordSender = "user@mydomain.com";

=== Nastavení textu Copyrightu a potlačení ikony ===
V <tt>LocalSettings.php</tt> upravíme tyto hodnoty:
 $wgRightsText = "copyright Taro Tanaka, all rights reserved";
 unset( $wgFooterIcons['copyright'] );

=== Nastavení limitní velikosti nahrávání ===
V <tt>LocalSettings.php</tt> 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 <tt>php.ini</tt> nastavíme tyto hodnoty:
 upload_max_filesize = 100M
 post_max_size = 100M

=== Ochrana složky “images” ===
Ve složce <tt>images</tt>, do které se ukládají nahrané soubory, je soubor <tt>.htaccess</tt>, 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:
<code>
 ''# 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
</code>
=== Nastavení editoru ===
V <tt>LocalSettings.php</tt> upravíme hodnoty, které řídí rozšíření “WikiEditor”:
<code>
 $wgAllowUserJs = true;
 $wgUseSiteJs = true;
 $wgDefaultUserOptions['usebetatoolbar'] = 1;
 $wgDefaultUserOptions['usebetatoolbar-cgd'] = 1;
 $wgDefaultUserOptions['wikieditor-preview'] = 1;
 $wgDefaultUserOptions['wikieditor-publish'] = 1;
</code>
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: <tt>MediaWiki:Common.js</tt>

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 <tt><nowiki>[[Special:SpecialPages]]</nowiki></tt>, 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: <tt><nowiki>[[Special:RecentChanges]]</nowiki></tt>
* Seznam všech mediálních souborů ve wiki: <tt><nowiki>[[Special:ListFiles]]</nowiki></tt>
* Přidat uživatele: <tt><nowiki>[[Special:CreateAccount]]</nowiki></tt>
* Nastavit přístupová práva uživatele: <tt><nowiki>[[Special:UserRights]]</nowiki></tt>

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

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

=== Seznamy stránek ===
Seznam stránek ve wiki můžeme zobrazit pomocí dvojitých svorek a určením jmenného prostoru.
 <tt><nowiki>{{Special:AllPages}}</nowiki></tt>
 <tt><nowiki>{{Special:AllPages|namespace=12}}</nowiki></tt>
Číslo jmenného prostoru zjistíme tak, že navštívíme <tt>Special:AllPages</tt>, 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: <tt>MediaWiki:Search</tt>
*    Browser Page title, for bookmarks: <tt>MediaWiki:Pagetitle</tt>
*    Edit tab text: <tt>MediaWiki:Edit</tt>
*    Sidebar structure: <tt>MediaWiki:Sidebar</tt>
*    Upload text: <tt>MediaWiki:Uploadtext</tt>
*    Copyright text: <tt>MediaWiki:Copyright</tt>
*    Copyright warning when saving edits: <tt>MediaWiki:Copyrightwarning</tt> and <tt>MediaWiki:Copyrightwarning2</tt>
*    Edit summary when reverting: <tt>MediaWiki:Revertpage</tt>
*    Place to enter syntax help under edit form: <tt>MediaWiki:Edittools</tt>
*    Default text in new articles: <tt>MediaWiki:Newarticletext</tt>
*    Text under tabs on all pages: <tt>MediaWiki:Sitenotice</tt>
*   Text under page title: <tt>MediaWiki:Tagline</tt> or, for specific languages, <tt>MediaWiki:Tagline/en</tt>
*   Home page name: <tt>MediaWiki:Mainpage</tt>

=== 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 {{mw}} 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".
Editing, set enable section edit via right click, and edit on double click. As well as “show edit toolbar”, “enable enhanced editing toolbar” and “enable wizards for inserting links etc”.
=== Vytvořit stránku ===

Make a page by searching for it (e.g. “Foo”), and clicking “Create the page “Foo” on this wiki!” to create. This creates the page in the “Main” namespace, which is fine for most content.

You can also create a page by linking to it, saving, then clicking the red link to jump to the freshly created page.
=== Vytvořit stránku ve jmenném prostoru ===

MediaWiki has several namespaces (think of them as folders) built in. To create a page in a namespace, just search for it with the namespace prepended, like: Help:FAQ

To see the namespaces, visit Special:AllPages and drop down the namespace list.
=== 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: [[Category:Procedures]]
=== 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 <tt><nowiki>[[Special:ListFiles]]</nowiki></tt> 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: <tt><nowiki>[[File:MyChart-2015]]</nowiki></tt>

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: <tt><nowiki>[[:File:MyChart-2015]]</nowiki></tt>
=== Odkaz nebo reference ===

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

<tt><nowiki>[[Special:ListFiles]]</nowiki></tt>

… versus …

<tt><nowiki>{{Special:ListFiles}}</nowiki></tt>