opensourcedesign.net

Website of the Open Source Design community, hosted on GitHub Pages.

Edit Website

Editing content on opensourcedesign.net can be done in 3 ways, all of which require a GitHub account.

1. Using GitHub's nifty file editor, which is quick but limited:

   

2. Using Gitpod which gives you a preconfigured IDE and live preview. This is quick and you can see your changes:

   

3. Setting the website up locally, which is more technical.

Code & Design The Website

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:

• Jekyll
• Bootstrap

Installing

Before you begin, ensure you have a Ruby development environment and Git installed and configured to connect to GitHub with SSH.

Prerequisites

• 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:

• Installing Ruby
• Using GitHub with SSH

Installation Steps

1. Install Bundler and Jekyll

   First, install Bundler, which manages Ruby dependencies:

sudo gem install bundler

2. 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

3. 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

4. Build the static site & watch for files

bundler exec jekyll serve --watch --config _config.yml,_config-dev.yml

👩‍🚀 Contributors, backers & sponsors

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)

♥ Code of Conduct

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.

📜 License

🔀 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.