nolboo / blogist

simple blog framework let you write blog with gist

 ____ ____ ____ ____ ____ ____ ____
||B |||L |||O |||G |||I |||S |||T ||
||__|||__|||__|||__|||__|||__|||__||
|/__\|/__\|/__\|/__\|/__\|/__\|/__\|

3 mins setup (assuming you are familiar with github, heroku and travis)

1st min: config your own blogist

1.1 fork blogist then clone to local

git clone https://github.com/<github username>/blogist.git
cd blogist

1.2 follow the first step here. and copy your github page [repo url], copy the ❗ https one, not ssh

1.3 config blogist

sh install.sh

then you will get prompt about how to setup your blogist

you’ll have to input the following:(* required)

• github_name*: your github username ❗IMPORTANT
• homepage*: your blog url, with “https?:\"
• ghpage_repo: [repo url] you copy before [:exclamation:IMPORTANT: use https link, not ssh!]
• author_name: optional, by default your git config user.name
• blog_title: title of your blog
• description:description of your blog
• theme: choose your blog theme, by default lumen, or anythin you like from here http://bootswatch.com/
• branch: default master, or gh-pages if you like.
• disqus_name: disqus short name
• google_analytics: google analytics code

after you complete the config, a settings.json will be generated. if you want to change the settings later, just modify this file.

alternatively, you may copy my settings.json file change things to yours, and put it in config/. then run `sh install.sh`

2nd min: configure travis ci (if you don’t need SEO because gist already does that for you, skip this, you’r DONE!)

2.1 Setup CI

open https://travis-ci.org/profile and find your repo

toggle on ❗

then go grab a cup of coffee, you’ll see the repo show up in travis when back.

2.2 push to github page

git add config/settings.json
git commit -am "init config"
git push origin master

then wait for the ci pass.

2.3 verify

visit one article like http://oyanglul.us/#/gist/10696702/Learn%20julia%20in%20Y%20Minutes and remove the #, if it’s not 404 page, congrat:sparkles:

3rd min: SEO

• go to the your repo’s travis
• open inspector goto network tab
• click rebuild
• right click the rebuild url and select “Copy as Curl”
• open https://addons.heroku.com/marketplace/scheduler
• add this addon to any of your heroku app. then open https://scheduler.heroku.com/dashboard.
• click add job then paste the curl you just copied.
• set the frequency as often as you like to cache your blogist for seo.

Contribute

run test

grunt mocha

Issues

feel free posting issues here https://github.com/blogist/blogist/issues