Hi,

Thank you very much for providing all of these great templates. I am trying to convert my CV from a Word document to a Rmd document so I no longer have to deal with manual formatting pains and I can now git-track the Rmd for reproducibility.

I am interested in adding unordered lists and sub-items using Markdown, but it doesn't seem to be supported in the way I would expect. The list items are properly indented, but there are not "bullets" in front of the text.

I anticipated that using * and + for major and sub-items, respectively, they would look like this:

• Item
  • sub-item

Am I doing something wrong or does your template not support the bullet-points for lists?

Sir - Love the CV template in R.

I would love if the email/github/phone/web/update date line could wrap in the header. If you include all of them, it kicks an error and I believe its because the text does not wrap. Would this functionality be hard to add?

Go Buckeyes BTW -

Thanks,

Inspite of my repeated tries, I am not able to remove the unwanted slide with sections

hey man >

look, i am confused about fontfamily: using your template to create manuscripts.
how to change fonts using that? seems like i gotta tweak the .tex template file first, as this command:

\newcommand*{\authorfont}{\fontfamily{phv}\selectfont}

so the value phv is possible to change but i still i can't get anything to work.
i tried to use ptm and tweak fontfamily: to Times but it shouted that i didn't have Times.sty file.

could you thus provide me with little insight on that? i would solely appreciate that! >

offtopic: you rock
E.

I want to have the title, author and affiliation centered in article rmarkdown, which relies on svm-latex-ms.tex

I changed this part of the template (\raggedright to \center and changes to author related parts)

\makeatletter
\def\@maketitle{%
  \newpage
%  \null
%  \vskip 2em%
%  \begin{center}%
  \let \footnote \thanks
    {\fontsize{18}{20}\selectfont\raggedright  \setlength{\parindent}{0pt} \@title \par}%
}
%\fi
\makeatother

I'm using this RMarkdown template https://github.com/svmiller/svm-r-markdown-templates/blob/master/article-example/svm-rmarkdown-article-example.Rmd

It has https://github.com/svmiller/svm-r-markdown-templates/blob/master/svm-latex-ms.tex as template

I want to have the title, author and affiliation centered.

I changed this part of the template (\raggedright to \center and changes to author related parts)

\makeatletter
\def@maketitle{%
\newpage
% \null
% \vskip 2em%
% \begin{center}%
\let \footnote \thanks
{\fontsize{18}{20}\selectfont\raggedright \setlength{\parindent}{0pt} @title \par}%
}
%\fi
\makeatother

to

\makeatletter
\def\@maketitle{%
  \newpage
%  \null
%  \vskip 2em%
%  \begin{center}%
  \let \footnote \thanks
    {\fontsize{18}{20}\selectfont\center  \setlength{\parindent}{0pt} \@title \par}%
}
%\fi
\makeatother

And this part

{% \usefont{T1}{pnc}{m}{n}
\setlength{\parindent}{0pt}
\thispagestyle{plain}
{\fontsize{18}{20}\selectfont\raggedright 
\maketitle  % title \par  

}

{
   \vskip 13.5pt\relax \normalsize\fontsize{11}{12} 
$if(anonymous)$\hfill $else$$for(author)$\textbf{\authorfont $author.name$} \hskip 15pt \emph{\small $author.affiliation$}  $sep$ \par $endfor$ $endif$

}

}

to

{% \usefont{T1}{pnc}{m}{n}
\setlength{\parindent}{0pt}
\thispagestyle{plain}
{\fontsize{18}{20}\selectfont\center
\maketitle  % title \par

}

{
   \vskip 13.5pt\relax \normalsize\fontsize{11}{12}
$if(anonymous)$\hfill $else$$for(author)$\center\textbf{\authorfont $author.name$} \emph{\center\small $author.affiliation$}  $sep$ \par $endfor$ $endif$

}

}

This somehow creates a blank first page in the output.

My goal is to have the title, author, affiliation and abstract vertically centered separately on my first page.

I just want to knit the template file and check what doest it look like in pdf. And the point is that I didn't change anything, but the output reminded me that I missed something....

This is XeTeX, Version 3.141592653-2.6-0.999994 (TeX Live 2022) (preloaded format=xelatex)
 restricted \write18 enabled.

entering extended mode

I was unable to find any missing LaTeX packages from the error log svm-article2-example.log.

! LaTeX Error: Missing \begin{document}.


