Legostar Galactica Wiki » PmWikiPtBr » InstalaÃ§Ã£o do PmWiki

administradores (bÃ¡sico) Esta pÃ¡gina explica como baixar e instalar o PmWiki 2.1 and 2.2. Veja a lista de pÃ¡ginas relacionadas:

Necessidades - Pre-requisites for running the PmWiki wiki engine
Upgrades - How to upgrade an existing PmWiki installation
Fazendas Wiki - Running multiple wikis from a single installation
Log de AlteraÃ§Ã£o - Log of changes made to PmWiki by Release

Improvements to these instructions are always appreciated. Just report any problems you encounter to the pmwiki-users PmWiki:mailing list or use the PmWiki Issue Tracking System.

Instalando PmWiki

1. Download

Baixe a Ãºltima versÃ£o do PmWiki como um

arquivo zip (pmwiki-latest.zip) ou um
gzipped tarball (pmwiki-latest.tgz) de http://pmwiki.org/pub/pmwiki/,

ou baixe o Ãºltimo beta a partir da pÃ¡gina PmWiki:Subversion.

2. Descompactando

Descompacte o arquivo (tar zxvf pmwiki-latest.tgz ou unzip pmwiki-latest.zip). Isso criarÃ¡ um diretÃ³rio pmwiki-x.y.z contendo o software PmWiki. Por exemplo, a atual "velha" deveria descompactar em uma diretÃ³rio nomeado como pmwiki-2.3.38. Os arquivos deste diretÃ³rio incluem:

  README.txt        Um documento introdutÃ³rio
  pmwiki.php        A pÃ¡gina principal do PmWiki que contÃ©m o script
  local/            Scripts de configuraÃ§Ã£o (arquivos de configuraÃ§Ã£o local)
  cookbook/         Recipes (add-ons) from the Cookbook
  docs/             Brief documentation, sample configuration scripts
  pub/              Publicly accessible files
  css/              Extra CSS stylesheet files ^[1]
  skins/            Layout templates for custom look and feel
  guiedit/
  scripts/          Scripts that are part of PmWiki
  wikilib.d/        Bundled default PmWiki pages

O diretÃ³rio pmwiki-x.y.z precisa ser colocado em um local acessÃvel pelo seu webserver (e.g., no diretÃ³rio public_html). VocÃª pode colocar os arquivos e diretÃ³rios usando vÃ¡rios mÃ©todos -- FTP, ou comandos Unix como mv e cp geralmente fazem esse trabalho.

Nota: Ã‰ recomendÃ¡vel alterar o diretÃ³rio "pmwiki-x.y.z" para simplesmente "pmwiki".

#diretÃ³rios 3. Criando diretÃ³rios

Em diversos casos PmWiki irÃ¡ fazer para vocÃª. Abra o brownser para o script pmwiki.php no servidor (i.e., nÃ£o no seu computador local ou acessando usando uma URL file://...). PmWiki irÃ¡ entÃ£o analizar sua configuraÃ§Ã£o de sistema e prover instruÃ§Ãµes (se necessÃ¡rio) para criaÃ§Ã£o do diretÃ³rio wiki.d/ o qual serÃ¡ usado para armazenar as pÃ¡ginas criadas por seu site.

Entretanto, hÃ¡ duas formas de arquivÃ¡-los.

3a. VocÃª pode criar o diretÃ³rio wiki.d/ manualmente, e apÃ³s fornecer total permissÃ£o de escrita (i.e., "chmod 777 wiki.d"). Use este mÃ©todo quando o modo "safe mode" estiver ativo em seus servidores de instalaÃ§Ã£o PHP.

3b. Em alguns sistemas vocÃª pode permitir que o PmWiki crie o diretÃ³rio wiki.d/ atravÃ©s de uma alteraÃ§Ã£o temporÃ¡ria de permissÃµes no diretÃ³rio que contÃ©m o arquivo pmwiki.php para 2777. In Unix this is commonly done by changing to the directory containing pmwiki.php and executing the command

chmod 2777 .

(note the dot at the end). The chmod command also works in many FTP programs. Creating wiki.d/ in this manner will (1) make the directory writable so the web server can create the data directory it needs for the wiki files, (2) preserve group ownership of the directory so the installer account can manipulate the files created in this directory, and (3) make it more difficult for other accounts on the same server to access the files in wiki.d/.

After establishing directory permissions, try opening a browser to the pmwiki.php script again. If all is well, the wiki.d directory will have been created and you'll see the default home page.

Important: If you used method 3b, you should reset permissions by executing "chmod 755 ." in the directory containing pmwiki.php.

4. Initialize

Check out Initial Setup Tasks for other tasks you may want to perform to begin customizing your PmWiki installation. You might also want to peruse the Release Notes for further information.

5. Set language

If you want to use PmWiki in a different language download the international language pack as zip archive (i18n-all.zip) from http://pmwiki.org/pub/pmwiki/i18n/. Then extract it and copy the files into the wikilib.d/ directory as described above. Besides the -all file you can also download your country localization file only.

Languages available are:

There are two directories in the decompressed i18n archive, scripts and wikilib.d. Copy the files respectively contained in these directories to the scripts and wikilib.d of your PmWiki directory. For example, for French localization, PmWikiFr.* and PmWiki.* must be contained in the same directory.

Then, enable localization by adding an instruction to local/config.php to load the language translation page of your choice. For instance, XLPage('fr','PmWikiFr.XLPage'); loads the French language page PmWikiFr.XLPage.

Read more about this on Internationalizations.

Notes

* The PmWiki distribution deliberately doesn't include an index.php file. You can easily add your own "wrapper script" in the same directory as pmwiki.php. Create a new file called index.php with the following single line of text (missing a closing " ?>" tag deliberately):

<?php include_once('pmwiki.php');

Resist the temptation to rename pmwiki.php to index.php because if you rename the file it will not be overwritten during an upgrade.

If using the Unix tar command to unpack the archive in step 2 above, be sure that the files are created with sufficient permissions for the webserver to be able to access them. Usually you can ensure this by typing umask 002 on the command line before unpacking the tar file.
When installing on Windows you should take a look at Cookbook:SimultaneousEdits to enable simultaneous edits on that platform.
Additional tips can be found at Troubleshooting.