update user guide and package documentation

CHANGELOG

@@ -5,6 +5,7 @@ version next
 - Include social icons in cover letter for styles classic, fancy and banking (#170)
 - Update Oldstyle to use symbols instead of marvosym (#209)
 - Fix spacing between first and last name again (#220)
+- Support BibLaTeX and drop BibTeX (#227)
 
 version 2.4.1 (18 Jul 2024)
 - Fix commons/colors.tex not found in package (#194)

KNOWN_BUGS

@@ -1,11 +1,8 @@
-- moderncv is incompatible with biber.
-- moderncv is incompatible with BibLaTeX.
 - moderncv is incompatible with babel in Spanish.
 
 - Skill matrices don't break automatically in fancy style.
 - Long names break the oldstyle style and possibly other styles (needs testing).
 - Long URLs in classic style can make the name break line. Fixed width for the address part must be implemented.
-- When using the fancy style, undesired space is added between the bibliography head and the first entry, as well as after the last entry.
 - Footnotes generate errors, but the output seems correct when running with "-interaction=nonstopmode"
 - When using CJK, the last \clearpage required for the fancyhdr package to work properly kills the "lastpage" counter, and therefore also the page numbering.
 - moderncv produces an error "lonely \item--perhaps a missing list environment" when used with the bibentry package, though the output is actually correct. Among other things, this causes compilation by LyX to stop.

manual/moderncv_userguide.tex

@@ -98,11 +98,11 @@
     cvitem, cventry, cvdoubleentry, cvdoubleitem, cvtripleitem, cvlistitem, cvlistdoubleitem, cvcolumns, moderncvstyle, moderncvcolor,
     cvskill, cvskilllegend, cvskillplainlegend, cvskillhead, cvskillentry, nopagenumbers,
     name, born, address, email, link, social, phone, homepage, extrainfo, photo, quote, section, subsection, setlength, NewDocumentCommand, definecolor, colorlet, cvitemwithcomment,
-    recipient, subject, opening, closing, signature, enclosure
+    recipient, subject, opening, closing, signature, enclosure, biblatex, printbibliography, addbibresource
   },
   emphstyle={\color{cvblue}},
   emph={[2]
-    familydefault, sfdefault, rmdefault, inputenc, moderncv, document, bibliographyitemlabel,
+    familydefault, sfdefault, rmdefault, inputenc, moderncv, document, 
     addresssymbol, mobilephonesymbol, fixedphonesymbol, faxphonesymbol, emailsymbol, homepagesymbol, linkedinsocialsymbol,
     xingsocialsymbol, twittersocialsymbol, githubsocialsymbol, gitlabsocialsymbol,
     stackoverflowsocialsymbol, bitbucketsocialsymbol, skypesocialsymbol, orcidsocialsymbol, researchgatesocialsymbol, arxivsocialsymbol, inspiresocialsymbol,
@@ -118,7 +118,7 @@
   unicode=true,
   % draft,  % Draft mode for printing (see below)
   colorlinks=true, linktocpage=true, pdfstartpage=3, pdfstartview=FitV,
-  % colorlinks=false, linktocpage=false, pdfstartpage=3, pdfstartview=FitV, pdfborder={0 0 0},  % Black links (e.g., for printing)
+  % colorlinks=false, linktocpage=false, pdfstartpage=3, pdfstartview=FitV, pdfborder={0 0 0},  % Black links (e.g., for pirnting)
   breaklinks=true, pageanchor=true,
   pdfpagemode=UseNone,
   % pdfpagemode=UseOutlines,
@@ -397,23 +397,31 @@ For instance, pictures can be included with \code{\\includegraphics}:
 Adding \code{\\hspace} in units of basic \code{moderncv} lengths will fit them more naturally into the CV or resume.  
 
 \paragraph{Bibliography.}
-In case BibTeX is used, the bibliography settings are adjusted in the lines
+In favor of BibLaTeX support for BibTeX is dropped.\newline
+Including a bibliography database \texttt{publications.bib} is achieved with the following lines in the preamble:
 \begin{lstlisting}
-  % to show numerical labels in the bibliography (default is to show no labels)
-  % \renewcommand*{\bibliographyitemlabel}{[\arabic{enumiv}]}
-  % \renewcommand{\refname}{Articles}
-
-  % bibliography with mutiple entries
-  % \usepackage{multibib}
-  % \newcites{book, misc}{{Books}, {Others}}
+  \usepackage[backend=biber]{biblatex}
+  % bibliography adjustments (only useful if you make citations in your resume, or print a list of publications using BibLaTeX)
+  \usepackage[backend=biber]{biblatex}
+  % in order to sort after citation occurrence use the following instead:
+  \usepackage[backend=biber, sorting=none]{biblatex}
+  \addbibresource{publications.bib}
 \end{lstlisting}
-By default, no labels are shown for bibliography entries.
-Uncommenting the line \code{\%\\renewcommand*\{\\bibliographyitemlabel\}\{[\\arabic\{enumiv\}]\}}
-allows one to fine-tune the labels.
-Uncommenting the line \code{\%\\renewcommand\{\\refname\}\{Articles\}} allows one to redefine the bibliography heading string ``Publications'' that is shown by default.
-Finally, adjustments using the \code{multibib} package can be done in the last two lines shown here.
+Uncommenting the line \code{\\usepackage[backend=biber, sorting=none]\{biblatex\}}
+allows sorting the citations after their occurrence.
+Throughout the CV now the \code{\\cite} command can be used to cite references from the \texttt{publications.bib}.
 
-\note \Biblatex is currently not supported.
+A list of the cited references can be created with:
+\begin{lstlisting}
+  % Publications from a BibLaTeX file
+  \printbibliography[title=Publications]
+  % in case all references should be printed without a \cite uncomment the following line:
+  \nocite{*}
+\end{lstlisting}
+In case the whole reference list should be printed regardless of a citation the option \code{\\nocite\{*\}} can be used.\newline
+For a different bibliography heading string, change the \texttt{title} option. ``Publications'' is used as the default bibliography title.
+
+For further reference please see the \texttt{biblatex} documentation on CTAN: \url{https://ctan.org/pkg/biblatex}
 
 \subsection{Modifying CV content}
 \subsubsection{Structuring the CV}
@@ -1047,8 +1055,6 @@ Most of these packages should be included in your \Latex distribution of choice.
 
 \subsection{Known conflicts with other packages}
 \begin{enumerate}
-  \item \Moderncv is incompatible with \code{biber}.
-  \item \Moderncv is incompatible with \biblatex.
   \item \Moderncv is incompatible with \code{babel} in Spanish
 \end{enumerate}
 
@@ -1058,7 +1064,6 @@ Most of these packages should be included in your \Latex distribution of choice.
   \item Long names break the \texttt{oldstyle} style and possibly other styles (needs testing).
   \item Long URLs in \texttt{classic} style can make the name break line.
   Fixed width for the address part must be implemented.
-  \item When using the \texttt{fancy} style, undesired space is added between the bibliography head and the first entry, as well as after the last entry.
     \item Footnotes generate errors, but the output seems correct when running with \code{-interaction=nonstopmode}.
   \item When using CJK, the last \code{\\clearpage} required for the \code{fancyhdr} package to work properly kills the ``lastpage'' counter, and therefore also the page numbering.
   \item \Moderncv produces the error ``\code{lonely \\item--perhaps a missing list environment}'' when used with the \code{bibentry} package, though the output is actually correct.