wp2hugo

Migrador de site WordPress para Hugo Static

Este é o melhor migrador para migrar a exportação do WordPress para o Hugo. Ele lida com vários casos estranhos que encontrei ao tentar migrar meu site pessoal para um site baseado em Hugo.

Embora tenha como alvo principal a geração de código baseado em Hugo, pode-se usá-lo para converter blogs WordPress em arquivos baseados em Markdown que podem ser usados ​​com outros sistemas, por exemplo, Mkdocs ou Jekyll.

Uso comercial

Quero que este projecto seja tão amplamente acessível quanto possível, ao mesmo tempo que financia os custos de desenvolvimento. Este projeto é totalmente gratuito para uso pessoal e não comercial. O uso comercial é restrito por meio de uma licença. Sinta-se à vontade para entrar em contato comigo se desejar licenciar isso comercialmente.

Uso

Binário

• Baixe a ferramenta wp2hugo dos lançamentos
• Exporte seu site WordPress via Tools -> Export em seu painel de administração
• Digamos que o arquivo baixado seja wordpress-export.xml gere o site usando $ wp2hugo --source wordpress-export.xml --download-media

$ wp2hugo
Usage of wp2hugo:
 -authors string
   CSV list of author name(s), if provided, only posts by these authors will be processed
  -color-log-output
   enable colored log output, set false to structured JSON log (default true)
  -continue-on-media-download-error
   continue processing even if one or more media downloads fail
  -download-media
   download media files embedded in the WordPress content
  -font string
   custom font for the output website (default " Lexend " )
  -media-cache-dir string
   dir path to cache the downloaded media files (default " /tmp/wp2hugo-cache " )
  -output string
   dir path to write the Hugo-generated data to (default " /tmp " )
  -source string
   file path to the source WordPress XML file

Construir a partir da fonte

$ git clone [email protected]:ashishb/wp2hugo.git
$ cd wp2hugo/src/wp2hugo
$ make build_prod
# `./bin/wp2hugo` will contain the binary and you can use it as `$ ./bin/wp2hugo --source wordpress-export.xml --download-media`

Instalação via gerenciadores de pacotes

Objetivos do wp2hugo

Migrar tipos de postagens, taxonomias e suas páginas de arquivo

1. Migrar postagens
2. Migrar páginas
3. Migrar tags
4. Migrar categorias
5. Migrar tipos de postagem personalizados do Avada (FAQ, portfólios)
6. Defina a página inicial do WordPress corretamente
7. Criar página de autor WordPress

Migrar links permanentes

1. Migre todos os URLs, incluindo URLs de mídia, corretamente
2. Gere configuração Nginx contendo GUID -> mapeamento de URL relativo
3. Migre o feed RSS com UUIDs existentes, para que as entradas tenham a mesma aparência - isso é importante para qualquer pessoa com um número significativo de seguidores de feed, veja mais detalhes de uma migração com falha
4. Mapeie feed.xml RSS do WordPress para feed.xml RSS do Hugo

Migrar conteúdo de postagem e códigos de acesso

1. Migrar trecho da página
2. Migrar "Mostrar mais..." do WordPress -> Summary no Hugo
3. Migrar postagens de categoria de lista (catlist)
4. Migrar índice do WordPress -> Hugo
5. Migre os blocos de código corretamente - migre as informações de classe de código existentes, se disponíveis
6. Migrar incorporações:
   1. Migre iframe(s) como incorporações do YouTube
   2. Migrar incorporações do YouTube
   3. Migrar incorporações de texto simples do YouTube no estilo WordPress no corpo da postagem
   4. Migrar incorporações do WP YouTube Lyte YouTube
   5. Migre a incorporação do Google Map por meio de um código de acesso personalizado googlemaps
   6. Migrar recursos do GitHub
7. Migrar códigos de acesso do WordPress:
   1. Migre o shortcode [legenda] do WordPress para a {{< figura >}} do Hugo)
   2. Migrar código de acesso do WordPress [áudio])
8. Migrar blocos e recursos do Gutenberg:
   1. Migrar notas de rodapé do WordPress
   2. Migrar galeria WordPress incluindo galeria vazia

Migrar metadados e atributos de postagem

1. Manter o status de rascunho para postagens de rascunho e pendentes
2. Use a data do rascunho como data alternativa para rascunhos de postagens
3. Imagens em destaque - exporte associações de imagens em destaque com páginas e postagens corretamente
4. Formatos de postagem do WordPress

Migrar anexos de mídia

1. Migrar favicon.ico
2. Migre imagens wp-content/uploads incorporadas em páginas para arquivos estáticos do Hugo, mantendo URLs relativos
3. Migrar imagens externas (em hosts diferentes) para arquivos estáticos do Hugo

Diversos

1. Capacidade de filtrar postagens por autor (es), útil para migrações de vários sites para WordPress
2. Fonte personalizada - o padrão é Lexend
3. Suporte para fundos desfocados paralaxe (semelhante aos fundos avançados do WordPress)

Por que as ferramentas existentes não funcionam

As ferramentas existentes fazem um trabalho incompleto de migração de conteúdo. Eles raramente migram os metadados como GUID, incorporações do YouTube, incorporações do Google Map e incorporações de código corretamente.

Gerente Hugo

Este repositório contém uma ferramenta experimental hugomanager . Eu uso essa ferramenta para a geração automática de URLs a partir do título, bem como para saber quais posts do blog ainda estão marcados como rascunho ou quais estão programados para serem publicados em breve.

Você pode construir isso através

src/wp2hugo $ make build_hugo_manager
...

src/wp2hugo $ ./bin/hugomanager
A tool for managing Hugo sites e.g. adding URL suggestions, generating site status summary etc.

Usage:
  hugomanager [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  help        Help about any command
  sitesummary Print site stats (e.g. number of posts, number of drafts etc.)
  urlsuggest  Suggests URLs for all the pending/future posts that are missing a URL
  version     Print the version number of HugoManager

Flags:
  -a, --author string    author name for copyright attribution (default " YOUR NAME " )
      --config string    config file (default is $HOME /.cobra.yaml)
  -h, --help             help for hugomanager
  -l, --license string   name of license for the project
      --viper            use Viper for configuration (default true)

Use " hugomanager [command] --help " for more information about a command.

Observação:

1. Para migrar comentários, use Remark42