This is the source repository for the pypy.org webpages.
You can see the Netlify previews here
Working with the repo to generate new content
The webpages are generated using the static site generator nikola (https://getnikola.com/).
To create a new post, first create a virtualenv with
make venv_nikola/bin/nikola, then
!! The content of
public (with all helper directories, like js, css, ...)
is not written by hand,
please do not modify - it will be overwritten !!
After you make changes, you can do
make build to regenerate the pages in
public/ for local viewing, but do not commit these, they will be
rebuilt and commited via a CI deploy step. You can also do
make auto to
start a server that will serve the pages, and rebuild them when any changes are
made to the sources.
PRs previews will be generated with Netlify. After pushing a PR, a CI run will have a "Deploy preview ready!" run, clicking on the "details" link will show the newly-rendered site preview.
Historic posts (before the transition to github in March 2021) were imported with their comments, additional commenting is disabled.
Any changes to the main branch (including merging PRs) regenerates and pushes
to the gh-pages branch, which is a copy of the
For historical reasons, and in order to allow us to change webpage hosting easily, the gh-pages branch is pulled into pypy.org by a cron job on a psf-hosted instance, see https://github.com/python/psf-salt/tree/master/salt/pypy-web.
The people with access to the instance are the ones in https://github.com/python/psf-salt/blob/master/pillar/base/users.sls with pypy-web access.