113 lines
3.2 KiB
Markdown
113 lines
3.2 KiB
Markdown
WBlog
|
|
=======
|
|
[](https://travis-ci.org/windy/wblog)
|
|
[](https://codeclimate.com/github/windy/wblog)
|
|
[](https://codeclimate.com/github/windy/wblog)
|
|
|
|
The missing open source blog system on Ruby on Rails.
|
|
|
|
WBlog is open source blog which built for mobile first, it's licenced on MIT, use it for free!
|
|
|
|
[中文说明文档](/README.zh-CN.md)
|
|
|
|
Characteristic:
|
|
|
|
* Awful reading feeling for reader
|
|
* Independent comment system, store data on your own sever
|
|
* With mardown supported, you can post both powerful and clean formatted article(s)
|
|
|
|
A demo came from my English blog: <http://en.yafeilee.me>
|
|
|
|
Power Admin Dashboard: <http://en.yafeilee.me/admin>, user and password are configurable.
|
|
|
|
|
|
|
|
### System dependencies
|
|
|
|
* Ruby ( >= 2.0 )
|
|
* Mongodb ( >= 2.7 )
|
|
* Nginx ( >= 1.4 )
|
|
|
|
### Features
|
|
|
|
* Responsive, iPhone, iPad, Notebook, PC, all are supported
|
|
* QR Code attached article, scan and share it
|
|
* Inpendent comment system, managed by yourself
|
|
* Markdown supported, code highlight, especially for programmer, like you
|
|
* Personalize it, commercialize it, it all depends on you
|
|
|
|
### Goal
|
|
|
|
Make it to the best Ruby on Rails Blog system in the world.
|
|
|
|
### Study it locally
|
|
|
|
WBlog MUST run in Linux or Mac, it depends on Mongodb database. You can run it like a Ruby on Rails project as usual:
|
|
|
|
1. Clone it
|
|
|
|
`git clone git@github.com:windy/wblog.git`
|
|
|
|
`cd wblog `
|
|
|
|
2. Install dependencies & configure
|
|
|
|
```shell
|
|
# Install mongodb ( see how to install it on your platform )
|
|
# on Mac, you can install it like this:
|
|
brew install mongodb
|
|
```
|
|
|
|
```shell
|
|
bundle install
|
|
cp config/application.yml.example config/application.yml
|
|
cp config/mongoid.yml.example config/mongoid.yml
|
|
```
|
|
|
|
Update application.yml & mongoid.yml as you need
|
|
|
|
3. Start it
|
|
|
|
```shell
|
|
rails s
|
|
```
|
|
|
|
If there is any error found, please check your database's user and password.
|
|
|
|
4. Post the first article
|
|
|
|
visit: http://127.0.0.1:3000/admin, input your username and password that is just configurated in application.yml.
|
|
then, post a new article.
|
|
|
|
OK, That's all.
|
|
|
|
### Deployment
|
|
|
|
WBlog uses `mina` as automation deployment tool, uses `unicorn` as the Rack container.
|
|
|
|
WBlog recommends `nginx` as reverse proxy server.
|
|
|
|
It will be very fast.
|
|
|
|
Ruby on Rails project deployment is another big topic, I would NOT talk it here.
|
|
|
|
You can read WBlog wiki for more information: [WBlog 的发布流程(Chinese only now)](https://github.com/windy/wblog/wiki)
|
|
|
|
### Stack
|
|
|
|
* Ruby on Rails 4.2.x / Ruby 2.x
|
|
* AngularJS
|
|
* Foundation 5
|
|
* mina
|
|
* slim
|
|
* Mongodb
|
|
|
|
|
|
## Related open source blog systems
|
|
|
|
* writings.io( Ruby on Rails 4.0.2 ): a multi users blog system <https://github.com/chloerei/writings>
|
|
* jekyll( Ruby Gem, Markdown): Static blog system <http://jekyllrb.com/>
|
|
* octopress( Github Pages ): <http://octopress.org/>
|
|
* middleman( Ruby Gem ): Another static blog system <https://github.com/middleman/middleman>
|
|
* robbin_site( Padrino ): <https://github.com/robbin/robbin_site>
|