WordPress para Hugo

Exportar para Hugo

Posted by     "rbits" on Wednesday, March 24, 2021

TOC

Histórico

Meu primeiro blog foi feito no WordPress com a ajuda de um colega. Apesar do site oferecer muitos recursos e facilmente conseguir ajuda pela Internet, não gostei da complexidade nem do desempenho.

Com o apoio de um colega desenvolvedor de soluções web, ele sugeriu o Hugo, um servidor de páginas estaticas onde o conteúdo do site deve ser escrito na linguagem MarkDown. Como eu tenho poucos artigos, não seria dificil de converter. Mas a intenção é usar MarkDown pois no futuro o conteúdo do site poderia facilmente ser convertido para qualquer outra tecnologia.

Conversão HTML para MarkDown

O primeiro passo foi converter os arquivos criados no WordPress para o formato markdown como segue:

  • Instalar o plugin SchumacherFM/wordpress-to-hugo-exporter que não é disponibilizado por padrão no WordPress.
  • Baixar o zip do plugin que é gratuito do site https://github.com/SchumacherFM/wordpress-to-hugo-exporter
  • Entrar no seu site do WordPress e adicionar um no menu, Plugins > Add New
  • Fazer o Upload do Plugin e escolher o zip baixado do github.
  • Entrar no menu Plugins do WordPress e ativar o plugin conversor para Hugo.

Uma vez instalado o plugin conversor, é só entrar no menu Tools do WordPress e escolher Export to Hugo Todos os posts e paginas serão convertidos assim como todos os arquivos uplod serão convertidos (/wp-content/*)

Se ocorrer uma falha na conversão, talvez seria porque seu site esteja muito complexo ou grande. Nesse caso, a solução seria usar a linha de comanndo por meio de uma conexão SSH para seu servidor WordPress. Voce configurou esse acesso durante a criação do seu site no WordPress. Então não seria tão complexa essa alternativa.

A partir da conexão SSH estabelecida com o servidor WordPress executar o comando hugo-export-cli.php que faz parte do plugin instalado anteriormente:

$ cd wp-content/plugins/wordpress-to-hugo-exporter-master/

$ php hugo-export-cli.php

Pronto!! O arquivo wp-hugo.zip contém todo o conteudo convertido para MarkDown.

Documentos

Mattias Geniar A step-by-step guide on migrating from WordPress to Hugo Google Analytics Hugo

Perguntas Mais Frequentes

  • Como personalizar o Google Analytics para uso com Hugo? Aqui está o link GA Hugo.