Quebra de linha para facilitar os commits

Fábio Ribeiro
1 parent ae437811
Showing 1 changed file with 101 additions and 43 deletions Show diff stats
README.md
@@ -2,25 +2,38 @@
 Para versões do Mapserver 7.x ou posteriores e Openlayers 4
-Utilize esse repositório para manter seu código sempre atualizado diariamente. Isso garante o recebimento de correções de bugs.
+Utilize esse repositório para manter seu código sempre atualizado diariamente.
+Isso garante o recebimento de correções de bugs.
-Arquivos antigos e outras informações, veja em: https://softwarepublico.gov.br/social/i3geo/
+Arquivos antigos e outras informações, veja em:
+https://softwarepublico.gov.br/social/i3geo/
-Guia completo sobre instalação e administração do software, veja em: https://softwarepublico.gov.br/gitlab/i3geo/i3geo/wikis/home
+Guia completo sobre instalação e administração do software, veja em:
+https://softwarepublico.gov.br/gitlab/i3geo/i3geo/wikis/home
-Sobre segurança: https://softwarepublico.gov.br/gitlab/i3geo/i3geo/wikis/notas-sobre-seguranca
+Sobre segurança:
+https://softwarepublico.gov.br/gitlab/i3geo/i3geo/wikis/notas-sobre-seguranca
 # Guia de instalação
-O i3Geo pode ser instalado em diferentes sistemas operacionais Linux e também no Windows. Nesse tutorial será mostrado como instalar no Windows e no Ubuntu.
+O i3Geo pode ser instalado em diferentes sistemas operacionais Linux e também no
+Windows. Nesse tutorial será mostrado como instalar no Windows e no Ubuntu.
-Os arquivos do i3Geo estão disponíveis no Portal do Software Público Brasileiro (SPB). Para ter acesso a eles é desejável fazer um cadastro. O SPB, utiliza o Git, um sistema de controle de versões para disponibilizar o código. Assim, para obter os arquivos do i3Geo é necessário ter um cliente Git. No Windows pode ser utilizado o Tortoise. A utilização do Git é importante pois você poderá atualizar o software sempre que achar necessário.
+Os arquivos do i3Geo estão disponíveis no Portal do Software Público Brasileiro
+(SPB). Para ter acesso a eles é desejável fazer um cadastro. O SPB, utiliza o
+Git, um sistema de controle de versões para disponibilizar o código. Assim, para
+obter os arquivos do i3Geo é necessário ter um cliente Git. No Windows pode ser
+utilizado o Tortoise. A utilização do Git é importante pois você poderá
+atualizar o software sempre que achar necessário.
 ## Docker
-Esta versão do i3geo conta com uma imagem Docker que pode ser utilizada para testar rapidamente o software e também utiliá-lo em ambiente produtivo após as suas customizações.
+Esta versão do i3geo conta com uma imagem Docker que pode ser utilizada para
+testar rapidamente o software e também utiliá-lo em ambiente produtivo após as
+suas customizações.
-Para usar basta ter o Docker instalado no seu computador e executar o seguinte comando:
+Para usar basta ter o Docker instalado no seu computador e executar o seguinte
+comando:
 `docker run -i -t -p 80:8080 --rm i3geo/i3geo`
@@ -30,44 +43,58 @@ Em seguida, acesse um navegador de sua preferência e insira o seguinte endereç
 Mais opções em https://hub.docker.com/u/i3geo/dashboard/
-Dicas sobre Docker: https://www.digitalocean.com/community/tutorials/como-instalar-e-utilizar-o-docker-primeiros-passos-pt
+Dicas sobre Docker:
+https://www.digitalocean.com/community/tutorials/como-instalar-e-utilizar-o-docker-primeiros-passos-pt
 ## Windows
