Instal·lació de PmWiki

Aquesta pàgina explica com descarregar i instal·lar PmWiki 2.1 i 2.2. Ací hi ha una llista de pàgines relacionades:

• Requirements - Prerequisits per a executar PmWiki
• Upgrades? -
• WikiFarms? -
• Change Log (en anglés) - Log of changes made to PmWiki by Release

S'aprecia qualsevol millora sobre aquestes instruccions. Només cal que informeu del problema a la MailingLists? de pmwiki-users o feu servir PmWiki Issue Tracking System.

Instal·lar PmWiki

Si voleu actualitzar, per favor llegiu la pàgina Upgrades?.

1. Descàrrega

Descarregueu l'última versió estable de PmWiki en format

• zip (pmwiki-latest.zip), o
• tarball (gzip) (pmwiki-latest.tgz) des de http://pmwiki.org/pub/pmwiki/, o

Descarregueu l'última versió beta des de la pàgina PmWiki:Subversion.

2. Descomprimiu

Descomprimiu l'arxiu (tar zxvf pmwiki-latest.tgz o unzip pmwiki-latest.zip). Això crearà un directori pmwiki-x.y.z què contindrà una còpia de PmWiki. Per exemple, el paquet "latest" actual s'hauria de descomprimir a un directori anomenat pmwiki-2.3.38. Els fitxers d'aquest directori són:

  README.txt        Un document introductori
  pmwiki.php        El programa principal de PmWiki
  local/            Els scripts de configuració (fitxers de configuració local)
  cookbook/         Complements (també anomenats receptes) del Cookbook
  docs/             Documentació  breu, scripts de configuració d'exemple
  pub/              Arxius accessibles públicament
  pub/css/          Fulls d'estil CSS extra [1]
  pub/guiedit/
  pub/skins/        Plantilles per a la personalització de l'aspecte i de la interacció
  scripts/          Scripts què són part de PmWiki
  wikilib.d/        Conjunt de pàgines de PmWiki incloses per defecte

El directori pmwiki-x.y.z s'ha de col·locar a algun lloc accessible pel servidor web (p.ex., a al directori public_html o algun equivalent). Podeu ubicar els fitxers i directoris de diverses maneres -- mitjançant FTP, o amb una comanda Unix mv o cp hauria de ser suficient.

3. Creació dels directoris necessaris

En la majoria de casos PmWiki crearà els directoris tot sol. Obriu el navegador web i visiteu l'script pmwiki.php al servidor (i.e., no la còpia que teniu a al vostre ordinador què s'accedeix usant un URL del tipus file://...). PmWiki analitzarà la vostra configuració i vos donarà instruccions (si és necessari) per a crear el directori wiki.d/ què s'usarà per a emmagatzemar les pàgines creades al vostre lloc web.

Alternativament, hi ha dos maneres d'arribar al mateix resultat. (Feu servir Filezilla o WinSCP per a canviar els permisos dels fitxers i directoris FTP.)

Després d'haver establert els permisos del directori, torneu a intentar obrir l'script pmwiki.php al navegador. Si tot ha anat bé, s'haurà creat el directori wiki.d i veureu la pàgina d'inicial.

Important: Si useu el mètode 3b, haureu de redefinir els permisos "chmod 755 ." del directori què conté pmwiki.php.

4. Inicialització

Trobareu altres tasques per a començar a personalitzar la vostra instal·lació de PmWiki a la pàgina de InitialSetupTasks?. Per a més informació, tal volta també voleu llegir detalladament les Notes de Versió.

5. Configureu l'idioma

Si voleu usar PmWiki en un idioma que no siga l'anglès, descarregueu el paquet d'idiomes internacional? en format zip (i18n-all.zip) des de http://pmwiki.org/pub/pmwiki/i18n/. Després descomprimiu-lo i copieu els continguts al directori wikilib.d/. Alternativament al fitxer amb tots els idiomes (sufixe -all), també podeu descarregar el fitxer d'idioma de la llengua que vos interessa.

Els idiomes disponibles són:

Hi ha dos directoris a l'arxiu i18n descomprimit, , scripts i wikilib.d. Copieu els fitxers continguts en aquestos directoris als directoris scripts i wikilib.d del vostre directori PmWiki respectivament. Per exemple, per a localitzacions en Català, PmWikiCa.* i PmWiki.* han de quedar ubicades al mateix directori.

Aleshores, habiliteu-ne la localització afegint la instrucció per a carregar la traducció que preferiu al fitxer local/config.php. Per exemple, XLPage('ca','PmWikiCa.XLPage'); carregarà la pàgina d'idioma català PmWikiCa.XLPage.

Podeu llegir més sobre aquest tema a Internationalizations?.

Notes

• La distribució de PmWiki no inclou un fitxer index.php a propòsit. Podeu afegir el vostre propi "wrapper" al mateix directori on és pmwiki.php. Creeu un fitxer nou anomenat index.php i escriviu-hi la següent línia (hi falta l'etiqueta " ?>" de tancament a propòsit):
  <?php include_once('pmwiki.php');

Resistiu la temptació de canviar el nom al fitxer pmwiki.php per index.php perquè si ho feu el fitxer no serà substituït en actualitzar el programari.

• Si useu l'ordre tar de Unix per a descomprimir l'arxiu del pas 2 de sobre, assegureu-vos que els fitxers es creen amb els permisos suficients per a que el servidor web hi pugui accedir. Normalment vos en podeu assegurar escrivint umask 002 a la línia d'ordres abans de descomprimir el fitxer tar.
• Quan feu una instal·lació a un sistema Windows hauríeu de fer una ullada a la recepta Cookbook:SimultaneousEdits per tal d'habilitar l'edició simultània?.
• Podeu trobar més trucs i consells a Troubleshooting?.

Feu una ullada a:

• Cookbook:PHP
• Cookbook:InstallOnIIS

Traducció de PmWiki.Installation - Pàgina original a PmWikiCa.Installation - Backlinks