wp2hugo

Статический перенос сайта с WordPress на Hugo

Это лучший инструмент для переноса экспорта WordPress в Hugo. Он обрабатывает несколько странных крайних случаев, с которыми я столкнулся при попытке перенести свой личный веб-сайт на сайт на базе Hugo.

Хотя это в первую очередь предназначено для генерации кода на основе Hugo, его можно использовать для преобразования блогов WordPress в файлы на основе Markdown, которые можно использовать с другими системами, например Mkdocs или Jekyll.

Коммерческое использование

Я хочу, чтобы этот проект был как можно более доступным и при этом финансировал затраты на разработку. Этот проект полностью бесплатен для некоммерческого и личного использования. Коммерческое использование ограничено лицензией. Не стесняйтесь обращаться ко мне, если вы хотите лицензировать это на коммерческой основе.

Использование

Двоичный

• Загрузите инструмент wp2hugo из выпусков
• Экспортируйте свой веб-сайт WordPress через Tools -> Export в панели администратора.
• Допустим, загружен файл wordpress-export.xml Создайте веб-сайт, используя $ 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

Сборка из исходного кода

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

Установка через менеджеры пакетов

Цели wp2hugo

Перенос типов сообщений, таксономий и страниц их архива.

1. Перенос сообщений
2. Перенос страниц
3. Перенос тегов
4. Перенос категорий
5. Перенос пользовательских типов сообщений Avada (часто задаваемые вопросы, портфолио)
6. Правильно настройте домашнюю страницу WordPress
7. Создать страницу автора WordPress

Перенос постоянных ссылок

1. Правильно перенесите все URL-адреса, включая URL-адреса мультимедиа.
2. Создайте конфигурацию Nginx, содержащую GUID -> сопоставление относительных URL-адресов.
3. Перенесите RSS-канал с существующими UUID, чтобы записи выглядели одинаково. Это важно для всех, у кого много подписчиков, см. более подробную информацию о неудачной миграции.
4. Сопоставьте RSS- feed.xml с RSS- feed.xml Хьюго.xml

Перенос содержимого публикации и шорткодов

1. Перенести фрагмент страницы
2. Перенос «Показать больше...» WordPress -> Summary в Hugo
3. Перенести сообщения категории списка (список кошек)
4. Перенести оглавление WordPress -> Хьюго
5. Правильно перенесите блоки кода — перенесите существующую информацию о классе кода, если она доступна.
6. Перенести встраивания:
   1. Перенос iframe(ов), например, встраивания YouTube.
   2. Перенос встраивания YouTube
   3. Перенос текстовых вставок YouTube в стиле WordPress в тело сообщения
   4. Перенос встраивания YouTube из WP YouTube Lyte
   5. Перенесите вставку Google Map с помощью специального короткого кода googlemaps
   6. Перенос GitHub Gists
7. Перенесите шорткоды WordPress:
   1. Перенесите шорткод WordPress [caption] на Hugo {{< рисунок >}})
   2. Перенести шорткод WordPress [аудио])
8. Перенос блоков и функций Гутенберга:
   1. Перенос сносок WordPress
   2. Перенос галереи WordPress, включая пустую галерею

Перенос метаданных и атрибутов публикации

1. Сохранение статуса черновика для черновых и ожидающих публикации сообщений.
2. Используйте дату черновика в качестве резервной даты для черновиков сообщений.
3. Избранные изображения — правильно экспортируйте ассоциации избранных изображений со страницами и сообщениями.
4. Форматы записей WordPress

Перенос медиа-вложений

1. Перенести favicon.ico
2. Перенос изображений wp-content/uploads встроенных в страницы, в статические файлы Hugo, сохраняя при этом относительные URL-адреса.
3. Перенос внешних изображений (на разных хостах) в статические файлы Hugo.

Разное

1. Возможность фильтровать сообщения по авторам, что полезно при миграции на несколько сайтов WordPress.
2. Пользовательский шрифт — по умолчанию Lexend.
3. Поддержка размытия фона параллакса (аналогично WordPress Advanced Backgrounds).

Почему существующие инструменты не работают

Существующие инструменты выполняют лишь наполовину работу по переносу контента. Они редко переносят метаданные, такие как GUID, встраивания YouTube, встраивания Google Map и встраивание кода должным образом.

Хьюго Менеджер

В этом репозитории содержится экспериментальный инструмент hugomanager . Я использую этот инструмент для автоматического создания URL-адресов из заголовка, а также для того, чтобы узнать, какие сообщения в блоге все еще отмечены как черновики, а какие планируется опубликовать в ближайшее время.

Вы можете построить это через

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.

Примечание:

1. Для переноса комментариев используйте Remark42.