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.12. 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.)
chmod 777 wiki.d
"). Useu aquest mètode quan el mode segur (safe mode) és actiu a la instal·lació PHP del servidor.
chmod 2777 .
chmod
també funciona a molts programes FTP. Si creeu el directori wiki.d/ així, aconseguireu (1) el directori amb permisos d'escriptura de manera que el servidor web podrà crear els directoris de dades que necessiti per als fitxers wiki, (2) mantenir la propietat del grup del directori de manera que l'instal·lador podrà manipular els fitxers creats al directori, i (3) fer que siga més difícil accedir als fitxers de wiki.d/ des d'altres comptes del mateix servidor.
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:
Česky (Czech) Arabic Bulgarian Català Chinese (Traditional) Chinese simplified Dansk Deutsch English Español Esperanto Farsi (Persian) Français Greek Indonesian Italiano Japanese Korean Latviešu (Latvian) Lietuvių (Lithuanian) Macedonian Magyar (Hungarian) Nederlands Norsk Polski Portuguese Portuguese (Br) Românã Russian Shqip Slovenčina Slovenščina Suomi Svenska Türkçe Tamil Ukrainian Việt ngữ
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:
Puc canviar el nom del fitxer pmwiki.php a index.php?
No es recomana canviar el nom del fitxer pmwiki.php. En lloc d'això, creeu un fitxer index.php que contingui aquesta única línia
<?php include_once('pmwiki.php');
Com faig de pmwiki.php la pàgina per defecte d'un lloc web?
Creeu un fitxer index.php que executi PmWiki des d'un subdirectori (per exemple pmwiki/ ) i col·loqueu-lo al directori web arrel del lloc.
<?php chdir('pmwiki'); include_once('pmwiki.php');
Nota: En aquest cas serà necessari que definiu explícitament la variable $PubDirUrl
(p.ex. amb el valor "http://example.com/pmwiki/pub"
) al fitxer local/config.php .
Com puc habilitar els "URLs nets" què són més curts i pareixen camins a les meues pàgines wiki? Per què pmwiki.org sembla tenir una estructura de directoris en lloc de tenir "?n=pagename" als URLs?
Feu una ullada a Cookbook:CleanUrls.
Com put fer servir PmWiki en una instal·lació isolada (fora de línia, portàtil) ?
Feu una ullada a Cookbook:Standalone o a Cookbook:WikiOnAStick.
Traducció de PmWiki.Installation -
Pàgina original a PmWikiCa.Installation -
Backlinks