]> git.r.bdr.sh - rbdr/blog/blob - README.md
Update version
[rbdr/blog] / README.md
1 # blog
2
3 Blog at unlimited.pizza -> Only
4
5 ## How to install
6
7 `npm install -g .` will expose the `blog` binary to your CLI.
8
9 ## How to add a new entry
10
11 Create a directory with a `.md` markdown file, and an `/assets`
12 directory with anything you want in there. This can be in any directory.
13
14 ```
15 .
16 └── this-is-an-example-post
17 ├── assets
18 │   └── example.png
19 └── this-is-an-example-post.md
20 ```
21
22 You can add this to the blog using the following command, it will shift
23 all entries and remove the oldest one if limit of posts is reached
24 (defualts to 3):
25
26 `blog --add path/to/blog_post`
27
28 These commands will regenerate the static files. At that point you can
29 preview your blog by serving the files on the `static` directory.
30
31 If you need to make corrections use:
32
33 `blog --update path/to/blog_post`
34
35 This will replace the latest with the contents of the `path` without
36 shifting the existing entries.
37
38 `blog --publish`
39
40 Will publish the blog.
41
42 ## How to publish
43
44 At the moment, the app does not include any publishers. [surge][surge] is an easy
45 way to do it, just point it to your static directory.
46
47
48 [surge]: https://surge.sh