This project that builds the resource list for the Chinese-English exchange discord server: https://discord.gg/ADdR45y. The resource list is accessible in either markdown or as a GitHub Pages site.
GitHub is accessible from within China and generally across all English-speaking and Chinese-language-speaking countries. Although this is currently tailored towards people learning Chinese, our server is intended to serve as resources for both English and Chinese-language learners.
Detailed Explanation of Chinese IMEs
The primary use case is meant to be the GitHub Pages html site. Its design was chosen to be minimal:
- statically generated via shellscript
- filterability with CSS3
- no primary or secondary functionality provided by JavaScript.
We are using YAML as the file format because:
- Supports the tree structure that fits well with an organised list
- Readable by both developer and computer
- You can have reference nodes in more than one place
- Can include comments
If you wish to contribute, you can build with the following steps:
You will need the following dependencies:
- yq >= 2.0.0
- python2/python3 - required by 'yq'
First obtain a local copy of this repository
git clone 'https://github.com/espaspw/Resource-Guide.git'
If you wish to add/edit/remove links, Make the changes to the links.yaml. Then build the project again by running (when inside the repository directory)
./build.sh all
You may also wish to take a look at the help command
./build.sh help
GPL v3.0