The primary purpose of this project is to collect useful open source projects and display them by categories and region. Github pages (jekyll) have been used for the website, hence all data are saved in yaml
format. Some python scripts are added for postprocessing.
All data is saved in three files in _data folder.
global.yml
- Contains projects applying to global scale. Used in homepage index.md
areas.yml
- Contains projects focusing on some countries or areas. Used in countries/areas page, area.md
china.yml
- data entries for the projects in china.md
Each project makes up one entry in the file. An entry is defined in meta.yml Add entries in those files, and the website will render and display it automatically.
- from your own experience.
- seen on github and web.
- from issues and pull requests. etc.
This repository is open an issue as a feedback, with the prescribed title and content. This step is optional.
Thanks for your work to help the people in need! Your site has been added to the Open-Source-COVID-19 page, which collects open source projects related to COVID-19, including maps, data, news, api, analysis, medical and supply information, etc. Please share to anyone who might need the information in the list, or will possibly contribute to some of those projects. You are also welcome to recommend more projects.
http://open-source-covid-19.weileizeng.com/
Cheers!
After adding an entry (and push to the origin), these steps will be done automatically (at every push). They would took one min in total.
- src/tags.py collect tags in the three data file and save it into tags.yml and tags_projects.yml. These two files are used for the tag page.
- src/shields.py. generate shields for each project. A shield is an svg picture showing the number of stars.
- github page rebuild the website
If you fork it, you can test it by turning on github pages "setting -> github pages -> master banch"
To do a local test. You need to install jekyll first, and then install gems for the project.
- install ruby environment
- gem install jekyll bundler
- bundle install
- bundle exec jekyll serve
A guide can be found here here to see the installation section.