VisualEditor
Figura Principal - VisualEditor on MediaWiki

O que é VisualEditor?

VisualEditor é um editor de rich-text para MediaWiki. Está disponível como uma extensão e depende do serviço analisador Parsoid para estar funcionando para edição de páginas MediaWiki.

E o que é Parsoid?

Entendendo o Parsoid, que é um serviço de analisador baseado em Nodejs. Está sendo usado por muitas extensões MediaWiki, incluindo VisualEditor, Flow, tradução de conteúdo e outras aplicações.

Instalando VisualEditor

Abaixo aprenderemos como instalar passo a passo e configurar o VisualEditor para a versão MediaWiki mais recente 1.30.

Requisitos

  • CentOS 7 com MediaWiki instalado
  • ser Root

O que será feito nesta instalação:

  • verificação da instalação do MediaWiki;
  • Instalação de Dependências;
  • Instalação e configuração do Parsoid;
  • Instalação e configuração do VisualEditor para MediaWiki;
  • Testar a configuração.
  1. Verifique a instalação do MediaWiki

Nesta etapa, verificamos nossa instalação do MediaWiki. O MediaWiki está instalado sob o nome de domínio ‘http://wiki.hakase-labs.me‘. Abra o navegador da Web e visite o seguinte endereço de URL do MediaWiki, o meu é: http://wiki.hakase-labs.me/. Você será redirecionado para a conexão HTTPS, após o qual você receberá a página MediaWiki com um “Vector” semelhante ao mostrado abaixo.

VisualEditor

Figura 1 – Tela inicial do MediaWiki


Em seguida, faça o login como usuário administrativo e tente editar a página. Clique na guia “Editar” e você receberá o editor MediaWiki padrão conforme abaixo.
VisualEditor

Figura 2 – acessando a página e editando-a


O MediaWiki está funcionando sem nenhum erro.

2. Instalar dependências

Para instalar o serviço Parsoid e configurar o VisualEditor, precisamos de alguns pacotes CentOS para serem instalados no sistema. Especificamente, instalaremos Nodejs, npm, vim e git. Instale todos os pacotes necessários usando o comando yum abaixo.

yum -y install nodejs npm vim-enhanced git

Todos os pacotes e dependências serão instalados.

3. Instale e configure Parsoid

Parsoid pode ser instalado em um servidor MediaWiki separado. Mas para este tutorial, e estaremos usando apenas o servidor 1 CentOS 7 para MediaWiki e Parsoid. No entanto, uma vez que estamos usando o servidor CentOS 7, precisamos instalar o serviço Parsoid manualmente da fonte porque os pacotes oficiais só estão disponíveis para sistemas operacionais baseados no Ubuntu/Debian. Então, para começar, crie um novo diretório ‘/opt/parsoid‘ e clone o último parsoid usando o comando git, conforme mostrado abaixo.

mkdir -p /opt/parsoid
git clone https://gerrit.wikimedia.org/r/p/mediawiki/services/parsoid /opt/parsoid

VisualEditor

Figura 3 – criando diretório e direcionando o pacote via git.


Agora vá para o diretório ‘/opt/parsoid‘ e instale o serviço Parsoid usando o seguinte comando npm.

cd /opt/parsoid
npm install

Depois da instalação completada você algo similar a essa imagem:

VisualEditor

Figura 4 – após a instalação aparecerá essa imagem


Em seguida, configure o serviço Parsoid editando os arquivos de configuração correspondentes.
Copie a configuração de exemplo ‘localsettings.example.js’ para ‘localsettings.js‘ e, em seguida, edite o arquivo usando vim

cp localsettings.example.js localsettings.js
vim localsettings.js

Descomente a linha ‘parsoidConfig.setMwApi’ e altere o valor ‘uri’ com o URL da API MediaWiki, conforme abaixo.

exports.setup = function(parsoidConfig) {
         // Do something dynamic with `parsoidConfig` like,
         parsoidConfig.setMwApi({
                 uri: 'http://wiki.hakase-labs.me/api.php',
          });
 };

VisualEditor

Figura 5 – descomentando a linha no processo de instalação


É isso aí. Salvar e sair.

3. 1 Copiando a configuração

Agora copie a configuração ‘config.example.yaml’ para ‘config.yaml’ e edite-a com o editor vim.

cp config.example.yaml config.yaml
vim config.yaml

Na linha ‘mwApis’ (número da linha 34), altere o valor ‘uri’ com o URL da API do MediaWiki e o valor ‘domínio’ com seu próprio nome de domínio.

mwApis:
         - # This is the only required parameter,
           # the URL of you MediaWiki API endpoint.
           uri: 'http://wiki.hakase-labs.me/api.php'
           # The "domain" is used for communication with Visual Editor
           # and RESTBase.  It defaults to the hostname portion of
           # the `uri` property above, but you can manually set it
           # to an arbitrary string. It must match the "domain" set
           # in $wgVirtualRestConfig.
           domain: 'wiki.hakase-labs.me' 
           #optional

