Skip to content

USRSE/usrse23

Repository files navigation

The US-RSE Association Conference 2023 (US-RSE'23)

This repo is website landing page for the US-RSE Association Conference 2023, happening October 16-18 in Chicago, IL.

Previewing the Site Locally

To preview the site locally, you'll need to install jekyll Then go to the root of the directory and run (only needed once):

$ bundle install

Then run

$ jekyll serve
# or
$ bundle exec jekyll serve

and open your browser to http://localhost:4000.

If you are having trouble try rm -rf _site, followed by bundle update, then bundle exec jekyll serve.

Container-based development

Build and run a Docker container to preview the site locally and support a local development workflow. If you do not already have Docker installed, please visit https://docs.docker.com/get-docker/ and follow the links to get started with Docker on your operating system.

Build the container image:

docker build -t us-rse-con-2023-website:latest .

Run the container to access the website at the URL http://127.0.0.1:4000/usrse23/

$ docker run --rm -it -p 4000:4000 us-rse-con-2023-website:latest
Configuration file: /srv/jekyll/_config.yml
            Source: /srv/jekyll
       Destination: /srv/jekyll/_site
 Incremental build: disabled. Enable with --incremental
      Generating... 
                    done in 1.616 seconds.
 Auto-regeneration: enabled for '/srv/jekyll'
    Server address: http://0.0.0.0:4000/usrse23/
  Server running... press ctrl-c to stop.

To develop the website, launch the container using the following command, where the source files are mounted into the container:

docker run --rm -it -p 4000:4000 \
    -v $(pwd):/srv/jekyll \
    us-rse-con-2023-website:latest \
    bundle exec jekyll serve --host=0.0.0.0 --watch --drafts

Change a source file, such as index.html for example, and save the changes. You will see Jekyll automatically regenerate the site, after which you can reload the page in your browser to see the rendered changes.