Differences

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

--- web:wiki [2020/08/19 11:30]
frederik.eistrup [Detalhes técnicos]
+++ web:wiki [2020/09/10 10:55] (current)
miguel.santos [Detalhes técnicos]
@@ Line 13: / Line 13: @@
 ===== 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.
@@ 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 sinatxe completa pode ser consultada em [[wiki:syntax]].
+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**).
-À 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)
-  - 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
   - Alterar o nome da página
   - 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 =====
-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''.
@@ Line 45: / Line 54: @@
   * 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.
-===== Instalação de Plugins =====
+====Configurações ====
-Por exemplo para escrever texto com <color red> cor vermelha </color>
+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).