<?xml version="1.0" encoding="iso-8859-1"?><xpml version="0.1" scheme="db"><meta><title>Instalação e configuração</title><date type="created">2004-12-15T01:04:11</date><date type="modified">2005-03-01T19:45:27</date><type>text</type><format>text/html</format><identifier type="id">db:www_n00002</identifier><identifier type="url">/install/index.html</identifier><language>pt-br</language></meta><resource id="db:www_n00002#1" type="toc"><title>Conteúdo desta página</title><position ref="index:template-positions#2.name">navbar</position></resource><resource id="db:www_n00002#2" type="content"><title>Obtendo a última versão do programa</title><position ref="index:template-positions#1.name">default</position><content><p>Lançamentos, atualizações e novidades sobre o Pindorama estarão sempre disponíveis na URL:</p><p><a href="http://sourceforge.net/projects/pindorama/">http://sourceforge.net/projects/pindorama/</a> </p><p>De posse do arquivo compactado (.zip ou .tar.gz) com a última distribuição do programa, é possível fazer a instalação em menos de 5 minutos.</p></content></resource><resource id="db:www_n00002#3" type="content"><title>Pré-requisitos</title><position ref="index:template-positions#1.name">default</position><content><p>Apesar do Pindorama ter rodado ate mesmo em servidores IIS, é recomendado o uso do servidor Web Apache, pela sua estabilidade e recursos de mapeamento de arquivos virtuais.</p><p>Também é necessário ter habilitado o suporte à linguagem de programação PHP, vesão 4.x (o Pindorama ainda não é compatível com a versão 5.x e 3.x), com os seguintes módulos instalados (além da configuração default:</p><ul><li>XML (utilizando o Expat)</li><li>Iconv</li><li>XSLT (utilizando o Sablotron)</li><li>Curl</li></ul><p>Para evitar problemas entre o PHP e outras instruções de processamento XML, é recomendado desativar a diretriz: <em>short_open_tag</em></p><p>Também, como o Pindorama trata muitos cabeçalhos HTTP nativamente, é recomendado não utilizar qualquer modelo de armazenamento e tratamento dos resultados dos scripts, como: <em>output buffers</em> etc.</p></content></resource><resource id="db:www_n00002#4" type="content"><title>Instalação</title><position ref="index:template-positions#1.name">default</position><content><p>Primeiro descompacte estes arquivos em algum lugar, como <em>/caminhopara/pindorama</em>, e modifique as permissões dentro da pasta <em>/pindorama/var/</em> para permitir que o usuário do servidor Web possa escrever e modificar arquivos e pastas (no Linux/Unix, utilize o comando <em>chmod</em> com a máscara 666 para arquivos e 777 para diretórios).</p><p>Você deve ter o servidor Web e PHP instalado (como módulo, não como CGI-BIN), com as seguintes bibliotecas no PHP: <em>XSLT</em> (com o sablotron), Curl e <em>Iconv</em>.</p><p>O Pindorama fica melhor quando possui um virtual host dedicado para ele, masele pode ser instalado como uma subpasta de seu domínio.</p><h3>Instalando o Pindorama em um novo <em>virtual host</em> (Apache)</h3><p>Escreva a seguinte diretriz na seção do <em>virtual host</em> a ser destacado para o Pindorama</p><pre>AliasMatch /.* /caminhopara/pindorama/active/index.php</pre><p>(Re)Inicie o servidor e pronto. Ao acessar este domínio, o Pindorama você deverá ver a página inicial do website Pindorama, com a barra de edição de conteúdo ao topo.</p><h3>Instalando o Pindorama em uma subpasta de seu domínio</h3><p>Com a instalação do Pindorama descompactada fora da raiz de seu website, crie uma pasta dentro da raiz do website para o Pindorama (como <em>/htdocs/admin/</em>) e copie o arquivo <em>/caminhopara/pindorama/copy-this.index.php</em> para esta pasta.</p><p>Com um editor de texto, edite o conteúdo deste arquivo, atualizando os valores de <em>$_SERVER[&quot;pindorama_base&quot;]</em> com o caminho completo para a pasta do Pindorama e <em>$_SERVER[&quot;pindorama_url&quot;]</em> com a URL da subpasta do Pindorama em seu domínio.</p><p>Acesse esta URL e você deverá ter acesso à página de entrada do website do Pindorama, com a barra de edição ao alto.</p><h3>Senha do administrador do sistema</h3><p>Caso você utilize a autenticação HTTP para controlar as permissões dos usuários, uma tela de login deverá aparecer ao primeiro acesso do Pindorama. Por default, utilize:</p><blockquote dir="ltr" style="margin-right: 0px"><p>Login: admin</p><p>Senha: admin1234</p></blockquote><p>Acesse a página de administração de usuários para atualizar a sua senha o quanto antes (em <em>Usuários</em> &gt; <em>Alterar login e informações dos usuários</em>).</p></content></resource><resource id="db:www_n00002#5" type="content"><title>Configuração</title><position ref="index:template-positions#1.name">default</position><content><p>Atualizando as informações em <em>/pindorama/etc/config/core.php</em>, é possível ajustar todas as preferências do website ou aplicação a ser gerenciado pelo Pindorama.</p></content></resource><resource id="db:www_n00002#6" type="content"><title>Conceitos básicos</title><position ref="index:template-positions#1.name">default</position><content><p>O conceito da ferramenta é simples, ela mantém no ambiente de desenvolvimento uma cópia do website que é gerada dinamicamente, através de transformações XSL. Ela utiliza uma base de dados em XML mas também acessa dados externos, e possui um sistema de templates para melhor apresentar estas informações.</p><p>As informações no Pindorama podem ser de duas formas: documentos e índices. Documentos são páginas isoladas de informação, que podem ter uma URL designada e estarem associados hierarquicamente (estrutura de informações). Cada arquivo do site é um documento, sejam páginas HTML, imagens, folhas de estilo CSS etc. Os documentos podem ser acessados a partir da interface do pindorama (utilizando a opção <em>Abrir este documento</em> ou colocando um sufixo &quot;.dav&quot; na URL completa da página (por exemplo, a página inicial do website <a href="http://localhost/">http://localhost/</a> pode ser acessada no pindorama através da URL <a href="http://localhost/index.html.dav">http://localhost/index.html.dav</a>).</p><p>Índices são como tabelas de informação, porém em XML (possuem uma estrutura mais sofisticada que uma tabela cartesiana) e são utilizados para associar informações. Os índices também podem ter URLs designadas e terem sua visualização própria, mas dependem de regras especificas nos templates para tanto.</p></content></resource><resource id="db:www_n00002#7" type="content"><title>Estrutura de diretórios do Pindorama</title><position ref="index:template-positions#1.name">default</position><content><p>A estrutura de diretórios do Pindorama foi estabelecida de forma a separar o código-fonte do programa, das configurações personalizadas do site e dos arquivos gerenciados pelo servidor.</p><p>Assim, a distribuição do Pindorama fica restrita à pasta <em>/pindorama/active/</em>, tendo como subestrutura a seguinte:</p><ul><li>/active</li><li>/active/components (componentes e módulos)</li><li>/active/config (configuração básica do programa (não deve ser alterada!)</li><li>/active/docs (documentação)</li><li>/active/stylesheets (arquivos XSL de transformação da interface do Pindorama e de atualização das informações)</li></ul><p>As configurações do site, em /etc, definem o comportamento do website, assim <br />como configurações peculiares a cada distribuição:</p><ul><li>/etc</li><li>/etc/config (configurações do site &#151; podem ser editadas)</li><!--<li>/etc/image (configurações do módulo de geração de imagens &#151; estilos)</li>--><li>/etc/includes (arquivos que podem ser incluídos pelas transformações XSLT)</li><!--<li>/etc/sql (consultas em sql para extrair informações de bancos de dados relacionais)</li><li>/etc/swish (configurações da feramenta de consulta swish-e -- o Pindorama possui templates prontas para utilizá-lo)</li>--><li>/etc/templates (templates de apresentação do pindorama)</li></ul><p>e em /var, os arquivos que são escritos pelo servidor (é bom colocar estes arquivos com chmod 666 para arquivos e 777 para diretórios)</p><ul><li>/var</li><li>/var/db (banco de dados das páginas em XML)</li><li>/var/index (bd dos índices em XML)</li><li>/var/log (logs da ferramenta)</li><!--<li>/var/post (local de incorporação de dados externos)</li>--><li>/var/public (local default para os arquivos publicados)</li><!--<li>/var/sql (cache dos dados extraídos das consultas sql em XML)</li><li>/var/swish (local dos índices de consulta do swish-e)</li>--><li>/var/users (informações sobre premissões dos usuários &#151; para aumentar a segurança, estes arquivos podem ser restritos ao usuário do Apache)</li><li>/var/webcache (cache das páginas geradas pelo Pindorama)</li><li>/var/www (arquivos a serem apresentados diretamente pelo Pindorama)</li></ul></content></resource></xpml>