SlideShare une entreprise Scribd logo
1  sur  46
Télécharger pour lire hors ligne
WIKI
                        Documentado de forma ágil.



                                         José Augusto (Guto) Carvalho
                                              gutocarvalho@gmail.com
                                                       @gutocarvalho
Tuesday, April 24, 12
Agenda

                        Entendendo Wiki
                        Sintaxe
                        Estrutura
                        Administração
                        Controles de Acesso
                                              46 Slides - 60 a 80 Minutos
Tuesday, April 24, 12
Entendendo Wiki


Tuesday, April 24, 12
Wiki: O que significa?
       Os termos wiki (pronunciado /uíqui/ ou /víqui/) e
       WikiWiki são utilizados para identificar um tipo específico
       de coleção de documentos em hipertexto ou o software
       colaborativo usado para criá-lo.

       O termo "Wiki wiki" significa "extremamente rápido" no
       idioma havaiano.

       Fonte: http://pt.wikipedia.org/wiki/Wiki


Tuesday, April 24, 12
Para o SysAdmin/DevOps qual parte
                        da documentação é a mais importante?




Tuesday, April 24, 12
Textos c/ Perfumarias?
                        Formatação complexa?
                           Design refinado?
                          Formato fechado?

                        Isso realmente importa?

Tuesday, April 24, 12
Nada disso importa, o
                          que importa é o
                           conteúdo.

Tuesday, April 24, 12
Necessidades do Sysadmin
                        encontrar a informação de forma simples e rápida
                        entender a informação para que ela lhe seja útil
                        ter condições de modificar a informação com objetivo de
                        complementar, atualizar ou corrigir.
                        editar a informação de forma simples e rápida


Tuesday, April 24, 12
Wiki: Características
                         Acesso através de qualquer navegador/OS

                         Formatação do texto em linguagem MarkDown

                         Edição coletiva/colaborativa (equipe)

                         Rastreamento de mudanças (versionamento)

                         Foco no conteúdo (editor sem distrações)

                         Portabilidade do conteúdo (texto puro)


Tuesday, April 24, 12
Wiki: Projetos conhecidos

                        MediaWiki (site da wikipedia)
                        Dokuwiki (site de documentação zabbix)
                        MoinMoin (site de documentação projeto apache)


Tuesday, April 24, 12
Wiki: Listagem de projetos

     No site wikimatrix.org você irá conhecer diversas
     ferramentas wiki, neste site você terá condições de avaliar os
     recursos e as principais diferenças entre estes sistemas.

     O site concentra informações referentes a grande maioria dos
     sistemas wiki open-source conhecidos hoje.


Tuesday, April 24, 12
Nossa escolha: Dokuwiki
Tuesday, April 24, 12
Tuesday, April 24, 12
Dokuwiki: Características 1
                        Aplicação escrita em PHP
                        Não usa banco de dados
                        Velocidade no uso (por não usar banco de dados)
                        Sintaxe de formatação simples (markdown)
                        Suporte a plugins PHP (muitos plugins disponíveis)
                        Suporte a categorização por namespaces
Tuesday, April 24, 12
Dokuwiki: Características 2
                        Suporte a links interwikis (wikipedia/dokuwiki)
                        Upload de imagens e uso de referências externas
                        Buscas ‘FullText Search’ com índices
                        Interface Agradável com recursos Ajax
                        Cache de Páginas
                        Suporte a autenticação Local, LDAP, AD, MySQL e PostgreSQL
