Another r/Fantasy 2021 Book Bingo post! How in the world am I generating this (updating) chart in Hugo?
2021 Book Bingo
 Hard Mode ✓ Five SFF Short Stories Any short story as long as there are five of them. Hard Mode: Read an entire SFF anthology or collection. |  by R.F. Kuang Hard Mode ✓ Set in Asia Any book set in Asia or an analogous fantasy setting that is based on a real-world Asian setting. Hard Mode: Written by an Asian author. |  Hard Mode ✓ A Selection from the r/Fantasy A to Z Genre Guide Any book listed in our A to Z Genre Guide. Hard Mode: A book by a BIPOC author. |  by T.J. Klune Hard Mode ✓ Found Family Or as TV Tropes calls it - Family of Choice. Often not biologically related, these relationships in a group typically form through bonds of shared experiences and become as important (in some cases more) as family members. Hard Mode: Featuring an LGBTQ+ character as a member of the found family. |  Hard Mode ✓ First Person POV Defined as: a literary style in which the narrative is told from the perspective of a narrator speaking directly about themselves. Link for examples. Hard Mode: There is more than one perspective, but each perspective is written in First Person. |
 Book Club OR Readalong Book Any past or active r/Fantasy book clubs count as well as past or active r/Fantasy readalongs. See our full list of book clubs here. Hard Mode: Must read a current selection of either a book club or readalong and participate in the discussion. |  by Mary Norton Hard Mode ✓ New to You Author This would be an author whose work you’ve yet to read, meaning no novel, no novella, no short fiction, etc. Hard Mode: Not only have you never read their work before but you’ve not heard much about this author or their work before deciding to try a book by them. |  Hard Mode ✓ Gothic Fantasy Gothic Fantasy is similar to Gothic Fiction but it includes fantasy elements or settings. Gothic Fiction is “a style of writing that is characterized by elements of fear, horror, death, and gloom, as well as romantic elements, such as nature, individuality, and very high emotion. These emotions can include fear and suspense.” (Source) Here is a good ‘introductory post’ on Gothic Fantasy for further reading from Book Riot. Hard Mode: NOT one of the ten titles listed in the Book Riot article. |  by Warren Ellis Hard Mode ✓ Backlist Book For our purposes we’re considering ‘backlist’ an author’s older titles that are not their latest published book or part of a currently running series (no further sequels announced when you read it). The author must also be a currently publishing author. Hard Mode: Published before the year 2000. |  Hard Mode ✓ Revenge-Seeking Character Book has a character whose main motivation in the story is revenge. Hard Mode: Revenge is central to the plot of the entire book. |
 by Mur Lafferty Hard Mode ✓ Mystery Plot The main plot of the book centers around solving a mystery. Hard Mode: Not a primary world Urban Fantasy (secondary world urban fantasy is okay!) |  Hard Mode ✓ Comfort Read This is one of those ‘personal to you’ squares. Any book that brings you comfort while reading it. You can use a reread on this square and it WON’T count for your ‘1 reread’. Hard Mode: Don’t use a reread, find a brand new comfort read! |  Hard Mode ✓ Published in 2021 A book published for the first time in 2021 (no reprints or new editions). Hard Mode: It’s also a debut novel–as in it’s the author’s first published novel. |  by Jamie Delano Hard Mode ✓ Cat Squasher: 500+ Pages Time to go tome hunting–find a book that is over 500 pages in length. Hard Mode: Lion Squasher - a book that is over 800 pages. |  Hard Mode ✓ SFF-Related Nonfiction Back by popular demand! Any nonfiction book that is related to SFF. Could be a book about the history of something in SFF, writing SFF, essays from a SFF writer, etc. Hard Mode: Published within the last five years. |
 by Kaela Rivera Hard Mode ✓ Latinx or Latin American Author Author is from Latin America or of Latinx/Hispanic heritage. Hard Mode: Book has fewer than 1000 Goodreads ratings. |  by R.S. Craig Hard Mode ✓ Self-Published Only self-published novels will count for this square. If the novel has been picked up by a publisher as long as you read it when it was self-pubbed it will still count. Hard Mode: Self-pubbed and has fewer than 50 ratings on Goodreads. |  Hard Mode ✓ Forest Setting This setting must be used be for a good portion of the book. Hard Mode: The entire book takes place in this setting. |  by Tamsyn Muir Hard Mode ✓ Genre Mashup A book that utilizes major elements from two or more genres. Examples: a romance set in a fantasy world, a book that combines science fiction and fantasy, etc. Hard Mode: Three or more genres are combined. |  by Matt Haig Hard Mode ✓ Has Chapter Titles A book where each chapter has a title (other than numbers or just a character’s name). Hard Mode: Chapter title is more than a single word FOR EVERY SINGLE CHAPTER |
 Hard Mode ✓ Title: _____ of _____ The title of the book must feature the format X of Y. Example: The Harp of Kings by Juliet Marillier. Hard Mode: _____ of ______ and ________. Format of title must be X of Y and Z. |  by Andy Weir Hard Mode ✓ First Contact From Wikipedia: Science Fiction about the first meeting between humans and extraterrestrial life, or of any sentient species’ first encounter with another one, given they are from different planets or natural satellites. Hard Mode: War does not break out as a result of contact. |  Trans or Nonbinary Character A book featuring a trans or nonbinary character that isn’t an alien or a robot. Hard Mode: This character is a main protagonist. |  Hard Mode ✓ Debut Author An author’s debut novel or novella. Hard Mode: The author has participated in an AMA. AMA List linked here. |  by Libba Bray Hard Mode ✓ Witches A book featuring witches. Note - characters practicing what is traditionally in their culture referred to as witchcraft would also count. For example brujos or brujas would count for this square. Hard Mode: A witch is a main protagonist. |
