Words are very necessary – Notes on building a dictionary
A presentation at JAMStack_berlin in in Berlin, Germany by Oscar
Words are very necessary. Notes on building a dictionary
Never again.
«That’s what I would like to say to my daughter, my granddaughter, peers of my daughter and granddaughter: Do not be indifferent.» ☞ Marian Turski, Auschwitz Survivor
https://r.ovl.design/jamstack-2001 Twitter: @_ovlb
Agenda Intro Tech & Code Feature Outlook
Disclaimer While I am working on this project it is not a project that is made for a privileged white dude. I just lent my expertise
What is Self-Defined?
Words about people
«Self-Defined seeks to provide more inclusive, holistic, and fluid definitions to reflect the diverse perspectives of the modern world.» ☞ Tatiana Mac www.selfdefined.app
www.selfdefined.app
Building Blocks
A dictionary is more than words 🙀
index.html 963 lines of code
Let humans focus on the definitions
Eleventy A simpler static site generator Invented by Zach Leatherman
Collections Automated collections by tags
Filtered by glob: filters getAll()
Filters & Shortcodes Thats it for Eleventy Link to courses and docs in the slides
Basic Definition Content
There are some things we haven’t yet covered
Advanced Definition Content Front Matter
Flags Visual clues helping to categorise words
Alternative words
Thing to note: Link
Table of Content
«this will not be remembered as the best code i’ve written.» ☞ Me github.com/tatianamac/selfdefined/blob/master/.eleventy.js#L80 It’s liberating that users won’t suffer from it
Thing to note: sections
Skip in ToC
Thing to note: Link
Feature Outlook
Self-Definitions Add your definition of you
API
Twitter Bot Slack-Bot …
Inclusive Contribution Workflow Lowering the barriers to entry
Outro
Ways to help Contribute
Ways to help Sponsor Tatiana
Ways to help Volunteer writing, design, dev help
Re-define the world Speak up. Act up. Dict just a small part
https://r.ovl.design/jamstack-2001 Twitter: @_ovlb
Danke. Oscar Braunert Thank you. www.ovl.design o@ovl.design @_ovlb Merci. code & design спасибо. ♡
We all use words. This announcement is made up of words. And some words are well-defined by a society that means to oppress with these words. Words that sometime need to be reclaimed, sometime used with caution or not at all. This is why Tatiana Mac started [self-defined] (https://www.selfdefined.app). A resource where the people impacted by these words can add their own definitions. As the claim goes: «we define our words, but they don’t define us».
Recently, it was rebuilt with Eleventy and a huge bunch of Markdown files. This change presented the team with some unique challenges, as Markdown wasn’t invented to build a dictionary.
This talk will provide with you with a look into the technical present and future of self-defined. How can you handle complex data structures with Markdown? To what extent does a static site make sense? And how can you add your definition of you?
for free. You
can too.
Resources
The following resources were mentioned during the presentation or are useful additional information.
-
Auschwitz, 75 years on: “Do not be indifferent”, says death camp survivor Marian Turski
-
Homepage of Tatiana Mac
-
Self-Defined on GitHub
-
Homepage of Zach Leatherman
-
Eleventy Documentation
-
CERN 2019 WorldWideWeb Rebuild
-
Every Layout
-
Zach Leatherman’s Twitter Archive
-
Own Your Content on Social Media Using the IndieWeb
Talk by Zach Leatherman explaining the thinking behind the Twitter Archive
-
Teaching in the open: Eleventy
Eleventy online course by Jérôme Coupé, freely available on GitHub
-
Tatiana’s GitHub sponsor page
