wp2hugo

WordPress에서 Hugo Static 사이트 마이그레이션 도구로

이것은 WordPress 내보내기를 Hugo로 마이그레이션하는 데 가장 적합한 마이그레이션 도구입니다. 이는 내 개인 웹사이트를 Hugo 기반 사이트로 마이그레이션하는 동안 직면했던 몇 가지 이상한 사례를 처리합니다.

이는 주로 Hugo 기반 코드 생성을 대상으로 하지만 WordPress 블로그를 Mkdocs 또는 Jekyll과 같은 다른 시스템에서 사용할 수 있는 Markdown 기반 파일로 변환하는 데 사용할 수 있습니다.

상업적인 용도

저는 이 프로젝트가 가능한 한 널리 접근 가능하고 동시에 개발 비용도 지원되기를 바랍니다. 이 프로젝트는 비상업적, 개인적 용도로 완전 무료입니다. 라이센스를 통해 상업적인 사용이 제한됩니다. 상업적으로 라이선스를 취득하고 싶다면 언제든지 저에게 연락해주세요.

용법

바이너리

• 릴리스에서 wp2hugo 도구 다운로드
• Tools -> Export 통해 WordPress 웹사이트 내보내기
• 다운로드한 파일이 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 사용자 정의 게시물 유형 마이그레이션(FAQ, 포트폴리오)
6. WordPress 홈페이지를 올바르게 설정하십시오.
7. WordPress 작성자 페이지 만들기

영구 링크 마이그레이션

1. 미디어 URL을 포함한 모든 URL을 올바르게 마이그레이션하세요.
2. GUID -> 상대 URL 매핑을 포함하는 Nginx 구성 생성
3. 항목이 동일하게 표시되도록 기존 UUID를 사용하여 RSS 피드를 마이그레이션합니다. 이는 다음과 같은 중요한 피드가 있는 모든 사람에게 중요합니다. 실패한 마이그레이션에 대한 자세한 내용을 참조하세요.
4. WordPress의 RSS feed.xml Hugo의 RSS feed.xml 에 매핑

게시물 콘텐츠 및 단축 코드 마이그레이션

1. 페이지 발췌 마이그레이션
2. WordPress의 "더보기..." 마이그레이션 -> Hugo Summary
3. 목록 카테고리 게시물 마이그레이션(catlist)
4. WordPress 목차 마이그레이션 -> Hugo
5. 코드 블록을 올바르게 마이그레이션 - 가능한 경우 기존 코드 클래스 정보를 마이그레이션합니다.
6. 임베드 마이그레이션:
   1. YouTube 삽입과 같은 iframe 마이그레이션
   2. YouTube 삽입 이전
   3. 게시물 본문에 WordPress 스타일의 일반 텍스트 YouTube 삽입을 마이그레이션합니다.
   4. WP YouTube Lyte YouTube 삽입 마이그레이션
   5. 맞춤 단축 코드 googlemaps 통해 Google 지도 삽입 마이그레이션
   6. GitHub 요점 마이그레이션
7. WordPress 단축 코드 마이그레이션:
   1. WordPress [캡션] 단축 코드를 Hugo의 {{< 그림 >}})으로 마이그레이션
   2. WordPress [오디오] 단축 코드 마이그레이션)
8. Gutenberg 블록 및 기능 마이그레이션:
   1. WordPress 각주 마이그레이션
   2. 빈 갤러리를 포함하여 WordPress 갤러리 마이그레이션

게시물 메타데이터 및 속성 마이그레이션

1. 초안 및 대기 중인 게시물의 초안 상태 유지
2. 초안 게시물의 대체 날짜로 초안 날짜를 사용하세요.
3. 주요 이미지 - 페이지 및 게시물과의 주요 이미지 연결을 올바르게 내보냅니다.
4. WordPress 게시물 형식

미디어 첨부 파일 마이그레이션

1. favicon.ico 마이그레이션
2. 상대 URL을 유지하면서 페이지에 포함된 wp-content/uploads 이미지를 Hugo 정적 파일로 마이그레이션합니다.
3. 외부 이미지(다른 호스트에 있음)를 Hugo 정적 파일로 마이그레이션

기타

1. 작성자별로 게시물을 필터링하는 기능은 WordPress 다중 사이트 마이그레이션에 유용합니다.
2. 사용자 정의 글꼴 - 기본값은 Lexend입니다.
3. 시차 흐림 배경 지원(WordPress 고급 배경과 유사)

기존 도구가 작동하지 않는 이유

기존 도구는 콘텐츠 마이그레이션 작업을 절반만 수행합니다. GUID, YouTube 포함, Google 지도 포함, 코드 포함과 같은 메타데이터를 제대로 마이그레이션하는 경우는 거의 없습니다.

휴고 매니저

이 저장소에는 실험 도구인 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를 사용하세요.