GitBlog.md (WIP)

This is a work in progress, some information written here might not be true yet.

A static blog using Markdown pulled from your git repository.

Flow

Installation

1. Download and install the latest version from the repo

git clone https://github.com/klemek/gitblog.md.git
npm install

2. Create your config file

cd gitblog.md
cp config.example.json config.json

then edit the config.json file with your values :

default values for config.json

{
  "nodePort": 3000,
  "dataDir": "data",
  "modules" : {
    "plantuml" : false,
    "rss": true,
    "webhook": true
  },
  "home" : {
    "index" : "index.ejs"
  },
  "article" : {
    "index" : "index.md"
  },
  "rss" : {
    "endpoint" : "/rss",
    "length" : 10
  },
  "webhook" : {
    "endpoint": "/webhook",
    "secretFile": "git_secret"
  }
}

3. Start your server

npm start
#or
node src/server.js

You might want to use something like screen to separate the process from your current terminal session.

4. Create and init your git source

You need to create a new repository on your favorite Git service.

#gitblog.md/
cd data
git remote add origin <url_of_your_repo.git>
git push -u origin master

5. Refresh content with a webhook (optional)

At first start, a git_secret file will be generated, use it to create a new webhook as following :

• Payload URL : https://<url_of_your_server>/webhook
• Content type : application/json
• Secret : <content of the git_secret file>
• Events : Just the push event

On GitHub, webhooks can be created in the Settings/Webhooks part of the repository.