/cv

Primary LanguageTypstApache License 2.0Apache-2.0



Brilliant CV

Check Status Badge Typst Version

The Brilliant CV project is still under preview, just like Typst is, so use with caution as future updates might break your current production.

Read commits and changelog should you find new patches are not working, and feel free to lock to a working release & submit issues or PRs, I am happy to help!


Brilliant CV is a Typst template for making Résume, CV or Cover Letter inspired by the famous LaTeX CV template Awesome-CV.

Features

  • Separation of style and content: version control your CV entries in the modules folder, without touching the styling and typesetting of your CV / Cover Letter (hey, I am not talking about Macrohard Word, you know)
  • Quick twitches on the visual: add company logos, put your shiny company name or your coolest title at the first line globally or per-document needs
  • Multilingual support: centrally store your multilingual CVs (English + French + German + Chinese + Japanese if you are superb) and change output language in a blink

Preview

CV Cover Letter
CV Cover Letter
CV (French, red, no photo) Cover Letter (French, red)
CV Cover Letter
CV (Chinese, green) Cover Letter (Chinese, green)
CV Letter

Usage

Installation

You can either directly create a new repository by using this template, or you might want to add the submodule repository and build up your own Typst project.

Method 1: Jumpstart by clicking Use this template and create your own CV repository

When compiling, use:

typst compile ./cv.typ ./output/CV.pdf --font-path ./src/fonts/

Method 2: Add the submodule repository to your existing project

cd your/CV/project
git submodule add https://github.com/mintyfrankie/brilliant-CV-Submodule brilliant-CV
typst compile cv.typ

When you want to get new features from the updated template module:

git submodule update --remote

Tips

  • metadata.typ should live in the project root folder, and by changing the variables in it, you can quickly adjust language or display settings of the documents.
  • Make sure when you build a multilingual module (./modules_fr for example) you are quoting the right language variable in the metadata.typ (fr in this case).

Project Structure

|
|-- modules/          --> sections of your CV
|   |- *.typ
|
|-- modules_*         --> multilingual sections of your CV
|
|-- brilliant-CV/
|   |- template.typ   --> the template file
|   |- metadata-demo.typ -> the example metadata file
|
|-- src/
|   |- fonts/         --> local font files
|   |- logos/         --> logos for your cvEntry
|   |- *.png          --> images used in the documents
|   |- *.bib          --> BibTeX file for Publications section
|
|-- cv.typ          --> CV file
|-- letter.typ      --> Cover Letter file
|-- metadata.typ    --> Personal Infos & Settings

Current Issues

As Typst is still a very young (although very promising and robust to my belief) project, some features are only partially supported on certain platforms. It is hence difficult to predict any anomalies, but you are definitely welcomed to bring a PR, an issue or a discussion!

  • Image cropping: Typst does not have direct support to crop images using native primitives. Bring your own cropped image for profile photo if needed.
  • Publications Section: Current version of Typst does not allow full customization on the #bibliography function, so the display of publication section might not be optimal. See this disucssion.

Credit

  • Typst is a newborn, open source and simple typesetting engine that offers a better scripting experience than LaTeX.
  • Awesome-CV is the original LaTeX CV template from which this project is heavily inspired. Thanks posquit0 for your excellent work!