Skip to content

qpython-android/qpython.pelican

Repository files navigation

qpython-android.pelican

Pelican for qpython-android.github.io as project

usage

How to update the site contents

main loop:

  1. git clone
  2. edit some .md in content/
  3. fab build for test local
  4. fab pub2hub published all
  5. git add->ci->push collection local edit

in fact, usually just 2~4 steps

repo. relation

  • fork https://github.com/appscript/gscript.main into local

  • or becamed https://gitcafe.com/appscript member hold the repo. ACL

  • the sub-dir means:

      +- _plugins/
      +- _themes/
      +- content/
      |    +- Events       首字母大写的是分类目录 收集对应文章
      |    +- Volunteer    ...志愿者
      |    +- _extra       扩展功能文件 e.g robots.txt
      |    +- _files       站内文件
      |    +- _images      站内图片
      |    `- pages        类似 about 的导航栏文档
      +- output/      subRepo. 
      |               https://github.com/appscript/appscript.github.io
      +- README.md         本文
      +- fabfile.py        定制的 fab 本地部署支持脚本
      +- pelicanconf.py    Pelical 主配置
      `- publishconf.py    Pelical 发布配置
    

文章格式

  • 标准 Markdown 格式

  • 以 .md 为后缀

  • 文件名不得使用中文/空格/符号

  • 内容模板:

    Title: 中E可以混杂的标题 Date: 2013-12-09 Tags: people, shanghai Slug: sting-chen Author: Zoom.Quiet

  • 其中:

deploy

支持本地调试! 使用 fabric 进行管理, 支持的命令:

fab 
Available commands:

    build       编译所有页面
    pub2hub  从本地 /outpu 子仓库中 git push 网站到 gscript.github.io
    serve       启动本地服务 localhost:8000
    reserve     重编译所有页面再启动本地服务

注意! 向主机部署,需要有相关权限,并在本地配置好对应 SSH 信息

design

基于 pelican-bootstrap3 深度定制

  • 配置: pelicanconf.py
  • 样式: _themes/pelican-bootstrap3/
  • 插件: _plugins/

Changelog

  • 140120 @ZoomQuiet inti.