support pronouns in other styles as well

* Add support for including pronouns in header

* Provide documentation and changelog for pronouns

pending render of manual/moderncv_userguide.pdf

* <automated> build of user guide

---------

Co-authored-by: daniel <Daniel.adlkofer@freenet.de>

CHANGELOG

@@ -47,6 +47,7 @@ version 2.5.1 (31 Jan 2026)
 - Add contemporary CV header style to cover letter, which also makes icons
   visible (#186)
 - Fix minor horizontal spacing issue in 'contemporary' style header
+- Added optional support for specifying pronouns (#249)
 
 
 version 2.4.2 (01 Feb 2025)

manual/moderncv_userguide.tex

@@ -97,7 +97,7 @@
   emph={
     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,
+    name, born, pronouns, address, email, link, social, phone, homepage, extrainfo, photo, quote, section, subsection, setlength, NewDocumentCommand, definecolor, colorlet, cvitemwithcomment,
     recipient, subject, opening, closing, signature, postscript, enclosure, makelettertitle, makeletterclosing, httplink, httpslink, emaillink
   },
   emphstyle={\color{cvblue}},
@@ -106,7 +106,7 @@
     addresssymbol, mobilephonesymbol, fixedphonesymbol, faxphonesymbol, emailsymbol, homepagesymbol, linkedinsocialsymbol,
     xingsocialsymbol, twittersocialsymbol, githubsocialsymbol, gitlabsocialsymbol, mastodonsocialsymbol, codebergsocialsymbol, discordsocialsymbol, twitchsocialsymbol, youtubesocialsymbol, tiktoksocialsymbol, instagramsocialsymbol, soundcloudsocialsymbol, steamsocialsymbol, xboxsocialsymbol, playstationsocialsymbol, battlenetsocialsymbol, simplexsocialsymbol, threemasocialsymbol, 
     stackoverflowsocialsymbol, bitbucketsocialsymbol, skypesocialsymbol, orcidsocialsymbol, researchgatesocialsymbol, arxivsocialsymbol, inspiresocialsymbol,
-    researcheridsocialsymbol, telegramsocialsymbol, whatsappsocialsymbol, signalsocialsymbol, matrixsocialsymbol, googlescholarsocialsymbol, cvstretchability, bornsymbol
+    researcheridsocialsymbol, telegramsocialsymbol, whatsappsocialsymbol, signalsocialsymbol, matrixsocialsymbol, googlescholarsocialsymbol, cvstretchability, bornsymbol, gendersymbol
   },
   emphstyle={[2]\color{cvblue!60!cvgrey}\bfseries},
   literate={{é}{{\'e}}1},
@@ -299,6 +299,18 @@ A command for a birth date.
   \born{<birth date>}
 \end{lstlisting}
 
+\paragraph{\code{\\pronouns}}
+A command for your pronouns.
+\begin{lstlisting}
+  \pronouns{<pronouns>}
+\end{lstlisting}
+
+\paragraph{\code{\\gendericon}}
+A command for the icon used for your gender.
+\begin{lstlisting}
+  \gendericon{<icon>}
+\end{lstlisting}
+
 \paragraph{\code{\\address}}
 A command for a three-lined street address.
 \begin{lstlisting}
@@ -815,6 +827,7 @@ Currently \Moderncv supports the following commands as \code{<\\symbolcommand>}:
     \item \code{\\battlenetsocialsymbol}
     \item \code{\\mediumsocialsymbol}
     \item \code{\\bornsymbol}
+    \item \code{\\gendersymbol}
     \item \code{\\arxivsocialsymbol}
     \item \code{\\inspiresocialsymbol}
     \item \code{\\simplexsocialsymbol}

moderncv.cls

@@ -224,6 +224,14 @@
 % usage: \title{<title>}
 \renewcommand*{\title}[1]{\def\@title{#1}}
 
+% defines one's preferred pronouns (optional)
+% usage: \pronouns{<pronouns>}
+\newcommand*{\pronouns}[1]{\def\@pronouns{#1}}
+
+% defines one's preferred gender icon (optional)
+% usage: \gendericon{<gendericon>}
+\newcommand*{\gendericon}[1]{\def\@gendericon{#1}}
+
 % defines one's address (optional)
 % usage: \address{<street>}{<city>}{<country>}
 % where the <city> and <country> arguments can be omitted or provided empty
@@ -361,6 +369,7 @@
 \newcommand*{\listitemsymbol}           {\labelitemi~}
 \newcommand*{\addresssymbol}            {}
 \newcommand*{\bornsymbol}               {}
+\newcommand*{\gendersymbol}             {}
 \newcommand*{\mobilephonesymbol}        {}
 \newcommand*{\fixedphonesymbol}         {}
 \newcommand*{\faxphonesymbol}           {}

moderncvfooti.sty

@@ -86,6 +86,7 @@
           \ifthenelse{\equal{\@addresscountry}{}}{}{\addtofoot[~--~]{\@addresscountry}}%
           \flushfoot\@firstfootelementtrue\\}%
         \ifthenelse{\isundefined{\@born}}{}{\addtofoot{\bornsymbol\@born}\flushfoot\@firstfootelementtrue\\}%
+        \ifthenelse{\isundefined{\@pronouns}}{}{\addtofoot{\gendersymbol\@pronouns}\flushfoot\@firstfootelementtrue\\}%
         \collectionloop{phones}{% the key holds the phone type (=symbol command prefix), the item holds the number
           \addtofoot{\csname\collectionloopkey phonesymbol\endcsname\collectionloopitem}}%
         \ifthenelse{\isundefined{\@email}}{}{\addtofoot{\emailsymbol\emaillink{\@email}}}%

moderncvheadi.sty

@@ -86,6 +86,7 @@
           \ifthenelse{\equal{\@addresscity}{}}{}{\makenewline\@addresscity}% if \addresstreet is defined, \addresscity and addresscountry will always be defined but could be empty
           \ifthenelse{\equal{\@addresscountry}{}}{}{\makenewline\@addresscountry}}%
         \ifthenelse{\isundefined{\@born}}{}{\makenewline\bornsymbol\@born}%
+	\ifthenelse{\isundefined{\@pronouns}}{}{\makenewline\gendersymbol\@pronouns}%
         \phonesdetails% needs to be pre-rendered as loops and tabulars seem to conflict
         \ifthenelse{\isundefined{\@email}}{}{\makenewline\emailsymbol\emaillink{\@email}}%
         \ifthenelse{\isundefined{\@homepage}}{}{\makenewline\homepagesymbol%

moderncvheadii.sty

@@ -141,6 +141,7 @@
       \ifthenelse{\equal{\@addresscountry}{}}{}{\addtomakeheaddetails[~--~]{\@addresscountry}}%
         \flushmakeheaddetails\@firstmakeheaddetailselementtrue\\\null}%
     \ifthenelse{\isundefined{\@born}}{}{\addtomakeheaddetails{\bornsymbol\@born}}%
+    \ifthenelse{\isundefined{\@pronouns}}{}{\addtomakeheaddetails{\gendersymbol\@pronouns}}%
     \collectionloop{phones}{% the key holds the phone type (=symbol command prefix), the item holds the number
       \addtomakeheaddetails{\csname\collectionloopkey phonesymbol\endcsname\collectionloopitem}}%
     \ifthenelse{\isundefined{\@email}}{}{\addtomakeheaddetails{\emailsymbol\emaillink{\@email}}}%

moderncvheadiii.sty

@@ -94,6 +94,7 @@
         \ifthenelse{\equal{\@addresscountry}{}}{}{\addtomakeheaddetails[~--~]{\@addresscountry}}%
         \flushmakeheaddetails\@firstmakeheaddetailselementtrue\\}%
       \ifthenelse{\isundefined{\@born}}{}{\addtomakeheaddetails{\bornsymbol\@born}}%
+      \ifthenelse{\isundefined{\@pronouns}}{}{\addtomakeheaddetails{\gendersymbol\@pronouns}}%
       \collectionloop{phones}{% the key holds the phone type (=symbol command prefix), the item holds the number
         \addtomakeheaddetails{\csname\collectionloopkey phonesymbol\endcsname\collectionloopitem}}%
       \ifthenelse{\isundefined{\@email}}{}{\addtomakeheaddetails{\emailsymbol\emaillink{\@email}}}%

moderncvheadiv.sty

@@ -110,6 +110,7 @@
         \ifthenelse{\equal{\@addresscity}{}}{}{\makenewline\@addresscity}% if \addresstreet is defined, \addresscity and \addresscountry will always be defined but could be empty
         \ifthenelse{\equal{\@addresscountry}{}}{}{\makenewline\@addresscountry}}%
       \ifthenelse{\isundefined{\@born}}{}{\makenewline\hbox to 1.0em{\bornsymbol}~\@born}%
+      \ifthenelse{\isundefined{\@pronouns}}{}{\makenewline\hbox to 1.0em{\gendersymbol}~\@pronouns}%
       \collectionloop{phones}{% the key holds the phone type (=symbol command prefix), the item holds the number
         \makenewline\hbox to 1.0em{\csname\collectionloopkey phonesymbol\endcsname}~\collectionloopitem}%
       \ifthenelse{\isundefined{\@email}}{}{\makenewline\hbox to 1.0em{\emailsymbol}~\emaillink{\@email}}%

moderncvheadv.sty

@@ -82,6 +82,7 @@
           \ifthenelse{\equal{\@addresscity}{}}{}{\makenewline\@addresscity}% if \addresstreet is defined, \addresscity and \addresscountry will always be defined but could be empty
           \ifthenelse{\equal{\@addresscountry}{}}{}{\makenewline\@addresscountry}}%
         \ifthenelse{\isundefined{\@born}}{}{\makenewline\bornsymbol~\@born}%
+        \ifthenelse{\isundefined{\@pronouns}}{}{\makenewline\gendersymbol~\@pronouns}%
         \collectionloop{phones}{% the key holds the phone type (=symbol command prefix), the item holds the number
           \makenewline\csname\collectionloopkey phonesymbol\endcsname~\collectionloopitem}%
         \ifthenelse{\isundefined{\@email}}{}{\makenewline\emailsymbol~\emaillink{\@email}}%

moderncvheadvi.sty

@@ -115,6 +115,7 @@
       \ifthenelse{\equal{\@addresscountry}{}}{}{\addtomakeheaddetails[~--~]{\@addresscountry}}%
         \flushmakeheaddetails\@firstmakeheaddetailselementtrue\\\null}%
     \ifthenelse{\isundefined{\@born}}{}{\addtomakeheaddetails{\bornsymbol\@born}}%
+    \ifthenelse{\isundefined{\@pronouns}}{}{\addtomakeheaddetails{\gendersymbol\@pronouns}}%
     \collectionloop{phones}{% the key holds the phone type (=symbol command prefix), the item holds the number
       \addtomakeheaddetails{\csname\collectionloopkey phonesymbol\endcsname\collectionloopitem}}%
     \ifthenelse{\isundefined{\@email}}{}{\addtomakeheaddetails{\emailsymbol\emaillink{\@email}}}%

moderncvheadvii.sty

@@ -98,6 +98,7 @@
           \ifthenelse{\equal{\@addresscity}{}}{}{\makenewline\@addresscity}% if \addresstreet is defined, \addresscity and addresscountry will always be defined but could be empty
           \ifthenelse{\equal{\@addresscountry}{}}{}{\makenewline\@addresscountry}}%
         \ifthenelse{\isundefined{\@born}}{}{\makenewline\bornsymbol\@born}%
+        \ifthenelse{\isundefined{\@pronouns}}{}{\makenewline\gendersymbol\@pronouns}%
         \phonesdetails% needs to be pre-rendered as loops and tabulars seem to conflict
         \ifthenelse{\isundefined{\@email}}{}{\makenewline\emailsymbol\emaillink{\@email}}%
         \ifthenelse{\isundefined{\@homepage}}{}{\makenewline\homepagesymbol\httplink{\@homepage}}%

moderncviconsawesome.sty

@@ -55,6 +55,7 @@
 \providecolor{playstation}{named}{default-socialicon-color}
 \providecolor{battlenet}{named}{default-socialicon-color}
 \providecolor{born}{named}{default-socialicon-color}
+\providecolor{gender}{named}{default-socialicon-color}
 \providecolor{signal}{named}{default-socialicon-color}
 \providecolor{medium}{named}{default-socialicon-color}
 
@@ -104,8 +105,10 @@
 % \renewcommand*{\arxivsocialsymbol}        {{\color{arxiv}{\small\faIcon{arxiv}}}~}
 % No inspire icon in fontawesome6 (v6.7.2-3) or fontawesome7 (v7.1.0-1)
 % \renewcommand*{\inspiresocialsymbol}      {{\color{inspire}{\small\faIcon{inspire}}}~}
+\def\@gendericon{\faNeuter}
+\renewcommand*{\gendersymbol}             {{\color{gender}\small\@gendericon}~}
 \renewcommand*{\bornsymbol}               {{\color{born}\raisebox{.5ex}{\tiny\faIcon{asterisk}}}~}           % alternative: \faIcon{baby-carriage}
-\renewcommand*{\mediumsocialsymbol}     {{\color{medium}\small\faIcon{medium}}~}
+\renewcommand*{\mediumsocialsymbol}       {{\color{medium}\small\faIcon{medium}}~}
 
 
 \endinput

template.tex

@@ -56,6 +56,8 @@
 \name{John}{Doe}
 \title{Résumé title}                               % optional, remove / comment the line if not wanted
 \born{4 July 1776}                                 % optional, remove / comment the line if not wanted
+\pronouns{they/them}                               % optional, remove / comment the line if not wanted
+\gendericon{\faNeuter}                             % optional, remove / comment the line if not wanted
 \address{street and number}{postcode city}{country}% optional, remove / comment the line if not wanted; the "postcode city" and "country" arguments can be omitted or provided empty
 \phone[mobile]{+1~(234)~567~890}                   % optional, remove / comment the line if not wanted; the optional "type" of the phone can be "mobile" (default), "fixed" or "fax"
 \phone[fixed]{+2~(345)~678~901}