update folder structure of docs
Before Width: | Height: | Size: 36 KiB After Width: | Height: | Size: 36 KiB |
Before Width: | Height: | Size: 71 KiB After Width: | Height: | Size: 71 KiB |
Before Width: | Height: | Size: 47 KiB After Width: | Height: | Size: 47 KiB |
Before Width: | Height: | Size: 15 KiB After Width: | Height: | Size: 15 KiB |
Before Width: | Height: | Size: 32 KiB After Width: | Height: | Size: 32 KiB |
Before Width: | Height: | Size: 354 KiB |
|
@ -1,86 +1 @@
|
||||||
# RenderCV
|
gest
|
||||||
[![CI](https://github.com/sinaatalay/rendercv/actions/workflows/ci.yaml/badge.svg?branch=main)](https://github.com/sinaatalay/rendercv/actions/workflows/ci.yaml)
|
|
||||||
[![coverage](https://coverage-badge.samuelcolvin.workers.dev/sinaatalay/rendercv.svg)](https://coverage-badge.samuelcolvin.workers.dev/redirect/sinaatalay/rendercv)
|
|
||||||
[![pypi-version](https://img.shields.io/pypi/v/rendercv?label=PyPI%20version&color=rgb(0%2C79%2C144))](https://pypi.python.org/pypi/rendercv)
|
|
||||||
[![pypi-downloads](https://img.shields.io/pepy/dt/rendercv?label=PyPI%20downloads&color=rgb(0%2C%2079%2C%20144))](https://pypi.python.org/pypi/rendercv)
|
|
||||||
|
|
||||||
|
|
||||||
RenderCV is a Python application that creates a $\LaTeX$ CV as a PDF from a JSON/YAML input file. Currently, it only supports one theme (*classic*). An example PDF can be seen [here](https://github.com/sinaatalay/rendercv/blob/main/John_Doe_CV.pdf?raw=true). More themes are planned to be supported in the future.
|
|
||||||
|
|
||||||
**What does it do?**
|
|
||||||
|
|
||||||
- It parses a YAML (or JSON) file that looks like this:
|
|
||||||
```yaml
|
|
||||||
cv:
|
|
||||||
name: John Doe
|
|
||||||
label: Mechanical Engineer
|
|
||||||
location: Geneva, Switzerland
|
|
||||||
email: johndoe@example.com
|
|
||||||
phone: "+33749882538"
|
|
||||||
website: https://example.com
|
|
||||||
social_networks:
|
|
||||||
- network: GitHub
|
|
||||||
username: johndoe
|
|
||||||
- network: LinkedIn
|
|
||||||
username: johndoe
|
|
||||||
education:
|
|
||||||
- institution: My University
|
|
||||||
url: https://example.com
|
|
||||||
area: Mechanical Engineering
|
|
||||||
degree: BS
|
|
||||||
location: Geneva, Switzerland
|
|
||||||
start_date: "2017-09-01"
|
|
||||||
end_date: "2023-01-01"
|
|
||||||
transcript_url: https://example.com
|
|
||||||
gpa: 3.10/4.00
|
|
||||||
highlights:
|
|
||||||
- "Class rank: 10 of 62"
|
|
||||||
- institution: The University of Texas at Austin
|
|
||||||
url: https://utexas.edu
|
|
||||||
area: Mechanical Engineering, Student Exchange Program
|
|
||||||
location: Austin, TX, USA
|
|
||||||
start_date: "2021-08-01"
|
|
||||||
end_date: "2022-01-15"
|
|
||||||
work_experience:
|
|
||||||
- company: AmIACompany
|
|
||||||
position: Summer Intern
|
|
||||||
location: Istanbul, Turkey
|
|
||||||
url: https://example.com
|
|
||||||
start_date: "2022-06-15"
|
|
||||||
end_date: "2022-08-01"
|
|
||||||
highlights:
|
|
||||||
- AmIACompany is a **technology** (markdown is
|
|
||||||
supported) company that provides web-based
|
|
||||||
engineering applications that enable the
|
|
||||||
simulation and optimization of products and
|
|
||||||
manufacturing tools.
|
|
||||||
- Modeled and simulated a metal-forming process deep
|
|
||||||
drawing using finite element analysis with
|
|
||||||
open-source software called CalculiX.
|
|
||||||
```
|
|
||||||
- Then, it validates the input, such as checking if the dates are consistent, checking if the URLs are correct, etc.
|
|
||||||
- Then, it creates a $\LaTeX$ file.
|
|
||||||
- Finally, it renders the $\LaTeX$ file to generate the PDF, and you don't need $\LaTeX$ installed on your PC because RenderCV comes with [TinyTeX](https://yihui.org/tinytex/).
|
|
||||||
|
|
||||||
![RenderCV example](images/example.png)
|
|
||||||
|
|
||||||
## Quick Start Guide
|
|
||||||
|
|
||||||
1. Install [Python](https://www.python.org/downloads/) (3.10 or newer).
|
|
||||||
2. Run the command below to install RenderCV.
|
|
||||||
```bash
|
|
||||||
pip install rendercv
|
|
||||||
```
|
|
||||||
3. Run the command below to generate a sample input file (`Full_Name_CV.yaml`). The file will be generated in the current working directory.
|
|
||||||
```bash
|
|
||||||
rendercv new "Full Name"
|
|
||||||
```
|
|
||||||
4. Edit the contents of the `Full_Name_CV.yaml` file.
|
|
||||||
5. Run the command below to generate your $\LaTeX$ CV.
|
|
||||||
```bash
|
|
||||||
rendercv render Full_Name_CV.yaml
|
|
||||||
```
|
|
||||||
|
|
||||||
## Contributing
|
|
||||||
|
|
||||||
All contributions to RenderCV are welcome, especially adding new $\LaTeX$ themes.
|
|
|
@ -86,7 +86,7 @@ highlights:
|
||||||
|
|
||||||
which renders into
|
which renders into
|
||||||
|
|
||||||
![EducationEntry](images/EducationEntry.png)
|
![EducationEntry](assets/images/imagesEducationEntry.png)
|
||||||
|
|
||||||
### *ExperienceEntry*
|
### *ExperienceEntry*
|
||||||
|
|
||||||
|
@ -107,7 +107,7 @@ highlights:
|
||||||
|
|
||||||
which renders into
|
which renders into
|
||||||
|
|
||||||
![ExperienceEntry](images/ExperienceEntry.png)
|
![ExperienceEntry](assets/images/imagesExperienceEntry.png)
|
||||||
|
|
||||||
### *NormalEntry*
|
### *NormalEntry*
|
||||||
|
|
||||||
|
@ -124,7 +124,7 @@ url: https://example.com
|
||||||
|
|
||||||
which renders into
|
which renders into
|
||||||
|
|
||||||
![NormalEntry](images/NormalEntry.png)
|
![NormalEntry](assets/images/imagesNormalEntry.png)
|
||||||
|
|
||||||
### *OneLineEntry*
|
### *OneLineEntry*
|
||||||
```yaml
|
```yaml
|
||||||
|
@ -134,7 +134,7 @@ details: C++, C, Python, JavaScript, MATLAB, Lua, LaTeX
|
||||||
|
|
||||||
which renders into
|
which renders into
|
||||||
|
|
||||||
![OneLineEntry](images/OneLineEntry.png)
|
![OneLineEntry](assets/images/imagesOneLineEntry.png)
|
||||||
|
|
||||||
### *PublicationEntry*
|
### *PublicationEntry*
|
||||||
|
|
||||||
|
@ -152,7 +152,7 @@ cited_by: 243
|
||||||
|
|
||||||
which renders into
|
which renders into
|
||||||
|
|
||||||
![PublicationEntry](images/PublicationEntry.png)
|
![PublicationEntry](assets/images/imagesPublicationEntry.png)
|
||||||
|
|
||||||
|
|
||||||
## Custom Sections
|
## Custom Sections
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
site_name: "RenderCV"
|
site_name: RenderCV
|
||||||
site_description: LaTeX CV generator engine from a YAML input file.
|
site_description: LaTeX CV generator engine from a YAML input file.
|
||||||
site_author: Sina Atalay
|
site_author: Sina Atalay
|
||||||
copyright: Copyright © 2023 Sina Atalay
|
copyright: Copyright © 2023 Sina Atalay
|
||||||
|
@ -9,7 +9,6 @@ edit_uri: edit/main/docs/
|
||||||
|
|
||||||
theme:
|
theme:
|
||||||
name: material
|
name: material
|
||||||
custom_dir: docs
|
|
||||||
palette:
|
palette:
|
||||||
- media: "(prefers-color-scheme: light)"
|
- media: "(prefers-color-scheme: light)"
|
||||||
scheme: default
|
scheme: default
|
||||||
|
@ -80,12 +79,12 @@ plugins:
|
||||||
members_order: source
|
members_order: source
|
||||||
show_bases: true
|
show_bases: true
|
||||||
docstring_section_style: list
|
docstring_section_style: list
|
||||||
# merge_init_into_class: true
|
merge_init_into_class: true
|
||||||
show_docstring_attributes: true
|
show_docstring_attributes: true
|
||||||
docstring_style: google
|
docstring_style: google
|
||||||
|
|
||||||
extra_javascript:
|
extra_javascript:
|
||||||
- javascripts/katex.js
|
- assets/javascripts/katex.js
|
||||||
- https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.7/katex.min.js
|
- https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.7/katex.min.js
|
||||||
- https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.7/contrib/auto-render.min.js
|
- https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.7/contrib/auto-render.min.js
|
||||||
|
|
||||||
|
|