3 Star 1 Fork 0

Gitee 极速下载 / Shinmun

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
此仓库是为了提升国内下载速度的镜像仓库,每日同步一次。 原始仓库: https://github.com/georgi/shinmun
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README

Shinmun - a file based blog engine

Shinmun is a small file based blog engine. Write posts in your favorite editor, track them with git and deploy to Heroku. Small, fast and simple.

Features

  • Posts are text files formatted with Markdown, Textile or HTML
  • Deploy via git-push
  • Easy and fast deploying on Heroku
  • Index, category and archive listings
  • RSS feeds
  • Syntax highlighting provided by CodeRay

Quickstart

Install the gems:

$ gem install shinmun

Create a sample blog:

$ shinmun init myblog

This will create a directory with all necessary files. Now start the web server:

$ cd myblog
$ rackup

Browse to the following url:

http://localhost:9292

Voilà, your first blog is up and running!

Writing Posts

Posts can be created by using the shinmun command inside your blog folder:

shinmun post 'The title of the post'

Shinmun will then create a post file in the right place, for example in posts/2008/9/the-title-of-the-post.md.

Post Format

Each blog post is just a text file with a YAML header and a body. The YAML header is surrounded with 2 lines of 3 dashes.

The YAML header has following attributes:

  • title: mandatory
  • date: posts need one, pages not
  • category: a post belongs to one category
  • tags: a comma separated list of tags

Example post:

--- 
date: 2008-09-05
category: Ruby
tags: bluecloth, markdown
title: BlueCloth, a Markdown library
---
This is the summary, which is by definition the first paragraph of the
article. The summary shows up in category listings or the index listing.

Syntax highlighting

Thanks to the fantastic highlighting library CodeRay, highlighted code blocks can be embedded easily in Markdown. For Textile support you have to require coderay/for_redcloth. These languages are supported: C, Diff, Javascript, Scheme, CSS, HTML, XML, Java, JSON, RHTML, YAML, Delphi

To activate CodeRay for a code block, you have to declare the language in lower case:

@@ruby

def method_missing(id, *args, &block)
  puts "#{id} was called with #{args.inspect}"
end             

Note that the declaration MUST be followed by a blank line!

Directory layout

+ config.ru
+ pages
  + about.md
+ posts
  + 2007
  + 2008
    + 9
      + my-article.md
+ public
  + styles.css
+ templates
  + 404.rhtml
  + archive.rhtml
  + category.rhtml
  + index.rhtml
  + index.rxml
  + layout.rhtml
  + page.rhtml
  + post.rhtml  

Blog configuation

In config.ru you can set the properties of your blog:

blog.config = {
  :language => 'en',
  :title => "Blog Title",
  :author => "The Author",
  :categories => ["Ruby", "Javascript"],
  :description => "Blog description"
}

Templates

Layout and templates are rendered by ERB. The layout is defined in templates/layout.rhtml. The content will be provided in the variable @content. A minimal example:

<html>
  <head>
    <title><%= @blog.title %></title>
    <%= stylesheet_link_tag 'style' %>
  </head>
  <body>
     <%= @content %>
  </body>
 </html>

The attributes of a post are accessible via the @post variable:

<div class="article">
 
  <h1><%= @post.title %></h1>
 
  <div class="date">
    <%= human_date @post.date %>
  </div>
 
  <%= @post.body_html %>

  ...      

</div>

Deployment on Heroku

Install the Heroku gem:

$ gem install heroku

Installing your public key:

$ heroku keys:add

Enter your Heroku credentials.
Email: joe@example.com
Password: 
Uploading ssh public key /Users/joe/.ssh/id_rsa.pub

Create an app on Heroku.

$ heroku create myblog
Created http://myblog.heroku.com/ | git@heroku.com:mybblog.git
Git remote heroku added

Now on your local machine, you create a new remote repository and push your blog to Heroku:

$ cd ~/myblog
$ git init
$ git add .
$ git commit -m 'initial commit'
$ git push heroku

That's it. Your blog is deployed.

GitHub Project

Download or fork the package at my github repository

空文件

简介

Shinmun是基于文件的小而美博客引擎,在喜欢的编辑器中编写帖子,使用 git 跟踪它们并部署到 Heroku 展开 收起
Ruby 等 3 种语言
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
Ruby
1
https://gitee.com/mirrors/Shinmun.git
git@gitee.com:mirrors/Shinmun.git
mirrors
Shinmun
Shinmun
master

搜索帮助