Instalar SciELO Markup no Windows (Guia Completo + Soluções)

Se você trabalha com publicação científica ou integração com o padrão SciELO, provavelmente já se deparou com o Markup, ferramenta essencial para marcação de artigos e geração de XML.

Neste guia, você vai aprender como instalar o SciELO Markup corretamente no Windows, além de resolver os erros mais comuns durante o processo.

---

📌 O que é o SciELO Markup?

O Markup é uma aplicação desktop (macro do Microsoft Word) usada para:

• Identificar elementos bibliográficos em documentos
• Estrurar artigos conforme padrões SciELO
• Gerar XML compatível com SPS e JATS
• Validar documentos e XMLs

Ele segue padrões como:

• ISO 8879-1986 (SGML)
• ISO 12083-1994 (Electronic Manuscript Preparation)

---

⚙️ Ambiente utilizado

Neste tutorial foi utilizada a seguinte configuração:

• Windows 11 64 bits
• Microsoft Office Professional Plus 2024

---

📥 Pré-requisitos obrigatórios

Antes de instalar o Markup, você precisa garantir que os seguintes itens estejam instalados:

🐍 Python 2.7 (obrigatório)

⚠️ Mesmo em sistemas 64 bits, utilize a versão 32 bits

• Versão recomendada: Python 2.7.18
• Download: https://www.python.org/ftp/python/2.7.18/python-2.7.18.msi

---

☕ Java

• Download: https://www.java.com/pt-BR/download/

---

✅ Validando as instalações

Abra o Prompt de Comando (CMD) e execute:

python -V
pip -V
java -version

Se tudo estiver correto, as versões serão exibidas.

---

📦 Baixando o SciELO Markup

Utilize um cliente FTP como o WinSCP:

• Download: https://winscp.net/eng/download.php

🔐 Dados de acesso:

Host: ftp.scielo.br
Usuário: produtos-scielo
Senha: produtos@scielo

Após conectar, faça o download dos arquivos conforme indicado.

---

🚀 Instalando o Markup

1. Acesse a pasta onde fez o download
2. Dê duplo clique no instalador
3. Aguarde a inicialização

---

📂 Instalando os requisitos do sistema

Abra o CMD e execute:

cd \
cd scielo\bin\xml\
C:\scielo\bin\xml\download_markup_journals.bat

---

C:\scielo\bin\xml\install_requirements.bat

❌ Erro: “A sintaxe do comando está incorreta”

Se aparecer o erro:

if not exist  (

🔧 Solução:

Edite o arquivo:

install_requirements.bat

Substitua:

if not exist %2 (
    python -m pip freeze >> %2
)

Por:

if not "%2"=="" (
    if not exist "%2" (
        python -m pip freeze >> "%2"
    )
)

---

❌ Erro ao instalar dependências (lxml, packtools)

Erro comum:

ERROR: Command errored out with exit status 1

🔧 Solução:

Edite o arquivo:

C:\scielo\bin\xml\app_modules\settings\requirements.txt

Substitua todo o conteúdo por:

Pillow==6.2.2
packtools==2.6.4
lxml==4.3.5

---

🔁 Execute novamente:

C:\scielo\bin\xml\install_requirements.bat

---

✅ Verificando instalação final

Execute:

pip freeze

Saída esperada:

lxml==4.3.5
packtools==2.6.4
pathlib==1.0.1
picles.plumber==0.11
Pillow==6.2.2

---

🔄 Atualizando o PIP (opcional)

python -m pip install --upgrade pip

---

🚀 Primeiro uso do Markup

Após a instalação, abra o programa normalmente. Faça o vínculo do Markup com o local de instalação do Microsoft Word.

 

 

 

 

 

 

---

🧠 Dicas finais

• Sempre utilize Python 2.7 (32 bits) — versões mais novas NÃO são compatíveis
• Evite atualizar dependências automaticamente
• Mantenha backup dos arquivos .bat e requirements.txt
• Utilize sempre um CMD novo após instalações
• Fonte: https://documentacao.scielo.org/books/scielo-pc-programs/chapter/scielo-pc-programs-portugues

---

🎯 Conclusão

A instalação do SciELO Markup pode parecer complicada à primeira vista, mas com os ajustes certos, o processo se torna totalmente funcional.

Seguindo este guia, você evita os erros mais comuns e garante um ambiente pronto para produção de XML no padrão SciELO.