Website of the Open Source Design community, hosted on GitHub Pages.
Editing content on opensourcedesign.net can be done in 3 ways, all of which require a GitHub account.
-
Using GitHub's nifty file editor, which is quick but limited:
-
Using Gitpod which gives you a preconfigured IDE and live preview. This is quick and you can see your changes:
-
Setting the website up locally, which is more technical.
To contribute to the website, you'll need some basic terminal skills and knowledge of web development technologies like HTML, CSS, and JavaScript. The site is built with the following tools:
Before you begin, ensure you have a Ruby
development environment and Git
installed and configured to connect to GitHub with SSH.
- Ruby: Jekyll requires Ruby version 2.5.0 or higher.
- RubyGems: Ruby package manager.
- GCC and Make: Essential for compiling native extensions.
You can install these dependencies using the following guides:
-
Install Bundler and Jekyll
First, install Bundler, which manages Ruby dependencies:
sudo gem install bundler
- Fork and clone the main website repository
git clone --single-branch --branch master https://github.com/opensourcedesign/opensourcedesign.github.io.git
cd opensourcedesign.github.io/
bundle install
- Clone the jobs repository
Currently the job board is still a separate repository, but we plan to move it in here.
git clone https://github.com/opensourcedesign/jobs.git
- Build the static site & watch for files
bundler exec jekyll serve --watch --config _config.yml,_config-dev.yml
This project exists thanks to all the people who contribute.
Thank you to all our backers! π (Become a backer)
Support this project by becoming a sponsor. (Become a sponsor)
Please note that Open Source Design has a Contributor Code of Conduct. By participating in this project online or at events you agree to abide by its terms.
π You can use & modify everything as long as you credit Open Source Design and use the same license for your resulting work. Code license is AGPLv3 and content is Creative Commons Attribution-ShareAlike.