Ajuda:Notes d'instal·lació i gestió del wiki

From SaniWiki.cat
Jump to: navigation, search

Instal·lació

Cal afegir sempre a LocalSettings.php:
$wgLocalisationUpdateDirectory = "$IP/cache";

Imatges

Recordeu que les versions per defecte no estan actualitzades i algunes s'ha de descarregar la darrera la 1.23, sisó, no funcionaran, com per exemple l'UploadWizard.

Per tal d'utilitzar directament les imatges de Wikimedia Commons, cal canviar (també a LocalSettings.php) escrivint-hi:

$wgUseInstantCommons = true;

Idioma del wiki per defecte

Partint de la idea de que el nostre idioma (català) prendrà un paper almenys important, poden donar-se tres circumstàncies 1. Només serà en català. Llavors per defecte serà en català. 2. Per defecte serà en català, però admet usuaris i traduccions en altres idiomes. 3. Per defecte en anglès, però admet usuaris i traduccions en altres idiomes. És la versió "internacional" per excel·lència.

Aquest és un punt crític. Ja que serà una bona idea aprofitar algunes (o moltes) de les plantilles de la Wikipedia de l'idioma del wiki per defecte. Així passar de 2 a 3 comportaria (en un wiki excel·lent canviar les plantilles de la Viquipèdia per les de la Wikipedia anglesa.

El valor per defecte s'estableix a LocalSettings.php:$wgLanguageCode = "qq";. On qq és l'idioma ("ca", "en", etc.).

Per fer traduccions s'han d'instal·lar les corresponents extensions (vegi's més endavant: MediaWikiLanguageExtensionBundle). Quan parlem d'una traducció vol dir que hi ha un article en l'idioma que vulguem (en català l'opció 2 o en anglès en la opció 3) que serà el de referència. Hi han extenses explicacions (traduïdes al català: Translate) de com fer tot això.

Molt important: el nom de les pàgines haurien de ser en l'idioma del wiki. Tot i que es poden renomenar les pàgines si ja estan marcades per traducció el renomenament no sempre acaba de funcionar bé quan ja hi han traduccions fetes.

Configuracions generals

Barra d'ordres lateral

Cal canviar MediaWiki:Sidebar, en la línia helppage|help per, en aquest web Ajuda:Introducció|help, per tal de tenir accés a la pàgina d'ajuda prèvia a aquesta.

Molt important: el nom de les pàgines haurien de ser en l'idioma del wiki, així si volem fer la versió 3, el nom de la pàgina hauria de ser Help:Introduction.

WikEd

Per a instal·lar la més que recomanable barra d'eines d'edició Extension:WikEd a tots els usuaris sols cal afegir a MediaWiki:Common.js:

// install [[Wikipedia:User:Cacycle/wikEd]] in-browser text editor
importScriptURI('//en.wikipedia.org/w/index.php?title=User:Cacycle/wikEd.js'
+ '&action=raw&ctype=text/javascript');

Només té un mínim inconvenient de que tarda un parell de segons en carregar-se, si bé es pot desactivar.

Altres canvis en les pàgines MediaWiki

En utilitzar plantilles de les wikipedies cal copiar el contingut de:

Extensions carregades per defecte

A més de les incorporades amb l'extensió:

  • Cite: permet a l'usuari crear notes al peu
  • ConfirmEdit: li permet utilitzar diverses tècniques de CAPTCHA, per tractar d'evitar spam i altres eines automatitzades d'edició del vostre wiki, així com per frustrar els intents d'inici de sessió automatitzats que tracten d'endevinar les contrasenyes.
  • Gadgets: proporciona un mètode perquè els usuaris puguin triar "gadgets" basats en JavaScript o CSS, que altres usuaris del wiki proporcionen.
  • ImageMap: permet mapes d'imatges clicables.
  • InputBox: afegeix formularis HTML ja creats per a les pàgines wiki.
  • Interwiki: afegeix la pàgina Mapa de les dades interwiki de paraules clau d'accés a altres wikis
  • LocalisationUpdate: permet actualitzar les localitzacions per als missatges del sistema en qualsevol moment, sense necessitat d'actualitzar el programari MediaWiki. Per això cal tenir el directori $wgLocalisationUpdateDirectory = "$IP/cache"; del servidor amb la possibilitat d'escriure-hi i executar l'ordre indicada (php extensions/LocalisationUpdate/update.php), amb PuTTY.
  • Nuke: fa possible que els operadors del sistema eliminin pàgines de forma massiva.
  • ParserFunctions: millora l'analitzador wikitext amb funcions útils, la majoria relacionades amb la lògica i la manipulació de cadenes.
  • PdfHandler: mostra els arxius pdf pujats en una vista prèvia de disseny de diverses pàgines.
  • Poem: permet un fàcil format de poemes i material similar dins Wikitext.
  • Renameuser: proporciona una pàgina especial que permet als usuaris autoritzats a canviar el nom dels comptes d'usuari.
  • SpamBlacklist: evita les edicions que contenen URLs de dominis que coincideixin amb patrons d'expressions regulars definides.
  • SyntaxHighlight_GeSHi: per visualitzar el codi font formatat amb l'etiqueta <syntaxhighlight>.
  • TitleBlacklist: permet als administradors del wiki bloquejar la creació, el moviment i la càrrega de pàgines, el títol coincideix amb una o més expressions regulars, així com el bloqueig de creació de comptes amb noms d'usuari que coincideixin.
  • WikiEditor: és un marc extensible amb un conjunt de mòduls basats en les característiques que faciliten l'edició als usuaris. També és la interfície d'edició que Wikipedia utilitza actualment.

