name-tag-guru

LaTeX template to quickly create beautiful name tags (badges) for collaboration meetings

The original code for the badges was created by Yao-Yuan Mao (https://github.com/LSSTDESC/name-tag-guru) and Adrien Helias designed the template badges for the CASCA application.

Usage

• Use your favorite spreadsheet app (e.g., Excel) to create a list of string of

  \participant{Large-font Badge Name}{Small-font Badge Name}{Affiliation}{Pronouns}{\command}

  and copy and paste to the LaTeX template latex/main.tex.

  Usually the spreadsheet formula would look like this:

  = "\participant{" & B1 & "}{" & B2 & "}{" & B3 & "}{" & B4 & "}{\" & B5 & "}"
  

  with B1 to B5 being the cells that specify the large- and small-font badge names, affiliation, pronouns, and highlighting command.

• Use \emptyticket{} to add empty name tags with the background.

• You can define your own highlight commands, such as:

  \newcommand*{\loc}{\highlight{orange}}

• To include CJK character, uncomment the following two lines. One also needs to compile with xelatex. A CJK font is also required (current set to Noto Sans CJK TC).

  \usepackage{xeCJK}
  \setCJKmainfont{Noto Sans CJK TC}

• To print two-sided name tags, uncomment these two lines:

  \hoffset=1.1in
  \backside

• Dimensions in the current template is designed to fit Avery Name Badges #74459. But you can easily change the dimension setting to fit you name tags.

  There relevant quantities are:

  • \hoffset, \voffset: setting page margins;
  • \ticketSize, \ticketDistance: setting the size of badges and the padding in between (current set in units of 0.01in);
  • \ticketNumbers: setting the number of badges per page;
  • the numbers in parentheses after \put: setting the location of each element.

• When ready to print, remember to remove the boxed option in

  \usepackage[boxed]{ticket}

  Leave the boxed option on to see how the badges would look like.

Automated badge generation from registration database

We provide a script that can automagically query the registration database from the meetings-registration-form repository to generate a participants.tex file. To install the sqlalchemy requirement:

$ pip install sqlalchemy

Then copy the secret heroku database URL from the settings tab of the Heroku service into a db_secret file at the root of this repo. Be careful not to commit or share this file! Finally, run the following command at the root of this repo:

$ python badges_from_db.py

And that's it, you now have a participants.tex file in the latex folder, ready to be processed.

Contributers

This template is designed and implemented by Yao-Yuan Mao, with helpful suggestions contributed by Alex Kim, Rachel Mandelbaum, Phil Marshall, Anže Slosar, and Michael Wood-Vasey.