146 lines
4.3 KiB
Plaintext
146 lines
4.3 KiB
Plaintext
WordPress Plugin Translation Toolkit
|
|
=====================================
|
|
|
|
Conjunto de scripts reutilizáveis para traduzir e corrigir plugins WordPress
|
|
para Português Europeu (PT-PT) usando LibreTranslate.
|
|
|
|
Author: Descomplicar® Crescimento Digital
|
|
Version: 2.0.0
|
|
Updated: 20-02-2026
|
|
|
|
|
|
SCRIPTS DISPONÍVEIS
|
|
===================
|
|
|
|
1. translate-wordpress-plugin.py ← Traduzir um único plugin (v1)
|
|
2. fix_malformed.py ← Corrigir sintaxe .po mal formada
|
|
3. fix_ptbr.py ← Corrigir PT-BR → PT-PT
|
|
4. translate_missing.py ← Preencher strings em falta via API
|
|
5. batch_process_library.py ← SCRIPT MESTRE: processar biblioteca inteira
|
|
|
|
|
|
USO RÁPIDO — BIBLIOTECA INTEIRA
|
|
=================================
|
|
|
|
# Processar TODOS os plugins (passos 1+2+3+4 automáticos):
|
|
python3 /media/ealmeida/Dados/Dev/Scripts/translate-wp-plugin/batch_process_library.py \
|
|
/media/ealmeida/Dados/Dev/WordPress/Tradução-Plugins-PT-PT
|
|
|
|
# Apenas correcções PT-BR (sem chamar API de tradução):
|
|
python3 batch_process_library.py /path/to/library --skip-translate
|
|
|
|
# Simular sem gravar:
|
|
python3 batch_process_library.py /path/to/library --dry-run
|
|
|
|
|
|
USO INDIVIDUAL — SCRIPTS ESPECÍFICOS
|
|
======================================
|
|
|
|
fix_malformed.py — Corrige sintaxe .po mal formada
|
|
---------------------------------------------------
|
|
# Um ficheiro:
|
|
python3 fix_malformed.py plugin-pt_PT.po
|
|
|
|
# Toda uma biblioteca:
|
|
find /path/to/library -name "*-pt_PT.po" | xargs python3 fix_malformed.py
|
|
|
|
|
|
fix_ptbr.py — Corrige PT-BR → PT-PT
|
|
--------------------------------------
|
|
# Um ficheiro:
|
|
python3 fix_ptbr.py plugin-pt_PT.po
|
|
|
|
# Toda uma biblioteca:
|
|
find /path/to/library -name "*-pt_PT.po" | xargs python3 fix_ptbr.py
|
|
|
|
Correcções aplicadas:
|
|
salvar → guardar
|
|
senha → palavra-passe
|
|
usuário → utilizador
|
|
arquivo → ficheiro
|
|
ativar → activar
|
|
atualizar → actualizar
|
|
desativar → desactivar
|
|
conectar → ligar
|
|
dashboard → painel
|
|
backup → cópia de segurança
|
|
você → o utilizador
|
|
(+ 40 outros termos)
|
|
|
|
|
|
translate_missing.py — Traduz strings em falta via LibreTranslate
|
|
------------------------------------------------------------------
|
|
# Um ficheiro:
|
|
python3 translate_missing.py plugin-pt_PT.po
|
|
|
|
# Simular (sem gravar):
|
|
python3 translate_missing.py plugin-pt_PT.po --dry-run
|
|
|
|
# Toda uma biblioteca:
|
|
find /path/to/library -name "*-pt_PT.po" | xargs python3 translate_missing.py
|
|
|
|
Requisitos:
|
|
- LibreTranslate API: https://translate.descomplicar.pt
|
|
- Rate limit: 0.3s entre chamadas
|
|
- Sem API key (whitelist IP 188.251.199.30)
|
|
|
|
|
|
translate-wordpress-plugin.py — Traduzir plugin único (v1 legacy)
|
|
-----------------------------------------------------------------
|
|
python3 translate-wordpress-plugin.py input.po
|
|
python3 translate-wordpress-plugin.py input.po --output output-pt_PT.po
|
|
python3 translate-wordpress-plugin.py input.po --api-url http://localhost:5000
|
|
|
|
|
|
REQUISITOS
|
|
==========
|
|
|
|
- Python 3.8+
|
|
- gettext (msgfmt): sudo apt install gettext
|
|
- LibreTranslate API: https://translate.descomplicar.pt (self-hosted)
|
|
- Acesso de rede ao servidor de tradução
|
|
|
|
|
|
FLUXO RECOMENDADO
|
|
=================
|
|
|
|
Para uma biblioteca nova ou actualização:
|
|
|
|
1. fix_malformed — garantir que os .po são válidos
|
|
2. fix_ptbr — substituir PT-BR por PT-PT
|
|
3. translate_missing — preencher strings em falta
|
|
4. msgfmt — recompilar .mo
|
|
|
|
O batch_process_library.py executa este fluxo automaticamente.
|
|
|
|
|
|
BIBLIOTECA PRINCIPAL
|
|
====================
|
|
|
|
Localização: /media/ealmeida/Dados/Dev/WordPress/Tradução-Plugins-PT-PT/
|
|
Glossário: /media/ealmeida/Dados/Dev/WordPress/Tradução-Plugins-PT-PT/GLOSSARIO-PT-PT.md
|
|
|
|
Destino WP: /wp-content/languages/loco/plugins/PLUGIN-SLUG-pt_PT.po
|
|
/wp-content/languages/loco/plugins/PLUGIN-SLUG-pt_PT.mo
|
|
|
|
|
|
CHANGELOG
|
|
=========
|
|
|
|
v2.0.0 (20-02-2026)
|
|
- Adicionado fix_malformed.py (correcção de sintaxe .po)
|
|
- Adicionado fix_ptbr.py (correcções PT-BR → PT-PT expandidas)
|
|
- Adicionado translate_missing.py (tradução de strings em falta)
|
|
- Adicionado batch_process_library.py (orquestrador para biblioteca inteira)
|
|
- Glossário expandido com 50+ termos adicionais
|
|
|
|
v1.0.0 (11-02-2026)
|
|
- Script inicial de tradução de plugin único
|
|
|
|
|
|
CONTACTO
|
|
========
|
|
|
|
Emanuel Almeida <emanuel@descomplicar.pt>
|
|
Descomplicar® Crescimento Digital
|