Chitang怎么写（如何操作Chitang）

1. 简介

Chitang是一款基于GitHub Issues的博客系统，可以方便的使用GitHub Issues作为文章的存储工具。通过Chitang，你可以使用Markdown撰写博客文章，同时享受开源社区的优秀社区支持。

2. 注册GitHub账号

由于Chitang是基于GitHub Issues的，因此注册GitHub账号是使用Chitang的第一步。请在GitHub官网上注册一个新的账号。注册完成后，请查看GitHub帮助文档，熟悉GitHub的基本使用方法。

3. 创建新的GitHub仓库

Chitang使用GitHub Issues作为博客文章的存储工具，因此需要创建新的GitHub仓库来存储文章。请按照以下步骤创建新的GitHub仓库：

1. 登录GitHub，点击右上角的加号按钮，选择New repository。

2. 在Repository name中填写新的仓库名称，并选择Public或Private。

3. 勾选Initialize this repository with a README，并将.gitignore设置为None。

4. 点击Create repository，成功创建新的GitHub仓库。

4. 配置Chitang

在创建好了GitHub仓库后，需要在本地配置Chitang，以便能够在本地使用GitHub Issues作为博客文章的存储工具。

1. 安装Ruby。在Ruby官网上下载并安装最新版的Ruby。

2. 安装Bundler。在命令行中运行以下命令以安装Bundler：

gem install bundler

3. 在本地创建新的目录，并在该目录下创建Gemfile文件，内容为：

source 'https://rubygems.org'

gem 'chitang', git: 'https://github.com/muan/chitang.git'

4. 在命令行中进入目录，运行以下命令以安装依赖：

bundle install

5. 在命令行中运行以下命令，以在本地初始化Chitang：

chitang new blog

其中，blog为博客的名称，可以根据自己的需要任意设置。

5. 发布文章

在完成以上步骤后，就可以使用Chitang发布文章了。在命令行中进入博客目录，运行以下命令以创建新文章：

chitang post "My First Post"

其中，My First Post为文章的标题。运行以上命令后，Chitang会在_posts目录下自动创建一个以当前日期命名的Markdown文件，例如2019-01-01-my-first-post.md。通过编辑该文件可以撰写文章。

6. 部署博客

在完成文章撰写后，需要将博客部署到GitHub上，以便他人可以访问。请按照以下步骤进行部署：

1. 在GitHub上创建新的仓库，用于存储博客网页。

2. 在本地运行以下命令，将博客部署到新仓库中：

chitang deploy

在运行以上命令后，Chitang会自动将博客生成的静态网页推送到GitHub上。你可以通过访问新仓库的页面，查看博客是否已经成功部署。部署步骤详细说明请参考Chitang的官方文档。

7. 使用主题

Chitang支持自定义主题，你可以按照自己的喜好选择合适的主题。在本地创建新的目录，将主题代码复制到该目录下，并配置Gemfile文件中的gem源指向该目录下的主题文件夹。例如：

source 'https://rubygems.org'

gem 'chitang', git: 'https://github.com/momoXiang/chitang.git'
gem 'my_theme', path: '/path/to/my_theme'

其中，/path/to/my_theme为主题文件夹的实际路径。在完成配置后，运行以下命令以切换主题：

chitang theme my_theme

其中，my_theme为主题名称，必须与配置文件中的gem名称相同。

8. 内容安全

为了保障用户隐私，控制内容的合法性，推荐使用第三方 API 做内容审核和过滤。Chitang已经集成了云从API，你可以按照以下步骤开启：

1. 登录云从API官网，注册账号并登录。

2. 进入后台，创建新的应用，获取app_id和app_secret。

3. 在博客目录下打开配置文件_config.yml，增加以下配置：

yunzong:

  app_id: xxx
  app_secret: xxx

其中，xxx为你在云从API官网获得的app_id和app_secret。在增加以上配置后，Chitang会在文章发布后自动将文章内容提交给云从API进行内容审核和过滤。

9. 自动推送更新

为了更方便的将更新推送到GitHub上，推荐使用Travis CI自动化部署工具。你可以按照以下步骤配置Travis CI：

1. 在GitHub上的新仓库中，创建.travis.yml文件，并写入以下内容：

language: ruby

rvm:
- 2.6.3
cache: bundler
branches:
  only:
    - master
notifications:
  email: false
addons:
  ssh_known_hosts: github.com
before_script:
- chmod +x ./script/cibuild
script: ./script/cibuild
env:
  global:
  - NOKOGIRI_USE_SYSTEM_LIBRARIES=true
  - secure: your_token_here
deploy:
- provider: pages
  skip_cleanup: true
  github_token: $GITHUB_TOKEN
  local_dir: _site/
  target_branch: gh-pages
  on:
    branch: master

其中:

2. 在GitHub上生成Token。在GitHub的个人设置中，找到Developer settings，选择Personal access tokens，点击Generate new token，勾选repo，生成新的Token。

3. 在Travis CI的官网上，使能进程，并在Settings中增加以下环境变量：

GITHUB_TOKEN=your_token_here

其中，your_token_here为刚才在GitHub上生成的Token。

在完成以上步骤后，每次提交代码到GitHub后，Travis CI会自动将代码部署到GitHub Pages上。

10. 其他操作

Chitang还有许多其它操作，例如文件管理、标签、分类、评论等。你可以通过查看官方文档或者向开源社区中的其他开发者寻求帮助，了解更多关于Chitang的使用技巧。