Error: LaTeX failed to compile svm-article2-example.tex. See https://yihui.org/tinytex/r/#debugging for debugging tips. See svm-article2-example.log for more info.

Execution halted

[VSC-R] svm-article2-example.Rmd process exited with exit code 1
[VSC-R] terminating R process

I am not able to run the example for "Steve's Non-Academic Resume Template." What are the required steps for set-up? I'm running into issues with the fonts, specifically this error:

! Package fontspec Error: The font "Fira Sans" cannot be found.

To get here I opened an Rstudio Cloud instance:

Sys.info()
#>                                               sysname 
#>                                               "Linux" 
#>                                               release 
#>                                      "5.4.0-1037-aws" 
#>                                               version 
#> "#39~18.04.1-Ubuntu SMP Fri Jan 15 02:48:42 UTC 2021" 
#>                                              nodename 
#>       "application-4077019-deployment-10023567-x9h4p" 
#>                                               machine 
#>                                              "x86_64" 
#>                                                 login 
#>                                             "unknown" 
#>                                                  user 
#>                                        "rstudio-user" 
#>                                        effective_user 
#>                                        "rstudio-user"

Then ran:

install.packages("stevetemplates")

tinytex::install_tinytex()
tinytex::tlmgr_install("cochineal")

Then clicked "knit" (resulting in error mentioned above).

I'd also tried tinytex::tlmgr_install("fira") and downloading + installing Fira Sans font but still got stuck at the above error message. (Note that just setting sansfont: cochineal works fine though).

How would you go on about adding your twitter handle to the CV template?
Wanted to include their logo as well as you added i.e. the Github one.

Thanks for this - amazing resource!

Thanks for uploading these helpful templates, @svmiller!
I'm trying to write an academic MS using RMarkdown and am trying a bunch of options including distill (previously, radix) by @jjallaire.

I would like to check out your article template for the PDF version but I am encountering the following error.

Input (yaml)

  pdf_document:
    latex_engine: pdflatex
    number_sections: true
    fig_caption: true
    keep_tex: true
    citation_package: natbib
    template: "templates/svm-latex-ms.tex"

Output (error)

"template" (line 1059, column 152):
unexpected "<"
expecting letter
Error: pandoc document conversion failed with error 5
Execution halted

