• Show page
  • Old revisions
  • Backlinks
  • Back to top
    • Back to top

    Differences

    This shows you the differences between two versions of the page.

    Link to this comparison view

    Next revision     		Previous revision
    web:wiki [2020/06/18 10:03]
    miguel.santos created     		web:wiki [2020/09/10 10:55] (current)
    miguel.santos [Detalhes técnicos]
    Line 1: Line 1:
     ====== Wiki da Gesto Energia ====== ====== Wiki da Gesto Energia ======
      
    --> [[http://en.wikipedia.org/wiki/Wiki|O que é um wiki?]] <- +-> [[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. 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.
    Line 13: Line 13:
     ===== Como utilizar ===== ===== 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 desmultiplicação de um tema em várias páginas.+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. 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.
    Line 19: Line 19:
     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 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 sinatxe completa pode ser consultada em [[wiki:syntax]]. +A sintaxe completa pode ser consultada em [[wiki:syntax]]. 
      
     ==== Esquema da página ==== ==== 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**).
      
    -À esquerda existe uma barra lateral com os principais links internos do Wiki, e à direita está a tabela de conteúdos da página atual, de acordo com os headings (cabeçalhos) e respetivos níveis definidos. A página atual oferece no topo quatro ícones, respetivamente, da esquerda para a direita:+{{ :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)   - Editar página atual (remete para caixa de edição)
    -  - Ver lista de versões anteriores da página +  - Ver lista de versões anteriores da página (histórico)
       - Ver lista de página que ligam à atual   - Ver lista de página que ligam à atual
       - Alterar o nome da página   - Alterar o nome da página
       - Topo   - Topo
      
    -O conteúdo principal está no corpo central da página, e a barra superior permite utilizar a pesquisa e aceder ao perfil de utilizador/configurações.+
      
     ===== Detalhes técnicos ===== ===== 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|Argon]], apesar de ter já outros temas também instalados.+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''. 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''.
    Line 44: Line 53:
     Apresenta como principal desvantagem: 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.   * 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 <color red> cor vermelha</color>, 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).

    web/wiki.1592474607.txt.gz · Last modified: 2020/06/18 10:03 by miguel.santos