Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

basically the best way to write an ebook

tree: cdd644921e

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 bin
Octocat-spinner-32 docbook-xsl
Octocat-spinner-32 example
Octocat-spinner-32 lib
Octocat-spinner-32 site
Octocat-spinner-32 stylesheets
Octocat-spinner-32 .gitignore
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README.asciidoc
Octocat-spinner-32 TODO.txt
Octocat-spinner-32 git-scribe.gemspec
Octocat-spinner-32 the_dream.asc
README.asciidoc

Git Scribe

The git-scribe tool is a simple command line toolset to help you use Git, GitHub and Asciidoc to write e-books. This provides tools for setting up the structure, collaborating with co-authors, doing technical and copy-editing, handling translations, taking errata, as well as publishing online, pdf, mobi (Kindle) and epub (iBooks, Nook) versions.

The project is targeted for writing books of any length, but should also be usable for articles and stuff too, though for a while you’ll have to just do it as a really short book.

Features

Eventually, these are the feature goals for the project:

  • Easy: Syntax-Highlighted Code, Formula, Diagrams

  • Site Generation: Comment, Search, Permalinks

  • Pegging versions of the book to versions of the tool it documents

  • Technical and Copy editing workflow tools

  • Translation workflow tools

  • Selling (possibly): Kindle, iBooks, Lulu, Pledgie(?)

The idea is that you use the tool to generate a known structure, write in asciidoc and let the tool handle everything else for you. I want authors to be able to focus on writing and not have to worry about anything else.

A good AsciiDoc cheat sheet: http://powerman.name/doc/asciidoc#_text

Disclaimer

This tool is a work in progress. At the 1.0 release, this file will be totally up to date, but for now I may have documented some stuff that doesn’t yet work. Contact me personally if you are interested in working on it.

Installing

You can install git-scribe via RubyGems.

$ gem install git-scribe

For local generation (evenutally pushing to GitHub will handle gen for you), it depends on a couple things like:

  • Ruby

  • asciidoc, a2x

  • xslt stuff

  • FOP for PDF gen

Usage

Initialize a new book with init.

$ git scribe init

This will set up the outline for your book. All the book content goes into the book subdirectory with book.asc as the starting point. If you want to split the writing up into multiple files you can simply include them in the book.asc file.

$ git scribe gen [site|html|pdf|epub|mobi|all]

Roadmap

See the_dream.asc for what this file should look like eventually.

Something went wrong with that request. Please try again.
https://github.com/leto/git-scribe/tree/cdd644921e66816758887bac7f9970622a654bf5
github.com
crawl=CC-MAIN-2014-10
40080
application/http; msgtype=response
sha1:ATMRILFQNAKVDNNPWGJB7CQQX4WRV2LL
<urn:uuid:cdc2defa-5432-4d1e-b821-e4639c6433f7>
2014-03-11T13:16:45Z
192.30.252.128
sha1:JVJ7WQVR4652WQTDA3OZIKGBYW2WEUPK
<urn:uuid:382d3a2d-99b2-4e20-b96e-31f477c0e6b4>
https://github.com/leto/git-scribe/tree/cdd644921e66816758887bac7f9970622a654bf5
length
response
<urn:uuid:c3ea7053-9f1d-4625-a729-6c99a97aa812>
robots: classic
hostname: ip-10-183-142-35.ec2.internal
software: Nutch 1.6 (CC)/CC WarcExport 1.0
isPartOf: CC-MAIN-2014-10
operator: CommonCrawl Admin
description: Wide crawl of the web with URLs provided by Blekko for March 2014
publisher: CommonCrawl
format: WARC File Format 1.0
conformsTo: http://bibnum.bnf.fr/WARC/WARC_ISO_28500_version1_latestdraft.pdf