Use either reStructuredText, Markdown or Jupyter Notebooks. To create an empty post:
$ nikola new_post -f markdown # default is .rst if not specifiedNote that for a Jupyter Notebook post, the post's metadata (title, author, slug, date) goes in the notebook metadata, as documented here. Jupyter Lab does not yet have a metadata editor - use Jupyter Notebook, install https://github.com/yuvipanda/jupyterlab-nbmetadata (although that did not work in a first test), or edit the metadata by hand.
To not show the whole post but only the first bit and then read more ..., use <!-- TEASER_END --> (either in plain Markdown or in a Markdown cell in a notebook).
The future post schedule is available as a Google spreadsheet accessible only to Quansight employees, you can use it to look up the next free spot.
The website rebuilds itself everyday (look into the GitHub action Cron), thus if you set the date on the metadata of your post and merge the pull request, the post will be published on the day it is merged.
The PR preview system does show future blog post, so no need to put a fake date when issuing a PR.
🐍 Note that Netlify uses Python 3.8 to build and deploy the site.
To set up a development environment: in a new conda env or virtualenv:
$ pip install -r requirements.txtConfiguration file for the site is conf.py.
To build the site, and have it auto-update when you edit content:
nikola auto
Once you submit a pull request a build of the site will be triggered on Netlify. The Netlify bot will add a comment to your pull request with the link to the preview URL.
If the build fails or you need to see more details about it click on the Show all checks link in the checks section and then click on Details to expand the list of checks and their full logs.
⏰ In addition to automatic builds on merge requests, we use GitHub actions to trigger an automatic build of the site everyday at 10:37 UTC. So if you want to "schedule" posts the best way is to make sure the date in the post preamble is a couple of hours before the scheduled time:
date: 2021-10-07 10:00:00 UTC-07:00