Generating a Book Bingo Chart in Hugo

Another r/Fantasy 2021 Book Bingo post! How in the world am I generating this (updating) chart in Hugo?

2021 Book Bingo

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>
  • range over the rows and columns, building an HTML table
  • In each cell:
    • Include the title of the cell from the data page
    • Build a index (and indexHard) for that row and column
    • Search over all pages in the matching Taxonomy, use the Page Data to see if they match this specific index or 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!