社区参与指南

《公益技术社区的术与道》



线下技术社区的优势

主要在于线下技术活动


线下技术社区的成就

主要以一次次活动来体现


个人、公司对社区的贡献

也主要以一次次活动为单位


一个活动是怎样的?

首先体现在它的宣传文案


一篇宣传文案

可以是一篇博客文章

title: # 文章主题(翻译成英文后设为本文件的文件名)
date: # 开篇日期
updated: # 修订日期
categories:
  # 分类名应为一个首字母大写的英文单词
  # 每级分类对应一级目录,写在本文件的文件名前面
tags:
  # 与内容相关的更多标签
authors:
  # 原作者们的 GitHub 账号
original: # 文章出处链接
toc: true
thumbnail: # 封面图片

一篇博客文章

又可以附带自定义元数据

title: # 活动主题(翻译成英文后设为本文件的文件名)
date: # 发起日期
categories:
  - Activity
  # 二级分类:Salon、Workshop 或 Conference
tags:
  # online 或 offline
  # 与内容相关的更多标签
toc: true

# Activity meta
description: # 活动简介
start: # 活动开始时间
end: # 活动结束时间
address: # 线下活动地址(市州、区县、路街、楼栋)
links:
  报名: # https://jinshuju.net/f/xxxxxx
mentors:
  # 讲师、教练们的 GitHub 账号
workers:
  # 组织者、志愿者们的 GitHub 账号
partners:
  # 合办方、场地方、赞助方

一次活动的反馈

可直接在活动博文下方进行

  • 建议:社会化评论框
  • 捐助:支付二维码

一次活动的总结

文字可以就近写在同一篇文章中

现场照片、演示文稿也可放在同级同名文件夹,并用附加元数据关联

photos:
  -  # 第一张为活动封面图
  -  # 第二张开始为活动结束后上传的现场照片
files:
  -  # 活动结束后上传的 PDF、PPT 等非纯文本文件

一场演讲的演示文稿

也可以是一篇博文

title: Hello World
slidehtml: true

社区贡献统计

基于现代静态网站生成器的二次开发能力实现

https://fcc-cd.dev/activity/

https://fcc-cd.dev/community/



团队的运作模式

负责人自上而下的领导


社区的运作模式

社群自下而上的生长


开源软件运动

现代社群的最成功探索


类 GitHub 平台

技术型社区的最佳协作工具


版本控制

记录成长点滴,杜绝胡乱删改


开源

政务透明、财务公开


Issue, Milestone & Project

任务安排、缺陷管理、进度跟踪


Fork & Pull request

人人皆可发起、参与活动


公益技术社区

就成了一个开源文档项目


开源运动的一切最佳实践基础设施

皆可为线下社群所用


文献翻译、工具开发

不但本身可以开源项目的模式运作

也可同时做成工作坊活动



安装基础软件

Windows

choco install nodejs-lts git

Mac OS X

brew install node

创建网站项目

npm init hexo-wiki ~/Desktop/FCC \
    --theme NexT \
    --plugins hexo-generator-slidehtml \
    --remote https://github.com/FCC/FCC.github.io.git

配置更新服务

branches:
  only:
    - hexo

language: node_js
node_js:
  - lts/*
cache:
  directories:
    - node_modules

before_install:
  - export TZ=${TIME_ZONE}
install:
  - npm install
script:
  - npm run build
  - cd ${FOLDER}
  - git init
  - git config user.name ${UID}
  - git config user.email ${EMAIL}
  - git add .
  - git commit -m "${MESSAGE}"
  - git push --force --quiet https://${TOKEN}@${GIT_URI}.git master:${BRANCH}

Enjoy your Community!


评论

Your browser is out-of-date!

Update your browser to view this website correctly. Update my browser now

×