GitHub - numpy/numpy.org: The NumPy home page
Getting Started
To contribute to the website, you'll first need to install the extended version of Hugo.
The Hugo
has instructions for different platforms and installers; make sure you end up with the extended version.
On Linux, it may be easiest to pick up a tarball of the latest extended version from the
and install it as described in
https://gohugo.io/getting-started/installing/#install-hugo-from-tarball
.
Next, clone this repository, and install the theme:
git submodule update --init --recursiveThe development web server is started with:
make serveIf you don't have make available (e.g., on Windows), use this instead:
python gen_config.py hugo serverAfter that, the site should be available at
.
You'll see
error: failed to transform resource: TOCSS: failed to transform "style.sass"if you don't have the Hugo extended version.
User Experience (UX)
NumPy Color Palette
RGB 1/50/67 | HEX #013243 | NumPy Warm Black
RGB 77/119/207 | HEX #4D77CF | NumPy Deep Blue
RGB 77/171/207 | HEX #4DABCF | NumPy Ndarray Blue
RGB 108/122/137 | HEX #6C7A89 | NumPy Slate Gray
RGB 238/238/238 | HEX #EEEEEE | NumPy Cloud Gray
RGB 255/197/83 | HEX #FFC553 | NumPy Yellow
RGB 255/255/255 | HEX #FFFFFF | White
Deployment
Submit pull requests first; they are run on
, and you can see a build preview by clicking the details link at the bottom.
Team lists
To update the teams gallery in numpy.org site, you need to run make teams Makefile target. It uses the team_query.py tool provided by
. The following pre-requisites need to be met in numpy.org build environment:
The team_query.py tool requires python requests package. Make sure it is installed in your numpy.org build environment before invoking make teams Makefile target.
with read:org permissions is required for requesting numpy.org team data from GitHub. The token has to be exported as GH_TOKEN.
export GH_TOKEN=xxxxxxxxxx make teams Upgrade Hugo
Change the version in netlify.toml.
Analytics
A self-hosted version of
is used to gather simple and privacy-friendly analytics for the site. The dashboard can be accessed
.