wp2hugo

WordPress zu Hugo Static Site-Migrator

Dies ist der beste Migrator für die Migration des WordPress-Exports nach Hugo. Es behandelt mehrere seltsame Grenzfälle, auf die ich gestoßen bin, als ich versucht habe, meine persönliche Website auf eine Hugo-basierte Website zu migrieren.

Während dies in erster Linie auf die Hugo-basierte Codegenerierung abzielt, kann man damit auch WordPress-Blogs in Markdown-basierte Dateien konvertieren, die mit anderen Systemen wie Mkdocs oder Jekyll verwendet werden können.

Kommerzielle Nutzung

Ich möchte, dass dieses Projekt so weit wie möglich zugänglich ist und gleichzeitig die Entwicklungskosten finanziert werden kann. Dieses Projekt ist für den nichtkommerziellen und persönlichen Gebrauch völlig kostenlos. Die kommerzielle Nutzung ist über eine Lizenz eingeschränkt. Kontaktieren Sie mich gerne, wenn Sie dies kommerziell lizenzieren möchten.

Verwendung

Binär

• Laden Sie das wp2hugo Tool von Releases herunter
• Exportieren Sie Ihre WordPress-Website über Tools -> Export in Ihrem Admin-Dashboard
• Nehmen wir an, die heruntergeladene Datei ist wordpress-export.xml Generieren Sie die Website mit $ 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

Aus dem Quellcode erstellen

$ 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 über Paketmanager

Ziele von wp2hugo

Migrieren Sie Beitragstypen, Taxonomien und ihre Archivseiten

1. Beiträge migrieren
2. Seiten migrieren
3. Tags migrieren
4. Kategorien migrieren
5. Benutzerdefinierte Beitragstypen von Avada migrieren (FAQ, Portfolios)
6. Stellen Sie die WordPress-Homepage richtig ein
7. Erstellen Sie eine WordPress-Autorenseite

Permalinks migrieren

1. Migrieren Sie alle URLs, einschließlich Medien-URLs, korrekt
2. Generieren Sie eine Nginx-Konfiguration mit GUID -> relative URL-Zuordnung
3. Migrieren Sie den RSS-Feed mit vorhandenen UUIDs, damit die Einträge gleich angezeigt werden. Dies ist wichtig für alle, die über eine große Feed-Fangemeinde verfügen. Sehen Sie sich weitere Details zu einer fehlgeschlagenen Migration an
4. Ordnen Sie den RSS- feed.xml von WordPress dem RSS- feed.xml von Hugo zu

Postinhalte und Shortcodes migrieren

1. Seitenauszug migrieren
2. Migrieren Sie „Mehr anzeigen...“ von WordPress -> Summary in Hugo
3. Listenkategoriebeiträge migrieren (Katzenliste)
4. WordPress-Inhaltsverzeichnis migrieren -> Hugo
5. Codeblöcke korrekt migrieren – vorhandene Codeklasseninformationen migrieren, sofern verfügbar
6. Einbettungen migrieren:
   1. Migrieren Sie Iframe(s) wie YouTube-Einbettungen
   2. YouTube-Einbettungen migrieren
   3. Migrieren Sie Klartext-YouTube-Einbettungen im WordPress-Stil in den Beitragstext
   4. Migrieren Sie WP YouTube Lyte YouTube-Einbettungen
   5. Migrieren Sie die Google Map-Einbettung über einen benutzerdefinierten Shortcode googlemaps
   6. GitHub-Gists migrieren
7. WordPress-Shortcodes migrieren:
   1. Migrieren Sie den WordPress-Shortcode [caption] zu Hugos {{<figur >}})
   2. WordPress-Shortcode [Audio] migrieren)
8. Gutenberg-Blöcke und -Funktionen migrieren:
   1. WordPress-Fußnoten migrieren
   2. Migrieren Sie die WordPress-Galerie einschließlich der leeren Galerie

Post-Metadaten und -Attribute migrieren

1. Behalten Sie den Entwurfsstatus für Entwürfe und ausstehende Beiträge bei
2. Verwenden Sie das Entwurfsdatum als Ersatzdatum für Entwurfsbeiträge
3. Ausgewählte Bilder – Exportieren Sie die Verknüpfungen hervorgehobener Bilder mit Seiten und Beiträgen korrekt
4. WordPress-Postformate

Medienanhänge migrieren

1. Favicon.ico migrieren
2. Migrieren Sie in Seiten eingebettete wp-content/uploads Bilder in statische Hugo-Dateien und behalten Sie dabei die relativen URLs bei
3. Migrieren Sie externe Images (auf verschiedenen Hosts) in statische Hugo-Dateien

Sonstiges

1. Möglichkeit, Beiträge nach Autor(en) zu filtern, nützlich für WordPress-Migrationen mit mehreren Websites
2. Benutzerdefinierte Schriftart – standardmäßig Lexend
3. Unterstützung für Parallaxenunschärfe-Hintergründe (ähnlich wie WordPress Advanced Backgrounds)

Warum vorhandene Tools nicht funktionieren

Bestehende Tools erledigen die Migration von Inhalten nur halbherzig. Sie migrieren die Metadaten wie GUID, YouTube-Einbettungen, Google Map-Einbettungen und Code-Einbettungen selten ordnungsgemäß.

Hugo-Manager

Dieses Repository enthält ein experimentelles Tool, hugomanager . Ich nutze dieses Tool zur automatischen Generierung von URLs aus Titeln und um zu erfahren, welche Blog-Beiträge noch als Entwurf markiert sind oder bald veröffentlicht werden sollen.

Sie können das über erstellen

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.

Notiz:

1. Um Kommentare zu migrieren, verwenden Sie Remark42