Muokataan sivua Käyttäjä:Erkkimon/ohjeita

Tämä sivu on tehty ensisijaisesti hyödyksi itselleni, mutta onhan tietysti ihan kivaa, jos näistä ohjeista on hyötyä muillekin. Tuota sekundäärifunktiota edistääkseni olen yrittänyt kirjoittaa jokseenkin selkeää tekstiä. Ohjeita en ihan kauheasti testaa, sillä kirjoitan useimmiten toimivan ratkaisun itselleni muistiin, ja mahdollinen testaus tapahtuu silloin, kun seuraavan kerran satun ehkä tarvitsemaan ohjetta. Niinpä kannattaa raportoida virheestä.

== Lyhyt urli muotoa domain.com/artikkelin_nimi ==

Olen todennut, että on fiksuinta toteuttaa lyhyet urlit niin, että Apache käsittelee olemattomiin tiedostoihin viittaavat urlit wiki-artsujen otsikoina. Etuna on se, että esimerkiksi wikin domainin alla olevien tiedostojen imppaaminen ja impattavaksi asettaminen ei mene monimutkaisesti. Lisäksi tämä metodi ei ole muiden metodien tapaan aiheuttanut ärsyttäviä bugeja ja haamuartikkeleita wikiin jne.

Homma alkaa poistamalla risuhäkkyrät $wgArticlePath -muuttujan edestä LocalSettings.php:ssa ja muuttamalla niiden arvot allaolevaa vastaaviksi. Jos muuttujaa ei ole, lisää ne – mieluiten heti $wgScriptPath -muuttujan jälkeen.
 $wgArticlePath      = "/$1";
Lisää LocalSettings.php -tiedostoon seuraava rivi, jotta uloskirjautuminen yms. toimisi kivasti.
 $wgUsePathInfo     = false;

Luo www-hakemistosi juureen tiedosto nimeltään .htaccess, ja tiedoston oikea sijainti on todennäköisesti /var/www/.htaccess. Jos wikisi on www-hakemistosi hakemistossa mediawiki, korvaat luonnollisesti hakemiston wiki hakemistolla mediawiki.

 Options -Indexes
  
 RewriteEngine On 
 RewriteRule ^/*$ /wiki/index.php [L,QSA]
 RewriteCond %{REQUEST_FILENAME} !-f
 RewriteCond %{REQUEST_FILENAME} !-d
 RewriteRule ^(.*)$ /wiki/index.php?title=$1 [L,QSA]

== GlobalFunctions.php -ongelman ratkaisu ==

Usein wiki mussuttaa softapäivityksen jälkeen jotain seuraavantapaista: "Warning: mkdir() [function.mkdir]: Permission denied in /path/to/wiki/ includes/GlobalFunctions.php on line 2012" ja/tai "PHP Warning: imagejpeg() [<a href='function.imagejpeg'>function.imagejpeg</a>]: Unable to open '/path/to/wiki/images/thumb/jotain/jotain/kuva.jpg' for writing: Permission denied in /path/to/wiki/includes/media/jtoain on line 236"

Tällöin wiki ei onnistu luomaan uusia hakemistoja. Ongelma ratkeaa useimmiten chmodaamalla wikin images-hakemiston kuville 755-oikeudet rekursiivisesti ja chownaamalla kyseisen hakemiston rekursiivisesti apache-käyttäjälle eli käyttäjälle, joka ajaa httpd:tä. Kyseinen käyttäjä on useimmiten Ubuntuissa www-data, ja useissa muissa distroissa apache. Homma siis tapahtuu seuraavasti, roottina tietysti:
 chmod -R 755 /path/to/wiki && chown -R www-data /path/to/wiki

Jos tämä ei auta, kannattaa kokeilla seuraavaa wikin images-hakemistossa:
 find . -type d -exec chmod 777 {} \;
 find . -type f -exec chmod 666 {} \;

Jos mikään muu ei auta, kannattaa kokeilla asettaa seuraavaa LocalSettings.php-tiedostoon:
 $wgHashedUploadDirectory = false;

== Add a banner to the sidebar (PHP) ==

You can add one or more banners to the sidebar by hacking your ''skins/Monobook.php'' file (if you're using monobook) to include the following piece of code.

Find (line 188):
 ?>
		</div><!-- end of the left (by default at least) column -->

Include:
 ?>
	<!-- begin of banner1 -->
	<div class='generated-sidebar portlet'>
	<h5><?php $this->msg('sidebar-banner1-headingtext') ?></h5>
	<div style="border: 1px solid #B0B0B0; background-color: #FFFFFF;">
	<a href="<?php $this->msg('sidebar-banner1-url') ?>">
	<img width="100%" title="<?php $this->msg('sidebar-banner1-alttext') ?>" 
		alt="<?php $this->msg('sidebar-banner1-alttext') ?>" 
		src="<?php $this->msg('sidebar-banner1-imgsrc') ?>" /></a>
	</div></div>
	<!-- end of banner1 -->
		</div><!-- end of the left (by default at least) column -->

Now in your Wiki, create four System messages: (i.e. articles named MediaWiki:sidebar-banner1-...)

{| class="prettytable"
! parameter
! value
|-
| <tt>sidebar-banner1-headingtext</tt>
| The text that will be displayed as the banner heading ("advertisement", "sponsor" etc.)
|-
| <tt>sidebar-banner1-url</tt>
| The destination URL of this banner
|-
| <tt>sidebar-banner1-alttext</tt>
| Title for the site. Content of the '''alt=""''' parameter of an HTML <img> tag.
|-
| <tt>sidebar-banner1-imgsrc</tt>
| URL of the banner image. It may be the address of an image uploaded to your Wiki ([[magic words]] may be used, e.g. <tt><nowiki>{{filepath:banner1.png}}</nowiki></tt>), or the address of an external image. Content of the '''src=""''' parameter of an HTML <img> tag. 
|}

To add more banners, just repeat the process renaming "banner1" to "banner2" etc.