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:
-
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
-
python3 -m venv env
note: Use exactly Python 3.5.2 on Windows (otherwise Pillow won't install with pip) so you might want topy -3.5 -m venv env
-
pip install -r requirements-dev.txt
-
copy
pyconcz/settings/local_template_dev.py
topyconcz/settings/local.py
and don't forget to set DATABASES and SECRET_KEY settings. -
./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 betweenpc-odd-section
andpc-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.
npm run build
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