I tried some of these solutions since a similar error was described (rstudio/tufte#56), but haven't been able to fix it yet. Please advise. thanks!

Formula does not compile when exporting word using \tag ,like this：

I also tried \lable and \eqno, but the formulas were not compiled.
I want to know how to display the label of the formula when exporting word.

Thank you for the great examples of what can be done with rmarkdown. I'm trying to tweak one of them for my own use, but run into the typical graphics vs graphicx issues that I have been unable to solve by adding an \includepackage{graphicx} to the top of the template file.

Is there any reason for this? Whatever I do am forced to do (graphics style):

\scalebox{0.50}{\includegraphics{image}}

and any graphicx variations will fail, e.g.

\includegraphics[scale=0.5]{image}

even in I add \includepackage{graphicx}.

If the YAML header does not have values specified for linkcolor and urlcolor, then knitting fails:

output file: cv.knit.md

! Package xcolor Error: Undefined color `Blue'.

Error: LaTeX failed to compile cv.tex. See https://yihui.org/tinytex/r/#debugging for debugging tips. See cv.log for more info.
Execution halted

The problem appears to be that the template.tex for cv specifies Blue rather than blue as a default color. Making this change (Blue to blue) in template.tex fixed the error on my local copy. I will fork and issue a PR.

Hi, although you have a "date" item in the YAML header, a date is not printed in the pdf output. How do you make the date appear? This is important to track versions. Many thanks.

Hi there,
I use your svm-latex-ms (thank you!), but it seems to be crashing in recent Rstudio updates due to CSLReferences missing. Wondering if you'd consider patching it for this?
Many thanks!

@svmiller, I appreciate all the rmarkdown templates you provided here! They are very helpful. However, here's a question about the bibliography styles in the syllabus template: why is there always an "In:" for the article bibliography? I didn't find that problem when using your template of academic article, while I didn't find the difference between the two templates in the bibliography part in both latex and rmd files. Do you have any idea where the "In:" comes from---because of the RefManageR package? Thank you.

Hello,
If I want to add image(logo) next to the tile in the front page, what should I do? Any suggestion would be helpful.
Thank you
sandesh

Hi
is it possible that the dataset "cross national rates of trade union density" is named unionDensity and not uniondensity as e.g. in the file svm-rmarkdown-article-example.Rmd?
Kind regards
Michael

Rstudio says "Fatal fontspec error: "cannot-use-pdftex"", when I try to knit the document. Are there anyone who can explain why it says that?

The include_graphics function does not seem to play nicely. I noticed the commit message "add support for include_graphics, maybe?"

Code:

knitr::include_graphics("~/Sentencing/Graphics/CookCounty_Race_ACS.png")

Error message:

"/Applications/RStudio.app/Contents/MacOS/pandoc/pandoc +RTS -K512m -RTS test.utf8.md --to latex --from markdown+autolink_bare_uris+ascii_identifiers+tex_math_single_backslash --output test.tex --template /Users/thomasapepperz/Sentencing/svm.latex.ms.tex --highlight-style tango --latex-engine pdflatex --natbib
output file: test.knit.md

! LaTeX Error: File `\nobreakspace {}/Sentencing/Graphics/CookCounty_Race_ACS'
not found.

Error: Failed to compile test.tex. See test.log for more info.
Execution halted"

Getting this error when Knitting the default template without any changes:

processing file: Untitled.Rmd
Quitting from lines 28-149 (Untitled.Rmd)
Error in dev.control(displaylist = if (record) "enable" else "inhibit") :
dev.control() called without an open graphics device
Calls: ... call_block -> block_exec -> eng_r -> chunk_device -> dev.control
In addition: Warning messages:
1: In grSoftVersion() :
unable to load shared object '/Library/Frameworks/R.framework/Resources/modules//R_X11.so':
dlopen(/Library/Frameworks/R.framework/Resources/modules//R_X11.so, 0x0006): Library not loaded: /opt/X11/lib/libSM.6.dylib
Referenced from: /Library/Frameworks/R.framework/Versions/4.1-arm64/Resources/modules/R_X11.so
Reason: tried: '/opt/X11/lib/libSM.6.dylib' (no such file), '/Library/Frameworks/R.framework/Resources/lib/libSM.6.dylib' (no such file), '/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home/lib/server/libSM.6.dylib' (no such file)
2: In cairoVersion() :
unable to load shared object '/Library/Frameworks/R.framework/Resources/library/grDevices/libs//cairo.so':
dlopen(/Library/Frameworks/R.framework/Resources/library/grDevices/libs//cairo.so, 0x0006): Library not loaded: /opt/X11/lib/libXrender.1.dylib
Referenced from: /Library/Frameworks/R.framework/Versions/4.1-arm64/Resources/library/grDevices/libs/cairo.so
Reason: tried: '/opt/X11/lib/libXrender.1.dylib' (no such file), '/Library/Frameworks/R.framework/Resources/lib/libXrender.1.dylib' (no such file), '/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home/lib/server/libXrender.1.dylib' (no such file)
3: In (function (filename = if (onefile) "Rplots.pdf" else "Rplot%03d.pdf", :
failed to load cairo DLL
Execution halted

Hi,
Thank you very much for sharing these great r markdown templates with us! I find the svm-rmarkdown-article-example.Rmd is very useful.

When I compiled it in my rstudio, I found the pdf file generated had no bookmarks showing. I tried with pdf expert and adobe pdf reader and the problem still existed.

Then I tried to compile the latex file (.tex) directly, then I found when I compiled it with pdflatex engine, no bookmarks showing with following warning message:

/Users/changche/Downloads/svm-rmarkdown-article-example.tex:150: Package hyperref Warning: Option bookmarks' has already been used,(hyperref) setting the option has no effect on input line 150. /Users/changche/Downloads/svm-rmarkdown-article-example.tex: Package hyperref Warning: Draft mode on. /Users/changche/Downloads/svm-rmarkdown-article-example.tex:179: LaTeX Font Warning: Font shape OMS/cmsy/m/n' in size <13.6799> not available(Font) size <14.4> substituted on input line 179.
/Users/changche/Downloads/svm-rmarkdown-article-example.tex: LaTeX Font Warning: Size substitutions with differences(Font) up to 0.7201pt have occurred.

When compiled with xelatex engine, bookmarks are back with the following warning message:

/usr/local/texlive/2017/texmf-dist/tex/latex/base/inputenc.sty: Package inputenc Warning: inputenc package ignored with utf8 based engines.
/Users/changche/Downloads/svm-rmarkdown-article-example.tex:150: Package hyperref Warning: Option bookmarks' has already been used,(hyperref) setting the option has no effect on input line 150. /Users/changche/Downloads/svm-rmarkdown-article-example.tex: Package hyperref Warning: Rerun to get /PageLabels entry. /Users/changche/Downloads/svm-rmarkdown-article-example.tex:179: LaTeX Font Warning: Font shape OMS/cmsy/m/n' in size <13.6799> not available(Font) size <14.4> substituted on input line 179.
/Users/changche/Downloads/svm-rmarkdown-article-example.tex: LaTeX Font Warning: Size substitutions with differences(Font) up to 0.7201pt have occurred.

Do you know what could cause this error messages and the problem of no bookmarks?

Thanks!!

Long URLs in documents are sometimes better displayed if they are wrapped at hyphens. This can be done by passing the hyphens option to the url package (which is loaded by hyperref, so the option needs to be passed earlier than the call to hyperref to stick).

Here's your latex-ms template at lines 119-126:

\@ifpackageloaded{hyperref}{}{%
\ifxetex
  \usepackage[setpagesize=false, % page size defined by xetex
              unicode=false, % unicode breaks when used with xetex
              xetex]{hyperref}
\else
  \usepackage[unicode=true]{hyperref}
\fi

I currently use this modification to wrap long URLs:

\@ifpackageloaded{hyperref}{}{%
\ifxetex
  \PassOptionsToPackage{hyphens}{url}\usepackage[setpagesize=false, % page size defined by xetex
              unicode=false, % unicode breaks when used with xetex
              xetex]{hyperref}
\else
  \PassOptionsToPackage{hyphens}{url}\usepackage[unicode=true]{hyperref}
\fi
}

Would you be able to add installation instructions for these templates to your README.md file? I am not familiar with installing .Rmd templates manually.

hi,
when i compile the svm-rmarkdown-syllabus-example.Rmd, I failed it because of the missing of ~/Dropbox/master.bib in line 44?

Can you upload all of the files in need, please?

I'd love to be able to use your templates, e.g. svm-latex-ms.tex, in writing my dissertation and some manuscripts in bookdown.

The trouble is, bookdown supports align-style equation environments for LaTeX-PDF output. This is a very useful thing about bookdown, as it allows more customisable equation layout:

\begin{align}
  \hat{Y}_{i}
    &= \beta_{0} + \beta_{1} X_{i} + \epsilon_{i}
    &= 4.20 + 3.69 X_{i} + \epsilon
\end{align}

For example, I wish to render to PDF from .Rmd source files that contain align-style equations. Using svm-latex-ms.tex as the template, my _output.yml is as follows:

bookdown::pdf_book:
  latex_engine: xelatex
  template: svm-latex-ms.tex

On rendering (with bookdown::render_book("index.Rmd")), I get this error:

! LaTeX Error: Environment align undefined.

Error: Failed to compile manuscript.tex. See manuscript.log for more info.
Execution halted

I think it would be great to include a definition for the align environment in these templates (I'm willing to help!) so that they can be more flexibly applied to outputs from the wider RMarkdown ecosystem, such as bookdown 😄.

Pandoc (at least until version 1.17) treats

- a
- b
- c

as a tightlist, using the \tightlist command when converting to TeX.

By default, the latex-ms template does not understand that command, and breaks if the document contains such a list.

The problem does not reproduce if * is used instead of - to build the list, which I find a bit puzzling to be honest.

Anyway, "tight lists" can easily be supported by copy-pasting this bit of code in the preamble of the TeX template:

\providecommand{\tightlist}{%
  \setlength{\itemsep}{0pt}\setlength{\parskip}{0pt}}

In the YAML for the cover letter, is there a way to place the letterhead in the top center of the page and have all the text (dates, addresses, etc.) come after the letterhead? I've experimented with a few things, such as making the letterhead "long" (blank space on both sides of the image) but have had no luck.

Steven, I used your template to build my cv. It worked perfectly until recently. I tried to compile the file, but I got an error like this:

! Undefined control sequence.
<argument>  \faEnvelopeO 
                         \hspace {1 mm} \href {mailto:}{\tt \href {mailto:yu...
l.110 ...ue-hu-1@uiowa.edu}}} \hspace{1 mm}      }

pandoc.exe: Error producing PDF
Error: pandoc document conversion failed with error 43
In addition: Warning message:
running command '"D:/RStudio/bin/pandoc/pandoc" +RTS -K512m -RTS miniSample.utf8.md --to latex --from markdown+autolink_bare_uris+ascii_identifiers+tex_math_single_backslash --output miniSample.pdf --template svm-latex-cvOrig.tex --highlight-style tango --latex-engine pdflatex' had status 43 
Execution halted

With some debugging setting, I found this error was caused by the fontawesome icons such as \faEnvelopeO. If I delete them from the template, the file converged smoothly. Do you have any hint how I should install or set the fontawesome to make it work? I am using a Windows 10 system and installed both the latest Tex Live and MiKTex (2.9).

Thanks,

Hi Steve,

I've been trying to create a non-academic resume, and could not get the template to render with fontawesome=TRUE. I went through the process of force reinstalling tinytex a couple of times as well as installing the fontawesome library a few times using tinytex::tlmgr_install() to no avail. I don't think this was a system problem (info below), but is rather related to this issue here, fontawesome font not found.

That conversation inspired me to update the local template.tex file from $if(fontawesome)$\usepackage{fontawesome}$endif$ to $if(fontawesome)$\usepackage{fontawesome5}$endif$ and this resolved the issue (in addition to changing the $if(email)$$if(fontawesome)$\faEnvelope0 text to $if(email)$$if(fontawesome)$\faEnvelope.

If this is an issue that others have reported or can replicate, I would suggest updating all of the templates to fontawesome5!

$ tlmgr version
tlmgr revision 60693 (2021-10-04 04:24:25 +0200)
tlmgr using installation: /Users/patcallahan/Library/TinyTeX
TeX Live (https://tug.org/texlive) version 2021

$ tex --version
TeX 3.141592653 (TeX Live 2021)
kpathsea version 6.3.3

$ xelatex --version
XeTeX 3.141592653-2.6-0.999993 (TeX Live 2021)
kpathsea version 6.3.3

$ tlmgr info fontawesome
package:     fontawesome
category:    Package
shortdesc:   Font containing web-related icons
longdesc:    The package offers access to the large number of web-related icons provided by the included font. The package requires the package, fontspec, if run with XeTeX or LuaTeX.
installed:   Yes
revision:    48145
sizes:       run: 481k
relocatable: No
cat-version: 4.6.3.2
cat-license: lppl1.3
cat-topics:  font font-supp-symbol font-symbol font-otf font-type1
cat-contact-repository: https://github.com/xdanaux/fontawesome-latex
collection:  collection-fontsextra

Please consider adding a license so that the templates here may be reused.

I have tried, but after check the error, i realized the package has lack of complete files to run the code, like the logo as an instance.

First and foremost, I want to give thanks for this template. I wanted to rework my Resume in R markdown, and I was getting nowhere fast hacking the YAML. This saved me countless hours, and simplified what I wanted to accomplish all along.

The habit with my old Resume was to have a single double-sided sheet, however the header remained on both pages. In the rework, I got the core info down to one core page (with a second for some recent, vaguely relevant things). I still wanted to have a repeating header in the same document.

The patch linked below does this (in a rather crude fashion) by allowing the editor to insert a \NewPageHeader at any desired page break. The original header is stored above the document start and is invoked originally by a \AtBeginDocument. This does not handle wrapped pages but a use case for that scenario seems slim.

At any rate, less talk, more action - here is the patch:

https://pastebin.com/GM33Mzc1

Hi,

I get an error message when trying to knit a .Rmd document using your custom latex template.

Error compiling template "svm-latex-ms.tex" (line 101, column 3474):
  unexpected "\\"
expecting ".", "/", "(", ":", "[" or "$"
Error: pandoc document conversion failed with error 5
Execution halted

What i find at line 101, column 3474 of the *.tex document is a single backslash, not a double one - namely the second backslash in the following expression :

\"$opt_dummy_attribute\",

Any idea what might be going wrong?

The latex-ms template will break when there are underscores in the URLs shown as part of the references of the document.

The problem can be fixed by loading the underscore package as part of the packages loaded if there is a bibliography in the document, at lins 98-101:

$if(natbib)$
\usepackage{natbib}
\bibliographystyle{$if(biblio-style)$$biblio-style$$else$plainnat$endif$}
\usepackage[strings]{underscore} % protect underscores in most circumstances
$endif$

The package documentation mentions that this fix is not fail-proof, but it works fine on my end (using natbib and apsr.bst with a reference that has multiple underscores in its Url field).