All geek questions in one place

Using github to write a book

In Github, you can write a file with formatted README.md and a document to represent the project. In addition, there are wiki pages for user interaction. I'm wandering around what would be an optimal workflow, even for non-technical users, to use the GitHub platform to write a collaborative book.

How to use markdown, but then improve it by applying a stylesheet, make a PDF from it, organize chapters, public website (gh-pages), etc.? Is there such a project or tool chain for GitHub?

In other words, how easy is it to write a collaborative book with good html and PDF output on GitHub? Thank.

+9
source share
1 answer

Edit: GitBook has changed a lot since I first wrote this answer. PDF support was discontinued, and the CLI toolkit was abandoned in favor of a proprietary service :

Since the efforts of the GitBook team are focused on the GitBook.com platform, the CLI is no longer in active development.

In mid-2019, mdBook is a good option, although initially it does not support PDF. If you have Rust and Cargo installed, you can simply

cargo install mdbook

to get started.

Original answer:

This is exactly what GitBook is designed for:

GitBook is a command line tool (and Node.js library) for creating beautiful books using GitHub / Git and Markdown (or AsciiDoc).

PDF , - -.

+14

Source: https://habr.com/ru/post/1651284/

More articles:


All Articles