arnaucube
arnaucube/blogoPublic Self-hosted repository
blogo/README.md
README.mdRaw
 1# Blogo [![Go Report Card](https://goreportcard.com/badge/github.com/arnaucube/blogo)](https://goreportcard.com/report/github.com/arnaucube/blogo)
 2Static blog generator, templating engine from markdown and html templates
 3
 4![blogo](https://raw.githubusercontent.com/arnaucube/blogo/master/blogo-diagram.png "blogo-diagram")
 5
 6## Usage
 7```
 8Usage of blogo:
 9  -d dev mode
10  -p port (only for dev mode) (default "8080")
11```
12
13So, for local usage:
14```
15blogo -d
16```
17Which will re-generate the html files each time that a input file is modified, and will serve the html generated site at `http://127.0.0.1:8080`.
18
19For a single use, you can simply use `blogo` command, which will generate the html files without serving them.
20
21Each build also generates an RSS 2.0 feed at `rss.xml` and adds an RSS auto-discovery link to generated HTML pages. Posts may include an optional `date` in RFC 3339 or `YYYY-MM-DD` format. Posts without a date remain in the feed without a `pubDate`.
22
23A complete usage example can be found in this repo: https://github.com/arnaucube/blogoExample
24
25### Config example
26```json
27{
28    "title": "Blogo Blog",
29    "relativePath": "",
30    "absoluteUrl": "https://blog.website.com",
31    "indexTemplate": "index.html",
32    "postThumbTemplate": "postThumbTemplate.html",
33    "posts": [
34	{
35	    "thumb": "article0_thumb.md",
36	    "md": "article0.md",
37	    "metaimg": "img/article0-img.png",
38	    "metadescr": "description of the article 0",
39	    "date": "2022-11-24"
40	}
41    ],
42    "copyRaw": [
43	"css",
44	"img",
45	"js"
46    ]
47}
48```
49
50
51---
52
53Blogo is used in https://arnaucube.com/blog