huangaszaq / wechaty.js.org Goto Github PK

Contributors List

Wechaty Official Homepage: https://wechaty.js.org

1. Fork it
2. Syncing your fork
3. Create your blog branch (git checkout -b your-blog)
4. Write your blog in markdown
5. Add your blog to _post folder
6. Add related image to assets folder
7. Add your info into _data/authors.yml
8. Commit your changes (git commit -am 'added a blog')
9. Push to the branch
10. Create new Pull Request

Done!~

All blog should has title, author, date, teaser...

Example as follows:

---
title: "'Score Your Face Photo' a ML&Wechaty practice"
author: your_github_username
image: your_teaser_image_path
---

<One line abstract for your blog post>

<Your beautiful blog post contents...>

• 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

Please do not commit unrelated files.

Example

<iframe width="560" height="315" src="https://www.youtube.com/embed/3eq8wJfCAWs" frameborder="0" allowfullscreen></iframe>

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

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:

[奇妙的Link](#我是-a-titlebat)

Install all the Jekyll requirements and run it at localhost for blog preview.

This is the recommended way for new users to easy getting started

make docker

You should not use this way except you are a Ruby expert.

make install
make serve

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.

npm install
npm test

This website is built using Docusaurus 2, a modern static website generator.

1. Installation: yarn
2. Local Development: yarn start

   This command starts a local development server and open up a browser window. Most changes are reflected live without having to restart the server.

3. Build: yarn build

   This command generates static content into the build directory and can be served using any static contents hosting service.

4. Deployment GIT_USER=<Your GitHub username> && USE_SSH=true yarn deploy

   If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the gh-pages branch.

We use different branch to support multi language:

• master: English version
• zh: Chinese version

If you want to contribute to English version code, you can pull request to master branch.

If you want to contribute to Chinese version code, you can pull request to zh branch.

As an open source product, Wechaty thrives from contributions of community members. Whatever your skill set is, there is a lot you can do to help us make Wechaty better! So start forking!

At the same time, we also meet up offline all over the world, here is some activities:

• Wechaty Contributor Dinner
• The memorabilia of The First Chatie WWDC Party
• Shanghai WWDC - WeChaty Worldwide Developers Conference
• Wechaty Contributor Dinner with Data Girls
• Wechaty Country Wide Developer Conference
• .....

• Fork this repo
• Checkout to the right branch
  • English version: git checkout master
  • Chinese version: git checkout zh
• Create your doc branch: git checkout -b doc
• Write this doc in markdown
• Commit your changes git commit -am 'doc comment'
• Push to the branch
• Create new Pull Request to the corresponding branch
  • English version: pull request to master branch
  • Chinese version: pull request to zh branch

See more in: Welcome to contribute

Contact [email protected] to learn more

Markdown Linting Rules Documents

• Migrating from gitbook to docsify.js
• Integrating GitBook with JSDoc to Document Your Open Source Project
• F8 2019: Using Docusaurus to Create Open Source Websites
• Jekyll Theme minima

1. @lijiarui, Rui LI, Founder & CEO of Juzi.BOT
2. @huan, Huan LI (李卓桓), Tencent TVP of Chatbot, <[email protected]>

• Code & Docs © 2016-now Wechaty Contributors https://github.com/wechaty
• Code released under the Apache-2.0 License
• Docs released under Creative Commons