Patches for pt-br translation
Leonardo Lara Rodrigues <[email protected]>
| Newsgroups | gmane.comp.apache.documentation |
|---|---|
| Message-ID | <CAJ5z2Y7Q92BUCpmdR=s30aJfu3VWVxWPV07-OmOiuh29tNngeA@mail.gmail.com> |
Greetings! This is my first contribution to httpd docs. My goal is to have all the manuals (2.4 and trunk) translated to pt-br in the near future. Find attached some initial patches for httpd pt-br docs translation. They also change the encoding to UTF-8. These are all for the 2.4.x branch only. docs/manual/howto/htaccess.xml.pt-br -> htaccess.xml.pt-br.patch docs/manual/index.xml.pt-br -> index.xml.pt-br.patch docs/manual/new_features_2_0.xml.pt-br -> new_features_2_0.xml.pt-br.patch docs/manual/new_features_2_2.xml.pt-br -> new_features_2_2.xml.pt-br.patch docs/manual/style/lang/pt-br.xml -> pt-br.xml.patch docs/manual/style/lang-targets.xml -> lang-targets.xml.patch docs/manual/style/manual.pt-br.xsl -> manual.pt-br.xsl.patch docs/manual/style/xsl/util/designations.xml > designations.xml.patch Let me know if this is the best format for this kind of patch e-mail. If not, please send me an example of best practices. Thanks, Leonardo Lara. --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
lang-targets.xml.patch
(text/x-diff, 675 B)
Index: docs/manual/style/lang-targets.xml
===================================================================
--- docs/manual/style/lang-targets.xml (revision 1933906)
+++ docs/manual/style/lang-targets.xml (working copy)
@@ -197,7 +197,7 @@
<!-- Portuguese -->
<!-- ==================================================================== -->
<property value=".xml.pt-br" name="inputext.pt-br"/>
-<property value=".html.pt-br" name="outputext.pt-br"/>
+<property value=".html.pt-br.utf8" name="outputext.pt-br"/>
<target description="- builds Portuguese HTML files" name="pt-br">
<html.generic lang="pt-br"/>
pt-br.xml.patch
(text/x-diff, 11.6 KB)
Index: docs/manual/style/lang/pt-br.xml
===================================================================
--- docs/manual/style/lang/pt-br.xml (revision 1933906)
+++ docs/manual/style/lang/pt-br.xml (working copy)
@@ -1,7 +1,7 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
+<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE language SYSTEM "../lang.dtd">
-<!-- English Revision: 333005 -->
-
+<!-- English Revision: 1919773 -->
+<!-- Portuguese(BR) translation: leonardolara --><!-- Reviewed by: leonardolara -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
@@ -21,86 +21,88 @@
<language id="pt-br">
<name>Portuguese</name>
- <charset>ISO-8859-1</charset>
+ <charset>UTF-8</charset>
<source-ext>.xml.pt-br</source-ext>
- <target-ext>.html.pt-br</target-ext>
+ <target-ext>.html.pt-br.utf8</target-ext>
- <!-- no sitemap yet
- <chm>
+ <!-- <chm>
<lang>0x416 Portuguese (Brazil)</lang>
<toc-font>,8,0</toc-font>
<charset>windows-1252</charset>
<settings>Portuguese (Brazil)</settings>
- </chm>
- -->
+ </chm> -->
- <!-- only English ATM
- <man>
+ <!-- only English ATM <man>
<charset>ISO-8859-1</charset>
- </man>
- -->
+ </man> -->
<!-- Some strings might be used in other contexts, than stated in the -->
<!-- comments... -->
<messages>
<!-- language link titles -->
- <message id="nativename">Português (Brasil)</message>
+ <message id="nativename">Português (Brasil)</message>
<!-- Used for the moduleindex -->
- <message id="corefeatures">Principais Funcionalidades e Módulos de Multi-Processos (MPM)</message>
- <message id="othermodules">Outros Módulos</message>
- <message id="obsoletemodules">Módulos Obsoletos</message>
+ <message id="corefeatures">Principais Funcionalidades e Módulos de
+ Multi-Processos (MPM)</message>
+ <message id="othermodules">Outros Módulos</message>
+ <message id="obsoletemodules">Módulos Obsoletos</message>
<!-- Used for the modulesynopsis and sitemap -->
- <message id="obsoleteapachemodule">Módulo Obsoleto Apache</message>
- <message id="apachemodule">Módulo Apache</message>
- <message id="apachecore">Principais Funcionalidades do Apache</message>
- <message id="apachempmcommon">Diretrizes Comuns Apache MPM</message>
+ <message id="obsoleteapachemodule">Módulo Obsoleto do Apache</message>
+ <message id="apachemodule">Módulo do Apache</message>
+ <message id="apachecore">Funcionalidades do Núcleo do Apache</message>
+ <message id="apachempmcommon">Diretrizes Comuns do Apache MPM</message>
<message id="apachempm">Apache MPM</message>
<!-- Used in description box for modulesynopsis -->
- <message id="description">Descrição</message>
- <message id="seealso">Veja também</message>
- <message id="topics">Tópicos</message>
+ <message id="description">Descrição</message>
+ <message id="seealso">Veja também</message>
+ <message id="topics">Tópicos</message>
<message id="status">Status</message>
- <message id="moduleidentifier">Identificador de Módulo</message>
+ <message id="moduleidentifier">Identificador de Módulo</message>
<message id="sourcefile">Arquivo Fonte</message>
<message id="compatibility">Compatibilidade</message>
- <message id="before-since">Available in Apache HTTP Server </message>
- <message id="after-since"> and later.</message>
+ <message id="before-since">DisponÃvel no Servidor Apache HTTP </message>
+ <message id="after-since"> e posteriores.</message>
<!-- Used in manualpage -->
- <message id="relatedmodules">Módulos Relacionados</message>
+ <message id="relatedmodules">Módulos Relacionados</message>
<message id="relateddirectives">Diretrizes Relacionadas</message>
- <message id="foundabug">Bugfix checklist</message>
- <message id="httpdchangelog">httpd changelog</message>
- <message id="httpdknownissues">Known issues</message>
- <message id="httpdreportabug">Report a bug</message>
+ <message id="lowercase">abcdefghijklmnopqrstuvwxyz</message>
+ <message id="uppercase">ABCDEFGHIJKLMNOPQRSTUVWXYZ</message>
+ <message id="name-section">NOME</message>
+ <message id="hyphenation"></message>
+ <message id="foundabug">Lista de verificação de bugs</message>
+ <message id="httpdchangelog">registro de alterações do httpd</message>
+ <message id="httpdknownissues">Problemas conhecidos</message>
+ <message id="httpdreportabug">Relate um problema</message>
<!-- Used in description box for directives -->
<message id="syntax">Sintaxe</message>
- <message id="default">Padrão</message>
+ <message id="default">Padrão</message>
<message id="context">Contexto</message>
<message id="override">Sobrescreve</message>
<message id="status">Status</message>
- <message id="module">Módulo</message>
+ <message id="module">Módulo</message>
<!-- Status descriptions -->
<message id="base" letter="B">Base</message>
<message id="mpm" letter="M">MPM</message>
- <message id="core" letter="C">Core</message>
- <message id="extension" letter="E">Extension</message>
+ <message id="core" letter="C">Núcleo</message>
+ <message id="extension" letter="E">Extensão</message>
<message id="experimental" letter="X">Experimental</message>
- <message id="external" letter="T">External</message>
+ <message id="external" letter="T">Externo</message>
<!-- Used in directive context lists -->
- <message id="serverconfig" letter="s">configuração do servidor</message>
- <message id="virtualhost" letter="v">hospedeiro virtual</message>
- <message id="directory" letter="d">diretório</message>
+ <message id="serverconfig" letter="s">configuração do servidor</message>
+ <message id="virtualhost" letter="v">host virtual</message>
+ <message id="directory" letter="d">diretório</message>
<message id="htaccess" letter="h">.htaccess</message>
+ <message id="proxy" letter="p">seção de proxy</message>
<!-- Used for directive lists -->
- <message id="directives">Diretrizes</message>
+ <message id="directives">Diretivas</message>
<!-- the optional attribute replace-space-with takes a string.
if present, the space between <directive name> and 'Directive'
in directivesynopsis headings will be replaced by the given string.
@@ -108,57 +110,58 @@
<!-- the optional attribute before-name takes a string.
if "yes", the 'Directive' word is place before the name instead of
being placed behind. See fr.xml for an example. -->
- <message id="directive">Diretrizes</message>
- <message id="nodirectives">Esse módulo não fornece nenhuma diretriz.</message>
+ <message id="directive">Diretiva</message>
+ <message id="nodirectives">Este módulo não fornece nenhuma
+ diretiva.</message>
<!-- Used in summaries -->
- <message id="summary">Sumário</message>
+ <message id="summary">Sumário</message>
<!-- Used for glossary link titles -->
- <message id="glossarylink">ver glossário</message>
+ <message id="glossarylink">ver glossário</message>
<!-- Used in headers and footers -->
<message id="apachetitle">- Servidor HTTP Apache</message>
- <message id="apachehttpserver">Servidor HTTP Apache Versão
+ <message id="apachehttpserver">Servidor HTTP Apache Versão
&httpd.major;.&httpd.minor;</message>
- <message id="apachedocalt">[DOCUMENTAÇÃO APACHE]</message>
+ <message id="apachedocalt">[DOCUMENTAÃÃO APACHE]</message>
<message id="search">Busca Google</message> <!-- search button -->
- <message id="index">Índice</message> <!-- deprecated -->
- <message id="home">Início</message> <!-- deprecated -->
- <message id="comments">Comentários</message>
+ <message id="index">Ãndice</message> <!-- deprecated -->
+ <message id="home">InÃcio</message> <!-- deprecated -->
+ <message id="comments">Comentários</message>
<!-- breadcrumb links -->
<message id="apache">Apache</message>
<message id="http-server">Servidor HTTP</message>
- <message id="documentation">Documentação</message>
- <message id="version">Versão &httpd.major;.&httpd.minor;</message>
+ <message id="documentation">Documentação</message>
+ <message id="version">Versão &httpd.major;.&httpd.minor;</message>
<!-- super menu -->
- <message id="modules">Módulos</message>
- <message id="faq">FAQ</message>
- <message id="glossary">Glossário</message>
- <message id="sitemap">Mapa do site</message>
+ <message id="modules">Módulos</message>
+ <message id="faq">Perguntas Frequentes</message>
+ <message id="glossary">Glossário</message>
+ <message id="sitemap">Mapa do Site</message>
<!-- footer line -->
<message id="before-license">Licenciado sob a</message>
<message id="after-license"></message>
- <message id="langavail">Línguas Disponíveis</message>
+ <message id="langavail">LÃnguas DisponÃveis</message>
<!-- not up to date -->
- <message id="outofdate">Esta tradução pode estar desatualizada.
- Confira a versão em Inglês para mudanças recentes.</message>
+ <message id="outofdate">Esta tradução pode estar desatualizada.
+ Confira a versão em inglês para mudanças recentes.</message>
<!-- directive not translated yet -->
- <message id="nottranslated">The documentation for this directive has
- not been translated yet. Please have a look at the English
- version.</message>
+ <message id="nottranslated">A documentação para esta diretiva ainda
+ não foi traduzida. Por favor consulte a versão
+ em inglês.</message>
<!-- retirement -->
- <message id="retired.headline">Please note</message>
+ <message id="retired.headline">Favor observar</message>
<message id="retired.description">
- <p>This document refers to the <strong>2.0</strong> version of Apache httpd, which <strong>is no longer maintained</strong>. Upgrade, and refer to the current version of httpd instead, documented at:</p>
+ <p>Este documento refere-se à versão <strong>2.0</strong> do Apache httpd, que <strong>não é mais mantida</strong>. Atualize e refira-se à versão atual do httpd, documentada em:</p>
</message>
- <message id="retired.current">Current release version of Apache HTTP Server documentation</message>
- <message id="retired.document">You may follow <link>this link</link> to go to the current version of this document.</message>
+ <message id="retired.current">Versão atual da documentação do Servidor HTTP Apache</message>
+ <message id="retired.document">Siga <link>este atalho</link> para a versão atual deste documento.</message>
</messages>
</language>
new_features_2_2.xml.pt-br.patch
(text/x-diff, 16.9 KB)
Index: docs/manual/new_features_2_2.xml.pt-br
===================================================================
--- docs/manual/new_features_2_2.xml.pt-br (revision 1933906)
+++ docs/manual/new_features_2_2.xml.pt-br (working copy)
@@ -1,8 +1,8 @@
-<?xml version='1.0' encoding='UTF-8' ?>
+<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="./style/manual.pt-br.xsl"?>
-<!-- English Revision: 151408:1933503 (outdated) -->
-
+<!-- English Revision: 1933503 -->
+<!-- Portuguese(BR) translation: leonardolara --><!-- Reviewed by: leonardolara -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
@@ -22,107 +22,245 @@
<manualpage metafile="new_features_2_2.xml.meta">
-<title>Descrição das novas funcionalidades do Apache 2.2</title>
+<title>Visão geral das novas funcionalidades no Servidor HTTP Apache 2.2</title>
<summary>
- <p>Esse documento descreve algumas das principais mudanças
- entre as versões 2.0 e 2.2 do Servidor HTTP Apache.
- Para a lista de mudanças desde a versão 1.3, veja a página
- de documentação <a href="new_features_2_0.html">novas funcionalidades
- do Apache 2.0</a>.</p>
+ <p>Este documento descreve algumas das principais mudanças entre as
+ versões 2.0 e 2.2 do servidor HTTP Apache. Para obter informações sobre os novos
+ recursos desde a versão 1.3, consulte o documento <a href="new_features_2_0.html">Novos
+ recursos da versão 2.0</a>.</p>
</summary>
<section id="core">
- <title>Principais Melhorias</title>
+ <title>Melhorias do Núcleo</title>
<dl>
<dt>Authn/Authz</dt>
- <dd>...</dd>
+ <dd>Os módulos de autenticação e autorização incluídos foram
+ refatorados. O novo módulo mod_authn_alias (já removido das versões 2.3/2.4)
+ pode simplificar bastante certas configurações de autenticação.
+ Consulte <a href="#module">alterações nos nomes dos módulos</a> e
+ as <a href="#developer">alterações para desenvolvedores</a> para obter mais
+ informações sobre como essas alterações afetam usuários e
+ desenvolvedores de módulos.</dd>
- <dt>Caching</dt>
- <dd>...</dd>
+ <dt>Cache</dt>
+ <dd><module>mod_cache</module>, <module>mod_cache_disk</module> e
+ mod_mem_cache (já removido das versões 2.3/2.4) tiveram muitas mudanças e
+ agora são considerados de qualidade de produção. <program>htcacheclean</program>
+ foi introduzido para limpar as configurações de
+ <module>mod_cache_disk</module>.</dd>
- <dt>Proxying</dt>
- <dd>O novo módulo <module>mod_proxy_balancer</module> fornece
- serviços de carregamento de balenceamento para <module
- >mod_proxy</module>. O novo módulo <module>mod_proxy_ajp</module
- > oferece suporte para o <code>Protocolo Apache JServ
- versão 1.3</code>, usado pelo <a
- href="http://tomcat.apache.org/">Apache Tomcat</a>.</dd>
+ <dt>Configuração</dt>
+ <dd>O layout de configuração padrão foi simplificado e
+ modularizado. Trechos de configuração que podem ser usados para
+ habilitar recursos comumente utilizados agora estão incluídos no Apache e
+ podem ser facilmente adicionados à configuração principal do servidor.</dd>
- <dt>Filtragem Inteligente (Smart Filtering)</dt>
- <dd>O <module>mod_filter</module> introduz configuração dinâmica para
- o filtro de saída de dados. Permitindo que os filtros sejam
- condicionalmente inseridos, baseando-se nos cabeçalhos <em
- >Request</em> ou <em>Response</em> ou em variáveis do
- ambiente, ele acaba com os problemas de dependências e pedidos
- da arquitetura 2.0.</dd>
+ <dt>Parada graciosa</dt>
+ <dd>Os MPMs <module>prefork</module>, <module>worker</module> e
+ <module>event</module> agora permitem que o <program>httpd</program>
+ seja desligado graciosamente através do sinal
+ <a href="stopping.html#gracefulstop"><code>graceful-stop</code></a>.
+ A diretiva <directive
+ module="mpm_common">GracefulShutdownTimeout</directive>
+ foi adicionada para especificar um tempo limite ótimo, após o qual
+ <program>httpd</program> terminará independentemente do status
+ de quaisquer requisições sendo servidas.</dd>
+ <dt>Proxy</dt>
+ <dd>O novo módulo <module>mod_proxy_balancer</module> fornece
+ serviços de balanceamento de carga para <module>mod_proxy</module>.
+ O novo módulo <module>mod_proxy_ajp</module> adiciona suporte para o
+ <code>Protocolo Apache JServ versão 1.3</code> usado pelo
+ <a href="http://tomcat.apache.org/">Apache Tomcat</a>.</dd>
+
+ <dt>Biblioteca de Expressões Regulares Atualizada</dt>
+ <dd>A versão 5.0 da
+ <a href="http://www.pcre.org/">Biblioteca de Expressões Regulares Compatíveis
+ com Perl</a> (PCRE) agora está incluída. O <program>httpd</program> pode ser
+ configurado para usar uma instalação do PCRE no sistema, passando a opção
+ <code>--with-pcre</code> para o comando de configuração.</dd>
+
+ <dt>Filtragem Inteligente</dt>
+ <dd><module>mod_filter</module> introduz configuração dinâmica
+ à cadeia de filtros de saída. Ele permite que filtros sejam inseridos condicionalmente,
+ com base em qualquer cabeçalho "Request" ou "Response" ou variável de ambiente,
+ e dispensa as dependências mais problemáticas e
+ os problemas de ordenação na arquitetura 2.0.</dd>
+
+ <dt>Suporte a Arquivos Grandes</dt>
+ <dd><program>httpd</program> agora é construído com suporte a arquivos maiores
+ que 2GB em sistemas Unix modernos de 32 bits. Também foi adicionado suporte
+ para lidar com corpos de requisição com mais de 2GB.</dd>
+
+ <dt>MPM de Eventos</dt>
+ <dd>O módulo MPM <module>event</module> usa um thread separado para lidar com
+ solicitações "Keep Alive" e aceitar conexões. As solicitações "Keep Alive"
+ tradicionalmente exigiam que o httpd dedicasse um trabalhador para processá-las.
+ Esse trabalhador dedicado não podia ser usado novamente até que o tempo limite do "Keep Alive"
+ fosse atingido.</dd>
+
+ <dt>Suporte a Banco de Dados SQL</dt>
+ <dd><module>mod_dbd</module>, em conjunto com o framework <code>apr_dbd</code>,
+ traz suporte direto a SQL para os módulos que precisam.
+ Suporte grupos de conexões em MPMs com threads.</dd>
+
</dl>
</section>
<section id="module">
- <title>Melhorias nos Módulos</title>
+ <title>Melhorias nos Módulos</title>
<dl>
+ <dt>Authn/Authz</dt>
+ <dd>Módulos no diretório "aaa" foram renomeados e oferecem
+ um suporte melhor para autenticação "digest". Por exemplo,
+ <code>mod_auth</code> agora está dividido em
+ <module>mod_auth_basic</module> e
+ <module>mod_authn_file</module>; <code>mod_auth_dbm</code> agora é
+ chamado de <module>mod_authn_dbm</module>; <code>mod_access</code> foi
+ renomeado para <module>mod_authz_host</module>. Também existe um novo
+ módulo mod_authn_alias (já removido da versão 2.3/2.4) para simplificar
+ certas configurações de autenticação.
+ </dd>
+
<dt><module>mod_authnz_ldap</module></dt>
- <dd>Este módulo é uma migração do <code>mod_auth_ldap</code>,
- da versão 2.0 para a estrutura 2.2 de <code>Authn/Authz</code>.
- As novas funcionalidades incluem o uso de atributos LDAP e
- filtros de procura complexos na diretriz <directive module="mod_authz_core"
- >Require</directive>.</dd>
+ <dd>Este módulo é uma adaptação do módulo
+ <code>mod_auth_ldap</code> da versão para o framework <code>Authn/Authz</code>
+ da versão 2.2. Os novos recursos incluem o uso de valores de atributos LDAP e
+ filtros de pesquisa complexos na
+ diretiva <directive module="mod_authz_core">Require</directive>.</dd>
+ <dt><module>mod_authz_owner</module></dt>
+ <dd>Um novo módulo que autoriza o acesso a arquivos com base
+ no proprietário do arquivo no sistema de arquivos.</dd>
+
+ <dt><module>mod_version</module></dt>
+ <dd>Um novo módulo que permite habilitar blocos de configuração com base no
+ número da versão do servidor em execução.</dd>
+
<dt><module>mod_info</module></dt>
- <dd>Adicionado um novo argumento <code>?config</code> que
- mostra a configuração das diretrizes analisadas pelo
- Apache, incluindo o nome do arquivo e o número da linha.
- Esse módulo também mostra a ordem de todos os ganchos de
- pedidos (request hooks) e informações adicionais sobre
- a compilação, similar ao comando <code>httpd -V</code>.</dd>
+ <dd>Adicionado um novo argumento <code>?config</code> que mostrará
+ as diretivas de configuração analisadas pelo Apache, incluindo
+ o nome do arquivo e o número da linha. O módulo também
+ mostra a ordem de todos os ganchos de requisição e informações adicionais
+ de construção, similar a <code>httpd -V</code>.</dd>
+
+ <dt><module>mod_ssl</module></dt>
+ <!-- Need Info on SSLEngine Support? -->
+ <dd>Adicionado suporte à
+ <rfc>2817</rfc>, que
+ permite que conexões sejam atualizadas de texto puro para criptografia TLS.</dd>
+
+ <dt><module>mod_imagemap</module></dt>
+ <dd><code>mod_imap</code> foi renomeado para
+ <module>mod_imagemap</module> para evitar confusão pelo usuário.</dd>
</dl>
+
</section>
+ <section id="programs">
+ <title>Melhorias na Aplicação</title>
+ <dl>
+ <dt><program>httpd</program></dt>
+ <dd>Uma nova opção de linha de comando <code>-M</code> foi adicionada. Ela
+ lista todos os módulos carregados com base na configuração atual.
+ Diferentemente da opção <code>-l</code>, esta lista
+ inclui DSOs carregados via <module>mod_so</module>.</dd>
+
+ <dt><program>httxt2dbm</program></dt>
+ <dd>Um novo programa usado para gerar arquivos dbm a partir de entrada de texto,
+ para uso em <directive module="mod_rewrite">RewriteMap</directive>
+ com o tipo de mapa <code>dbm</code>.</dd>
+ </dl>
+ </section>
+
<section id="developer">
- <title>Mudanças ao Desenvolvedor de Módulos</title>
+ <title>Alterações para Desenvolvedor de Módulos</title>
<dl>
- <dt>API do APR 1.0</dt>
+ <dt>API <glossary>APR</glossary> 1.0</dt>
- <dd>O Apache 2.2 utiliza a API do APR 1.0. Todas as funções e
- símbolos antigos foram removidos do <code>APR</code> e
- <code>APR-Util</code>. Para mais detalhes, visite o
+ <dd>Apache 2.2 usa a API APR 1.0. Todas as funções e símbolos
+ descontinuados foram removidas do <code>APR</code> e do
+ <code>APR-Util</code>. Para detalhes, consulte o
<a href="http://apr.apache.org/">Website do APR</a>.</dd>
- <dt>Registros de Erros de Conexão (logs)</dt>
+ <dt>Authn/Authz</dt>
+ <dd>Os módulos de autenticação e autorização foram
+ renomeados da seguinte forma:
+ <ul>
+ <li><code>mod_auth_*</code> -> Módulos que implementam um mecanismo
+ de autenticação HTTP</li>
+ <li><code>mod_authn_*</code> -> Módulos que fornecem um provedor
+ de autenticação de backend</li>
+ <li><code>mod_authz_*</code> -> Módulos que implementam
+ autorização (ou acesso)</li>
+ <li><code>mod_authnz_*</code> -> Módulo que implementa tanto
+ autenticação quanto autorização</li>
+ </ul>
+ Existe um novo esquema de provedor de backend de
+ autenticação que facilita bastante a construção de
+ novos backends de autenticação.</dd>
- <dd>Uma nova função <code>ap_log_cerror</code>, foi adicionada
- para registrar erros que ocorrem na conexão do cliente.
- Quando documentado no diário de log, a mensagem inclui o
- endereço IP do cliente.</dd>
+ <dt>Registro de Erros de Conexão</dt>
- <dt>Adicionado Gancho de Teste de Configuração</dt>
+ <dd>Uma nova função, <code>ap_log_cerror</code>, foi adicionada para registrar
+ erros que ocorrem com a conexão do cliente. Quando registrada,
+ a mensagem inclui o endereço IP do cliente.</dd>
- <dd>Um novo gancho (hook), <code>test_config</code> foi
- adicionado para auxiliar módulos que querem executar
- códigos especiais apenas quando o usuário passa o
- parâmetro <code>-t</code> para o httpd.</dd>
+ <dt>Gancho de Configuração de Teste Adicionado</dt>
- <dt>Ajustar o Stacksize dos "Threaded MPM's"</dt>
+ <dd>Um novo gancho, <code>test_config</code>, foi adicionado para auxiliar
+ módulos que desejam executar código especial somente quando o usuário passar
+ <code>-t</code> para <program>httpd</program>.</dd>
- <dd>Uma nova diretriz chamada <code>ThreadStackSize</code>,
- foi adicionada para ajustar o tamanho das stacks em todos
- os threadeds MPMs. Essa é uma prática necessário para alguns
- módulos de terceiros em plataformas com tamanhos de stacks
- pequenos por padrão.</dd>
+ <dt>Definindo o Tamanho da Pilha de MPMs com Threads</dt>
- <dt>Negociação de Protocolo para filtros de saída</dt>
+ <dd>Uma nova diretiva, <directive
+ module="mpm_common">ThreadStackSize</directive> foi adicionada para
+ definir o tamanho da pilha em todos os MPMs com threads. Isso é necessário
+ para alguns módulos de terceiros em plataformas com tamanho de pilha de
+ threads padrão pequeno.</dd>
- <dd>No passado, todo filtro era responsável por garantir
- a geração de cabeçalhos de resposta correto que os afetava.
- Os filtros agora podem delegar o gerenciamento de protocolos
- comuns para <module>mod_filter</module>, usando chamadas
- de <code>ap_register_output_filter_protocol</code> ou
+ <dt>MAnipulação de protocolo para filtros de saída</dt>
+
+ <dd>No passado, cada filtro era responsável por garantir
+ a geração de cabeçalhos de resposta corretos que os afetasse.
+ Os filtros agora podem delegar o gerenciamento de protocolos comuns para
+ <module>mod_filter</module>, usando as chamadas
+ <code>ap_register_output_filter_protocol</code> ou
<code>ap_filter_protocol</code>.</dd>
+ <dt>Gancho de monitoramento adicionado</dt>
+ <dd>O gancho de monitoramento permite que os módulos executem tarefas regulares/agendadas
+ no processo pai (raiz).</dd>
+
+ <dt>Alterações na API de expressões regulares</dt>
+
+ <dd>O cabeçalho <code>pcreposix.h</code> não está mais disponível;
+ ele foi substituído pelo novo cabeçalho <code>ap_regex.h</code>.
+ A implementação POSIX.2 <code>regex.h</code> exposta pelo antigo
+ cabeçalho agora está disponível no namespace <code>ap_</code>
+ a partir de <code>ap_regex.h</code>. Chamadas para <code>regcomp</code>,
+ <code>regexec</code> e assim por diante podem ser substituídas por chamadas para
+ <code>ap_regcomp</code>, <code>ap_regexec</code>.</dd>
+
+ <dt>Framework DBD (API de banco de dados SQL)</dt>
+
+ <dd><p>Com o Apache 1.x e 2.0, os módulos que exigiam um backend SQL
+ tinham que assumir a responsabilidade de gerenciá-lo por conta própria. Além de
+ reinventar a roda, isso pode ser muito ineficiente, por
+ exemplo, quando vários módulos mantêm suas próprias conexões.</p>
+
+ <p>O Apache 2.1 e versões posteriores fornecem a API <code>ap_dbd</code> para
+ gerenciar conexões de banco de dados (incluindo estratégias otimizadas
+ para MPMs com e sem threads), enquanto o APR 1.2 e versões posteriores fornecem
+ a API <code>apr_dbd</code> para interagir com o banco de dados.</p>
+
+ <p>Novos módulos DEVEM agora usar essas APIs para todas as operações de banco de dados SQL.
+ Os aplicativos existentes DEVEM ser atualizados para usá-las
+ sempre que possível, seja de forma transparente ou como uma opção recomendada
+ aos seus usuários.</p></dd>
</dl>
-
</section>
</manualpage>
manual.pt-br.xsl.patch
(text/x-diff, 1.3 KB)
Index: docs/manual/style/manual.pt-br.xsl
===================================================================
--- docs/manual/style/manual.pt-br.xsl (revision 1933906)
+++ docs/manual/style/manual.pt-br.xsl (working copy)
@@ -18,7 +18,7 @@
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
-<xsl:output method="xml" encoding="ISO-8859-1" indent="no" doctype-public="-//W3C//DTD XHTML 1.0 Strict//EN" doctype-system="http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"/>
+<xsl:output method="xml" encoding="UTF-8" indent="no" doctype-public="-//W3C//DTD XHTML 1.0 Strict//EN" doctype-system="http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"/>
<!-- Read the localized messages from the specified language file -->
<xsl:variable name="message" select="document('lang/pt-br.xml')/language/messages/message"/>
@@ -26,7 +26,7 @@
<xsl:variable name="allmodules" select="document('xsl/util/allmodules.xml')/items/item[@lang=$doclang]"/>
<!-- some meta information have to be passed to the transformation -->
-<xsl:variable name="output-encoding">ISO-8859-1</xsl:variable>
+<xsl:variable name="output-encoding">UTF-8</xsl:variable>
<xsl:variable name="is-chm" select="false()"/>
<xsl:variable name="is-zip" select="false()"/>
<xsl:variable name="is-retired" select="false()"/>
new_features_2_0.xml.pt-br.patch
(text/x-diff, 19.2 KB)
Index: docs/manual/new_features_2_0.xml.pt-br
===================================================================
--- docs/manual/new_features_2_0.xml.pt-br (revision 1933906)
+++ docs/manual/new_features_2_0.xml.pt-br (working copy)
@@ -1,8 +1,8 @@
-<?xml version='1.0' encoding='UTF-8' ?>
+<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="./style/manual.pt-br.xsl"?>
-<!-- English Revision: 420990:1562488 (outdated) -->
-
+<!-- English Revision: 1562488 -->
+<!-- Portuguese(BR) translation: leonardolara --><!-- Reviewed by: leonardolara -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
@@ -22,111 +22,111 @@
<manualpage metafile="new_features_2_0.xml.meta">
-<title>Descrição das novas funcionalidades do Apache 2.0</title>
+<title>Visão Geral das novas funcionalidades do Servidor HTTP Apache 2.0</title>
<summary>
- <p>Esse documento descreve algumas das mudanças principais
- entre as versões 1.3 e 2.0 do Servidor HTTP Apache.</p>
+ <p>Esse documento descreve algumas das mudanças principais entre as
+ versões 1.3 e 2.0 do Servidor HTTP Apache.</p>
</summary>
-<seealso><a href="upgrading.html">Atualizando da versão 1.3 para 2.0</a></seealso>
+<seealso><a href="upgrading.html">Atualizando da versão 1.3 para a 2.0</a></seealso>
<section id="core">
<title>Principais Melhorias</title>
<dl>
- <dt>Threading Unix</dt>
+ <dt>Threads Unix</dt>
- <dd>Em sistemas Unix com suporte a threads POSIX, o Apache pode
- funcionar em modo híbrido multiprocesso e multithread. Não funciona
- em todas configurações, mas melhora a escalabilidade em muitas.</dd>
+ <dd>Em sistemas Unix com suporte a threads POSIX, o Apache httpd agora
+ pode funcionar em um modo híbrido multiprocessos e multithreads. Isto melhora
+ a escalabilidade para muitos mas não para todas as configurações.</dd>
- <dt>Novo Sistema de Compilação</dt>
+ <dt>Novo Sistema de Compilação</dt>
- <dd>O sistema de compilação foi reescrito do zero para utilizar o
- <code>autoconf</code> e o <code>libtool</code>, tornando a
- configuração do sistema Apache mais similar a de outros
- pacotes.</dd>
+ <dd>O sistema de compilação foi reescrito do zero para utilizar o
+ <code>autoconf</code> e o <code>libtool</code>, tornando o
+ sistema de configuração do Apache httpd mais similar a
+ de outros pacotes.</dd>
<dt>Suporte Multi-protocolo</dt>
- <dd>O Apache possui agora uma infraestrutura feita para suportar
- múltiplos protocolos. O módulo <module>mod_echo</module> é um
- exemplo ilustrativo de sua utilização.</dd>
+ <dd>O Servidor HTTP Apache possui agora infraestrutura para
+ suportar múltiplos protocolos. O módulo <module>mod_echo</module> é
+ exemplo ilustrativo de sua utilização.</dd>
- <dt>Suporte Aperfeiçoado para Plataformas Não-Unix</dt>
+ <dt>Suporte aperfeiçoado para plataformas
+ não-Unix</dt>
- <dd>O Apache 2.0 está mais rápido e mais estável em plataformas
- Não-Unix como BeOS, OS/2 e Windows. Com a introdução de módulos
- <a href="mpm.html">multi-processamento</a> (MPMs) específicos e a
- Apache Portable Runtime (APR), essas plataformas estão implementando
- as suas APIs nativas, evitando as camadas de emulação POSIX que se
- mostravam lentas e defeituosas.</dd>
+ <dd>O Servidor HTTP Apache 2.0 é mais rápido e mas estável em plataformas
+ não-Unix como BeOS, OS/2 e Windows. Com a
+ introdução de <a
+ href="mpm.html">módulos de multi-processamento</a> específicos por plataforma (MPMs) e o
+ Apache Portable Runtime (APR), essas plataformas agora estão
+ implementadas em suas API nativas, evitando as camadas de emulação POSIX que muitas vezes se
+ defeituosas e com baixo desempenho.</dd>
- <dt>Nova API Apache</dt>
+ <dt>Nova API httpd Apache</dt>
- <dd>A API para módulos mudou significativamente na versão 2.0.
- Muitos dos problemas de ordenamento/prioridade da versão
- 1.3 foram resolvidos. A versão 2.0 faz o ordenamento automático
- "per-hook" para permitir mais flexibilidade. Novas chamadas foram
- adicionadas para fornecer capacidades adicionais sem a necessidade
- de se aplicar nenhum patch ao servidor Apache principal.</dd>
+ <dd>A API para módulos mudou significativamente na versão 2.0.
+ Muitos dos problemas de ordenação/prioridade de módulos da versão
+ 1.3 foram resolvidos. A 2.0 faz muito disso automaticamente e a ordenação de módulos
+ agora é feita através de ganchos para permitir mais flexibilidade. Além disso, novas chamadas
+ foram adicionadas para fornecer capacidades adicionais de módulos
+ sem a necessidade de se aplicar patches ao núcleo do Servidor HTTP Apache.</dd>
<dt>Suporte IPv6</dt>
- <dd>Em sistemas onde o IPv6 é suportado pela biblioteca de base
- Apache Portable Runtime, o Apache monitora por padrão
- as interfaces IPv6. Em adição as diretrizes <directive
+ <dd>Em sistemas onde o IPv6 é suportado pela biblioteca subjacente
+ do Apache Portable Runtime, o httpd Apache monitora sockets
+ IPv6 por padrão. Adicionalmente, as diretivas <directive
module="mpm_common">Listen</directive>, <directive module="core"
>NameVirtualHost</directive> e <directive module="core"
- >VirtualHost</directive>, suportam correntes (strings) de
- endereços numéricos do tipo IPv6. (ex. "<code>Listen
+ >VirtualHost</directive> suportam strings de
+ endereço numérico IPv6 (ex.: "<code>Listen
[2001:db8::1]:8080</code>").</dd>
- <dt>Filtrando</dt>
+ <dt>Filtros</dt>
- <dd>Os módulos do Apache agora são feito filtros que
- agem na corrente do conteúdo na medida que este é entregue, tanto
- na entrada quando na saída de dados do servidor. É possível então,
- por exemplo, que o retorno de dados de scripts CGI sejam analisados
- pelas diretrizes do "Server Side Include" usando o filtro <code
- >INCLUDES</code> do <module>mod_include</module>. O módulo <module
- >mod_ext_filter</module>, permite que programas externos trabalhem
- como filtros do mesmo modo que aplicações CGI funcionam como
+ <dd>Os módulos do Apache agora podem ser escritos como filtros que atuam
+ no fluxo de conteúdo à medida que este é entregue ou recebido do
+ do servidor. Isto permite, por exemplo, que a saída de scripts CGI seja
+ analisada para encontrar diretivas "Server Side Include" usando o
+ filtro <code>INCLUDES</code> de <module>mod_include</module>. O
+ módulo <module>mod_ext_filter</module> permite que programas externos
+ atuem como filtros do mesmo modo que aplicações CGI podem atuar como
manipuladores.</dd>
<dt>Respostas de Erro Multi-linguais</dt>
- <dd>Mensagens de erro para o navegador agora são fornecidas em
- diversas línguas, usando documentos SSI. Podem ser personalizadas
- pelo administrador que desejar definir seus próprios
- padrões.</dd>
+ <dd>Mensagens de respostas de erro para o navegador agora são fornecidas em
+ diversas línguas, usando documentos SSI. Podem ser personalizadas
+ pelo administrador para atingir uma aparência consistente.</dd>
- <dt>Configuração Simplificada</dt>
+ <dt>Configuração Simplificada</dt>
- <dd>Muitas diretrizes confusas foram simplificadas. Entre elas,
- <code>Port</code> e <code>BindAddress</code> não existem
- mais; apenas a diretriz <directive module="mpm_common">Listen</directive>
- é usada para direcionar endereços IP; a diretriz <directive
- module="core">ServerName</directive> especifica o nome do servidor
- e o número da porta apenas para redirecionamento e reconhecimento
- de hospedeiros virtuais.</dd>
+ <dd>Muitas diretivas confusas foram simplificadas. Entre elas,
+ <code>Port</code> e <code>BindAddress</code> não existem
+ mais; apenas a diretiva <directive module="mpm_common">Listen</directive>
+ é usada para vinculação de endereço IP; a diretiva <directive
+ module="core">ServerName</directive> especifica o
+ nome do servidor e o número da porta apenas para redirecionamento e reconhecimento
+ de hosts virtuais.</dd>
<dt>Suporte Nativo ao Unicode do Windows NT</dt>
- <dd>O Apache 2.0 para Windows NT agora usa utf-8 para codificação
- de todos os nomes de arquivos. A tradução para o sistema
- base Unicode, torna possível o suporte multi-lingual para todas
- as instalações da família NT, incluindo o Windows 2000 e Windows XP.
- <em>Esse suporte não se estende ao Windows 95, 98 ou ME, que
- continuam usando o código de páginas da máquina local para o
+ <dd>O Apache httpd 2.0 para Windows NT agora usa UTF-8 para codificação
+ de todos os nomes de arquivos que são traduzidos diretamente para o sistemas de Arquivos
+ Unicode subjacente, fornecendo suporte multi-lingual para todas
+ as versões Windows da família NT, incluindo Windows 2000 e Windows XP.
+ <em>Este suporte não se estende ao Windows 95, 98 ou ME, que
+ continuam usando o código de página local da máquina para
acesso ao sistema de arquivos.</em></dd>
- <dt>Biblioteca de Expressões Regulares Atualizada</dt>
+ <dt>Biblioteca de Expressões Regulares Atualizada</dt>
- <dd>O Apache 2.0 inclui a <a href="http://www.pcre.org/">Biblioteca
- de Expressões Regulares Compatíveis Perl</a> (PCRE). Todas as
- avaliações de expressões regulares usam a mais poderosa sintaxe
+ <dd>O Apache httpd 2.0 inclui a <a href="http://www.pcre.org/">Biblioteca
+ de Expressões Regulares Compatível com Perl</a> (PCRE). Todas as
+ análises de expressões regulares agoram usam a sintaxe mais poderosa
do Perl 5.</dd>
</dl>
@@ -133,106 +133,100 @@
</section>
<section id="module">
- <title>Melhorias nos Módulos</title>
+ <title>Melhorias nos Módulos</title>
<dl>
<dt><module>mod_ssl</module></dt>
- <dd>Novo módulo no Apache 2.0. Esse módulo é uma interface
- para os protocolos de codificação SSL/TLS fornecidos pela
+ <dd>Novo módulo no Apache httpd 2.0. Este módulo é uma interface
+ para os protocolos de codificação SSL/TLS fornecidos pelo
OpenSSL.</dd>
<dt><module>mod_dav</module></dt>
- <dd>Novo módulo no Apache 2.0. Este módulo implementa as
- especificações de Autoria Distribuída e Versões (Distributed
- Authoring and Versioning - DAV) para HTTP, para a publicação
- e a manutenção de conteúdo da web.</dd>
+ <dd>Novo módulo no Apache httpd 2.0. Este módulo implementa as
+ especificações de Autoria e Versionamento Distribuídas (DAV) para
+ para publicação e manutenção de conteúdo web.</dd>
<dt><module>mod_deflate</module></dt>
- <dd>Novo módulo no Apache 2.0. Esse módulo permite o suporte
- a navegadores que solicitam que o conteúdo seja comprimido antes
- da entrega, economizando banda da rede.</dd>
+ <dd>Novo módulo no Apache httpd 2.0. Este módulo permite suporte
+ a navegadores que solicitam que o conteúdo seja comprimido antes da entrega,
+ economizando tráfego de rede.</dd>
<dt><module>mod_auth_ldap</module></dt>
- <dd>Novo módulo no Apache 2.0.41. Este módulo permite que
- bancos de dados LDAP sejam usados para armazenar credenciais
- para Autenticação Básica HTTP. Um módulo que o acompanha <module
- >mod_ldap</module>, fornece a conciliação de conexões e armazenamento
- de resultados.</dd>
+ <dd>Novo módulo no Apache httpd 2.0.41. Este módulo permite que
+ um banco de dados LDAP seja usados para armazenar credenciais para Autenticação
+ Básica Básica HTTP. Um módulo que o acompanha, <module>mod_ldap</module>,
+ fornece o gerenciamento de grupos de conexões e armazenamento de resultados em cache.</dd>
<dt><module>mod_auth_digest</module></dt>
- <dd>Inclui suporte adicional para armazenamento de sessões
- através de processos que usam memória compartilhada.</dd>
+ <dd>Inclui suporte adicional para armazenamento de sessões em cache
+ através de processos que usam memória compartilhada.</dd>
<dt><module>mod_charset_lite</module></dt>
- <dd>Novo módulo no Apache 2.0. Este modo experimental permite a
- tradução de tabelas de caracteres ou re-codificação.</dd>
+ <dd>Novo módulo no Apache httpd 2.0. Este módulo experimental permite
+ tradução ou recodificação de conjuntos de caracteres.</dd>
<dt><module>mod_file_cache</module></dt>
- <dd>Novo módulo no Apache 2.0. Esse módulo inclui a funcionalidade
- do <code>mod_mmap_static</code> do Apache 1.3, além de disponibilizar
- outras possibilidades de armazenamento.</dd>
+ <dd>Novo módulo no Apache httpd 2.0. Esse módulo inclui a
+ funcionalidade do <code>mod_mmap_static</code> do Servidor HTTP
+ Apache versão 1.3 e disponibiliza outras habilidades de armazenamento em cache.</dd>
<dt><module>mod_headers</module></dt>
- <dd>Este módulo está muito mais flexível no Apache 2.0. Pode
- modificar pedidos de cabeçalhos usados pelo <module>mod_proxy</module
- >, e incondicionalmente pode ajustar cabeçalhos de respostas.</dd>
+ <dd>Este módulo é muito mais flexível no Apache httpd 2.0. Ele pode agora
+ modificar cabeçalhos de requisição usados pelo <module>mod_proxy</module> e
+ pode ajustar cabeçalhos de resposta sob certas condições.</dd>
<dt><module>mod_proxy</module></dt>
- <dd>O módulo proxy foi totalmente reescrito para levar vantagem
- da nova infraestrutura de filtro e implementar um proxy mais fiel e
- de acordo com o padrão HTTP/1.1. Além disso, uma nova seção
- de configuração <directive module="mod_proxy" type="section"
- >Proxy</directive> fornece controles mais legíveis (e internamente
- mais rápidos) para sites com proxies; configurações
- sobrecarregadas <code><Directory "proxy:..."></code>, não
- são suportadas. O módulo agora é dividido em suporte
- de protocolos específicos incluindo <code>proxy_connect</code>,
- <code>proxy_ftp</code> e <code>proxy_http</code>.</dd>
+ <dd>O módulo de proxy foi totalmente reescrito para tomar
+ vantagem da nova infraestrutura de filtros e para implementar um
+ proxy mais confiável e compatível com o padrão HTTP/1.1. Além disso, novas
+ seções de configuração <directive module="mod_proxy" type="section">Proxy</directive>
+ fornecem controles mais legíveis (e internamente
+ mais rápidos) de sites com proxies; configurações
+ sobrecarregadas <code><Directory "proxy:..."></code> não são suportadas.
+ O módulo agora é dividido módulos de suporte a protocolos específicos
+ incluindo <code>proxy_connect</code>, <code>proxy_ftp</code> e
+ <code>proxy_http</code>.</dd>
<dt><module>mod_negotiation</module></dt>
- <dd>A nova diretriz <directive module="mod_negotiation"
+ <dd>A nova diretiva <directive module="mod_negotiation"
>ForceLanguagePriority</directive> pode ser usada para assegurar que
- o cliente receba um único documento em todos os casos, ao invés de
- respostas "NOT ACCEPTABLE" ou "MULTIPLE CHOICES". Novos algoritmos
- de negociação e visões múltiplas (MultiViews) foram organizados para
- obter resultados mais consistentes e uma nova forma de tipo de mapa
- (map type) que podem incluir o conteúdo de documentos é fornecido.</dd>
+ o cliente receba um único documento em todos os casos, em vez de
+ respostas como "NOT ACCEPTABLE" ou "MULTIPLE CHOICES". Adicionalmente, os algoritmos
+ de negociação e visualizações múltiplas foram organizados para
+ fornecer resultados mais consistentes e foi disponibilizado uma nova forma de
+ mapa de tipo que pode incluir conteúdo de documentos.</dd>
<dt><module>mod_autoindex</module></dt>
- <dd>As listagens de diretórios automáticas podem ser
- configuradas para usar tabelas HTML para formatações mais limpas
- e permitir controles mais acurados de classificação, incluindo
- ordenação por versão e filtro da lista de
- diretórios através de caracteres-coringa.</dd>
+ <dd>As listagens de diretórios autoindexadas agora podem ser configuradas
+ para usar tabelas HTML para formatações mais limpas e permitir controles
+ mais finos de ordenação, incluindo ordenação por versão e filtragem da listagem de
+ diretórios através de caracteres-coringa.</dd>
<dt><module>mod_include</module></dt>
- <dd>Novas diretrizes permitem que as tags padrões <em>start</em> e
- <em>end</em> para elementos SSI, possam ser alteradas e permitir que
- as configurações de formatos de erro e hora sejam incluídos no
- arquivo de configuração principal, ao invés de serem adicionadas
- ao documento SSI. Resultados de análises de expressões regulares
- e agrupamento (baseadas na sintaxe de expressões regulares do Perl)
- podem ser obtidas usando as variáveis do módulo <module
- >mod_include</module>, de <code>$0</code> a <code>$9</code>.</dd>
+ <dd>Novas diretivas permitem que as tags padrões de início e fim para elementos
+ SSI possam ser alteradas e permitem que a configuração de formato de erro e horário
+ ocorra no arquivo de configuração principal em vez de ocorrerem
+ no documento SSI. Resultados de análises de expressões regulares e agrupamento
+ (agora baseadas na sintaxe de expressões regulares do Perl) podem ser obtidas
+ usando as variáveis do módulo <module>mod_include</module>: <code>$0</code>
+ .. <code>$9</code>.</dd>
<dt><module>mod_auth_dbm</module></dt>
- <dd>Agora suporta múltiplos tipos de banco de dados similares ao DBM,
- usando a diretriz <a href="../2.0/mod/mod_auth_dbm.html#AuthDBMType">
- <code>AuthDBMType</code></a>
- .</dd>
+ <dd>Agora suporta múltiplos tipos de banco de dados similares ao DBM usando a
+ diretiva <directive>AuthDBMType</directive>.</dd>
</dl>
</section>
index.xml.pt-br.patch
(text/x-diff, 7.4 KB)
Index: docs/manual/index.xml.pt-br
===================================================================
--- docs/manual/index.xml.pt-br (revision 1933906)
+++ docs/manual/index.xml.pt-br (working copy)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE indexpage SYSTEM "./style/sitemap.dtd">
<?xml-stylesheet type="text/xsl" href="./style/manual.pt-br.xsl"?>
-<!-- English Revision: 420993:1933437 (outdated) -->
-
+<!-- English Revision: 1933437 -->
+<!-- Portuguese(BR) translation: leonardolara --><!-- Reviewed by: leonardolara -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
@@ -23,71 +23,77 @@
<indexpage metafile="index.xml.meta">
<parentdocument href="http://httpd.apache.org/docs-project/" />
-<title>Documentação do Servidor HTTP Apache Versão
+<title>Documentação do Servidor HTTP Apache Versão
&httpd.major;.&httpd.minor;</title>
-<category id="release"><title>Notas da Versão</title>
+<category id="release"><title>Notas da Versão</title>
<page href="new_features_2_4.html">Novas funcionalidades no Apache 2.3/2.4</page>
<page href="new_features_2_2.html">Novas funcionalidades no Apache 2.1/2.2</page>
<page href="new_features_2_0.html">Novas funcionalidades no Apache 2.0</page>
- <page href="upgrading.html">Atualizando da versão 2.2 para 2.4</page>
- <page href="license.html">Licença Apache</page>
+ <page href="upgrading.html">Atualizando da versão 2.2 para 2.4</page>
+ <page href="license.html">Licença Apache</page>
</category>
-<category id="manual"><title>Manual de Referência</title>
+<category id="manual"><title>Manual de Referência</title>
<page href="install.html">Compilando e Instalando</page>
- <page href="invoking.html">Iniciando</page>
+ <page href="invoking.html">Executando</page>
<page href="stopping.html">Parando ou Reiniciando</page>
- <page href="mod/directives.html">Diretrizes de Configuração para execução</page>
- <page href="mod/quickreference.html">Referência Rápida de Diretrizes</page>
- <page href="mod/">Módulos</page>
- <page href="mpm.html">Módulos Multi-Processos (MPMs)</page>
+ <page href="mod/quickreference.html">Diretivas de Configuração para Execução</page>
+ <page href="mod/">Módulos</page>
+ <page href="mpm.html">Módulos Multi-Processos (MPMs)</page>
<page href="filter.html">Filtros</page>
- <page href="handler.html">Handlers</page>
- <page href="programs/">Servidor e Programas Suportados</page>
- <page href="glossary.html">Glossário</page>
-</category>
+ <page href="handler.html">Manipuladores</page>
+ <page href="expr.html">Interpretador de Expressão</page>
+ <page href="mod/overrides.html">Índice de Classe de Substituição para .htaccess</page>
+ <page href="programs/">Servidor e Programas de Suporte</page>
+ <page href="glossary.html">Glossário</page>
+</category>
-<category id="usersguide"><title>Guia do Usuário</title>
- <page href="bind.html">Portas de escuta</page>
- <page href="configuring.html">Arquivos de Configuração</page>
- <page href="sections.html">Seções de Configuração</page>
- <page href="caching.html">Cachê de Conteúdo</page>
- <page href="content-negotiation.html">Negociação de Conteúdo</page>
- <page href="dso.html">Objetos Dinâmicos Compartilhados (DSO)</page>
- <page href="env.html">Variáveis de Ambiente</page>
+<category id="usersguide"><title>Guia do Usuário</title>
+ <page href="getting-started.html">Introdução</page>
+ <page href="bind.html">Vinculando a Endereços e Portas</page>
+ <page href="configuring.html">Arquivos de Configuração</page>
+ <page href="sections.html">Seções de Configuração</page>
+ <page href="caching.html">Cache de Conteúdo</page>
+ <page href="content-negotiation.html">Negociação de Conteúdo</page>
+ <page href="dso.html">Objetos Dinâmicos Compartilhados (DSO)</page>
+ <page href="env.html">Variáveis de Ambiente</page>
<page href="logs.html">Arquivos de Registro</page>
<page href="urlmapping.html">Mapeando URLs para o Sistema de Arquivos</page>
- <page href="misc/perf-tuning.html">Ajustes de Performance</page>
- <page href="misc/security_tips.html">Dicas de Segurança</page>
- <page href="server-wide.html">Configurações Globais do Servidor</page>
- <page href="ssl/">Encriptamento SSL/TLS</page>
- <page href="suexec.html">Execução Suexec para CGI</page>
- <page href="rewrite/">Guia para Reescrever URL</page>
- <page href="vhosts/">Hosting Virtuais</page>
+ <page href="misc/perf-tuning.html">Ajustes de Desempenho</page>
+ <page href="misc/security_tips.html">Dicas de Segurança</page>
+ <page href="server-wide.html">Configurações Globais do Servidor</page>
+ <page href="ssl/">Criptografia SSL/TLS</page>
+ <page href="suexec.html">Execução Suexec para CGI</page>
+ <page href="rewrite/">Re-escrita de URL com mod_rewrite</page>
+ <page href="vhosts/">Hosts Virtuais</page>
</category>
-<category id="howto"><title>How-To / Tutoriais</title>
- <page href="howto/auth.html">Autenticação, Autorização, e
- Controle de Acesso</page>
- <page href="howto/cgi.html">CGI: Conteúdo Dinâmico</page>
+<category id="howto"><title>Como Fazer / Tutoriais</title>
+ <page href="howto/auth.html">Autenticação e Autorização</page>
+ <page href="howto/access.html">Controle de Acesso</page>
+ <page href="howto/cgi.html">CGI: Conteúdo Dinâmico</page>
<page href="howto/htaccess.html">Arquivos .htaccess</page>
<page href="howto/ssi.html">Server Side Includes (SSI)</page>
- <page href="howto/public_html.html">Diretórios Web para usuários individuais
- (public_html)</page>
+ <page href="howto/public_html.html">Diretórios Web para Usuários Individuais (public_html)</page>
+ <page href="howto/reverse_proxy.html">Guia de Configuração de Proxy Reverso</page>
+ <page href="howto/http2.html">Guia do HTTP/2</page>
</category>
-<category id="platform"><title>Notas Específicas para diferentes Platformas</title>
+<category id="platform"><title>Observações para Plataformas Específicas</title>
<page href="platform/windows.html">Microsoft Windows</page>
+ <page href="platform/rpm.html">Sistemas Baseados em RPM (Redhat / CentOS / Fedora)</page>
<page href="platform/netware.html">Novell NetWare</page>
<page href="platform/ebcdic.html">EBCDIC Port</page>
</category>
-<category id="other"><title>Outros Tópicos</title>
- <page href="faq/">Perguntas Mais Frequentes</page>
+<category id="other"><title>Outros Tópicos</title>
+ <page href="https://cwiki.apache.org/confluence/display/httpd/FAQ">Perguntas Mais Frequentes</page>
<page href="sitemap.html">Mapa do Site</page>
- <page href="developer/">Documentação para Desenvolvedores</page>
- <page href="misc/">Outras Notas</page>
+ <page href="developer/">Documentação para Desenvolvedores</page>
+ <page href="http://httpd.apache.org/docs-project/">Ajudando com a Documentação</page>
+ <page href="misc/">Outras Observações</page>
+ <page href="https://cwiki.apache.org/confluence/display/httpd/">Wiki</page>
</category>
</indexpage>
designations.xml.patch
(text/x-diff, 713 B)
Index: docs/manual/style/xsl/util/designations.xml =================================================================== --- docs/manual/style/xsl/util/designations.xml (revision 1933906) +++ docs/manual/style/xsl/util/designations.xml (working copy) @@ -6,7 +6,7 @@ <item charset="UTF-8" lang="fr">.html.fr.utf8</item> <item charset="UTF-8" lang="ja">.html.ja.utf8</item> <item charset="EUC-KR" lang="ko">.html.ko.euc-kr</item> -<item charset="ISO-8859-1" lang="pt-br">.html.pt-br</item> +<item charset="UTF-8" lang="pt-br">.html.pt-br</item> <item charset="UTF-8" lang="ru">.html.ru.utf8</item> <item charset="UTF-8" lang="tr">.html.tr.utf8</item> <item charset="UTF-8" lang="zh-cn">.html.zh-cn.utf8</item>
htaccess.xml.pt-br.patch
(text/x-diff, 35.1 KB)
Index: docs/manual/howto/htaccess.xml.pt-br
===================================================================
--- docs/manual/howto/htaccess.xml.pt-br (revision 1933906)
+++ docs/manual/howto/htaccess.xml.pt-br (working copy)
@@ -1,8 +1,8 @@
-<?xml version='1.0' encoding='UTF-8' ?>
+<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.pt-br.xsl"?>
-<!-- English Revision: 151408:1933863 (outdated) -->
-
+<!-- English Revision: 1741841 -->
+<!-- Portuguese(BR) translation: leonardolara --><!-- Reviewed by: leonardolara -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
@@ -21,13 +21,13 @@
-->
<manualpage metafile="htaccess.xml.meta">
-<parentdocument href="./">How-To / Tutoriais</parentdocument>
+<parentdocument href="./">Como Fazer / Tutoriais</parentdocument>
-<title>Tutorial do Apache: arquivos .htaccess</title>
+<title>Tutorial do Servidor HTTP Apache: arquivos .htaccess</title>
<summary>
-<p>Arquivos <code>.htaccess</code> oferecem um meio de fazer mudanças
- nas configurações por-diretório.</p>
+<p>Arquivos <code>.htaccess</code> oferecem um meio de fazer alterações
+ nas configurações por diretório.</p>
</summary>
<section id="related"><title>Arquivos .htaccess </title>
@@ -55,52 +55,53 @@
</directivelist>
</related>
+
+ <note>O uso de arquivos <code>.htaccess</code> deve ser totalmente evitado se for possível o acesso ao
+ arquivo de configuração httpd principal. O uso de arquivos <code>.htaccess</code> deixa o Servidor Apache HTTP mais lento.
+ Qualquer diretiva que possa ser incluída em um <code>.htaccess</code> fica melhor se for incluída em um bloco <directive module="core">Directory</directive>, pois terá o mesmo efeito com um desempenho melhor.</note>
</section>
<section id="what">
-<title>O que eles são/Como usá-los</title>
+ <title>O que eles são / Como usá-los</title>
- <p>Os arquivos <code>.htaccess</code> (ou "arquivos de
- configuração distribuída") oferecem um meio de fazer mudanças nas
- configurações por-diretório. Um arquivo, contendo uma ou mais
- diretrizes de configurações, é colocado em um diretório
- em particular, e as diretrizes se aplicam para aquele diretório e todos
- os seu subdiretórios subseqüentes.</p>
+ <p>Os arquivos <code>.htaccess</code> (ou "arquivos de configuração distribuída")
+ oferecem um meio de fazer alterações nas configurações por diretório. Um
+ arquivo, contendo uma ou mais diretivas de configurações, é colocado em um
+ diretório em particular e as diretivas se aplicam àquele diretório e a
+ todos os seus subdiretórios.</p>
<note><title>Nota:</title>
- <p>Se você quiser renomear o seu arquivo <code>.htaccess</code>
- para outro nome, você deve usar a diretriz <directive
- module="core">AccessFileName</directive>. Por exemplo, se você
- prefere que o arquivo se chame <code>.config</code>, então você
- pode adicionar a seguinte linha ao seu arquivo de configuração
- do servidor:</p>
+ <p>Se o nome do arquivo precisar ser diferente de <code>.htaccess</code>,
+ deve ser usada a diretiva <directive
+ module="core">AccessFileName</directive>. Por exemplo,
+ se a preferência for chamar o arquivo de <code>.config</code>, pode
+ ser adicionada a seguinte linha ao arquivo de configuração do servidor:</p>
- <example>
- AccessFileName .config
- </example>
+ <highlight language="config">
+AccessFileName ".config"
+ </highlight>
</note>
- <p>No geral, arquivos <code>.htaccess</code> usam a mesma sintaxe
- que os <a href="../configuring.html#syntax">arquivos de
- configuração principal</a>. O que você pode colocar nesses
- arquivos é determinado pele diretriz <directive
- module="core">AllowOverride</directive>. Essa diretriz especifica,
- em categorias, quais diretrizes serão aceitas caso sejam
- encontradas em um arquivo <code>.htaccess</code>. Se uma diretriz
- for permitida em um arquivo <code>.htaccess</code>, a documentação
- para essa diretriz irá conter uma seção <em>Override</em>,
+ <p>Em geral, arquivos <code>.htaccess</code> usam a mesma sintaxe
+ que os <a href="../configuring.html#syntax">arquivos de configuração
+ principal</a>. O que pode ser colocado nesses arquivos é determinado pela
+ diretiva <directive module="core">AllowOverride</directive>. Esta
+ diretiva especifica, em categorias, quais diretivas serão
+ honradas caso sejam encontradas em um arquivo <code>.htaccess</code>. Se uma
+ diretiva for permitida em um arquivo <code>.htaccess</code>, a
+ documentação para essa diretiva conterá uma seção Override,
especificando que valor precisa estar em <directive
- module="core">AllowOverride</directive> para que esta diretriz
+ module="core">AllowOverride</directive> para que essa diretiva
seja permitida.</p>
- <p>Por exemplo, se você procurar na documentação pela diretriz
- <directive module="core">AddDefaultCharset</directive>, você
- achará que ela é permitida nos arquivos <code>.htaccess</code>.
- (Veja a linha Contexto no sumário das diretivas.) A
- linha <a href="../mod/directive-dict.html#Context">Override</a> lê
- <code>FileInfo</code>. Então, você deve ao menos ter
- <code>AllowOverride FileInfo</code> para que essa diretriz seja
- aceita nos arquivos <code>.htaccess</code>.</p>
+ <p>Por exemplo, ao procurar na documentação pela diretiva <directive
+ module="core">AddDefaultCharset</directive>,
+ pode-se notar que ela é permitida nos arquivos <code>.htaccess</code>.
+ (Veja a linha Contexto no sumário das diretivas.) A
+ linha <a href="../mod/directive-dict.html#Context">Override</a> apresenta
+ <code>FileInfo</code>. Assim, deve-se ter pelo menos
+ <code>AllowOverride FileInfo</code> para que essa diretiva seja
+ honrada nos arquivos <code>.htaccess</code>.</p>
<example><title>Exemplo:</title>
<table>
@@ -107,7 +108,7 @@
<tr>
<td><a
href="../mod/directive-dict.html#Context">Contexto:</a></td>
- <td>configuração do servidor, hospedeiros virtuais, diretório, .htaccess</td>
+ <td>configuração do servidor, host virtual, diretório, .htaccess</td>
</tr>
<tr>
@@ -118,61 +119,59 @@
</table>
</example>
- <p>Se você estiver incerto se uma diretriz em particular é
- aceita em um arquivo <code>.htaccess</code>, procure na
- documentação por essa diretriz, e verifique a linha de
- Contexto por ".htaccess".</p> </section>
+ <p>Caso não haja certeza que se uma diretiva em particular é permitida em um
+ arquivo <code>.htaccess</code>, procure na documentação por essa
+ diretiva e verifique na linha Contexto a presença de ".htaccess".</p>
+</section>
- <section id="when"><title>Quando (não) usar arquivos .htaccess</title>
+<section id="when"><title>Quando (não) usar arquivos .htaccess</title>
- <p>No geral, você nunca deve usar arquivos <code>.htaccess</code>
- a não ser que você não tenha acesso ao arquivo de configuração
- principal do servidor. Existe, por exemplo, um erro de concepção
- que dita que a autenticação de usuários sempre deve
- ser feita usando os arquivos <code>.htaccess</code>. Esse
- simplesmente não é o caso. Você pode usar as configurações de
- autenticação de usuário no arquivo de configuração principal do
- servidor, e isso é, de fato, a maneira mais adequada de se fazer
- as coisas.</p>
+ <p>Em geral, arquivos <code>.htaccess</code> só devem ser usados quando
+ não houver como acessar o arquivo de configuração principal do servidor. Existe,
+ por exemplo, um equívoco comum de que a autenticação de usuários
+ deve sempre ser feita em arquivos <code>.htaccess</code> e, mais recentemente,
+ outro equívoco de que as diretivas <module>mod_rewrite</module>
+ devem estar em arquivos <code>.htaccess</code>. Isso simplesmente não é verdade.
+ As configurações de autenticação de usuários podem ser colocadas na configuração principal do servidor,
+ e essa é, na verdade, a maneira preferida de fazer
+ as coisas. Da mesma forma, as diretivas <code>mod_rewrite</code> funcionam melhor,
+ em muitos aspectos, na configuração principal do servidor.</p>
- <p>Arquivos <code>.htaccess</code> devem ser usados em casos onde
- os provedores de conteúdo do site precisem fazer mudanças na
- configuração do servidor por-diretório, mas não tem
- acesso <em>root</em> ao sistema do servidor. Caso o administrador do
- servidor não esteja disposto a fazer mudanças freqüentes nas
- configurações do servidor, é desejável permitir que os
- usuários possam fazer essas mudanças através de arquivos
- <code>.htaccess</code> eles mesmos. Isso é particularmente
- verdade, por exemplo, em casos onde provedores estão fornecendo
- múltiplos sites para usuários em apenas uma máquina, e querem que
- seus usuários possam alterar suas configurações.</p>
+ <p>Os arquivos <code>.htaccess</code> devem ser usados nos casos em que os
+ provedores de conteúdo precisam fazer alterações de configuração no servidor
+ por diretório, mas não têm acesso root ao sistema do servidor.
+ Caso o administrador do servidor não esteja disposto a fazer
+ alterações de configuração frequentes, pode ser desejável permitir que
+ usuários individuais façam essas alterações em arquivos <code>.htaccess</code>
+ por conta própria. Isso é particularmente verdadeiro, por exemplo, em casos em que
+ ISPs hospedam vários sites de usuários em uma única máquina e desejam
+ que seus usuários possam alterar sua configuração.</p>
- <p>No entanto, de modo geral, o uso de arquivos <code>.htaccess</code>
- deve ser evitado quando possível. Quaisquer configurações
- que você considerar acrescentar em um arquivo <code>.htaccess</code>, podem
- ser efetivamente colocadas em uma seção <directive module="core"
- type="section">Directory</directive> no arquivo principal de
- configuração de seu servidor.</p>
+ <p>No entanto, em geral, o uso de arquivos <code>.htaccess</code> deve ser
+ evitado sempre que possível. Qualquer configuração que se considere
+ colocar em um arquivo <code>.htaccess</code> pode ser feita com a mesma eficácia
+ em uma seção <directive module="core"
+ type="section">Directory</directive> no seu arquivo de configuração
+ principal do servidor.</p>
- <p>Existem duas razões principais para evitar o uso de arquivos
+ <p>Existem dois motivos principais para evitar o uso de arquivos
<code>.htaccess</code>.</p>
- <p>A primeira delas é a performance. Quando <directive
- module="core">AllowOverride</directive> é configurado para
- permitir o uso de arquivos <code>.htaccess</code>, o Apache procura
- em todos diretórios por arquivos <code>.htaccess</code>.
- Logo, permitir arquivos <code>.htaccess</code> causa um impacto na
- performance, mesmo sem você usá-los de fato! Além disso,
- o arquivo <code>.htaccess</code> é carregado toda vez que um documento
- é requerido.</p>
+ <p>O primeiro desses motivos é o desempenho. Quando a diretiva <directive
+ module="core">AllowOverride</directive>
+ está configurada para permitir o uso de arquivos <code>.htaccess</code>, o httpd
+ procurará em todos os diretórios por arquivos <code>.htaccess</code>. Portanto,
+ permitir arquivos <code>.htaccess</code> causa uma queda de desempenho,
+ independentemente de serem realmente usados ou não! Além disso, o
+ arquivo <code>.htaccess</code> é carregado sempre que um documento é
+ solicitado.</p>
- <p>Além disso, note que o Apache precisa procurar pelos arquivos
- <code>.htaccess</code> em todos os diretórios superiores, para ter
- o complemento total de todas as diretivas que devem ser
- aplicadas. (Veja a seção <a href="#how">como as diretrizes são
- aplicadas</a>.) Então, se um arquivo de um diretório
- <code>/www/htdocs/example</code> é requerido, o Apache precisa
- procurar pelos seguintes arquivos:</p>
+ <p>Observe ainda que o httpd deve procurar arquivos <code>.htaccess</code>
+ em todos os diretórios de nível superior, a fim de ter um conjunto completo de
+ diretivas que ele deve aplicar. (Consulte a seção sobre <a href="#how">como
+ as diretivas são aplicadas</a>.) Assim, se um arquivo for solicitado de um
+ diretório <code>/www/htdocs/example</code>, o httpd deverá procurar os
+ seguintes arquivos:</p>
<example>
/.htaccess<br />
@@ -181,217 +180,299 @@
/www/htdocs/example/.htaccess
</example>
- <p>Assim, para cada acesso de arquivo fora desse diretório,
- existem 4 acessos ao sistema de arquivos adicionais, mesmo
- que nenhum desses arquivos estejam presentes. (Note que esse
- só será o caso se os arquivos <code>.htaccess</code>
- estiverem habilitados para <code>/</code>, o que
- normalmente não é o verdade.)</p>
+ <p>Assim, para cada acesso a um arquivo fora desse diretório, há 4
+ acessos adicionais ao sistema de arquivos, mesmo que nenhum desses arquivos esteja
+ presente. (Observe que isso só ocorreria se
+ os arquivos <code>.htaccess</code> estivessem habilitados para <code>/</code>, o que
+ normalmente não acontece.)</p>
- <p>A segunda consideração é relativa à segurança.
- Você está permitindo que os usuários modifiquem as
- configurações do servidor, o que pode resultar em mudanças
- que podem fugir ao seu controle. Considere com cuidado se você quer
- ou não dar aos seus usuários esses privilégios. Note também
- que dar aos usuários menos privilégios que eles precisam, acarreta em
- pedidos de suporte técnico adicionais. Tenha certeza que você comunicou
- aos usuários que nível de privilégios você os deu.
- Especificar exatamente o que você configurou na diretriz <directive
- module="core">AllowOverride</directive>, e direcioná-los para a
- documentação relevante, irá poupá-lo de muita confusão
- depois.</p>
+ <p>No caso de diretivas <directive
+ module="mod_rewrite">RewriteRule</directive>, no contexto do
+ <code>.htaccess</code>, essas expressões regulares devem ser
+ recompiladas a cada requisição ao diretório, enquanto no contexto da configuração principal do
+ servidor, elas são compiladas uma vez e armazenadas em cache.
+ Além disso, as próprias regras são mais complexas, pois é preciso
+ contornar as restrições que acompanham o contexto por diretório
+ e o <code>mod_rewrite</code>. Consulte o <a
+ href="../rewrite/intro.html#htaccess">Guia de Reescrita</a> para obter mais
+ detalhes sobre este assunto.</p>
- <p>Perceba que é exatamente equivalente colocar o arquivo
- <code>.htaccess</code> em um diretório
- <code>/www/htdocs/example</code> contendo uma diretriz, e
- adicionar a mesma diretriz em uma seção <em>Directory</em>
- <code><Directory /www/htdocs/example></code> na configuração
- principal do seu servidor:</p>
+ <p>A segunda consideração é de segurança. Esses arquivos permitem
+ que os usuários modifiquem a configuração do servidor, o que pode resultar em alterações sobre as quais
+ o administrador não tem controle. Considere cuidadosamente se deseja conceder
+ esse privilégio aos usuários. Observe também que conceder aos usuários menos
+ privilégios do que o necessário levará a solicitações adicionais de suporte técnico.
+ Certifique-se de informar claramente aos usuários qual o nível de
+ privilégios que foi condedido a eles. Especificar exatamente o valor definido para
+ <directive module="core">AllowOverride</directive> e direcioná-los
+ para a documentação relevante evitará muita confusão
+ posteriormente.</p>
+ <p>Observe que é completamente equivalente colocar um arquivo <code>.htaccess</code>
+ em um diretório <code>/www/htdocs/example</code> contendo uma
+ diretiva, e colocar essa mesma diretiva em uma seção Directory
+ <code><Directory "/www/htdocs/example"></code> na sua configuração principal do
+ servidor:</p>
+
<p>Arquivo <code>.htaccess</code> em <code>/www/htdocs/example</code>:</p>
- <example><title>Conteúdo de um arquivo .htaccess em
+ <example><title>Contents of .htaccess file in
<code>/www/htdocs/example</code></title>
- AddType text/example .exm
+ <highlight language="config">
+AddType text/example ".exm"
+ </highlight>
</example>
- <example><title>Seção do seu arquivo <code>httpd.conf</code></title>
- <Directory /www/htdocs/example><br />
- <indent>
- AddType text/example .exm<br />
- </indent>
- </Directory>
+ <example><title>Seção do arquivo <code>httpd.conf</code>
+ </title>
+ <highlight language="config">
+<Directory "/www/htdocs/example">
+ AddType text/example ".exm"
+</Directory>
+ </highlight>
</example>
- <p>No entanto, adicionando isso ao seu arquivo de configuração do
- servidor resultará em uma menor perda de performance, na medida que
- a configuração é carregada no momento da inicialização do
- servidor, ao invés de toda que que um arquivo é requerido.</p>
+ <p>No entanto, colocar essa configuração no arquivo de configuração do servidor
+ resultará em uma perda de desempenho menor, pois a configuração é
+ carregada uma vez quando o httpd é iniciado, em vez de toda vez que um arquivo é
+ solicitado.</p>
- <p>O uso de arquivos <code>.htaccess</code> pode ser totalmente
- desabilitado, ajustando a diretriz <directive
- module="core">AllowOverride</directive> para <code>none</code>:</p>
+ <p>O uso de arquivos <code>.htaccess</code> pode ser completamente desativado
+ definindo a diretiva <directive module="core">AllowOverride</directive>
+ como <code>none</code>:</p>
- <example>
- AllowOverride None
- </example>
+ <highlight language="config">
+AllowOverride None
+ </highlight>
</section>
-<section id="how"><title>Como as diretrizes são aplicadas</title>
+<section id="how"><title>Como as diretivas são aplicadas</title>
- <p>As diretrizes de configuração que se encontram em um arquivo
- <code>.htaccess</code> são aplicadas para o diretório no qual o
- arquivo <code>.htaccess</code> se encontra, e para todos os
- subdiretórios ali presentes. Mas, é importante lembrar também que
- podem existir arquivos <code>.htaccess</code> no diretórios
- superiores. As diretrizes são aplicadas na ordem que são
- achadas. Logo, um arquivo <code>.htaccess</code> em um diretório
- em particular, pode sobrescrever as diretrizes encontradas em um
- diretório acima deste em sua respectiva árvore. Estes, por sua vez,
- podem ter suas diretrizes sobrescritas por diretrizes ainda mais
- acima, ou no próprio arquivo de configuração principal do
- servidor.</p>
+ <p>As diretivas de configuração encontradas em um arquivo <code>.htaccess</code>
+ são aplicadas ao diretório em que o arquivo <code>.htaccess</code>
+ está localizado e a todos os seus subdiretórios. No entanto, é importante
+ lembrar também que pode haver arquivos <code>.htaccess</code>
+ em diretórios acima na hierarquia. As diretivas são aplicadas na ordem em que
+ são encontradas. Portanto, um arquivo <code>.htaccess</code> em um determinado
+ diretório pode sobrescrever diretivas encontradas em arquivos <code>.htaccess</code>
+ localizados acima na hierarquia de diretórios. E estes, por sua vez, podem ter
+ sobrescrito diretivas encontradas ainda acima na hierarquia, ou no próprio arquivo de
+ configuração principal do servidor.</p>
<p>Exemplo:</p>
- <p>No diretório <code>/www/htdocs/example1</code> nós temos
+ <p>No diretório <code>/www/htdocs/example1</code>, considere
um arquivo <code>.htaccess</code> contendo o seguinte:</p>
- <example>
- Options +ExecCGI
- </example>
+ <highlight language="config">
+Options +ExecCGI
+ </highlight>
- <p>(Nota: você deve ter "<code>AllowOverride Options</code>" para
- permitir o uso da diretriz "<directive
- module="core">Options</directive>" nos arquivos
- <code>.htaccess</code> .)</p>
+ <p>(Observação: "<code>AllowOverride Options</code>" deve estar em vigor
+ para permitir o uso da diretiva "<directive
+ module="core">Options</directive>" em
+ arquivos <code>.htaccess</code>.)</p>
- <p>No diretório <code>/www/htdocs/example1/example2</code> nós temos
+ <p>No diretório <code>/www/htdocs/example1/example2</code>, considere
um arquivo <code>.htaccess</code> contendo:</p>
- <example>
- Options Includes
- </example>
+ <highlight language="config">
+Options Includes
+ </highlight>
- <p>Devido a esse segundo arquivo <code>.htaccess</code>, no
- diretório <code>/www/htdocs/example1/example2</code>, a execução
- de scripts CGI não é permitida, pois somente <code>Options
- Includes</code> está em efeito, o que sobrescreve completamente
- quaisquer outros ajustes previamente configurados.</p>
+ <p>Devido a este segundo arquivo <code>.htaccess</code>, no diretório
+ <code>/www/htdocs/example1/example2</code>, a execução de CGI não é
+ permitida, pois apenas <code>Options Includes</code> está em vigor, o que
+ sobrescreve completamente qualquer configuração anterior que possa ter estado
+ em vigor.</p>
+
+ <section id="merge">
+ <title>Mesclagem do .htaccess com os arquivos de configuração principais</title>
+
+ <p>Conforme discutido na documentação sobre <a
+ href="../sections.html">Seções de Configuração</a>,
+ os arquivos <code>.htaccess</code> podem sobrescrever as seções <directive
+ type="section" module="core">Directory</directive> para
+ o diretório correspondente, mas serão sobrescritos por outros tipos
+ de seções de configuração dos arquivos de configuração principais.
+ Esse fato pode ser usado para impor certas configurações, mesmo na
+ presença de uma configuração <directive
+ module="core">AllowOverride</directive> permissiva. Por exemplo, para
+ impedir a execução de scripts, permitindo que qualquer outra configuração seja feita em
+ <code>.htaccess</code>, pode ser usado:</p>
+
+ <highlight language="config">
+<Directory "/www/htdocs">
+ AllowOverride All
+</Directory>
+
+<Location "/">
+ Options +IncludesNoExec -ExecCGI
+</Location>
+ </highlight>
+
+ <note>Este exemplo pressupõe que <directive
+ module="core">DocumentRoot</directive> seja <code>/www/htdocs</code>.</note>
+ </section>
+
</section>
-<section id="auth"><title>Exemplo de Autenticação</title>
+<section id="auth"><title>Exemplo de Autenticação</title>
- <p>Se você veio diretamente à esta parte do documento para
- aprender como fazer autenticação, é importante notar uma
- coisa. Existe uma concepção errada, mas muito comum, de que é
- necessário o uso de arquivos <code>.htaccess</code> para implementar
- a autenticação por senha. Este não é o caso. Colocar
- diretrizes de senha em uma seção <directive module="core"
- type="section">Directory</directive>, no seu arquivo principal de
- configuração do servidor, é a melhor maneira de se implementar
- isto, e os arquivos <code>.htaccess</code> devem ser usados apenas
- se você não tem acesso ao arquivo principal de configuração do
- servidor. Veja <a href="#when">acima</a> a discussão sobre quando
- você deve e quando não deve usar os arquivos
- <code>.htaccess</code>.</p>
+ <p>Se você veio direto para esta parte do documento para descobrir como
+ fazer a autenticação, é importante observar uma coisa. Existe um
+ equívoco comum de que é necessário usar
+ arquivos <code>.htaccess</code> para implementar a autenticação por senha.
+ Isso não é verdade. Colocar as diretivas de autenticação
+ em uma seção <directive module="core" type="section">Directory</directive>
+ no arquivo de configuração principal do servidor é a maneira preferida
+ de implementar isso, e os arquivos <code>.htaccess</code> devem ser usados somente
+ se você não tiver acesso ao arquivo de configuração principal do servidor. Veja <a
+ href="#when">acima</a> uma discussão sobre quando se deve e quando não se deve
+ usar arquivos <code>.htaccess</code>.</p>
- <p>Dito isso, se você ainda acredita que precisa usar um arquivo
- <code>.htaccess</code>, a configuração a seguir provavelmente
- funcionará para você.</p>
+ <p>Dito isso, se você ainda acredita que precisa usar um arquivo
+ <code>.htaccess</code>, a configuração a seguir provavelmente
+ funcionará para você.</p>
- <p>Conteúdo de um arquivo <code>.htaccess</code>:</p>
+ <p>Conteúdo de um arquivo <code>.htaccess</code>:</p>
- <example>
- AuthType Basic<br />
- AuthName "Password Required"<br />
- AuthUserFile /www/passwords/password.file<br />
- AuthGroupFile /www/passwords/group.file<br />
- Require Group admins
- </example>
+ <highlight language="config">
+AuthType Basic
+AuthName "Senha Requerida"
+AuthUserFile "/www/senhas/arquivo.senhas"
+AuthGroupFile "/www/senhas/arquivo.grupos"
+Require group admins
+ </highlight>
- <p>Note que <code>AllowOverride AuthConfig</code> precisa estar
- habilitado para que estas diretrizes tenham efeito.</p>
+ <p>Observe que <code>AllowOverride AuthConfig</code> deve estar em vigor
+ para que essas diretivas tenham algum efeito.</p>
- <p>Por favor veja o <a href="auth.html">tutorial de
- autenticação</a> para uma discussão mais completa sobre
- autenticação e autorização.</p>
+ <p>Consulte o <a href="auth.html">tutorial de autenticação</a> para uma
+ discussão mais completa sobre autenticação e autorização.</p>
</section>
<section id="ssi"><title>Exemplo de Server Side Includes</title>
- <p>Outro uso comum de arquivos <code>.htaccess</code> é ativar o
- Server Side Includes para um diretório em particular. Isto pode
- ser feito com as seguintes diretrizes de configuração, colocadas em
- um arquivo <code>.htaccess</code> no diretório desejado:</p>
+ <p>Outro uso comum de arquivos <code>.htaccess</code> é habilitar
+ inclusões do lado do servidor para um diretório específico. Isso pode ser feito com
+ as seguintes diretivas de configuração, colocadas em um
+ arquivo <code>.htaccess</code> no diretório desejado:</p>
- <example>
- Options +Includes<br />
- AddType text/html shtml<br />
- AddHandler server-parsed shtml
- </example>
+ <highlight language="config">
+Options +Includes
+AddType text/html shtml
+AddHandler server-parsed shtml
+ </highlight>
- <p>Note que ambos <code>AllowOverride Options</code> e
- <code>AllowOverride FileInfo</code> precisam estar habilitados
- para essas diretrizes terem efeito.</p>
+ <p>Observe que <code>AllowOverride Options</code> e <code>AllowOverride
+ FileInfo</code> devem estar ambos em vigor para que essas diretivas tenham algum
+ efeito.</p>
- <p>Por favor veja o <a href="ssi.html">tutorial de SSI</a> para
- uma discussão mais completa sobre server-side includes.</p>
+ <p>Consulte o <a href="ssi.html">tutorial SSI</a> para uma discussão mais
+ completa sobre includes do lado do servidor.</p>
</section>
+<section id="rewrite"><title>Regras de reescrita em arquivos .htaccess</title>
+ <p>Ao usar <directive module="mod_rewrite">RewriteRule</directive> em
+ arquivos .htaccess, esteja ciente de que o contexto por diretório
+ muda um pouco as coisas. Em particular, as regras são consideradas relativas
+ ao diretório atual, em vez de serem o URI solicitado original.
+ Considere os seguintes exemplos:</p>
+
+ <highlight language="config">
+ # No arquivo httpd.conf
+ RewriteRule "^/imagens/(.+)\.jpg" "/imagens/$1.png"
+
+ # No arquivo .htaccess do diretório raiz
+ RewriteRule "^imagens/(.+)\.jpg" "imagens/$1.png"
+
+ # No arquivo .htaccess do diretório imagens/
+ RewriteRule "^(.+)\.jpg" "$1.png"
+ </highlight>
+
+ <p>Em um arquivo <code>.htaccess</code> no diretório de documentos, a barra inicial
+ é removida do valor fornecido para <directive
+ module="mod_rewrite">RewriteRule</directive>, e no subdiretório
+ <code>imagens</code>, <code>/imagens/</code> é removido
+ dele. Portanto, a expressão regular precisa omitir essa parte
+ também.</p>
+
+ <p>Consulte a documentação do <a href="../rewrite/">mod_rewrite</a> para
+ obter mais detalhes sobre como usar o <code>mod_rewrite</code>.</p>
+
+</section>
+
<section id="cgi"><title>Exemplo de CGI</title>
- <p>Finalmente, você pode querer que um arquivo
- <code>.htaccess</code> permita a execução de programas CGI em um
- diretório em particular. Isto pode ser implementado com as
- seguintes configurações:</p>
+ <p>Por fim, pode ser necessário usar um arquivo <code>.htaccess</code> para permitir
+ a execução de programas CGI em um diretório específico. Isso pode ser
+ implementado com a seguinte configuração:</p>
- <example>
- Options +ExecCGI<br />
- AddHandler cgi-script cgi pl
- </example>
+ <highlight language="config">
+Options +ExecCGI
+AddHandler cgi-script cgi pl
+ </highlight>
- <p>Alternativamente, se você desejar que todos os arquivos de um
- dado diretório, sejam considerados programas CGI, isso pode ser
- feito com a seguinte configuração:</p>
+ <p>Alternativamente, se for necessário que todos os arquivos no diretório especificado sejam
+ considerados programas CGI, isso pode ser feito com a seguinte
+ configuração:</p>
- <example>
- Options +ExecCGI<br />
- SetHandler cgi-script
- </example>
+ <highlight language="config">
+Options +ExecCGI
+SetHandler cgi-script
+ </highlight>
- <p>Note que ambos <code>AllowOverride Options</code> e
- <code>AllowOverride FileInfo</code> precisam estar habilitados
- para que essas diretrizes tenham quaisquer efeito.</p>
+ <p>Observe que <code>AllowOverride Options</code> e <code>AllowOverride
+ FileInfo</code> devem estar ambos em vigor para que essas diretivas tenham algum
+ efeito.</p>
- <p>Por favor veja o <a href="cgi.html">tutorial de CGI
- tutorial</a> para uma discussão mais completa sobre programação
- e configuração CGI.</p>
+ <p>Consulte o <a href="cgi.html">tutorial CGI</a> para uma discussão mais
+ completa sobre programação e configuração CGI.</p>
+
</section>
<section id="troubleshoot"><title>Resolvendo Problemas</title>
- <p>Quando você adiciona diretrizes de configuração em um arquivo
- <code>.htaccess</code>, e não obtém o efeito desejado, existe uma
- série de pontos que podem estar errados.</p>
+ <p>Quando são colocadas diretivas de configuração em um arquivo <code>.htaccess</code>
+ e não é obtido o efeito desejado, há uma série de
+ coisas que podem estar dando errado.</p>
- <p>Mais comumente, o problema é que a diretriz <directive
- module="core">AllowOverride</directive> não está habilitada
- corretamente para que as suas diretrizes de configurações sejam
- honradas. Verifique se você não possui <code>AllowOverride
- None</code> ajustado para o escopo do arquivo em questão. Um bom
- meio de testar isso é colocar "lixo" em seu arquivo
- <code>.htaccess</code> e recarregá-lo. Se não for gerado nenhum
- erro do servidor, certamente você tem <code>AllowOverride
- None</code> habilitado.</p>
+ <p>O problema mais comum é que a diretiva <directive
+ module="core">AllowOverride</directive> não está
+ configurada de forma que suas diretivas de configuração sejam respeitadas.
+ Certifique-se de que não exista um <code>AllowOverride None</code> em vigor
+ para o escopo do arquivo em questão. Um bom teste para isso é colocar lixo
+ no seu arquivo <code>.htaccess</code> e recarregar a página. Se um erro do servidor não for
+ gerado, então quase certamente existe <code>AllowOverride
+ None</code> em vigor.</p>
- <p>Se, por outro lado, você está obtendo erros do servidor ao
- tentar acessar documentos, verifique o registro de erros do
- Apache. Ele provavelmente irá indicar que a diretriz usada em
- seu arquivo <code>.htaccess</code> não é permitida.
- Alternativamente, ele pode acusar erros de sintaxe que você terá
- que corrigir.</p>
+ <p>Se, por outro lado, erros do servidor estiverem sendo gerados ao tentar
+ acessar documentos, verifique o registro de erros do httpd. Ele provavelmente informará
+ que a diretiva usada no arquivo <code>.htaccess</code> não é
+ permitida.</p>
+ <example>
+ [Fri Sep 17 18:43:16 2010] [alert] [client 192.168.200.51] /var/www/html/.htaccess: DirectoryIndex not allowed here
+ </example>
+
+ <p>Isso indicará que foi usada uma diretiva que
+ nunca é permitida em arquivos <code>.htaccess</code>, ou que simplesmente
+ não existe um <directive module="core">AllowOverride</directive> definido para
+ um nível suficiente para a diretiva usada. Consulte a
+ documentação dessa diretiva específica para determinar qual
+ é o caso.</p>
+
+ <p>Alternativamente, pode aparecer um erro de sintaxe no
+ uso da própria diretiva.</p>
+
+ <example>
+ [Sat Aug 09 16:22:34 2008] [alert] [client 192.168.200.51] /var/www/html/.htaccess: RewriteCond: bad flag delimiters
+ </example>
+
+ <p>Nesse caso, a mensagem de erro deve ser específica para o
+ erro de sintaxe cometido.</p>
+
</section>
</manualpage>