wp2hugo

Migrator situs WordPress ke Hugo Static

Ini adalah migrasi terbaik untuk memigrasikan ekspor WordPress ke Hugo. Ini menangani beberapa kasus aneh yang saya temui ketika mencoba memigrasikan situs web pribadi saya ke situs berbasis Hugo.

Meskipun ini terutama menargetkan pembuatan kode berbasis Hugo, Anda dapat menggunakannya untuk mengonversi blog WordPress menjadi file berbasis Markdown yang dapat digunakan dengan sistem lain misalnya Mkdocs atau Jekyll.

Penggunaan komersial

Saya ingin proyek ini bisa diakses seluas-luasnya, sambil tetap mendanai biaya pengembangannya. Proyek ini sepenuhnya gratis untuk penggunaan non-komersial dan pribadi. Penggunaan komersial dibatasi melalui lisensi. Jangan ragu untuk menghubungi saya jika Anda ingin melisensikannya secara komersial.

Penggunaan

Biner

• Unduh alat wp2hugo dari rilis
• Ekspor situs WordPress Anda melalui Tools -> Export di dasbor admin Anda
• Katakanlah file yang diunduh adalah wordpress-export.xml buat situs web menggunakan $ 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

Bangun dari sumber

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

Instalasi melalui Manajer Paket

Tujuan wp2hugo

Migrasikan jenis postingan, taksonomi, dan halaman arsipnya

1. Migrasikan postingan
2. Migrasikan halaman
3. Migrasikan tag
4. Migrasi kategori
5. Migrasikan jenis kiriman khusus Avada (FAQ, Portofolio)
6. Atur beranda WordPress dengan benar
7. Buat halaman penulis WordPress

Migrasikan tautan permanen

1. Migrasikan semua URL termasuk URL media dengan benar
2. Hasilkan konfigurasi Nginx yang berisi GUID -> pemetaan URL relatif
3. Migrasikan feed RSS dengan UUID yang ada, sehingga entri tampak sama - hal ini penting bagi siapa saja yang memiliki banyak pengikut feed, lihat detail lebih lanjut tentang migrasi yang gagal
4. Petakan RSS feed.xml WordPress ke RSS feed.xml Hugo

Migrasikan konten postingan dan kode pendek

1. Migrasikan kutipan halaman
2. Migrasikan "Tampilkan lebih banyak..." dari WordPress -> Summary di Hugo
3. Migrasi postingan Kategori Daftar (catlist)
4. Migrasikan daftar isi WordPress -> Hugo
5. Migrasikan blok kode dengan benar - migrasikan informasi kelas kode yang ada jika tersedia
6. Migrasikan penyematan:
   1. Migrasikan iframe seperti penyematan YouTube
   2. Migrasikan penyematan YouTube
   3. Migrasikan penyematan YouTube teks biasa bergaya WordPress di badan postingan
   4. Migrasikan penyematan WP YouTube Lyte YouTube
   5. Migrasikan penyematan Google Map melalui googlemaps kode pendek khusus
   6. Migrasikan intisari GitHub
7. Migrasikan kode pendek WordPress:
   1. Migrasikan kode pendek [caption] WordPress ke {{< figure >}}) Hugo
   2. Migrasikan kode pendek [audio] WordPress)
8. Migrasi blok dan fitur Gutenberg:
   1. Migrasikan catatan kaki WordPress
   2. Migrasikan galeri WordPress termasuk Galeri kosong

Migrasikan metadata dan atribut postingan

1. Pertahankan status draf untuk postingan draf dan tertunda
2. Gunakan tanggal draf sebagai tanggal cadangan untuk postingan draf
3. Gambar unggulan - ekspor asosiasi gambar unggulan dengan halaman dan postingan dengan benar
4. Format Posting WordPress

Migrasikan lampiran media

1. Migrasikan favicon.ico
2. Migrasikan gambar wp-content/uploads yang disematkan di halaman ke file statis Hugo dengan tetap mempertahankan URL relatif
3. Migrasikan gambar eksternal (pada host berbeda) ke file statis Hugo

Lain-lain

1. Kemampuan untuk memfilter postingan berdasarkan penulis, berguna untuk migrasi multi-situs WordPress
2. Font khusus - default untuk Lexend
3. Dukungan untuk latar belakang paralaks blur (mirip dengan Latar Belakang Tingkat Lanjut WordPress)

Mengapa alat yang ada tidak berfungsi

Alat yang ada melakukan pekerjaan setengah matang dalam memigrasikan konten. Mereka jarang memigrasikan metadata seperti GUID, penyematan YouTube, penyematan Google Map, dan penyematan kode dengan benar.

Manajer Hugo

Repositori ini berisi alat eksperimental hugomanager . Saya menggunakan alat ini untuk menghasilkan URL secara otomatis dari judul serta untuk mengetahui postingan blog mana yang masih bertanda draft atau mana yang dijadwalkan untuk segera diterbitkan.

Anda dapat membangunnya melalui

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.

Catatan:

1. Untuk memigrasikan komentar, gunakan Remark42