update folder structure of docs

This commit is contained in:
Sina Atalay committed 2024-02-18 20:10:19 +01:00
1 parent 1653ec38db
commit 220cdac833
10 files changed
+9 -95

No files matched your search

File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
Binary file not shown.

Before

Width:  |  Height:  |  Size: 354 KiB

+1 -86
View File
@@ -1,86 +1 @@
# RenderCV
[![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.
gest
+5 -5
View File
@@ -86,7 +86,7 @@ highlights:
which renders into
![EducationEntry](images/EducationEntry.png)
![EducationEntry](assets/images/imagesEducationEntry.png)
### *ExperienceEntry*
@@ -107,7 +107,7 @@ highlights:
which renders into
![ExperienceEntry](images/ExperienceEntry.png)
![ExperienceEntry](assets/images/imagesExperienceEntry.png)
### *NormalEntry*
@@ -124,7 +124,7 @@ url: https://example.com
which renders into
![NormalEntry](images/NormalEntry.png)
![NormalEntry](assets/images/imagesNormalEntry.png)
### *OneLineEntry*
```yaml
@@ -134,7 +134,7 @@ details: C++, C, Python, JavaScript, MATLAB, Lua, LaTeX
which renders into
![OneLineEntry](images/OneLineEntry.png)
![OneLineEntry](assets/images/imagesOneLineEntry.png)
### *PublicationEntry*
@@ -152,7 +152,7 @@ cited_by: 243
which renders into
![PublicationEntry](images/PublicationEntry.png)
![PublicationEntry](assets/images/imagesPublicationEntry.png)
## Custom Sections
+3 -4
View File
@@ -1,4 +1,4 @@
site_name: "RenderCV"
site_name: RenderCV
site_description: LaTeX CV generator engine from a YAML input file.
site_author: Sina Atalay
copyright: Copyright © 2023 Sina Atalay
@@ -9,7 +9,6 @@ edit_uri: edit/main/docs/
theme:
name: material
custom_dir: docs
palette:
- media: "(prefers-color-scheme: light)"
scheme: default
@@ -80,12 +79,12 @@ plugins:
members_order: source
show_bases: true
docstring_section_style: list
# merge_init_into_class: true
merge_init_into_class: true
show_docstring_attributes: true
docstring_style: google
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/contrib/auto-render.min.js