====== Wiki da Gesto Energia ====== -> [[wp>Wiki|O que é um wiki?]] <- O Wiki (que estás neste momento a ler!) é um site de documentação interna. Foi criado para centralizar a documentação técnica da área de desenvolvimento de software e manutenção da infraestrutura web da Gesto. |**Não deve, em caso algum, ser acedido por pessoas externas à empresa!**| ===== Âmbito ===== Um wiki é um sistema de documentação genérica que pode servir qualquer fim. No caso da Gesto, uma vez que há uma grande quantidade de documentação no que diz respeito a desenvolvimento e configuração de software e infraestrutura, justifica-se a utilização de um repositório de informação em vez de documentos estáticos. À data da criação do wiki (junho de 2020) não se prevê que este wiki seja utilizado por outras áreas da empresa, embora nada o impeça. ===== Como utilizar ===== A página de entrada [[:start]] dá uma visão geral das páginas e da sua lógica de organização. Não há um critério muito rígido sobre quando um tema deve estar contido apenas numa página, ou dividido por várias. Como regra genérica, deve usar-se o critério da quantidade de informação com que o utilizador é confrontado, que pode justrificar a divisão de um tema em várias páginas. As alterações mais recentes podem ser consultadas em [[https://wiki.gestoenergy.com/doku.php?id=start&do=recent|Recent Changes]]. As áreas temáticas dividem-se em //namespaces// (equivalentes a categorias), e todas as páginas do wiki estão listadas em [[https://wiki.gestoenergy.com/doku.php?id=start&do=index|Sitemap]]. Estes links estão sempre disponíveis na barra lateral à esquerda. A filosofia de escrita num wiki é a de que o conteúdo tem prevalência sobre o estilo. É semelhante à forma de utilizar sistemas de preparação de documentos (como o [[https://en.wikipedia.org/wiki/LaTeX|LaTeX]]) em que se definem os conteúdos na escrita (com a devida hierarquização) e o sistema trata de gerar o estilo. Como tal, a escrita de documentos segue uma sintaxe determinada, e não usa formatação direta (por oposição a editores [[https://en.wikipedia.org/wiki/WYSIWYG|WYSIWYG]]). A sintaxe completa pode ser consultada em [[wiki:syntax]]. ==== Esquema da página ==== O conteúdo principal da página é apresentado ao centro, (assinalado com o número **3**). No início da página está indicada a localização da página atual, de acordo com a organização interna do Wiki (o caminho é visível na barra com o número **2**). {{ :web:wiki_main.png?direct&600 |}} À esquerda existe uma barra lateral (fixa) com os principais links internos do Wiki (**1**), e à direita está a tabela (variável) de conteúdos da página atual (**4**), de acordo com os //headings// (cabeçalhos) e respetivos níveis definidos. No topo existe uma barra permanente que inclui, além do link para a //home// do Wiki (o título), uma caixa de pesquisa de texto, e o menu// drop-down// do utilizador (**5**), que inclui o perfil pessoal e o //link// de fim de sessão. A página atual oferece no topo do conteúdo principal cinco ícones, respetivamente, da esquerda para a direita: {{ :web:botoes.png?direct&200 |}} - Editar página atual (remete para caixa de edição) - Ver lista de versões anteriores da página (histórico) - Ver lista de página que ligam à atual - Alterar o nome da página - Topo ===== Detalhes técnicos ===== Este wiki é uma instalação do software open-source [[http://dokuwiki.org|DokuWiki]]. Tem atualmente ativo o tema/template [[https://www.dokuwiki.org/template:argon-alt|Argon Alternative]], além de outros temas também instalados. Foi instalado, via cPanel/Softaculous, no [[web:configuração geral|alojamento]] web da Gesto. O subdomínio ''wiki.gestoenergy.com'' está apontado para a respetiva pasta de instalação: ''/home/gestoene/wiki''. O DokuWiki corre sobre PHP e tem como vantagens em relação a outros wikis: * Instalação pequena (~20MB) * utilização de ficheiros de texto em vez de bases de dados (simplicidade de configuração/migração) * desenvolvimento ativo e comunidade grande Apresenta como principal desvantagem: * incompatibilidade da sintaxe com outros wikis, nomeadamente com MediaWiki (o wiki mais disseminado, utilizado pela Wikipédia). Existem contudo plugins/ferramentas que fazem esta conversão da sintaxe, caso se queira migrar para outro wiki. ====Configurações ==== Os plugins, restante configuração do wiki, devem ser feitos através da interface de administração. Para tal, deve fazer-se login com o utilizador ''admin'' (consultar [[other:credentials]]). Ao utilizar este login é possível aceder, via menu //drop-down// no topo, à interface de Administração: {{ :web:admin.png?direct&400 |}} Daqui pode aceder-se às configurações gerais, entre as quais o //extension manager//, que permite instalar templates e plugins para outras funções. Em alternativa, caso não se consiga aceder ao interface de Administração por alguma razão, é possível instalar manualmente um plugin. Por exemplo, para escrever texto com cor vermelha, estamos a utilizar um plugin DokuWiki chamado "color Plugin", instalado manualmente. Para tal: * Seguir para a respectiva página ([[https://www.dokuwiki.org/plugin:color]]) * Fazer "[[https://github.com/hanche/dokuwiki_color_plugin/archive/2018-10-12.zip | Download]]" do ficheiro .zip * Fazer "Upload" do .zip para a pasta de plugins no alojamento da página, isto, é no File Manager do CPanel ( [[https://cpanel.gestoenergy.com/cpsess9254237938/frontend/paper_lantern/filemanager/index.html | wiki/lib/plugins/ ]] ) * Fazer "Extract" do .zip e mudar o nome da pasta extraída para "color" (e apagar o .zip original).