Skip to content

tgeorgeux/jupyter.github.io

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Jupyter's main website

Build Status

This is the source to Jupyter.org.

Build instructions

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

Quick local testing

Clone this repository locally, and cd into it:

git clone https://github.com/jupyter/jupyter.github.io
cd jupyter.github.io

Install bundler, and use it to install the dependencies to build the website:

gem install bundler
bundle install

Now you can ask Jekyll to build the website.

bundle exec jekyll serve liveserve

Open your browser to localhost:4000.

Edit the various parts, the liveserve option should automatically rebuild and refresh the pages when changes occur.

To stop serving the website, press Ctrl-C in your terminal

Enjoy.

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 looks like that:

head:
    - 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 means, 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
---

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

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

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

Continuous integration testing on Travis

Travis will run and test:

  • jekyll build
  • html-proofer
  • csslint

Previewing a Pull Request

Netlify is used to provide a link to a rendered website with the changes proposed in a PR. This convenience helps reviewers see how the change would look before it is deployed in production.

The link is found in the GitHub PR status box. In the deploy/netlify section, click on the Details link.

Releases

No releases published

Packages

No packages published

Languages

  • HTML 66.3%
  • CSS 26.7%
  • Python 5.3%
  • JavaScript 1.3%
  • Other 0.4%