-Utilize pacote MS4W, que irá transformar o seu computador em um servidor web (apenas para uso pessoal), ao instalar os softwares APACHE, PHP e Mapserver.
+Utilize pacote MS4W, que irá transformar o seu computador em um servidor web
+(apenas para uso pessoal), ao instalar os softwares APACHE, PHP e Mapserver.
-Para isso faça o download do arquivo de instalação em http://www.ms4w.com/download.html#download.
+Para isso faça o download do arquivo de instalação em
+http://www.ms4w.com/download.html#download.
-Nas opções de pacotes escolha pelo menos "MS4W Base Files" e "Install and Start Apache Server", na opção "Destination root" escolha "C:\" e em "Apache port" mantenha como "80".
+Nas opções de pacotes escolha pelo menos "MS4W Base Files" e "Install and Start
+Apache Server", na opção "Destination root" escolha "C:\" e em "Apache port"
+mantenha como "80".
-Teste a instalação digitando em seu navegador de internet: http://localhost (se não funcionar, reinicie o computador).
+Teste a instalação digitando em seu navegador de internet: http://localhost (se
+não funcionar, reinicie o computador).
-Depois de instalado o MS4W você terá em seu computador a pasta c:\ms4w\Apache\htdocs. Dentro dessa pasta é que o i3Geo deverá ser copiado.
+Depois de instalado o MS4W você terá em seu computador a pasta
+c:\ms4w\Apache\htdocs. Dentro dessa pasta é que o i3Geo deverá ser copiado.
-Alguns usuários reportaram problemas ao instalar o Apache em algumas versões do Windows. Nesses casos a seguinte rotina pode resolver o problema:
+Alguns usuários reportaram problemas ao instalar o Apache em algumas versões do
+Windows. Nesses casos a seguinte rotina pode resolver o problema:
 * No Painel de Controle, digite no campo de pesquisa UAC
 * Escolha a opção “Alterar configurações de Controle de Contas de Usuário”.
 * Na janela que será aberta na sequência, configure para “Nunca notificar“.
 * Reinicie o computador
 * Execute novamente o arquivo apache-install.bat
-* Para confirmar que tudo ocorreu bem, abra o navegador de internet e digite http:\\localhost
+* Para confirmar que tudo ocorreu bem, abra o navegador de internet e digite
+  http:\\localhost
 ### i3Geo Windows
-Para obter o código do i3Geo você tem duas opções, a primeira utiliza simplesmente o download de um arquivo e a segunda utiliza o Git. A vantagem da segunda opção é que você poderá atualizar sua instalação de forma mais fácil.
+Para obter o código do i3Geo você tem duas opções, a primeira utiliza
+simplesmente o download de um arquivo e a segunda utiliza o Git. A vantagem da
+segunda opção é que você poderá atualizar sua instalação de forma mais fácil.
 #### Primeira opção:
-* Baixe o código do i3Geo: https://softwarepublico.gov.br/gitlab/i3geo/i3geo/repository/archive.zip
+* Baixe o código do i3Geo:
+  https://softwarepublico.gov.br/gitlab/i3geo/i3geo/repository/archive.zip
 * Descompacte a pasta i3geo.git para dentro da pasta c:\ms4w\Apache\htdocs
-* Renomeie a pasta c:\ms4w\Apache\htdocs\i3geo.git para c:\ms4w\Apache\htdocs\i3geo
+* Renomeie a pasta c:\ms4w\Apache\htdocs\i3geo.git para
+  c:\ms4w\Apache\htdocs\i3geo
 * Teste o funcionamento digitando no navegador http://localhost/i3geo
 #### Segunda opção:
 * Instale o Git: https://git-for-windows.github.io/ utilizando as opções default.
-* Após a instalação, clique com o botão da direita sobre a pasta c:\ms4w\Apache\htdocs e escolha a opção "Git Bash Here"
+* Após a instalação, clique com o botão da direita sobre a pasta
+  c:\ms4w\Apache\htdocs e escolha a opção "Git Bash Here"
 * No terminal digite a sequência de comandos:
 ```
@@ -82,7 +109,8 @@ Não esqueça o PONTO no final da linha acima.
 Válido apenas se você não é um desenvolvedor do i3Geo e não tenha feito checkout via SSH.
-Clique com o botão da direita sobre a pasta c:\ms4w\Apache\htdocs\i3geo e escolha a opção "Git Bash Here"
+Clique com o botão da direita sobre a pasta c:\ms4w\Apache\htdocs\i3geo e
+escolha a opção "Git Bash Here"
 ```
 git stash
@@ -92,7 +120,8 @@ git stash pop
 Observação:
