document installation of moderncv and altacv

readme.org

@@ -16,8 +16,24 @@ items a latex file which compiles into a reasonably nice CV. In the same
 spirit the org-mode file must export to markdown so that it can be uses for
 web based CV.
 * Installation
+This project is not on MELPA so you have to do a manual installation. First
+clone this git repository.
+#+BEGIN_SRC bash
+git clone https://gitlab.com/Titan-C/org-cv.git
+#+END_SRC
+
+There are various modules to perform the export. As of now =ox-moderncv=,
+=ox-altacv=, =ox-hugocv=. Choose any or all that you prefer for install. I
+use =use-package= to manage my installed packages like this.
+
+#+BEGIN_SRC emacs-lisp
+(use-package ox-moderncv
+    :load-path "~/dev/org-cv/"
+    :init (require 'ox-moderncv))
+#+END_SRC
 
 * Basic Org file
+The basic structure of an org file containing your CV is shown next.
 #+BEGIN_SRC text :tangle basic_cv.org
 ,#+TITLE: My dream job
 ,#+AUTHOR: John Doe
@@ -29,6 +45,7 @@ web based CV.
 ,#+GITHUB: Titan-C
 ,#+GITLAB: Titan-C
 ,#+PHOTO: smile.jpg
+
 ,* Employement
 ,** One job
 :PROPERTIES:
@@ -49,9 +66,70 @@ I like languages: strict and human
 
 * Latex Exporter
 ** Using modern-cv
-I first started using latex modern-cv styles as the target for my CV.
+[[https://www.ctan.org/tex-archive/macros/latex/contrib/moderncv][moderncv]] is a standard \(\LaTeX\) package that you can find in many of your
-** Using alta-cv
+latex distributions. For I maintain for personal purposes a fork of it to
+better work with my use case at https://github.com/Titan-C/moderncv.git
+Feel free to use any or even your personal fork for your desired use case.
 
+To configure the export for moderncv you need the addition options in your
+org file.
+#+BEGIN_SRC org
+# CV theme - options include: 'casual' (default), 'classic', 'oldstyle' and 'banking'
+,#+CVSTYLE: banking
+# CV color - options include: 'blue' (default), 'orange', 'green', 'red', 'purple', 'grey' and 'black'
+,#+CVCOLOR: green
+#+END_SRC
+
+When exporting you can call the following function to get the latex file.
+#+BEGIN_SRC emacs-lisp :exports none
+(org-export-to-file 'moderncv "moderncv.tex")
+#+END_SRC
+
+or you can have a hook to do the export when you save a file.
+#+BEGIN_SRC org
+# Local Variables:
+# eval: (add-hook 'after-save-hook #'org-hugo-export-wim-to-md-after-save :append :local)
+# End:
+#+END_SRC
+** Using alta-cv
+[[https://github.com/liantze/AltaCV][AltaCV]] is another project to generate a CV, you will need to install it
+yourself. I maintain a fork too at https://github.com/Titan-C/AltaCV.git
+because I need extra features and I encourage to use this for on the
+sections branch.
+
+The style of this CV is more involved and you need some configuration in
+your org file to get it to work. First define the margins, the large margin
+to the right is to allow for a second column.
+#+BEGIN_SRC text
+#+LATEX_HEADER: \geometry{left=1cm,right=9cm,marginparwidth=6.8cm,marginparsep=1.2cm,top=1.25cm,bottom=1.25cm}
+#+END_SRC
+Content on the right column has the same structure of a org file, but you
+need to enclose it in the =\marginpar{}= command as shown next.
+#+BEGIN_SRC text
+#+latex: \marginpar{
+
+* Main Interests
+- Free/Libre and Open Source Software (FLOSS)
+- Free food
+- Free beer
+
+* Programming Languages
+- Python
+- C/C++
+- EmacsLisp
+- Bash
+- JavaScript
+- PHP
+
+* Languages
+
+- *English*  Fluent
+- *German*   Fluent
+- *Spanish*  Native
+- *French*   Intermediate
+
+#+latex: }
+#+END_SRC
 * Update readme
 ** TODO examples [0/2]
 *** TODO pictures