개요

Hugo의 매뉴얼에 따르면 GitHub Pages에 문서를 푸시 Wercker step
lukevivier/gh-pages이 있습니다. 그러나이 단계는 과거 커밋을 덮어 쓰므로,
커밋 로그를 남기는 다른 단계 jkawamoto/ghp-import를 만들었습니다.

사용법

jkawamoto/ghp-import step을 실행하려면 pip가 필요합니다.wercker.yml에서 steps

- install-packages:
    packages: python-pip

를 추가하거나 box에 jkawamoto/ghp-box을 사용하십시오.
jkawamoto/ghp-import step에는 다음 옵션이 있습니다.

token: Github 액세스 토큰.

basedie : 문서의 루트 경로.

msg ​​: 약어 커밋 메시지.

branch : 브랜치 이름. 기본값은 gh-pages .

공개 저장소에는 public_repo 권한이 있는 액세스 토큰이 필요합니다. 개인 저장소의 경우 repo 권한이 필요하다고 생각합니다. 또한 wercker.yml에 직접 값을 쓰는 대신 환경 변수를 통해 전달하십시오. 환경 변수는 다음 화면에서 등록 할 수 있습니다.

예

roadie에서 실제로 사용하는 예는 다음과 같습니다.

wercker.yml

box: jkawamoto/ghp-box
build:
  steps:
    - script:
        name: Prepare submodules
        code: |-
          git submodule update --init
    - arjen/hugo-build:
        version: "0.15"
        basedir: docs
deploy:
  steps:
    - jkawamoto/ghp-import:
        token: $GIT_TOKEN
        basedir: docs/public