Plantilles i mòduls

La majoria de les plantilles han estat importades des de la Viquipèdia, amb les mateixes estructures. Per importar-ne de noves cal tenir instal·lat Scribunto, i carregar sempre a més de la pàgina de la plantilla (Plantilla:Nom de plantilla), la documentació: Plantilla:Nom de plantilla/ús en un wiki en català, o Plantilla:Nom de plantilla/doc en un wiki en anglès o castellà, i abans de la plantilla. Cal importar-la abans que la plantilla, altrament s'haurà d'editar la plantilla per tal de que s'actualitzi el seu contingut.

Per fer-ho els passos són.

  1. Exportar des de:
    1. Viquipèdia: Exportació de pàgines (a la que hi podeu accedir des de Pàgines especials, de la barra de menús de l'esquerra).
    2. Wikipedia: Special:Export (a la que hi podeu accedir des de Pàgines especials, de la barra de menús de l'esquerra).
    3. Commons: Special:Export (a la que hi podeu accedir des de Pàgines especials, de la barra de menús de l'esquerra).
  2. Es crearà un fitxer xml que desareu al vostre ordinador.
  3. Importar des d'aquest wiki: Importació de pàgines (a la que hi podeu accedir des de Pàgines especials, de la barra de menús de l'esquerra. Cal seleccionar el fitxer xml desat.

Es pot utilitzar l'extensió ExternalRedirect per tal d'enllaçar directament els enllaços que hi han en les documentacions de les plantilles a la Viquipèdia, resultant finalment les següents redireccions:

##https://www.mediawiki.org/wiki/Extension:ExternalRedirect
require_once("$IP/extensions/ExternalRedirect/ExternalRedirect.php");
$wgExternalRedirectPages = array(
"Ajuda:Categoria",
"Ajuda:Com es modifica una pàgina",
"Ajuda:Notes a peu de pàgina",
"Viquipèdia:Actualitat",
"Viquipèdia:Administrador",
"Viquipèdia:Aquesta pàgina està protegida",
"Viquipèdia:Article ",
"Viquipèdia:Caixes d'avís per a articles",
"Viquipèdia:Categories",
"Viquipèdia:Citau les fonts",
"Viquipèdia:Color del text",
"Viquipèdia:Consens",
"Viquipèdia:Criteris de supressió ràpida",
"Viquipèdia:Documentació de plantilles",
"Viquipèdia:Drecera",
"Viquipèdia:Editor visual",
"Viquipèdia:Esborrany",
"Viquipèdia:Esborrar pàgines",
"Viquipèdia:Esborrar pàgines/Propostes",
"Viquipèdia:Espai de noms",
"Viquipèdia:Fonts fiables",
"Viquipèdia:Fusió",
"Viquipèdia:Llibre d'estil",
"Viquipèdia:Millora",
"Viquipèdia:Neutralitat",
"Viquipèdia:Pàgina protegida",
"Viquipèdia:Plantilles de navegació",
"Viquipèdia:Plantilles per a citar fonts",
"Viquipèdia:Plantilles",
"Viquipèdia:Política i normes",
"Viquipèdia:Proves de plantilles",
"Viquipèdia:Punt de vista neutral",
"Viquipèdia:Sobre les proves",
"Viquipèdia:Traduccions",
"Viquipèdia:Verificabilitat",
);

Aquests enllaços no són exhaustius.

Extensions opcionals

Val la pena incorporar les següents:

  • CategoryTree: proporciona una visió dinàmica de l'estructura de categories de la wiki com un arbre.
  • CiteThisPage: afegeix en el menú de l'esquerra ("Cita aquesta pàgina") un enllaç que copia al portapapers una referència a la pàgina.
  • CharInsert: Permet inserir en el moment d'editar un article caràcters i paraules predeterminades en el text. Està definit a MediaWiki:Edittools
  • CodeEditor: dona més propietats a la barra d'eines d'edició de WikiEditor amb el giny d'edició Ace incrustat.
  • CommonsMetadata: prova d'extreure les metadades de les pàgines de commons (per exemple de la fotografia: quan va ser tirada, la distància focal, etc).
  • Collection: permet a l'usuari organitzar seleccions personals de les pàgines d'una col·lecció. Les col·leccions es poden editar i estructurar mitjançant capítols. Després es poden exportar a pdf.
  • DeleteHistory: elimina vella informació no desitjada en la història.
  • Disambiguator: està dissenyat per fer més fàcil treballar amb les pàgines de desambiguació amb programació. Permet designar totes les pàgines de desambiguació amb la paraula màgica (o un àlies equivalent), que després se les marca com a tals a la base de dades.
  • ExternalRedirect: permet crear redireccions a pàgines externes en format wiki.
  • FramedVideo: permet incrustar vídeos de 44 serveis d'allotjament de vídeo (entre ells, es clar, Youtube, Vimeo, ...).
  • MediaWikiLanguageExtensionBundle: sols utilitzat per fer wikis amb múltiples traduccions
    • Babel: permet especificar en els textos de les pàgines d'usuari, quins són els idiomes que parla, ajudant a la comunicació multilingüe entre diferents usuaris que poden parlar o entendre una llengua diferent de l'anglès, per exemple.
    • cldr
    • CleanChanges
    • LocalisationUpdate: ja comentat abans
    • Translate: una potent eina per a traduir qualsevol tipus de text.
    • UniversalLanguageSelector: permet als usuaris seleccionar un idioma d'una manera fàcil.
  • Mantle: necessària per a MobileFrontend:
  • MobileFrontend: detecció i visualització específica per a mòbils.
  • MwEmbedSupport: necessària per a altres extensions (com TimedMediaHandler).
  • PdfExport o, millor, PdfBook... a investigar cal instal·lar abans: Htmldoc.
  • ReplaceText: per permetre als administradors fer una cerca global d'una cadena i fer reemplaçament en el text o en els títols de les pàgines de contingut del wiki.
  • Scribunto, per tal de que funcioni el lua, cal canviar els permisos de /extensions/Scribunto/engines/LuaStandalone/binaries/lua5_1_5_linux_64_generic/lua: Ha de tenir permisos d'execució!, això és pot fer directament des de FileZilla
  • TemplateData: introdueix l'etiqueta <templatedata> i una API que en conjunt permeten als editors especificar com s'han d'invocar plantilles.
  • TemplateSandbox: afegeix la possibilitat de previsualitzar una pàgina usant versions de prova de les plantilles. També treballa amb mòduls Scribunto.
  • Thanks: permet als usuaris dir "gràcies" a altres usuaris per les seves modificacions.
  • UploadWizard: complet sistema de càrrega de fitxers

No funcionen:

Recordeu que fer una crida a una extensió inexistent fa que el wiki deixi de funcionar.

UploadWizard

Important, cal carregar l'última versió.

En la versió en català

Com que MediaWiki:Common.js ha estat copiat del corresponent fitxer de la Viquipèdia (MediaWiki:Common.js), heu d'anar a

a.setAttribute('href', '/wiki/Ajuda:Carregar_un_fitxer');

i canviar-ho per:

a.setAttribute('href', "index.php?title=Projecte:Pàgina d'inici de càrrega");

Llavors és a Projecte:Pàgina d'inici de càrrega on hi ha la proposta de fer la càrrega a Commons envers de fer-la en aquest wiki.

En la versió en anglès

Amb una MediaWiki:Common.js copiada de la versió anglesa MediaWiki:Common.js. Heu d'afegir:

/**
 * Link to load default page for help
 */
var LienUpload = function ($) {
  uploadLink = document.getElementById("t-upload");
  if (!uploadLink) return;
 
  a = uploadLink.firstChild;
  a.setAttribute('href', "index.php?title=Project:Upload start page");
};
$(document).ready(LienUpload);

Abans de

/* End of mw.loader.using callback */

Llavors és a Project:Upload start page on hi ha la proposta de fer la càrrega a Commons envers de fer-la en aquest wiki.

Informació de les imatges

Una vegada carregada la imatge aquesta contindrà una plantilla d'informació de la imatge: títol, l'autor, etc.

Llicències

Cal crear: MediaWiki:Licenses, podeu prendre model de:

Missatges

Que com podreu veure conté moltes cadenes de paraules multillenguatge que caldrà carregar, ho farem des de MediaWiki.

Cadenes cridades, a les quals cal afegir-hi "/ca", "/es", "/en", etc.

MediaWiki:Wm-license-cc-wiki-link
MediaWiki:Wm-license-own-work
MediaWiki:Wm-license-cc-by-sa-4.0-text
MediaWiki:Wm-license-cc-by-sa-3.0-text
MediaWiki:Wm-license-cc-conditions
MediaWiki:Wm-license-cc-conditions-attribution-header
MediaWiki:Wm-license-cc-conditions-attribution-text
MediaWiki:Wm-license-cc-conditions-share alike-header
MediaWiki:Wm-license-cc-conditions-share alike-text
MediaWiki:Wm-license-cc-free
MediaWiki:Wm-license-cc-free-to-remix-header
MediaWiki:Wm-license-cc-free-to-remix-text
MediaWiki:Wm-license-cc-free-to-share-header
MediaWiki:Wm-license-cc-free-to-share-text
MediaWiki:Wm-license-information-author
MediaWiki:Wm-license-information-author-missing
MediaWiki:Wm-license-information-date
MediaWiki:Wm-license-information-description
MediaWiki:Wm-license-information-description-missing
MediaWiki:Wm-license-information-description-missing-request
MediaWiki:Wm-license-information-other-versions
MediaWiki:Wm-license-information-permission
MediaWiki:Wm-license-information-permission-reusing-link
MediaWiki:Wm-license-information-permission-reusing-text
MediaWiki:Wm-license-information-source
MediaWiki:Wm-license-information-source-missing
MediaWiki:Wm-license-information-source-missing-request
MediaWiki:Wm-license-self-multiple-licenses
MediaWiki:Wm-license-self-one-license

Plantilles

Caldrà importar des de Commons:Main page

Template:Description/doc
Template:Description
Template:Description-begin
Template:Description-end
Template:Description/i18n
Template:Description/sandbox
Template:Description/sandbox1
Template:Description/testcases
Template:Description article audio
Template:Description insufficient
Template:Description missing/doc
Template:Description missing
Template:Description needed

Template:Author missing/doc
Template:Autotranslate/doc
Template:Dir/doc
Template:Documentation/doc
Template:Documentation subpage/doc
Template:Documentation/layout/doc
Template:Fallback/doc
Template:GetFallback/doc
Template:Heavily used template/doc
Template:ISOdate/doc
Template:Iffile/doc
Template:Information/doc
Template:Information/author processing/doc
Template:Parse source/doc
Template:Section link/doc
Template:Source missing/doc
Template:Tl/doc
Module:Fallback/doc
Module:Fallbacklist/doc
Module:TemplatePar/doc
Template:Information/doc

Template:Author missing
Template:Autotranslate
Template:Description missing
Template:Dir
Template:Documentation
Template:Documentation subpage
Template:Documentation/en
Template:Documentation/layout
Template:Fallback
Template:GetFallback
Template:Heavily used template
Template:ISOdate
Template:Iffile
Template:Information
Template:Information/author processing
Template:Parse source
Template:Section link
Template:Source missing
Template:Tl
Module:Fallback
Module:Fallbacklist
Module:TemplatePar
Template:Information
Template:Information/draft
Template:Information/sandbox

Plantilles utilitzades en l'explicació -> Desplegables d'idiomes

En el moment d'afegir una imatge cal escollir l'idioma o idiomes de l'explicació, per la llista cal que siguin incorporats.

Per fer-ho calen les plantilles de Category:Language templates

Template:Internationalization template doc
Template:Internationalization template doc/ca
...
Template:ca
....

Versió sols en català

Alguna de les Plantilles d'indicació d'idioma, com Plantilla:ca.

Versió multilingüe

Per fer-ho calen les plantilles de Category:Language templates

Template:ca
Template:es
Template:en
....

Còpia de seguretat del wiki

Tot i que hi han sistemes de seguretat en els servidor, es pot fer una còpia seguint els passos establerts: Manual:Backing up a wiki.

Per fer la còpia de seguretat de la base de dades jo utilitzo HeidiSQL.

Optimització d'espai a la base de dades

Eliminar l'espai de pàgines esborrades