wp2hugo

Migrador de sitios de WordPress a Hugo Static

Este es el mejor programa de migración para migrar la exportación de WordPress a Hugo. Maneja varios casos extremos extraños que encontré al intentar migrar mi sitio web personal al sitio basado en Hugo.

Si bien esto se dirige principalmente a la generación de código basado en Hugo, se puede utilizar para convertir blogs de WordPress en archivos basados ​​en Markdown que se pueden utilizar con otros sistemas, por ejemplo, Mkdocs o Jekyll.

Uso comercial

Quiero que este proyecto sea lo más accesible posible y al mismo tiempo financiar los costos de desarrollo. Este proyecto es completamente gratuito para uso personal y no comercial. El uso comercial está restringido mediante una licencia. No dude en ponerse en contacto conmigo si desea licenciar esto comercialmente.

Uso

Binario

• Descargue la herramienta wp2hugo desde los lanzamientos
• Exporte su sitio web de WordPress a través de Tools -> Export en su panel de administración
• Digamos que el archivo descargado es wordpress-export.xml genere el sitio web 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 desde la fuente

$ 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`

Instalación a través de administradores de paquetes

Objetivos de wp2hugo

Migrar tipos de publicaciones, taxonomías y sus páginas de archivo

1. Migrar publicaciones
2. Migrar páginas
3. Migrar etiquetas
4. Migrar categorías
5. Migrar tipos de publicaciones personalizadas de Avada (Preguntas frecuentes, Portafolios)
6. Configure la página de inicio de WordPress correctamente
7. Crear página de autor de WordPress

Migrar enlaces permanentes

1. Migre correctamente todas las URL, incluidas las URL de medios
2. Genere una configuración de Nginx que contenga GUID -> asignación de URL relativa
3. Migre la fuente RSS con los UUID existentes, para que las entradas aparezcan iguales; esto es importante para cualquier persona con un seguimiento importante de la fuente; consulte más detalles sobre una migración fallida.
4. Asigne feed.xml RSS de WordPress al feed.xml RSS de Hugo

Migrar contenido de publicaciones y códigos cortos

1. Migrar extracto de página
2. Migrar "Mostrar más..." de WordPress -> Summary en Hugo
3. Migrar publicaciones de categoría de lista (catlist)
4. Migrar tabla de contenido de WordPress -> Hugo
5. Migre bloques de código correctamente: migre la información de clase de código existente si está disponible
6. Migrar incrustaciones:
   1. Migrar iframe(s) como incrustaciones de YouTube
   2. Migrar incrustaciones de YouTube
   3. Migrar incrustaciones de texto sin formato de YouTube al estilo WordPress en el cuerpo de la publicación
   4. Migrar incrustaciones de YouTube de WP YouTube Lyte
   5. Migre la incrustación de Google Map a través de un código corto personalizado googlemaps
   6. Migrar las esencias de GitHub
7. Migrar códigos cortos de WordPress:
   1. Migrar el shortcode de WordPress [caption] al {{< figure >}}) de Hugo
   2. Migrar código corto de WordPress [audio])
8. Migrar bloques y funciones de Gutenberg:
   1. Migrar notas al pie de WordPress
   2. Migrar la galería de WordPress, incluida la galería vacía

Migrar metadatos y atributos de publicaciones

1. Mantener el estado de borrador para publicaciones borrador y pendientes.
2. Utilice la fecha del borrador como fecha alternativa para las publicaciones preliminares
3. Imágenes destacadas: exporte correctamente las asociaciones de imágenes destacadas con páginas y publicaciones
4. Formatos de publicación de WordPress

Migrar archivos adjuntos multimedia

1. Migrar favicon.ico
2. Migre wp-content/uploads imágenes incrustadas en páginas a archivos estáticos Hugo manteniendo las URL relativas
3. Migrar imágenes externas (en diferentes hosts) a archivos estáticos de Hugo

Varios

1. Capacidad para filtrar publicaciones por autor(es), útil para migraciones de sitios múltiples de WordPress
2. Fuente personalizada: por defecto Lexend
3. Soporte para fondos desenfocados de paralaje (similar a los fondos avanzados de WordPress)

Por qué las herramientas existentes no funcionan

Las herramientas existentes hacen un trabajo a medias al migrar contenido. Rara vez migran correctamente los metadatos como GUID, incrustaciones de YouTube, incrustaciones de mapas de Google y incrustaciones de código.

Hugo Gerente

Este repositorio contiene una herramienta experimental hugomanager . Utilizo esta herramienta para la generación automática de URL a partir del título, así como para saber qué publicaciones de blog todavía están marcadas como borrador o cuáles están programadas para publicarse pronto.

Puedes construir eso a través de

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.

Nota:

1. Para migrar comentarios, utilice Remark42