-* Pode ser que você precise registrar um usuário no Git antes de executar um stash. Para isso execute os seguintes comandos:
+* Pode ser que você precise registrar um usuário no Git antes de executar um
+  stash. Para isso execute os seguintes comandos:
 ```
 git config --global user.email seuemail@example.com
@@ -102,22 +131,34 @@ git config --global user.name &quot;Seu Nome&quot;
 ### PostGIS Windows (opcional)
-Para instalar o PostGIS siga o roteiro mostrado em http://postgis.net/windows_downloads
+Para instalar o PostGIS siga o roteiro mostrado em
+http://postgis.net/windows_downloads
-Instale também o pgAdmin, que é uma interface gráfica para o PostGIS: http://www.pgadmin.org/download/windows.php
+Instale também o pgAdmin, que é uma interface gráfica para o PostGIS:
+http://www.pgadmin.org/download/windows.php
-Caso deseje, carregue no PostGIS o banco de dados do i3GeoSaúde. Esse banco é utilizado em alguns dos tutoriais do i3Geo e pode servir de teste para uso com o SAIKU.
+Caso deseje, carregue no PostGIS o banco de dados do i3GeoSaúde. Esse banco é
+utilizado em alguns dos tutoriais do i3Geo e pode servir de teste para uso com o
+SAIKU.
-* Primeiro baixe o arquivo https://softwarepublico.gov.br/gitlab/i3geo/i3geosaude/raw/master/databasei3geosaude.backup
-* Abra o pgAdmin e crie uma nova conexão com o banco de dados. Em nome do host utilize "localhost" e o login e senha que você usou na istalação, normalmente "postgres".
-* Utilize as opções do pgAdmin para criar um novo banco de dados chamado i3geosaude. Ao criá-lo, utilize o banco de dados postgres como template e login e senha "postgres".
-* Clicando sobre o novo banco de dados, localize a opção "restore" e faça a carga do banco de dados que foi baixado no início.
+* Primeiro baixe o arquivo
+  https://softwarepublico.gov.br/gitlab/i3geo/i3geosaude/raw/master/databasei3geosaude.backup
+* Abra o pgAdmin e crie uma nova conexão com o banco de dados. Em nome do host
+  utilize "localhost" e o login e senha que você usou na istalação, normalmente
+  "postgres".
+* Utilize as opções do pgAdmin para criar um novo banco de dados chamado
+  i3geosaude. Ao criá-lo, utilize o banco de dados postgres como template e
+  login e senha "postgres".
+* Clicando sobre o novo banco de dados, localize a opção "restore" e faça a
+  carga do banco de dados que foi baixado no início.
 ## Linux (baseado em Ubuntu 14.04)
 Instale os softwares necesários para configurar o servidor web com PHP5, Mapserver e outros.
-Importante: versões mais novas do Ubuntu utilizam PHP7, nesses casos, siga os passos baseados no Ubuntu 16 (https://softwarepublico.gov.br/gitlab/i3geo/i3geo#linux-baseado-em-ubuntu-16).
+Importante: versões mais novas do Ubuntu utilizam PHP7, nesses casos, siga os
+passos baseados no Ubuntu 16
+(https://softwarepublico.gov.br/gitlab/i3geo/i3geo#linux-baseado-em-ubuntu-16).
 No terminal, digite a sequência de comandos abaixo.
@@ -144,7 +185,8 @@ sudo apt-get install r-base r-base-core r-cran-maptools
 sudo apt-get install php5-mbstring
 ```
-Em alguns casos a mbstring já é instalada junto com o PHP, por isso esse comando pode gerar mensagem de erro sem maiores consequências.
+Em alguns casos a mbstring já é instalada junto com o PHP, por isso esse comando
+pode gerar mensagem de erro sem maiores consequências.
 Lista de códigos EPSG, sua ausência faz com que os serviços WMS não funcionem.
@@ -169,9 +211,11 @@ Teste a instalação digitando no seu navegador web http://localhost
 ## Linux (baseado em Ubuntu 16)
-As versões mais recentes do Ubuntu utilizam como padrão o PHP 7, que é incompatível com o Mapserver e i3Geo.
+As versões mais recentes do Ubuntu utilizam como padrão o PHP 7, que é
+incompatível com o Mapserver e i3Geo.
-Nesses casos é necessário adicionar um repositório de código que contenha o PHP 5 e compilar o Mapserver, o que pode ser feito seguindo-se o roteiro:
+Nesses casos é necessário adicionar um repositório de código que contenha o PHP
+5 e compilar o Mapserver, o que pode ser feito seguindo-se o roteiro:
 Digite no terminal Linux:
@@ -220,7 +264,9 @@ service apache2 restart
 ### i3Geo Linux
