OB - Oliver's Blog Script
A Blog and RSS system written in Rust.
Features
- Converts blog entries written in Markdown into HTML. ✍🏻
- Keeps a rolling blog page.
🔎 - Keeps an RSS feed which includes blog posts in full.
📰 - Creates entries in the rolling blog page that are easily modifiable with CSS.
⚡️ - One command to delete entries from the RSS feed, rolling blog and standalone entries simultaneously.
🚀 - Works on MacOS, Linux and Windows.
🖥 - Less than 350 lines of code.
🏝 - Blazingly fast.
🔥
Installation
Install Rust:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
Install OB:
cargo install ob
Setup
You will need to create four files:
- A Rolling Blog File where the blog entries will be listed.
<!DOCTYPE html>
<html lang="en">
<head>
<title>Your Blog</title>
<meta charset="utf-8"/>
</head>
<body>
<h1>Blog Updates</h1>
<ul>
<!-- OB -->
</ul>
</body>
</html>
- A Template to be filled out with the content of a blog post.
<!DOCTYPE html>
<html lang="en">
<head>
<title></title>
<meta charset="utf-8"/>
</head>
<body>
<!-- OB -->
</body>
</html>
- An RSS feed.
<?xml version="1.0" encoding="utf-8"?>
<?xml-stylesheet type="text/css" href="rss.css" ?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
<channel>
<title>Blog Title</title>
<description>Description</description>
<language>en-us</language>
<link>https://your_blog.com/rss.xml</link>
<atom:link href="https://your_blog.com/rss.xml" rel="self" type="application/rss+xml" />
<!-- OB -->
</channel>
</rss>
- A configuration file containing the paths to your blog index, template and rss files.
It should also include the address of where the blog entries will be hosted, the maximum number of posts on the rss feed and whether to include images or not.
{
"blog": "index.html",
"template": "template.html",
"rss": "rss.xml",
"items": 4,
"blog_address": "https://your_blog.com/blog/",
"images": true
}
Markers
For the system to work, add the following comment line to the Rolling Blog File, Template and RSS feed (as above).
<!-- OB -->
When you publish a blog post, it will be added directly below that line in the proper format.
Usage
USAGE:
ob [FLAGS]
FLAGS:
-d, --delete Delete an entry
-h, --help Prints help information
-n, --new Create a new draft
-p, --publish Publish a daft
-V, --version Prints version information
The first time ob is used it will create a folder at: /blog.
When you create a new draft it will be located at: /blog/drafts.
When you publish a new draft it will be located at: /blog/example.html.
Example usage:
ob --new
4 Sep 19, 2022
486 Dec 28, 2022
32 Dec 25, 2022
2 Jan 28, 2022
3 Jul 30, 2022
99 Jan 5, 2023
11 Dec 15, 2022
5 Mar 6, 2023
18 Aug 3, 2023
22 Nov 30, 2022
10 Dec 13, 2022
12 Jul 5, 2022
26 Dec 27, 2022
13 Dec 5, 2022
0 Aug 3, 2021
36 Dec 19, 2022
475 Jan 2, 2023
287 Nov 25, 2022
5 Nov 17, 2021