chore: update manual generation lib

Fixes #92

.github/workflows/build-documentation.yml

@@ -1,21 +0,0 @@
-name: Build documentation
-on: [push, workflow_dispatch]
-jobs:
-  build_pdf:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Set up Git repository
-        uses: actions/checkout@v4
-      - name: Install fonts
-        run: sudo apt-get install fonts-font-awesome fonts-roboto texlive-fonts-recommended texlive-fonts-extra
-      - name: Typst
-        uses: yusancky/setup-typst@v2
-        id: setup-typst
-        with:
-          version: 'v0.11.0'
-      - run: typst compile modern-cv-docs.typ
-      - name: Upload PDF file
-        uses: actions/upload-artifact@v3
-        with:
-          name: modern-cv-docs
-          path: modern-cv-docs.pdf

.github/workflows/release.yml

@@ -0,0 +1,77 @@
+name: Package and push to registry repo
+on:
+  push:
+    tags: [ '*' ]
+
+env:
+  # the repository to which to push the release version
+  # usually a fork of typst/packages (https://github.com/typst/packages/)
+  # that you have push privileges to
+  REGISTRY_REPO: DeveloperPaul123/typst-packages
+  # the path within that repo where the "<name>/<version>" directory should be put
+  # for the Typst package registry, keep this as is
+  PATH_PREFIX: packages/preview
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Probe runner package cache
+        uses: awalsh128/cache-apt-pkgs-action@v1
+        with:
+          packages: cargo
+          version: 1.0
+
+      - name: Install just from crates.io
+        uses: baptiste0928/cargo-install@v3
+        with:
+          crate: just
+
+      - name: Setup typst
+        uses: typst-community/setup-typst@v3
+        with:
+          typst-version: latest
+
+      - name: Determine and check package metadata
+        run: |
+          . scripts/setup
+          echo "PKG_NAME=${PKG_PREFIX}" >> "${GITHUB_ENV}"
+          echo "PKG_VERSION=${VERSION}" >> "${GITHUB_ENV}"
+
+          if [[ "${GITHUB_REF_NAME}" != "${VERSION}" ]]; then
+            echo "package version ${VERSION} does not match release tag ${GITHUB_REF_NAME}" >&2
+            exit 1
+          fi
+
+      - name: Build package
+        run: |
+          just doc
+          just package out
+
+      - name: Checkout package registry
+        uses: actions/checkout@v4
+        with:
+          repository: ${{ env.REGISTRY_REPO }}
+          token: ${{ secrets.REGISTRY_TOKEN }}
+          path: typst-packages
+
+      - name: Release package
+        run: |
+          mkdir -p "typst-packages/${{ env.PATH_PREFIX }}/$PKG_NAME"
+          mv "out/${PKG_NAME}/${PKG_VERSION}" "typst-packages/${{ env.PATH_PREFIX }}/${PKG_NAME}"
+          rmdir "out/${PKG_NAME}"
+          rmdir out
+
+          GIT_USER_NAME="$(git log -1 --pretty=format:'%an')"
+          GIT_USER_EMAIL="$(git log -1 --pretty=format:'%ae')"
+
+          cd typst-packages
+          git config user.name "${GIT_USER_NAME}"
+          git config user.email "${GIT_USER_EMAIL}"
+          git checkout -b "${PKG_NAME}-${PKG_VERSION}"
+          git add .
+          git commit -m "${PKG_NAME}:${PKG_VERSION}"
+          git push --set-upstream origin "${PKG_NAME}-${PKG_VERSION}"

.github/workflows/tests.yml

