weekly.PyChina.org

in fact from 2003 there is CZUG.org ~ the 1st(and only one) focus Zope tech community be set up;

so years ago, there is soooooooo many python tech abt. commuity in China

but never group as one unify community brand, like as: perl-china/ruby-china etc.

so after PyCon2013China, some old Chinese Pythonista together and building:

goal

• by Pythonner in China Operations
• as Pythonner in China Deleloping
• for Pythonista in Global support events organizing srvice

organizer

• Zoom.Quiet

path

• 基于 gh-pages 专用分支发布
• 所以, 本地要复制出两个仓库
  • master 分支进行内容撰写
  • 另外一个仓库, 切换为 gh-pages 分支
    • 并链接为 output 输出目录
    • 这样, 才可以合理使用 fab 指令来完成自动化本地编译和发布

usage

How to update the site contents

main loop:

1. git clone
2. edit some .md in content/
3. fab build && fab serve for test local
4. cd output this is another repo. yet!
5. mark the article you have applied on GitCafe Ticket
6. git add->ci->push
7. fab deploy published all

writing

• fork https://gitcafe.com/CPyUG/PyChina into local

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

• cd into content/

• the sub-dir means:

    content/
        +- Events       首字母大写的是分类目录 收集对应文章
        +- Volunteer    ...志愿者
        +- _extra       扩展功能文件 e.g robots.txt
        +- _files       站内文件
        +- _images      站内图片
        `- pages        类似 about 的导航栏文档
  

文章格式

• 标准 Markdown 格式

• 以 .md 为后缀

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

• 内容模板:

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

• 其中:

  • Date: 如果没有将使用文件的系统时间
  • Tags: 使用逗号作间隔, 不宜过多,建议三个为界,以人物/行为/目标领域 为方向进行定义
    • 参考: 如何规划blog的标签（tag）和分类 - 心内求法 - 博客园
  • Slug: 是实际输出的页面文件名, 建议全部小写E文, 使用中划线, 不使用特殊符号

deploy

新方式：GitHub Actions 自动部署（推荐）

从 2025-02-14 起，本项目已迁移到 GitHub Actions 自动部署：

1. 编辑 content/ 目录下的 Markdown 文件
2. 提交并推送到 master 分支：git push origin master
3. GitHub Actions 自动完成：
   • 检测并修复图片缺失的 alt 属性
   • 编译 Pelican 静态站点
   • 部署到 GitHub Pages

触发条件：修改 content/、_themes/、pelicanconf.py 等文件时自动触发

旧方式：本地 fabric 部署（已废弃）

支持本地调试! 使用 fabric 进行管理, 支持的命令:（不再维护）

~fab~ 
~Available commands:~
    ~build       编译所有页面~
    ~deploy      向主机部署所有页面~
    ~reserve     重编译所有页面再启动本地服务~
    ~serve       启动本地服务 localhost:8000~

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

design

基于 pelican-bootstrap3 深度定制

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

贡献

提交你的贡献到CPyUG / weekly，先确保自己的仓库与上游仓库同步

# 在 Fork 的代码库中添加上游代码库的 remote 源，（操作一次就可以，以后不必每次添加）
git remote add upstream https://gitcafe.com/CPyUG/weekly.git

# 查看添加的上游仓库
git remote -v

# 提交本地修改
git add .
git commit -m "****"

# 同步上游版本
git remote update upstream
git rebase upstream/master

# push代码到gitcafe
git push origin master

# pull request
在自己gitcafe项目仓库下提交pull request到上游仓库

changelog

• 250214 ZQ 重大架构变更：迁移到 GitHub Actions 自动部署
  • 修复多个 Markdown 元数据格式错误（Slug 冲突、Title 缺失）
  • 新增 fix_image_alt.py 脚本自动修复图片 alt 属性
  • 创建 .github/workflows/build-and-deploy.yml 自动化工作流
  • 废弃 inv pub / fab deploy 本地部署方式
  • 简化发布流程：推送代码即可自动构建部署
• 191028 ZQ 提醒本地发布环境
• 190818 ZQ ++ CNZZ WA support
• 131219 base pelican build and through qiniu.com publish