Descriptions, posters, stuff to show around

So I got nerdsniped again.

I was supposed to create and print descriptions for stuff we’re showcasing in IKM but instead I created a tool to automate creation of such things in the future.

The project is not yet in a state I’d like it to be, but I’ll work on it to get there, including Cloud IDE support and preview generation.

Still: even in its current form it should be usable and useful for MusicJam, CCC, GameJam, Festiwal Światła, Hack4Change, and maybe even in HS itself.

The code lives under https://github.com/hs3city/descriptions . If you want to contribute but you don’t have access just ping me here and I’ll add you.

I also attach a sample PDF generated from the current version of the code.

The idea is simple:

  • we have templates for different events
  • we have a bunch of Markdown files with descriptions
  • Typst program compiles all that into beautiful PDF pages ready for print (it can also generate sticker labels and whatnot if we want)

To add a new description, you have to add a new Markdown file to the content directory and update the content/toc.yaml file.

At this moment PDF generation is not automated on GitHub, but if you have Nix installed, you can run nix run '.#build' to create it locally. There’s also a nix run '.#watch' command that constatly watches your changes and updates the PDF in real-time.

Reactions: :mechanical_arm: ×1 (Ninufar (Marta)) · :heart: ×1 (Leszek) · :rocket: ×1 (unsolaci)

Sample PDF

Note: Please use Conventional Commits when committing changes :slightly_smiling_face:

CC @Marcin Młyński @Leszek @@vi:unsola.ci @𝓚𝓲𝓷𝓽𝓮𝓻 @aleensztajn @Traq @Emilia Ema @Asia_Lena @Claude @Ninufar (Marta) @Ijon Tichy @pawels9703

Ah, ideally these descriptions would be pulled directly from our homepage so we have a single source of truth :slightly_smiling_face:

This was not a PDF, this is…

main.pdf

ooh, neat. I can take on :united_states: translations today if noone has started it yet and make a pr for others to double-check perhaps?

Reactions: :+1: ×1 (DoomHammer) · :green_heart: ×1 (DoomHammer) · pink_heart ×2 (DoomHammer, Asia_Lena)

i prefer convenient commits, but alright :upside_down_face:

you should see the commit history of my Masters Thesis… It tells a story

Reactions: :heart: ×1 (Xorboo)

Reactions: :bullseye: ×1 (DoomHammer) · c_lang ×1 (DoomHammer)

come to think of it, this tool could also help with generating cover images for events on social platforms…

Reactions: :+1: ×1 (Xorboo)

yes, the template is not ideal as this is my very first Typst project, will work on that once I have some adult supervision re. design

propozycje tła dla plakatów HS3 ode mnie :upside_down_face:

Reactions: this ×3 (Ninufar (Marta), DoomHammer, 𝓚𝓲𝓷𝓽𝓮𝓻)

upd: fork disabled, i just pushed it to prod, along with some other improvements :seal:

Reactions: :+1: ×1 (DoomHammer)

fyi @𝓚𝓲𝓷𝓽𝓮𝓻, some existing :ukraine: translations weren’t added to toc.yaml. I haven’t touched that in case those were WIP

Together with @DoomHammer we decided that there was no point

oof, we don’t need translations anymore, why? :frowning_face_with_open_mouth: