rendercv/docs/user_guide/cli.md

Command Line Interface (CLI)

This page lists the available commands and options of the RenderCV CLI.

Options of the rendercv command

• #!bash --version or #!bash -v

  Shows the version of RenderCV.

  rendercv --version
  

• #!bash --help or #!bash -h

  Shows the help message.

  rendercv --help
  

Options of the rendercv new command

• #!bash --theme "THEME_NAME"

  Generates files for a specific built-in theme, instead of the default classic theme. Currently, the available themes are: {{available_themes}}.

  rendercv new "Full Name" --theme "THEME_NAME" 
  

• #!bash --dont-create-theme-source-files or #!bash -nolatex

  Prevents the creation of the theme source files. By default, the theme source files are created.

  rendercv new "Full Name" --dont-create-theme-source-files
  

• #!bash --dont-create-markdown-source-files or #!bash -nomd

  Prevents the creation of the Markdown source files. By default, the Markdown source files are created.

  rendercv new "Full Name" --dont-create-markdown-source-files
  

• #!bash --help or #!bash -h

  Shows the help message.

  rendercv new --help
  

Options of the rendercv render command

• #!bash --use-local-latex-command "LATEX_COMMAND" or #!bash -use "LATEX_COMMAND"

  Generates the CV with the local \LaTeX installation, i.e., runs LATEX_COMMAND. By default, RenderCV uses its own TinyTeX distribution.

  rendercv render "Full_Name_CV.yaml" --use-local-latex-command "pdflatex" 
  

• #!bash --output-folder-name "OUTPUT_FOLDER_NAME" or #!bash -o "OUTPUT_FOLDER_NAME"

  Generates the output files in a folder with the given name. By default, the output folder name is rendercv_output. The output folder will be created in the current working directory.

  rendercv render "Full_Name_CV.yaml" --output-folder-name "OUTPUT_FOLDER_NAME"
  

• #!bash --latex-path "PATH" or #!bash -latex "PATH"

  Copies the generated \LaTeX source code from the output folder and pastes it to the specified path.

  rendercv render "Full_Name_CV.yaml" --latex-path "PATH"
  

• #!bash --pdf-path "PATH" or #!bash -pdf "PATH"

  Copies the generated PDF file from the output folder and pastes it to the specified path.

  rendercv render "Full_Name_CV.yaml" --pdf-path "PATH"
  

• #!bash --markdown-path "PATH" or #!bash -md "PATH"

  Copies the generated Markdown file from the output folder and pastes it to the specified path.

  rendercv render "Full_Name_CV.yaml" --markdown-path "PATH"
  

• #!bash --html-path "PATH" or #!bash -html "PATH"

  Copies the generated HTML file from the output folder and pastes it to the specified path.

  rendercv render "Full_Name_CV.yaml" --html-path "PATH"
  

• #!bash --png-path "PATH" or #!bash -png "PATH"

  Copies the generated PNG files from the output folder and pastes them to the specified path.

  rendercv render "Full_Name_CV.yaml" --png-path "PATH"
  

• #!bash --dont-generate-markdown or #!bash -nomd

  Prevents the generation of the Markdown file.

  rendercv render "Full_Name_CV.yaml" --dont-generate-markdown
  

• #!bash --dont-generate-html or #!bash -nohtml

  Prevents the generation of the HTML file.

  rendercv render "Full_Name_CV.yaml" --dont-generate-html
  

• #!bash --dont-generate-png or #!bash -nopng

  Prevents the generation of the PNG files.

  rendercv render "Full_Name_CV.yaml" --dont-generate-png
  

• #!bash --ANY.LOCATION.IN.THE.YAML.FILE "VALUE"

  Overrides the value of ANY.LOCATION.IN.THE.YAML.FILE with VALUE. This option can be used to avoid storing sensitive information in the YAML file. Sensitive information, like phone numbers, can be passed as a command-line argument with environment variables. This method is also beneficial for creating multiple CVs using the same YAML file by changing only a few values. Here are a few examples:

  rendercv render "Full_Name_CV.yaml" --cv.phone "+905555555555"
  

  rendercv render "Full_Name_CV.yaml" --cv.sections.education.1.institution "Your University"
  

  Multiple #!bash --ANY.LOCATION.IN.THE.YAML.FILE "VALUE" options can be used in the same command.

• #!bash --help or #!bash -h

  Shows the help message.

  rendercv render --help
  

Options of the rendercv create-theme command

• #!bash --based-on "THEME_NAME"

  Generates a custom theme based on the specified built-in theme, instead of the default classic theme. Currently, the available themes are: {{available_themes}}.

  rendercv create-theme "mycustomtheme" --based-on "THEME_NAME"
  

• #!bash --help or #!bash -h

  Shows the help message.

  rendercv create-theme --help