================================ zcms : 基于文件系统的超轻CMS

厌倦了各种复杂的CMS建站系统？厌倦了升级，迁移，学习管理...

然而，Sphinx-doc太单调太简单了，Jekyll也还是太复杂...

那么zcms来了, 一个极简的CMS，都是你熟悉的:

• 无需数据库, 每个页面是一个文本文件
• 扩展reStructuredText指令(.rst)，轻松实现博客、导航、新闻等动态内容
• 支持Markdown格式(.md)编写页面
• 当然支持html页面(.html)
• 支持多站点

zcms吸取了Jekyll优点，使用python/pyramid开发完成，完全无需任何开发知识即可掌握.

欢迎微博传播，如有反馈，请微博联系: http://weibo.com/panjunyong

启动服务

准备运行环境:

 python bootstrap.py
 bin/buildout

站点制作过程，启动：

./bin/pserve development.ini

正式使用(缓存加速)，启动：

./bin/pserve production.ini

示例站点

我们易度的所有站点，都采用这个开发完成：

• http://everydo.com
• http://edodocs.com
• http://viewer.everydo.com
• http://czug.org
• http://zopen.cn

无阻力建站

1. 创建站点文件夹

   站点默认放置在sites文件夹下，比如sites/demo

2. 填充站点内容

   在站点文件夹下创建子文件夹和页面，子文件夹将自动成为子栏目, index.rst或index.md自动成为子栏目的首页:

    demo/  
        index.rst
        tour/
            index.rst
            install.rst
            sites.rst
        blog/
            index.rst
            post01.rst
            post02.rst
        about.rst
        img/
            logo.png
   

3. 完工，你也看到一个twitter bootstrap风格的站点!

   很不完美，后面来完善...

文件夹和页面属性

站点基本可以工作, 存在的问题：

• 栏目顺序比较随机无序
• 栏目标题是文件名，可能需要中文标题

每个文件夹下，可以放置一个 _config.yaml 的文件，在这里设置文件夹的属性:

title: 教程                                 # 标题
order: [index.rst, tour, blog, about.rst]   # 显示顺序
hide: [img]                                 # 隐藏图片文件夹的显示

对于rst/md的页面文件, 可直接在文件头部指定这些信息:

---
title: 教程                                 # 标题
creator: [潘俊勇, 王小二]                   # 创建人
created: 2010-12-12 9:12                    # 创建时间，新闻根据这个时间排序
---

页面文件的属性，必须以三个短横开始和结束

设置左右列以及头部信息

对整个文件夹下的页面模版，可以定制左侧、右侧和头部的显示信息，分别加入：

1. _left.rst
2. _right.rst
3. _upper.rst

如果具体某个页面，需要定制，也可以单独设置，通过命名来区分：

1. index.rst 页面的头部信息 _upper_index.rst
2. about.rst 页面的左侧信息 _left_about.rst

动态内容

可在reST中使用如下指令即可：

1. 最近新闻

     .. news::
        :size: 5
        :path: blog
   

2. 博客页面

     .. blog::
        :path: blog
   

3. 导航树

     .. nav_tree::
        :root_depth: 2
   

外观模版的设置和制作

在站点根文件夹下面的_config.yaml里面，定义了整个站点的皮肤

theme_base: http://localhost:6543/themes/bootstrap/  # 存放模版的基准位置，这里可能存放了多个模版
theme_default: default.html                          # 默认的模版

外观模版是通过一个网址来指定的，上面的完整外观模版地址是：

http://localhost:6543/themes/bootstrap/default.html

如果不想使用默认的外观模版，可文件夹或页面属性中，设置个性化的外观模版:

theme: home.html     # 首页模版，可能没有左右列

这里会使用外观模版:

http://localhost:6543/themes/bootstrap/home.html

具体如何定义一个外观模版？可看看themes文件夹里面的文件，因为太简单，就不细说了。 (其实就是一个python的String Template)

nginx虚拟主机

默认安装，我们得到的地址首页是

 http://server.com:6543/site_name

如果我们希望实际类似这样访问

 http://site_name.server.com:6543

需要调整：

1. 采用uwsgi来带，需要预先安装uwsgi, 使用自带的uwsgi.ini

2. nginx.conf里面，增加rewrite指令

    if ($host = site_name\.server\.com) {
        rewrite ^/(.*) /server.com/site_name/$1 break;
    }
   

3. 开启虚拟主机功能, 调整production.ini，设置use_vhm = true

Jekyll参考

• http://www.ruanyifeng.com/blog/2012/08/blogging_with_jekyll.html
• http://yanping.me/cn/blog/2012/03/18/github-pages-step-by-step/
• http://www.soimort.org/posts/101/

TODO

1. 默认的bootstrap风格皮肤还很弱，还没有支持right列
2. production模式下，应该大量缓存加速，减少io
3. 提供webdav api
4. 提供RSS输出
5. 使用zapian进行全文搜索、排序等