How to use it

In you mkdocs.yml file, put the curriculum-vitae theme :

theme:
  name: curriculum-vitae

Next, you just have to create a docs folder in your repo, and only put an empty index.md.

Configuration

What you have to do is play with the theme variables :

Theming

Choosing a theme is optional, without the variable, the default theme will be applied to your CV.

To select one, you just have to define the mkcv_theme variable :

# mkdocs.yml

theme:
  name: curriculum-vitae
  mkcv_theme: default

Multiple themes are available, that affects CSS : - default - neon

Basic informations

  • firstname
  • lastname
  • mail
  • location

Example :

firstname: John
lastname: Doe
mail: john.doe@example.com
location: Tours

Profile picture

  • profile_picture

Example :

profile_picture: https://dummyimage.com/600x600/

Experiences

  • experiences

Each experience has a title, and a description. You can also add a start_date and end_date.

You can set start_date without end_date, this will put "now" instead.

Example :

experiences:
  - title: First experience
    description: First experience description
    start_date: 2024-01-01
  - title: Second experience
    description: Second experience description
    start_date: 2023-01-01
    end_date: 2023-12-31

Education

  • educations

Each education has a title, and a description. You can also add a start_date and end_date.

You can set start_date without end_date, this will put "now" instead.

educations:
  - title: First education
    description: First education description
    start_date: 2024-01-01
  - title: Second education
    description: Second education description
    start_date: 2023-01-01
    end_date: 2023-12-31

Skills

  • skills
skills:
  - skill 1
  - skill 2

Hobbies

  • hobbies
hobbies:
  - hobby 1
  - hobby 2

Certifications

  • certifications
certifications:
  - certification 1
  - certification 2

You can add links to your CV, those variables are optionnal. The link will appear only if the associated variable is defined.

personnal_links:
  github: https://example.com/
  gitlab: https://example.com/
  linkedin: https://example.com/
  facebook: https://example.com/
  youtube: https://example.com/
  Instagram: https://example.com/
  tiktok: https://example.com/

Titles override

You can override titles with ease with those variables. You don't need to define them, as they have default values.

main_title: Main title override
basic_informations_section_title: Basic infos title override
personnal_links_section_title: Links title override
experiences_section_title: Experiences title override
education_section_title: Education title overrride
skills_section_title: Skills title override
hobbies_section_title: Hobbies title override

Full Example

# mkdocs.yml

theme:
  name: curriculum-vitae
  firstname: John
  lastname: Doe
  mail: john.doe@example.com
  location: Tours
  profile_picture: https://dummyimage.com/600x600/
  main_title: Main title override
  basic_informations_section_title: Basic infos title override
  skills_section_title: Skills title override
  personnal_links_section_title: Links title override
  experiences_section_title: Experiences title override
  education_section_title: Education title overrride
  hobbies_section_title: Hobbies title override
  certifications_section_title: Certifications title override
  skills:
    - skill 1
    - skill 2
  hobbies:
    - hobby 1
    - hobby 2
  certifications:
    - certification 1
    - certification 2
  personnal_links:
    github: https://example.com/
    gitlab: https://example.com/
    linkedin: https://example.com/
    facebook: https://example.com/
    youtube: https://example.com/
    Instagram: https://example.com/
    tiktok: https://example.com/
  experiences:
    - title: First experience
      description: First experience description
      start_date: 2024-01-01
    - title: Second experience
      description: Second experience description
      start_date: 2023-01-01
      end_date: 2023-12-31
  educations:
    - title: First education
      description: First education description
      start_date: 2024-01-01
    - title: Second education
      description: Second education description
      start_date: 2023-01-01
      end_date: 2023-12-31