PyData PDX Website

This repository contains the source code for the website pdx.pydata.org.

Developing

1. Install Docker
2. Clone the project repository
3. Run the following command to serve it:

   export JEKYLL_VERSION=4 && docker run --name pydatapdx --volume="$PWD:/srv/jekyll" -p 4000:4000 -it jekyll/jekyll:$JEKYLL_VERSION jekyll serve --watch --drafts
   

4. Natigate to http://localhost:4000

While running Jekyll will automatically rebuild the site and refresh the browser when changes are made to the source code.

Troubleshooting

See this article

Building the container

 export JEKYLL_VERSION=4 && docker run --rm --volume="$PWD:/srv/jekyll" -it jekyll/jekyll:$JEKYLL_VERSION jekyll build

Removing the container

docker rm -f pydatapdx

Customizations

Some of the theme defaults were customized to match the existing site. As a result, all the default .scss files needed to be brought in. See Minimal Mistakes' Documentation for further instructions on how to customize styles and layout.

Notes:

• See assets/css/main.scss for a list of SCSS variables that were overriden.
• Hero image styles and html (_page.scss and page__hero.html) were customized to match the old site.
• Custom font links are listed in head.html.