Recuado texto

Fábio Ribeiro
1 parent c37bae54
Showing 1 changed file with 129 additions and 129 deletions Show diff stats
guia_de_migracao.md
@@ -169,215 +169,215 @@ i3GEO.arvoreDeTemas.OPCOESADICIONAIS.navegacaoDir = false;
 ## Para a versão 4.5
-	Os arquivos com as interfaces HTML dos diferentes mapas do i3Geo foram movidos do diretório
-	i3geo/aplicmap para o diretório i3geo/interface. Caso existam links apontando diretamente para
-	esses arquivos, vc pode simplesmente copiar os arquivos existentes na nova pasta (i3geo/interface)
-	para a antiga (i3geo/aplicmap).
+Os arquivos com as interfaces HTML dos diferentes mapas do i3Geo foram movidos do diretório
+i3geo/aplicmap para o diretório i3geo/interface. Caso existam links apontando diretamente para
+esses arquivos, vc pode simplesmente copiar os arquivos existentes na nova pasta (i3geo/interface)
+para a antiga (i3geo/aplicmap).
-	As variáveis de configuração $temasdir e $temasaplic foram removidas. Se vc desenvolveu programas em PHP,
-	no lugar dessas variáveis utilize $locaplic e o local fixo dos arquivos, por exemplo $locaplic."/temas"
-	e $locaplic."/aplicmap"
+As variáveis de configuração $temasdir e $temasaplic foram removidas. Se vc desenvolveu programas em PHP,
+no lugar dessas variáveis utilize $locaplic e o local fixo dos arquivos, por exemplo $locaplic."/temas"
+e $locaplic."/aplicmap"
-	A opção de administração com base em arquivos XML em disco foi removida. Agora, deve-se sempre utilizar o banco de dados
-	de admnistração.
+A opção de administração com base em arquivos XML em disco foi removida. Agora, deve-se sempre utilizar o banco de dados
+de admnistração.
-	O banco de dados de administração sofreu alterações. Veja em "Outras opções", no sistema de admnistração.
+O banco de dados de administração sofreu alterações. Veja em "Outras opções", no sistema de admnistração.
-	O arquivo admin.db (banco de dados de admnistração default) foi movido de i3geo/menutemas para i3geo/admin
+O arquivo admin.db (banco de dados de admnistração default) foi movido de i3geo/menutemas para i3geo/admin
-	O "alias" para a interface "zerocal" foi removido, utilize em seu lugar:
-	http://localhost/i3geo/ms_criamapa.php?interface=zerocal.htm ou
-	http://localhost/i3geo/interface/zerocal.htm
+O "alias" para a interface "zerocal" foi removido, utilize em seu lugar:
+http://localhost/i3geo/ms_criamapa.php?interface=zerocal.htm ou
+http://localhost/i3geo/interface/zerocal.htm
-	A pasta "images" foi removida e as imagens movidas para a pasta "imagens\depreciado"
+A pasta "images" foi removida e as imagens movidas para a pasta "imagens\depreciado"
-	Opção de comentários em temas
-		Foram acrescentadas novas variáveis em ms_configura.php. Veja esse arquivo para editar as variáveis e registrar
-		as APIs das redes sociais como Twitter e Facebook
-		Por default, todos os temas agora podem receber comentários. Para bloquear comentários em temas específicos,
-		utilize o editor de mapfiles do sistema de admnistração para bloquear essa opção em cada tema
-		Os comentários são armazenados em uma tabela no banco de dados de administração. Essa tabela precisa ser criada no banco.
-		Para criar a tabela veja o item "Outras opções" em http://localhost/i3geo/admin
+Opção de comentários em temas
+	Foram acrescentadas novas variáveis em ms_configura.php. Veja esse arquivo para editar as variáveis e registrar
+	as APIs das redes sociais como Twitter e Facebook
+	Por default, todos os temas agora podem receber comentários. Para bloquear comentários em temas específicos,
+	utilize o editor de mapfiles do sistema de admnistração para bloquear essa opção em cada tema
+	Os comentários são armazenados em uma tabela no banco de dados de administração. Essa tabela precisa ser criada no banco.
+	Para criar a tabela veja o item "Outras opções" em http://localhost/i3geo/admin
-	Contagem do número de acessos de cada tema
-		Foi criada uma nova tabela no sistema de administração para guardar o número de vezes que um tema é acessado. Antes
-		a contagem era mantida na tabela i3geoadmin_temas, cuja coluna nacessos foi depreciada. Essa nova tabela guarda também o dia do acesso.
-		Para criar a tabela veja o item "Outras opções" em http://localhost/i3geo/admin
+Contagem do número de acessos de cada tema
+	Foi criada uma nova tabela no sistema de administração para guardar o número de vezes que um tema é acessado. Antes
+	a contagem era mantida na tabela i3geoadmin_temas, cuja coluna nacessos foi depreciada. Essa nova tabela guarda também o dia do acesso.
+	Para criar a tabela veja o item "Outras opções" em http://localhost/i3geo/admin
-	O nome dos arquivos js e ccs compactados foram renomeados, incluindo o valor da versão no final. Isso foi feito para se
-	evitar problemas de cache de versões antigas. Os arquivos renomeados foram:
-		classesjs/i3geo_tudo_compacto45.js
-		css/i3geo_ferramentas45.css
+O nome dos arquivos js e ccs compactados foram renomeados, incluindo o valor da versão no final. Isso foi feito para se
+evitar problemas de cache de versões antigas. Os arquivos renomeados foram:
+	classesjs/i3geo_tudo_compacto45.js
+	css/i3geo_ferramentas45.css
-	Testado o uso de zlib.output_compression = On no php.ini
+Testado o uso de zlib.output_compression = On no php.ini
-	Variáveis ou funções removidas
-		i3GEO.interface (utilize i3GEO.Interface, com "I" maiúsculo)
-		g_postpx
-		g_tipotop
-		g_tipoleft
+Variáveis ou funções removidas
+	i3GEO.interface (utilize i3GEO.Interface, com "I" maiúsculo)
+	g_postpx
+	g_tipotop
+	g_tipoleft
-	A inicialização da interface Google Earth (interface/googleearth.phtml) foi incluida na tag "body":
-		<body id="i3geo" onload='i3GEO.inicia();'>
+A inicialização da interface Google Earth (interface/googleearth.phtml) foi incluida na tag "body":
+	<body id="i3geo" onload='i3GEO.inicia();'>
-	e-mail institucional (incluido no arquivo de correções SP7)
-		em ms_configura.php pode ser definido um e-mail padrão que é utilizado nas interfaces dos mapas
-		Para que o e-mail definido seja mostrado, é necessário adicionar um elemento HTML com id=emailInstituicao no mapa
+e-mail institucional (incluido no arquivo de correções SP7)
+	em ms_configura.php pode ser definido um e-mail padrão que é utilizado nas interfaces dos mapas
+	Para que o e-mail definido seja mostrado, é necessário adicionar um elemento HTML com id=emailInstituicao no mapa
 ## Para a versão 4.4
