DES Data Management (DESDM) public data release website
This repository is the source code for the DESDM public data release website at https://des.ncsa.illinois.edu/.
Workflow for contributing content updates
- Install
docker
andgit
. - Fork the repo https://github.com/des-labs/des_ncsa to https://github.com/$GITHUB_USER/des_ncsa where
$GITHUB_USER
is your GitHub account username. - Clone your fork locally and checkout the
dev
branch.CLONE_DIR="$HOME/src/$GITHUB_USER/des_ncsa" git clone https://github.com/$GITHUB_USER/des_ncsa $CLONE_DIR cd $CLONE_DIR git checkout dev
- Build the Docker image.
docker build -t desdm-public:dev .
- Configure the webserver to run in "dev" mode.
docker run --rm --name desdm-public \ -e APP_ROOT="/" -e JIRA_DEFAULT_ASSIGNEE="" -e BASE_URL="localhost" \ -p 8080:8080 \ -v $(pwd):/home/des \ -v /tmp:/db \ -u $(id -u) \ desdm-public:dev \ python3 vulcan.py --dev
- Run the webserver to serve the webpage.
docker run --rm --name desdm-public \ -e APP_ROOT="/" -e JIRA_DEFAULT_ASSIGNEE="" -e BASE_URL="localhost" \ -p 8080:8080 \ -v $(pwd):/home/des \ -v /tmp:/db \ -u $(id -u) \ desdm-public:dev \ python3 main.py
- Open your browser to http://127.0.0.1:8080 to view the website.
- Ensure that the ServiceWorker is not registered. Open your web browser's web development tools. In Firefox, use CTRL+SHIFT+I and go to the Application tab. Disable/remove any ServiceWorker you see listed.
- Edit and save the relevant HTML files. Reload the page and see the results. Repeat this step until satisfied.
- Commit only the substantive changes to the git repo and push the updates to your GitHub fork. Do not commit the changes related to the "dev mode" configuration.
git add git commit -m 'Updated release page blah' git push
- Create a pull request to merge and publish your changes. You must inform the DES Science Release community via the #sci-release Slack channel to allow for a peer review of the submission before it can be accepted.