Tuesday, April 24, 12
Dokuwiki: Características 3

                        Suporte a mais de 50 idiomas
                        Código Fonte Aberto
                        Processo de desenvolvimento bem documentado
                        Syndication (RSS/ATOM) das mudanças recentes
                        Outros ... (http://www.dokuwiki.org/features)

Tuesday, April 24, 12
Dokuwiki: Diferencial

      O grande diferencial deste projeto é o fato de [não] utilizar
      base de dados relacional, tudo é salvo em arquivos no
                                File System.




Tuesday, April 24, 12
Dokuwiki: Diferencial

        O fato de não usar banco de dados, proporciona grande
        velocidade nas rotinas de criação, edição e leitura
        das páginas wiki, afinal, os dados são consumidos diretamente
        do filesystem, a aplicação faz a leitura de arquivos (.txt)
        em formato ASCII, algo simples, rápido, eficiente e universal.



Tuesday, April 24, 12
Dokuwiki: Diferencial

      Backup simplificado, basta compactar o diretório do dokuwiki
      para termos todos os dados salvos. Além disto, cada página é
      um arquivo de texto (.txt) simples, ou seja, nem precisamos ter
      um servidor de aplicação instalado para ler os dados, qualquer
      editor de texto puro consegue ler os dados.



Tuesday, April 24, 12
Sintaxe


Tuesday, April 24, 12
Linaguagem Markdown
            MarkDown é uma linguagem de marcação simples,
            onde você declara a formatação desejada através de
            símbolos, estes símbolos orientam a conversão do ‘texto
            puro’ para uma outra linguagem que normalmente é
            ((x)html).
            Referências: http://pt.wikiped ia.org/wiki/Markdown




Tuesday, April 24, 12
====== objetivo =======

               descreva de forma objetiva, de preferência em uma linha o objetivo dessa wiki para agilizar o entendimento, exemplo:

                 * descrever a instalação de ferramente XPTO no CentOS.

               ====== descrição =======

               Nem sempre a descrição, mas dependendo do manual é bom investir algumas linhas contextualizando a necessidade, exemplo:

                * a instalacao da ferramenta XPTO foi uma demanda motivada pelo problema XPTO e após análise resolvemos abordar essa
               solução.

               ====== procedimento =======

               ===== requisitos =====

               pacotes/dependencias

               ===== instalação =====

               instalando pacotes, tarballs, permissoes

               ===== configuração =====

               configuracoes em arquivos, servicos, sub-sistemas e no própio aplicativo instalado.

               ===== operação =====

               acesso ao aplicativo e como usar

               ====== referências =======

               sites/links que lhe ajudaram a escrever esse documento, exemplo:

                 * site 1
                 * site 2
                 * site 3

Tuesday, April 24, 12
Tuesday, April 24, 12
Mão na Massa
                        entendendo na prática como criar e editar wikipages




Tuesday, April 24, 12
Acessando wiki

                        Para acesse a wiki entre em http://wiki.dominio.local
                        Clique em Entrar
                        Utilize seu usuário
                        Clique Dokuwiki (no topo superior direito)
                        Clique em Playground

Tuesday, April 24, 12
[[area:nome|descrição]]

                   [[playground:teste do guto|Página teste do Guto]]




                           criando página
Tuesday, April 24, 12
//Itálico//

                             __sublinhado__

                               **negrito**

                           <del> tachado <del>



                        Formatação Simples
Tuesday, April 24, 12
Lista não                           Lista ordenada
                        ordenada
                                                            - Alfredo
                        * Alface                            - Bernardo
                        * Tomate                            - Camila
                        * Cebola                            - Daniel
                        * Alho                              - Euclides

         dois espaços no inicio da linha antes do simbolo




                                                        Listas
Tuesday, April 24, 12
http://www.google.com

                                www.google.com

      [[http://www.google.com | Acesse o google]]

                                     [[wp > wiki]]
              [[infraestrutura:modelo de projeto|Visualize o modelo de Projeto]]




                                        links
Tuesday, April 24, 12
{{area:nome.png | descricao caption}}

                              {{url | descricao caption}}

                  {{wiki:fotoguto.png | Foto do Gutocarvalho}}

    {{infraestrutura:racks.png | Foto dos Racks do CPD}}

                   {{www.site.com/logo.png | Logo do Detran}}



                                  Imagens
Tuesday, April 24, 12
^Nome^Telefone^
                        | Jose Augusto    | 5555-5555 |
                        | Fernando         | 5555-5555 |




                               Tabelas
Tuesday, April 24, 12
Execute o comando (dois espaços)
           comando 1
           comando 2


          <code>
          conteúdo longo
          </code>


                        Destacando Texto
Tuesday, April 24, 12
<file php arquivo.php>

                        <?php echo "hello world!"; ?>

                        </file>



                        Conteúdo Arquivo
Tuesday, April 24, 12
Estrutura


Tuesday, April 24, 12
Tuesday, April 24, 12
Tuesday, April 24, 12
Administração


Tuesday, April 24, 12
Área administrativa




Tuesday, April 24, 12
Gerenciamento de Plugins




Tuesday, April 24, 12
Gerenciamento de Usuários




Tuesday, April 24, 12
Controles de Acesso


Tuesday, April 24, 12
Permissões Exemplo 1




Tuesday, April 24, 12
Permissões Exemplo 2




Tuesday, April 24, 12
Protegendo Páginas Wiki
                                    [[área:nome|descrição]]

                                  [[infraestrutura:nome|descrição]]
                        [[infraestrutura:procedimentos:nome|descrição]]
                            [[infraestrutura:ambiente:nome|descrição]]
                           [[infraestrutura:processos:nome|descrição]]

                          [[desenvolvimento:nome|descrição]]
                      [[desenvolvimento:testes::nome|descrição]]
                  [[desenvolvimento:homologação::nome|descrição]]

                                [[playground:nome|descrição]]


Tuesday, April 24, 12
Perguntas? (5 min)
                                   José Augusto (Guto) Carvalho
                                        gutocarvalho@gmail.com
                                         http://gutocarvalho.net
                                                 @gutocarvalho

Tuesday, April 24, 12
Obrigado
                              José Augusto (Guto) Carvalho
                                   gutocarvalho@gmail.com
                                    http://gutocarvalho.net
                                            @gutocarvalho

Tuesday, April 24, 12

Contenu connexe

Tendances

Tendances (20)

Learn to Use Databricks for Data Science
Learn to Use Databricks for Data ScienceLearn to Use Databricks for Data Science
Learn to Use Databricks for Data Science
 
Big Data / Analytics sem Governança de Dados é apenas uma utopia
Big Data / Analytics sem Governança de Dados é apenas uma utopiaBig Data / Analytics sem Governança de Dados é apenas uma utopia
Big Data / Analytics sem Governança de Dados é apenas uma utopia
 
MongoDB Administration 101
MongoDB Administration 101MongoDB Administration 101
MongoDB Administration 101
 
Creating your Center of Excellence (CoE) for data driven use cases
Creating your Center of Excellence (CoE) for data driven use casesCreating your Center of Excellence (CoE) for data driven use cases
Creating your Center of Excellence (CoE) for data driven use cases
 
Modern Data Architecture
Modern Data ArchitectureModern Data Architecture
Modern Data Architecture
 
Banco de Dados Não Relacionais vs Banco de Dados Relacionais
Banco de Dados Não Relacionais vs Banco de Dados RelacionaisBanco de Dados Não Relacionais vs Banco de Dados Relacionais
Banco de Dados Não Relacionais vs Banco de Dados Relacionais
 
Exemplos de Design Patterns em Java
Exemplos de Design Patterns em JavaExemplos de Design Patterns em Java
Exemplos de Design Patterns em Java
 
Data pipelines from zero to solid
Data pipelines from zero to solidData pipelines from zero to solid
Data pipelines from zero to solid
 
Big Data Architectural Patterns
Big Data Architectural PatternsBig Data Architectural Patterns
Big Data Architectural Patterns
 
Aula Xml Schema - XSD
Aula Xml Schema - XSDAula Xml Schema - XSD
Aula Xml Schema - XSD
 
Dicas para implantação de um Programa de Governança de Dados
Dicas para implantação de um Programa de Governança de DadosDicas para implantação de um Programa de Governança de Dados
Dicas para implantação de um Programa de Governança de Dados
 
Architecting a datalake
Architecting a datalakeArchitecting a datalake
Architecting a datalake
 
Business Intelligence
Business IntelligenceBusiness Intelligence
Business Intelligence
 
Data Warehouse Modernization: Accelerating Time-To-Action
Data Warehouse Modernization: Accelerating Time-To-Action Data Warehouse Modernization: Accelerating Time-To-Action
Data Warehouse Modernization: Accelerating Time-To-Action
 
As boas práticas da Gestão de Dados Moderna
As boas práticas da Gestão de Dados ModernaAs boas práticas da Gestão de Dados Moderna
As boas práticas da Gestão de Dados Moderna
 
Governança de Dados e Big Data_v02
Governança de Dados e Big Data_v02Governança de Dados e Big Data_v02
Governança de Dados e Big Data_v02
 
Migrating your traditional Data Warehouse to a Modern Data Lake
Migrating your traditional Data Warehouse to a Modern Data LakeMigrating your traditional Data Warehouse to a Modern Data Lake
Migrating your traditional Data Warehouse to a Modern Data Lake
 
Banco de Dados II: Aspectos de Segurança em Banco de Dados (aula 13)
Banco de Dados II: Aspectos de Segurança em Banco de Dados (aula 13)Banco de Dados II: Aspectos de Segurança em Banco de Dados (aula 13)
Banco de Dados II: Aspectos de Segurança em Banco de Dados (aula 13)
 
Big Data, o que é isso?
Big Data, o que é isso?Big Data, o que é isso?
Big Data, o que é isso?
 
BI - Uso e Benefícios ( Business Intelligence )
BI - Uso e Benefícios ( Business Intelligence )BI - Uso e Benefícios ( Business Intelligence )
BI - Uso e Benefícios ( Business Intelligence )
 

En vedette

Carlos Veiga - Aula05 - Cabeamento Estruturado - (parte02)
Carlos Veiga - Aula05 - Cabeamento Estruturado - (parte02)Carlos Veiga - Aula05 - Cabeamento Estruturado - (parte02)
Carlos Veiga - Aula05 - Cabeamento Estruturado - (parte02)
Heber Souza
 
Monitoramento da rede de A a ZABBIX - Daniel Bauermann
Monitoramento da rede de A a ZABBIX - Daniel BauermannMonitoramento da rede de A a ZABBIX - Daniel Bauermann
Monitoramento da rede de A a ZABBIX - Daniel Bauermann
Tchelinux
 

En vedette (9)

Wiki como ferramenta de colaboração em empresas familiares – estudo de caso
Wiki como ferramenta de colaboração em empresas familiares – estudo de casoWiki como ferramenta de colaboração em empresas familiares – estudo de caso
Wiki como ferramenta de colaboração em empresas familiares – estudo de caso
 
Bypass de token csrf na pratica secure brasil
Bypass de token csrf na pratica secure brasilBypass de token csrf na pratica secure brasil
Bypass de token csrf na pratica secure brasil
 
Apresentação exploit
Apresentação exploitApresentação exploit
Apresentação exploit
 
Carlos Veiga - Aula05 - Cabeamento Estruturado - (parte02)
Carlos Veiga - Aula05 - Cabeamento Estruturado - (parte02)Carlos Veiga - Aula05 - Cabeamento Estruturado - (parte02)
Carlos Veiga - Aula05 - Cabeamento Estruturado - (parte02)
 
Monitoramento da rede de A a ZABBIX - Daniel Bauermann
Monitoramento da rede de A a ZABBIX - Daniel BauermannMonitoramento da rede de A a ZABBIX - Daniel Bauermann
Monitoramento da rede de A a ZABBIX - Daniel Bauermann
 
Trabalho de fibra óptica
Trabalho de fibra óptica Trabalho de fibra óptica
Trabalho de fibra óptica
 
Documentos de software
Documentos de softwareDocumentos de software
Documentos de software
 
FTTH para ISPs
FTTH para ISPsFTTH para ISPs
FTTH para ISPs
 
Lançamento do livro "De A a Zabbix" no IFPB
Lançamento do livro "De A a Zabbix" no IFPBLançamento do livro "De A a Zabbix" no IFPB
Lançamento do livro "De A a Zabbix" no IFPB
 

Similaire à Documentando de forma Ágil (usando dokuwiki)

Criação de uma base de dados para gestão de uma biblioteca
Criação de uma base de dados para gestão de uma bibliotecaCriação de uma base de dados para gestão de uma biblioteca
Criação de uma base de dados para gestão de uma biblioteca
David Canjamba 2D
 

Similaire à Documentando de forma Ágil (usando dokuwiki) (14)

Repositorios
RepositoriosRepositorios
Repositorios
 
Repositorios
RepositoriosRepositorios
Repositorios
 
Qualidade de Software: Ferramentas de apoio
Qualidade de Software: Ferramentas de apoioQualidade de Software: Ferramentas de apoio
Qualidade de Software: Ferramentas de apoio
 
Plataformas wiki
Plataformas wikiPlataformas wiki
Plataformas wiki
 
Latex2e - guia rápido e básico
Latex2e - guia rápido e básicoLatex2e - guia rápido e básico
Latex2e - guia rápido e básico
 
Criação de uma base de dados para gestão de uma biblioteca
Criação de uma base de dados para gestão de uma bibliotecaCriação de uma base de dados para gestão de uma biblioteca
Criação de uma base de dados para gestão de uma biblioteca
 
Software D Space 4 Gerenciamento
Software D Space 4 GerenciamentoSoftware D Space 4 Gerenciamento
Software D Space 4 Gerenciamento
 
Dokuwiki e a superimportancia da documentacao na TI
Dokuwiki e a superimportancia da documentacao na TIDokuwiki e a superimportancia da documentacao na TI
Dokuwiki e a superimportancia da documentacao na TI
 
Apresentação sobre Drupal
Apresentação sobre DrupalApresentação sobre Drupal
Apresentação sobre Drupal
 
Apresentação Docker
Apresentação DockerApresentação Docker
Apresentação Docker
 
[Engenharia de Software] Marquivos.com
[Engenharia de Software] Marquivos.com[Engenharia de Software] Marquivos.com
[Engenharia de Software] Marquivos.com
 
Lista de ferramentas na web 2
Lista de ferramentas  na web 2Lista de ferramentas  na web 2
Lista de ferramentas na web 2
 
Minicurso - Introdução ao LaTeX
Minicurso - Introdução ao LaTeXMinicurso - Introdução ao LaTeX
Minicurso - Introdução ao LaTeX
 
Wiki
WikiWiki
Wiki
 

Plus de Jose Augusto Carvalho

Plus de Jose Augusto Carvalho (18)

Trabalhando com Módulos no Puppet
Trabalhando com Módulos no PuppetTrabalhando com Módulos no Puppet
Trabalhando com Módulos no Puppet
 
Orquestração com Mcollective
Orquestração com McollectiveOrquestração com Mcollective
Orquestração com Mcollective
 
Infraestrutura ágil com Puppet - CISL
Infraestrutura ágil com Puppet - CISLInfraestrutura ágil com Puppet - CISL
Infraestrutura ágil com Puppet - CISL
 
Cultura DevOps - Integração entre infra e devel
Cultura DevOps - Integração entre infra e develCultura DevOps - Integração entre infra e devel
Cultura DevOps - Integração entre infra e devel
 
Infraestrutura como código com Puppet e Mcollective
Infraestrutura como código com Puppet e McollectiveInfraestrutura como código com Puppet e Mcollective
Infraestrutura como código com Puppet e Mcollective
 
Cultura DevOps e integração entre infra e devel
Cultura DevOps e integração entre infra e develCultura DevOps e integração entre infra e devel
Cultura DevOps e integração entre infra e devel
 
Oficina de infraestrutura como código (apresentando o Puppet)
Oficina de infraestrutura como código (apresentando o Puppet)Oficina de infraestrutura como código (apresentando o Puppet)
Oficina de infraestrutura como código (apresentando o Puppet)
 
Ferramentas para infraestrutura ágil
Ferramentas para infraestrutura ágilFerramentas para infraestrutura ágil
Ferramentas para infraestrutura ágil
 
Conhecendo o Wordpress
Conhecendo o WordpressConhecendo o Wordpress
Conhecendo o Wordpress
 
Monitoração avançada com Zabbix 2
Monitoração avançada com Zabbix 2Monitoração avançada com Zabbix 2
Monitoração avançada com Zabbix 2
 
O que é DevOps afinal?
O que é DevOps afinal?O que é DevOps afinal?
O que é DevOps afinal?
 
Palestra Puppet Hora Livre
Palestra Puppet Hora LivrePalestra Puppet Hora Livre
Palestra Puppet Hora Livre
 
Oficina Puppet latinoware
Oficina Puppet latinowareOficina Puppet latinoware
Oficina Puppet latinoware
 
Puppet webcast 4linux
Puppet webcast 4linuxPuppet webcast 4linux
Puppet webcast 4linux
 
Oficina Puppet - Aprenda a Gerenciar Configurações
Oficina Puppet - Aprenda a Gerenciar ConfiguraçõesOficina Puppet - Aprenda a Gerenciar Configurações
Oficina Puppet - Aprenda a Gerenciar Configurações
 
Puppet Cloud IaaS
Puppet Cloud IaaSPuppet Cloud IaaS
Puppet Cloud IaaS
 
Consegi 2011: Puppet
Consegi 2011: PuppetConsegi 2011: Puppet
Consegi 2011: Puppet
 
Consegi 2011: Ganeti + Puppet
Consegi 2011: Ganeti + PuppetConsegi 2011: Ganeti + Puppet
Consegi 2011: Ganeti + Puppet
 

Dernier

Assessement Boas Praticas em Kubernetes.pdf
Assessement Boas Praticas em Kubernetes.pdfAssessement Boas Praticas em Kubernetes.pdf
Assessement Boas Praticas em Kubernetes.pdf
Natalia Granato
 

Dernier (6)

ATIVIDADE 1 - LOGÍSTICA EMPRESARIAL - 52_2024.docx
ATIVIDADE 1 - LOGÍSTICA EMPRESARIAL - 52_2024.docxATIVIDADE 1 - LOGÍSTICA EMPRESARIAL - 52_2024.docx
ATIVIDADE 1 - LOGÍSTICA EMPRESARIAL - 52_2024.docx
 
ATIVIDADE 1 - GCOM - GESTÃO DA INFORMAÇÃO - 54_2024.docx
ATIVIDADE 1 - GCOM - GESTÃO DA INFORMAÇÃO - 54_2024.docxATIVIDADE 1 - GCOM - GESTÃO DA INFORMAÇÃO - 54_2024.docx
ATIVIDADE 1 - GCOM - GESTÃO DA INFORMAÇÃO - 54_2024.docx
 
Boas práticas de programação com Object Calisthenics
Boas práticas de programação com Object CalisthenicsBoas práticas de programação com Object Calisthenics
Boas práticas de programação com Object Calisthenics
 
Assessement Boas Praticas em Kubernetes.pdf
Assessement Boas Praticas em Kubernetes.pdfAssessement Boas Praticas em Kubernetes.pdf
Assessement Boas Praticas em Kubernetes.pdf
 
Padrões de Projeto: Proxy e Command com exemplo
Padrões de Projeto: Proxy e Command com exemploPadrões de Projeto: Proxy e Command com exemplo
Padrões de Projeto: Proxy e Command com exemplo
 
ATIVIDADE 1 - CUSTOS DE PRODUÇÃO - 52_2024.docx
ATIVIDADE 1 - CUSTOS DE PRODUÇÃO - 52_2024.docxATIVIDADE 1 - CUSTOS DE PRODUÇÃO - 52_2024.docx
ATIVIDADE 1 - CUSTOS DE PRODUÇÃO - 52_2024.docx
 

Documentando de forma Ágil (usando dokuwiki)

  • 1. WIKI Documentado de forma ágil. José Augusto (Guto) Carvalho gutocarvalho@gmail.com @gutocarvalho Tuesday, April 24, 12
  • 2. Agenda Entendendo Wiki Sintaxe Estrutura Administração Controles de Acesso 46 Slides - 60 a 80 Minutos Tuesday, April 24, 12
  • 4. Wiki: O que significa? Os termos wiki (pronunciado /uíqui/ ou /víqui/) e WikiWiki são utilizados para identificar um tipo específico de coleção de documentos em hipertexto ou o software colaborativo usado para criá-lo. O termo "Wiki wiki" significa "extremamente rápido" no idioma havaiano. Fonte: http://pt.wikipedia.org/wiki/Wiki Tuesday, April 24, 12
  • 5. Para o SysAdmin/DevOps qual parte da documentação é a mais importante? Tuesday, April 24, 12
  • 6. Textos c/ Perfumarias? Formatação complexa? Design refinado? Formato fechado? Isso realmente importa? Tuesday, April 24, 12
  • 7. Nada disso importa, o que importa é o conteúdo. Tuesday, April 24, 12
  • 8. Necessidades do Sysadmin encontrar a informação de forma simples e rápida entender a informação para que ela lhe seja útil ter condições de modificar a informação com objetivo de complementar, atualizar ou corrigir. editar a informação de forma simples e rápida Tuesday, April 24, 12
  • 9. Wiki: Características Acesso através de qualquer navegador/OS Formatação do texto em linguagem MarkDown Edição coletiva/colaborativa (equipe) Rastreamento de mudanças (versionamento) Foco no conteúdo (editor sem distrações) Portabilidade do conteúdo (texto puro) Tuesday, April 24, 12
  • 10. Wiki: Projetos conhecidos MediaWiki (site da wikipedia) Dokuwiki (site de documentação zabbix) MoinMoin (site de documentação projeto apache) Tuesday, April 24, 12
  • 11. Wiki: Listagem de projetos No site wikimatrix.org você irá conhecer diversas ferramentas wiki, neste site você terá condições de avaliar os recursos e as principais diferenças entre estes sistemas. O site concentra informações referentes a grande maioria dos sistemas wiki open-source conhecidos hoje. Tuesday, April 24, 12
  • 14. Dokuwiki: Características 1 Aplicação escrita em PHP Não usa banco de dados Velocidade no uso (por não usar banco de dados) Sintaxe de formatação simples (markdown) Suporte a plugins PHP (muitos plugins disponíveis) Suporte a categorização por namespaces Tuesday, April 24, 12
  • 15. Dokuwiki: Características 2 Suporte a links interwikis (wikipedia/dokuwiki) Upload de imagens e uso de referências externas Buscas ‘FullText Search’ com índices Interface Agradável com recursos Ajax Cache de Páginas Suporte a autenticação Local, LDAP, AD, MySQL e PostgreSQL Tuesday, April 24, 12
  • 16. Dokuwiki: Características 3 Suporte a mais de 50 idiomas Código Fonte Aberto Processo de desenvolvimento bem documentado Syndication (RSS/ATOM) das mudanças recentes Outros ... (http://www.dokuwiki.org/features) Tuesday, April 24, 12
  • 17. Dokuwiki: Diferencial O grande diferencial deste projeto é o fato de [não] utilizar base de dados relacional, tudo é salvo em arquivos no File System. Tuesday, April 24, 12
  • 18. Dokuwiki: Diferencial O fato de não usar banco de dados, proporciona grande velocidade nas rotinas de criação, edição e leitura das páginas wiki, afinal, os dados são consumidos diretamente do filesystem, a aplicação faz a leitura de arquivos (.txt) em formato ASCII, algo simples, rápido, eficiente e universal. Tuesday, April 24, 12
  • 19. Dokuwiki: Diferencial Backup simplificado, basta compactar o diretório do dokuwiki para termos todos os dados salvos. Além disto, cada página é um arquivo de texto (.txt) simples, ou seja, nem precisamos ter um servidor de aplicação instalado para ler os dados, qualquer editor de texto puro consegue ler os dados. Tuesday, April 24, 12
  • 21. Linaguagem Markdown MarkDown é uma linguagem de marcação simples, onde você declara a formatação desejada através de símbolos, estes símbolos orientam a conversão do ‘texto puro’ para uma outra linguagem que normalmente é ((x)html). Referências: http://pt.wikiped ia.org/wiki/Markdown Tuesday, April 24, 12
  • 22. ====== objetivo ======= descreva de forma objetiva, de preferência em uma linha o objetivo dessa wiki para agilizar o entendimento, exemplo: * descrever a instalação de ferramente XPTO no CentOS. ====== descrição ======= Nem sempre a descrição, mas dependendo do manual é bom investir algumas linhas contextualizando a necessidade, exemplo: * a instalacao da ferramenta XPTO foi uma demanda motivada pelo problema XPTO e após análise resolvemos abordar essa solução. ====== procedimento ======= ===== requisitos ===== pacotes/dependencias ===== instalação ===== instalando pacotes, tarballs, permissoes ===== configuração ===== configuracoes em arquivos, servicos, sub-sistemas e no própio aplicativo instalado. ===== operação ===== acesso ao aplicativo e como usar ====== referências ======= sites/links que lhe ajudaram a escrever esse documento, exemplo: * site 1 * site 2 * site 3 Tuesday, April 24, 12
  • 24. Mão na Massa entendendo na prática como criar e editar wikipages Tuesday, April 24, 12
  • 25. Acessando wiki Para acesse a wiki entre em http://wiki.dominio.local Clique em Entrar Utilize seu usuário Clique Dokuwiki (no topo superior direito) Clique em Playground Tuesday, April 24, 12
  • 26. [[area:nome|descrição]] [[playground:teste do guto|Página teste do Guto]] criando página Tuesday, April 24, 12
  • 27. //Itálico// __sublinhado__ **negrito** <del> tachado <del> Formatação Simples Tuesday, April 24, 12
  • 28. Lista não Lista ordenada ordenada - Alfredo * Alface - Bernardo * Tomate - Camila * Cebola - Daniel * Alho - Euclides dois espaços no inicio da linha antes do simbolo Listas Tuesday, April 24, 12
  • 29. http://www.google.com www.google.com [[http://www.google.com | Acesse o google]] [[wp > wiki]] [[infraestrutura:modelo de projeto|Visualize o modelo de Projeto]] links Tuesday, April 24, 12
  • 30. {{area:nome.png | descricao caption}} {{url | descricao caption}} {{wiki:fotoguto.png | Foto do Gutocarvalho}} {{infraestrutura:racks.png | Foto dos Racks do CPD}} {{www.site.com/logo.png | Logo do Detran}} Imagens Tuesday, April 24, 12
  • 31. ^Nome^Telefone^ | Jose Augusto | 5555-5555 | | Fernando | 5555-5555 | Tabelas Tuesday, April 24, 12
  • 32. Execute o comando (dois espaços) comando 1 comando 2 <code> conteúdo longo </code> Destacando Texto Tuesday, April 24, 12
  • 33. <file php arquivo.php> <?php echo "hello world!"; ?> </file> Conteúdo Arquivo Tuesday, April 24, 12
  • 44. Protegendo Páginas Wiki [[área:nome|descrição]] [[infraestrutura:nome|descrição]] [[infraestrutura:procedimentos:nome|descrição]] [[infraestrutura:ambiente:nome|descrição]] [[infraestrutura:processos:nome|descrição]] [[desenvolvimento:nome|descrição]] [[desenvolvimento:testes::nome|descrição]] [[desenvolvimento:homologação::nome|descrição]] [[playground:nome|descrição]] Tuesday, April 24, 12
  • 45. Perguntas? (5 min) José Augusto (Guto) Carvalho gutocarvalho@gmail.com http://gutocarvalho.net @gutocarvalho Tuesday, April 24, 12
  • 46. Obrigado José Augusto (Guto) Carvalho gutocarvalho@gmail.com http://gutocarvalho.net @gutocarvalho Tuesday, April 24, 12