Create certificate of participation
Source:R/certificate_participation.R
create_participation_certificate.Rd
Create certificate of participation (1 certificate per DIN-A4 page)
Usage
create_participation_certificate(
data = NULL,
path = NULL,
filename = NULL,
language = c("English", "Spanish"),
name.column = NULL,
affiliation.column = "",
comm.type.column = "",
title.column = "",
coauthor.column = "",
date.column = "",
email.column = NULL,
email.info = NULL,
type = "",
event = "",
freetext = "",
signer = "",
signer.role = "",
signature.pic = NULL,
lpic = NULL,
rpic = NULL,
font = NULL,
keep.files = FALSE,
template = NULL
)
Arguments
- data
A data frame containing participants' names and contributions.
- path
path Character. Path to folder where the PDF certificates will be saved.
- filename
Character. Filename of the pdf. If NULL, default is "Participation" for English, "Participacion" for Spanish".
- language
Character. Select 'English' or 'Spanish'.
- name.column
Character. Name of the column in
data
storing participants' name.- affiliation.column
Character (optional). Name of the column in
data
storing participants' affiliation- comm.type.column
Character. Name of the column in
data
reporting participation type (e.g. poster, oral communication, etc)- title.column
Character. Name of the column in
data
storing the title of the contribution.Name of the column in
data
storing the names of the coauthors to the contribution.- date.column
Character. Name of the column in
data
storing dates of participation.- email.column
Character. Name of the column in
data
storing attendees' email address to automatically send them their certificates.- email.info
Object created using
configure_email()
function.- type
Character (optional). Type of event (conference, workshop, seminar...)
- event
Character. Title of the event
- freetext
Character (optional). Free text to insert before the date. Can include LaTeX commands (see examples).
- signer
Character. Person who signs the certificate
- signer.role
Character. Signer's role or position
- signature.pic
Character (optional) Path to a PNG image to appear in the bottom, above signer's name.
- lpic
Character (optional) Path to a PNG image to appear in the top-left.
- rpic
Character (optional) Path to a PNG image to appear in the top-right.
- font
Character. Font face to use. Default is Latin Modern. NOTE: not all fonts are supported, so unexpected results may occur. A list of fonts is available at https://tug.org/FontCatalogue/opentypefonts.html. See Details for more information.
- keep.files
Logical. Keep the RMarkdown template and associated files in the output folder? Default is FALSE.
- template
Character (optional) RMarkdown template to use. If not provided, using the default template included in
labeleR
.
Value
PDF certificates are saved on disk, in the folder defined
by path
. If keep.files = TRUE
, the RMarkdown template and PNG logo files
will also appear in the same folder.
Details
font
Not all fonts can be used. Consider only those which are stated to be 'Part of TeX Live',
and have OTF and TT available. Additionally, fonts whose 'Usage' differs from
\normalfont
, \itshape
and \bfseries
usually fail during installation and/or rendering.
Several fonts tried that seem to work are:
libertinus
accanthis
Alegreya
algolrevived
almendra
antpolt
Archivo
Baskervaldx
bitter
tgbonum
caladea
librecaslon
tgchorus
cyklop
forum
imfellEnglish
LobsterTwo
quattrocento
Examples
if (FALSE) { # interactive()
create_participation_certificate(
data = participation.table,
path = "labeleR_output",
language = "Spanish",
name.column = "Name",
affiliation.column = "House",
comm.type.column = "Comm.type",
title.column = "Title",
date.column = "Date",
type = "online seminar",
event = "Hogwarts School of Witchcraft and Wizardry",
freetext = "which lasted 2 hours",
signer = "A.P.W.B. Dumbledore",
signer.role = "School Headmaster",
lpic = NULL,
rpic = NULL,
signature.pic = NULL,
font = "libertinus"
)
}