a filesystem based simple CMS
Switch branches/tags
Nothing to show
Pull request Compare This branch is 66 commits behind everydo:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
sites/demo
themes
zcms
.gitattributes
.gitignore
CHANGES.txt
COPYRIGHT.txt
LICENSE.txt
README.md
bootstrap.py
buildout.cfg
development.ini
production.ini
setup.py
uwsgi.ini

README.md

================================ 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

示例站点

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

无阻力建站

  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

TODO

  1. 默认的bootstrap风格皮肤还很弱,还没有支持right列
  2. production模式下,应该大量缓存加速,减少io
  3. 提供blogger api
  4. 提供RSS输出