Skip to content
Dask development blog
HTML Jupyter Notebook Other
Branch: gh-pages
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
_includes serve disqus comments over https Sep 28, 2018
_layouts Copy most content over from matthewrocklin.com/blog Sep 20, 2018
_plugins Copy most content over from matthewrocklin.com/blog Sep 20, 2018
_posts Add deployment update post (#58) Nov 1, 2019
assets/themes/twitter Copy most content over from matthewrocklin.com/blog Sep 20, 2018
css/pygments Copy most content over from matthewrocklin.com/blog Sep 20, 2018
images groupby post (#53) Oct 8, 2019
scripts Copy most content over from matthewrocklin.com/blog Sep 20, 2018
storage Copy most content over from matthewrocklin.com/blog Sep 20, 2018
404.html Copy most content over from matthewrocklin.com/blog Sep 20, 2018
CNAME Create CNAME (#1) Sep 21, 2018
CONTRIBUTING.md Create CONTRIBUTING.md (#59) Oct 22, 2019
Gemfile Copy most content over from matthewrocklin.com/blog Sep 20, 2018
README.md add instructions on using conda-forge to setup blog (#55) Sep 17, 2019
Rakefile Copy most content over from matthewrocklin.com/blog Sep 20, 2018
_config.yml simplify config Sep 20, 2018
atom.xml Copy most content over from matthewrocklin.com/blog Sep 20, 2018
changelog.md Copy most content over from matthewrocklin.com/blog Sep 20, 2018
documentation.html add link to docs Sep 20, 2018
feed.python.xml Copy most content over from matthewrocklin.com/blog Sep 20, 2018
feed.scipy.xml Copy most content over from matthewrocklin.com/blog Sep 20, 2018
feed.sympy.xml Copy most content over from matthewrocklin.com/blog Sep 20, 2018
index.md Replace Matthew Rocklin with Dask in config Sep 20, 2018
sitemap.txt Copy most content over from matthewrocklin.com/blog Sep 20, 2018
tags.html

README.md

Dask Working Notes

A collection of working notes about Dask

Build Locally

This blog uses Jekyll, which is built on Ruby. You will need Ruby to build locally.

Do this once on your machine (assuming you have ruby and gem, Ruby's package manager)

gem install bundler
bundle install

Then do this from the root of this project directory whenever you want to build-and-host your docs:

bundle exec jekyll serve

That should also watch for changes and rebuild automatically. Built pages live in _site/.

Installing Jekyll

As noted aboove, Jekyll can be installed as a gem:

gem install jekyll bundle

Jekyll and ruby can also be install via conda-forge:

conda create -n dask-blog -c conda-forge ruby rb-jekyll rb-nokogiri rb-jekyll-commonmark-ghpages rb-commonmarker rb-bundler
conda activate dask-blog
bundle install
bundle exec jekyll serve

Add a new page

Content lives in _posts as individual markdown files. These markdown files have a few expectations on them.

  1. They should be named according to the date of publication like the following:

    YYYY-MM-DD-brief-title-url.md
    

    like

    2018-12-31-dask-in-the-new-year.md
    
  2. They should have the following front-matter

    ---
    layout: post
    title: Your Title
    author: Your Name
    tagline: an optional tagline
    tags: [A, list, of tags]
    theme: twitter
    ---
    
    {% include JB/setup %}
    

    You can copy-paste this from any existing post

  3. You can also optionally add the following element to the front-matter to avoid placing this article in the table of contents and on RSS feeds.

    draft: true
    
  4. Images should go in the images/ directory and be referred to as /images/my-image.svg with normal HTML or markdown syntax like the following:

    <img src="/images/my-image.svg">

Publish on Github Pages

Github runs Jekyll by default. No additional work is needed for deployment, just push to the gh-pages branch and things should be up in a few minutes.

You can’t perform that action at this time.