[Open Source] **告別Word，YAML履歷，求職季倒數計時中！**

再見Word，你好RenderCV！用YAML寫履歷，打造你的完美PDF

身為台灣的求職者，你是否也曾為了製作一份漂亮的履歷而煩惱？在Word裡調整格式、對齊方式，常常弄得焦頭爛額，好不容易排版好了，換個電腦字體就跑掉，簡直想哭！

今天，我要向大家介紹一個超好用的工具： RenderCV。它讓你擺脫Word的束縛，用YAML這個簡單的文字格式來撰寫履歷，輕鬆產生專業又美觀的PDF！

為什麼要選擇RenderCV？

• 告別排版地獄：RenderCV 幫你處理所有排版細節，像是字體、間距、對齊等，讓你專注於內容，不必再浪費時間在格式上。
• 版本控制超方便：履歷是用文字檔儲存，就像寫程式一樣，你可以使用Git等版本控制工具，輕鬆追蹤修改紀錄、還原到之前的版本，再也不怕履歷改到面目全非！
• 完美字體呈現：RenderCV 採用專業的排版引擎，產生的PDF字體美觀、對齊精準，讓你的履歷看起來更專業、更有質感。
• 客製化設計：RenderCV 提供多種主題，你也可以根據自己的喜好調整顏色、字體、邊距等，打造獨一無二的履歷。
• 跨平台使用：只要有Python環境，你就可以在 Windows、macOS 或 Linux 上使用 RenderCV。

什麼是 YAML？ 為什麼要用它？

YAML (YAML Ain’t Markup Language) 是一種人類可讀的資料序列化格式。簡單來說，它就像一種更友善、更容易閱讀的文字格式，特別適合用來描述資料結構，像是履歷的內容。

YAML 的優點：

• 易於閱讀：YAML 使用縮排來表示資料結構，看起來清爽、易懂。
• 易於編輯：用任何文字編輯器都可以編輯 YAML 檔案，方便修改內容。
• 結構清晰：YAML 的結構化特性，有助於你更有條理地整理履歷資訊。

快速上手 RenderCV： 從安裝到產出 PDF

1. 安裝 RenderCV

首先，你需要安裝 Python 3.12 或更高版本。然後，打開你的終端機（Terminal）或命令提示字元（Command Prompt），輸入以下指令：

pip install "rendercv[full]"

• pip 是 Python 的套件管理工具，用於安裝和管理 Python 套件。
• "rendercv[full]" 表示安裝 RenderCV 以及所有必要的依賴套件。

2. 建立你的第一份履歷

安裝完成後，使用以下指令建立一個新的 YAML 檔案，並以你的名字命名：

rendercv new "你的名字"

例如，如果你的名字是「王小明」，就輸入：

rendercv new "王小明"

這個指令會建立一個名為 你的名字_CV.yaml 的檔案。

3. 編輯你的 YAML 檔案

用你喜歡的文字編輯器（例如：Notepad++、Visual Studio Code、Sublime Text 等）打開 你的名字_CV.yaml 檔案。你會看到一個預設的 YAML 結構，裡面已經有一些範例內容。

現在，你可以開始修改這個檔案，填入你的履歷資訊。以下是一些基本的 YAML 語法和範例：

cv:
  name: 王小明  # 你的姓名
  location: 台北市  # 你的居住地
  email: xiaoming.wang@example.com  # 你的電子郵件
  website: https://www.linkedin.com/in/xiaoming/  # 你的 LinkedIn 網址
  social_networks: # 你的社群連結
    - network: LinkedIn
      username: xiaoming
    - network: GitHub
      username: xiaomingwang
  sections:
    簡介: # 自我介紹
      - 積極主動、熱愛學習的軟體工程師，擁有三年以上的開發經驗，擅長Python、Java等程式語言...
    學歷:
      - institution: 國立台灣大學
        area: 資訊工程學系
        degree: 碩士
        date: # 日期可以只寫年份，或完整日期
          start_date: 2018-09
          end_date: 2020-06
        location: 台北市
        summary: 碩士論文研究方向為...
        highlights:  # 突出顯示的重點
          - 參與 XXX 專案，負責 XXX 模組的開發
          - 獲得 XXX 獎學金
    工作經驗:
      - company: ABC 公司
        title: 軟體工程師
        date:
          start_date: 2020-07
          end_date: 至今
        location: 台北市
        summary: 負責 XXX 產品的開發和維護，主要使用 Python 和 Django 框架...
        highlights:
          - 參與 XXX 功能的設計和開發，提升使用者體驗
          - 成功部署 XXX 系統，提升系統效能

YAML 語法小提示：