-	Verifique se o PHP está configurado (php.ini) para permitir a passagem de parâmetros por referência
-	(dependendo da versão do PHP, esse parâmetro é definido como "Off" por default):
-	allow_call_time_pass_reference = On
+Verifique se o PHP está configurado (php.ini) para permitir a passagem de parâmetros por referência
+(dependendo da versão do PHP, esse parâmetro é definido como "Off" por default):
+allow_call_time_pass_reference = On
-	Foi acrescentado um novo LAYER em i3geo/aplicmp/geral1.map e geral1windows.map com dados do Open Street Map. Caso vc não
-	queira que essa camada nova apareça, basta removê-las desses arquivos.
+Foi acrescentado um novo LAYER em i3geo/aplicmp/geral1.map e geral1windows.map com dados do Open Street Map. Caso vc não
+queira que essa camada nova apareça, basta removê-las desses arquivos.
-	Foi incluida a remoção de cookies no ms_criamapa.php, que inicializa o i3geo ($_COOKIE = array();). Se vc precisa definir cookies,
-	considere a necessidade de comentar a linha de código do ms_criamapa.php.
+Foi incluida a remoção de cookies no ms_criamapa.php, que inicializa o i3geo ($_COOKIE = array();). Se vc precisa definir cookies,
+considere a necessidade de comentar a linha de código do ms_criamapa.php.
-	Por default, o i3Geo passou a usar a interface openlayers.htm. Se vc quiser modificar isso, altere o ms_configura.php.
+Por default, o i3Geo passou a usar a interface openlayers.htm. Se vc quiser modificar isso, altere o ms_configura.php.
 ## Para a versão 4.3
