1
0
mirror of https://gitlab.com/MisterBiggs/latex-bingo.git synced 2025-06-16 07:06:49 +00:00

added source

This commit is contained in:
Anson 2020-09-28 21:35:36 -07:00
parent 9455f01059
commit 1aa21ac83b

View File

@ -1,4 +1,7 @@
# Forked From https://github.com/jessehamner/BingoCards
# BingoCards # BingoCards
[LaTeX](http://tug.org/) and [python](http://www.python.org)-powered randomized bingo cards with custom cells. [LaTeX](http://tug.org/) and [python](http://www.python.org)-powered randomized bingo cards with custom cells.
Takes a user-supplied list of phrases and randomly assigns them to a user-specified number of bingo cards, using LaTeX. Takes a user-supplied list of phrases and randomly assigns them to a user-specified number of bingo cards, using LaTeX.
A python script creates a complete checklist for all possible bingo card cells. A python script creates a complete checklist for all possible bingo card cells.
@ -28,8 +31,8 @@ We don't \emph{win} anymore
``` ```
:exclamation: **Important:** the list of items must _not_ include a final semicolon. :exclamation: **Important:** the list of items must _not_ include a final semicolon.
LaTeX interprets a final semicolon to mean "the next entry is a blank", LaTeX interprets a final semicolon to mean "the next entry is a blank",
and you will end up with randomly empty cells on the bingo cards. and you will end up with randomly empty cells on the bingo cards.
The list should terminate only with a close-brace, though the brace can be on a new line. The list should terminate only with a close-brace, though the brace can be on a new line.
The LaTeX file, when run, will take the list, pick 24 at random The LaTeX file, when run, will take the list, pick 24 at random
@ -42,7 +45,7 @@ The LaTeX file includes a for-loop to create some number (initially set at 50) o
## Customizing the Code ## Customizing the Code
The bingo cards also include a small label below the bingo grid, so customize the ```\biglabel``` macro to suit your event. The bingo cards also include a small label below the bingo grid, so customize the `\biglabel` macro to suit your event.
```LaTeX ```LaTeX
% make a nice identifier for the card (in case, say, there is more than one % make a nice identifier for the card (in case, say, there is more than one
@ -79,10 +82,10 @@ to be more centered.
## The Master Checklist ## The Master Checklist
The python script parses the entire list and provides a ```longtable``` The python script parses the entire list and provides a `longtable`
checklist for the moderator to use when evaluating a given event. checklist for the moderator to use when evaluating a given event.
The ```bingochecklist.tex``` file reads the output of the python script, The `bingochecklist.tex` file reads the output of the python script,
which is a file called ```checklist1.tex```. which is a file called `checklist1.tex`.
So, from a terminal on your machine of choice, run So, from a terminal on your machine of choice, run
@ -92,9 +95,9 @@ python makechecklist.py
And if you've got all the files where they are supposed to be, it will And if you've got all the files where they are supposed to be, it will
form up the guts of the checklist. form up the guts of the checklist.
Next, compile ```bingochecklist.tex``` a few times and you'll be good to go. Next, compile `bingochecklist.tex` a few times and you'll be good to go.
You need to compile the TeX file at least twice because it uses You need to compile the TeX file at least twice because it uses
```longtable```, and column widths are determined dynamically over `longtable`, and column widths are determined dynamically over
the course of a few LaTeX compiles. the course of a few LaTeX compiles.
Jesse Hamner, 2016-2017. :rocket: Jesse Hamner, 2016-2017. :rocket: