SideBar

administradores (b脿sic)

Aquesta p脿gina explica com descarregar i instal路lar PmWiki 2.1 i 2.2. Ac铆 hi ha una llista de p脿gines relacionades:

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

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.7.5. 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.

Nota: Es recomana canviar el nom del directori "pmwiki-x.y.z" per simplement "pmwiki" o fins i tot nom茅s "wiki".

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.)

3a. Podeu crear el directori wiki.d/ manualment, i despr茅s donar-li permisos d'escriptura per a tothom (i.e., "chmod 777 wiki.d"). Useu aquest m猫tode quan el mode segur (safe mode) 茅s actiu a la instal路laci贸 PHP del servidor.
3b. En alguns sistemes podeu deixar que PmWiki crei el directori wiki.d/ canviant temporalment els permisos del directori qu猫 cont茅 el fitxer pmwiki.php a 2777. En sistemes Unix aix貌 es fa anant al directori que cont茅 el fitxer pmwiki.php i executant l'ordre
chmod 2777 .
(noteu el punt al final). L'ordre 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:

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