ob 1.0.10

A Blog and RSS system written in Rust.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144

<br/>
<img src="https://image.flaticon.com/icons/png/512/4229/4229823.png" height="200" width="200"/>

# 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, edit or regenerate entries from the RSS feed, rolling blog and standalone entry pages simultaneously.   🚀
- Works on MacOS, Linux and Windows.   🖥
- Less than 450 lines of code.   🏝
- Blazingly fast.   🔥

## Installation

Install Rust:

```shell
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
```

Install OB:

```shell
cargo install ob
```

## Setup

You will need to create four files:

- A Rolling Blog File where the blog entries will be listed.

```html
<!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.

```html
<!DOCTYPE html>
<html lang="en">
  <head>
    <title></title>
    <meta charset="utf-8"/>
  </head>
  <body>
    <!-- OB -->
  </body>
</html>
```

- An RSS feed.

```xml
<?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.

```json
{
    "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).

```html
<!-- OB -->
```

When you publish a blog post, it will be added directly below that line in the proper format.

## Usage

```
USAGE:
    ob <SUBCOMMAND>

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information

SUBCOMMANDS:
    delete     Deletes an entry
    edit       Edit a published entry
    help       Prints this message or the help of the given subcommand(s)
    new        Create a new draft
    publish    Publish a daft
    regen      Regenerates all blog entries
```

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:**

```shell
ob new
```

<br>

### You can see an example on [my blog](https://oliverbrotchie.github.io/) or [OB's website](https://oliverbrotchie.github.io/ob/) located in the `/docs` folder.