PyCon CZ taking place in Ostrava for its fifth edition.

PyCon CZ website is using Python 3.5/Django for the backend, NodeJS for bundling frontend assets and Postgresql as a database.

Run following commands to setup project for local development:

1. You can either use sqlite database, if you only need to work with static pages and styles, in which case, you don't need to setup anything. Or, if you need to work with dynamic apps, you need to use postgresql.

   Create role and db via cli:

   # su -c psql postgres
   postgres=# CREATE ROLE pyconcz LOGIN ENCRYPTED PASSWORD 'your fancy password';
   postgres=# CREATE DATABASE "pycon2019" WITH ENCODING='UTF8' OWNER=pyconcz;
   

   You can also use PostgreSQL localy in Docker container: $ docker run --name pyconcz2019-pg -e POSTGRES_PASSWORD="your fancy password" -e POSTGRES_USER=pyconcz -d -p 5432:5432 postgres

2. python3 -m venv env note: Use exactly Python 3.5.2 on Windows (otherwise Pillow won't install with pip) so you might want to py -3.5 -m venv env

3. pip install -r requirements-dev.txt

4. copy pyconcz/settings/local_template_dev.py to pyconcz/settings/local.py and don't forget to set DATABASES and SECRET_KEY settings.

5. ./manage.py migrate

You only need this if you work with styles or images.

For styles and images processing to work, you need to have node.js and gulp-cli installed globally (sudo npm install gulp-cli -g)

Inside root directory (the same directory where manage.py is) run npm install

You can run your dev server manually on http://localhost:8000 with:

./manage.py runserver --settings=pyconcz.settings.local

We have some non-semantic HTML to accomodate the design. Hopefully this is temporary, until a CSS wizard tames the madness. Things to watch out for:

• Headers <h1> and <h2> need an extra <span> inside for the content:

      <h1><span>PyCon CZ Team</span></h1>

• Sections (with the headers above) need to be wrapped in double <div>. Alternate between pc-odd-section and pc-even-section classes:

      <div class="pc-odd-section">
          <div class="container">
              ...
          </div>
      </div>

• If you end with pc-even-section, adjust the footer by adding the following block:

      {% block footer-class %}pc-odd-footer{% endblock %}

To start development with static files being processed run gulp. It will also start dev server for you.

Open http://localhost:3838 and you should see development version of website with automatic compiling and reloading.

You can also set your hosts to map 127.0.0.1 to pycon.test and it will work on http://pycon.test:3838.

Everything in /static/css and /static/img is replaced with processed content of /static_src/css and /static_src/img respectively. So don't edit anything inside /static/css and /static/img manually.

Same would go for own JavaScript but we don’t have any.

After each production build, you have to commit newly generated CSS and image files. Old files are automatically replaced.

1. npm run build
2. git add pyconcz/static

Just use fab production deploy to deploy to production or fab beta deploy to deploy to beta site.

This work is licensed under a MIT