HTCondor Website

This git repository contains the source code for the refactored HTCondor website.If you want to learn more about HTCondor, visit the website itself.

• Development
• Creating Preview Branches
• Making Website Changes

Development

The HTCondor website is implemented in Jekyll. We've provided a Docker image which contains all the necessary libraries to build the website and preview it in a web browser.

Obtaining Docker image

Grab the htcondor/web image from our Docker Hub:

docker pull dockerreg.chtc.wisc.edu:443/htcondor/web

Run Docker Manually

At the website root:

docker run -it -p 8002:8000 -v $PWD:/app -w /app ruby:2.7 /bin/bash

This will utilize the latest Jekyll version and map port 8000 to your host. Within the container, a small HTTP server can be started with the following command:

bundle install
bundle exec jekyll serve --watch --config _config.yml -H 0.0.0.0 -P 8000

https://localhost:8002

Previewing Branches

If you would like to preview your branch or test it with the website production build you have the option now.

To create a preview branch:

1. Prepend the name of your branch with "preview-"
   • Example: "preview-helloworld"
2. Push this branch to https://github.com/htcondor/htcondor-web.git
3. Check for your preview branch @ https://htcondor.com/web-preview/\
   • Example: https://htcondor.com/web-preview/preview-helloworld/
4. You can monitor the preview branch build here ( time to complete is typically ~20 minutes ) -> https://github.com/htcondor/web-preview/actions
5. When you merge in the branch or no longer need it, delete the branch and Github will delete the web preview

This is a great way to demo your changes to others easily.

Making Website Changes

❗ New workflow is live making master the production branch.

1. Submit a pull request with website updates to the master branch (the default) and request a review.
2. If the PR is approved you can merge into master.
3. Check that your intended changes populate at htcondor.org