https://github.com/dcsunset/org-moderncv
Org exporter for curriculum vitae or cover letter using moderncv
https://github.com/dcsunset/org-moderncv
cover-letter cv emacs org org-mode resume
Last synced: 2 months ago
JSON representation
Org exporter for curriculum vitae or cover letter using moderncv
- Host: GitHub
- URL: https://github.com/dcsunset/org-moderncv
- Owner: DCsunset
- License: gpl-3.0
- Created: 2023-07-16T18:53:37.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-09-28T18:48:39.000Z (over 1 year ago)
- Last Synced: 2025-03-28T14:51:12.515Z (3 months ago)
- Topics: cover-letter, cv, emacs, org, org-mode, resume
- Language: Emacs Lisp
- Homepage:
- Size: 46.9 KB
- Stars: 4
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.org
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
#+TITLE: Org exporter for curriculum vitae using moderncv
This project is forked from [[https://gitlab.com/Titan-C/org-cv]].
It keeps only moderncv export and improves and fix bugs in it.
* Installation
To install it, you can clone this git repository and add it to your load-path:
#+BEGIN_SRC bash
git clone https://github.com/DCsunset/org-moderncv.git
(use-package org-moderncv
:load-path "path_to_repository/org-moderncv/"
:init (require 'org-moderncv))
#+END_SRC
If you are using Nix flake, you can add this repo to your inputs directly.
This package is also available in Nix NUR: =nur.repos.dcsunset.moderncv=.
* Basic Org file
The basic structure of an org file containing your CV is shown next.
** Personal contact information
=TITLE=, =AUTHOR= and =EMAIL= are standard org options. But on =TITLE= you
put your foreseen job.
| Field | Description |
|----------+----------------------------------------------------|
| CVKIND | Kind: "cv" or "letter". (default: "cv") |
| CVSTYLE | Moderncv style |
| CVCOLOR | Moderncv color |
| NOITALIC | Make subtitles non-italic in cventry if set |
| TITLE | Desired job |
| AUTHOR | Who are you? |
| EMAIL | Your contact email |
| ADDRESS | Mailing address, this can span over multiple lines |
| HOMEPAGE | URL of your website |
| MOBILE | Mobile phone |
| SOCIAL | Social items |
| PHOTO | path to photo file |
The social items correspond to the ~\social~ command in moderncv.
Each item consists of =kind=, =content=, and an optional =url=, separated by =|=.
(e.g. =github | | https://github.com/= or just =gitlab | =).
There are some options that only apply to the cover letter, as listed below.
You don't need to set them if you are not using the cover letter.
| Field | Description |
|-----------+-------------------------------------------------------------------------------|
| recipient | Recipient in cover letter. Need to specify it twice for recipient and company |
| opening | Opening line |
| closing | Closing line |
#+BEGIN_SRC org :tangle basic_cv.org
,#+TITLE: My dream job
,#+AUTHOR: Test
,#+email: Test
,#+ADDRESS: My Awesome crib
,#+ADDRESS: Fantastic city -- Planet Earth
,#+MOBILE: (+9) 87654321
,#+HOMEPAGE: example.com
,#+GITHUB: Test
,#+SOCIAL: github |
,#+SOCIAL: linkedin | |
,#+PHOTO: smile.png
#+END_SRC
You can use org-modes hierarchical structure to describe your CV. To make a
specific subtree an item describing an experience point (Job you have,
degree you pursued, etc.) you use the org properties drawer and with the
=:CV_ENV: cventry= property. You should also include the =FROM= and =TO=
properties defining the span of the event, as =LOCATION= and =EMPLOYER=.
#+BEGIN_SRC org :tangle workcontent.org
,* Employement
,** One job
:PROPERTIES:
:CV_ENV: cventry
:FROM: <2014-09-01>
:TO: <2017-12-07>
:TITLE: The employer
:SUBTITLE: a city, a country
:END:
I write about awesome stuff I do.
,** Other job
:PROPERTIES:
:CV_ENV: cventry
:FROM: <2013-09-01>
:TO: <2014-08-07>
:TITLE: The employer
:SUBTITLE: a city, a country
:END:
I write about awesome stuff I do.
,* Other stuff I do
- I work a lot
- I sleep a lot
- I eat a lot
#+END_SRC