Repository: PandaScience/FortySecondsCV
Branch: main
Commit: 3cb095156020
Files: 8
Total size: 77.7 KB

Directory structure:
gitextract_lrf_p0gz/

├── .gitignore
├── .gitmodules
├── LICENSE
├── README-nl-NL.md
├── README.md
├── fortysecondscv.cls
├── template.tex
└── template.xdv

================================================
FILE CONTENTS
================================================

================================================
FILE: .gitignore
================================================
fonts/*
tmp/*
*pdf
*gz
*aux
*latexmk
*log
*synctex*
*fls
*out
test*
README.html


================================================
FILE: .gitmodules
================================================
[submodule "pics/flags"]
	path = pics/gosquared-flags
	url = https://github.com/gosquared/flags


================================================
FILE: LICENSE
================================================
Copyright © 2019 René Wirnata

Redistribution and use of this software in source and binary forms, with or
without modification, are permitted provided that the following conditions are
met:

1. Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.

2. Neither the name of the copyright holder nor the names of its contributors
may be used to endorse or promote products derived from this software without
specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.


================================================
FILE: README-nl-NL.md
================================================
Forty Seconds CV
================

[中文](https://github.com/PandaScience/FortySecondsCV/blob/old-license/README-zh-CN.md) | [English](README.md)

## Omschrijving

Gewoon een andere CV klasse voor LaTeX - maar deze keer zeer aanpasbaar!

Dit project kan worden beschouwd als een bijna volledige herschrijving van de
oorspronkelijke twentysecondcv klasse. Het is niet bedoeld om een nieuwe
cv-stijl aan te bieden die je nergens anders kunt vinden, maar neemt juist een
zeer gevestigde stijl en voegt een duidelijke gebruikersinterface toe aan bijna
alle lay-outelementen en maakt daarmee een zeer aanpasbare framework-klasse:
FortySecondsCV.

Probeer het gewoon zelf, beginnend vanaf `template.tex`!

Wanneer zou je twentysecondcv of altacv of een andere LaTeX CV klasse moeten
gebruiken:

* Je bent tevreden met de lay-outelementen die worden aangeboden door de
  bestaande CV-stijlen
* Je hoeft het afdrukformaat niet aan te passen
* Je wilt je CV-stijl verder niet aanpassen

Wanneer zou je de FortySecondsCV klasse moeten gebruiken:

* Je bouwt graag een CV op dat is geoptimaliseerd voor 2 pagina's incl. een
  zijbalk (met de optie voor extra pagina's)
* Je wilt je CV in hoge mate aanpassen met een groot kleurenpalet en
  layout-elementen
* Je wilt geen enkele definitie in het klassenbestand wijzigen
* Je geeft de voorkeur aan een eenvoudig te gebruiken gebruikersinterface voor
  bijna alle stijlelementen
* Je hebt een netjes geschreven klassenbestand nodig voor het geval je toch
  besluit om low-level klasse definities te veranderen


## Attributies

* Deze LaTeX CV-klasse is gebaseerd op de stijlideeën van de
  [twentysecondscv class](https://github.com/spagnuolocarmine/TwentySecondsCurriculumVitae-LaTex)
  door Carmine Spagnuolo
* Pictogrammen voor talen in de template zijn afkomstig uit [de repository van gosquared](https://github.com/gosquared/flags)


## Benodigdheden

Je moet het document compileren met XeLaTeX of LuaLaTeX om de nieuwste Font
Awesome-pictogrammen (`fontawesome5`) en Academicons te kunnen gebruiken. Als je
alsnog wilt compileren met pdfLaTeX om welke reden dan ook, ~~zal FortySecondsCV
terug vallen naar het oudere pictogrampakket (`fontawesome`), waar sommige
pictogrammen er anders uit zien en anderen niet eens zijn inbegrepen~~ zal
Academicons niet beschikbaar zijn.


## Licentie

Forty Seconds CV is uitgebracht onder de BSD 3-clausule licentie. Zie het
LICENSE bestand voor meer informatie.


## Gebruikersinterface

### Klasse-opties

De mogelijke opties die kunnen worden doorgegeven aan FortySecondsCV zijn:

* alle geldige opties voor de standaard artikelklasse zoals bijv. `a4paper` of
  `11pt`.
* `sidesectionsize` stelt de lettergrootte van sectie titels in de zijbalk in op
  `\large`, `\huge`, etc., wanneer deze optie wordt ingesteld op `large`,
  `huge`, etc. (d.w.z. zonder de backslash er voor)
* `showframes` toont randen rond de zijbalk en de teksten in het hoofddocument
  wat kan helpen om de marges correct aan te passen. Let wel op dat hierdoor de
  inhoud van tabellen wat wordt verplaatst omdat de lijnen ook wat ruimte
  innemen.
* `vline=<lengte>` tekent een rode verticale lijn op x-positie `<length>` om te
  helpen de inhoud van de zijbalk aan te passen.
* `maincolor=<kleur>` stelt de themakleur in die wordt gebruikt voor de gehele
  zijbalk incl. koppen, pictogrammen, en grafieken. Veel kleuren worden van deze
  afgeleid.
* `sidecolor=<kleur>` stelt de achtergrondkleur van de zijbalk in.
* `sidetextcolor=<kleur>` stelt de kleur van de tekst in de zijbalk in.
* `sectioncolor=<kleur>` stelt de kleur van sectiekoppen in de hoofdtekst in.
* `itemtextcolor=<kleur>` stelt de kleur van cvitem beschrijvingen in.
* `subsectioncolor=<kleur>` hetzelfde als sectioncolor, voor subsecties.
* `sidebarwidth=<lengte>` stelt de totale breedte van de zijbalk in, d.w.z. de
  breedte van de zichtbare zijbalkkleur.
* `topbottommargin=<lengte>` stelt de boven- en onderpaginamarge in voor beide
  kolommen.
* `leftrightmargin=<lengte>` stelt de linker- en rechterpaginamarge in voor
  beide kolommen en tevens hoeveel ruimte er tussen de beide kolommen zal zijn.
* `profilepicsize=<lengte>` stelt de breedte van de profielfoto in.
* `profilepicborderwidth=<lengte>` stelt de breedte in van de rand van de
  profielfoto.
* `profilepicstyle=profilecircle` toont de profielfoto in een cirkel zoals in
  de originele `twentysecondcv` klasse.
* `profilepiczoom=<float>` stelt de zoomfactor voor de profielfoto in. Samen met
  de twee onderstaande opties kun je jouw favoriete profielfoto direct zonder
  wijziging hier gebruiken en hier bijsnijden.
* `profilepicxshift=<lengte>` stelt de xshift voor de profielfoto in.
* `profilepicyshift=<lengte>` stelt de yshift voor de profielfoto in.
* `profilepicrounding=<lengte>` stelt de afrondingsradius in voor de rechter
  bovenhoek en de linker benedenhoek voor de standaard afgeronde
  profielfotostijl.
* `sidebarplacement=right` verplaatst de zijbalk naar de rechterkant van het
  document in plaats van links.

Let op:

* Lengtes kunnen worden opgegeven in elke absolute lengte-eenheid, bijv. `em`
  voor breedtes, `ex` voor hoogtes, of relatieve waarden zoals`0.5\paperheight`
  of `0.3\linewidth`.
* Kleuren kunnen worden gekozen uit de volledige catalogus verzorgd door de
  `dvipsnames`, `svgnames`, en` x11names` opties van het `xcolor` pakket. Zie de
  [xcolor pakket documentatie](http://mirrors.ctan.org/macros/latex/contrib/xcolor/xcolor.pdf)
  voor meer informatie en kleurentabellen.
* Kleuren kunnen ook opnieuw worden gedefinieerd binnen de documenttekst met
  bijv. `\definecolor{sidecolor}{HTML}{000000}`.

### Zijbalk

De zijbalken aan de voor- en achterkant van het CV worden gegenereerd met behulp
van de commando's `\makefrontsidebar` en`\makebacksidebar` binnen het `document`
gedeelte van de LaTeX code. Het wordt aanbevolen om `\newpage` onmiddellijk vóór
`\makebacksidebar` te gebruiken.

Lay-outelementen in de zijbalk aan de voor- en achterkant kunnen worden
toegevoegd met
```latex
\addtofrontsidebar{}
\addtobacksidebar{}
```
met enkele vooraf gedefinieerde elementen zoals profielfoto, naam en functie
titel al ingesteld, of definieer ze volledig opnieuw met
```latex
\renewcommand{\makefrontsidebar}{%
  \begin{sidebar}
    <jouw code>
  \end{sidebar}
}
```
Je kunt alle eerder gedefinieerde macro's gebruiken zoals `\cvname` en
`\cvjobtitle` of andere elementen zoals de icontable
[hier](#persoonlijke-informatie) uitgelegd.
Zie [#22](https://github.com/PandaScience/FortySecondsCV/issues/22) voor een
meer gedetailleerd voorbeeld.

De `sidebar`-omgeving zorgt ervoor dat in ieder geval alle tekst correct wordt
gepositioneerd in de linkerkolom (zijbalk) van elke pagina. Als je iets
beperkters nodig hebt, bijv. om overloop te voorkomen bij gebruik van meerdere
diagramlabels, kun je delen van de zijbalkinhoud insluiten in een
`sidebarminipage`:
```latex
\begin{sidebarminipage}
  \chartlabel{Bubble Diagram}
  \chartlabel{met}
  \chartlabel{juiste}
  \chartlabel{overflow}
  \chartlabel{bescherming}
  \chartlabel{voor}
  \chartlabel{labels}
\end{sidebarminipage}
```
Met behulp van de `sidebar`-omgeving kun je ook makkelijk meer sidebar
definities toevoegen voor extra pagina's. Als je wilt dat de zijbalk in plaats
van de linkerkant, aan de rechterkant van de pagina verschijnt, gebruik dan de
klasse-optie `sidebarplacement=right`.

Als je de zijbalk volledig wilt verwijderen op een enkele pagina, roep dan
simpelweg de zijbalk constructors niet aan. Vervolgens kun je de gewenste marges
instellen met
```latex
\newpage
% geen \makebacksidebar enz.
\newgeometry{
  top=<lengte>,
  bottom=<lengte>,
  left=<lengte>,
  right=<lengte>
}
```
De standaardinstellingen zijn `\leftrightmargin` en `\topbottommargin`. Voor het
geval je op de volgende pagina's weer wilt terugkeren naar de standaard layout,
hoef je alleen maar `\restoregeometry` aan te roepen na de volgende `\newpage`.

De tekstkleur van sidebar elementen kan worden aangepast via de klasse-optie
`sidetextcolor`. Voor zwaardere stijlwijzigingen kun je ook het `\sidetext`
commando aanpassen aan je behoeften. Bijvoorbeeld:
```latex
  \renewcommand{\sidetext}[1]{\textcolor{red}{\texttt{#1}}}
```

### Persoonlijke informatie

Stel persoonlijke informatie in via handige functies:
```latex
  % logo afbeelding
  \cvlogopic[0.8\linewidth]{pics/logo.png}
  % profielfoto
  \cvprofilepic{pics/profile.png}
  % uw naam
  \cvname{Panda Bear}
  % functietitel
  \cvjobtitle{Panda Scientist,\\[0.2em] Panda of the Year}
  % geboortedatum
  \cvbirthday{Mar 7, 2019}
  % kort adres / locatie, gebruik \newline als er meer dan 1 regel nodig is
  \cvaddress{Park Ave.~1, 555 555 B-Woods}
  % telefoonnummer
  \cvphone{+86 555 555 555}
  % persoonlijke website
  \cvsite{https://pandascience.net}
  % e-mailadres
  \cvmail{panda@bamboo.cn}
  % pgp sleutel
  \cvkey{4096R/FF00FF00}{0xAABBCCDDFF00FF00}
  % elk ander custom item
  \cvcustomdata{\faFlag}{Chinese}
```
* Alleen `\cvname` en `\cvjobtitle` zijn verplicht.
* Als je wilt dat een (optioneel) item niet in je CV verschijnt, gebruik het dan
  simpelweg niet. Als je geen van deze handige commando's gebruikt, zal de
  tabel met persoonlijke informatie helemaal niet verschijnen.
* Het e-mailadres wordt automatisch gekoppeld aan `mailto:email`.
* Er wordt ook een hyperlink naar je website gemaakt.
* Voor de pgp-sleutel definieert het eerste argument de weergegeven tekst,
  die gekoppeld is aan een keyserver die zoekt naar de ID in het tweede
  argument.<br>
  Let op: Om veiligheidsredenen dien je de lange ID van je sleutel of de
  vingerafdruk in het tweede argument te gebruiken.
* De macro `\cvcustom{<pictogram>}{<tekst>}` laat zien hoe je nieuwe regels
  definieert met een pictogram als eerste, en wat tekst als tweede argument.
  Achter de schermen is dit commando eigenlijk gebruikt om de andere commando's
  in het bovenstaande voorbeeld te definiëren.

Als je de standaardstijl van de "persoonlijke informatietabel" niet mooi vindt,
kan je jouw eigen tabel definiëren met
```latex
\begin{icontable}[<arraystretch=1>]{<breedte 1st column>}{<ruimte tussen kolommen>}
  \personal{<pictogram>}{<tekst>}
  \social{<pictogram>}{<URL>}{<tekst>}
\end{icontable}
```
waarbij de breedte van de 1e kolom ook de grootte van alle pictogrammen in die
kolom bepaalt, aangezien pictogrammen worden geschaald naar de maximale breedte
van hun cel. Voor visuele doeleinden kun je de ruimte tussen de pictogrammen en
de bijbehorende tekst bepalen met het 2e verplichte argument. Het optionele
argument bepaalt de afstand tussen de tabel regels, wat alleen belangrijk is
voor kleine pictogramhoogtes (d.w.z. kleine 1e kolommen).

* `\personal` accepteert een pictogram en een tekst. Het pictogram wordt
  doorgegeven aan `\circleicon{<pictogram>}`, die een cirkel tekent die is
  gevuld met `maincolor` rondom het pictogram. Het pictogram zelf wordt wit
  weergegeven.
* `\social` accepteert een pictogram en een URL + tekst. `Tekst` wordt als label
  weergegeven van een hyperlink naar `URL`.
  In het geval dat `URL` leeg is, zal uw LaTeX-compiler een onschuldige
  waarschuwing geven over "Suppressing link with empty target" en de tekst zal
  worden weergegeven zonder link. Het pictogram zelf wordt doorgegeven aan
  `\socialicon{<pictogram>}`, dat simpelweg de grootte wijzigt van pictogram en
  het tekent in `maincolor`. Deze versie heeft de voorkeur voor de pictogrammen
  van sociale netwerken (zie voorbeeld).

De standaard "persoonlijke informatietabel" gebruikt
```latex
\begin{icontable}[1.6]{1.7em}{0.4em}
  \personal{<pictogram>}{<tekst>}
\end{icontable}
```

### Andere stijlelementen in de zijbalk

* Sectie kop tekst
  ```latex
  \profilesection{<sectie kop tekst>}
  ```

* Eenvoudige vaardigheid met alleen een pictogram en wat tekst en met optionele
  inspringing
  ```latex
  \skill[<inspringing>]{<pictogram>}{<tekst>}
  ```

* Vaardigheid uitgedrukt in punten, bestaande uit een icoon, tekst, het aantal
  punten en optioneel het maximaal mogelijke aantal punten (standaard: 5).
  Een paar voorbeelden:
  ```latex
  \pointskill{<pictogram>}{<tekst>}{<punten>}
  ```
  maakt een vaardigheid met behulp van een Font Awesome- of Academicons
  pictogram met wat tekst en een ranking van `<punten>` van de 5 punten.
  ```latex
  \pointskill{<pictogram>}{<tekst>}{<punten>}[<maximum>]
  ```
  maakt een vaardigheid met behulp van een Font Awesome- of Academicons
  pictogram met wat tekst en een ranking van `<punten>` uit `<maximum>`
  mogelijke punten.
  ```latex
  \pointskill{\flag{DE.png}}{Duits}{5}
  ```
  creëert een taalvaardigheid met behulp van een vlagpictogram, dat moet worden
  aangegeven met het `\flag` commando om de klasse te informeren dat het
  pictogram niet gekleurd moet worden in `\maincolor`.

* Vaardigheid uitgedrukt in een balk, bestaande uit een pictogram, tekst en
  percentage van hoe ver de vaardigheidsbalk moet worden gevuld
  ```latex
  \barskill{<pictogram>}{<tekst>}{<percentage>}
  ```

* "Over mij" tekst
  ```latex
  \aboutme{<tekst over meerdere regels>}
  ```

* Afgerond en gekleurd label voor bijv. grafieken en andere afbeeldingen
  ```latex
  \chartlabel{<tekst>}
  ```

* Wiel diagram
  ```latex
  \wheelchart{<buitenste straal>}{<binnenste straal>}{%
    <percentage>/<afstand>/<kleur>/<tekst>,
    <percentage>/<afstand>/<kleur>/<tekst>
  }
  ```
  * Percentages moeten samen uitkomen op 100

* Lidmaatschappen
  ```latex
  \begin{memberships}[<afstand>=1em]
    \membership[<pictogrambreedte>=4em]{<logo>}{<tekst>}
    \membership[<pictogrambreedte>=4em]{<logo>}{<tekst>}
    \membership[<pictogrambreedte>=4em]{<logo>}{<tekst>}
  \end{memberships}
  ```
  * De breedte van de 1e kolom met de pictogrammen is gelijk aan de breedte van
    de grootste pictogram zodat alle tekst in de 2e kolom uitgelijnd is.

* Sociale netwerken
  ```latex
  \begin{socialnetwork}[<afstand>=1em]
    \social{<pictogram>}{<URL>}{<tekst>}
    \social{<pictogram>}{<URL>}{<tekst>}
    \social{<pictogram>}{<URL>}{<tekst>}
  \end{socialnetwork}
  ```
  * Een andere pictogramstijl die gebruikt kan worden voor bijv. sociale
    netwerk pictogrammen van Academicons, maar die ook werkt voor FontAwesome
    pictogrammen.
  * `tekst` wordt de label van een link naar `URL`.
  * `tekst` kan zoals gewoonlijk worden opgemaakt via bijv. `\texttt{}` enz.

### Hoofdtekst

De rechterkolom van de CV met tabellen voor iets als "werkervaring" moet
gedefinieerd worden binnen de `document` omgeving.

* Sectie- en subsectie koppen
  ```latex
  \cvsection
  \cvsubsection
  ```

* CV-items moeten binnen `cvtable` worden geplaatst, onafhankelijk van het type.
  De mogelijkheden zijn:
  ```latex
  \begin{cvtable}[<arraystretch>=1]
    \cvitem{<data>}{<titel>}{<locatie>}{<omschrijving>}
    \cvitem{<data>}{<titel>}{<locatie>}{}
    \cvitemshort{<key>}{<omschrijving>}
    \cvpubitem{<titel>}{<auteur>}{<tijdschrift>}{<jaar>}
  \end{cvtable}
  ```
  * `cvitem` inclusief een omschrijving zal de titel vetgedrukt maken, de datum
    of data links uitlijnen, de locatie rechts uitlijnen en de omschrijving
    ingesprongen op de volgende regel zetten. De beschrijving zelf zal in
    `itemtextcolor` staan, zoals gedefinieerd in de
    [klasse opties](#klasse-opties).
  * Als `cvitem` een beschrijving mist, wordt er een item van één regel
    toegevoegd in de stijl hierboven omschreven, maar met een "normale" titel in
    plaats van vetgedrukt.
  * `cvitemshort` lijnt `<key>` linkt uit, gevolgd door de omschrijving.
  * `cvpubitem` voegt een item toe met links uitgelijnd jaar/datum, vetgedrukte
    titel op dezelfde regel, gevolgd door een cursieve gedrukte auteur naam, en
    normaal gedrukte tijdschrift, elk op een afzonderlijke regel.
  * `<arraystretch>` wijzigt de afstand tussen de items van `cvtable`. Voor
     tabellen van `cvitem` moet je minimaal 1.5 gebruiken, voor` cvitemshort` en
     `cvitem` zonder omschrijving is de standaardwaarde voldoende.

* Kleuren
  `cvsection`, `cvsubsection` en de tekst kleur van omschrijvingen kunnen
  worden gedefinieerd zoals omschreven in de [klasse opties](#klasse-opties).

* De combinatie van naam en functietitel met de juiste spatiëring, lettertype en
  kleur
  ```latex
  \nameandjob
  ```

* Het afronden van de CV met een plaats, datum en handtekening, zoals
  gebruikelijk in bijv. Duitsland wordt gedaan via
  ```latex
  \cvsignature
  ```

### Configuratie van het lettertype

* Wijzig het standaardlettertype door het bijbehorende pakket te laden, bijv.
  voor google noto
  ```latex
  \usepackage[sfdefault]{noto} % gebruik het google noto lettertype
  ```
  of door de optie van XeLaTeX te gebruiken om lokale lettertypen rechtstreeks
  in te laden via fontspec
  ```latex
  \usepackage[quiet]{fontspec}
  \newfontfamily\headingfont[Path = fonts/]{segoeuib.ttf}
  ```

* Voor meertalige documenten, raad ik het gebruik van van pdfLaTeX ten zeerste
  af. Omdat ik maar weinig ervaring heb met LuaLaTeX (maar ik zal waarschijnlijk
  wel binnenkort hiernaar overschakelen), kan ik voor nu alleen instructies
  geven voor XeLaTeX. Daar moet je eerst het `polyglossia` pakket inladen en
  vervolgens lettertypen instellen voor elke taal afzonderlijk. Voor documenten
  met Latijns schrift met bijv. enkele Arabische tekstfragmenten, gebruik dan
  ```latex
  \usepackage{polyglossia}
  \newfontfamily\arabicfont[Script=Arabic]{Amiri}
  \setdefaultlanguage{english}
  \setotherlanguage{arabic}
  % zet Arabische fragmenten in de hoofdtekst met één van
  \textarabic{...}
  \begin{Arabic}...\end{Arabic}
  ```
  terwijl u voor documenten met een niet-Latijns schrift iets kunt gebruiken als
  ```latex
  \usepackage{polyglossia}
  \setmainfont{Amiri}
  \newfontfamily\englishfont{Clear Sans}
  \setdefaultlanguage{arabic}
  \setotherlanguage{english}
  % zet Engelse fragmenten in de hoofdtekst met één van
  \textenglish{...}
  \begin{english}...\end{english}
  ```
  Voor Perzische talen (Farsi) zou het volgende moeten werken volgens
  [dit antwoord](https://tex.stackexchange.com/a/238245):
  ```latex
  \newfontfamily\farsifont[Script=Arabic,Scale=10,Contextuals=Swash]{IranNastaliq}
  ```
  Afhankelijk van welk lettertypestijl jouw standaard is, moet je
  `\arabicfontfs` (sans serif) gebruiken, of `\arabicfonttt` (monospace), in
  plaats van `\arabicfont`.

  OPMERKING: Als je een RTL-lettertype instelt als hoofdlettertype, worden ook
  andere delen van het CV automatisch omgedraaid. Hoewel dit voor de meeste
  onderdelen geen probleem lijkt te zijn voor zover ik kan zien (ik ben helemaal
  niet gewend aan RTL), breekt het wel een deel van de vaardigheid commando's,
  met name `\pointskill` en `\membership`, en leidt het tot enige problemen met
  de afstanden. Hoe dan ook, voor RTL wil je ook waarschijnlijk de
  `sidebarplacement=right` optie gebruiken.

* TODO: LuaLaTeX + babel-instellingen

* Je moet lettertypen zoals Amiri en Clear Sans handmatig installeren wanneer
  je ze via fontspec inlaadt. Dit is niet nodig voor documenten in één taal
  waar je eenvoudig van lettertype kunt wisselen, zoals in het eerste voorbeeld,
  door de respectievelijke LaTeX-pakketten te gebruiken.

* Als je op zoek bent naar een specifiek pictogram, bijvoorbeeld LinkedIn, moet
  je eerst in de [FontAwesome galerij](https://fontawesome.com/icons?d=gallery)
  naar de naam zoeken, bijv. `linkedin-in`, en vervolgens de bijbehorende
  LaTeX-code opzoeken in het
  [fontawesome5 pakket](https://ftp.gwdg.de/pub/ctan/fonts/fontawesome5/doc/fontawesome5.pdf),
  in dit geval '\faLinkedinIn'.

* Als je de regelafstand globaal wilt vergroten, gebruik je
  ```latex
  \usepackage{setspace}
  \setstretch{1.1}
  ```
  in plaats van de `arraystretch` modifier. Merk op dat dit ook van invloed is
  op de inhoud van de zijbalk.

* Als je de grootte van het basis lettertype wilt wijzigen, gebruik de opties
  van de 'artikel' klasse zoals `12pt`, voor alle elementen in het hoofd
  document en de paragrafen in de zijbalk. Koppen in de zijbalk kunnen worden
  aangepast via de `sidesectionsize` [klasse optie](#klasse-opties). Voor de
  lettergrootte van naam en functietitel moet je respectievelijke commando's
  opnieuw definiëren, zoals [hier](#zijbalk) uitgelegd.


## Voorbeeld

![](pics/template-0.jpg)
![](pics/template-1.jpg)


================================================
FILE: README.md
================================================
# Forty Seconds CV

[中文](https://github.com/PandaScience/FortySecondsCV/blob/old-license/README-zh-CN.md) | [Nederlands](README-nl-NL.md)

## Description

Just another CV class for LaTeX - but this time highly customizable!

This project can be regarded as a major rewrite of the original twentysecondcv
class. It does not aim to provide a new CV style that you can't find anywhere
else, but rather takes a very well established one and adds a straightforward
user interface to almost all layout elements and thus creates a highly
customizable framework-class: FortySecondsCV.

Just try it yourself starting from `template.tex`!

When you should use twentysecondcv or altacv or any other LaTeX CV class:

- You are happy with the layout elements offered by the existing CV class styles
- You don't need to change paper sizes / formats at all
- You don't want to customize your CV further

When you should use the FortySecondsCV class:

- You like to build a CV optimized for 2 pages incl. a sidebar (with option for
  additional pages)
- You want to highly customize your CV using a great palette of colors and
  layout elements
- You don't want to modify any definition in the class file
- You prefer an easy-to-use user interface to almost all style elements
- You need a cleanly written class file in case you decide to change low-level
  class definitions

## Attributions

- This LaTeX CV class is based on the style ideas of the
  [twentysecondscv class](https://github.com/spagnuolocarmine/TwentySecondsCurriculumVitae-LaTex)
  by Carmine Spagnuolo
- Language icons in the template are taken from [gosquared's repository](https://github.com/gosquared/flags)

## Requirements

You need to compile your document with XeLaTeX or LuaLaTeX in order to have
the latest Font Awesome icons (`fontawesome5`) and Academicons. If you still
want to compile with pdfLaTeX for whatever reason, Academicons won't be
available.

If you want to use [gosquared's flag icon set](https://github.com/gosquared/flags),
make sure to first run

```
git submodule update --init
```

## License

Forty Seconds CV is distributed under the BSD 3-Clause license. See LICENSE
file for more information.

## User Interface

### Class Options

Possible options that can be passed to FortySecondsCV are:

- all valid options for the standard article class like e.g. `a4paper` or
  `11pt`.
- `sidesectionsize` sets the font size of sidebar section titles to `\large`,
  `\huge`, etc. when assigned to `large`, `huge`, etc. (i.e. w/o leading slash)
- `showframes` will show frames around the sidebar and body texts that help to
  adjust margins correctly. Note, that this will move content of tables
  slightly since tabular lines also take some space.
- `vline=<length>` plots a red vertical line at x-position `<length>` to help
  adjust sidebar content.
- `maincolor=<color>` sets the theme color used for the entire sidebar incl.
  headings, icons, and charts. Many colors are derived from it.
- `sidecolor=<color>` sets the background color of the sidebar.
- `sidetextcolor=<color>` sets the color of text located in the sidebar.
- `sectioncolor=<color>` sets the color of section headings in the body text.
- `itemtextcolor=<color>` sets the color of cvitem descriptions.
- `subsectioncolor=<color>` same as sectioncolor for subsections.
- `sidebarwidth=<length>` sets the total width of the sidebar, i.e. the width
  of the visible sidebar color.
- `topbottommargin=<length>` sets the top and bottom page margin for both
  columns.
- `leftrightmargin=<length>` sets the left and right page margin for both
  columns as well as how much space will be between both columns.
- `nameandjobposition` controls the position of the name and job title with
  regards the profile picture: 'after' (default), 'before' or hidden for any
  other value.
- `profilepicsize=<length>` sets the width of the profile picture.
- `profilepicborderwidth=<length>` sets the width of the profile picture's
  border.
- `profilepicstyle=profilecircle` clips the profile picture to a circle as in
  the original `twentysecondcv` class.
- `profilepiczoom=<float>` sets the zoom factor for the profile picture.
  Together with the two options below, this allows you to use your favorite
  profile picture directly without modification and crop it here.
- `profilepicxshift=<length>` sets the xshift for the profile picture.
- `profilepicyshift=<length>` sets the yshift for the profile picture.
- `profilepicrounding=<length>` sets the rounding radius for the top right and
  bottom left corner in the default rounded profile picture style.
- `sidebarplacement=right` puts the sidebar to the right of the body instead of
  to the left.
- `frontsidebaronallpages` renders the same (front)sidebar on all pages.

  **NOTE:** when using this option, there is no need for any manual
  `\makefrontsidebar` or `\makebacksidebar` commands in the `.tex` file!

- `datecolwidth=<length>` sets the width of the date column of the body.

Notes:

- Lengths can be specified in any absolute length unit, e.g. `em` for widths,
  `ex` for heights, or relative ones like `0.5\paperheight` or `0.3\linewidth`.
- Colors can be picked from the entire catalogue provided by the `dvipsnames`,
  `svgnames`, and `x11names` options of the `xcolor` package. See
  [xcolor package documentation](http://mirrors.ctan.org/macros/latex/contrib/xcolor/xcolor.pdf)
  for details and color tables.
- Colors can also be redefined within the document body using e.g.
  `\definecolor{sidecolor}{HTML}{000000}`.
- Redefining `maincolor` is a bit tricky. See [#34][i34] for more details.

[i34]: https://github.com/PandaScience/FortySecondsCV/issues/34

### Sidebar

Sidebars on front and back of the CV are generated using the commands
`\makefrontsidebar` and `\makebacksidebar` within the `document` part of the
LaTeX code. It is recommended to use `\newpage` immediately before
`\makebacksidebar`.

Layout elements in front and back sidebar can be added either by using

```latex
\addtofrontsidebar{}
\addtobacksidebar{}
```

where some pre-defined elements like profile picture, name and job title are
already set, or completely redefine them using

```latex
\renewcommand{\makefrontsidebar}{%
  \begin{sidebar}
    <your code>
  \end{sidebar}
}
```

You can use all previously defined macros like `\cvname` and `\cvjobtitle` or
other elements like the icontable introduced [here](#personal-information).
See [#22][i22] for a more detailed example.

[i22]: https://github.com/PandaScience/FortySecondsCV/issues/22

The `sidebar` environment makes sure that at least all text will be positioned
correctly within the left column (sidebar) of each page. If you need something
more restrictive, e.g. to prevent overflow when using multiple chart labels,
you can enclose parts of the sidebar content in a `sidebarminipage`:

```latex
\begin{sidebarminipage}
  \chartlabel{Bubble Diagram}
  \chartlabel{with}
  \chartlabel{proper}
  \chartlabel{overflow}
  \chartlabel{protection}
  \chartlabel{for}
  \chartlabel{labels}
\end{sidebarminipage}
```

Using the `sidebar` environment, you can also add more sidebar definitions for
additional pages easily. If you want the sidebar to appear on the right instead
of the left side of the body, use the class option `sidebarplacement=right`.

If you want to remove the sidebar entirely on a single page, just don't call
any of the sidebar constructors. Then you may set your preferred margins using

```latex
\newpage
% no \makebacksidebar etc.
\newgeometry{
  top=<length>,
  bottom=<length>,
  left=<length>,
  right=<length>
}
```

The defaults are `\leftrightmargin` and `\topbottommargin`. In case you want
to return to the default layout on subsequent pages, simply call
`\restoregeometry` after the next `\newpage`.

The text color of sidebar elements can be adapted via the class option
`sidetextcolor`. For heavier style changes you can also redefine the
`\sidetext` command to your needs. For example:

```latex
  \renewcommand{\sidetext}[1]{\textcolor{red}{\texttt{#1}}}
```

### Personal Information

Set personal information via convenience commands

```latex
  % logo picture
  \cvlogopic[0.8\linewidth]{pics/logo.png}
  % profile picture
  \cvprofilepic{pics/profile.png}
  % your name
  \cvname{Panda Bear}
  % job title/career
  \cvjobtitle{Panda Scientist,\\[0.2em] Panda of the Year}
  % date of birth
  \cvbirthday{Mar 7, 2019}
  % short address/location, use \newline if more than 1 line is required
  \cvaddress{Park Ave.~1, 555 555 B-Woods}
  % phone number
  \cvphone{+86 555 555 555}
  % personal website
  \cvsite{https://pandascience.net}
  % email address
  \cvmail{panda@bamboo.cn}
  % pgp key
  \cvkey{4096R/FF00FF00}{0xAABBCCDDFF00FF00}
  % any other custom entry
  \cvcustomdata{\faFlag}{Chinese}
```

- Only `\cvname` and `\cvjobtitle` are mandatory.
- If you want any (optional) entry not to show up in your CV, simply don't use
  it. If you don't use any of these convenience commands, the personal
  information table will not appear at all.
- The email address will be automatically linked with `mailto:email`.
- Your website will be hyperlinked as well.
- For the pgp key, the first argument defines the displayed text which is
  linked to a keyserver searching for the ID in the second argument.<br>
  Note: For safety, you should use your key's long ID or its fingerprint in the
  second argument.
- The `\cvcustom{<icon>}{<text>}` macro shows how to define new lines using an
  icon as first and some text as second argument. Behind the scenes, this
  command is actually used to define the other convenience commands in the above
  example.

If you don't like the default style of the "personal information table", you
can define your own via

```latex
\begin{icontable}[<arraystretch=1>]{<width 1st column>}{<space between columns>}
  \personal{<icon>}{<text>}
  \social{<icon>}{<url>}{<text>}
\end{icontable}
```

where the width of the 1st column will also determine the size of all icons in
this column, since icons are scaled to maximum width of their cell. For visual
purposes, you can fine-tune the space between icons and corresponding text with
the 2nd mandatory argument. The optional argument determines the spacing
between table lines, which is only important for small icon heights (i.e. small
1st columns).

- `\personal` takes an icon and a text. The icon is passed to
  `\circleicon{<icon>}`, which draws a circle filled with `maincolor` around
  the icon symbol. The symbol itself appears white.
- `\social` takes an icon and url + text. `Text` will be hyperlinked to `url`.
  In case `url` is empty, your LaTeX compiler will throw a harmless warning
  about "Suppressing link with empty target" and text will not be hyperlinked.
  The icon itself is passed to `\socialicon{<icon>}`, which simply resizes
  the icon symbol and draws it in `maincolor`. This version is the preferred
  one for social network icons (see example).

The default "personal information table" uses

```latex
\begin{icontable}[1.6]{1.7em}{0.4em}
  \personal{<icon>}{<text>}
\end{icontable}
```

### Further Sidebar Style Elements

- Section heading

  ```latex
  \profilesection{<section title>}
  ```

- Simple skill containing only an icon and some text and with optional
  indentation

  ```latex
  \skill[<indent>]{<icon>}{<text>}
  ```

- Pointskill consisting of an icon, text, the number of points and optionally
  the maximum possible number (default: 5).
  Some examples:

  ```latex
  \pointskill{<icon>}{<text>}{<points>}
  ```

  creates a skill using a Font Awesome or Academicons icon with some text and a
  ranking of
  `<points>` out of 5 points.

  ```latex
  \pointskill{<icon>}{<text>}{<points>}[<maxnum>]
  ```

  creates a skill using a Font Awesome or Academicons icon with some text and a
  ranking of `<points>` out of `<maxnum>` possible points.

  ```latex
  \pointskill{\flag{DE.png}}{German}{5}
  ```

  creates a language skill using a flag-icon, which has to be indicated using
  the `\flag` command in order to inform the class that the icon should not be
  colored using `\maincolor`.

- Barskill consisting of an optional height argument as well as a mandatory
  icon, text and percentage of how far the skillbar should be filled

  ```latex
  \barskill[<height>]{<icon>}{<text>}{<percentage>}
  ```

- "About me" text

  ```latex
  \aboutme{<text spanning multiple lines>}
  ```

- Rounded and colored label for e.g. charts and other graphics

  ```latex
  \chartlabel{<text>}
  ```

- Wheel chart

  ```latex
  \wheelchart{<outer radius>}{<inner radius>}{%
    <percentage>/<spacing>/<color>/<text>,
    <percentage>/<spacing>/<color>/<text>
  }
  ```

  - Percentages should add up to 100

- Memberships

  ```latex
  \begin{memberships}[<separation>=1em]
    \membership[<iconwidth>=4em]{<logo>}{<text>}
    \membership[<iconwidth>=4em]{<logo>}{<text>}
    \membership[<iconwidth>=4em]{<logo>}{<text>}
  \end{memberships}
  ```

  - Width of the 1st column containing the icons is equal to the width of the
    largest icon such that all text entries in the 2nd column are aligned.

- Social Networks
  ```latex
  \begin{socialnetwork}[<separation>=1em]
    \social{<icon>}{<url>}{<text>}
    \social{<icon>}{<url>}{<text>}
    \social{<icon>}{<url>}{<text>}
  \end{socialnetwork}
  ```
  - Another icon style that could be used for e.g. social network icons from
    Academicons, but is working for FontAwesome icons as well.
  - `text` will be hyperlinked to `url`.
  - `text` may be formatted as preferred like usual via e.g. `\texttt{}` etc.

### Body

The right part of the CV containing tables for sth. like "working experience"
has to be defined within the `document` environment.

To prevent unwanted line breaks in dates, the width of the first column in the
body can be adjusted via the `datecolwidth` class option.

- Section and subsection headings

  ```latex
  \cvsection
  \cvsubsection
  ```

- CV items should be enclosed by `cvtable`, independent of the item type.
  Possible types are:

  ```latex
  \begin{cvtable}[<arraystretch>=1]
    \cvitem{<dates>}{<title>}{<location>}{<description>}
    \cvitem{<dates>}{<title>}{<location>}{}
    \cvitemshort{<key>}{<description>}
    \cvpubitem{<title>}{<author>}{<journal>}{<year>}
  \end{cvtable}
  ```

  - `cvitem` including a description will make the title bold, left-align the
    date, right-align the location and put the description indented on the next
    line. The description itself will be in `itemtextcolor` defined in the
    [class options](#class-options).
  - `cvitem` missing a description will add a one-line item in the style of the
    former one but with a "normal" title instead of a bold one.
  - `cvitemshort` left-aligns `<key>` followed by its description.
  - `cvpubitem` adds an entry with left-aligned year/date, bold title on same
    line followed by italic author and normal text journal, each on its own
    line.
  - `<arraystretch>` modifies the spacing between items of `cvtable`. For
    tables of `cvitem`, you should use at least 1.5, for `cvitemshort` and
    `cvitem` without description, the default value is sufficient.

- Coloring
  `cvsection`, `cvsubsection` and description text colors can be defined as
  described in [class options](#class-options).

- Name and job title combination with proper spacing, font and color

  ```latex
  \nameandjob
  ```

- Finalizing the CV with a place, date and signature as common practice in e.g.
  Germany is done via
  ```latex
  \cvsignature
  ```

### Font Configuration

- Change the default font either by loading the corresponding package, e.g. for
  google noto

  ```latex
  \usepackage[sfdefault]{noto} % use noto google font
  ```

  or by using XeLaTeX's option to load local fonts directly via fontspec

  ```latex
  \usepackage[quiet]{fontspec}
  \newfontfamily\headingfont[Path = fonts/]{segoeuib.ttf}
  ```

- When working on multi-language documents, I highly advise against the usage
  of pdfLaTeX. Since I have only little experience with LuaLaTeX (but will
  probably switch to the latter soon), I can only provide instructions for
  XeLaTeX for now. There you first need to load the `polyglossia` package and
  set fonts for each language separately. For latin-based documents with e.g.
  some arabic text snippets then use

  ```latex
  \usepackage{polyglossia}
  \newfontfamily\arabicfont[Script=Arabic]{Amiri}
  \setdefaultlanguage{english}
  \setotherlanguage{arabic}
  % typeset arabic snippets in body text with either of
  \textarabic{...}
  \begin{Arabic}...\end{Arabic}
  ```

  whereas for non-latin-based documents you can use something like

  ```latex
  \usepackage{polyglossia}
  \setmainfont{Amiri}
  \newfontfamily\englishfont{Clear Sans}
  \setdefaultlanguage{arabic}
  \setotherlanguage{english}
  % typeset english snippets in body text with either of
  \textenglish{...}
  \begin{english}...\end{english}
  ```

  For persian languages (farsi), the following should work according to
  [this answer](https://tex.stackexchange.com/a/238245):

  ```latex
  \newfontfamily\farsifont[Script=Arabic,Scale=10,Contextuals=Swash]{IranNastaliq}
  ```

  Depending on what font style is your default, you need to use `\arabicfontfs`
  (sans serif) or `\arabicfonttt` (monospace) instead of `\arabicfont`.

  NOTE: Setting a RTL-font as main font will also flip other parts of the
  CV automatically. While this seems to be no problem for most parts as far as
  I can tell (I'm not used to RTL at all), it does break some of the skill
  commands, notably `\pointskill` and `\membership` and leads to some spacing
  issues. Anyways, for RTL you probably want to use the
  `sidebarplacement=right` feature as well.

- TODO: LuaLaTeX + babel settings

- You need to install fonts like Amiri and Clear Sans manually when
  loading them via fontspec. This is not necessary for mono-language documents
  where you can simply switch fonts like shown in the first example by using
  the respective LaTeX packages directly.

- If you are looking for a specific icon, say LinkedIn, you should first search
  the [FontAwesome gallery](https://fontawesome.com/icons?d=gallery) for its
  name, e.g. `linkedin-in` and then find the corresponding LaTeX code in the
  [fontawesome5 package](https://ftp.gwdg.de/pub/ctan/fonts/fontawesome5/doc/fontawesome5.pdf),
  which is in this case `\faLinkedinIn`.

- If you want to increase the line spacing globally, use

  ```latex
  \usepackage{setspace}
  \setstretch{1.1}
  ```

  instead of the `arraystretch` modifier. Note, that this will also affect the
  sidebar content.

- If you want to change the base font size, use the 'article' class options
  like `12pt` for all body elements and the paragraphs in the sidebar. Sidebar
  section titles can be changed via the [class option](#class-options)
  `sidesectionsize`. For name and job title font sizes you have to
  redefine the respective commands as explained [here](#sidebar).

## Example

![](pics/template-0.jpg)
![](pics/template-1.jpg)


================================================
FILE: fortysecondscv.cls
================================================
% FortySecondsCV LaTeX class
% SPDX-License-Identifier: BSD-Source-Code
%
% Please visit https://github.com/PandaScience/FortySecondsCV for the most
% recent version! For bugs or feature requests, please open a new issue on
% github.
%
% Contributors:
% https://github.com/PandaScience/FortySecondsCV/graphs/contributors
%
% Attributions
% ------------
% * fortysecondscv is based on the twentysecondcv class by Carmine Spagnuolo
%   (cspagnuolo@unisa.it), released under the MIT license and available under
%   https://github.com/spagnuolocarmine/TwentySecondsCurriculumVitae-LaTex
% * further attributions are indicated immediately before corresponding code


%-------------------------------------------------------------------------------
%                           CLASS NAME AND VERSION
%-------------------------------------------------------------------------------
\NeedsTeXFormat{LaTeX2e}
\ProvidesClass{fortysecondscv}[2020/10/19 CV class]


%-------------------------------------------------------------------------------
%                            PROCESS CLASS OPTIONS
%-------------------------------------------------------------------------------
%% first load all packages absolutely required to parse class options
% for easy color definitions; provides \definecolor; load before background pkg
\RequirePackage[dvipsnames, svgnames, x11names]{xcolor}
% for positioning text within the side column | use showboxes for visible frame
\RequirePackage[absolute,overlay]{textpos}
% provides key-value class options via \DeclareOptionX
\RequirePackage{xkeyval}
% provides \ifnumgreater{<int expr.>}{<int expr.>}{<true>}{<false>},
% \apptocmd{<command>}{<code>}{<success>}{<failure>} and \newtoggle{<name>}
\RequirePackage{etoolbox}
% provides basic conditional expressions
\RequirePackage{ifthen}
% enable simple math like +/- etc. on lengths
\RequirePackage{calc}
% change page margins
\RequirePackage[
	nohead,
	nofoot,
	nomarginpar,
]{geometry}

% pre-define some colors the user can choose from
\definecolor{cvblue}{HTML}{0E5484}
\definecolor{cvgreen}{HTML}{007170}
\definecolor{cvred}{HTML}{8B0000}
\definecolor{cvsidecolor}{HTML}{E7E7E7}
\definecolor{cvsectioncolor}{HTML}{0395DE}
\definecolor{cvsubsectioncolor}{HTML}{4D4D4D}
% set default values
\colorlet{maincolor}{cvblue}
\colorlet{sidecolor}{cvsidecolor}
\colorlet{sidetextcolor}{black}
\colorlet{sectioncolor}{cvsectioncolor}
\colorlet{subsectioncolor}{cvsubsectioncolor}
\colorlet{itemtextcolor}{black!90}
% colors for document body (right column)
% let user define main color
\DeclareOptionX{maincolor}{\colorlet{maincolor}{#1}}
\DeclareOptionX{sidecolor}{\colorlet{sidecolor}{#1}}
\DeclareOptionX{sidetextcolor}{\colorlet{sidetextcolor}{#1}}
\DeclareOptionX{sectioncolor}{\colorlet{sectioncolor}{#1}}
\DeclareOptionX{subsectioncolor}{\colorlet{subsectioncolor}{#1}}
\DeclareOptionX{itemtextcolor}{\colorlet{itemtextcolor}{#1}}

% set page margins
\newlength\sidebarwidth%
\newlength\topbottommargin%
\newlength\leftrightmargin%
\newlength\sidebartextwidth
% default values
\setlength{\sidebarwidth}{0.34\paperwidth}
\setlength{\topbottommargin}{0.02\paperheight}
\setlength{\leftrightmargin}{0.02\paperwidth}
% user overwrites
\DeclareOptionX{sidebarwidth}{\setlength{\sidebarwidth}{#1}}
\DeclareOptionX{topbottommargin}{\setlength{\topbottommargin}{#1}}
\DeclareOptionX{leftrightmargin}{\setlength{\leftrightmargin}{#1}}

% profile picture settings
\newlength\profilepicsize%
\setlength{\profilepicsize}{0.7\sidebarwidth}
\DeclareOptionX{profilepicsize}{\setlength{\profilepicsize}{#1}}
\newlength\profilepicborderwidth%
\setlength{\profilepicborderwidth}{3.5pt}
\DeclareOptionX{profilepicborderwidth}{\setlength{\profilepicborderwidth}{#1}}
\newcommand*{\profilepicstyle}{}
\DeclareOptionX{profilepicstyle}{\renewcommand{\profilepicstyle}{#1}}
\newcommand*{\profilepiczoom}{}
\DeclareOptionX{profilepiczoom}{\renewcommand{\profilepiczoom}{#1}}
\newlength\profilepicxshift
\setlength{\profilepicxshift}{0mm}
\DeclareOptionX{profilepicxshift}{\setlength{\profilepicxshift}{#1}}
\newlength\profilepicyshift
\setlength{\profilepicyshift}{0mm}
\DeclareOptionX{profilepicyshift}{\setlength{\profilepicyshift}{#1}}
\newlength\profilepicrounding
\setlength{\profilepicrounding}{0.15\sidebarwidth}
\DeclareOptionX{profilepicrounding}{\setlength{\profilepicrounding}{#1}}

% sidebar settings
\newcommand*{\sidebarplacement}{}
\DeclareOptionX{sidebarplacement}{\renewcommand{\sidebarplacement}{#1}}
\newcommand*{\sidesectionsize}{\huge}
\DeclareOptionX{sidesectionsize}{%
	\expandafter\renewcommand{\sidesectionsize}{\csname #1\endcsname}%
}

% show front sidebar on all pages
\newtoggle{tsamesidebar}
\togglefalse{tsamesidebar}
\DeclareOptionX{frontsidebaronallpages}{
	\toggletrue{tsamesidebar}
	\AddToHook{shipout/before}{\makefrontsidebar}
}

% logo settings
\newlength\logowidth%
\setlength{\logowidth}{\profilepicsize}
\DeclareOptionX{logowidth}{\setlength{\logowidth}{#1}}
\newlength\logospace%
\DeclareOptionX{logospace}{\setlength{\logospace}{#1}}
\newcommand*{\logoposition}{}
\DeclareOptionX{logoposition}{\renewcommand{\logoposition}{#1}}

% show sidebar and page margins
\newtoggle{tshowframes}
\togglefalse{tshowframes}
\DeclareOptionX{showframes}{
	\geometry{showframe}
	\TPoptions{showboxes=true}
	\toggletrue{tshowframes}
	% adding \hline in \newenvironment directly doesn't work, so do it here...
	\AtBeginDocument{\apptocmd{\personaldata}{\hline}{}{}}
}

% name and job position: 'after' (default) picture, 'before', or hidden (any other value)
\newcommand*{\nameandjobposition}{after}
\DeclareOptionX{nameandjobposition}{\renewcommand{\nameandjobposition}{#1}}

% draw vertical guideline
\newcommand{\plotvline}{}
\DeclareOptionX{vline}{%
	% must be defined here as macro, b/c tikz won't expand absolute length in
	% \backgroundsetup -- BUG?
	\renewcommand{\plotvline}{%
		\draw [thick, red, opacity=0.7]
		(\leftrightmargin + #1, 0) -- (\leftrightmargin + #1, -\paperheight);
	}
}

% date column width
\newlength\datecolwidth
\setlength{\datecolwidth}{0.17\textwidth}
\DeclareOptionX{datecolwidth}{\setlength{\datecolwidth}{#1}}

% pass further options to base class and load it
\DeclareOptionX*{\PassOptionsToClass{\CurrentOption}{article}}
\ProcessOptionsX\relax
\LoadClass{article}

% compute "inner" margin of sidebar automatically;
% must come after \sidebarwidth and \leftrightmargin possibly changed by user
\setlength{\sidebartextwidth}{\sidebarwidth - 2\leftrightmargin}

% let geometry package perform the changes;
% must come after loading the base class to prevent overwriting
\ifthenelse{\equal{\sidebarplacement}{right}}{%
	\geometry{
		top=\topbottommargin,
		bottom=\topbottommargin,
		right=\sidebarwidth + \leftrightmargin,
		left=\leftrightmargin,
	}
}{% else
	\geometry{
		top=\topbottommargin,
		bottom=\topbottommargin,
		left=\sidebarwidth + \leftrightmargin,
		right=\leftrightmargin,
	}
}

%-------------------------------------------------------------------------------
%                              REQUIRED PACKAGES
%-------------------------------------------------------------------------------
% use as workaround for spacing problem when TikZ picture is not in paragraph;
% details: https://tex.stackexchange.com/a/435790
\RequirePackage[texcoord]{eso-pic}

% for easy section style definitions
\RequirePackage{titlesec}

% loads graphicx, provides align=c option for vertical alignment w.r.t. text
\RequirePackage{graphbox}

% provides X column type for automatic length calculations
\RequirePackage{tabularx}
\RequirePackage{longtable, tabu}

% take care of compiler-specific packages
\RequirePackage{ifluatex}
\RequirePackage{ifxetex}
\newif\ifxetexorluatex
\ifxetex
	\xetexorluatextrue
\else
	\ifluatex
		\xetexorluatextrue
	\else
		\xetexorluatexfalse
	\fi
\fi

% pictures, icons and drawings
\ifxetexorluatex
	\RequirePackage{academicons}
\fi
\RequirePackage{fontawesome5}
\RequirePackage{tikz}
\usetikzlibrary{arrows, backgrounds}

% provides \xrfill for horizontal rules
\RequirePackage{xhfill}

% enable multiple optional arguments in macros
\RequirePackage{xparse}

% enable links
\RequirePackage[hidelinks]{hyperref}


%-------------------------------------------------------------------------------
%                          DERIVED COLOR DEFINITIONS
%-------------------------------------------------------------------------------
% profile section color (sidebar/left column)
\colorlet{pseccolor}{maincolor!90}
% color used for all icon arguments
\colorlet{iconcolor}{maincolor!90}

% color definitions for TikZ drawings
\colorlet{wheelchartlabelcolor}{black}
\colorlet{wheeltextcolor}{black!80!white}
% color of unfilled skill points / bar / chart label
\colorlet{skillbg}{black!25}


%-------------------------------------------------------------------------------
%                      GLOBAL LAYOUT AND HEADINGS STYLE
%-------------------------------------------------------------------------------
% remove headers and footers
\pagestyle{empty}

% globally disable paragraph indentation
\setlength{\parindent}{0pt}

% set space between paragraphs
% \setlength{\parskip}{1ex}

% creates a rule after some text using remaining line width
% usage: \xrfill[<raise>]{<width>}
\newcommand*{\sectionline}[1]{#1~\xrfill[.5ex]{1pt}[pseccolor]}

% section style for cv table headings in right column
% \titleformat{<command>}[<shape>]{<format>}{<label>}{<sep>}{<before>}[<after>]
\newcommand*{\cvsection}[1]{\section*{#1}}
\titleformat{\section}%
	{\color{sectioncolor}\normalfont\bfseries\LARGE}{}{0pt}{}
\titlespacing*{\section}{0pt}{1.5ex}{1ex}

% grey subsection style for right column
\newcommand*{\cvsubsection}[1]{\subsection*{#1}}
\titleformat{\subsection}%
	{\color{subsectioncolor}\normalfont\large}{}{0pt}{}

% for compatibility with older versions
\newcommand*{\profilesection}[1]{\subsubsection*{#1}}
% abuse subsubsection as sidesection in left column
\newcommand*{\sidesection}[1]{\subsubsection*{#1}}
\titleformat{\subsubsection}%
	{\color{pseccolor}\normalfont\sidesectionsize}{}{0pt}%
	{\color{pseccolor}\sectionline}%
% set spaces before and after sidesections: <left><before><after>
% "starred version kills the indentation of the paragraph following the title"
\titlespacing*{\subsubsection}{0pt}{1ex}{1ex}


%-------------------------------------------------------------------------------
%                              SIDEBAR ELEMENTS
%-------------------------------------------------------------------------------
% text in user-specific color
\newcommand{\sidetext}[1]{\textcolor{sidetextcolor}{#1}}

% style for name
\newcommand*{\cvnameformat}{\Huge\color{maincolor}}

% style for job title
\newcommand*{\cvjobtitleformat}{\Large\color{black!80}}

% mandatory personal information
\newcommand*{\cvname}[1]{\renewcommand{\cvname}{#1}}
\newcommand*{\cvjobtitle}[1]{\renewcommand{\cvjobtitle}{#1}}

% profile picture (optional)
\newcommand{\plotprofilepicture}{}
\newcommand*{\cvprofilepic}[1]{
	\renewcommand{\cvprofilepic}{#1}

	\ifthenelse{\equal{\profilepicstyle}{profilecircle}}{
		\renewcommand{\plotprofilepicture}{\profilecircle}
	}{
		\renewcommand{\plotprofilepicture}{\profileroundedcorners}
	}
}

% additional logo (optional)
\newcommand{\plotlogobefore}{}
\newcommand{\plotlogoafter}{}
\newcommand*{\cvlogopic}[1]{%
	% default = before; if any other (incl. 'after') --> after
	\ifthenelse{\equal{\logoposition}{before}}{%
		\renewcommand{\plotlogobefore}{%
			\begin{figure}\centering%
				\includegraphics[align=c, width=\logowidth]{#1}%
			\end{figure}
			\vspace*{\logospace}%
		}%
	}{%
		\renewcommand{\plotlogoafter}{%
			\vspace*{\logospace}%
			\begin{figure}\centering%
				\includegraphics[align=c, width=\logowidth]{#1}%
			\end{figure}
		}%
	}
}

% social network item; \social{<icon>}{<url>}{<text>}
\newcommand*{\social}[3]{%
	\socialicon{#1} & \href{#2}{\sidetext{#3}}\\%
}

% personal information item; \personal{<icon>}{<text>}
\newcommand*{\personal}[2]{%
	\circleicon{#1} & {\sidetext{#2}}\\%
}

% other personal information as macro that can be used later. Usage:
% \cvcustomdata{<Icon>}{<Text>}
% icon can be taken from FontAwesome or Academicon for example
\newcommand{\personaldata}{}
\newcommand*{\cvcustomdata}[2]{%
	\apptocmd{\personaldata}{\personal{#1}{#2}}{}{}%
}

% useful shortcuts
% NOTE: we use href instead of url so user can decide textformatting since url
% automatically uses \texttt{} as format for the url
\newcommand*{\cvbirthday}[1]{\cvcustomdata{\faUser}{#1}}
\newcommand*{\cvaddress}[1]{\cvcustomdata{\faEnvelope}{#1}}
\newcommand*{\cvphone}[1]{\cvcustomdata{\faPhone}{\href{tel:#1}{#1}}}
\newcommand*{\cvsite}[1]{\cvcustomdata{\faGlobe}{\href{#1}{#1}}}
\newcommand*{\cvmail}[1]{\cvcustomdata{\faAt}{\href{mailto:#1}{#1}}}
\newcommand*{\cvkey}[2]{\cvcustomdata{\faKey}{%
	\href{https://keyserver.ubuntu.com/pks/lookup?search=#2\&op=vindex\&fingerprint=on}{#1}%
}}
\newcommand*{\cvcitizenship}[1]{\cvcustomdata{\faFlag}{#1}}
\newcommand*{\cvgithub}[1]{\cvcustomdata{\faGithub}{\href{https://github.com/#1}{#1}}}
\newcommand*{\cvlinkedin}[2]{\cvcustomdata{\faLinkedin}{\href{https://www.linkedin.com/in/#1}{#2}}}

% TODO find a cleaner solution for consistent spacing
\newcommand{\nameandjob}{%
	{\cvnameformat\cvname}\par%
	\setlength{\parskip}{2ex}
	{\cvjobtitleformat\cvjobtitle}\par%
	\setlength{\parskip}{1ex}
}

\newcommand{\nameandjobbeforepic}{%
	\ifthenelse{\equal{\nameandjobposition}{before}}{%
		\nameandjob
		\vspace{1ex}
	}{}
}
\newcommand{\nameandjobafterpic}{%
	\ifthenelse{\equal{\nameandjobposition}{after}}{%
		\vspace{1ex}
		\nameandjob
	}{}
}

\newcommand{\profileroundedcorners}{%
	\begin{figure}\centering
		% see TikZ/pgf v3.1.1 manual §2.11 (clipping), §14.5 (rounded corners),
		% §12 (scopes), §13.2 (coordinate systems)
		\begin{tikzpicture}[x=\profilepicsize, y=\profilepicsize]
			\begin{scope}
				\path[clip]
					(0, 0) [sharp corners] --
					(0, 1) [rounded corners=\profilepicrounding] --
					(1, 1) [sharp corners] --
					(1, 0) [rounded corners=\profilepicrounding] -- cycle;
				\node[anchor=center, inner sep=0pt, xshift=\profilepicxshift,
						yshift=\profilepicyshift] (profilepic) at (0.5, 0.5)
					{\includegraphics[width=\profilepiczoom\profilepicsize]
						{\cvprofilepic}};
			\end{scope}
			\ifdim \profilepicborderwidth > 0pt
				\begin{scope}
					\draw[line width=\profilepicborderwidth, color=iconcolor]
					(0, 0) [sharp corners] --
					(0, 1) [rounded corners=\profilepicrounding] --
					(1, 1) [sharp corners] --
					(1, 0) [rounded corners=\profilepicrounding] -- cycle;
				\end{scope}
			\fi
		\end{tikzpicture}
	\end{figure}
}

\newcommand{\profilecircle}{%
	\begin{figure}\centering
		\begin{tikzpicture}[x=\profilepicsize, y=\profilepicsize]
			\begin{scope}
				\clip (0, 0) circle (0.5);
				\node[anchor=center, inner sep=0pt, outer sep=0pt,
						xshift=\profilepicxshift, yshift=\profilepicyshift]
					(profilepic) at (0,0) {
				\includegraphics[width=\profilepiczoom\profilepicsize]
					{\cvprofilepic}};
			\end{scope}
			\ifdim \profilepicborderwidth > 0pt
				\begin{scope}
					\draw[line width=\profilepicborderwidth, color=iconcolor]
						(0, 0) circle (0.5\profilepicsize);
				\end{scope}
			\fi
		\end{tikzpicture}
	\end{figure}
}

% table with 2 columns for icons and text
% \icontable{<width 1st column>}{<space between columns>}{<arraystretch>}
\newenvironment{icontable}[3][1]%
{%
	\renewcommand{\arraystretch}{#1}% increase linespacing in tables; default=1
	\iftoggle{tshowframes}{%
		% https://tex.stackexchange.com/a/42331
		\tabularx{\sidebartextwidth}{|m{#2} | @{\hskip #3} | X|} \hline%
	}{%
		\tabularx{\sidebartextwidth}{m{#2} @{\hskip #3} X}%
	}
}{%
	\endtabularx%
}

% icon style for personal information
\newcommand*\circleicon[1]{%
	\tikz[baseline = (char.base)]{%
		\node[%
			shape=circle,%
			draw,%
			inner sep=1pt,%
			fill=iconcolor,%
			maincolor,%
			text=white,%
			minimum size=\hsize%
		] (char) {#1};%
	}%
}

% icon style for social network
\newcommand*{\socialicon}[1]{%
	\resizebox{\hsize}{!}{\textcolor{iconcolor}{#1}}%
}

% make sure about me text stays in textbox frame
\newcommand{\aboutme}[1]{\parbox[b]{\linewidth}{\sidetext{#1}}}

% uniform icon style for all skill icons, e.g. flags or fontawesome icons
\newcommand{\cvicon}[1]{\makebox[1em]{\color{iconcolor} #1}}
\newcommand{\flag}[1]{\includegraphics[align=c, width=1em]{#1}}

% \pointskill[<indent>]{<icon>}{<description>}{<points>}[<maxpoints>] creates
% | [indent] [icon]  description  \hfill  ● ● ● ○ ○ |
% -- inspired by arravc.cls by LianTze Lim: https://github.com/liantze/AltaCV
\NewDocumentCommand{\pointskill}{ O{0em} m m m O{5} }{%
	\hspace{#1} \cvicon{#2} ~ \sidetext{#3} \hfill%
	\foreach \x in {1,...,#5}{%
		\space%
		{\ifnumgreater{\x}{#4}{\color{skillbg}}{\color{iconcolor}}% from etoolbox
		% don't use totalheight; see https://tex.stackexchange.com/a/41014
		\raisebox{0.5\height-0.4ex}{\scriptsize\faCircle}%
		}
	}\par%
}

\newcommand{\barskill}[4][1ex]{
	% remove 1pt in width to prevent overfull box warnings
	\begin{tikzpicture}[x=\sidebartextwidth-1pt, y=#1]
			\draw[fill, skillbg, rounded corners=0.25em]
				(0, 0) rectangle (1, 1);
			\draw[fill, iconcolor!70, rounded corners=0.25em]
				(0, 0) rectangle (#4/100, 1);
			\node[above right] at (0, 1) {\cvicon{#2} ~ \sidetext{#3}};
	\end{tikzpicture}
	\par
}

% \skill[<indent>]{<icon>}{<description>} creates in sidebar
% | [indent] [icon]  some longer skill description  |
\newcommand{\skill}[3][0em]{
	\hspace{#1} \cvicon{#2} ~ \parbox{\linewidth-#1-2.5em}{\sidetext{#3}}%
	\hfill \par%
}

% label for wheel charts
\newcommand{\chartlabel}[2][skillbg]{%
	\begin{tikzpicture}
	\node[
		fill=#1!25, % interior color
		anchor=base,
		draw=#1, % line color
		rounded corners,
		inner xsep=1ex, % distance from left/right border to text
		inner ysep=0.75ex, % distance top/bottom border to text
		text height=1.5ex, % align text vertically in box (at least as resulting
		text depth=.25ex   % effect)
	]{\sidetext{#2}};%
	\end{tikzpicture}
}


\newenvironment{sidebarminipage}%
	{\begin{minipage}{\sidebartextwidth}}%
	{\end{minipage}}%


\newenvironment{memberships}[1][1em]%
{%
	\iftoggle{tshowframes}{%
		\tabularx{\sidebartextwidth}{|l | @{\hskip #1} | X|} \hline%
	}{%
		\tabularx{\sidebartextwidth}{l @{\hskip #1} X}%
	}
}{%
	\endtabularx%
}%


\newcommand{\membership}[3][4em]{
	\includegraphics[align=c,width=#1]{#2} & \sidetext{#3} \\[3ex]
}

% adapted from https://tex.stackexchange.com/a/82729
\newcommand{\wheelchart}[4][-90]{%
	\def\outerradius{#2}%
	\def\innerradius{#3}%
	% Calculate total
	\pgfmathsetmacro{\totalnum}{0}%
	\foreach\value/\colour/\name in {#4} {%
		\pgfmathparse{\value+\totalnum}%
		\global\let\totalnum=\pgfmathresult%
	}%
	\begin{tikzpicture}

		% Calculate the thickness and the middle line of the wheel
		\pgfmathsetmacro{\wheelwidth}{\outerradius-\innerradius}
		\pgfmathsetmacro{\midradius}{(\outerradius+\innerradius)/2}

		% Rotate so we start from the top
		\begin{scope}[rotate=#1, on background layer]
		% Loop through each value set. \cumnum keeps track of where we are in the
		% wheel
		\pgfmathsetmacro{\cumnum}{0}
		\foreach \value/\width/\colour/\name in {#4} {
			\pgfmathsetmacro{\newcumnum}{\cumnum + \value/\totalnum*360}

			% Calculate the percent value
			\pgfmathsetmacro{\percentage}{\value/\totalnum*100}
			% Calculate the mid angle of the colour segments to place the labels
			\pgfmathsetmacro{\midangle}{-(\cumnum+\newcumnum)/2}

			% This is necessary for the labels to align nicely
			\pgfmathparse{
				(-\midangle>180?"west":"east")
			} \edef\textanchor{\pgfmathresult}
			\pgfmathparse{
				(-\midangle>180?"flush left":"flush right")
			} \edef\textalign{\pgfmathresult}
			\pgfmathsetmacro\labelshiftdir{1-2*(-\midangle<180)}

			% Draw the color segments. Somehow, the \midrow units got lost, so
			% we add 'pt' at the end. Not nice...
			\filldraw[draw=white,fill=\colour]
				(-\cumnum:\outerradius)
				arc (-\cumnum:-(\newcumnum):\outerradius)
				-- (-\newcumnum:\innerradius)
				arc (-\newcumnum:-(\cumnum):\innerradius)
				-- cycle;

			% Draw the data labels
			\draw [*-,thin,wheelchartlabelcolor] node [append after command={
				(\midangle:\midradius pt) --
				(\midangle:\outerradius + 1ex) --
				(\tikzlastnode)}] at (\midangle:\outerradius + 1ex) [
				xshift=\labelshiftdir*0.5cm,inner sep=1ex,
				outer sep=0pt,
				text width=\width,
				anchor=\textanchor,
				align=\textalign,
				font=\small,
				text=wheeltextcolor
			]{\name};
			% Set the old cumulated angle to the new value
			\global\let\cumnum=\newcumnum
		}
		\end{scope}
	\end{tikzpicture}\par
}

\newcommand{\cvsignature}{
	\vfill
	{\large\bfseries\color{maincolor!70}\today \hfill \cvname}
}


%-------------------------------------------------------------------------------
%                               SIDEBAR LAYOUT
%-------------------------------------------------------------------------------
% draw sidebar background on current page
\newcommand{\drawSidebarBG}{%
	\AddToShipoutPictureBG*{%
		\ifthenelse{\equal{\sidebarplacement}{right}}{%
			\begin{tikzpicture}[remember picture, overlay]
				\node at (current page.north east)[
					rectangle,
					fill=sidecolor,
					anchor=north east,
					minimum width=\sidebarwidth,
					minimum height=\paperheight,
				]{};%
				% plot vertical red guideline
				\plotvline%
			\end{tikzpicture}%
		}{% else
			\begin{tikzpicture}[remember picture, overlay]
				\node[
					rectangle,
					fill=sidecolor,
					anchor=north west,
					minimum width=\sidebarwidth,
					minimum height=\paperheight,
				]{};%
				% plot vertical red guideline
				\plotvline%
			\end{tikzpicture}%
		}%
	}%
}%

% use textpos to position textblock within TikZ background; we have to use
% the starred version for absolute values here, b/c we use \pagewidth directly
% instead of \setlength{\TPHorizModule}{<dimen>}, which seems to be "absolute"
% as opposed to "relative" - strange but true.
\newenvironment{sidebar}{%
	\drawSidebarBG%
	\ifthenelse{\equal{\sidebarplacement}{right}}{%
		\begin{textblock*}{\sidebartextwidth}%
			(\paperwidth - \sidebarwidth + \leftrightmargin, \topbottommargin)
	}{% else
		\begin{textblock*}{\sidebartextwidth}(\leftrightmargin, \topbottommargin)
	}%
}{%
	\end{textblock*}%
}

% provide user interface for easily adding new sections in side bars
% default: empty sidebar
\newcommand{\frontsidebar}{}
\newcommand{\backsidebar}{}
\newcommand{\addtofrontsidebar}[1]{\apptocmd{\frontsidebar}{#1}{}{}}
\newcommand{\addtobacksidebar}[1]{\apptocmd{\backsidebar}{#1}{}{}}

\newcommand{\makefrontsidebar}{%
	\begin{sidebar}
		% most sidebar commands end with \par; increase space between them
		\setlength{\parskip}{1ex}

		% name and job - when \nameandjobposition = 'before'
		\nameandjobbeforepic

		% optionally insert logo picture before profile
		\plotlogobefore

		% optionally insert profile picture
		\plotprofilepicture

		% optionally insert logo picture after profile
		\plotlogoafter

		% name and job - when \nameandjobposition = 'after'
		\nameandjobafterpic

		% personal information
		\vspace*{0.5em}
		\begin{icontable}[1.6]{1.7em}{0.4em}
			\personaldata
		\end{icontable}

		% user definitions
		\frontsidebar
	\end{sidebar}
}

\newcommand{\makebacksidebar}{%
	\begin{sidebar}
		% begin with name instead of picture
		\nameandjob

		% make sure there is no space at top, but after cvjob
		\setlength{\parskip}{1ex}

		% user definitions
		\backsidebar
	\end{sidebar}
}


%-------------------------------------------------------------------------------
%                              LIST ENVIRONMENTS
%-------------------------------------------------------------------------------
% reduce space between table columns to minimum
\setlength{\tabcolsep}{0pt}

% cv list environment --> table, left aligned, width=textwidth
% tabular starred version adds space to make table as wide as \textwidth here
\newenvironment{cvtable}[1][1]{%
	\renewcommand{\arraystretch}{#1}%
	% remove additional spacing before and after longtables
	\setlength{\LTpre}{0pt}
	\setlength{\LTpost}{0pt}
	\iftoggle{tshowframes}{%
		\begin{longtabu} to \textwidth {@{\extracolsep{\fill}}|l|l|}%
		\hline%
	}{%
		\begin{longtabu} to \textwidth {@{\extracolsep{\fill}}ll}%
	}
}{%
	\iftoggle{tshowframes}{%
		\hline%
		\end{longtabu}%
	}{%
		\end{longtabu}%
	}
}

% | <keyword>      <one-line description>            |
% use parbox if text needs to use multiple lines
\newcommand{\cvitemshort}[2]{%
	\parbox[t]{\datecolwidth}{\raggedright #1}
	& \parbox[t]{0.98\textwidth-\datecolwidth}{#2} \\}

% | <date>         <bold-title>  \hfill  <location>  |
% |                <longer description>              |
% or, if description is empty:
% | <date>         <title>       \hfill  <location>  |
\newcommand{\cvitem}[4]{%
	\parbox[t]{\datecolwidth}{\raggedright #1} &%
	\parbox[t]{0.98\textwidth-\datecolwidth}{%
		\if\relax\detokenize{#4}\relax%
			\parbox[t]{\linewidth-\widthof{\footnotesize #3}-1em}{\raggedright #2}%
			\hfill {\footnotesize#3}%
		\else%
			\parbox[t]{\linewidth-\widthof{\footnotesize #3}-1em}{\raggedright \textbf{#2}}%
			\hfill {\footnotesize#3} \\%
			\textcolor{itemtextcolor}{#4}%\vspace{\parsep}%
		\fi%
	}\\
}

% | <date>         <bold-title>  \par\hfill  <location>  |
% |                <longer description>              |
% or, if description is empty:
% | <date>         <title>       \par\hfill  <location>  |
\newcommand{\cvitempar}[4]{%
	\parbox[t]{\datecolwidth}{\raggedright #1} &%
	\parbox[t]{0.98\textwidth-\datecolwidth}{%
		\if\relax\detokenize{#4}\relax%
			\parbox[t]{\textwidth}{\raggedright #2}%
			\par\hfill {\footnotesize#3}%
		\else%
			\parbox[t]{\textwidth}{\raggedright \textbf{#2}}%
			\par\hfill {\footnotesize#3} \\%
			\textcolor{itemtextcolor}{#4}%\vspace{\parsep}%
		\fi%
	}\\
}

% publication item
% \cvpubitem{<title>}{<author>}{<journal>}{<year>} will produce
% | <year>         <bold title>                      |
% |                <italic author>                   |
% |                <journal>                         |
\newcommand{\cvpubitem}[4]{%
	\parbox[t]{\datecolwidth}{\raggedright #4} &
	\parbox[t]{0.98\textwidth-\datecolwidth}{%
		\textbf{#1} \par \textit{#2} \par #3 \vspace{\parsep}%
	}\\
}

% EOF - fortysecondscv.cls


================================================
FILE: template.tex
================================================
% FortySecondsCV LaTeX template
% SPDX-License-Identifier: BSD-Source-Code
%
% Please visit https://github.com/PandaScience/FortySecondsCV for the most
% recent version! For bugs or feature requests, please open a new issue on
% github.
%
% Contributors:
% https://github.com/PandaScience/FortySecondsCV/graphs/contributors
%
% Attributions
% ------------
% * fortysecondscv is based on the twentysecondcv class by Carmine Spagnuolo
%   (cspagnuolo@unisa.it), released under the MIT license and available under
%   https://github.com/spagnuolocarmine/TwentySecondsCurriculumVitae-LaTex
% * further attributions are indicated immediately before corresponding code


%-------------------------------------------------------------------------------
%                             ADDITIONAL PACKAGES
%-------------------------------------------------------------------------------
\documentclass[
	a4paper,
	% 9pt,
	% sidesectionsize=Large,
	% showframes,
	% vline=2.2em,
	% maincolor=cvgreen,
	% sidecolor=gray!50,
	% sidetextcolor=green,
	% sectioncolor=red,
	% subsectioncolor=orange,
	% itemtextcolor=black!80,
	% sidebarwidth=0.4\paperwidth,
	% topbottommargin=0.03\paperheight,
	% leftrightmargin=20pt,
	% profilepicsize=4.5cm,
	% profilepicborderwidth=3.5pt,
	% profilepicstyle=profilecircle,
	% profilepiczoom=1.0,
	% profilepicxshift=0mm,
	% profilepicyshift=0mm,
	% profilepicrounding=1.0cm,
	% logowidth=4.5cm,
	% logospace=5mm,
	% logoposition=before,
	% sidebarplacement=right,
	% frontsidebaronallpages, % omit any \makefrontsidebar or \makebacksidebar cmds!
	% datecolwidth=0.22\textwidth,
]{fortysecondscv}

% fine tune line spacing
% \usepackage{setspace}
% \setstretch{1.1}

% improve word spacing and hyphenation
\usepackage{microtype}
\usepackage{ragged2e}

% uncomment in case you don't want any hyphenation
% \usepackage[none]{hyphenat}

% take care of proper font encoding
\ifxetexorluatex
	\usepackage{fontspec}
	\defaultfontfeatures{Ligatures=TeX}
	% \newfontfamily\headingfont[Path=fonts/]{segoeuib.ttf} % use local font
\else
	\usepackage[utf8]{inputenc}
	\usepackage[T1]{fontenc}
\fi

% use a sans serif font as default
\usepackage[sfdefault]{ClearSans}
% \usepackage[sfdefault]{noto}

% multi-language CV XeLaTeX and polyglossia (should also work with LuaLaTeX)
% NOTE: breaks \pointskill, \membership and some spacings
% \ifxetexorluatex
% 	\usepackage{polyglossia}
% 	\newfontfamily\arabicfontsf[Script=Arabic,Scale=1.5]{Amiri}
% 	\newfontfamily\englishfontsf{Clear Sans}
% 	\setmainfont{Amiri}
% 	\setdefaultlanguage{arabic}
% 	\setotherlanguage{english}
% \fi

% enable mathematical syntax for some symbols like \varnothing
\usepackage{amssymb}

% bubble diagram configuration
\usepackage{smartdiagram}
\smartdiagramset{
	% default font size is \large, so adjust to harmonize with sidebar layout
	bubble center node font = \footnotesize,
	bubble node font = \footnotesize,
	% default: 4cm/2.5cm; make minimum diameter relative to sidebar size
	bubble center node size = 0.4\sidebartextwidth,
	bubble node size = 0.25\sidebartextwidth,
	distance center/other bubbles = 1.5em,
	% set center bubble color
	bubble center node color = maincolor!70,
	% define the list of colors usable in the diagram
	set color list = {maincolor!10, maincolor!40,
	maincolor!20, maincolor!60, maincolor!35},
	% sets the opacity at which the bubbles are shown
	bubble fill opacity = 0.8,
}

%-------------------------------------------------------------------------------
%                            PERSONAL INFORMATION
%-------------------------------------------------------------------------------
%% mandatory information
% your name
\cvname{Panda Bear}
% job title/career
\cvjobtitle{Panda Scientist,\\[0.2em] Panda of the Year}

%% optional information
% profile picture
\cvprofilepic{pics/profile.png}
% logo picture
\cvlogopic{pics/logo_txt.png}

% NOTE: ordering in sidebar will mimic the following order
% date of birth
\cvbirthday{\today}
% short address/location, use \newline if more than 1 line is required
\cvaddress{Park Ave.~1, 555 555 B-Woods}
% phone number
\cvphone{+86 555 555 555}
% personal website
\cvsite{https://pandascience.net}
% email address
\cvmail{panda@bamboo.cn}
% pgp key
\cvkey{4096R/FF00FF00}{0xAABBCCDDFF00FF00}
% any other custom entry
\cvcustomdata{\faFlag}{Chinese}

%-------------------------------------------------------------------------------
%                              SIDEBAR 1st PAGE
%-------------------------------------------------------------------------------
% add more profile sections to sidebar on first page
\addtofrontsidebar{
	% include gosquare national flags from https://github.com/gosquared/flags;
	% naming according to ISO 3166-1 alpha-2 country codes
	\graphicspath{{pics/gosquared-flags/flags/flags-iso/shiny/64}}

	% social network accounts incl. proper hyperlinks
	\sidesection{Social Network}
		\begin{icontable}{2.5em}{1em}
			\social{\faLeaf}
				{https://de.overleaf.com/latex/templates/forty-seconds-cv/pztcktmyngsk}
				{Overleaf Template Link}
			\social{\faGithub}
				{https://github.com/PandaScience/FortySecondsCV}
				{Github Project Page Link}
		\end{icontable}

	\sidesection{Languages}
		\pointskill{\flag{CN.png}}{Chinese}{5}
		\pointskill{\flag{DE.png}}{German}{3}
	\pointskill{\flag{GB.png}}{English}{3}
	\pointskill{\flag{FR.png}}{French}{3}

	\sidesection{Hard Skills}
		\skill{\faBalanceScale}{Sleeping almost all day}
		\skill{\faSitemap}{Eating a lot of bamboo sprouts}
		\skill{\faGraduationCap}{Relaxing rest of the day}

	\sidesection{Soft Skills}
		\pointskill{\faHome}{Looking Cute}{4}[4]
			\skill[1.8em]{\faCompress}{No need to specify further}
		\pointskill{\faChild}{Chillin' hard}{3}[4]
			\skill[1.8em]{\faCompress}{On a tree}
			\skill[1.8em]{\faCompress}{In the grass}
}


%-------------------------------------------------------------------------------
%                              SIDEBAR 2nd PAGE
%-------------------------------------------------------------------------------
\definecolor{pastelgreen}{HTML}{D7ECD9}
\definecolor{pastelpurple}{HTML}{D5D6EA}
\definecolor{pastelorange}{HTML}{F5D5CB}
\definecolor{pastelyellow}{HTML}{F6F6EB}

\addtobacksidebar{
	\sidesection{About Me}
	\aboutme{
		The giant panda is a terrestrial animal and primarily spends its life
		roaming and feeding in the bamboo forests of the Qinling Mountains and in
		the hilly province of Sichuan.
	}

	\sidesection{Diagrams}
	\begin{sidebarminipage}
		\chartlabel[pastelgreen]{Bubble}
		\chartlabel[pastelgreen]{Diagrams}
		\chartlabel[pastelpurple]{with}
		\chartlabel[pastelpurple]{proper}
		\chartlabel[pastelorange]{overflow}
		\chartlabel[pastelorange]{protection}
		\chartlabel[pastelyellow]{for}
		\chartlabel[pastelyellow]{labels}
	\end{sidebarminipage}

	\begin{figure}\centering
		\smartdiagram[bubble diagram]{
			\textcolor{white}{\textbf{Being a}} \\
			\textcolor{white}{\textbf{Panda}}, % center bubble
			\textcolor{black!90}{Eating},
			\textcolor{black!90}{Sleeping},
			\textcolor{black!90}{Rolling},
			\textcolor{black!90}{Playing},
			\textcolor{black!90}{Chilling}
		}
	\end{figure}

	\chartlabel{Wheel Chart}

	\wheelchart{3.7em}{2em}{%
	20/3em/maincolor!50/Chill,
	15/3em/maincolor!15/Play,
	30/4em/maincolor!40/Sleep,
	20/3em/maincolor!20/Eat
	}

	\sidesection{Barskills}
	\barskill[1ex]{\faSkyatlas}{Wearing asian rice hats}{60}
	\barskill[2ex]{\faImage}{Playing Chess}{30}
	\barskill[3ex]{\faMusic}{Playing the bamboo flute}{50}

	\sidesection{Memberships}
	\begin{memberships}
		\membership[4em]{pics/logo.png}{PandaScience.net}
		\membership[4em]{pics/logo.png}{Some longer text spanning over more than
			only one line}
	\end{memberships}
}


%-------------------------------------------------------------------------------
%                         TABLE ENTRIES RIGHT COLUMN
%-------------------------------------------------------------------------------
\begin{document}

\makefrontsidebar

\cvsection{Working Experience}
\begin{cvtable}[3]
	\cvitem{currently}{CEO The Panda Way}{Start Up}{Chief executive officer, Head
		developer and yoga ambassador of 'The Panda Way' - A company from pandas
		for pandas.}
	\cvitem{05/2015 -- 08/2018}{Panda Scientist}{Bamboo University}{
		Reasearching the impact of adequate bamboo nutrition compared to
		conventional feeding methods.}
	\cvitem{2010 -- 2015}{Bamboo Broker}{Stock Exchange}{Continuously achieving
		better bamboo bangs for the buck.}
\end{cvtable}


\cvsection{Education}
\cvsubsection{Postgraduate Training}
\begin{cvtable}[1.5]
	\cvitem{2009 -- 2010}{Post-Doc Panda Studies}{Panda Academy}
		{In-depth studies on the impact of bamboo nutrition for young pandas and
		its relation to relaxing, sleeping and snoozing parts of the day.}
	\cvitem{2008 -- 2009}{Research Stay Europe}{European Panda Labs}
		{Spending one year abroad teaching european panda facilities about the
		newest findings and research in the field of asian rice hat covers and
		applications for bamboo as a material.}
\end{cvtable}


\cvsubsection{Study}
\begin{cvtable}[1.5]
	\cvitem{2006 -- 2008}{Master Studies Panda Science}{Panda Academy}
		{Focus: Advanced rice hat studies and nouveau rain-reflecting cover
		materials.}
	\cvitem{}{Master Thesis ($\varnothing\, 1,0$)}{Asian Rice Hat Institute}
		{Impact of solar radiation onto rice hat cover materials with special
		attention to water resistance.}
	\cvitem{2003 -- 2006}{Bachelor Studies PandaScience}{Panda Academy}
		{Focus: Bamboo morphology and its usage in different craftmanships.}
	\cvitem{}{Bachelor Thesis ($\varnothing\, 1,0$)}{Bamboo Institute}
		{The bambo flute: An underestimated instrument in orchestras?}
\end{cvtable}

\cvsection{Publications}
\begin{cvtable}
	\cvpubitem{Cooking: 100 recipes for lazy Pandas}{Me and My Panda Friends}
		{Panda's Culinary World}{2010}
	\cvpubitem{Pandastasia}{Still Me}{Bamboo Books Assoc.}{2005}
\end{cvtable}

\cvsection{Awards}
\begin{cvtable}
	\cvitem{2010 -- now}{Panda of the Year}{Panda World Forum}{}
	\cvitem{2005 -- now}{Face of World Wide Fund for Nature}{WWF}{}
	\cvitem{2000}{Winner of Bamboo Sprouts Eating Contest}{Bamboo Society}{}
\end{cvtable}


\cvsection{Extra-Curricular Activities}
\begin{cvtable}
	\cvitemshort{Relaxing}{Master the fine art of relaxing everywhere}
	\cvitemshort{Music}{Playing the bamboo flute in the 1st Panda Orchestra}
	\cvitemshort{Education}{Teaching young pandas to be more panda-like}
\end{cvtable}


\newpage
\makebacksidebar
% \newgeometry{
% 	top=\topbottommargin,
% 	bottom=\topbottommargin,
% 	right=\leftrightmargin,
% 	left=\leftrightmargin
% }

\cvsection{section}
\cvsubsection{Subsection}
\begin{cvtable}
	\cvitem{<dates>}{<cv-item title>}{<location>}{<optional: description>}
\end{cvtable}

\cvsection{cvitem}
\cvsubsection{Multi-line with longer description}
\begin{cvtable}
	\cvitem{date}{Description}{location}{Some longer and more detailed
		description, that takes two lines of space instead of only one.}
	\cvitem{date}{Description}{location}{Some longer and more detailed
		description, that takes two lines of space instead of only one.}
	\cvitem{date}{Description}{location}{Some longer and more detailed
		description, that takes two lines of space instead of only one.}
\end{cvtable}

\cvsubsection{One-line without description}
\begin{cvtable}
	\cvitem{Award}{One-line description}{Sponsor}{}
	\cvitem{Award}{One-line description}{Sponsor}{}
	\cvitem{Award}{One-line description}{Sponsor}{}
\end{cvtable}

\cvsection{cvitemshort}
\cvsubsection{One-line}
\begin{cvtable}
	\cvitemshort{Key}{Some further description}
	\cvitemshort{Key}{Some further description}
	\cvitemshort{Key}{Some further description}
\end{cvtable}

\cvsubsection{Multi-line with longer description}
\begin{cvtable}
	\cvitemshort{Key}{Some further description. Can fill even more than
		only one single line while still keeping the correct indendation level.}
	\cvitemshort{Key}{Some further description. Can fill even more than
		only one single line while still keeping the correct indendation level.}
	\cvitemshort{Key}{Some further description. Can fill even more than
		only one single line while still keeping the correct indendation level.}
\end{cvtable}

\cvsection{cvpubitem}
\begin{cvtable}
	\cvpubitem{Publication title}{Authors}{Journal}{Year}
	\cvpubitem{Publication title}{Authors}{Journal}{Year}
	\cvpubitem{Publication title that is spanning over multiple lines and still
		does not look too bad}{Authors}{Journal}{Year}
\end{cvtable}

\cvsignature

\end{document}