Typstで履歴書と職務経歴書をBuildする

Table of Contents

背景・動機

直近履歴書と職務経歴書を書く必要があった。

以前はGoogle Docsやpagesを使って適当に書いていたのだが、これからのAI時代はコードベースで管理できた方がよいだろうということで移行を決意した。最近Typst推しなのでTypstからPDFをNix Buildで生成できるようにしてみた。

試したこと・やったこと

0. アプローチのやり方を考える

世間一般的には履歴書や職務経歴書の絶対的な規格というものはなく、業界や各事業者によってさまざまな運用がされているらしい。履歴書にはJIS規格があるが、必ずしも準拠する必要はないらしい。

必要な情報というのはある程度決まっており、それに倣っておくと汎用性の高い履歴書と職務経歴書になるということで世の中転がってるものをひととおり確認した。

今回は次のようにコンテンツとテンプレートを分けて、より管理をしやすいように設計した。

YAML: コンテンツをKey/Valueで表現する
Typst: YAMLを読み込んでテンプレートからPDFを作成する

1. レポジトリ作成

現状GitHubのレポジトリや設定をTerraform上で管理しているので、Terraform経由でPrivateレポジトリを作成した。

また、他の人が使えるようにOSS版も作った。

https://github.com/takeokunn/typst-resume-template

2. Nix Build周り整備

fontは日本語を正しく描画してくれるHackgenを選んだ。 fontもNix経由でインストールできるの非常に体験がよい。

https://github.com/takeokunn/typst-resume-template/blob/main/cv/flake.nix

flake.nix:

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs";
    flake-utils.url = "github:numtide/flake-utils";
  };

  outputs =
    {
      self,
      nixpkgs,
      flake-utils
    }:
    flake-utils.lib.eachDefaultSystem (
      system:
      let
        pkgs = import nixpkgs { inherit system; };
      in
        {
          devShells.default = pkgs.mkShell {
            packages = with pkgs; [ typst ];
          };

          packages.default = pkgs.stdenv.mkDerivation {
            name = "private-career-cv";
            src = ./.;
            nativeBuildInputs = with pkgs; [ typst hackgen-font ];
            buildPhase = ''
              typst compile main.typ --font-path ${pkgs.hackgen-font}/share/fonts/hackgen-nf
            '';
            installPhase = ''
              mkdir -p $out
              cp main.pdf $out/cv.pdf
            '';
          };
        }
    );
}