{"action":"created","issue":{"url":"https://api.github.com/repos/data-8/textbook/issues/75","repository_url":"https://api.github.com/repos/data-8/textbook","labels_url":"https://api.github.com/repos/data-8/textbook/issues/75/labels{/name}","comments_url":"https://api.github.com/repos/data-8/textbook/issues/75/comments","events_url":"https://api.github.com/repos/data-8/textbook/issues/75/events","html_url":"https://github.com/data-8/textbook/pull/75","id":368301958,"node_id":"MDExOlB1bGxSZXF1ZXN0MjIxNTExMDQ5","number":75,"title":"Moving the textbook build to jupyter-book","user":{"login":"choldgraf","id":1839645,"node_id":"MDQ6VXNlcjE4Mzk2NDU=","avatar_url":"https://avatars1.githubusercontent.com/u/1839645?v=4","gravatar_id":"","url":"https://api.github.com/users/choldgraf","html_url":"https://github.com/choldgraf","followers_url":"https://api.github.com/users/choldgraf/followers","following_url":"https://api.github.com/users/choldgraf/following{/other_user}","gists_url":"https://api.github.com/users/choldgraf/gists{/gist_id}","starred_url":"https://api.github.com/users/choldgraf/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/choldgraf/subscriptions","organizations_url":"https://api.github.com/users/choldgraf/orgs","repos_url":"https://api.github.com/users/choldgraf/repos","events_url":"https://api.github.com/users/choldgraf/events{/privacy}","received_events_url":"https://api.github.com/users/choldgraf/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":3,"created_at":"2018-10-09T16:46:43Z","updated_at":"2018-10-26T05:55:34Z","closed_at":null,"author_association":"CONTRIBUTOR","pull_request":{"url":"https://api.github.com/repos/data-8/textbook/pulls/75","html_url":"https://github.com/data-8/textbook/pull/75","diff_url":"https://github.com/data-8/textbook/pull/75.diff","patch_url":"https://github.com/data-8/textbook/pull/75.patch"},"body":"Since the original creation of the Jekyll-based build system, I've been working with @SamLau95 to improve this process ([now called \"jupyter books\"](https://github.com/choldgraf/jupyter-book)). This is also the build system that DS100 uses, abstracted out so that it's class-agnostic.\r\n\r\nThe main advantages are:\r\n\r\n1. The site is much simpler. There are fewer unused CSS styles, templates, includes, etc. This is largely because the old build was based on a Jekyll theme which added a lot of extra cruft.\r\n2. There's more well-crafted JS/CSS in there. I suspect largely because @SamLau95 is a better coder than me :-)\r\n3. There are extra features that weren't there before (e.g. turbolinks fast-loads the pages so they should update much faster, and without the sidebar reloading)\r\n4. The site makes better use of the available space and the CSS is more well-tuned.\r\n\r\nThe main differences are:\r\n\r\n1. The TOC is now specified directly in `_data/toc.yml` instead of being auto-generated by `generate_book.py`. This removes an extra step of auto-complexity and gives us more control over exactly what goes in the sidebar.\r\n\r\nThat's mostly it (there are some stylistic differences etc but those aren't huge).\r\n\r\nThis PR will convert the data-8 textbook to use this new system (which will make it easier to bring in future updates as jupyter-book is improved). Before we do this, we should:\r\n\r\n* Make sure we're OK with the new build/site system\r\n* Make sure all the links still work properly etc\r\n* Merge this PR over the weekend or sometime when students won't be too surprised.\r\n\r\n**[You can find a demo of the new textbook here](https://predictablynoisy.com/textbook/chapters/intro)**. Take a look and let me know if all looks OK.\r\n\r\ncc @davidwagner @a-adhikari @papajohn who are probably particularly interested in this."},"comment":{"url":"https://api.github.com/repos/data-8/textbook/issues/comments/433295055","html_url":"https://github.com/data-8/textbook/pull/75#issuecomment-433295055","issue_url":"https://api.github.com/repos/data-8/textbook/issues/75","id":433295055,"node_id":"MDEyOklzc3VlQ29tbWVudDQzMzI5NTA1NQ==","user":{"login":"SamLau95","id":2468904,"node_id":"MDQ6VXNlcjI0Njg5MDQ=","avatar_url":"https://avatars0.githubusercontent.com/u/2468904?v=4","gravatar_id":"","url":"https://api.github.com/users/SamLau95","html_url":"https://github.com/SamLau95","followers_url":"https://api.github.com/users/SamLau95/followers","following_url":"https://api.github.com/users/SamLau95/following{/other_user}","gists_url":"https://api.github.com/users/SamLau95/gists{/gist_id}","starred_url":"https://api.github.com/users/SamLau95/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/SamLau95/subscriptions","organizations_url":"https://api.github.com/users/SamLau95/orgs","repos_url":"https://api.github.com/users/SamLau95/repos","events_url":"https://api.github.com/users/SamLau95/events{/privacy}","received_events_url":"https://api.github.com/users/SamLau95/received_events","type":"User","site_admin":false},"created_at":"2018-10-26T05:55:34Z","updated_at":"2018-10-26T05:55:34Z","author_association":"MEMBER","body":"Just wanted to mention it in case: we should make sure all existing links to textbook pages will work with the new build system."}}
{"actor":{"display_login":"SamLau95"}}