Salve e saia.
Agora vamos configurar o Parsoid como um serviço. Para isso, vá para o diretório ‘/etc/systemd/ system’ e crie um novo arquivo de serviço denominado ‘parsoid.service’.

cd /etc/systemd/system/
vim parsoid.service

Cole a configuração do serviço Parsoid abaixo

[Unit]
 Description=Mediawiki Parsoid web service on node.js
 Documentation=http://www.mediawiki.org/wiki/Parsoid
 Wants=local-fs.target network.target
 After=local-fs.target network.target
 [Install]
 WantedBy=multi-user.target
 [Service]
 Type=simple
 User=root
 Group=root
 WorkingDirectory=/opt/parsoid
 ExecStart=/usr/bin/node /opt/parsoid/bin/server.js
 KillMode=process
 Restart=on-success
 PrivateTmp=true
 StandardOutput=syslog

Salvar e Sair, após execute o comando abaixo para recarregamento.

systemctl daemon-reload

Agora, comece o serviço Parsoid e permita que ele seja executado sempre no início do sistema

systemctl start parsoid
systemctl enable parsoid

O Parsoid agora deve estar funcionando como um serviço no CentOS 7, usando a porta 8000. Você pode verificá-lo com o comando netstat da seguinte maneira.

netstat -plntu

E teremos um resultado similar com o da imagem abaixo:

VisualEditor

Figura 5 – verificando a porta 8000


A instalação do Parsoid foi concluida!

Se você tiver o Firewalld em execução no seu servidor, adicione a porta parsoid 8000 à configuração firewalld usando os seguintes comandos.
firewall-cmd --add-port=8000/tcp --permanent
firewall-cmd --reload
VisualEditor

Figura 6 – Firewall

4. Instalando e Configurando o VisualEditor

Agora vamos instalar e configurar extensões VisualEditor para MediaWiki. Vá para o diretório de instalação do MediaWiki ‘/var/www/mediawiki/extensions‘ e baixe a versão mais recente do VisualEditor usando git.

cd /var/www/mediawiki/extensions
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/VisualEditor.git

Agora vá para o diretório VisualEditor, e inicialize e atualize todos os submódulos dentro dele.

cd VisualEditor/
git submodule update --init

VisualEditor

Figura 6 – inserindo os pacotes com git no subdiretorio


Em seguida, precisamos editar o arquivo de configuração Mediawiki ‘LocalSettings.php’ para habilitar o VisualEditor. Para isso, dirija-se ao diretório mediawiki e edite o arquivo ‘LocalSettings.php’ usando vim.

cd /var/www/mediawiki
vim LocalSettings.php

Cole a configuração abaixo para o final do arquivo.

wfLoadExtension( 'VisualEditor' );
 // Enable by default for everybody
 $wgDefaultUserOptions['visualeditor-enable'] = 1;
 // Optional: Set VisualEditor as the default for anonymous users
 // otherwise they will have to switch to VE
 // $wgDefaultUserOptions['visualeditor-editor'] = "visualeditor";
 // Don't allow users to disable it
 $wgHiddenPrefs[] = 'visualeditor-enable';
 // OPTIONAL: Enable VisualEditor's experimental code features
 #$wgDefaultUserOptions['visualeditor-enable-experimental'] = 1;
 $wgVirtualRestConfig['modules']['parsoid'] = array(
     // URL to the Parsoid instance
     // Use port 8142 if you use the Debian package
     'url' => 'http://wiki.hakase-labs.me:8000',
     // Parsoid "domain", see below (optional)
     'domain' => 'wiki.hakase-labs.me',
     // Parsoid "prefix", see below (optional)
     'prefix' => 'wiki.hakase-labs.me'
 );

Salve e saia.

Altere o URL com seu próprio nome de domínio.
Em seguida, altere as permissões de propriedade para o diretório mediawiki para o usuário e o grupo ‘nginx’.
chown -R nginx:nginx /var/www/mediawiki

Agora o VisualEditor está instalado.
5. Fazendo o Teste final
Abra seu navegador e visite a página do MediaWiki URL, a minha é: http://wiki.hakase-labs.me
Agora log como administrador:

VisualEditor

Figura 7 – Acessando com login


Uma vez conectado, clique na aba “Editar” para editar a página inicial. Você deve obter VisualEditor como mostrado abaixo.
VisualEditor

Figura 8 – Finalizando o teste


A instalação do VisualEditor e a configuração do MediaWiki no CentOS 7 foram concluídas com sucesso.
Por hoje é só pessoal, espero que vocês tenha gostado, nos siga nas redes sociais e deixem nos comentários o que vocês acharam da matéria.

Redação
Este usuário é utilizado quando um post é migrado de um usuário para outro, ou quando alguém envia um conteúdo ao SempreUPdate.

    Script pós instalação do Raspbian para remoção de pacotes extras

    Previous article

    Mobility Show Nordeste Evento de Tecnologia Assistiva e acessibilidade

    Next article

    You may also like

    Comments

    Comments are closed.

    More in Tutoriais