1) O que é o dokuwiki?
2)Quem usa o Dokuwiki?
3)Porque a documentação é tão importante?
4)Documentação de servidores e infraestrutura
5)Comparativo Dokuwiki, Jira Confluence, MediaWiki, Doxygen, LaTex
6)Caso de sucesso Dokuwiki: Industria de camarão Camanor Brasil
7)Como subir dokuwiki no debian?
8)Sintaxe exclusiva do dokuwiki
9)Código para criar artigo simples
Dokuwiki e a superimportancia da documentacao na TI
1. Dokuwiki e a superimportancia da
documentação na TI
Mario Araujo Xavier
Analista Field - Florianopolis
@marioaxavier7
Telegram/Gmail/Linkedin/Instagram
2. Roteiro
1) O que é o dokuwiki?
2)Quem usa o Dokuwiki?
3)Porque a documentação é tão importante?
4)Documentação de servidores e infraestrutura
5)Comparativo Dokuwiki, Jira Confluence, MediaWiki, Doxygen, LaTex
6)Caso de sucesso Dokuwiki: Industria de camarão Camanor Brasil
7)Como subir dokuwiki no debian?
8)Sintaxe exclusiva do dokuwiki
9)Código para criar artigo simples
3. Roteiro
10)Código para criar links internos e externos
11)Código para criar links servidorcompartilhamento
12)Código para criar links para anexar imagens, áudio e vídeo com parametrizações
13)Código para criar repositório de documentos
14)Código para criar repositório de software
15)Código para criar listas com subníveis e tabelas
16)Código para Emoticons XD
17)Templates e Plugins
4. O que é o dokuwiki?
• Software livre para documentação escrito em PHP.
• Podemos criar artigos e subartigos por hierarquia ou páginas separadas
• Podemos definir permissões de usuário e grupos
• Podemos criar documentação em texto, foto, vídeo, links e PDF embutido
• Cada pagina é escrita em um arquivo .txt, que contem a sintaxe dokuwiki
6. Porque a documentação
é tão importante?
1)Documentar facilita o trabalho do outro, permite trabalho colaborativo
2)Documentar agiliza o entendimento e troubleshooting: não é preciso reinventar a
roda
3)Documentar diminui a curva de aprendizagem em infraestruturas de rede e codigos
enormes
4)Documentar orienta a expansão da infraestrutura, as principais necessidades e o
que precisa melhorar
7. Porque a documentação
é tão importante?
5)Documentar faz processos evoluirem, principalmente com diagramas/BPM/UML
6)Documentar ajuda novos colaboradores da TI
7)Documentar aumenta a proatividade, continuidade do trabalho e manutenção
preventiva, principalmente com checklists
Cenário 1: documentação no problema em rede cascateada dentro da industria
Cenário 2: documentação na ausência do programador PHP
8. Documentação de servidores
Para servidores é recomendável documentar:
1) Hardware: processador, memoria, disco, RAID, firmware, fabricante, garantia e
upgrade/expansão possíveis
2) Rede: escopo de IP, Gateways, subnets, mascaras, DNS, DHCP, VLAN e redundancias
3) Software: SO, Dominio, DNS, DHCP, File Server, Web Server, Homologação, Backup e
Disaster Recovery, Cluster, Licenciamento, ERP, CRM, Intranet
9. Documentação de infraestrutura
Para infraestrutura é recomendável documentar:
1) Rack, pontos lógicos, switches, roteadores, VPN, Firewall, Links e Provedores de
internet
2) Contato/CNPJ/Razão Social dos fornecedores, contratos e SLA
3) Rotinas e procedimentos: backup, restore, manutenção preventiva e corretiva,
testes e homologações, inclusão de permissões de acesso(usuarios, grupos, contas
etc)
10. Comparativo Dokuwiki, Jira Confluence,
MediaWiki, Doxygen, LaTex
• Sistema de documentação associado ao Jira Software, Jira Service Desk e outros
produtos Atlassian
• Organizado por categorias, e com editor de texto avançado
• Podemos vincular soluções de chamados do Jira ao procedimento documentado no
Confluence
•
• Cenário: Documentação exigida no SLA em usina hidreletrica
12. Comparativo Dokuwiki, Jira Confluence,
MediaWiki, Doxygen, LaTex
• Sistema web escrito em PHP e origem do Wikipedia, WikiBooks, etc
• Usado para criar o WikiBB: hospeda relatório anual do Banco do Brasil para o Banco
Central e investidores
13. Comparativo Dokuwiki, Jira Confluence,
MediaWiki, Doxygen, LaTex
• Sistema que gera documentação padronizada em vários formatos, evitando
trabalho braçal
• Gera documentação em HTML, LaTex, RTF, Postscript, PDF com gŕ
aficos e diagramas
em hierarquias/dependencias
• Usado pela Adobe, Autodesk, iTunes, KDE, Asterisk, Red Hat Package Manager(RPM)
14.
15. Caso de sucesso Dokuwiki:
Industria de camarão Camanor
Brasil
• A TI da indústria ainda não tinha documentação geral de infra e dev
• Existiam alguns artigos em pastas e desatualizados
• Organizamos no dokuwiki por filial, por categoria, com diagramas de rede,
processos, tabela de IP e servidores, virtualização, redundancia e backup.
• Alem da documentação de TI, adicionamos contratos, CNPJs das filiais, IP CFTV,
ramais VOIP, etc
• Na hora que a TI vira um caos, a documentação ajuda muito a solucionar
rapidamente
16. Como subir dokuwiki no debian?
• É preciso baixar, descompactar o pacote e subir para seu localhost/servidor/nuvem
• Abra o arquivo install.php, siga as instruções e seja feliz XD
17. Sintaxe exclusiva do dokuwiki
• Para adicionar qualquer artigo, PDF, foto, video, tabela, plugin, é preciso seguir a
sintaxe
• Dokuwiki tem sua propria sintaxe, que facilita os ajustes e permite criar
documentação muito exclusiva, modelando de acordo com a necessidade
20. Código para criar
links internos e externos
Sintaxe para Link externo: [[http://www.potilivre.org| Clique aqui para acessar o
Potilivre]]
Sintaxe para email: <contato@potilivre.org>
21. Código para criar
links internos e externos
Sintaxe para Link interno: [[ Eventos | Clique aqui para ver os eventos do Potilivre ]]
22. Código para criar links SMB
servidorcompartilhamento
Sintaxe funciona tanto para nome (servidor) e IP ( 192.168.x.x), redirecionando e
abrindo o compartilhamento
23. Código para criar links para anexar
imagens, áudio e vídeo
Depois de subir os arquivos para o dokuwiki, usamos a sintaxe:
{{wiki:grafico.png}}
{{wiki:gravacao.mp3}}
{{wiki:tutorial.avi}}
24. Código para criar
repositório de documentos
{{wiki:listaRamaisVOIP.pdf}}
{{wiki:treinamento.doc}}
{{wiki:comunicado.odt}}
{{wiki:escalaAlmoco.xls}}
25. Código para criar
repositório de software
{{wiki:LimparSpooler.bat}}
{{wiki:Firefox.msi}}
{{https://www.7-zip.org/a/7z1900.exe}}
{{https://espejito.fder.edu.uy/videolan/vlc/3.0.16/
win32/vlc-3.0.16-win32.exe}}
30. Templates e Plugins para Dokuwiki
https://www.dokuwiki.org/template
https://www.dokuwiki.org/plugins
31. Dokuwiki e a superimportancia da
documentação na TI
Mario Araujo Xavier
Analista Field - Florianopolis
@marioaxavier7
Telegram/Gmail/Linkedin/Instagram