All Projects → Quansight-Labs → quansight-labs-site

Quansight-Labs / quansight-labs-site

Licence: other
💻 Development site and blog for Quansight Labs

Programming Languages

Jupyter Notebook
11667 projects
CSS
56736 projects
python
139335 projects - #7 most used programming language
javascript
184084 projects - #8 most used programming language
Makefile
30231 projects
C++
36643 projects - #6 most used programming language

Quansight Labs Site

Deploy labs website

Netlify Status

Creating new posts

Use either reStructuredText, Markdown or Jupyter Notebooks. To create an empty post:

$ nikola new_post -f markdown  # default is .rst if not specified

Note 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).

📆 Scheduling a post - internal content calendar

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.

👷 Build information

🐍 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.txt

Configuration file for the site is conf.py.

To build the site, and have it auto-update when you edit content:

nikola auto

🚀 Deployment

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.

Screenshot of a GitHub Pull Request displaying the Netlify bot for website builds

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.

Screenshot of a GitHub Pull Request checks with the Details window expanded

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
Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].