Tabela de conteúdos
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 oGerenciador 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 arquivoconf/dokuwiki.php. No entanto, este arquivo contém os valores “padrão” do sistema. Para personalizá-lo, você deve editar o arquivoconf/local.php ou criá-lo se ele não existir. Para descobrir o que você pode configurar nesse arquivo, consulte a lista deopções disponíveis.
Nomes de usuário, senhas (criptografadas) e regras de controle de acesso são armazenados nos arquivosconf/users.auth.php econf/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 arquivoconf/mime.conf. Para fazer upload de um novo tipo de arquivo, especifique-o no arquivomime.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 poracronyms.conf,smileys.conf ouentities.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.phplocal.protected.php | ver abaixo | Configuração geral do wiki |
acronyms.conf | acronyms.local.conf | abbreviations | Tooltips de abreviatura automática |
entities.conf | entities.local.conf | entities | Substituições automáticas de texto |
interwiki.conf | interwiki.local.conf | interwiki | Links de atalho interwiki |
mime.conf | mime.local.conf | mime | Configurações MIME para uploads |
smileys.conf | smileys.local.conf | smileys | Substituições de imagem |
acl.auth.php | acl | Configurações de controle de acesso | |
users.auth.php | acl | Usuários e senhas | |
license.php | license.local.php | config:license | Lista de licenças disponíveis |
scheme.conf | scheme.local.conf | urlschemes | Esquemas deURL a serem reconhecidos como links |
mediameta.php | mediameta.local.php | exif | Metadados editáveis para imagens |
wordblock.conf | wordblock.local.conf | blacklist | Lista negra de SPAM |
plugins.required.php | plugins.local.phpplugins.protected.php | ver abaixo | Ativar/Desativar plug-ins |
userscript.js | devel:javascript | JavaScripts presonalizados | |
userstyle.css | devel:css | CSS personalizados | |
manifest.json | manifest.local.json | 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 oGerenciador de extensões, que grava no arquivoplugins.local.php. Você pode proteger certos plug-ins colocando-os emconf/plugins.protected.php.
Por padrão, o DokuWiki carrega seus arquivos de configuração na seguinte ordem:
conf/plugins.php- plug-ins padrãoconf/plugins.local.php- alterado pelo gerenciador de extensãoconf/plugins.required.php- esses plug-ins principais não podem ser controlados pelo gerenciador de extensãoconf/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 arquivopreload.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 listadasaqui. Seus valores padrão são armazenados em um arquivo chamadoconf/dokuwiki.php. Se você quiser modificar uma configuração, deve fazer isso em um arquivo chamadoconf/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 arquivoconf/local.protected.php pode ser usado para configurações que não podem ser modificadas no Config Manager.
Aqui está um exemplo de arquivoconf/local.php:
<?php$conf['title']='Admin\'s Wiki'; $conf['useacl']=1;$conf['superuser']='admin';
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 - Asstrings devem ser colocadas entre aspas simples ou duplas. Exemplo:
'foo bar' - Os booleanos podem ser
1ou0 - Os arrays contêm vários valores de um dos tipos acima
Opções Disponíveis
VejaAvailable Options (em inglês).