wiki

Wiki

Revisão de 13h39min de 27 de março de 2018 por Lclaudio (discussão | contribs) (→Roadmap Fase II)

Instalações



Tutorial de como editar os menus da barra lateral

IMPORTANTE

  • Todo conteúdo a ser adicionado/editado na wiki, que seja a nivel do software "mediawiki" provavelmente será editado no arquivo "LocalSettings.php" na pasta que foi indicado a ser instalado
  • A barra lateral é um código que pertence ao software da mediaWiki, somente um usuário com permissão pode alterar partes do software 'mediaWiki'

Consultando o grupo que o usuário se encontra

  • na SideBar ( logo a esquerda) tem uma parte chamada "ferramentas > Páginas especiais" , ou pelo link "//yourdomain/mediawiki/index.php/Especial:P%C3%A1ginas_especiais "
  • nas paginas especiais, há uma série de ações que um usuario pode fazer, para mudar um usuário de grupo, procurar o tópico "lista de usuarios"
  • procurar o usuário em questão e identificar os grupos que ele está presente :
    • Fulano da Silva (Burocrata, Administrador, Porteiro, Colecionador_de_tampinhas)
      • lembrando que os grupos estão entre parenteses


Alterando o usuario de grupo

  • Somente um usuário em um grupo com permissão de "administrador" tem acesso a estas funções na wiki
  • na SideBar ( logo a esquerda) tem uma parte chamada "ferramentas > Páginas especiais" , ou pelo link "//yourdomain/mediawiki/index.php/Especial:P%C3%A1ginas_especiais "
  • nas paginas especiais, há uma série de ações que um usuario pode fazer, para mudar um usuário de grupo, procurar o tópico "Gestão de Privilégios de Usuários" e

então procurar o usuario em questão, e coloca-lo em um grupo com permissão, ou que receberá a permissão futuramente.


Alterando a permissão do usuario

  • para editar o menu de navegação é preciso que o usuário tenha permissão
    • caso o usuario já seja administrador da wiki, não é necessário realizar nenhum procedimento, caso contrário, é preciso habilitar o grupo que ele se encontra com a permissão devida


  • faça um backup do arquivo "LocalSettings.php" para caso der algum erro não perder o trabalho todo, salve uma cópia do original em outro diretório(que você se lembre posteriormente)
  • adicionar ao final do arquivo "LocalSettings.php" o seguinte código :
    • # $wgGroupPermissions['GRUPO']['PERMISSAO'] = true
      • para criar um novo grupo, pois os grupos default podem não ser suficientes para o número de usuarios e/ou contexto, adicione:
      • # $wgGroupPermissions['NOME DO NOVO GRUPO']['PERMISSAO'] = true
    • Consultar a lista de perimssões na pagina :
  • salvar o arquivo e ir por proximo passo

Alterando o menu

  • ir ao campo de pesquisa e digitar mediawiki:Sidebar, ao aparecer a página ir na opção de editar e realizar o procedimento

ou então...

  • Utilizar o endereço abaixo para editar a SideBar da wiki:
    • "//yourdomain/yourwiki/index.php?title=MediaWiki:Sidebar&action=edit" - editar barra lateral
  • o link a seguir fornece algumas instruções de possibilidades de como alterar o menu, mas basicamente é como uma página comum da wiki:


Features


Colocando "Artigos em Destaque"

O que é ?

O "Espaço" Artigos em Destaque serve para colocar em exposição alguns artigos que possuem um
destaque suficiente para ser exibido na primeira página ou em uma página de grande acesso.


Não é um plugin instalado ou então uma ferramenta tão complexa, somente um link colocado no "código" da pagina que exibe o conteúdo
de uma página dentro da outra. a opção é encontrada no proprio programa da mediawiki, chamada "Transclusion" ou do portugues "inclusão"

Como fazer

  • Para se fazer uma inclusão é preciso que a pagina que se deseja incluir já exista. Caso não exista crie a página coloque seu conteúdo para depois inclui-la em outra página


  • utilizando duas chaves {{ : nome_da_pagina }}
    • pode-se colocar o texto em diversos formatos, dentro de tabelas, e etc, como no exemplo abaixo:
Artigos em Destaque
{{:pagina|seção}}

Opçoes de Inclusão

Op 1: Por seções

  • Para definir uma seção utiliza-se as tags :<section> como no exemplo:
<section begin=capitulo1 /> Este é o capitulo 1<section end=capitulo1 />


