YAMLResume Mendarat di Homebrew

YAMLResume baru saja diterima](https://github.com/Homebrew/homebrew-core/pull/246949) oleh Homebrew (package manager paling populer di macOS). Itu artinya pengguna macOS sekarang dapat memasang dan memperbarui YAMLResume dengan satu perintah yang dapat dipercaya—tanpa instalasi global [Node.js] (https://nodejs.org) manual, tanpa memainkan path. Postingan ini menunjukkan langkah demi langkah yamlresume setup yang lebih detail dengan Homebrew dan mesin typesetting untuk output PDF terbaik.

Mengapa Ini Penting

Sebelumnya, jalur khas untuk mendapatkan CLI YAMLResume untuk pengguna macOS adalah:

1. pasang Node.js,
2. pasang CLI yamlresume dengan package manager Node.js (npm/pnpm/yarn/bun)
3. pasang mesin typesetting untuk menghasilkan PDF

Formula Homebrew dapat menggabungkan langkah 1 dan 2 menjadi satu, karena Homebrew dapat mengelola dependensi Node.js untuk Anda. Ini mengurangi masalah konfigurasi lingkungan dan menyederhanakan upgrade (brew upgrade yamlresume).

Instalasi Cepat

brew install yamlresume

Homebrew akan memasang Node.js sebagai dependensi jika Anda belum memilikinya.

Lalu verifikasi:

$ yamlresume help
Usage: yamlresume [options] [command]

YAMLResume — Resume as Code in YAML

 __   __ _    __  __ _     ____
 \ \ / // \  |  \/  | |   |  _ \ ___  ___ _   _ ___  ___   ___
  \ V // _ \ | |\/| | |   | |_) / _ \/ __| | | / _ \/ _ \ / _ \
   | |/ ___ \| |  | | |___|  _ <  __/\__ \ |_| | | | | | |  __/
   |_/_/   \_\_|  |_|_____|_| \_\___||___/\____|_| |_| |_|\___|


Options:
  -V, --version                  output the version number
  -v, --verbose                  verbose output
  -h, --help                     display help for command

Commands:
  new [filename]                 create a new resume
  build [options] <resume-path>  build a resume to LaTeX and PDF
  dev [options] <resume-path>    build a resume on file changes (watch mode)
  languages                      i18n and l10n support
  templates                      manage resume templates
  validate <resume-path>         validate a resume against the YAMLResume schema
  help [command]                 display help for command

Jika Anda melihat output help, binary CLI tersedia di PATH Anda.

YAMLResume bergantung pada mesin typesetting untuk menghasilkan PDF, Anda dapat memasang MacTeX atau Tectonic melalui Homebrew.

Opsi A: Full TeX Live (XeTeX)

Pasang melalui MacTeX cask (termasuk XeTeX):

# install the full mactex
brew install mactex
# or if you want to save some disk space
brew install mactex-no-gui

Setelah instalasi, pastikan binary TeX ada di PATH (Homebrew biasanya menautkannya di bawah /Library/TeX/texbin). Test:

$ xelatex --version
XeTeX 3.141592653-2.6-0.999994 (TeX Live 2022)
kpathsea version 6.3.4
Copyright 2022 SIL International, Jonathan Kew and Khaled Hosny.
There is NO warranty.  Redistribution of this software is
covered by the terms of both the XeTeX copyright and
the Lesser GNU General Public License.
For more information about these matters, see the file
named COPYING and the XeTeX source.
Primary author of XeTeX: Jonathan Kew.
Compiled with ICU version 70.1; using 70.1
Compiled with zlib version 1.2.11; using 1.2.11
Compiled with FreeType2 version 2.11.1; using 2.11.1
Compiled with Graphite2 version 1.3.14; using 1.3.14
Compiled with HarfBuzz version 3.4.0; using 3.4.0
Compiled with libpng version 1.6.37; using 1.6.37
pplib version v2.05 less toxic i hope
Using Mac OS X Core Text and Cocoa frameworks

Opsi B: Tectonic (Ringan)

$ brew install tectonic
$ tectonic --version

Mana yang harus Anda pilih?

Jika Anda mengalami masalah paket LaTeX yang tidak dapat dijelaskan atau kasus edge penanganan font lanjutan, fallback ke XeTeX.

Membuat dan Membangun Curriculum Vitae

Seperti biasa, Anda dapat membuat curriculum vitae YAML starter dengan:

$ yamlresume new my-resume.yml
✔ Created my-resume.yml successfully.

Periksa dan edit my-resume.yml di editor Anda, lalu build ke PDF:

$ yamlresume build my-resume.yml
◐ Generating resume PDF with command: xelatex -halt-on-error my-resume.tex...
✔ Generated resume PDF successfully.

Di baliknya YAMLResume akan:

1. transform my-resume.yml menjadi LaTeX (my-resume.tex).
2. panggil mesin typesetting Anda (xelatex atau tectonic).
3. hasilkan my-resume.pdf.

Upgrade

Tetap terkini (template baru, perbaikan, peningkatan i18n):

$ brew update
$ brew upgrade yamlresume

Uninstall

$ brew uninstall yamlresume

Hapus dependensi opsional hanya jika Anda tidak membutuhkannya lagi (font, mesin TeX, dll.).

Pemecahan Masalah

Mode verbose membantu mendiagnosis masalah build curriculum vitae:

$ yamlresume build --verbose my-resume.yml

Perbaikan umum:

• mesin typesetting hilang: pasang MacTeX atau gunakan Tectonic.
• permission denied menulis file: pastikan Anda di direktori yang dapat ditulis (hindari path sistem).
• ketidakcocokan mesin/kesalahan LaTeX aneh di Tectonic: fallback ke XeTeX (brew install mactex).

Catatan Akhir

Termasuk dalam Homebrew menurunkan hambatan untuk pengguna baru dan menandakan kematangan proyek. Jika Anda mengalami kasus edge, buka issue atau diskusi—kami iterate dengan cepat. Selamat hacking dan mungkin curriculum vitae Anda selalu pixel perfect!

Terakhir tetapi tidak kalah penting, kredit kepada @chenrui333 lagi atas PR awalnya untuk termasuk YAMLResume di Homebrew.