Jupyter Website
CSS HTML Python Other
Latest commit 034ab43 Jan 17, 2017 @rgbkrk rgbkrk committed on GitHub Alphabetize Steering Council (#180)
Fixes #179
Failed to load latest commit information.
.travis 'fix travis' Jun 27, 2016
_data Include installation page in jupyter.org and fix styling Oct 13, 2016
_includes Merge pull request #176 from cameronoelsen/nav-fixes Jan 3, 2017
_layouts Build jupyter.org website with jekyll Oct 21, 2015
assets Cleanup screenshot Jan 13, 2017
css Fixed navbar-active state to work again, changed nav items to not be … Jan 3, 2017
fonts Initial Commit Aug 29, 2015
js symplify page structure Oct 21, 2015
repo_images Update repos in generateGraph.py Nov 15, 2016
.gitignore removed Gemfile.lock and add Gemfile.lock to gitignore Dec 2, 2016
.travis.yml 'fix travis' Jun 27, 2016
CNAME Set up the CNAME for jupyter.org Aug 29, 2015
Gemfile Add travis and html and css checkers Jun 27, 2016
README.md Convert readthedocs links for their .org -> .io migration for hosted … Oct 9, 2016
_config.yml Tweak settings Jun 27, 2016
about.html Alphabetize Steering Council (#180) Jan 17, 2017
community.html Renamed calendar icon and changed references in html Oct 28, 2016
donate.html Added the rest of the typography scale, went through some more unused… Oct 20, 2016
embed-jupyter-widgets.html Replace npmcdn.com with unpkg.com Sep 7, 2016
favicon.ico add jupyter favicon Feb 18, 2015
generateGraph.py Update repos in generateGraph.py Nov 15, 2016
graphData.json Update graph data Nov 15, 2016
index.html Merge pull request #173 from cameronoelsen/id-additions Dec 8, 2016
install.html Fixed resource section and defined new classes. Got rid of unused cla… Oct 25, 2016
jupyter-circle.png Added logo and Community tests Sep 11, 2015
timestamp Update graph data Nov 15, 2016
widgets.html Adding pip install instructions (#170) Dec 4, 2016


Jupyter's main website

Build Status

This is the source to Jupyter.org.

Build instruction.

The site is build using GitHub Pages Jekyll, see Jekyll website for customizing build process, and detail on how what where.

Quick local testing

$ gem install jekyll kramdown github-pages

cd into the root of this directory,

jekyll serve --baseurl ''

Open your browser to localhost:4000

Edit the various part and reload at will.


What is where.

Most pages are located at the place where their URL is, nothing fancy. Headers and footer are in _includes/head.html, _includes/header.html , _includes/footer.html.

The navbar is in _data/nav.yml and look like that:

    - Home
    - title: Install
      url: https://jupyter.readthedocs.io/en/latest/install.html
    - About
    - title: Documentation
      url: https://jupyter.readthedocs.io/en/latest/install.html
    - title: Blog
      url: https://blog.jupyter.org
    - Donate

which mean, insert in order the following links into the navbar:

- Link to `Home` page, guess the url by yourself. 
- link to `Install` page, the url is...
- Link to `About`, guess the url by yourself, 
-  ... etc.

The navbar will automatically target _blank pages where the url is explicit, and mark the correct link as the "current" one.

How do I create a new page ?

Create my_page.html (will have url https://jupyter.org/my_page.html) or my_page/index.html (will have url https://jupyter.org/my_page/), start with the following :

layout: default
title: My Page
navbar_gray: true

write some html here (consider you are already inside `<body></body>`

You can not do it yet with .md file, but you will be able soon.

Add commit (and don't forget to add to _data/nav.yml

navbar_gray: true start the navbar with a grey background if you need it.

Continuous Integration Testing on Travis

Travis will run and test:

  • jekyll build
  • html-proofer
  • csslint