wp2hugo

Migrateur de site WordPress vers Hugo Static

C'est le meilleur migrateur pour migrer l'export WordPress vers Hugo. Il gère plusieurs cas étranges que j'ai rencontrés en essayant de migrer mon site Web personnel vers un site basé sur Hugo.

Bien que cela cible principalement la génération de code basée sur Hugo, on peut l'utiliser pour convertir des blogs WordPress en fichiers basés sur Markdown pouvant être utilisés avec d'autres systèmes, par exemple Mkdocs ou Jekyll.

Utilisation commerciale

Je souhaite que ce projet soit le plus largement accessible possible, tout en finançant les coûts de développement. Ce projet est entièrement gratuit pour un usage non commercial et personnel. L'utilisation commerciale est restreinte via une licence. N'hésitez pas à me contacter si vous souhaitez obtenir une licence commerciale.

Usage

Binaire

• Téléchargez l'outil wp2hugo à partir des versions
• Exportez votre site WordPress via Tools -> Export dans votre tableau de bord d'administration
• Disons que le fichier téléchargé est wordpress-export.xml générez le site Web en utilisant $ 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

Construire à partir des sources

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

Installation via les gestionnaires de packages

Objectifs de wp2hugo

Migrer les types de publications, les taxonomies et leurs pages d'archives

1. Migrer les publications
2. Migrer des pages
3. Migrer les balises
4. Migrer les catégories
5. Migrer les types de publication personnalisés Avada (FAQ, Portfolios)
6. Définir correctement la page d'accueil de WordPress
7. Créer une page d'auteur WordPress

Migrer les permaliens

1. Migrez correctement toutes les URL, y compris les URL de médias
2. Générer une configuration Nginx contenant le GUID -> mappage d'URL relatif
3. Migrez le flux RSS avec les UUID existants, afin que les entrées apparaissent identiques - ceci est important pour toute personne disposant d'un flux important, voir plus de détails sur un échec de migration
4. Mapper feed.xml de WordPress au feed.xml de Hugo

Migrer le contenu des publications et les codes courts

1. Migrer un extrait de page
2. Migrer "Afficher plus..." de WordPress -> Summary dans Hugo
3. Migrer les publications de la catégorie de liste (catlist)
4. Migrer la table des matières WordPress -> Hugo
5. Migrez correctement les blocs de code - migrez les informations de classe de code existantes si disponibles
6. Migrer les intégrations :
   1. Migrer des iframe(s) comme les intégrations YouTube
   2. Migrer les intégrations YouTube
   3. Migrer les intégrations YouTube en texte brut de style WordPress dans le corps de la publication
   4. Migrer les intégrations YouTube de WP YouTube Lyte
   5. Migrer l'intégration de Google Map via un shortcode personnalisé googlemaps
   6. Migrer les informations GitHub
7. Migrez les shortcodes WordPress :
   1. Migrez le shortcode WordPress [légende] vers Hugo's {{< figure >}})
   2. Migrer le shortcode WordPress [audio])
8. Migrez les blocs et les fonctionnalités de Gutenberg :
   1. Migrer les notes de bas de page WordPress
   2. Migrer la galerie WordPress, y compris la galerie vide

Migrer les métadonnées et les attributs de la publication

1. Maintenir le statut de brouillon pour les publications en brouillon et en attente
2. Utiliser la date de brouillon comme date de secours pour les brouillons de publications
3. Images en vedette : exportez correctement les associations d'images en vedette avec les pages et les publications.
4. Formats de publication WordPress

Migrer les pièces jointes multimédias

1. Migrer favicon.ico
2. Migrez les images wp-content/uploads intégrées dans les pages vers des fichiers statiques Hugo tout en conservant les URL relatives
3. Migrer les images externes (sur différents hôtes) vers des fichiers statiques Hugo

Divers

1. Possibilité de filtrer les publications par auteur(s), utile pour les migrations multi-sites WordPress
2. Police personnalisée - par défaut Lexend
3. Prise en charge des arrière-plans flous de parallaxe (similaire aux arrière-plans avancés de WordPress)

Pourquoi les outils existants ne fonctionnent pas

Les outils existants font un travail de migration de contenu à moitié cuit. Ils migrent rarement les métadonnées telles que le GUID, les intégrations YouTube, les intégrations Google Map et les intégrations de code correctement.

Hugo Gérant

Ce référentiel contient un outil expérimental hugomanager . J'utilise cet outil pour la génération automatique d'URL à partir du titre ainsi que pour savoir quels articles de blog sont encore marqués comme brouillon ou lesquels devraient être publiés prochainement.

Vous pouvez construire cela via

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.

Note:

1. Pour migrer les commentaires, utilisez Remark42