직무 경력서를 GitLab Pages를 사용하여 공개해 보았습니다.

처음에

장기간의 휴가가 되어, 정리된 시간을 잡을 수 있었기 때문에 자신의 2년간의 되돌아보고, 막상이라는 때를 위해서 직무 경력서 되는 것을 써 보려고 했다. 형식을 살펴보면 PDF나 Word와 같은 형식이 주류인 것 같다. 처음에는 Word로 쓰고 PDF로 변환하려고 생각했지만, 마침내 나는 엔지니어이므로 Word 레이아웃과 격투하는 등의 불필요한 비용은 사용하지 않고 Markdown에서 빨리 쓰고 구성 관리를 하고 싶었다. 그래서 개인적으로 사용하고 있는 GitLab에서 구성 관리, 특히 숨길 이유도 없기 때문에 GitLab Pages에서 공개하기로 했다.

작업 내용

실현하고 싶은 것은 이하와 같다.

직무경력서(Markdown)를 구성관리하고 싶다.

Master에 병합한 타이밍에 PDF로 변환해 다운로드할 수 있도록(듯이) 하고 싶다.

별도로 숨길 필요도 없으므로 GitLab Pages로 공개한다.

리포지토리 생성

특히 이름에 결정은 없지만, 영약으로 하면 Curriculum Vitae 라는 것이었으므로, curriculum-vitae 라는 이름으로 했다.
다음은 리포지토리의 디렉토리 구성입니다. (GitBook의 디렉토리 구성을 따르고 있습니다)

curriculum-vitae
|- styles
|   |- pdf.css
|   |- website.css
|- gitlab-ci.yml
|- book.json
|- README.md
|- SUMMARY.md

styles : 공개 사이트 및 PDF에 적용 할 스타일 시트

.gitlab-ci.yml : GitLab CI/CD에서 실행되는 스크립트 정의

book.json: GitBook 설정 파일

이하, 설정 예입니다.

book.json

  {
    "langeage": "ja",
    "title": "Curriculum Vitae",
    "styles": {
      "website": "styles/website.css",
      "pdf": "styles/pdf.css"
    },
    "plugins": ["theme-api", "-sharing"]
  }

README.md : 직무 경력서 본문

SUMMARY.md : 문장 구성

직무경력서 작성

각 경력을 자유롭게 기재하십시오. 무엇을 쓸까는 정해져 있지 않습니다만, 나는 이 근처를 참고로 썼습니다.

엔지니어가 읽고 싶은 직무경력서

GitLab Pages에서 게시할 준비

.gitlab-ci.yml 쓰기

GitLab CI/CD를 사용하여 정적 사이트 빌드 -> 게시, Markdown에서 PDF로 변환합니다.
다음 파일을 리포지토리의 루트에 놓습니다.

gitlab-ci.yml

image: node:10

cache:
  paths:
    - node_modules/

before_script:
  - apt-get update
  - apt-get install -y calibre xvfb fonts-ipafont-gothic fonts-ipafont-mincho
  - npm install -g gitbook-cli
  - gitbook fetch 3.2.3
  - gitbook install

test:
  stage: test
  script:
    - gitbook build . public
    - xvfb-run gitbook pdf
  only:
    - branches
  except:
    - master

pages:
  stage: deploy
  script:
    - gitbook build . public
    - xvfb-run gitbook pdf . curriculum-vitae.pdf
  artifacts:
    paths:
      - public
      - curriculum-vitae.pdf
    expire_in: 1 week
  only:
    - master