# wechaty.github.io
**Repository Path**: Yangself/wechaty.github.io
## Basic Information
- **Project Name**: wechaty.github.io
- **Description**: Wechaty Official Home Page
- **Primary Language**: Unknown
- **License**: CC-BY-SA-4.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-28
- **Last Updated**: 2024-05-30
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# wechaty.github.io
[](https://github.com/Wechaty/wechaty)
[](https://github.com/wechaty/wechaty.github.io/actions?query=workflow%3ANPM)
[Wechaty Official Homepage](https://wechaty.github.io)
[](https://sourcerer.io/fame/huan/wechaty/wechaty.github.io/links/0)
[](https://sourcerer.io/fame/huan/wechaty/wechaty.github.io/links/1)
[](https://sourcerer.io/fame/huan/wechaty/wechaty.github.io/links/2)
[](https://sourcerer.io/fame/huan/wechaty/wechaty.github.io/links/3)
[](https://sourcerer.io/fame/huan/wechaty/wechaty.github.io/links/4)
[](https://sourcerer.io/fame/huan/wechaty/wechaty.github.io/links/5)
[](https://sourcerer.io/fame/huan/wechaty/wechaty.github.io/links/6)
[](https://sourcerer.io/fame/huan/wechaty/wechaty.github.io/links/7)
## HOW TO POST BLOG
1. Fork it
1. [Syncing your fork](https://help.github.com/cn/github/collaborating-with-issues-and-pull-requests/syncing-a-fork)
1. Create your blog branch (git checkout -b your-blog)
1. Write your blog in markdown
1. Add your blog to `_post` folder
1. Add related image to `assets` folder
1. Add your info into `_data/authors.yml`
1. Commit your changes (git commit -am 'added a blog')
1. Push to the branch
1. Create new Pull Request
Done!~
## CONTRIBUTE GUIDELINE
### 1. Add Blog Header
All blog should has title, author, date, teaser...
Example as follows:
```yaml
---
title: "'Score Your Face Photo' a ML&Wechaty practice"
date: 2017-09-18 09:00 +0800
author: your_github_username
header:
teaser: your_teaser_image_path
---
> Author: [@your_github_username](https://github.com/your_github_username) your one-line bio at here
> Code: [@yourcode](your_code_path)
```
### 2. Writing Style
* Keep all filenames & url as lowercase, and use `-` to connect words instead of space. e.g. `2017-10-06-wechat-pc-impactor` instead of `2017-10-06-WeChat PC Impactor`
* Find a good image for the blog to make it more beautiful.
* Embed the photo & video before publishing, save all external file to the blog `/assets/${current_year}` directory.
see more: [Do not include Date in URL](https://github.com/wechaty/wechaty.github.io/issues/79)
### 3. Add `` Section
Add `` section for your abstract part, it will show on the blog homepage, or the blog homepage will show all your blog content.
### 4. Just Commit Related Files
Please do not commit unrelated files.
### 5. Add Videos
Example
```html
```
### 6. Add links to anchor in paragraph
The titles in markdown files will be added an anchor automatically, you can use that to add your own anchor links. And here is some of the rules how the blog generate the anchor:
* convert the title directly to anchor
* spaces will be replaced by dash `-`
* `/`, `&`, `?` and `.` will be eliminated
* Chinese character will be kept in the anchor
#### Example
Say you have a title as `### 我是? a title.bat`. Then you will get the anchor generated as `我是-a-titlebat`. And you can use the generated anchor to implement your own links. Like this:
```markdown
[奇妙的Link](#我是-a-titlebat)
```
## Usage
### Jekyll
Install all the Jekyll requirements and run it at localhost for blog preview.
#### 1 Use Docker Compose
This is the recommended way for new users to easy getting started
```sh
make docker
```
#### 2 ~~Install Jekyll by Hand~~
You should not use this way except you are a Ruby expert.
```sh
make install
make serve
```
### Test
In order to make sure everything(file name, file size, etc) is ok, you can run the following command to check them before `git push`.
```sh
npm install
npm test
```
## OTHERS
### JEKYLL THEME
minima:
## Author
[Huan LI](https://github.com/huan)
([李卓桓](http://linkedin.com/in/zixia)),
Tencent TVP of Chatbot,
\
[](https://stackexchange.com/users/265499)
## Copyright & License
* Code & Docs © 2019-now Huan LI \
* Code released under the Apache-2.0 License
* Docs released under Creative Commons