Full categories
Five SFF Short Stories
Any short story as long as there are five of them.
Hard Mode: Read an entire SFF anthology or collection.
Set in Asia
Any book set in Asia or an analogous fantasy setting that is based on a real-world Asian setting.
Hard Mode: Written by an Asian author.
A Selection from the r/Fantasy A to Z Genre Guide
Any book listed in our A to Z Genre Guide.
Hard Mode: A book by a BIPOC author.
Found Family
Or as TV Tropes calls it - Family of Choice. Often not biologically related, these relationships in a group typically form through bonds of shared experiences and become as important (in some cases more) as family members.
Hard Mode: Featuring an LGBTQ+ character as a member of the found family.
First Person POV
Defined as: a literary style in which the narrative is told from the perspective of a narrator speaking directly about themselves. Link for examples.
Hard Mode: There is more than one perspective, but each perspective is written in First Person.
Book Club OR Readalong Book
Any past or active r/Fantasy book clubs count as well as past or active r/Fantasy readalongs. See our full list of book clubs here.
Hard Mode: Must read a current selection of either a book club or readalong and participate in the discussion.
New to You Author
This would be an author whose work you’ve yet to read, meaning no novel, no novella, no short fiction, etc.
Hard Mode: Not only have you never read their work before but you’ve not heard much about this author or their work before deciding to try a book by them.
Gothic Fantasy
Gothic Fantasy is similar to Gothic Fiction but it includes fantasy elements or settings. Gothic Fiction is “a style of writing that is characterized by elements of fear, horror, death, and gloom, as well as romantic elements, such as nature, individuality, and very high emotion. These emotions can include fear and suspense.” (Source) Here is a good ‘introductory post’ on Gothic Fantasy for further reading from Book Riot.
Hard Mode: NOT one of the ten titles listed in the Book Riot article.
Backlist Book
For our purposes we’re considering ‘backlist’ an author’s older titles that are not their latest published book or part of a currently running series (no further sequels announced when you read it). The author must also be a currently publishing author.
Hard Mode: Published before the year 2000.
Revenge-Seeking Character
Book has a character whose main motivation in the story is revenge.
Hard Mode: Revenge is central to the plot of the entire book.
Mystery Plot
The main plot of the book centers around solving a mystery.
Hard Mode: Not a primary world Urban Fantasy (secondary world urban fantasy is okay!)
Comfort Read
This is one of those ‘personal to you’ squares. Any book that brings you comfort while reading it. You can use a reread on this square and it WON’T count for your ‘1 reread’.
Hard Mode: Don’t use a reread, find a brand new comfort read!
Published in 2021
A book published for the first time in 2021 (no reprints or new editions).
Hard Mode: It’s also a debut novel–as in it’s the author’s first published novel.
Cat Squasher: 500+ Pages
Time to go tome hunting–find a book that is over 500 pages in length.
Hard Mode: Lion Squasher - a book that is over 800 pages.
SFF-Related Nonfiction
Back by popular demand! Any nonfiction book that is related to SFF. Could be a book about the history of something in SFF, writing SFF, essays from a SFF writer, etc.
Hard Mode: Published within the last five years.
Latinx or Latin American Author
Author is from Latin America or of Latinx/Hispanic heritage.
Hard Mode: Book has fewer than 1000 Goodreads ratings.
Self-Published
Only self-published novels will count for this square. If the novel has been picked up by a publisher as long as you read it when it was self-pubbed it will still count.
Hard Mode: Self-pubbed and has fewer than 50 ratings on Goodreads.
Forest Setting
This setting must be used be for a good portion of the book.
Hard Mode: The entire book takes place in this setting.
Genre Mashup
A book that utilizes major elements from two or more genres. Examples: a romance set in a fantasy world, a book that combines science fiction and fantasy, etc.
Hard Mode: Three or more genres are combined.
Has Chapter Titles
A book where each chapter has a title (other than numbers or just a character’s name).
Hard Mode: Chapter title is more than a single word FOR EVERY SINGLE CHAPTER
Title: _____ of _____
The title of the book must feature the format X of Y. Example: The Harp of Kings by Juliet Marillier.
Hard Mode: _____ of ______ and ________. Format of title must be X of Y and Z.
First Contact
From Wikipedia: Science Fiction about the first meeting between humans and extraterrestrial life, or of any sentient species’ first encounter with another one, given they are from different planets or natural satellites.
Hard Mode: War does not break out as a result of contact.
Trans or Nonbinary Character
A book featuring a trans or nonbinary character that isn’t an alien or a robot.
Hard Mode: This character is a main protagonist.
Debut Author
An author’s debut novel or novella.
Hard Mode: The author has participated in an AMA. AMA List linked here.
Witches
A book featuring witches. Note - characters practicing what is traditionally in their culture referred to as witchcraft would also count. For example brujos or brujas would count for this square.
Hard Mode: A witch is a main protagonist.
To start, I have a Data file for the names of the categories:
-
- "SFF anthology or collection"
- "Set in Asia (Hard: by an Asian author)"
...
-
- "r/Fantasy Book Club (Hard: with participation)"
...
...
It’s just markdown (for links) in a nested list. 5x5 (hard coded) at the moment, but I could probably make that flexible if I wanted.
Next, I have to add a bit of metadata to each post that’s going to be included in a Book Bingo:
bingo:
- 2021 Book Bingo
bingo-data:
2021 Book Bingo: [3x1+]
It’s a bit annoying that I have to do this. What I’d really want is for the Taxonomy to support a hash as the data field, so I could just do:
bingo:
2021 Book Bingo: [3x1+]
But if you do that, the post isn’t included in the bingo taxonomy. So I have to include both. If I figure out a better way to do that, I’ll update this post, but for the moment, it’s okay. So bingo is a Taxonomy (so I can list all pages that match it without cycling through all pages), while bingo-data is just a $Page.Param that I can access. The field is: {row}x{column}{hard mode flag}.
Finally, I actually make a shortcode that can use that information and build a table:
{{- $title := .Get 0 -}}
{{- $slug := $title | urlize }}
{{- $data := index $.Site.Data.bingo $title -}}
<h1>{{ $title }}</h1>
<table class="bingo">
{{- range $row := seq 0 4 -}}
<tr>
{{- range $col := seq 0 4 -}}
<td>
{{- $index := (printf "%dx%d" (add 1 $row) (add 1 $col) )}}
{{- $indexHard := (printf "%dx%d+" (add 1 $row) (add 1 $col) )}}
{{- $title := index $data $row $col }}
<p>{{ $title | markdownify }}</p>
{{- range $page := index $.Site.Taxonomies "bingo" $slug -}}
{{- $squares := index $page.Params "bingo-data" (replace $slug "-" " ") -}}
{{- if (or (in $squares $index) (in $squares $indexHard)) -}}
<a href="{{ $page.Permalink }}">
<figure>
{{ safeHTML (index (findRE "(?m:<img.*?>)" .Content 1) 0) }}
<figcaption>{{ .Title }}</figcaption>
</figure>
</a>
{{- if in $squares $indexHard -}}
<p>(Hard Mode)</p>
{{- end -}}
{{- end -}}
{{- end -}}
</td>
{{- end -}}
</tr>
{{- end -}}
</table>
rangeover the rows and columns, building an HTML table- In each cell:
- Include the title of the cell from the data page
- Build a
index(andindexHard) for that row and column - Search over all pages in the matching Taxonomy, use the Page Data to see if they match this specific
indexor not - If so, include the cover as a link, plus the ‘(Hard Mode)’ flag
I’ll admit, it feels a bit hacky, but one of the beautiful things about a static site generator is that it only has to run when rebuilding my site. The end result is just HTML. And I only have to update the individual pages, not keep a central list. I think that’s pretty neat.
Perhaps I should figure out more things I can do with Page Data. Perhaps keep track of authors as well as series? Ratings? Who knows!