Mediawiki
De Infowiki
Mediawiki
Mediawiki és un CMS que ens dona la possibilitat de crear articles al moment, i editar-los. És un bon sistema per recollir tutorials guies o coses a explicar, que molta gent pugui aportar. Qualsevol pot editar o modificar articles.
Un clar exemple de mediawiki, és la Viquipedia
Contingut |
Instal·lació
Mediawiki la podeu descarregar de la seva pagina web. Mediawiki Descarrega
Pujar al allotjament web
Un cop descarregada, descomprimim el .tar.gz, i els arxius de dins els pujem amb algun programa via FTP, al directori que volem instal·lar la mediawiki. Això pot trigar una estona depèn la connexió que es tingui.
Omplir dades
Un cop pujada tota la mediawiki, Amb el navegador ens dirigim a la direcció en concret on es troba la wiki. Normalment si diposeu de un domini i l' heu instal·lat a l' arrel, entrant a www.dominicomprat.net anirem a parar a la inicialització de la instal·lació.
Si la wiki es troba en alguna altre carpeta dins de l' arrel, per exemple la carpeta wiki, estarà a www.dominicomprat.net/wiki.
Ens Sortirà una web que ens demana que comencem la instal·lació
MediaWiki 1.10.0 Please set up the wiki first.
clickem a setup i omplim els camps
Un script ens comprovarà que tot sigui correcte.
Environment checked. You can install MediaWiki.
Omplirem els camps seguents:
Nom de la wiki:
Wiki name: Must not be blank or "MediaWiki"
Email de l' administrador de la wiki:
Contact e-mail:
Llengua en que funcionarà la wiki:
Language:
Escollim llicencia que empararà tots els escrits dins la wiki. Si no sabem quina posar posem no license metadata.
Copyright/license:
* No license metadata * GNU Free Documentation License 1.2 (Wikipedia-compatible) * A Creative Commons license - choose
Nom de l' administrador, i el seu password:
Admin username:
Password: Must not be blank Password confirm:
Activar memoria cache: Si volem activar el sistema de cache de pagines, per accelerar el lloc web quan el nombre de usuaris es molt elevat( mils). Shared memory caching:
* No caching * Memcached
Memcached servers:
Opcions d' email
Aquesta opció fa que ens envii un email per notificar el nostre password, o enviar emails de usuari a usuari, notificacions de canvi en els articles creats.
E-mail features (global):
* Enabled * Disabled
There are additional options for fine tuning in /includes/DefaultSettings.php; copy these to your LocalSettings.php and edit them there to change them.
E-mail address authentication:
* Disabled * Enabled
Nom del servidor:
Database host:
Nom de la base de dades:
Database name:
nom d' usuari de la base de dades
DB username:
Password de la base de dades:
DB password: Must not be blank
Confirmar password
DB password confirm:
Superuser account: Administrador de la base de dades.Normalment és Root.
Superuser password: Contrassenya
El prefix de la database, va be quan tenim més de algun sistema funcionant amb la mateixa base de dades, o dos o més mediawikis treballant amb la mateixa taula. Així es distingeixen.
Database table prefix:
Un cop omplertes totes les dades, clickem instal·lar wiki. Ens dirà que la instalació ha anat be, i que haurem de moure l' arxiu config/Localsettings.php a el directori principal de la wiki.
I la wiki ja la tindrem inicialitzada.
Aspecte
Per canviar l' aspecte de mediawiki es poden pujar uns skins ja creats, o a partir de l' actual modificar-lo i crear un propi.
en aquesta web skins mediawiki trobareu uns quans exemples creats.
En descarreguem algun el descomprimim i el pujem a la carpeta /skins.
Ens connectem com a usuari administrador de la mediawiki. Exemple webmestre.
I a les preferències de l'administrador a Aspecte podrem canviar l' Aspecte. Si' s' ha instal·lat be ens hauria de sortir a la llista.
Configuració
La configuració per defecte de MediaWiki està a l' arxiu DefaultSettings.php. Aquest arxiu no s' ha de editar ja que si o fem, es maxacara cada cop que actualitzem la mediawiki, i perdriem la nostra personalització.
El que em de fer copiar les linies que volem modificar de DefaultSettings, a l' arxiu LocalSettings.php
Així mediawiki, procesa primer DefaultSettings, i després LocalSettings. Si troba dos parametres iguals, preval el de LocalSettings.php.
Permisos d' escriptura
escrivint al arxiu localsettings.php la linia següent
$wgGroupPermissions['*']['edit'] = false;
bloquejara els usuaris no registrats l' edició d' articles.
Permetre Pujada d' arxius
Em de copiar aquesta linia a Localsettings.php
$wgEnableUploads = true;
Si volem que la wiki es puguin pujar arxius i imatges.
No és possible pujar arxius de forma anonima, per això haurem de estar registrats, i per defecte sols podrem pujar arxius amb extenció 'png', 'gif', 'jpg' y 'jpeg'.
Permetre altres extencions
Per permetre més extencions a pujar haurem de editar el parametre.
$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg', 'svg', 'mp3', 'ogg', 'avi', ‘swf’, 'pdf', 'zip', 'doc', 'xls' );
Canviar el logo
Per canviar el logo de la wiki, i posar un personalitzat, només haurem de pujar la imatge al directori /wiki/skins/common/images/
un cop pujada al arxiu localsettings.php afegim 3 noves linies.
$wgStylePath = "$wgScriptPath/skins"; $wgStyleDirectory = "$IP/skins";
I en aquesta on hi hagi logo i posarem la imatge pujada.
$wgLogo = "$wgStylePath/common/images/logo.png";
Interwiki: comunicació entre diferents idiomes
Interwiki permet poder tenir tot un projecte de wikis en diferent idiomes, però amb el mateix contingut, amb una bona comunicació. Un exemple d' ell és la Viquipèdia on tots els articles, tenen la barra lateral en altres idiomes. Així poder saltar a altres traduccions de l' article
Per poder tenir aquesta barra lateral, sols haurem d' editar la taula interwiki de la base de dades de les wikis instal·lades. En ella haurem de omplir en cada camp els prefixos que farem servir, i l' enllaç que ens portarà a la traducció.
Exemple, tenim creat un article que és diu Ubuntu en versió en català, però a la wiki en anglès també existeix. Per vincular-les haurem d'editar l' cada article i posar aquesta linia
[[ca:Ubuntu]]
on ca és el prefix de la llengua que voleu vincular. En aquest cas la linia la posarem a l' article anglès, i apuntarà a l' article de la wiki en català.
Un cop tenim els dos articles amb els seus enllaços a l' article. veurem que la barra lateral no surt. Per que surti haurem d' editar la taula interwiki de les dos wikis. En ella haurem de posar els seguents parametres per que ens funcioni els prefix posats als articles.
* iw_prefix, el prefix que emprarem * iw_url, l'URL del recurs * iw_local, si és 1, fa que es redireccioni a un recurs extern de forma transparent talment com si fos propi. * iw_trans, si és 1, podrà utilitzar-se el contingut al qual es fa referència com a plantilla.
Exemple
* iw_prefix, ca * iw_url, http://www.dominidelhosting.cat/wikiencatala/index.php/$1 * iw_local, 1 * iw_trans, 1
El $1 a la url es posa per que és co una variable, on es passara el paramatre a buscar. En aquest cas Ubuntu
Migració
Per migrar mysql haurem de transportar la base de dades i els arxius del directori. Un cop fet, per que ens funcioni amb la nova base de dades, haurem d' editar l'arxiu LocalSettings.php i canviem les variables
$wgDBserver = "localhost"; $wgDBname = "taula_base_de_dades"; $wgDBuser = "usuari_base_de_dades"; $wgDBpassword = "contrasenya";
directori on es troba el projecte
$wgScriptPath = "/informatics.cat/wiki";
Errors
Migració de base de dades
mediawiki depèn com s' instal·li, pot donar problemes alhora de migrar a un altre servidor. En el meu cas em vaig trobar que al canviar de servidor algunes pagines canviaven de nom per culpa de la codificació i els caracters amb accent.
Em vaig trobar amb la Pàgina principal sense res, ja que l' antiga detectava la lletra A amb accent com un altre caracter. Tot això pot vindre donat a que la codificació de cada servidor pot variar.
Solució: després de molt remenar i provar coses. Al final vaig aconseguir fer una migració casi perfecte.
Ens dirigim a exportació, marquem totes les taules de la wiki. I desmarquem l' opció de canviar text a hexagesimal. Això ens donara la opció de poder veure les entrades en text normal.
Marquem enviar, però que només es visualitzi amb el navegador. Copiem tot el codi sql, i l' enganxem a un nou arxiu que creem al nostre ordinador. Després ho guardem amb la codificació correcte, en el meu cas utf8.
I així a mi em va solucionar tots els caràcters dels titols de les pagines amb accent.
No deixa pujar arxius
Cal donar permisos d'escriptura a la carpeta /images, en aquesta carpeta és on es pujaran els arxius.
