Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sinaatalay/rendercv
LaTeX CV generator from a YAML/JSON input file.
https://github.com/sinaatalay/rendercv
cv cv-generator jinja2 latex latex-cv latex-cv-template latex-resume latex-resume-template python resume resume-generator
Last synced: about 1 month ago
JSON representation
LaTeX CV generator from a YAML/JSON input file.
- Host: GitHub
- URL: https://github.com/sinaatalay/rendercv
- Owner: sinaatalay
- License: mit
- Created: 2023-06-11T13:58:25.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-04-14T23:52:01.000Z (8 months ago)
- Last Synced: 2024-04-15T10:12:03.413Z (8 months ago)
- Topics: cv, cv-generator, jinja2, latex, latex-cv, latex-cv-template, latex-resume, latex-resume-template, python, resume, resume-generator
- Language: Python
- Homepage: https://sinaatalay.github.io/rendercv/
- Size: 122 MB
- Stars: 408
- Watchers: 5
- Forks: 26
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
RenderCV
*The engine of the [RenderCV App](https://rendercv.com)*
[](https://github.com/sinaatalay/rendercv/actions/workflows/test.yaml)
[](https://coverage-badge.samuelcolvin.workers.dev/redirect/sinaatalay/rendercv)
[)](https://docs.rendercv.com)
[)](https://pypi.python.org/pypi/rendercv)
[)](https://pypistats.org/packages/rendercv)
RenderCV allows you to create a high-quality CV as a PDF from a YAML input file. It supports Markdown syntax and gives you complete control over the $\LaTeX$ code.
The primary motivation behind RenderCV is to provide a concrete framework that allows:
- Version controlling a CV's content and design separately and in an organized manner.
- Building an automated pipeline that updates the final output (PDF, $\LaTeX$, Markdown, HTML, and PNGs) whenever the content is modified.
- Making the CV's design uniform and nicely structured without room for human errors.
RenderCV offers built-in $\LaTeX$ and Markdown templates ready to produce high-quality CVs. However, the templates are entirely arbitrary and can easily be updated to leverage RenderCV's capabilities with custom CV themes.
RenderCV takes a YAML file that looks like this:
```yaml
cv:
name: John Doe
location: Your Location
email: [email protected]
sections:
this_is_a_section_title:
- This is a type of entry, TextEntry—just a plain string.
- You may have as many entries as you want under a section.
- RenderCV offers a variety of entry types such as TextEntry,
BulletEntry, EducationEntry, ExperienceEntry, NormalEntry,
OneLineEntry, PublicationEntry.
- Each entry type has its own set of attributes and different
looks.
my_education_section:
- institution: Boğaziçi University
area: Mechanical Engineering
degree: BS
start_date: 2024-09
end_date: 2029-05
highlights:
- 'GPA: 3.9/4.0 ([Transcript](https://example.com))'
- '**Coursework:** Structural Analysis, Thermodynamics,
Heat Transfer'
experience:
...
```
Then, it produces one of these PDFs with its corresponding $\LaTeX$ code, Markdown file, HTML file, and images as PNGs. Each of these is an example of one of 4 built-in themes of RenderCV. Click on the images below to preview PDF files.
| [](https://github.com/sinaatalay/rendercv/blob/main/examples/John_Doe_ClassicTheme_CV.pdf) | [](https://github.com/sinaatalay/rendercv/blob/main/examples/John_Doe_Sb2novTheme_CV.pdf) |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [](https://github.com/sinaatalay/rendercv/blob/main/examples/John_Doe_ModerncvTheme_CV.pdf) | [](https://github.com/sinaatalay/rendercv/blob/main/examples/John_Doe_EngineeringresumesTheme_CV.pdf) |
The contents of the HTML file can be pasted into Grammarly or any word processor for spelling and grammar checking.
It also validates the input file. If there are any problems, it tells users where the problems are and how they can fix them.
RenderCV comes with a JSON Schema so that the YAML input file can be filled out interactively.
## Quick Start Guide
Either use the [RenderCV App](https://rendercv.com), [`rendercv-pipeline`](https://github.com/sinaatalay/rendercv-pipeline), or follow the steps below.
1. Install [Python](https://www.python.org/downloads/) (3.10 or newer).
2. Run the command below in a terminal to install RenderCV.
```bash
pip install rendercv
```
3. Run the command below to generate starting input files.
```bash
rendercv new "Full Name"
```
4. Edit the contents of `Full_Name_CV.yaml` in your favorite editor (*tip: use an editor that supports JSON Schemas*).
5. Run the command below to generate your CV.
```bash
rendercv render Full_Name_CV.yaml
```
[Here](https://docs.rendercv.com/user_guide/), you can find a comprehensive user guide that covers the YAML input file structure and command-line interface (CLI) in greater detail.
## Motivation
Writing the content of a CV and designing a CV are separate issues that should be treated separately. RenderCV attempts to provide this separation. This approach encourages users to concentrate on the content without getting distracted by the appearance of their CV and vice versa.
RenderCV also provides a set of utilities that automate most of the manual work involved in the CV updating process. After updating a single sentence or date in the YAML input file written in pure English, RenderCV will:
- Re-create your $\LaTeX$ file,
- Render a new PDF file,
- Create a new Markdown file,
- Create a new HTML document, and
- Create images of each page of the PDF file as PNGs.
> Why use RenderCV instead of $\LaTeX$? I can version-control $\LaTeX$ code too!
RenderCV is not a replacement for $\LaTeX$. It is a set of utilities designed to create and manage $\LaTeX$ CVs. If you're currently using $\LaTeX$ to create your CV, you should try RenderCV. Using your existing $\LaTeX$ themes in RenderCV is very easy.
Advantages of RenderCV over using pure $\LaTeX$:
- RenderCV will separate the content of your CV from your $\LaTeX$ code. They will sit in independent files, and RenderCV will use both to generate your CV.
- You will be able to version-control your $\LaTeX$ code and content separately.
- Updating your content in a YAML file is easier than updating a complex $\LaTeX$ file.
- A pure $\LaTeX$ CV will have many code duplications because a CV is a document with a list of sections that contain a list of entries. RenderCV has only one $\LaTeX$ code for each entry type, duplicated automatically based on the YAML input file.
- Spell-checking is not very straightforward in $\LaTeX$ documents.
## Documentation
- [User Guide](https://docs.rendercv.com/user_guide)
- [Developer Guide](https://docs.rendercv.com/developer_guide)
- [Overview of Source Code](https://docs.rendercv.com/reference)
- [Changelog](https://docs.rendercv.com/changelog)
## Contributing
All contributions to RenderCV are welcome! To get started, please read [the developer guide](https://docs.rendercv.com/developer_guide).