GithubHelp home page GithubHelp logo

euvaz / texcv Goto Github PK

View Code? Open in Web Editor NEW
2.0 2.0 0.0 167 KB

Templatable resume and cover letter generator utilizing SOPS Age encryption and CI/CD via GitHub Actions.

License: GNU General Public License v3.0

Shell 100.00%
coverletter latex resume template github-actions

texcv's Introduction

TeXCV

I developed a specialized solution for version-controlling my resume, aiming to generate a unique version for each job application using a customizable template without the need to manually create a new file for each implementation. Furthermore, I sought to automate the process of delivering these templates and add linting features to ensure consistency and high-quality output.

To achieve this, I created a solution that enables the creation of specific LaTeX templates that can be customized using LaTeX macros. I developed a utility, gen.sh, that performs effective substitution of these macros.

To ensure quality and consistency in the resume generation process, I utilized the powerful CI/CD capabilities of GitHub Actions. This allows for automatic linting of new pull requests and the automatic compilation and delivery of a new Artifact.tar.gz to my self-hosted Nextcloud instance upon pushes to the main branch.

Overview

๐Ÿ“‚ Repository structure

def         # TeX files which define base macros
doc         # TeX templates
fonts       # Font directory
out/        # Output directory
โ”œโ”€โ”€ merge   # Merged TeX files, source files for PDFs
โ””โ”€โ”€ pdf     # PDF output
pre         # TeX files which defined unique macros

Usage

This project can be utilized in two ways:

  1. Automation: GitHub Actions
  2. Manual: Executing the script and compiling the PDF(s)

Automation

Automation will require the following action repository secrets:

Name Description Example
AGE_SECRET_KEY Age private key for SOPS decryption of macros AGE-SECRET-KEY-...
AWS_ACCESS_KEY_ID AWS Access Key ID abcdef132456
AWS_SECRET_ACCESS_KEY AWS Secret Access Key abcdef123456
AWS_S3_ENDPOINT AWS S3 Endpoint http(s)://s3.domain.tld:9000

Manual

Manually compiling resume PDFs can be done by first generating all merge files via gen.sh:

$ ./gen.sh
[INFO] MERGING: DOCUMENT=./doc/Resume.tex MACRO=./pre/Amazon.sops.yaml MERGE=./out/merge/Amazon-Resume.tex
[INFO] MERGING: DOCUMENT=./doc/Resume.tex MACRO=./pre/Google.sops.yaml MERGE=./out/merge/Google-Resume.tex
[INFO] MERGING: DOCUMENT=./doc/Resume.tex MACRO=./pre/Microsoft.sops.yaml MERGE=./out/merge/Microsoft-Resume.tex

Then compiling all merge files located in ./out/merge/ via xelatex:

$ xelatex -output-directory ./out/pdf/ ./out/merge/*.tex

Optionally, an individual PDF can also be generated:

$ xelatex -output-directory ./out/pdf/ ./out/merge/Google-Resume.tex

texcv's People

Contributors

euvaz avatar renovate[bot] avatar

Stargazers

 avatar  avatar

Watchers

 avatar  avatar

texcv's Issues

Renovate Dashboard

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Repository problems

These problems occurred while renovating this repository. View logs.

  • WARN: Found renovate config warnings

Open

These updates have all been created already. Click a checkbox below to force a retry/rebase of any.

Detected dependencies

github-actions
.github/actions/lint/action.yaml
  • oxsecurity/megalinter v7.13.0@bacb5f8674e3730b904ca4d20c8bd477bc51b1a7
.github/actions/upload/action.yaml
  • xu-cheng/latex-action v3@809f138f734cff030fab8eb42fd7a61a9bae94de
.github/workflows/on-merge.yaml
  • actions/checkout v4@692973e3d937129bcbf40652eb9f2f61becf3332
  • actions/checkout v4@692973e3d937129bcbf40652eb9f2f61becf3332
.github/workflows/on-pr.yaml
  • actions/checkout v4@692973e3d937129bcbf40652eb9f2f61becf3332

  • Check this box to trigger a request for Renovate to run again on this repository

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.