{"id":13483978,"url":"https://github.com/schacon/git-scribe","last_synced_at":"2025-05-14T18:06:30.541Z","repository":{"id":1323952,"uuid":"1269231","full_name":"schacon/git-scribe","owner":"schacon","description":"basically the best way to write an ebook","archived":false,"fork":false,"pushed_at":"2023-10-12T12:32:54.000Z","size":2389,"stargazers_count":1354,"open_issues_count":24,"forks_count":122,"subscribers_count":64,"default_branch":"master","last_synced_at":"2025-05-08T02:01:57.454Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"XSLT","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/schacon.png","metadata":{"files":{"readme":"README.asciidoc","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2011-01-19T00:20:52.000Z","updated_at":"2025-04-07T17:57:24.000Z","dependencies_parsed_at":"2024-06-19T02:47:42.422Z","dependency_job_id":"b67410e3-614e-418d-81bf-532a4488e33a","html_url":"https://github.com/schacon/git-scribe","commit_stats":{"total_commits":75,"total_committers":17,"mean_commits":4.411764705882353,"dds":0.64,"last_synced_commit":"41424bb312975cc49ed9716a932e216485ebf2d3"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schacon%2Fgit-scribe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schacon%2Fgit-scribe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schacon%2Fgit-scribe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schacon%2Fgit-scribe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/schacon","download_url":"https://codeload.github.com/schacon/git-scribe/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254127776,"owners_count":22019504,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T17:01:17.511Z","updated_at":"2025-05-14T18:06:25.532Z","avatar_url":"https://github.com/schacon.png","language":"XSLT","readme":"Git Scribe\n==========\n\nimage::https://travis-ci.org/schacon/git-scribe.png[Build Status,link=\"https://travis-ci.org/schacon/git-scribe\"]\n\nThe git-scribe tool is a simple command line toolset to help you use Git, GitHub and Asciidoc\nto 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.\n\nThe 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.\n\nFeatures\n========\n\nEventually, these are the feature goals for the project:\n\n* Easy: Syntax-Highlighted Code, Formula, Diagrams\n* Site Generation: Comment, Search, Permalinks\n* Pegging versions of the book to versions of the tool it documents\n* Technical and Copy editing workflow tools\n* Translation workflow tools\n* Selling (possibly): Kindle, iBooks, Lulu, Pledgie(?)\n\nThe 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 (website, multiple format generation, etc).\n\nA good AsciiDoc cheat sheet: http://powerman.name/doc/asciidoc#_text\n\nDisclaimer\n==========\n\nThis 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.\n\nInstalling\n==========\n\nYou can install git-scribe via RubyGems.\n\n    $ gem install git-scribe\n\nFor local generation (eventually pushing to GitHub will handle gen for you), it depends on a couple things like:\n\n* Git\n* Ruby\n* asciidoc, a2x (8.6.4)\n* xsltproc\n* source-highlight (3.1)\n* FOP (1.0) - for PDF generation\n\nUsage\n=====\n\nCheck if you have everything installed properly for local generation with `check`:\n\n    $ git scribe check\n    asciidoc - ok\n    xsltproc - ok\n    a2x      - ok\n    highlighting - ok\n    fop      - ok\n\nIf you are on OSX and using Homebrew http://mxcl.github.com/homebrew/ you can install dependencies easily:\n\n----\n$ brew install asciidoc source-highlight fop\n$ brew install https://gist.github.com/raw/4064648/kindlegen.rb\n----\n\nIf you are on Ubuntu, you can install the dependencies with apt-get:\n\n----\n$ sudo apt-get install asciidoc\n$ sudo apt-get install source-highlight\n$ sudo apt-get install fop\n----\n\nKindlegen: http://www.amazon.com/gp/feature.html?ie=UTF8\u0026docId=1000765211\n\nInitialize a new book with `init`:\n\n    $ git scribe init \u003cdirectory name\u003e\n\nThis 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.  The generated files have an example of this.\n\nThen you can generate your book content with the 'git scribe gen' command:\n\n    $ git scribe gen [site|html|pdf|epub|mobi|all]\n\nEventually, simply pushing to GitHub will take care of this for you.  \n\nRoadmap\n=======\n\nSee SPEC.asciidoc for what this file should look like eventually.\n\nContributing\n============\n\nIf you want to hack on this, fork it, improve it and send me a pull request.\n\nTo get started using it, just clone it and call the ./bin/git-scribe script directly from either the `example` subdir or your own book directory.  If you add a feature, make sure it's included in the example subdirectory so I can test it out.\n\n\n","funding_links":[],"categories":["Publishing and Sharing","XSLT","Ebook"],"sub_categories":["Writing"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fschacon%2Fgit-scribe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fschacon%2Fgit-scribe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fschacon%2Fgit-scribe/lists"}