c0de.dev-blog/readme.md

c0de.dev Blog

This is a Pelican based blog that powers c0de.dev. There's not really a whole lot here, but it contains all the configuration files and plugins/themes.

Installation

1. SSH into your server
2. Clone the repo - git clone --recurse-submodules https://github.com/alopexc0de/c0de.dev-blog
3. cd c0de.dev-blog
4. Install the config and plugins - make install

Updating

1. SSH into your server
2. cd c0de.dev-blog
3. make update

Making new posts

For seperation, I store the content in a private repo (can't read my drafts and encrypted blogs without the password). Also as a matter of choice, I'm using Markdown as markup language.

Categories are defined per folder in the c0de.dev-content repository. To create a new category, simply create a new folder in that repo with at least one post within. For posts without a category, simply throw the new posts in the root of the repo.

When a new post has been created (with the appropiate metadata), the steps to generate the output is as follows:

1. SSH into your server
2. cd c0de.dev-blog
3. Update all submodules (installs new plugins too) - make update
4. cd pelican
5. Clear the output cache if themes or globals changed - make clean
6. Generate the new static HTML site - make html

TODO

• Service/Unit to run this in a server on prod
• Git hooks to automatically fetch content
• NginX config