Op 2: Incluir uma seção

  • Utilizando a função #lst para fazer a inclusão
**Ex: Para incluir a seção chamada "capitulo1" de uma pagina chamada "articleX": 


{{#lst:articleX|capitulo1}}

O arquigo em destaque já define automaticamente o local da seção, essa é uma função determinada pela função de analise '#lst'

Op 3: Incluir pagina mas excluir seção

Para incluir a pagina mas excluir uma seção especifica, usa-se a função #lstx: 

{{#lstx:articleX|capitulo1}}

É possível colocar um texto no lugar da seção substituida. 

{{#lstx:articleX|capitulo1|pagina ou texto a ser substituido}}

Exemplo: 

{{#lstx:articleX|capitulo1|Veja capitulo 1 em [[articleX]].}}

A substituição do texto vai aparecer na área onde o texto original da seção deveria aparecer

Retirado de: Transclusion

Restringir o acesso a uma página

Para restringir o acesso à determinada página ou grupo de páginas, é necessário criar um grupo e adicionar os usuários que podem acessar a página a esse grupo.

Criar um grupo

Para criar um novo grupo acesse : yourdomain/index.php/Especial:AccessControlPanel, adicione um novo grupo e depois adicione os usuários que farão parte desse novo grupo.

  • Caminho:
    • Páginas especiais
    • Outras páginas especiais
    • Access control panel


Criar a página que será restrita

Para a página ser restrita, ela deve fazer parte do namespace do grupo criado. Por isso, o nome da página de seguir a estrutura "NomeDoGrupo:Título Da Página". Quando a página é criada dessa forma, ela já passa a receber todas as permissões do grupo.

Permissões padrão

As permissões padrão para o namespace de um grupo são de leitura e escrita para usuários do grupo e os administradores e bloqueada para os demais membros. As permissões podem ser alteradas no Access Control Panel.




Descrição páginas

Portal Comunitário:

Esta página visa mostrar o que está acontecendo no SourceInnovation, informar sobre as notícias, tarefas e colaborações atuais assim como apresentar meios de como interagir com outros usuários.



Eventos Atuais

É uma configuração da wiki que redireciona para uma página que mostra as informações dos principais eventos. A página de eventos pode ser alterada de acordo com as permissões atribuídas a ela. Para alterar a configuração é necessário acessar o link http://sourceinnovation.com.br/index.php/MediaWiki:Currentevents-url e colocar a nova página de eventos, para realizar essa alteração é necessário ter privilégios de administrador.



Página aleatória

Página aleatória é uma página especial que conduz o usuário para uma página da wiki escolhida aleatoriamente.



Páginas afluentes

A ferramenta páginas afluentes é uma página especial que permite saber quais páginas contêm uma ligação interna para a que se está visualizando, assim como as páginas que a incluem integralmente (embedded). Ao usar esta ferramenta, é mostrada uma listagem de outras páginas disposta por ordem alfabética ou cronológica, com as mais antigas no topo da lista. Caso um artigo não possua afluentes, ele é considerado como uma página orfã, ou seja, uma página à qual não se pode aceder através de nenhuma outra.



Alterações relacionadas.

Esta página lista alterações feitas recentemente em páginas com links na página em q você se encontra (ou de membros de uma categoria especificada). Páginas de sua lista de páginas vigiadas são exibidas em negrito



Mostra a ultima alteração feita na página



Fórum de Conversação

É um fórum em uma nova página especial, as páginas do fórum são indexadas pelos buscadores (como o Google) e podem ser perquisadas pela função de busca interna.



Vigiar

Quando escolhemos vigiar uma página, ela será incluida na nossa listagem de Páginas_vigiadas. O modo de exibição Páginas vigiadas serve para acompanhar alterações, de forma similar a exibição dada pela página “Recent changes” , mas limitada a mostrar apenas as alterações ocorridas nas páginas que você incluiu na sua lista de páginas vigiadas. Acessamos esta visualização clicando no link “watchlist” localizado a direita na parte superior, porém este link só esta disponível para usuários que estiverem registrados e logados no sistema.



Proteger

Protege uma página contra edição e movimentação. Os Administradores podem editar páginas protegidas, proteger e desproteger páginas contra edição e movimentação. As versões de proteção de edição são:

  • Semi-proteção: protege páginas contra edição de usuários não-registrados.
  • Proteção total: protege páginas contra edição de usuários sem prvilégios de administrador.
  • Proteção em cascata: combinada com a proteção total: protege páginas contra edição de usuários sem prvilégios de administrador, mas também protege imagens carregadas na página, desde que estejam no mesmo local (e não no Commons), e também aplicando a mesma proteção para páginas transcluídas enquanto elas permanecem transcluídas na página (isso funciona recursivamente).
  • combinada com a semi-proteção: não faz sentido e deve ser evitada (veja bugzilla:8796); aplica-se uma proteção total para páginas transcluídas enquanto elas permanecem transcluídas na página (de novo recursivamente).



Roadmap Fase I


30/12

  • Backup e Restore
    • Implementar diariamente backup de toda a base do SourceInnovation e testar restauração


15/12

  • Novo Skin
    • Alterar o skin do sourceinnovation. Gustavo Gomes já fez o teste e falta efetivamente colocar em produção


31/12/

  • Implementar novas features:
    • Gerenciador de Livros
    • Semântica


22/09

  • Problema Resolvido:
    • Incompatibilidade da wiki com o PCRE 8.34, foi necessário adição de um script da página Magic World


Roadmap Fase II


  • Restrição de acesso
    • Implementar uma extensão que configura a restrição de acesso a determinadas páginas


  • Envio de email
    • Provavelmente existe uma restrição de portas no container do Docker


  • Implantar nova versão - 1.26 para 1.29
    • Mapeamento de páginas: Descobrir como é feito o mapeamento de páginas na MediaWiki
    • Backup do Banco de Dados
    • Backup dos arquivos necessários


Backup and Restore



Backup

Neste tutorial ensinaremos de maneira bem simples como fazer backup da base de dados para uma máquina qualquer. No site da mediaWiki [ http://www.mediawiki.org/wiki/Manual:Backing_up_a_wiki ] têm as várias maneiras de como é possível fazer o backup, porem neste tutorial será abordado de como se deve proceder para fazer um backup automatizado visto que é inviável fazer backups manuais todos os dias. Primeiramente será necessário a instalação do mysql client no linux [ apt-get install mysql-client-5.5] Tendo o mysql instalado podemos testar o script abaixo para testes: 


              #!/bin/sh
              # mysqlBackup.sh
              DATA=`/bin/date +%Y%m%d`
               # NOME armazena o nome do arquivo de backup, neste casoi
               NOME="/home/usuario/-$DATA.sql"
                # variáveis do MySQL
               HOST="srv46.hosting24.com"       #host do db desejado
              USER="sourcein_alex"                   #usuário do db
              PASSWORD="ctbc1234"                #password do db
              DATABASE="sourcein_wikiAlgar"    # database desejado
               mysqldump -h $HOST -u $USER -p$PASSWORD --databases $DATABASE > $NOME

Podemos testar o script no terminal [ sh <nomeDoArquivo> ] Se tudo ocorrer bem agora configuraremos uma rotina para realizar este comando automaticamente, para isto é necessário usar o cron.

Geralmente o Cron se encontra /var/spool/cron/ Entre com o comando crontab -e

Feito isto estará disponível para edição com o vi A configuração funciona da seguinte forma:

[minutos] [horas] [dias do mês] [mês] [dias da semana] [usuário] [comando]

ex: 30 22 20 * * echo "Não entre em pânico" > /home/alecrim/infowester.txt

Assim no dia 20 as 22h30m o comando será executado

Restore

Abra o phpmyadmin do cpanel , loga, escolha o banco de dados sourcein_wikiAlgar. Clique em Importar, selecione Procurar, escolher o arquivo SQL texto simples descompactado e importá-lo. Lembre-se de restaurar também componentes do sistema de arquivos do wiki que pode ser necessária, por exemplo. imagens, logotipo e extensões, (ver acima em mysql). Dependendo das configurações de tempo de espera eo tamanho do arquivo de SQL, pode levar várias tentativas de importar tudo. Não conclusão da importação pode deixar o banco de dados em um estado inconsistente, por exemplo com revisões em falta.


Extensão S5


Estrutura do Código


Diagrama de Classes


Diagrama de Casos de Uso


Detalhamento


Skins

As skins disponiveis para a wiki se encontra no link: https://www.mediawiki.org/wiki/Category:All_skins

Instalação

No link onde cada skin se encontra, existe um tutorial para fazer a instalação. Entretanto a maior parte das skins seguem o seguinte padrão:

1 - Baixe a skin desejada: https://www.mediawiki.org/wiki/Category:All_skins

2 - Extraia o pacote na pasta de skins: /var/www/html/wiki/skins

3 - Edite o arquivo LocalSettings.php 

  1 - Adicione a seguinte linha de código com o nome da skin: wfLoadSkin( 'NomeSkin' );
  2 - Altere a linha com o nome da skin: $wgDefaultSkin = "NomeSkin";

4 - Algumas skins podem conter mais algumas configurações

5 - Apos isso, é só salvar.

Melhores skins

Segue os melhores momentos: 

DeepSea: https://www.mediawiki.org/wiki/Skin:DeepSea
Pivot: https://www.mediawiki.org/wiki/Skin:Pivot
Greyt: https://www.mediawiki.org/wiki/Skin:Greyt
Gamepress: https://www.mediawiki.org/wiki/Skin:Gamepress
Cavendish: https://www.mediawiki.org/wiki/Skin:Cavendish
Bswiki: https://www.mediawiki.org/wiki/Skin:Bswiki
BootStrapSkin: https://www.mediawiki.org/wiki/Skin:BootStrapSkin]

Utilizando um Carrossel de imagens

1 - Envie a imagem que deseja adicionar na página especial Enviar Arquivos .

2 - Na página onde deseja adicionar o carrossel, clique em Editar Código Fonte, logo ao lado do título.

3 - Adicione as seguintes linhas de comando no editor: <syntaxhighlight lang="html" line="1"> <slideshow sequence="random" transition="fade" refresh="10000"> </slideshow> </syntaxhighlight>

4 - Para adicionar uma imagem, coloque entre as duas linhas do passo anterior a seguinte linha, substituindo "imagem,jpg" pelo nome da imagem enviada no passo 1. <syntaxhighlight lang="html" line="1">

Caption 1

</syntaxhighlight> 5 - Para adicionar novas imagens, basta adicionar mais DIVs, e para tirar uma imagem do carrossel basta apagar a linha que contém o div da imagem. Para mais detalhes e opções, acesse Carrossel


Plugins/Extensões

Extensões permitem a você personalizar a aparência e o funcionamento do MediaWiki.

As extensões existentes se encontra no link: https://www.mediawiki.org/wiki/Category:Extensions_by_category

Algumas dessas extensões: 

Presentation: Cria uma apresentação usando paginas da wiki
  Link: https://www.mediawiki.org/wiki/Extension:Presentation
EmbedVideo: Permite a incorporacao de videos na wiki a partir de servicos de compartilhamento de video como por exemplo o youtube
  Link: https://www.mediawiki.org/wiki/Extension:EmbedVideo
Lockdown e AccessControlPanel: Essas duas extensões juntas permitem controlar o acesso às páginas da wiki, possibilitando que sejam criados grupos de usuários com permissões específicas.
  Link: https://www.mediawiki.org/wiki/Extension:Lockdown
  Link: https://www.mediawiki.org/wiki/Extension:Access_Control_Panel
Bootstrap: É um framework front-end
  Link: https://www.mediawiki.org/wiki/Extension:Bootstrap
Graph: Essa extensão permite a criação de gráficos dentro da midiawiki como por exemplo o gráfico de pizza, timeline, histogramas e o de barra
  Link: https://www.mediawiki.org/wiki/Extension:Graph
JavascriptSlideshow: Essa extensão permite a criação de um carrossel simples de imagens
  Link: https://www.mediawiki.org/wiki/Extension:JavascriptSlideshow
  Breve tutorial criado no source: Carrossel


Histórico


  • 28/11:
    • Gabriel Franco: Instalação e configuração de plugins do source na wiki local para testes.


Estudo Dirigido


  • Fazer backup diariamente usando crontab e FTP - Todos os dias (2a. 4a e 6a: Área A - 3a. e 5a.: Área B)
  • Instalação do MediaWiki standalone versão anterior - 30m
  • Instalação do MediaWiki na nuvem - 2 dias
  • Implementar backup diário da nuvem para local -
  • Restauração da Wiki local para a nuvem - 30m
  • Mudar o skin da Wiki para outro padrão qualquer - 25m
  • Upgrade da versão da Wiki local ou na nuvem -
  • Implementar carrossel - 40m
  • Avaliar Plugins -


Disponível em “http://3.143.69.156/wiki/index.php?title=Wiki&oldid=57252”