GitLab CI와 mdbook에서 책을 쓰고 게시

mdbook은 Rust에서 만든 Gitbook 클론입니다.



이렇게 왼쪽으로 짚고 오른쪽에 본문 형식의 HTML을 할 수 있습니다. Rust 문서의 대부분은 mdbook에서 생성되어 있기 때문에 Rust를 쓰고 있다고 잘 보네요.

이전 기사 에서 소개한 대로, 그림이나 수식(MathJax)을 추가할 수 있습니다.


이번에는 이 mdbook에서 생성한 HTML을 GitLab의 기능인 GitLab CI를 이용해 자동으로 배포하기 위한 설정을 간단하게 실시하기 위한 리포지토리를 만들었으므로 소개합니다.

사용법

GitLab에서 포크 htps : // 기트 b. 코 m / 테 r도 sh t / my fu rst md 보오 k

src/아래의 Markdown 파일에 추가

GitLab에 푸시

에서 HTTPS로 생성된 book 형식의 HTML을 호스팅합니다.

Markdown에서 수식을 작성하는 방법은 이전 기사를 참조하십시오.

eom/book의 일본어판을 만들기 시작했다

URL은 https://{username}.gitlab.com/{repository_name} 가 되어야 합니다.

실제로는 왼쪽의 Settings > Pages 탭을 보면 올바른 링크가 있어야합니다

최초 배포에서는 SSL 인증서를 활성화하는 데 30분 정도(?) 걸릴 것이므로 주의하십시오.

손으로 생성 결과 확인

쓰는 도중에 확인하려면 mdbook을 설치해야합니다. 후술하는 방법으로 설치 한 후,

mdbook build

에서 book/ 디렉토리 아래에 HTML이 생성됩니다.

바이너리 다운로드

GitHub mdbook 리포지토리 릴리스 페이지에서 바이너리가 배포되므로 사용

tar/zip의 압축을 풀면 실행 파일의 mdbook

cargo로 설치

Rust의 개발 환경을 정돈하는 경우

cargo install mdbook

에 들어갑니다. 그냥 컴파일은 조금 무겁습니다.