Update README.md
This commit is contained in:
@@ -1,90 +1,6 @@
|
|||||||
# GitBlog.md (WIP)
|
# GitBlog.md (WIP)
|
||||||
> This is a work in progress, some information written here might not be true yet.
|
> This is a work in progress, development are in the branch 'dev'
|
||||||
|
|
||||||
[](https://travis-ci.org/Klemek/GitBlog.md)
|
[](https://travis-ci.org/Klemek/GitBlog.md)
|
||||||
|
|
||||||
A static blog using Markdown pulled from your git repository.
|
A static blog using Markdown pulled from your git repository.
|
||||||
|
|
||||||
## Flow
|
|
||||||
|
|
||||||

|
|
||||||
|
|
||||||

|
|
||||||
|
|
||||||

|
|
||||||
|
|
||||||

|
|
||||||
|
|
||||||
## Installation
|
|
||||||
**1. Download and install the latest version from the repo**
|
|
||||||
```bash
|
|
||||||
git clone https://github.com/klemek/gitblog.md.git
|
|
||||||
npm install
|
|
||||||
```
|
|
||||||
**2. Create your config file**
|
|
||||||
```bash
|
|
||||||
cd gitblog.md
|
|
||||||
cp config.example.json config.json
|
|
||||||
```
|
|
||||||
then edit the config.json file with your values :
|
|
||||||
> default values for config.json
|
|
||||||
````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**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
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](https://github.com/new) on your favorite Git service.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
#gitblog.md/
|
|
||||||
cd data
|
|
||||||
git init
|
|
||||||
git add .
|
|
||||||
git commit -m "initial commit"
|
|
||||||
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.
|
|
||||||
|
|||||||
Reference in New Issue
Block a user