{"id":13591733,"url":"https://github.com/jagregory/abrash-black-book","last_synced_at":"2025-05-14T17:05:56.956Z","repository":{"id":12948946,"uuid":"15627038","full_name":"jagregory/abrash-black-book","owner":"jagregory","description":"Markdown source for Michael Abrash's Graphics Programming Black Book","archived":false,"fork":false,"pushed_at":"2023-06-20T19:44:42.000Z","size":13001,"stargazers_count":4587,"open_issues_count":4,"forks_count":337,"subscribers_count":122,"default_branch":"master","last_synced_at":"2025-05-14T17:05:11.941Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jagregory.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2014-01-04T05:31:46.000Z","updated_at":"2025-05-14T01:11:11.000Z","dependencies_parsed_at":"2022-07-12T10:22:26.120Z","dependency_job_id":"c02ddecb-06af-40c4-93be-c5d5bb693739","html_url":"https://github.com/jagregory/abrash-black-book","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jagregory%2Fabrash-black-book","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jagregory%2Fabrash-black-book/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jagregory%2Fabrash-black-book/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jagregory%2Fabrash-black-book/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jagregory","download_url":"https://codeload.github.com/jagregory/abrash-black-book/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254190396,"owners_count":22029632,"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-08-01T16:01:01.376Z","updated_at":"2025-05-14T17:05:56.928Z","avatar_url":"https://github.com/jagregory.png","language":"CSS","funding_links":[],"categories":["CSS","Graphics"],"sub_categories":[],"readme":"# Michael Abrash's Graphics Programming Black Book\n\nThis is the source for an ebook version of Michael Abrash's Black Book of Graphics Programming (Special Edition), originally published in 1997 and [released online for free in 2001](http://www.drdobbs.com/parallel/graphics-programming-black-book/184404919) (original link now broken, [Internet Archive link](https://web.archive.org/web/20190706123029/http://www.drdobbs.com/parallel/graphics-programming-black-book/184404919)).\n\nReproduced with blessing of Michael Abrash, converted and maintained by [James Gregory](mailto:james@jagregory.com).\n\nThe [GitHub releases list](https://github.com/jagregory/abrash-black-book/releases) has an EPUB and Mobi version available for download, and you can find a mirror of the HTML version at [www.jagregory.com/abrash-black-book](http://www.jagregory.com/abrash-black-book/).\n\n## How does this differ from the previously released versions?\n\nThe book is now out of print, and hard to come by. Last time I checked, it was going for over $200 on eBay.\n\nThe version which Michael and Dr. Dobbs released in 2001 was a collection of PDF files. That version is [still available](http://www.drdobbs.com/parallel/graphics-programming-black-book/184404919) (original link now broken, [Internet Archive link](https://web.archive.org/web/20190706123029/http://www.drdobbs.com/parallel/graphics-programming-black-book/184404919)). However, the structure (multiple files) and the format (PDF) result in a poor user experience on an ebook reader or other mobile device.\n\nThis version has been thoroughly cleaned of artifacts and condensed into something which can easily be converted into an ebook-friendly format. You can read this version online at GitHub, or download any of the EPUB or Mobi releases. You can clone the repository and generate your own version with [pandoc](http://johnmacfarlane.net/pandoc/) if necessary.\n\n## Contributing\n\nChanges are welcome, especially conversion-related ones. If you spot any problems while reading, please [submit an issue](https://github.com/jagregory/abrash-black-book/issues) and I'll correct it. Pull requests are always welcome.\n\nSome larger changes could be made to improve the content. I'd love to see some of the images converted to a vector representation so we can provide higher-resolution versions.  Formulas and equations could be typeset with [MathJax](http://www.mathjax.org/).\n\n## Generating your own ebook\n\nYou need to have the following software installed and on your `PATH` before you begin:\n\n  * [pandoc](http://johnmacfarlane.net/pandoc/) version 2.0 or greater for Markdown to HTML and EPUB conversion.\n  * [kindlegen](http://www.amazon.com/gp/feature.html?docId=1000765211) for Epub to Mobi conversion.\n\nTo generate an e-reader friendly version of the book, you can use `make` with one of the following options:\n\n  * `html` - build an HTML5 single-page version of the book\n  * `epub` - build an EPUB3 ebook\n  * `mobi` - build a Kindle-friendly Mobi\n  * `all`  - do all of the above\n\nOnce complete, there will be an `out` directory with a `black-book.epub`, a `black-book.mobi` and an `html` directory with a `black-book.html` file.\n\n\u003e Note: Generating a Mobi requires an EPUB to already exist. Also, Mobi generation can be *slow* because of compression. If you want a quick Mobi conversion you can just run `kindlegen out/black-book.epub`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjagregory%2Fabrash-black-book","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjagregory%2Fabrash-black-book","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjagregory%2Fabrash-black-book/lists"}