-Para obter o código do i3Geo você tem duas opções, a primeira utiliza simplesmente o download de um arquivo e a segunda utiliza o Git. A vantagem da segunda opção é que você poderá atualizar sua instalação de forma mais fácil.
+Para obter o código do i3Geo você tem duas opções, a primeira utiliza
+simplesmente o download de um arquivo e a segunda utiliza o Git. A vantagem da
+segunda opção é que você poderá atualizar sua instalação de forma mais fácil.
 Após a instalação, digite no navegador web http://localhost/i3geo
@@ -245,18 +291,21 @@ Não esqueça o ponto no final da linha acima.
 ### Permissões
-Para uso local você pode modificar de forma mais liberal as permissões dos arquivos. No terminal digite:
+Para uso local você pode modificar de forma mais liberal as permissões dos
+arquivos. No terminal digite:
 ```
 sudo chmod -R 777 /var/www/html/i3geo
 sudo chmod -R 777 /var/www/html/ms_tmp
 ```
-Em ambiente de produção devem ser consideradas as orientações que constam no artigo sobre segurança (ver Wiki).
+Em ambiente de produção devem ser consideradas as orientações que constam no
+artigo sobre segurança (ver Wiki).
 ### Atualização do código (Ubuntu)
-Válido apenas se você não é um desenvolvedor do i3Geo e não tenha feito checkout via SSH.
+Válido apenas se você não é um desenvolvedor do i3Geo e não tenha feito checkout
+via SSH.
 Abra o terminal e digite os seguintes comandos (pode ser necessário usar `sudo`):
@@ -269,7 +318,8 @@ git stash pop
 Observação:
-* Pode ser que você precise registrar um usuário no Git antes de executar um stash. Para isso execute os seguintes comandos:
+* Pode ser que você precise registrar um usuário no Git antes de executar um
+  stash. Para isso execute os seguintes comandos:
 ```
 cd /var/www/html/i3geo
@@ -281,7 +331,8 @@ git config --global user.name &quot;Seu Nome&quot;
 Instale o PostgreSQL e PostGIS
-(dependendo da versão do PostgreSQL pode ser necessário alterar de 9.1 para a versão correta)
+(dependendo da versão do PostgreSQL pode ser necessário alterar de 9.1 para a
+versão correta)
 ```
 apt-get install postgresql postgis pgadmin3
@@ -292,11 +343,13 @@ service postgresql start
 Observações:
-* Dependendo da versão do PostgreSQL alguns comandos podem ser diferentes. Veja a pasta /usr/share/postgresql para descobrir a versão instalada)
+* Dependendo da versão do PostgreSQL alguns comandos podem ser diferentes. Veja
+  a pasta /usr/share/postgresql para descobrir a versão instalada)
 * Pode ser necessário o uso de sudo, exemplo: sudo su - postgres -c "createdb i3geosaude"
-* Você pode primeiro mudar para o usuário postgres e depois executar os comandos. Nesse caso utilize "sudo su postgres" e depois "psql"
+* Você pode primeiro mudar para o usuário postgres e depois executar os
+  comandos. Nesse caso utilize "sudo su postgres" e depois "psql"
 * Para sair de "psql" digite \d
@@ -306,7 +359,9 @@ Observações:
 * Para executar um arquivo SQL utilize "\i arquivo.sql"
-* Pode ser que ao final do processo, ele seja executado apesar de ter encontrado erros. Isso se deve a diferenças de versões do PostgreSQL e PostGIS, e pode ser ignorado.
+* Pode ser que ao final do processo, ele seja executado apesar de ter encontrado
+  erros. Isso se deve a diferenças de versões do PostgreSQL e PostGIS, e pode
+  ser ignorado.
 Comandos para instalação:
@@ -328,7 +383,10 @@ pg_restore --host localhost --port 5432 --username postgres --dbname i3geosaude 
 ## Chave utilizada pela API do GoogleMaps
-Devido às restrições de uso da API do GoogleMaps, é necessário registrar uma chave no site do Google para o seu endereço de servidor para que as funcionalidades do i3Geo que utilizam essa API funcionem. Veja como fazer em: http://code.google.com/apis/maps/signup.html.
+Devido às restrições de uso da API do GoogleMaps, é necessário registrar uma
+chave no site do Google para o seu endereço de servidor para que as
+funcionalidades do i3Geo que utilizam essa API funcionem. Veja como fazer em:
+http://code.google.com/apis/maps/signup.html.
 A chave deve ser incluída na variável $googleApiKey do arquivo i3geo/ms_configura.php.