Skip to content

Commit

Permalink
Update text from Gitbook to Honkit (#89)
Browse files Browse the repository at this point in the history
  • Loading branch information
swaroopch authored Nov 7, 2020
1 parent 113cc41 commit bb53b08
Show file tree
Hide file tree
Showing 5 changed files with 26 additions and 8 deletions.
18 changes: 15 additions & 3 deletions INSTALL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,18 @@
```
npm install -g gitbook-cli
gitbook serve
# install honkit
npm install honkit --save-dev
# show website running locally
npx honkit serve
# generate website files
npx honkit build . public --log=debug
# generate pdf
npx honkit pdf . byte-of-python.pdf
# generate epub
npx honkit epub . byte-of-python.epub
```

See http://toolchain.gitbook.com/ebook.html
See https://github.com/honkit/honkit and https://honkit.netlify.app/
6 changes: 3 additions & 3 deletions Makefile
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# https://toolchain.gitbook.com/setup.html
# https://github.com/honkit/honkit
setup:
npm install gitbook-cli -g
npm install honkit --save-dev

serve:
gitbook serve
npx honkit serve
2 changes: 2 additions & 0 deletions about.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,8 @@ For the ninth draft, I switched to [AsciiDoc format](http://asciidoctor.org/docs

For the tenth draft, I switched to writing in Markdown + [GitBook](https://www.gitbook.com) format, using the [Spacemacs editor](http://spacemacs.org).

Nov 2020: Since Gitbook abandoned their open source software, migrated to [Honkit, a community-maintained fork of Gitbook legacy](https://github.com/honkit/honkit).

## About the Author

See {{ book.authorUrl }}
4 changes: 4 additions & 0 deletions revision_history.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,10 @@ The book needs the help of its readers such as yourselves to point out any parts

# Appendix: Revision History {#revision-history}

- No version change
- 06 Nov 2020
- Migrated from abandoned GitBook to [community-maintained Honkit, a fork of GitBook legacy](https://github.com/honkit/honkit)

- 4.0
- 19 Jan 2016
- Switched back to Python 3
Expand Down
4 changes: 2 additions & 2 deletions translation_howto.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,6 @@
1. The full source of the book is available from {{ book.sourceUrl }}.
2. Please [fork the repository](https://help.github.com/articles/fork-a-repo).
3. Then, fetch the repository to your computer. You need to know how to use [Git](http://www.git-scm.com) to do that.
4. Read the [GitBook documentation](https://docs.gitbook.com), esp. the [Markdown section](https://docs.gitbook.com/editing-content/markdown).
4. Read the [Honkit documentation](https://honkit.netlify.app), esp. the [Markdown section](https://honkit.netlify.app/syntax/markdown.html).
5. Start editing the `.md` files to translate to your local language.
6. [Sign up on GitBook.com](https://www.gitbook.com), create a book and you can see a beautifully rendered website, with links to download PDF, EPUB, etc.
6. See [INSTALL.md](./INSTALL.md) on how to generate the website, PDF, EPUB.

0 comments on commit bb53b08

Please sign in to comment.