Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

--- pt-br:config [2013-12-29 12:00] – removida ach
+++ pt-br:config [2021-01-07 16:46] (atual) – criada coldscientist
@@ Linha 1: / Linha 1: @@
+====== Configurando o DokuWiki ======
+Muitos dos recursos do DokuWiki podem ser configurados por meio de várias opções de configuração. A maneira mais fácil de modificar essas opções é usando o Gerenciador de Configuração, que permite que os administradores do wiki alterem facilmente as configurações do wiki on-line a partir do conforto de seu navegador favorito.
+Para iniciar o [[plugin:config|Gerenciador de Configuração]], faça login como superusuário, clique em "Administrar" e escolha "Configurações do DokuWiki".
+===== O que pode ser configurado =====
+As opções de "sistema" do DokuWiki serão encontradas no arquivo ''conf/dokuwiki.php''. No entanto, este arquivo contém os valores "padrão" do sistema. Para personalizá-lo, você deve editar o arquivo ''conf/local.php'' ou criá-lo se ele não existir. Para descobrir o que você pode configurar nesse arquivo, consulte a lista de [[#opcoes_disponiveis|opções disponíveis]].
+Nomes de usuário, senhas (criptografadas) e regras de controle de acesso são armazenados nos arquivos ''conf/users.auth.php'' e ''conf/acl.auth.php''.
+Ao enviar um novo arquivo no Gerenciador de mídias, você pode encontrar a mensagem "''O envio foi bloqueado. Essa extensão de arquivo é proibida!''". Este comportamento é controlado no arquivo ''conf/mime.conf''. Para fazer upload de um novo tipo de arquivo, especifique-o no arquivo [[doku>mime|mime.local.conf]].
+Algumas substituições automáticas são feitas quando você edita suas páginas. Alguns geram dicas, smileys ou alguns caracteres especiais. Este comportamento é controlado por [[doku>abbreviations|acronyms.conf]], [[doku>smileys|smileys.conf]] ou [[doku>entitites|entities.conf]].
+===== Arquivos de configuração =====
+Todos os arquivos de configuração podem ser encontrados no diretório ''./conf'' ou ''/etc/dokuwiki'' quando instalados a partir de um pacote Debian.
+Os "arquivos principais" geralmente vêm com o DokuWiki, enquanto os "arquivos locais" devem ser criados pelo administrador do wiki.
+Se os arquivos locais são suportados, você deve usá-los em vez de modificar os arquivos principais para evitar que suas configurações especiais não sejam sobrescritas por uma atualização posterior.
+^ arquivo principal                 ^ arquivo local                                         ^ tipo de configuração        ^ informação rápida                             ^
+| ''dokuwiki.php''          | ''local.php''\\ ''local.protected.php''            | ver abaixo             | Configuração geral do wiki             |
+| ''acronyms.conf''         | ''acronyms.local.conf''                            | [[doku>abbreviations|abbreviations]]     | Tooltips de abreviatura automática           |
+| ''entities.conf''         | ''entities.local.conf''                            | [[doku>entities|entities]]          | Substituições automáticas de texto            |
+| ''interwiki.conf''        | ''interwiki.local.conf''                           | [[doku>interwiki|interwiki]]         | Links de atalho interwiki               |
+| ''mime.conf''             | ''mime.local.conf''                                | [[doku>mime|mime]]              | Configurações MIME para uploads         |
+| ''smileys.conf''          | ''smileys.local.conf''                             | [[doku>smileys|smileys]]           | Substituições de imagem                     |
+|                           | ''acl.auth.php''                                   | [[doku>pt-br:acl|acl]]           | Configurações de controle de acesso                |
+|                           | ''users.auth.php''                                 | [[doku>pt-br:acl|acl]]           | Usuários e senhas                    |
+| ''license.php''           | ''license.local.php''                              | [[doku>config:license|config:license]]    | Lista de licenças disponíveis             |
+| ''scheme.conf''           | ''scheme.local.conf''                              | [[doku>urlschemes|urlschemes]]        | Esquemas de URL a serem reconhecidos como links  |
+| ''mediameta.php''         | ''mediameta.local.php''                            | [[doku>exif|exif]]              | Metadados editáveis para imagens           |
+| ''wordblock.conf''        | ''wordblock.local.conf''                           | [[doku>blacklist|blacklist]]         | Lista negra de SPAM                         |
+| ''plugins.required.php''  | ''plugins.local.php''\\ ''plugins.protected.php''  | ver abaixo             | Ativar/Desativar plug-ins             |
+|                           | ''userscript.js''                                  | [[doku>devel:javascript|devel:javascript]]  | JavaScripts presonalizados         |
+|                           | ''userstyle.css''                                  | [[doku>devel:css|devel:css]]         | CSS personalizados                |
+| ''manifest.json''         | ''manifest.local.json''                            | [[doku>devel:manifest|devel:manifest]]    | PWA Manifest                           |
+==== Arquivos de configuração de tema ====
+Arquivos de configuração adicionais são encontrados em ''/var/lib/dokuwiki/lib/tpl/dokuwiki'' (Debian), por exemplo, ''style.ini''. Style.ini é um arquivo de texto que é lido pelo tema padrão e o usuário pode configurar, por exemplo, a cor de fundo.
+===== Ativando/Desativando plug-ins =====
+Os plug-ins instalados são habilitados por padrão. Eles podem ser desabilitados usando o [[doku>plugin:extension|Gerenciador de extensões]], que grava no arquivo ''plugins.local.php''. Você pode proteger certos plug-ins colocando-os em ''conf/plugins.protected.php''.
+Por padrão, o DokuWiki carrega seus arquivos de configuração na seguinte ordem:
+  * ''conf/plugins.php'' - plug-ins padrão
+  * ''conf/plugins.local.php'' - alterado pelo gerenciador de extensão
+  * ''conf/plugins.required.php'' - esses plug-ins principais não podem ser controlados pelo gerenciador de extensão
+  * ''conf/plugins.protected.php'' - sobrescreve a configuração nos outros arquivos
+A ordem de carregamento dos arquivos de configuração é controlada pela variável global ''$config_cascade''. Usando um arquivo [[doku>devel:preload|preload.php]], você pode alterar esse comportamento.
+===== Opções de configuração =====
+A maioria dos recursos do DokuWiki podem ser configurados por meio de várias opções de configuração. A maneira mais fácil de modificar essas opções é usando o Gerenciador de configuração.
+As configurações disponíveis estão listadas [[doku>config#available_options|aqui]]. Seus valores padrão são armazenados em um arquivo chamado ''conf/dokuwiki.php''. Se você quiser modificar uma configuração, deve fazer isso em um arquivo chamado ''conf/local.php'' - isso garante que suas configurações especiais não sejam sobrescritas por uma atualização posterior. O Config Manager também usará esse arquivo. O arquivo ''conf/local.protected.php'' pode ser usado para configurações que não podem ser modificadas no Config Manager.
+Aqui está um exemplo de arquivo ''conf/local.php'':
+<code php>
+<?php
+$conf['title']     = 'Admin\'s Wiki';
+$conf['useacl']    = 1;
+$conf['superuser'] = 'admin';
+</code>
+Algumas notas sobre o arquivo de configuração. O arquivo é uma parte do código PHP, portanto, a sintaxe do PHP deve ser preservada. Por exemplo. cada linha deve ter um ponto e vírgula no final. Existem vários tipos de variáveis:
+  * Os números podem ser escritos como estão. Exemplo: ''9''
+  * As //strings// devem ser colocadas entre aspas simples ou duplas. Exemplo: '''foo bar'''
+  * Os booleanos podem ser ''1'' ou ''0''
+  * Os arrays contêm vários valores de um dos tipos acima
+==== Opções Disponíveis ====
+Veja [[doku>config#available_options|Available Options]] (em inglês).