How to write a blog post for Cyberia
Imported from https://cyberia.club/blog Originally published: 2020-02-25
- UPDATE 2023-05-24: This is a historical document for the previous blog system for Cyberia. The new blogging system, writefreely, has a web editor that is simpler to approach without this excellent writeup. However, it does not have the classic Cyberia asthetics of the original (white text on a black background. You can still visit the old blog at https://cyberia.club/blog
Subject: How to write a blog post for Cyberia From: j3s Date: 25/02/2020
Hi everyone! The new site design is live! Mad inspiration taken from https://k1ss.org
In this blog post, I'll be walking through how to add a new blog post to the site, but first: specific requirements for formatting your blog post.
Tools ============ * git and git send-email (https://git-send-email.io/) * a text editor
Requirements (in the form of commandments) ============ * thou post shalt be written in plain text > posts appear exactly as written * no line of thy post shalt be wider than 57 characters > this breakeths the smol phones > this rule isn't firm, but is a best practice
So, with the above in your head, you're ready to write a blog post. You have questions! Naturally. Let me preemptively answer them.
+==================+ | WHY NOT MARKDOWN?| +==================+ because everybody knows plain text
+====================+ | WHAT ABOUT TABLES? | +====================+ the beauty of plain ascii is that you get to decide how to do your own tables.
+——————————————————+————–+ | Col1 | Col2 | +——————————————————+————–+ | trash | Value 2 | | garbage | cols | | This is a pretty traditional table | | +——————————————————+————–+
┌──────────────────────────────────┬─────────┬ │ Col1 │ Col2 │ ├──────────────────────────────────┼─────────┼ │ Value 1 │ Value 2 │ │ Separate │ cols │ │ This is a row with only one cell │ │ └──────────────────────────────────┴─────────┴
random text header
awihfiweoifj owiefj w strange Big blah blah time things Blah blah blah
The choice is yours! Just keep them under 57 chars wide! If you need wider tables, consider linking to an external source or linking to a picture.
—-THE PROCESS—- Before you put text to document, let's make things easy on you – I've written a script to generate a new blog post! It's very simple. Let's go through the steps together.
–> cd ~/projects –> git clone email@example.com:services/website –> cd website/blog –> ./mkblog title-of-blog-post –> ls -l # discover the new blog posts name
Now you can open the new blog post in the text editor of your choice! Proceed with writing it.
Now that you're finished writing, it's time to submit your blog to a maintainer for approval! The simplest way of doing this is via email. We use the process built into git for this – git-send-mail.
First, if you aren't subscribed to the firstname.lastname@example.org mailing list yet, be sure to subscribe.
After you have received confirmation that you were subscribed to the mailing list, send us a patch!
–> git add . –> git commit -m 'Add blog post about unicorns' –> git send-email —to=“email@example.com” HEAD^
Tah dah! That's it, your patch has been submitted.
Now that you have submitted your own blog post, it is time to wrap up!
I've used several different header and writing styles throughout this document to give you an idea of how you can write your own posts. Hopefully that is helpful and inspiring!
I hope that you will see that plain text can be a liberating and artistic format! The only limitation is the character width :]
Now go forth and write your own post about unicorns, or games, or something even slightly related to Cyberian interests, (like how narwhals don't exist) and submit it! Make a little project out of it! It's a good way to broadcast branch happenings, meetings, or personal projects. Or talk about your new RPG system, or philosophy, or opinion!
That's all for now. As always, this post is the result of much thought, from your humble head of services.
^(;,;)^ j3s ^(;,;)^
© Attribution-ShareAlike 4.0 International Cyberia Computer Club 2020-∞