Getting started

Here are the essential parts of this project's file structure. The first, dceu2019/ contains a Django project and hugo_site/ contains the Hugo project for static site generation (the main site):

.
├── dceu2019  # <= Django project
│   ├── db.sqlite3  # <= NOT in repo
│   ├── __init__.py
│   ├── manage.py
│   ├── MANIFEST.in
│   ├── media
│   ├── README.md
│   ├── setup.cfg
│   ├── setup.py
│   ├── src
│   │   ├── dceu2019
│   │   │   ├── apps
│   │   │   │   └── __init__.py
│   │   │   ├── __init__.py
│   │   │   ├── locale
│   │   │   ├── settings
│   │   │   │   ├── base.py
│   │   │   │   ├── dev.py
│   │   │   │   ├── __init__.py
│   │   │   │   ├── local.py  # <= NOT in repo
│   │   │   │   ├── pretalx.py
│   │   │   │   └── production.py
│   │   │   ├── static
│   │   │   ├── templates
│   │   │   ├── urls.py
│   │   │   └── wsgi.py
│   │   └── __init__.py
│   └── staticfiles
│       └── ...
└── hugo_site  # <= Hugo project
    ├── content  # <= This is where all the content lives!
    │   └── ...
    └── themes
        └── dceu2019  # <= The theme
            ├── layouts  # <= HTML templates
            ├── static  # <= CSS etc
            └── ...

Developing the Hugo site

We use a static main site because we want to archive the main conference website as easily as possible. We are using the latest Hugo from the Debian repositories, but the version from Ubuntu 18.04 is too old.

See below method to directly fetch 2 .deb files from a Debian mirror and install them.

# Install Hugo
$ wget https://mirror.csclub.uwaterloo.ca/debian/pool/main/libs/libsass/libsass1_3.5.5-4_amd64.deb -O /tmp/libsass1.deb
$ wget https://mirror.csclub.uwaterloo.ca/debian/pool/main/h/hugo/hugo_0.55.6+really0.54.0-1_amd64.deb -O /tmp/hugo.deb
$ sudo dpkg -i /tmp/hugo.deb /tmp/libsass1.deb

# Go to project directory
$ cd hugo_site

# Run dev server
$ hugo server

Developing the Django project

The Django project will be used before and during the conference for planning purposes: Talk submissions, scheduling, and ticket holder services such as ride sharing and accommodation sharing.

You can install and work on a development version following these steps:

# Create a Python 3.6+ virtualenv (virtualenvwrapper)
$ mkvirtualenv -p python3

# Install project & dependencies in "editable" mode (-e), with the [dev]
# dependency subset.
# You should repeat this command when you pull in new changes which can
# contain new requirements or version upgrades
$ pip install -e "dceu2019[dev]"

# Install our code-quality pre-commit hooks (a.k.a. linting)
$ pre-commit install

# Try invoking the Django main management script
$ python dceu2019/manage.py

# ...you will be told that it has created a local.py file. You might want to
# edit this now or later depending on your needs.

# When ready, run migrations.
$ python dceu2019/manage.py migrate

# Initialize PreTalx: Creates a superuser etc.
$ python dceu2019/manage.py init

# Now you can run the development server
$ python dceu2019/manage.py runserver

# Point your browser to localhost:8000/ and you'll see an empty schedule

Adding a sponsor logo

Add an item to the array in this file: hugo_site/data/sponsors.json, and logo image here: hugo_site/static/static/sponsors/

{
  "name": "Company Name",
  "logo": "logo.png",
  "website": "#"
}