mirror of
https://github.com/rendercv/rendercv.git
synced 2026-09-16 08:01:58 -04:00
update folder structure of docs
This commit is contained in:
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
@@ -1,86 +1 @@
|
||||
# RenderCV
|
||||
[](https://github.com/sinaatalay/rendercv/actions/workflows/ci.yaml)
|
||||
[](https://coverage-badge.samuelcolvin.workers.dev/redirect/sinaatalay/rendercv)
|
||||
[)](https://pypi.python.org/pypi/rendercv)
|
||||
[)](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/).
|
||||
|
||||

|
||||
|
||||
## 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
@@ -86,7 +86,7 @@ highlights:
|
||||
|
||||
which renders into
|
||||
|
||||

|
||||

|
||||
|
||||
### *ExperienceEntry*
|
||||
|
||||
@@ -107,7 +107,7 @@ highlights:
|
||||
|
||||
which renders into
|
||||
|
||||

|
||||

|
||||
|
||||
### *NormalEntry*
|
||||
|
||||
@@ -124,7 +124,7 @@ url: https://example.com
|
||||
|
||||
which renders into
|
||||
|
||||

|
||||

|
||||
|
||||
### *OneLineEntry*
|
||||
```yaml
|
||||
@@ -134,7 +134,7 @@ details: C++, C, Python, JavaScript, MATLAB, Lua, LaTeX
|
||||
|
||||
which renders into
|
||||
|
||||

|
||||

|
||||
|
||||
### *PublicationEntry*
|
||||
|
||||
@@ -152,7 +152,7 @@ cited_by: 243
|
||||
|
||||
which renders into
|
||||
|
||||

|
||||

|
||||
|
||||
|
||||
## Custom Sections
|
||||
|
||||
+3
-4
@@ -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
|
||||
|
||||
|
||||
Reference in new issue
Block a user