• 冒號 (:)：用於分隔鍵 (key) 和值 (value)。
• 縮排：YAML 使用縮排來表示層次結構。通常使用兩個或四個空格。
• 列表 (List)：使用 - 開頭表示列表中的每個項目。
• 字串 (String)：字串可以用單引號或雙引號括起來，但通常不需要。

4. 產生 PDF

修改完 YAML 檔案後，在終端機或命令提示字元中，輸入以下指令來產生 PDF：

rendercv render "你的名字_CV.yaml"

例如：

rendercv render "王小明_CV.yaml"

RenderCV 會自動讀取 YAML 檔案，並產生一份漂亮的 PDF 履歷，預設檔案名稱為 你的名字_CV.pdf。

5. 檢視 PDF

在你的工作目錄中，你會看到一個名為 你的名字_CV.pdf 的檔案。用 PDF 閱讀器打開它，就可以看到你的履歷啦！

深入探索 RenderCV： 更多進階功能

1. 選擇主題

RenderCV 提供了多種主題，你可以根據自己的喜好選擇：

• classic：經典、簡潔的主題。
• engineeringresumes：適合工程師的專業主題。
• sb2nov：現代感十足的主題。
• moderncv：簡約、時尚的主題。
• engineeringclassic：另一個工程師專用主題。
• 你也可以自訂主題！

要更換主題，可以在 YAML 檔案的 design 部分指定 theme：

design:
  theme: moderncv

2. 自訂設計

除了主題，你還可以自訂各種設計選項，例如：

• page: 設定頁面大小、邊距、頁尾等。
• colors: 設定字體顏色、標題顏色、連結顏色等。
• typography: 設定字體、行距、對齊方式等。

例如，要修改字體顏色，可以在 design 部分加入 colors：

design:
  colors:
    body: rgb(50, 50, 50)  # 設定正文字體顏色為深灰色
    name: rgb(0, 100, 200) # 設定姓名顏色為藍色

3. JSON Schema 支援

RenderCV 提供了 JSON Schema，讓你可以在支援 JSON Schema 的編輯器中，獲得程式碼自動補全和語法檢查功能。這可以大幅提升編輯 YAML 檔案的效率。

你可以參考 RenderCV 的官方文件 了解如何在 Visual Studio Code 中設定 JSON Schema。

4. 支援多國語言

RenderCV 支援多國語言，包括中文。你可以在 locale 部分設定語言：

locale:
  language: chinese_traditional # 繁體中文
  last_updated:  更新於
  month: 月
  months: 月
  year: 年
  years: 年
  present: 至今
  month_abbreviations:
    - 一月
    - 二月
    - 三月
    - 四月
    - 五月
    - 六月
    - 七月
    - 八月
    - 九月
    - 十月
    - 十一月
    - 十二月

設定好語言後，RenderCV 產生的 PDF 中的日期、標題等就會使用中文顯示。

實作心得與錯誤排除

我自己在製作履歷時，也嘗試使用了 RenderCV。以下分享一些實作心得和可能遇到的問題：

• 善用 VS Code： VS Code 搭配 YAML 擴充套件和 JSON Schema，編輯 YAML 檔案簡直是如虎添翼！自動補全、語法檢查功能，可以大大減少出錯的機率。
• 先從範例開始： RenderCV 官方提供了許多範例，可以參考這些範例來撰寫自己的履歷，避免從頭開始的迷茫。
• 逐步調整： 不要一次把所有內容都填進去。先填入基本資訊，然後逐步增加內容，並隨時檢查 PDF 產生的結果，更容易發現和解決問題。
• 調整間距和排版： 如果你對預設的排版不滿意，可以調整 design 部分的 line_spacing (行距) 和 alignment (對齊方式) 等選項。
• 檢查 YAML 語法： YAML 語法非常嚴格，如果出現錯誤，RenderCV 會產生錯誤訊息。仔細檢查錯誤訊息，通常就能找到問題所在。
• 中文字體問題： 預設情況下，RenderCV 可能無法正確顯示中文。你可以參考 RenderCV 的官方文件，設定中文字體，例如思源黑體 (Source Han Sans)。
• 版本控制很重要： 使用 Git 等版本控制工具，可以追蹤每次修改，方便回溯到之前的版本，避免修改錯誤導致履歷崩潰。

結語： 告別繁瑣，擁抱專業

RenderCV 是一個功能強大、易於使用的履歷製作工具。它讓你擺脫Word的束縛，專注於內容的撰寫，並輕鬆打造出專業、美觀的 PDF 履歷。

希望這篇文章能幫助你開始使用 RenderCV，讓你的求職之路更加順利！ 趕快試試看，打造一份令人印象深刻的履歷吧！

RenderCV 官方網站
RenderCV 官方文件 (有更詳細的教學和範例)

參考閱讀

https://github.com/rendercv/rendercv