This repository holds the websites for sciwork's annual conferences. The site is hosted at https://conf.sciwork.dev via Netlify.
The repository is organized into the following directories:
-
content/
: This directory contains sub-directories for each individual conference. Each sub-directory should be named asYYYY
whereYYYY
is the conference year. These directories will contain the conference-specific content and configurations. -
shared-assets/
: This directory contains common assets like logos, font styles, common scripts, and stylesheets that are shared across all the conferences. -
netlify.toml
: This is the configuration file for Netlify. It instructs Netlify how to build and deploy the sites for the different conferences.
Please refer to the respective README file within each conference's directory for specific details and instructions about that conference's site.
Please follow these steps for contributing:
-
Fork and clone the repository Fork the project repository to your own GitHub account and clone it to your local machine.
-
Create a new branch Use a descriptive name for your branches, such as
feature/add-speaker-bio
orbugfix/registration-link
. This helps others understand the purpose of a branch at a glance. -
Develop and test your changes Make the necessary changes in your local project and commit them. Push your branch and changes to your forked GitHub repository. Then, create a Pull Request (PR) against the
develop
branch. In the PR description, describe the changes you've made, the problem they solve, or the feature they add. -
Deploy Previews with Netlify Every PR will trigger a Deploy Preview on Netlify. This allows you and others to preview the changes made in a live environment. You can find the Deploy Preview link in the PR checks section on the GitHub PR page.
-
Review and merge process Await review of your PR. Incorporate any changes requested by reviewers. Once your PR is approved, it will be merged into the
develop
branch. The sciwork team will periodically mergedevelop
intomain
, which will publish the changes.
For specific instructions on how to run and develop the site locally, refer to the README file within each conference's directory.
We use Netlify to host our site.
-
The
main
branch is deployed to the official website https://conf.sciwork.dev and https://swconf.netlify.app. -
The
develop
branch is deployed to the under development https://develop--swconf.netlify.app. -
Other branches are deployed to
https://{branch}--swconf.netlify.app
. Replace/
in the branch name with-
. -
Pull requests are deployed to
https://deploy-preview-{id}--swconf.netlify.app
.{id}
is the PR ID.
To deploy your changes to Netlify, you will need to push your changes to GitHub. Netlify will then automatically detect these changes and rebuild the site.