@@ -0,0 +1,84 @@
+name: Tests
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  tests:
+    strategy:
+      matrix:
+        # add any other Typst versions that your package should support
+        typst-version: ["0.12"]
+        # the docs don't need to build with all versions supported by the package;
+        # the latest one is enough
+        include:
+          - typst-version: "0.12"
+            doc: 1
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Probe runner package cache
+        uses: awalsh128/cache-apt-pkgs-action@v1
+        with:
+          packages: imagemagick cargo
+          version: 1.0
+
+      - name: Install oxipng from crates.io
+        uses: baptiste0928/cargo-install@v3
+        with:
+          crate: oxipng
+
+      - name: Install just from crates.io
+        uses: baptiste0928/cargo-install@v3
+        with:
+          crate: just
+
+      - name: Install typst-test from github
+        uses: baptiste0928/cargo-install@v3
+        with:
+          crate: typst-test
+          git: https://github.com/tingerrr/typst-test.git
+          tag: ci-semi-stable
+
+      - name: Setup typst
+        uses: typst-community/setup-typst@v3
+        with:
+          typst-version: ${{ matrix.typst-version }}
+    
+      - name: Install fonts
+        run: |
+            sudo apt update
+            sudo apt-get install fonts-roboto
+            ./scripts/install-fontawesome
+            ./scripts/install-source-sans
+
+      - name: Install locally
+        run: just install
+
+      - name: Run test suite
+        run: just test
+
+      - name: Archive diffs
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: diffs
+          path: |
+            tests/**/diff/*.png
+            tests/**/out/*.png
+            tests/**/ref/*.png
+          retention-days: 5
+
+      - name: Build docs
+        if: ${{ matrix.doc }}
+        run: just doc
+     
+      - name: Upload docs
+        uses: actions/upload-artifact@v4
+        with:
+          name: manual
+          path: docs/manual.pdf

.gitignore

@@ -1 +1,3 @@
-*.pdf
+*.pdf
+tests/*/diff
+tests/*/out

.typstignore

@@ -0,0 +1,9 @@
+.github
+.fork
+scripts
+template/*.pdf
+.gitignore
+.issuetracker
+tests/*
+docs/*
+Justfile

Justfile

@@ -0,0 +1,45 @@
+root := justfile_directory()
+
+export TYPST_ROOT := root
+
+[private]
+default:
+    @just --list --unsorted
+
+# generate manual
+doc:
+    typst compile docs/manual.typ docs/manual.pdf
+
+# run test suite
+test *args:
+    typst-test run {{ args }}
+
+# update test cases
+update *args:
+    typst-test update {{ args }}
+
+# package the library into the specified destination folder
+package target:
+  ./scripts/package "{{target}}"
+
+# install the library with the "@local" prefix
+install: (package "@local")
+
+# install the library with the "@preview" prefix (for pre-release testing)
+install-preview: (package "@preview")
+
+[private]
+remove target:
+  ./scripts/uninstall "{{target}}"
+
+# uninstalls the library from the "@local" prefix
+uninstall: (remove "@local")
+
+# uninstalls the library from the "@preview" prefix (for pre-release testing)
+uninstall-preview: (remove "@preview")
+
+format:
+    ./scripts/format
+
+# run ci suite
+ci: test doc

README.md

@@ -3,12 +3,23 @@
 [![say thanks](https://img.shields.io/badge/Say%20Thanks-👍-1EAEDB.svg)](https://github.com/DeveloperPaul123/modern-cv/stargazers)
 [![Discord](https://img.shields.io/discord/652515194572111872?logo=Discord)](https://discord.gg/CX2ybByRnt)
 ![Release](https://img.shields.io/github/v/release/DeveloperPaul123/modern-cv)
-[![Build documentation](https://github.com/DeveloperPaul123/modern-cv/actions/workflows/build-documentation.yml/badge.svg)](https://github.com/DeveloperPaul123/modern-cv/actions/workflows/build-documentation.yml)
+[![Tests](https://github.com/DeveloperPaul123/modern-cv/actions/workflows/tests.yml/badge.svg)](https://github.com/DeveloperPaul123/modern-cv/actions/workflows/tests.yml)  
 
 A port of the [Awesome-CV](https://github.com/posquit0/Awesome-CV) Latex resume template in [typst](https://github.com/typst/typst).
 
 ## Requirements
 
+### Tools
+
+The following tools are used for the development of this template:
+
+- [typst](https://github.com/typst/typst)
+- [typst-test](https://github.com/tingerrr/typst-test) for running tests
+- [just](https://github.com/casey/just) for simplifying command running
+- [oxipng](https://github.com/shssoichiro/oxipng) for compressing thumbnails used in the README
+
+### Fonts
+
 You will need the `Roboto` and `Source Sans Pro` fonts installed on your system or available somewhere. If you are using the `typst` web app, no further action is necessary. You can download them from the following links:
 
 - [Roboto](https://fonts.google.com/specimen/Roboto)
@@ -27,7 +38,7 @@ See `typst fonts --help` for more information on configuring fonts for `typst` t
 Below is a basic example for a simple resume:
 
 ```typst
-#import "@preview/modern-cv:0.1.0": *
+#import "@preview/modern-cv:0.8.0": *
 
 #show: resume.with(
   author: (
@@ -43,7 +54,9 @@ Below is a basic example for a simple resume:
         "Software Architect"
       )
   ),
-  date: datetime.today().display()
+  profile-picture: none,
+  date: datetime.today().display(),
+  page-size: "us-letter"
 )
 
 = Education
@@ -81,19 +94,21 @@ Documentation for this template is published with each commit. See the attached
 
 ## Building and Testing Locally
 
-To build and test the project locally, you will need to install the `typst` CLI. You can find instructions on how to do this [here](https://typst.app/docs/getting-started).
+To build and test the project locally, you will need to install the `typst` CLI. You can find instructions on how to do this [here](https://github.com/typst/typst#installation).
 
-With typst installed you can make changes to `lib.typ` and then `install_package_locally.ps1` to install the package locally. Change the import statements in the template files to point to the local package:
+With typst installed you can make changes to `lib.typ` and then `just install` or `just install-preview` to install the package locally. Change the import statements in the template files to point to the local package (if needed):
 
 ```typst
-#import "@local/modern-cv:0.3.0": *
+#import "@local/modern-cv:0.8.0": *
 ````
 
+If you use `just install-preview` you will only need to update the version number to match `typst.toml`.
+
 Note that the script parses the `typst.toml` to determine the version number and the folder the local files are installed to.
 
 ### Formatting
 
-This project uses [typstyle](https://github.com/Enter-tainer/typstyle) to format the code. The script `format_typst.ps1` will format all the `*.typ` files in the project. Be sure to install `typstyle` before running the script.
+This project uses [typstyle](https://github.com/Enter-tainer/typstyle) to format the code. Run `just format` to format all the `*.typ` files in the project. Be sure to install `typstyle` before running the script.
 
 ## License
 

assets/icons/LICENSE.txt

@@ -1,165 +0,0 @@
-Fonticons, Inc. (https://fontawesome.com)
-
---------------------------------------------------------------------------------
-
-Font Awesome Free License
-
-Font Awesome Free is free, open source, and GPL friendly. You can use it for
-commercial projects, open source projects, or really almost whatever you want.
-Full Font Awesome Free license: https://fontawesome.com/license/free.
-
---------------------------------------------------------------------------------
-
-# Icons: CC BY 4.0 License (https://creativecommons.org/licenses/by/4.0/)
-
-The Font Awesome Free download is licensed under a Creative Commons
-Attribution 4.0 International License and applies to all icons packaged
-as SVG and JS file types.
-
---------------------------------------------------------------------------------
-
-# Fonts: SIL OFL 1.1 License
-
-In the Font Awesome Free download, the SIL OFL license applies to all icons
-packaged as web and desktop font files.
-
-Copyright (c) 2023 Fonticons, Inc. (https://fontawesome.com)
-with Reserved Font Name: "Font Awesome".
-
-This Font Software is licensed under the SIL Open Font License, Version 1.1.
-This license is copied below, and is also available with a FAQ at:
-http://scripts.sil.org/OFL
-
-SIL OPEN FONT LICENSE
-Version 1.1 - 26 February 2007
-
-PREAMBLE
-The goals of the Open Font License (OFL) are to stimulate worldwide
-development of collaborative font projects, to support the font creation
-efforts of academic and linguistic communities, and to provide a free and
-open framework in which fonts may be shared and improved in partnership
-with others.
-
-The OFL allows the licensed fonts to be used, studied, modified and
-redistributed freely as long as they are not sold by themselves. The
-fonts, including any derivative works, can be bundled, embedded,
-redistributed and/or sold with any software provided that any reserved
-names are not used by derivative works. The fonts and derivatives,
-however, cannot be released under any other type of license. The
-requirement for fonts to remain under this license does not apply
-to any document created using the fonts or their derivatives.
-
-DEFINITIONS
-"Font Software" refers to the set of files released by the Copyright
-Holder(s) under this license and clearly marked as such. This may
-include source files, build scripts and documentation.
-
-"Reserved Font Name" refers to any names specified as such after the
-copyright statement(s).
-
-"Original Version" refers to the collection of Font Software components as
-distributed by the Copyright Holder(s).
-
-"Modified Version" refers to any derivative made by adding to, deleting,
-or substituting — in part or in whole — any of the components of the
-Original Version, by changing formats or by porting the Font Software to a
-new environment.
-
-"Author" refers to any designer, engineer, programmer, technical
-writer or other person who contributed to the Font Software.
-
-PERMISSION & CONDITIONS
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of the Font Software, to use, study, copy, merge, embed, modify,
-redistribute, and sell modified and unmodified copies of the Font
-Software, subject to the following conditions:
-
-1) Neither the Font Software nor any of its individual components,
-in Original or Modified Versions, may be sold by itself.
-
-2) Original or Modified Versions of the Font Software may be bundled,
-redistributed and/or sold with any software, provided that each copy
-contains the above copyright notice and this license. These can be
-included either as stand-alone text files, human-readable headers or
-in the appropriate machine-readable metadata fields within text or
-binary files as long as those fields can be easily viewed by the user.
-
-3) No Modified Version of the Font Software may use the Reserved Font
-Name(s) unless explicit written permission is granted by the corresponding
-Copyright Holder. This restriction only applies to the primary font name as
-presented to the users.
-
-4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
-Software shall not be used to promote, endorse or advertise any
-Modified Version, except to acknowledge the contribution(s) of the
-Copyright Holder(s) and the Author(s) or with their explicit written
-permission.
-
-5) The Font Software, modified or unmodified, in part or in whole,
-must be distributed entirely under this license, and must not be
-distributed under any other license. The requirement for fonts to
-remain under this license does not apply to any document created
-using the Font Software.
-
-TERMINATION
-This license becomes null and void if any of the above conditions are
-not met.
-
-DISCLAIMER
-THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
-OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
-COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
-INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
-DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
-OTHER DEALINGS IN THE FONT SOFTWARE.
-
---------------------------------------------------------------------------------
-
-# Code: MIT License (https://opensource.org/licenses/MIT)
-
-In the Font Awesome Free download, the MIT license applies to all non-font and
-non-icon files.
-
-Copyright 2023 Fonticons, Inc.
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of
-this software and associated documentation files (the "Software"), to deal in the
-Software without restriction, including without limitation the rights to use, copy,
-modify, merge, publish, distribute, sublicense, and/or sell copies of the Software,
-and to permit persons to whom the Software is furnished to do so, subject to the
-following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
-INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
-PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
-HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
-SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-
---------------------------------------------------------------------------------
-
-# Attribution
-
-Attribution is required by MIT, SIL OFL, and CC BY licenses. Downloaded Font
-Awesome Free files already contain embedded comments with sufficient
-attribution, so you shouldn't need to do anything additional when using these
-files normally.
-
-We've kept attribution comments terse, so we ask that you do not actively work
-to remove them from files, especially code. They're a great way for folks to
-learn about Font Awesome.
-
---------------------------------------------------------------------------------
-
-# Brand Icons
-
-All brand icons are trademarks of their respective owners. The use of these
-trademarks does not indicate endorsement of the trademark holder by Font
-Awesome, nor vice versa. **Please do not use brand logos for any purpose except
-to represent the company, product, or service to which they refer.**

assets/icons/square-phone-solid.svg

@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Pro 6.3.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2023 Fonticons, Inc. --><path d="M64 32C28.7 32 0 60.7 0 96V416c0 35.3 28.7 64 64 64H384c35.3 0 64-28.7 64-64V96c0-35.3-28.7-64-64-64H64zm90.7 96.7c9.7-2.6 19.9 2.3 23.7 11.6l20 48c3.4 8.2 1 17.6-5.8 23.2L168 231.7c16.6 35.2 45.1 63.7 80.3 80.3l20.2-24.7c5.6-6.8 15-9.2 23.2-5.8l48 20c9.3 3.9 14.2 14 11.6 23.7l-12 44C336.9 378 329 384 320 384C196.3 384 96 283.7 96 160c0-9 6-16.9 14.7-19.3l44-12z"/></svg>

docs/manual.typ

@@ -0,0 +1,9 @@
+#import "../lib.typ"
+#import "@preview/tidy:0.4.1"
+
+#let docs = tidy.parse-module(
+  read("../lib.typ"),
+  name: "Modern CV",
+  scope: (resume: lib),
+)
+#tidy.show-module(docs, style: tidy.styles.minimal)

docs/release-checklist.md

@@ -0,0 +1,13 @@
+# Release Checklist
+
+This document outlines the steps required to prepare a new release of `modern-cv`.
+
+Steps:
+
+1. Create a new release branch with the format `release/x.y.z`.
+2. Update the version in the `typst.toml`.
+3. Update examples in the [README.md](../README.md) to reflect the new version.
+4. Update templates to import the correct version.
+5. Do a final compilation/export check of all the templates.
+6. Ensure that tests pass.
+7. Ensure that the documentation manual builds.

lang.toml

@@ -8,6 +8,7 @@ cover-letter = "Cover Letter"
 attached = "Attached"
 curriculum-vitae = "Curriculum Vitae"
 sincerely = "Sincerely"
+letter-position-pretext = "Job Application for"
 
 [lang.de]
 resume = "Lebenslauf"
@@ -15,7 +16,8 @@ dear = "Sehr geehrte"
 cover-letter = "Anschreiben"
 attached = "Angehängt"
 curriculum-vitae = "Lebenslauf"
-sincerely = "Aufrichtig"
+sincerely = "Mit freundlichen Grüßen"
+letter-position-pretext = "Bewerbung für"
 
 [lang.gr]
 resume = "Βιογραφικό"
@@ -24,6 +26,7 @@ cover-letter = "Συνοδευτική Επιστολή"
 attached = "Συνημμένο"
 curriculum-vitae = "Βιογραφικό"
 sincerely = "Με εκτίμηση"
+letter-position-pretext = "Αίτηση εργασίας για"
 
 [lang.pt]
 resume = "Currículo"
@@ -32,6 +35,7 @@ cover-letter = "Carta de Apresentação"
 attached = "Em anexo"
 curriculum-vitae = "Currículo"
 sincerely = "Atenciosamente"
+letter-position-pretext = "Candidatura a emprego para"
 
 [lang.sp]
 resume = "Currículum"
@@ -40,3 +44,40 @@ cover-letter = "Carta de Presentación"
 attached = "Adjunto"
 curriculum-vitae = "Currículum"
 sincerely = "Sinceramente"
+letter-position-pretext = "Solicitud de empleo para"
+
+[lang.fr]
+resume = "Curriculum Vitae"
+dear = "Cher/Chère"
+cover-letter = "Lettre de motivation"
+attached = "Ci-joint"
+curriculum-vitae = "Curriculum Vitae"
+sincerely = "Sincèrement"
+letter-position-pretext = "Demande d'emploi pour"
+
+[lang.ru]
+resume = "Резюме"
+dear = "Уважаемый"
+cover-letter = "Сопроводительное письмо"
+attached = "Прилагается"
+curriculum-vitae = "Биографическая справка"
+sincerely = "Искренне"
+letter-position-pretext = "Заявление о приеме на работу"
+
+[lang.zh]
+resume = "简历"
+dear = "亲爱的"
+cover-letter = "求职信"
+attached = "附件"
+curriculum-vitae = "简历"
+sincerely = "真诚的"
+letter-position-pretext = "職位申請"
+
+[lang.it]
+resume = "Curriculum"
+dear = "Egregio"
+cover-letter = "Lettera di presentazione"
+attached = "Allegato"
+curriculum-vitae = "Curriculum Vitae"
+sincerely = "Cordiali saluti"
+letter-position-pretext = "Domanda di lavoro per"

lib.typ

@@ -1,22 +1,34 @@
-#import "@preview/fontawesome:0.1.0": *
-#import "@preview/linguify:0.4.0": *
+#import "@preview/fontawesome:0.5.0": *
+#import "@preview/linguify:0.4.1": *
 
 // const color
 #let color-darknight = rgb("#131A28")
 #let color-darkgray = rgb("#333333")
 #let color-gray = rgb("#5d5d5d")
 #let default-accent-color = rgb("#262F99")
+#let default-location-color = rgb("#333333")
 
 // const icons
 #let linkedin-icon = box(
-  fa-icon("linkedin", fa-set: "Brands", fill: color-darknight),
+  fa-icon("linkedin", fill: color-darknight),
 )
 #let github-icon = box(
-  fa-icon("github", fa-set: "Brands", fill: color-darknight),
+  fa-icon("github", fill: color-darknight),
 )
-// for some reason this icon doesn't work with fa-icon, so we use the local version
-#let phone-icon = box(image("assets/icons/square-phone-solid.svg"))
+#let twitter-icon = box(
+  fa-icon("twitter", fill: color-darknight),
+)
+#let google-scholar-icon = box(
+  fa-icon("google-scholar", fill: color-darknight),
+)
+#let orcid-icon = box(
+  fa-icon("orcid", fill: color-darknight),
+)
+#let phone-icon = box(fa-icon("square-phone", fill: color-darknight))
 #let email-icon = box(fa-icon("envelope", fill: color-darknight))
+#let birth-icon = box(fa-icon("cake", fill: color-darknight))
+#let homepage-icon = box(fa-icon("home", fill: color-darknight))
+#let website-icon = box(fa-icon("globe", fill: color-darknight))
 
 /// Helpers
 
@@ -52,6 +64,54 @@
   ]
 }
 
+#let __coverletter_footer(author, language, date, lang_data) = {
+  set text(
+    fill: gray,
+    size: 8pt,
+  )
+  __justify_align_3[
+    #smallcaps[#date]
+  ][
+    #smallcaps[
+      #if language == "zh" or language == "ja" [
+        #author.firstname#author.lastname
+      ] else [
+        #author.firstname#sym.space#author.lastname
+      ]
+      #sym.dot.c
+      #linguify("cover-letter", from: lang_data)
+    ]
+  ][
+    #context {
+      counter(page).display()
+    }
+  ]
+}
+
+#let __resume_footer(author, language, lang_data, date) = {
+  set text(
+    fill: gray,
+    size: 8pt,
+  )
+  __justify_align_3[
+    #smallcaps[#date]
+  ][
+    #smallcaps[
+      #if language == "zh" or language == "ja" [
+        #author.firstname#author.lastname
+      ] else [
+        #author.firstname#sym.space#author.lastname
+      ]
+      #sym.dot.c
+      #linguify("resume", from: lang_data)
+    ]
+  ][
+    #context {
+      counter(page).display()
+    }
+  ]
+}
+
 /// Show a link with an icon, specifically for Github projects
 /// *Example*
 /// #example(`resume.github-link("DeveloperPaul123/awesome-resume")`)
@@ -61,7 +121,7 @@
   set box(height: 11pt)
   
   align(right + horizon)[
-    #fa-icon("github", fa-set: "Brands", fill: color-darkgray) #link(
+    #fa-icon("github", fill: color-darkgray) #link(
       "https://github.com/" + github-path,
       github-path,
     )
@@ -78,7 +138,7 @@
   body
 }
 
-/// Right section of a tertiaty headers. 
+/// Right section of a tertiaty headers.
 /// - body (content): The body of the right header
 #let tertiary-right-header(body) = {
   set text(
@@ -121,9 +181,10 @@
 
 /// Resume template that is inspired by the Awesome CV Latex template by posquit0. This template can loosely be considered a port of the original Latex template.
 ///
-/// The original template: https://github.com/posquit0/Awesome-CV 
+/// The original template: https://github.com/posquit0/Awesome-CV
 ///
 /// - author (content): Structure that takes in all the author's information
+/// - profile-picture (image): The profile picture of the author. This will be cropped to a circle and should be square in nature.
 /// - date (string): The date the resume was created
 /// - accent-color (color): The accent color of the resume
 /// - colored-headers (boolean): Whether the headers should be colored or not
@@ -132,10 +193,15 @@
 /// -> none
 #let resume(
   author: (:),
+  profile-picture: image,
   date: datetime.today().display("[month repr:long] [day], [year]"),
   accent-color: default-accent-color,
   colored-headers: true,
+  show-footer: true,
   language: "en",
+  font: ("Source Sans Pro", "Source Sans 3"),
+  header-font: ("Roboto"),
+  paper-size: "a4",
   body,
 ) = {
   if type(accent-color) == "string" {
@@ -143,14 +209,17 @@
   }
   
   let lang_data = toml("lang.toml")
-  
-  set document(
-    author: author.firstname + " " + author.lastname,
-    title: "resume",
-  )
-  
+
+  show: body => context {
+    set document(
+      author: author.firstname + " " + author.lastname,
+      title: lflib._linguify("resume", lang: language, from: lang_data).ok,
+    )
+    body
+  }
+
   set text(
-    font: ("Source Sans Pro", "Source Sans 3"),
+    font: font,
     lang: language,
     size: 11pt,
     fill: color-darkgray,
@@ -158,35 +227,22 @@
   )
   
   set page(
-    paper: "a4",
+    paper: paper-size,
     margin: (left: 15mm, right: 15mm, top: 10mm, bottom: 10mm),
-    footer: [
-      #set text(
-        fill: gray,
-        size: 8pt,
-      )
-      #__justify_align_3[
-        #smallcaps[#date]
-      ][
-        #smallcaps[
-          #author.firstname
-          #author.lastname
-          #sym.dot.c
-          #linguify("resume", from: lang_data)
-        ]
-      ][
-        #counter(page).display()
-      ]
-    ],
+    footer: if show-footer [#__resume_footer(
+        author,
+        language,
+        lang_data,
+        date,
+      )] else [],
     footer-descent: 0pt,
   )
   
   // set paragraph spacing
-  show par: set block(
-    above: 0.75em,
-    below: 0.75em,
+  set par(
+    spacing: 0.75em,
+    justify: true,
   )
-  set par(justify: true)
   
   set heading(
     numbering: none,
@@ -194,24 +250,19 @@
   )
   
   show heading.where(level: 1): it => [
-    #set block(
-      above: 1em,
-      below: 1em,
-    )
     #set text(
       size: 16pt,
       weight: "regular",
     )
-    
-    #align(left)[
-      #let color = if colored-headers {
-        accent-color
-      } else {
-        color-darkgray
-      }
-      #text[#strong[#text(color)[#it.body.text]]]
-      #box(width: 1fr, line(length: 100%))
-    ]
+    #set align(left)
+    #set block(above: 1em)
+    #let color = if colored-headers {
+      accent-color
+    } else {
+      color-darkgray
+    }
+    #text[#strong[#text(color)[#it.body]]]
+    #box(width: 1fr, line(length: 100%))
   ]
   
   show heading.where(level: 2): it => {
@@ -239,10 +290,17 @@
           #set text(
             size: 32pt,
             style: "normal",
-            font: ("Roboto"),
+            font: header-font,
           )
-          #text(fill: accent-color, weight: "thin")[#author.firstname]
-          #text(weight: "bold")[#author.lastname]
+          #if language == "zh" or language == "ja" [
+            #text(
+              accent-color,
+              weight: "thin",
+            )[#author.firstname]#text(weight: "bold")[#author.lastname]
+          ] else [
+            #text(accent-color, weight: "thin")[#author.firstname]
+            #text(weight: "bold")[#author.lastname]
+          ]
         ]
       ]
     ]
@@ -266,10 +324,12 @@
   let address = {
     set text(
       size: 9pt,
-      weight: "bold",
+      weight: "regular",
     )
     align(center)[
-      #author.address
+      #if ("address" in author) [
+        #author.address
+      ]
     ]
   }
   
@@ -286,40 +346,97 @@
       )
       #block[
         #align(horizon)[
-          #if author.phone != none [
+          #if ("birth" in author) [
+            #birth-icon
+            #box[#text(author.birth)]
+            #separator
+          ]
+          #if ("phone" in author) [
             #phone-icon
             #box[#text(author.phone)]
             #separator
           ]
-          #if author.email != none [
+          #if ("email" in author) [
             #email-icon
             #box[#link("mailto:" + author.email)[#author.email]]
           ]
-          #if author.github != none [
+          #if ("homepage" in author) [
+            #separator
+            #homepage-icon
+            #box[#link(author.homepage)[#author.homepage]]
+          ]
+          #if ("github" in author) [
             #separator
             #github-icon
             #box[#link("https://github.com/" + author.github)[#author.github]]
           ]
-          #if author.linkedin != none [
+          #if ("linkedin" in author) [
             #separator
             #linkedin-icon
             #box[
               #link("https://www.linkedin.com/in/" + author.linkedin)[#author.firstname #author.lastname]
             ]
           ]
+          #if ("twitter" in author) [
+            #separator
+            #twitter-icon
+            #box[#link("https://twitter.com/" + author.twitter)[\@#author.twitter]]
+          ]
+          #if ("scholar" in author) [
+            #let fullname = str(author.firstname + " " + author.lastname)
+            #separator
+            #google-scholar-icon
+            #box[#link("https://scholar.google.com/citations?user=" + author.scholar)[#fullname]]
+          ]
+          #if ("orcid" in author) [
+            #separator
+            #orcid-icon
+            #box[#link("https://orcid.org/" + author.orcid)[#author.orcid]]
+          ]
+          #if ("website" in author) [
+            #separator
+            #website-icon
+            #box[#link(author.website)[#author.website]]
+          ]
         ]
       ]
     ]
   }
   
-  name
-  positions
-  address
-  contacts
+  if profile-picture != none {
+    grid(
+      columns: (100% - 4cm, 4cm),
+      rows: (100pt),
+      gutter: 10pt,
+      [
+        #name
+        #positions
+        #address
+        #contacts
+      ],
+      align(left + horizon)[
+        #block(
+          clip: true,
+          stroke: 0pt,
+          radius: 2cm,
+          width: 4cm,
+          height: 4cm,
+          profile-picture,
+        )
+      ],
+    )
+  } else {
+    name
+    positions
+    address
+    contacts
+  }
+
   body
+
 }
 
-/// The base item for resume entries. 
+/// The base item for resume entries.
 /// This formats the item for the resume entries. Typically your body would be a bullet list of items. Could be your responsibilities at a company or your academic achievements in an educational background section.
 /// - body (content): The body of the resume entry
 #let resume-item(body) = {
@@ -329,8 +446,14 @@
     weight: "light",
     fill: color-darknight,
   )
+  set block(
+    above: 0.75em,
+    below: 1.25em,
+  )
   set par(leading: 0.65em)
-  body
+  block(above: 0.5em)[
+    #body
+  ]
 }
 
 /// The base item for resume entries. This formats the item for the resume entries. Typically your body would be a bullet list of items. Could be your responsibilities at a company or your academic achievements in an educational background section.
@@ -338,16 +461,31 @@
 /// - location (string): The location of the resume entry
 /// - date (string): The date of the resume entry, this can be a range (e.g. "Jan 2020 - Dec 2020")
 /// - description (content): The body of the resume entry
+/// - title-link (string): The link to use for the title (can be none)
+/// - accent-color (color): Override the accent color of the resume-entry
+/// - location-color (color): Override the default color of the "location" for a resume entry.
 #let resume-entry(
   title: none,
   location: "",
   date: "",
   description: "",
+  title-link: none,
   accent-color: default-accent-color,
+  location-color: default-location-color,
 ) = {
-  pad[
-    #justified-header(title, location)
-    #secondary-justified-header(description, date)
+  let title-content
+  if type(title-link) == "string" {
+    title-content = link(title-link)[#title]
+  } else {
+    title-content = title
+  }
+  block(above: 1em, below: 0.65em)[
+    #pad[
+      #justified-header(title-content, location)
+      #if description != "" or date != "" [
+        #secondary-justified-header(description, date)
+      ]
+    ]
   ]
 }
 
@@ -403,12 +541,25 @@
 
 /// ---- Coverletter ----
 
-/// Cover letter template that is inspired by the Awesome CV Latex template by posquit0. This template can loosely be considered a port of the original Latex template. 
+#let default-closing(lang_data) = {
+  align(bottom)[
+    #text(weight: "light", style: "italic")[ #linguify(
+        "attached",
+        from: lang_data,
+      )#sym.colon #linguify("curriculum-vitae", from: lang_data)]
+  ]
+}
+
+/// Cover letter template that is inspired by the Awesome CV Latex template by posquit0. This template can loosely be considered a port of the original Latex template.
 /// This coverletter template is designed to be used with the resume template.
-/// - author (content): Structure that takes in all the author's information
+/// - author (content): Structure that takes in all the author's information. The following fields are required: firstname, lastname, positions. The following fields are used if available: email, phone, github, linkedin, orcid, address, website.
 /// - profile-picture (image): The profile picture of the author. This will be cropped to a circle and should be square in nature.
-/// - date (date): The date the cover letter was created
+/// - date (datetime): The date the cover letter was created. This will default to the current date.
 /// - accent-color (color): The accent color of the cover letter
+/// - language (string): The language of the cover letter, defaults to "en". See lang.toml for available languages
+/// - font (array): The font families of the cover letter
+/// - show-footer (boolean): Whether to show the footer or not
+/// - closing (content): The closing of the cover letter. This defaults to "Attached Curriculum Vitae". You can set this to `none` to show the default closing or remove it completely.
 /// - body (content): The body of the cover letter
 #let coverletter(
   author: (:),
@@ -416,6 +567,10 @@
   date: datetime.today().display("[month repr:long] [day], [year]"),
   accent-color: default-accent-color,
   language: "en",
+  font: ("Source Sans Pro", "Source Sans 3"),
+  show-footer: true,
+  closing: none,
+  paper-size: "a4",
   body,
 ) = {
   if type(accent-color) == "string" {
@@ -425,13 +580,20 @@
   // language data
   let lang_data = toml("lang.toml")
   
-  set document(
-    author: author.firstname + " " + author.lastname,
-    title: "cover-letter",
-  )
-  
+  if closing == none {
+    closing = default-closing(lang_data)
+  }
+
+  show: body => context {
+    set document(
+      author: author.firstname + " " + author.lastname,
+      title: lflib._linguify("cover-letter", lang: language, from: lang_data).ok,
+    )
+    body
+  }
+
   set text(
-    font: ("Source Sans Pro"),
+    font: font,
     lang: language,
     size: 11pt,
     fill: color-darkgray,
@@ -439,35 +601,22 @@
   )
   
   set page(
-    paper: "a4",
+    paper: paper-size,
     margin: (left: 15mm, right: 15mm, top: 10mm, bottom: 10mm),
-    footer: [
-      #set text(
-        fill: gray,
-        size: 8pt,
-      )
-      #__justify_align_3[
-        #smallcaps[#date]
-      ][
-        #smallcaps[
-          #author.firstname
-          #author.lastname
-          #sym.dot.c
-          #linguify("cover-letter", from: lang_data)
-        ]
-      ][
-        #counter(page).display()
-      ]
-    ],
+    footer: if show-footer [#__coverletter_footer(
+        author,
+        language,
+        date,
+        lang_data,
+      )] else [],
     footer-descent: 0pt,
   )
   
   // set paragraph spacing
-  show par: set block(
-    above: 0.75em,
-    below: 0.75em,
+  set par(
+    spacing: 0.75em,
+    justify: true,
   )
-  set par(justify: true)
   
   set heading(
     numbering: none,
@@ -485,7 +634,7 @@
     )
     
     #align(left)[
-      #text[#strong[#text(accent-color)[#it.body.text]]]
+      #text[#strong[#text(accent-color)[#it.body]]]
       #box(width: 1fr, line(length: 100%))
     ]
   ]
@@ -499,8 +648,16 @@
             style: "normal",
             font: ("Roboto"),
           )
-          #text(accent-color, weight: "thin")[#author.firstname]
-          #text(weight: "bold")[#author.lastname]
+          #if language == "zh" or language == "ja" [
+            #text(
+              accent-color,
+              weight: "thin",
+            )[#author.firstname]#text(weight: "bold")[#author.lastname]
+          ] else [
+            #text(accent-color, weight: "thin")[#author.firstname]
+            #text(weight: "bold")[#author.lastname]
+          ]
+          
         ]
       ]
     ]
@@ -528,50 +685,65 @@
       fill: color-gray,
     )
     align(right)[
-      #author.address
+      #if ("address" in author) [
+        #author.address
+      ]
     ]
   }
   
   let contacts = {
     set box(height: 9pt)
     
-    let separator = [#box(sym.bar.v)]
-    
+    let separator = [  #box(sym.bar.v)  ]
+    let author_list = ()
+
+    if ("phone" in author) {
+      author_list.push[
+        #phone-icon
+        #box[#text(author.phone)]
+      ]
+    }
+    if ("email" in author) {
+      author_list.push[
+        #email-icon
+        #box[#link("mailto:" + author.email)[#author.email]]
+      ]
+    }
+    if ("github" in author) {
+      author_list.push[
+        #github-icon
+        #box[#link("https://github.com/" + author.github)[#author.github]]
+      ]
+    }
+    if ("linkedin" in author) {
+      author_list.push[
+        #linkedin-icon
+        #box[
+          #link("https://www.linkedin.com/in/" + author.linkedin)[#author.firstname #author.lastname]
+        ]
+      ]
+    }
+    if ("orcid" in author) {
+      author_list.push[
+        #orcid-icon
+        #box[#link("https://orcid.org/" + author.orcid)[#author.orcid]]
+      ]
+    }
+    if ("website" in author) {
+      author_list.push[
+        #website-icon
+        #box[#link(author.website)[#author.website]]
+      ]
+    }
+
+
     align(right)[
       #set text(
         size: 8pt,
         weight: "light",
         style: "normal",
       )
-      #block[
-        #align(horizon)[
-          #stack(
-            dir: ltr,
-            spacing: 0.5em,
-            if author.phone != none [
-              #phone-icon
-              #box[#text(author.phone)]
-              #separator
-            ],
-            if author.email != none [
-              #email-icon
-              #box[#link("mailto:" + author.email)[#author.email]]
-            ],
-            if author.github != none [
-              #separator
-              #github-icon
-              #box[#link("https://github.com/" + author.github)[#author.github]]
-            ],
-            if author.linkedin != none [
-              #separator
-              #linkedin-icon
-              #box[
-                #link("https://www.linkedin.com/in/" + author.linkedin)[#author.firstname #author.lastname]
-              ]
-            ],
-          )
-        ]
-      ]
+      #author_list.join(separator)
     ]
   }
   
@@ -598,15 +770,14 @@
     )
   }
   
-  let letter-conclusion = {
+  let signature = {
     align(bottom)[
       #pad(bottom: 2em)[
-        #text(weight: "light")[#linguify("sincerely", from: lang_data)#sym.comma] \
-        #text(weight: "bold")[#author.firstname #author.lastname] \ \
-        #text(weight: "light", style: "italic")[ #linguify(
-            "attached",
+        #text(weight: "light")[#linguify(
+            "sincerely",
             from: lang_data,
-          )#sym.colon #linguify("curriculum-vitae", from: lang_data)]
+          )#if language != "de" [#sym.comma]] \
+        #text(weight: "bold")[#author.firstname #author.lastname] \ \
       ]
     ]
   }
@@ -615,7 +786,8 @@
   letter-heading
   body
   linebreak()
-  letter-conclusion
+  signature
+  closing
 }
 
 /// Cover letter heading that takes in the information for the hiring company and formats it properly.
@@ -646,16 +818,22 @@
 /// Letter heading for a given job position and addressee.
 /// - job-position (string): The job position you are applying for
 /// - addressee (string): The person you are addressing the letter to
-#let letter-heading(job-position: "", addressee: "") = {
+/// - dear (string): optional field for redefining the "dear" variable
+#let letter-heading(job-position: "", addressee: "", dear: "") = {
   let lang_data = toml("lang.toml")
   
   // TODO: Make this adaptable to content
   underline(evade: false, stroke: 0.5pt, offset: 0.3em)[
-    #text(weight: "bold", size: 12pt)[Job Application for #job-position]
+    #text(weight: "bold", size: 12pt)[#linguify("letter-position-pretext", from: lang_data) #job-position]
   ]
   pad(top: 1em, bottom: 1em)[
     #text(weight: "light", fill: color-gray)[
-      #linguify("dear", from: lang_data) #addressee,
+      #if dear == "" [
+        #linguify("dear", from: lang_data)
+      ] else [
+        #dear
+      ]
+      #addressee,
     ]
   ]
 }

modern-cv-docs.typ

@@ -1,9 +0,0 @@
-#import "lib.typ"
-#import "@preview/tidy:0.2.0"
-
-#let docs = tidy.parse-module(
-  read("lib.typ"),
-  name: "Modern CV",
-  scope: (resume: lib),
-)
-#tidy.show-module(docs)

scripts/format

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -eu
+
+find . -iname "*.typ" | xargs typstyle -i

scripts/format_typst.ps1

@@ -1,5 +0,0 @@
-# requires typstyle to be installed
-# cargo install typstyle
-
-# get all *.typ files and format them
-Get-ChildItem -Path $PSScriptRoot/../*.typ -Recurse | ForEach-Object { typstyle -i $_.FullName }

scripts/install-fontawesome

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+set -eu
+
+wget -O ~/fontawesome.zip https://use.fontawesome.com/releases/v6.6.0/fontawesome-free-6.6.0-desktop.zip
+mkdir -p ~/fontawesome-fonts
+unzip ~/fontawesome.zip -d ~/fontawesome-fonts
+mkdir -p ~/.fonts
+find ~/fontawesome-fonts -type f -name "*.otf" -exec cp {} ~/.fonts \;
+rm ~/fontawesome.zip
+rm -rf ~/fontawesome-fonts
+fc-cache -f -v

scripts/install-source-sans

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+set -eu
+
+wget -O ~/source-sans.zip https://github.com/adobe-fonts/source-sans/releases/download/3.052R/OTF-source-sans-3.052R.zip
+mkdir -p ~/source-sans-fonts
+unzip ~/source-sans.zip -d ~/source-sans-fonts
+mkdir -p ~/.fonts
+find ~/source-sans-fonts -type f -name "*.otf" -exec cp {} ~/.fonts \;
+rm ~/source-sans.zip
+rm -rf ~/source-sans-fonts
+fc-cache -f -v

scripts/install_package_locally.ps1

@@ -1,10 +0,0 @@
-# requires the PSToml cmdlet to be installed
-# https://github.com/jborean93/PSToml?tab=readme-ov-file
-# Install-Module -Name PSToml -Scope AllUsers
-
-$typst_toml = ConvertFrom-Toml (Get-Content "$PSScriptRoot/../typst.toml" -Raw)
-Write-Host 'Package version: ' $typst_toml.package.version
-$Source = "$PSScriptRoot/../*"
-$Destination = "$env:LOCALAPPDATA/typst/packages/local/modern-cv/$($typst_toml.package.version)"
-New-Item -ItemType Directory -Path $Destination -Force
-Copy-Item -Path $Source -Destination $Destination -Recurse -Force

scripts/package

@@ -0,0 +1,86 @@
+#!/usr/bin/env bash
+set -eu
+
+# adapted from https://github.com/johannes-wolf/cetz/blob/35c0868378cea5ad323cc0d9c2f76de8ed9ba5bd/scripts/package
+# licensed under Apache License 2.0
+
+. "$(dirname "${BASH_SOURCE[0]}")/setup"
+
+if (( $# < 1 )) || [[ "${1:-}" == "help" ]]; then
+  echo "package TARGET"
+  echo ""
+  echo "Packages all relevant files into a directory named '<name>/<version>'"
+  echo "at TARGET. If TARGET is set to @local or @preview, the local Typst package"
+  echo "directory will be used so that the package gets installed for local use."
+  echo "The name and version are read from 'typst.toml' in the project root."
+  echo ""
+  echo "Local package prefix: $DATA_DIR/typst/package/local"
+  echo "Local preview package prefix: $DATA_DIR/typst/package/preview"
+  exit 1
+fi
+
+TARGET="$(resolve-target "${1:?Missing target path, @local or @preview}")"
+echo "Install dir: $TARGET"
+
+# ignore rules
+readarray -t ignores < <(grep -v '^#' .typstignore | grep '[^[:blank:]]')
+
+# recursively print all files that are not excluded via .typstignore
+function enumerate {
+	local root="$1"
+	if [[ -f "$root" ]]; then
+		echo "$root"
+	else
+		local files
+		readarray -t files < <(find "$root" \
+      -mindepth 1 -maxdepth 1 \
+      -not -name .git \
+      -not -name .typstignore)
+		# declare -p files >&2
+
+		local f
+		for f in "${files[@]}"; do
+			local include
+			include=1
+
+			local ignore
+			for ignore in "${ignores[@]}"; do
+				if [[ "$ignore" =~ ^! ]]; then
+					ignore="${ignore:1}"
+					if [[ "$f" == ./$ignore ]]; then
+						# echo "\"$f\" matched \"!$ignore\"" >&2
+						include=1
+					fi
+				elif [[ "$f" == ./$ignore ]]; then
+					# echo "\"$f\" matched \"$ignore\"" >&2
+					include=0
+				fi
+			done
+			if [[ "$include" == 1 ]]; then
+				enumerate "$f"
+			fi
+		done
+	fi
+}
+
+# List of all files that get packaged
+readarray -t files < <(enumerate ".")
+# declare -p files >&2
+
+TMP="$(mktemp -d)"
+
+for f in "${files[@]}"; do
+  mkdir -p "$TMP/$(dirname "$f")" 2>/dev/null
+  cp -r "$ROOT/$f" "$TMP/$f"
+done
+
+TARGET="${TARGET:?}/${PKG_PREFIX:?}/${VERSION:?}"
+echo "Packaged to: $TARGET"
+if rm -r "${TARGET:?}" 2>/dev/null; then
+  echo "Overwriting existing version."
+fi
+mkdir -p "$TARGET"
+
+# include hidden files by setting dotglob
+shopt -s dotglob
+mv "$TMP"/* "$TARGET"

scripts/setup

@@ -0,0 +1,37 @@
+# source this script to prepare some common environment variables
+
+# adapted from https://github.com/johannes-wolf/cetz/blob/35c0868378cea5ad323cc0d9c2f76de8ed9ba5bd/scripts/package
+# licensed under Apache License 2.0
+
+# Local package directories per platform
+if [[ "$OSTYPE" == "linux"* ]]; then
+  DATA_DIR="${XDG_DATA_HOME:-$HOME/.local/share}"
+elif [[ "$OSTYPE" == "darwin"* ]]; then
+  DATA_DIR="$HOME/Library/Application Support"
+else
+  DATA_DIR="${APPDATA}"
+fi
+
+function read-toml() {
+  local file="$1"
+  local key="$2"
+  # Read a key value pair in the format: <key> = "<value>"
+  # stripping surrounding quotes.
+  perl -lne "print \"\$1\" if /^${key}\\s*=\\s*\"(.*)\"/" < "$file"
+}
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")"; pwd -P)/.." # macOS has no realpath
+PKG_PREFIX="$(read-toml "$ROOT/typst.toml" "name")"
+VERSION="$(read-toml "$ROOT/typst.toml" "version")"
+
+function resolve-target() {
+  local target="$1"
+
+	if [[ "$target" == "@local" ]]; then
+		echo "${DATA_DIR}/typst/packages/local"
+	elif [[ "$target" == "@preview" ]]; then
+		echo "${DATA_DIR}/typst/packages/preview"
+	else
+		echo "$target"
+	fi
+}

scripts/uninstall

@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+set -eu
+
+# adapted from https://github.com/johannes-wolf/cetz/blob/35c0868378cea5ad323cc0d9c2f76de8ed9ba5bd/scripts/package
+# licensed under Apache License 2.0
+
+. "$(dirname "${BASH_SOURCE[0]}")/setup"
+
+if (( $# < 1 )) || [[ "${1:-}" == "help" ]]; then
+  echo "uninstall TARGET"
+  echo ""
+  echo "Removes the package installed into a directory named '<name>/<version>'"
+  echo "at TARGET. If TARGET is set to @local or @preview, the local Typst package"
+  echo "directory will be used so that the package gets installed for local use."
+  echo "The name and version are read from 'typst.toml' in the project root."
+  echo ""
+  echo "Local package prefix: $DATA_DIR/typst/package/local"
+  echo "Local preview package prefix: $DATA_DIR/typst/package/preview"
+  exit 1
+fi
+
+TARGET="$(resolve-target "${1:?Missing target path, @local or @preview}")"
+echo "Install dir: $TARGET"
+
+TARGET="${TARGET:?}/${PKG_PREFIX:?}/${VERSION:?}"
+echo "Package to uninstall: $TARGET"
+if [[ ! -e "${TARGET:?}" ]]; then
+  echo "Package was not found."
+elif rm -r "${TARGET:?}" 2>/dev/null; then
+  echo "Successfully removed."
+else
+  echo "Removal failed."
+fi

template/coverletter.typ

@@ -1,21 +1,32 @@
-#import "@preview/modern-cv:0.3.0": *
+#import "@preview/modern-cv:0.8.0": *
 
 #show: coverletter.with(
   author: (
     firstname: "John",
     lastname: "Smith",
     email: "js@gmail.com",
+    homepage: "https://example.com",
     phone: "(+1) 111-111-1111",
     github: "DeveloperPaul123",
     linkedin: "John Smith",
     address: "111 Example St. Apt. 111, Example City, EX 11111",
+    website: "https://www.github.com/DeveloperPaul123",
     positions: (
       "Software Engineer",
       "Full Stack Developer",
     ),
   ),
   profile-picture: image("./profile.png"),
+  // change this to match the language available in 'lang.toml'
   language: "en",
+  font: "Times New Roman",
+  // Remove the following line to show the footer
+  // Or set the value to `true`
+  show-footer: false,
+  // set this to `none` to show the default or remove it completely
+  closing: [],
+  // see typst "page" documentation for more options
+  paper-size: "us-gov-legal"
 )
 
 #hiring-entity-info(entity-info: (

template/coverletter2.typ

@@ -1,10 +1,11 @@
-#import "@preview/modern-cv:0.3.0": *
+#import "@preview/modern-cv:0.8.0": *
 
 #show: coverletter.with(
   author: (
     firstname: "John",
     lastname: "Smith",
     email: "js@gmail.com",
+    homepage: "https://example.com",
     phone: "(+1) 111-111-1111",
     github: "DeveloperPaul123",
     linkedin: "John Smith",
@@ -15,7 +16,7 @@
     ),
   ),
   profile-picture: none,
-  language: "en",
+  language: "sp",
 )
 
 #hiring-entity-info(entity-info: (

template/resume.typ

@@ -1,12 +1,17 @@
-#import "@preview/modern-cv:0.3.0": *
+#import "@preview/modern-cv:0.8.0": *
 
 #show: resume.with(
   author: (
     firstname: "John",
     lastname: "Smith",
     email: "js@example.com",
+    homepage: "https://example.com",
     phone: "(+1) 111-111-1111",
     github: "DeveloperPaul123",
+    twitter: "typstapp",
+    scholar: "",
+    orcid: "0000-0000-0000-000X",
+    birth: "January 1, 1990",
     linkedin: "Example",
     address: "111 Example St. Example City, EX 11111",
     positions: (
@@ -15,9 +20,12 @@
       "Developer",
     ),
   ),
+  profile-picture: none,
   date: datetime.today().display(),
   language: "en",
   colored-headers: true,
+  show-footer: false,
+  paper-size: "us-letter",
 )
 
 = Experience
@@ -27,6 +35,7 @@
   location: "Example City, EX",
   date: "2019 - Present",
   description: "Example, Inc.",
+  title-link: "https://github.com/DeveloperPaul123",
 )
 
 #resume-item[
@@ -42,6 +51,16 @@
   description: "Previous Company, Inc.",
 )
 
+#resume-item[
+  // content doesn't have to be bullet points
+  #lorem(72)
+]
+
+#resume-entry(
+  title: "Intern",
+  location: "Example City, EX",
+)
+
 #resume-item[
   - #lorem(20)
   - #lorem(15)

tests/resume/test.typ

@@ -0,0 +1,95 @@
+#import "@local/modern-cv:0.8.0": *
+
+// setup the document like we do for the resume
+#let font = ("Source Sans Pro", "Source Sans 3")
+#set text(
+  font: font,
+  size: 11pt,
+  fill: color-darkgray,
+  fallback: true,
+)
+
+#set page(
+  paper: "a4",
+  margin: (left: 15mm, right: 15mm, top: 10mm, bottom: 10mm),
+  footer: [],
+  footer-descent: 0pt,
+)
+
+// set paragraph spacing
+#set par(spacing: 0.75em, justify: true)
+
+#set heading(
+  numbering: none,
+  outlined: false,
+)
+
+#show heading.where(level: 1): it => [
+
+  #set block(
+    above: 1em,
+    below: 1em,
+  )
+  #set text(
+    size: 16pt,
+    weight: "regular",
+  )
+
+  #align(left)[
+    #let color = if colored-headers {
+      accent-color
+    } else {
+      color-darkgray
+    }
+    #text[#strong[#text(color)[#it.body.text]]]
+    #box(width: 1fr, line(length: 100%))
+  ]
+
+]
+
+#show heading.where(level: 2): it => {
+  set text(
+    color-darkgray,
+    size: 12pt,
+    style: "normal",
+    weight: "bold",
+  )
+  it.body
+}
+
+#show heading.where(level: 3): it => {
+  set text(
+    size: 10pt,
+    weight: "regular",
+  )
+  smallcaps[#it.body]
+}
+
+// test the resume functions
+
+#resume-item("Education")
+
+#resume-entry(
+  title: "BSc Computer Science",
+  location: "Example City",
+  date: "2019 - 2022",
+  description: "Achieved acaademic honors and awards.",
+)
+
+// resume-entry also support omitting the date and description
+#resume-entry(
+  title: "Title",
+  location: "Location",
+)
+
+#resume-certification(
+  "Certified Scrum Master (CSM)",
+  "Jan 2022",
+)
+
+#resume-skill-item(
+  "Programming",
+  (strong["C++"], "Python", "Java"),
+)
+
+#resume-gpa("3.5", "4.0")

tests/utilities/test.typ

@@ -0,0 +1,88 @@
+#import "@local/modern-cv:0.8.0": *
+
+// setup the document like we do for the resume
+#let font = ("Source Sans Pro", "Source Sans 3")
+#set text(
+  font: font,
+  size: 11pt,
+  fill: color-darkgray,
+  fallback: true,
+)
+
+#set page(
+  paper: "a4",
+  margin: (left: 15mm, right: 15mm, top: 10mm, bottom: 10mm),
+  footer: [],
+  footer-descent: 0pt,
+)
+
+// set paragraph spacing
+#set par(spacing: 0.75em, justify: true)
+
+#set heading(
+  numbering: none,
+  outlined: false,
+)
+
+#show heading.where(level: 1): it => [
+
+  #set block(
+    above: 1em,
+    below: 1em,
+  )
+  #set text(
+    size: 16pt,
+    weight: "regular",
+  )
+
+  #align(left)[
+    #let color = if colored-headers {
+      accent-color
+    } else {
+      color-darkgray
+    }
+    #text[#strong[#text(color)[#it.body.text]]]
+    #box(width: 1fr, line(length: 100%))
+  ]
+
+]
+
+#show heading.where(level: 2): it => {
+  set text(
+    color-darkgray,
+    size: 12pt,
+    style: "normal",
+    weight: "bold",
+  )
+  it.body
+}
+
+#show heading.where(level: 3): it => {
+  set text(
+    size: 10pt,
+    weight: "regular",
+  )
+  smallcaps[#it.body]
+}
+
+#justified-header("Modern CV", "A modern curriculum vitae template")
+
+#secondary-justified-header("Created by", "DeveloperPaul123")
+
+#github-link("DeveloperPaul123/modern-cv")
+#linkedin-icon
+#github-icon
+#twitter-icon
+#google-scholar-icon
+#orcid-icon
+#phone-icon
+#email-icon
+#birth-icon
+#homepage-icon
+#website-icon
+
+#square(size: 1em, fill: color-darkgray)
+#square(size: 1em, fill: color-darknight)
+#square(size: 1em, fill: color-gray)
+#square(size: 1em, fill: default-accent-color)
+#square(size: 1em, fill: default-location-color)

typst.toml

@@ -1,7 +1,7 @@
 [package]
 name = "modern-cv"
-version = "0.3.0"
-compiler = "0.11.0"
+version = "0.8.0"
+compiler = "0.12.0"
 entrypoint = "lib.typ"
 authors = ["Paul Tsouchlos <https://github.com/DeveloperPaul123>"]
 license = "MIT"
@@ -10,7 +10,6 @@ keywords = ["CV", "Curriculum Vitae", "Resume", "Minimalistic", "Professional",
 categories = ["cv"]
 disciplines = []
 exclude = ["resume-documentation*", "scripts*", "assets/images/*"]
-homepage = "https://github.com/DeveloperPaul123/modern-cv"
 repository = "https://github.com/DeveloperPaul123/modern-cv"
 
 [template]