Você ainda segue o ‘livro’ quando se trata de aprender algo novo?
Bem, eu faço!
E tenho certeza que muitos de vocês concordariam com isso.
Na era dos smartphones, vídeos e áudio, ninguém pode negar a existência dos livros. Eles também evoluíram conosco e se tornaram disponíveis digitalmente na forma de eBooks, base de conhecimento, documentação de produtos e muito mais.
Aposto que ninguém pode esquecer wikis populares como a Wikipedia!
Muitos de vocês esperam encontrar informações sobre seu jogador de futebol favorito, cantor pop, tecnologias e outros campos.
Você sabia que a Wikipedia tem atualmente mais de 50 milhões de páginas em 314 idiomas?
Agora você sabe!
Você está interessado em criar um site como a Wikipedia ou uma base de conhecimento que oriente seus clientes sobre seus produtos?
Sorte sua, este artigo é exatamente sobre isso!
Aqui, falarei sobre o que é o software wiki, como ele pode ajudá-lo e, em seguida, algumas soluções auto-hospedadas para ele.
últimas postagens
O que é software wiki?
O software Wiki é a solução de software que você pode utilizar para criar, compartilhar e editar conteúdo, colaborar e organizá-lo de forma eficaz.
Você pode instalá-lo em um servidor facilmente e executá-lo como um aplicativo da web. Todo o conteúdo criado dentro desse ambiente normalmente é armazenado em um banco de dados eficiente. O software também pode ser chamado de mecanismo wiki.
As empresas precisam de software wiki para criar uma base de conhecimento e documentação do produto que ajude os usuários a obter as informações de que precisam sobre seu produto e serviço. Torna-se um guia para iniciantes e usuários iniciantes cujas perguntas podem ser facilmente abordadas no documento.
Casos de uso de um software wiki
- Para armazenar e compartilhar o conhecimento e as instruções para seus produtos/serviços.
- Wiki interno para colaboração em equipe
- Wiki de sala de aula para professores que podem compartilhar materiais e guias do curso com os alunos
- Gere ideias e publique-as no wiki para que as pessoas possam adicionar mais sugestões a ele
- Trabalhar como manuais
- Tutoriais e instruções
- Você pode apresentar discussões por e-mail em um wiki.
- Funciona como um blog para CEOs, gerentes e funcionários
Por que você precisa de um software wiki?
Existem muitos benefícios. Vamos explorar alguns deles.
Conteúdo pesquisável 🔍
O software Wiki permite que as pessoas recuperem informações arquivadas facilmente com um mecanismo de pesquisa embutido.
Assim, os usuários não terão problemas para acessá-lo, mesmo que você coloque toneladas de informações dentro dele. Mas para que isso aconteça, você precisa organizar as informações em um formato legível e adequado, tornando mais acessível para as pessoas procurarem o que querem ler.
Colaboração eficaz
Wiki promove a colaboração onde cada membro de sua equipe pode contribuir, compartilhar seus conhecimentos e fazer esforços para melhorar o conteúdo como um todo.
Por outro lado, as soluções não wiki não lhe dão esse luxo porque apenas a pessoa que publica o conteúdo ou o editor atribuído a ele só pode editar o conteúdo.
Controle de qualidade 💯
Caso seu editor tenha cometido um erro em um documento, outros membros de sua equipe ou comunidade podem corrigi-lo imediatamente. Dessa forma, o erro não será detectado pelos usuários finais que podem ficar confusos sobre uma instrução específica que pode dificultar a presença da sua empresa.
Tomada de decisão descentralizada 🤔
Um wiki permite que você execute ações descentralizadas em seus documentos, onde as pessoas podem tomar decisões que você pode revisar posteriormente.
É melhor do que buscar permissão sempre de um tomador de decisões centralizado que pode não tomar decisões dentro do prazo.
Chega de teoria, é hora do show agora!
Há muitos softwares wiki comerciais e de código aberto que você pode instalar em seu servidor. Obtenha uma VM na nuvem de sua escolha e instale qualquer uma das soluções a seguir.
Wiki.js
Wiki.js é um poderoso software wiki de código aberto que torna a documentação um passeio divertido com sua interface intuitiva. É compatível com MariaDB, PostgreSQL, MySQL, SQLite ou MS-SQL Server e funciona praticamente em qualquer plataforma. Wiki.js é executado em Node.js, que oferece um desempenho extremamente rápido.
Você obtém a flexibilidade de personalizar a aparência de sua documentação através do modo escuro ou claro. Torne o wiki privado, público ou uma combinação de ambos, o que você achar certo. Ele utiliza de forma inteligente os recursos disponíveis, seja uma VM de alto desempenho ou um Raspberry Pi.
O Wiki.js é fácil de instalar em poucos minutos por meio de guias passo a passo. Ele oferece módulos abrangentes que você pode ativar/desativar com base nas necessidades, se você falar sobre recursos. Para autenticação, ele possui autenticação integrada, incluindo recuperação de senha e recursos de autorregistro.
Você também pode integrar serviços de autenticação de terceiros, como GitHub, Google, Microsoft, Auth0, LDAP, Okta e muito mais, juntamente com 2FA. Ele tem o editor de markdown popular com uma barra de ferramentas e uma visualização ao vivo, um editor WYSIWYG fácil de usar que não técnicos podem usar e HTML simples para importar páginas pré-formatadas.
O Wiki.js também introduzirá a migração de conteúdo usando WikiText, tabular e um editor otimizado para REST/GraphQL. Você pode rastrear modificações de conteúdo, comparar versões para ver a diferença, reverter para o estado anterior ou até mesmo recuperar páginas excluídas ou exportar uma versão de página. Está disponível em mais de 40 idiomas e também suporta idiomas RTL nativos.
Você pode gerenciar ativos de mídia, editar as imagens, destacar códigos, gerar diagramas, renderizar expressões matemáticas e adicionar vídeo e áudio. O Wiki.js vem com um mecanismo de pesquisa integrado e suporta pesquisa na nuvem, Elasticsearch e outros mecanismos como Sphinx, Manticore, etc.
Faça backup de conteúdo usando GitHub, Azure DevOps, GitLab, DigitalOcean Spaces, Google Cloud Storage, Dropbox, Box, Google Drive, etc.
Instale o wiki.js na VM, Docker, Kubernetes ou imagens de nuvem pré-criadas da DigitalOcean e AWS.
DokuWiki
O altamente versátil DokuWiki é de código aberto e é conhecido por sua simplicidade e eficácia durante a documentação. Ele não precisa de um banco de dados e é apreciado por desenvolvedores e usuários por sua sintaxe legível e limpa. Outros pontos a favor do DokuWiki são a fácil manutenção, integração e backup.
Ele também vem com conectores de autenticação e controles de acesso integrados, tornando-o ainda mais útil para empresas. A vibrante comunidade do DokuWiki contribuiu com muitos plugins para vários casos de uso além de um wiki tradicional. Você pode facilmente adicionar novas páginas e atualizá-las rapidamente.
Os desenvolvedores projetaram o DokuWiki para ser uma ferramenta eficaz de colaboração e manutenção de um registro de todas as alterações feitas. Os diferentes casos de uso do DokuWiki são:
- Manual do software
- Base de conhecimento
- Bloco de notas privado
- CMS – intranet
- Espaço de trabalho do projeto
O DokuWiki oferece muitas vantagens, como facilidade de instalação, menos requisitos de sistema, muitas extensões, controles de acesso integrados, suporte a mais de 50 idiomas e independência de dispositivo. Ele permite uma configuração fácil e oferece muitos modelos e plugins.
Se você precisa do DokuWiki na nuvem, pode tentar Kamateraque oferece instalação com um clique e oferece a opção de hospedar em 13 data centers em todo o mundo.
MídiaWiki foi criado por cientistas seniores no ano de 2002. É um software wiki de código aberto e gratuito que capacita milhares de sites, organizações e empresas. Inclui wikis populares como Wikipedia, Wikimedia Commons, Wikcionário e muitos mais.
O MediaWiki ajuda a coletar conhecimento, organizá-lo e, então, tornar o conhecimento disponível para todos. O software é poderoso, extensível, confiável e multilíngue. Ele é escrito em PHP, o que facilita a inicialização na pilha LAMP. Ele já foi implantado extensivamente por anos; é agora uma das soluções wiki mais robustas disponíveis no mercado.
O MediaWiki vem com recursos úteis e opções de organização que o tornam uma ótima opção para o wiki corporativo. Você tem a opção de personalizar com a ajuda de modelos e adicionar mais funcionalidades instalando extensões úteis.
Para hospedagem MediaWiki, você pode tentar o A2 plataforma.
XWiki
Novamente, mais uma solução wiki de código aberto para você – XWiki, que é escrito em Java. Você pode usá-lo como um wiki de 1ª geração ou um wiki de 2ª geração. Os wikis de 1ª geração são principalmente para colaboração de conteúdo, enquanto os wikis de 2ª geração são para criar aplicativos da web colaborativos.
Os exemplos de 2ª geração podem ser blogs que comunicam informações e as organizam com fóruns e tags. Essas plataformas permitem que os participantes discutam tópicos valiosos e promovam soluções de gerenciamento de tarefas para criar e distribuir tarefas associadas a projetos. XWiki apresenta um editor WYSIWYG intuitivo e robusto junto com a sintaxe wiki.
Os desenvolvedores principais e a comunidade XWiki fornecem 600 extensões, incluindo plugins, temas, skins, macros e aplicativos. Do gerenciamento à colaboração, ele oferece tudo perfeitamente para que você possa tornar sua documentação um grande sucesso.
Pilha de livros
Uma plataforma simples para armazenar e organizar informações usando Pilha de livros.
Um dos USPs do BookStack é sua simplicidade; seu editor de páginas inclui uma interface simples com WYSIWYG. Você pode dividir o conteúdo em 3 grupos do mundo real – páginas, capítulos e livros. Todo o conteúdo do BookStack é pesquisável nesses três grupos e no próprio nível do livro.
Mantenha a documentação conectada vinculando qualquer parágrafo diretamente. Configure o BookStack com base em seu caso de uso específico e altere o logotipo, o nome e os campos de registro. Além disso, você pode alterar a visibilidade do sistema e optar por visualizá-lo publicamente ou não.
BookStack é alimentado pelo framework PHP, Laravel, com MySQL como banco de dados. Como resultado, qualquer que seja a VM que você use, o desempenho dificilmente seria um problema. Além dos poderosos recursos de vinculação e pesquisa, você obtém classificação entre livros, gerenciamento de imagens e revisões de páginas.
Usando o sistema de permissões e funções, você também pode bloquear ações e conteúdo conforme necessário. Graças à comunidade deles, você pode definir seu idioma preferido, como inglês, francês, espanhol, italiano, japonês, russo, alemão, holandês, etc.
Você é fã do Markdown?
Boas notícias!
O BookStack o suporta, além de visualizações ao vivo de tudo o que você escreve em sua documentação. Ele também permite a integração com provedores de autenticação como Okta, LDAP, Google, Slack, GitHub e AzureAD.
Gollum
Se você quer um frontend local e uma API doce, Gollum é seu amigo.
Não, não estou falando do ‘Gollum’ do Senhor dos Anéis.
Em vez disso, este Gollum é uma solução wiki simples e baseada em Git para documentação. Suas páginas podem ser categorizadas em diretórios da maneira que você quiser.
Você também pode incluir outros conteúdos como PDFs, cabeçalhos ou rodapés, imagens, etc. As páginas Gollum podem ser escritas em marcações de diferentes tipos, e qualquer mudança que seu sistema de editor faça pode ser imediatamente visível. Você também pode exibir e reverter páginas em várias versões.
O Gollum é compatível com wikis do GitHub e suporta funcionalidades de ponta, como diagramas UML, anotações com CriticMarkup, matemática usando MathJax, redirecionamentos, macros, feed RSS, citação, BibTeX e muito mais. Ele funciona em sistemas do tipo Unix, mas você pode usá-lo no Windows usando JRuby.
Contorno
Contorno é considerada uma das soluções wiki mais rápidas para empresas em crescimento. Ele permite que você crie páginas bonitas e ricas em recursos e também é compatível com markdown. Este software é criado usando Node.js e React para que você possa pensar em seus benefícios como alta velocidade, melhor desempenho e programação mais simples.
Para armazenamento de arquivos, ele oferece suporte ao armazenamento de objetos compatível com AWS S3 ou S3.
Conclusão
Se você tem uma pequena ou média empresa ou mesmo uma grande empresa, pode criar uma base de conhecimento, colaborar nela e conscientizar seu cliente sobre seus produtos. E tudo isso é possível usando uma solução wiki discutida acima.
Assim, escolha a solução que você encontrar que tenha recursos que você possa utilizar e dê um passo à frente para atender mais seus clientes.
Se você não estiver pronto para optar por uma solução auto-hospedada, você pode, alternativamente, tentar plataformas wiki hospedadas.