Repository files navigation

This is the source repository for thepypy.org webpages.

You can see the Netlify previews here

The webpages are generated using the static site generatornikola (https://getnikola.com/).To create a new post, first create a virtualenv withmake venv_nikola/bin/nikola, then./venv_nikola/bin/nikola new_post.

!! The content ofpublic (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 domake build to regenerate the pages inpublic/ for local viewing, butdo not commit these, they will berebuilt and committed via a CI deploy step. You can also domake auto tostart a server that will serve the pages, and rebuild them when any changes aremade to the sources.

PRs previews will be generated with Netlify. After pushing a PR, a CI run willhave a "Deploy preview ready!" run, clicking on the "details" link will show thenewly-rendered site preview.

Comments to blog posts are generated via theutterancesjavascript plugin. The comments appear as issues in the repo.When viewing the site, a query is made to fetch the comments to the issue withthat name. To comment, users must authorize the utterances app to post on theirbehalf using theGitHubOAuth flow.Alternatively, users can comment on the GitHub issue directly.

Historic posts (before the transition togithub in March 2021) were imported with their comments, additional commentingis disabled.

Any changes to the main branch (including merging PRs) regenerates and pushesto the gh-pages branch, which is a copy of thepublic directory.

For historical reasons, and in order to allow us to change webpage hostingeasily, the gh-pages branch is pulled into pypy.org by a cron job on apsf-hosted instance, seehttps://github.com/python/psf-salt/tree/master/salt/pypy-web.

The people with access to the instance are the ones inhttps://github.com/python/psf-salt/blob/master/pillar/base/users.slswith pypy-web access.