diff --git a/docs/reference/data/models/rendercv_settings.md b/docs/reference/data/models/rendercv_settings.md new file mode 100644 index 00000000..bbce49c5 --- /dev/null +++ b/docs/reference/data/models/rendercv_settings.md @@ -0,0 +1,3 @@ +# `rendercv.data.models.rendercv_settings` + +::: rendercv.data.models.rendercv_settings \ No newline at end of file diff --git a/docs/user_guide/structure_of_the_yaml_input_file.md b/docs/user_guide/structure_of_the_yaml_input_file.md index ffad9a03..3cf8ecfd 100644 --- a/docs/user_guide/structure_of_the_yaml_input_file.md +++ b/docs/user_guide/structure_of_the_yaml_input_file.md @@ -1,6 +1,6 @@ # Structure of the YAML Input File -RenderCV's input file consists of three parts: `cv`, `design`, and `locale_catalog`. +RenderCV's input file consists of four parts: `cv`, `design`, `locale_catalog` and `rendercv_settings`. ```yaml title="Your_Name_CV.yaml" cv: @@ -15,11 +15,16 @@ locale_catalog: ... TRANSLATIONS TO YOUR LANGUAGE ... +rendercv_settings: + ... + RENDERCV SETTINGS + ... ``` - The `cv` field is mandatory. It contains the **content of the CV**. - The `design` field is optional. It contains the **design options of the CV**. If you don't provide a `design` field, RenderCV will use the default design options with the `classic` theme. - The `locale_catalog` field is optional. You can provide translations for some of the strings used in the CV, for example, month abbreviations. RenderCV will use English strings if you don't provide a `locale_catalog` field. +- The `rendercv_settings` field is optional. It contains the **settings of RenderCV**. If you don't provide a `rendercv_settings` field, RenderCV will use the default settings. !!! tip To maximize your productivity while editing the input YAML file, set up RenderCV's JSON Schema in your IDE. It will validate your inputs on the fly and give auto-complete suggestions. @@ -355,4 +360,22 @@ locale_catalog: ``` 1. The available phone number formats are: `national`, `international`, and `E164`. -2. The `MONTH_ABBREVIATION` and `YEAR` are placeholders. The available placeholders are: `FULL_MONTH_NAME`, `MONTH_ABBREVIATION`, `MONTH`, `MONTH_IN_TWO_DIGITS`, `YEAR`, and `YEAR_IN_TWO_DIGITS`. \ No newline at end of file +2. The `MONTH_ABBREVIATION` and `YEAR` are placeholders. The available placeholders are: `FULL_MONTH_NAME`, `MONTH_ABBREVIATION`, `MONTH`, `MONTH_IN_TWO_DIGITS`, `YEAR`, and `YEAR_IN_TWO_DIGITS`. + +## "`rendercv_settings`" field + +The `rendercv_settings` field contains the settings of RenderCV. This feature is what makes RenderCV a flexible tool. You can change the output folder name, the paths of the output files, and disable the generation of some output files directly from within the code (You can also use the [cli arguments](cli.md) which ever is convinient for you). Below is an example of the `rendercv_settings` field: + +```yaml +rendercv_settings: + output_folder_name: output # default value is 'rendercv_output' + pdf_path: cv.pdf # default value is 'None' + latex_path: cv.tex # default value is 'None' + html_path: cv.html # default value is 'None' + markdown_path: cv.md # default value is 'None' + dont_generate_html: false # default value is 'false' + dont_generate_markdown: false # default value is 'false' + dont_generate_png: false # default value is 'false' +``` + +All this fields are optional. If you don't provide a `rendercv_settings` field, RenderCV will use the default settings. diff --git a/mkdocs.yaml b/mkdocs.yaml index eaea8b4b..965c7800 100644 --- a/mkdocs.yaml +++ b/mkdocs.yaml @@ -78,6 +78,7 @@ nav: - curriculum_vitae.py: reference/data/models/curriculum_vitae.md - design.py: reference/data/models/design.md - locale_catalog.py: reference/data/models/locale_catalog.md + - rendercv_settings.py: reference/data/models/rendercv_settings.md - rendercv_data_model.py: reference/data/models/rendercv_data_model.md - generator.py: reference/data/generator.md - reader.py: reference/data/reader.md