import

.gitignore

@@ -0,0 +1,108 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+
+# Jekyll
+_site/
+.sass-cache

CNAME

@@ -0,0 +1 @@
+www.inferentialthinking.com

Gemfile

@@ -0,0 +1,21 @@
+source 'https://rubygems.org'
+
+group :jekyll_plugins do
+  gem 'github-pages'
+  gem 'jekyll-feed', '~> 0.6'
+
+  # Textbook plugins
+  gem 'jekyll-redirect-from'
+  gem 'jekyll-scholar'
+end
+
+# Windows does not include zoneinfo files, so bundle the tzinfo-data gem
+gem 'tzinfo-data', platforms: [:mingw, :mswin, :x64_mingw, :jruby]
+
+# Performance-booster for watching directories on Windows
+gem 'wdm', '~> 0.1.0' if Gem.win_platform?
+
+# Development tools
+gem 'guard', '~> 2.14.2'
+gem 'guard-jekyll-plus', '~> 2.0.2'
+gem 'guard-livereload', '~> 2.5.2'

Guardfile

@@ -0,0 +1,8 @@
+guard 'jekyll-plus', serve: true do
+  watch /.*/
+  ignore /^_site/
+end
+
+guard 'livereload' do
+  watch /.*/
+end

Makefile

@@ -0,0 +1,38 @@
+.PHONY: help book clean serve
+
+help:
+	@echo "Please use 'make <target>' where <target> is one of:"
+	@echo "  install     to install the necessary dependencies for jupyter-book to build"
+	@echo "  book        to convert the content/ folder into Jekyll markdown in _build/"
+	@echo "  clean       to clean out site build files"
+	@echo "  runall      to run all notebooks in-place, capturing outputs with the notebook"
+	@echo "  serve       to serve the repository locally with Jekyll"
+	@echo "  build       to build the site HTML and store in _site/"
+	@echo "  site 		 to build the site HTML, store in _site/, and serve with Jekyll"
+
+
+install:
+	# Check to see whether bundler is already installed. If not, install it.
+	if [ hash bundler 2>/dev/null ]; then \
+	gem install bundler;\
+	fi
+	bundle install
+
+book:
+	jupyter-book build ./
+
+runall:
+	jupyter-book run ./content
+
+clean:
+	python scripts/clean.py
+
+serve:
+	bundle exec guard
+
+build:
+	jupyter-book build ./ --overwrite
+
+site: build
+	bundle exec jekyll build
+	touch _site/.nojekyll

README.md

@@ -0,0 +1,53 @@
+# The Data 8 Jekyll textbook
+
+This repository holds a Jekyll-based version of the Data 8 textbook.
+
+All textbook content is primarily stored in Jupyter notebooks in the `content/` folder.
+This can be converted to Jekyll-ready markdown and served on github pages.
+
+## How this repository is deployed to `inferentialthinking.com`
+
+The Data 8 textbook has a slightly more complex deploy process. This is because
+[GitHub doesn't work well for using a custom domain name for an organization's non-root
+repository](https://help.github.com/articles/custom-domain-redirects-for-github-pages-sites/).
+
+So, here's how the textbook deploy works:
+
+* The textbook at `inferentialthinking.com` is actually being served from this repository:
+
+  https://github.com/inferentialthinking/inferentialthinking.github.io
+
+  **You should not ever directly edit the inferentialthinking.github.io repository**
+* Updates to the textbook should be made at **this** repository (`github.com/data-8/texbook`)
+* When you make a change to this repository and push it to the `data-8/textbook` gh-pages
+  branch, these changes should automatically be copied to https://github.com/inferentialthinking/inferentialthinking.github.io.
+* This is done with CircleCI, and the [configuration for this can be found](.circleci/config.yml)
+
+## Building the textbook
+Here are steps to get started building the textbook on your own machine:
+
+1. **Install the jupyter-book command line tool**. This allows you to create
+   and modify Jupyter Books:
+
+   ```
+   pip install jupyter-book
+   ```
+
+2. **Follow the build instructions on the Jupyter Book guide**. The guide
+   has information for how to use the Jupyter Book CLI to build this book.
+   You can find the [Jupyter Book build instructions here](https://jupyter.org/jupyter-book/guide/03_build.html#build-the-books-markdown).
+
+   A short summary (see the link for full details):
+   If you have Ruby and bundle installed,
+   install the dependencies by running
+   `bundle install`, then running `gem pristine ...` for each warning.
+   Once the dependencies are installed, run `make book` and then `make build`.
+
+**To preview your built site** using Jekyll on your computer, follow
+the steps on the [Jupyter Book guide](https://jupyter.org/jupyter-book/guide/03_build.html#build-the-books-site-html-locally-optional).
+The short version is to run `make serve`, then visit `http://127.0.0.1:4000/chapters/intro` in your browser.
+
+## Relevant files
+
+An explanation of the various files in this textbook can be found in
+the [Jupyter Book guide](https://jupyter.org/jupyter-book/guide/01_overview.html#a-quick-tour-of-a-jupyter-book).