-	O banco de dados de administração sofreu as seguintes alterações (vc deve incluir as novas colunas
-	para que o i3Geo funcione corretamente:
+O banco de dados de administração sofreu as seguintes alterações (vc deve incluir as novas colunas
+para que o i3Geo funcione corretamente:
-	- acréscimo das colunas en,es,it nas tabelas (tipo texto)
-		i3geoadmin_menus
-		i3geoadmin_temas
-		i3geoadmin_grupos
-		i3geoadmin_subgrupos
+- acréscimo das colunas en,es,it nas tabelas (tipo texto)
+	i3geoadmin_menus
+	i3geoadmin_temas
+	i3geoadmin_grupos
+	i3geoadmin_subgrupos
-	- acréscimo da coluna kmz_tema em i3geoadmin_temas (tipo texto)
+- acréscimo da coluna kmz_tema em i3geoadmin_temas (tipo texto)
-	Foi incluida uma nova opção que permite ao usuário alterar o SQL que faz o acesso aos dados em
-	um LAYER (elemento DATA do mapfile). Mostrar ou não essa opção é controlado por um metadata
-	em cada LAYER. Por default, o i3Geo entende que esse metadata é marcado como SIM. Se vc não quer
-	que o usuário possa acessar essa funcionalidade, utilize o sistema de administração para editar
-	esse metadata de cada LAYER presente em um mapfile ou então, inclua o metadata "editorsql" "nao".
+Foi incluida uma nova opção que permite ao usuário alterar o SQL que faz o acesso aos dados em
+um LAYER (elemento DATA do mapfile). Mostrar ou não essa opção é controlado por um metadata
+em cada LAYER. Por default, o i3Geo entende que esse metadata é marcado como SIM. Se vc não quer
+que o usuário possa acessar essa funcionalidade, utilize o sistema de administração para editar
+esse metadata de cada LAYER presente em um mapfile ou então, inclua o metadata "editorsql" "nao".
 ## Para a versão 4.1
 Sistema de administração
-	A administração do i3geo pode ser feita através de um sistema de formulários  web desde que vc opte por isso.
+A administração do i3geo pode ser feita através de um sistema de formulários  web desde que vc opte por isso.
-	Se vc quiser continuar usando os arquivos XML existentes em i3geo/menutemas, não tem problema, mas nesse
-	caso o sistema de administração não lhe será útil.
+Se vc quiser continuar usando os arquivos XML existentes em i3geo/menutemas, não tem problema, mas nesse
+caso o sistema de administração não lhe será útil.
-	A opção pelo uso do sistema de administração é default na versão 4.1. Se vc não quiser usá-la, deverá
-	editar o arquivo i3geo/ms_configura.php e colocar os nomes dos arquivos XML nas opções desejadas. Esse
-	arquivo está documentado, basta ler para entender o que deve ser feito.
+A opção pelo uso do sistema de administração é default na versão 4.1. Se vc não quiser usá-la, deverá
+editar o arquivo i3geo/ms_configura.php e colocar os nomes dos arquivos XML nas opções desejadas. Esse
+arquivo está documentado, basta ler para entender o que deve ser feito.
-	O sistema de administração é acessível no endereço i3geo/admin (http://localhost/i3geo/admin). Apenas editores
-	cadastrados podem usar esse sistema. O cadastramento é feito por número IP (veja i3geo/ms_configura.php).
-	Por default, "localhost" é um editor cadastrado.
+O sistema de administração é acessível no endereço i3geo/admin (http://localhost/i3geo/admin). Apenas editores
+cadastrados podem usar esse sistema. O cadastramento é feito por número IP (veja i3geo/ms_configura.php).
+Por default, "localhost" é um editor cadastrado.
-	Os arquivos mapfiles existentes em i3geo/temas continuam sendo necessários e vc pode editá-los manualmente
-	ou por meio do sistema de administração.
+Os arquivos mapfiles existentes em i3geo/temas continuam sendo necessários e vc pode editá-los manualmente
+ou por meio do sistema de administração.
-	Os arquivos XML que vc já possuí em i3geo/menutemas devem ser importados para o sistema de administração.
-	Utilize as opções existentes em i3geo/admin para fazer isso.
+Os arquivos XML que vc já possuí em i3geo/menutemas devem ser importados para o sistema de administração.
+Utilize as opções existentes em i3geo/admin para fazer isso.
-	O banco de dados default do i3geo é em SQLITE e fica em i3geo/menutemas/admin.db.
-	Vc deve apagar esse arquivo e criar outro antes de importar seus arquivos XML. No sistema de administração
-	existe uma opção para criar o banco, o que deve ser feito depois que vc apagar o arquivo que vai com o i3geo.
+O banco de dados default do i3geo é em SQLITE e fica em i3geo/menutemas/admin.db.
+Vc deve apagar esse arquivo e criar outro antes de importar seus arquivos XML. No sistema de administração
+existe uma opção para criar o banco, o que deve ser feito depois que vc apagar o arquivo que vai com o i3geo.
-	Se vc não quiser usar o SQLITE vc deve criar um arquivo de conexão com seu banco de dados e registrar o endereço
-	desse arquivo em uma variável no i3geo/ms_configura.php. Um exemplo de arquivo de configuração para POSTGRE
-	pode ser visto em i3geo/admin/php/conexaomm.php. Ao usar a opção de criação do banco existente no sistema
-	de administração, as tabelas serão criadas no banco de dados indicado.
+Se vc não quiser usar o SQLITE vc deve criar um arquivo de conexão com seu banco de dados e registrar o endereço
+desse arquivo em uma variável no i3geo/ms_configura.php. Um exemplo de arquivo de configuração para POSTGRE
+pode ser visto em i3geo/admin/php/conexaomm.php. Ao usar a opção de criação do banco existente no sistema
+de administração, as tabelas serão criadas no banco de dados indicado.
 PHP
-	O sistema de administração do i3geo é baseado na biblioteca PHP chamada "PDO". Nas versões mais recentes do
-	PHP e no MS4W essa biblioteca já vem habilitada. Se no seu PHP não existir o PDO vc deverá instalá-lo.
+O sistema de administração do i3geo é baseado na biblioteca PHP chamada "PDO". Nas versões mais recentes do
+PHP e no MS4W essa biblioteca já vem habilitada. Se no seu PHP não existir o PDO vc deverá instalá-lo.
 YAHOO
-	A bibblioteca do YAHOO (YUI) foi atualizada. A versão antiga continua em i3geo/pacotes. Se vc desenvolveu
-	programas baseados na versão antiga, é bom verificar se tudo funcionará corretamente pois o arquivo
-	i3geo/classesjs/i3geo.js agora utiliza essa nova versão da YUI.
+A bibblioteca do YAHOO (YUI) foi atualizada. A versão antiga continua em i3geo/pacotes. Se vc desenvolveu
+programas baseados na versão antiga, é bom verificar se tudo funcionará corretamente pois o arquivo
+i3geo/classesjs/i3geo.js agora utiliza essa nova versão da YUI.
 JSOBJECTS
-	Essa biblioteca não será mais utilizada pelo i3geo, sendo substituída pelo YUI. Se vc utilizava as funcionalidades
-	dessa biblioteca, embutida no i3geo.js, deverá verificar seu código ou então embutir novamente essa
-	biblioteca no i3geo.js. Para isso vc deve alterar o programa i3geo/classesjs/compactajs.php e executá-lo
-	para gerar os arquivos compactados do i3geo.
+Essa biblioteca não será mais utilizada pelo i3geo, sendo substituída pelo YUI. Se vc utilizava as funcionalidades
+dessa biblioteca, embutida no i3geo.js, deverá verificar seu código ou então embutir novamente essa
+biblioteca no i3geo.js. Para isso vc deve alterar o programa i3geo/classesjs/compactajs.php e executá-lo
+para gerar os arquivos compactados do i3geo.
 Classes JS e namespaces
-	O modelo de desenvolvimento dos programas javascript estão sendo migrados aos poucos para estruturas
-	baseadas em classes. Isso facilitará a compreensão dos códigos e sua documentação, facilitando a vida
-	dos desenvolvedores e permitindo uma melhor evolução dos códigos.
+O modelo de desenvolvimento dos programas javascript estão sendo migrados aos poucos para estruturas
+baseadas em classes. Isso facilitará a compreensão dos códigos e sua documentação, facilitando a vida
+dos desenvolvedores e permitindo uma melhor evolução dos códigos.
-	As classes desenvolvidas ficarão em arquivos únicos de cada classe e devem usar o namespace i3GEO. Essa
-	regra evitará conflitos entre bibliotecas javascript adicionadas ao i3geo.
-	Exemplo, para remover a acentuação de uma palavra vc pode usar a classe i3GEO.util:
+As classes desenvolvidas ficarão em arquivos únicos de cada classe e devem usar o namespace i3GEO. Essa
+regra evitará conflitos entre bibliotecas javascript adicionadas ao i3geo.
+Exemplo, para remover a acentuação de uma palavra vc pode usar a classe i3GEO.util:
-	var palavraAcentuada = "coração";
-	var palavraSemAcento = i3GEO.util.removeAcentos(palavraAcentuada);
+var palavraAcentuada = "coração";
+var palavraSemAcento = i3GEO.util.removeAcentos(palavraAcentuada);
 Googlemaps
-	A chave de registro da API do Google agora deve ser incluída no arquivo i3geo/ms_configura.php na
-	variável $googleApiKey.
+A chave de registro da API do Google agora deve ser incluída no arquivo i3geo/ms_configura.php na
+variável $googleApiKey.
-	Isso foi necessário porque a API do Google será utilizada em outras ferramentas do i3geo.
+Isso foi necessário porque a API do Google será utilizada em outras ferramentas do i3geo.
-	A ferramenta googlemaps agora é chamada com ferramentas/googlemaps/index.php
+A ferramenta googlemaps agora é chamada com ferramentas/googlemaps/index.php
 Idiomas
-	A lista de palavras e suas traduções foram retiradas do arquivo i3geo/classesjs/configura.js e incluidas no
-	novo arquivo i3geo/classesjs/dicionario.js
+A lista de palavras e suas traduções foram retiradas do arquivo i3geo/classesjs/configura.js e incluidas no
+novo arquivo i3geo/classesjs/dicionario.js
-	Foi criada uma classe específica para manipular a internacionalização. Veja a documentação em
-	http://localhost/i3geo/documentacao/files/classesjs/classe_idioma-js.html
+Foi criada uma classe específica para manipular a internacionalização. Veja a documentação em
+http://localhost/i3geo/documentacao/files/classesjs/classe_idioma-js.html
 Árvore de temas
-	A árvore de temas, que aparece na guia "Mapa", agora é montada com a biblioteca YUI. Foi criada uma classe
-	javascript específica para manipular essa árvore. Veja a documentação em
-	http://localhost/i3geo/documentacao/files/classesjs/classe_arvoredecamadas-js.html
-	Os aplicativos que usam árvores também utilizam agora essa classe, como o i3geo/datadownload.htm
+A árvore de temas, que aparece na guia "Mapa", agora é montada com a biblioteca YUI. Foi criada uma classe
+javascript específica para manipular essa árvore. Veja a documentação em
+http://localhost/i3geo/documentacao/files/classesjs/classe_arvoredecamadas-js.html
+Os aplicativos que usam árvores também utilizam agora essa classe, como o i3geo/datadownload.htm
 Árvore de camadas
-	A árvore de camadas, que aparece na guia "+ temas", agora é montada com a biblioteca YUI. Foi criada uma classe
-	javascript específica para manipular essa árvore. Veja a documentação em
-	http://localhost/i3geo/documentacao/files/classesjs/classe_arvoredetemas-js.html
+A árvore de camadas, que aparece na guia "+ temas", agora é montada com a biblioteca YUI. Foi criada uma classe
+javascript específica para manipular essa árvore. Veja a documentação em
+http://localhost/i3geo/documentacao/files/classesjs/classe_arvoredetemas-js.html
 Utilitários
-	Foi criada uma classe específica com funções de uso geral. Veja em:
-	http://localhost/i3geo/documentacao/files/classesjs/classe_util-js.html
+Foi criada uma classe específica com funções de uso geral. Veja em:
+http://localhost/i3geo/documentacao/files/classesjs/classe_util-js.html
 Cálculos
-	Os cálculos agora estão na classe i3GEO.calculo, por exemplo, para converter coordenadas de dd para dms, utilize:
-	i3GEO.calculo.dd2dms(dd)
+Os cálculos agora estão na classe i3GEO.calculo, por exemplo, para converter coordenadas de dd para dms, utilize:
+i3GEO.calculo.dd2dms(dd)
 objmapa
-	A forma de inicialização do i3geo do lado do navegador (javascript) agora é controlado pela classe i3GEO.
-	O "objmapa" não é mais utilizado.
-	Os parâmetros do mapa, como extensão geográfica, tamanho do pixel, etc, são agora acessados por meio
-	de i3GEO.parametros, por exemplo, para obter a extensão geográfica do mapa atual, utilize:
-	alert(i3GEO.parametros.mapexten)
-	A lista completa de i3GEO.parametros pode ser vista em i3geo/classesjs/classe_i3geo.js
+A forma de inicialização do i3geo do lado do navegador (javascript) agora é controlado pela classe i3GEO.
+O "objmapa" não é mais utilizado.
+Os parâmetros do mapa, como extensão geográfica, tamanho do pixel, etc, são agora acessados por meio
+de i3GEO.parametros, por exemplo, para obter a extensão geográfica do mapa atual, utilize:
+alert(i3GEO.parametros.mapexten)
+A lista completa de i3GEO.parametros pode ser vista em i3geo/classesjs/classe_i3geo.js
 Variáveis de configuração
-	Muitas das novas classes possuem seus próprios métodos de configuração. Porém os parâmetros principais
-	de configuração do mapa ficam agora na classe i3GEO.configura
-	Por exemplo, para obter o diretório onde o i3geo está instalado, antes utilizava-se g_locaplic, agora utiliza-se
-	i3GEO.configura.locaplic
+Muitas das novas classes possuem seus próprios métodos de configuração. Porém os parâmetros principais
+de configuração do mapa ficam agora na classe i3GEO.configura
+Por exemplo, para obter o diretório onde o i3geo está instalado, antes utilizava-se g_locaplic, agora utiliza-se
+i3GEO.configura.locaplic
 Chamada aos programas PHP
-	Todas as chamadas a programas PHP via AJAX foram concentradas na classe classe_php.js.
+Todas as chamadas a programas PHP via AJAX foram concentradas na classe classe_php.js.