Cyberia  Culture  Blog  Calendar  Donate  Matrix

Capsul ->  Nullhex ->  Git ->  Docs ->  Mailing Lists ->

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.

for example:

+------------------------------------+---------+
|               Col1                 |  Col2   |
+------------------------------------+---------+
| trash                              | Value 2 |
| garbage                            | cols    |
| This is a pretty traditional table |         |
+------------------------------------+---------+

or:

┌──────────────────────────────────┬─────────┬
│               Col1               │  Col2   │
├──────────────────────────────────┼─────────┼
│ Value 1                          │ Value 2 │
│ Separate                         │ cols    │
│ This is a row with only one cell │         │
└──────────────────────────────────┴─────────┴

or, simply:

           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 git@cyberia.club: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 misc@c3f.net
mailing list yet, be sure to subscribe.

mailto:ml@c3f.net?subject=subscribe%20misc

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="misc@c3f.net" HEAD^

Tah dah! That's it, your patch has been submitted.


~~~~~~~~~~~~~
~~LA FINALE~~
~~~~~~~~~~~~~
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.

Love,


^(;,;)^ j3s ^(;,;)^


(c) Attribution-ShareAlike 4.0 International
    Cyberia Computer Club 2020-∞


View page source