{"id":23490093,"url":"https://github.com/cmod/ahab","last_synced_at":"2025-04-14T15:41:44.902Z","repository":{"id":3438286,"uuid":"4490769","full_name":"cmod/ahab","owner":"cmod","description":"Ahab! Is a .mobi template for helping you produce Amazon Kindle specific ebooks. ","archived":false,"fork":false,"pushed_at":"2021-02-28T18:25:20.000Z","size":1302,"stargazers_count":126,"open_issues_count":1,"forks_count":10,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-04-14T05:55:45.870Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"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/cmod.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}},"created_at":"2012-05-30T04:04:45.000Z","updated_at":"2025-02-26T23:23:33.000Z","dependencies_parsed_at":"2022-09-07T07:31:03.072Z","dependency_job_id":null,"html_url":"https://github.com/cmod/ahab","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmod%2Fahab","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmod%2Fahab/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmod%2Fahab/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmod%2Fahab/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cmod","download_url":"https://codeload.github.com/cmod/ahab/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248907927,"owners_count":21181433,"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-12-25T00:18:38.150Z","updated_at":"2025-04-14T15:41:44.881Z","avatar_url":"https://github.com/cmod.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"\nAHAB!    \n=====\n                                  \nA baseline Mobi template\n------------------------\n\u003cpre\u003e\n:-...-----------::///++oooossssooo++//////////+//++////++oooosssyhhhhddd\n/:----..```````......--//+oooooooo++++//-://+++++/....--:////+/++ssyhhhh\n///:-....````````.....-:::/++ooooooooo+.:s++/++o/```.-+oo/:-:://++++++oo\n////:--...``.``````.-::::-::/++oooooos--sso+//+/-``.-:shhyho:/+oooo+oooo\n///+////:-.`````````.--::::/:/+++oooo:.:ho++++:-```.:+ymmmmdyo+ossssssss\n-://++++//-`````````````..-::--::////--os////:-```.-+ydmmmmddyo++oosssss\n/////++///:-.``````````````..--......--s/-.-/:.``.-+ydmmmmdmdyh//++ossss\n++//++//////::-..``````````...-..```..:s-.:hy-``.:+yddmmmdmmhhh/++oossss\n+++////+++++///:--...............``..-++-/hy-``-/+yhdmmmmmmdyho/+oosssss\n+//++++///++////::::-::::///::::-..---o/ods.``-+syhddmmmmmdhy+/++++oooss\nso+oosso++///:-``.-:://///++++/:::--.-oyd/```-+shdddmmdmmmhhy+oooo+++ssy\nsssssyyyssoo+//:::://+++++++oo+/:---../o. `.:ohddhhhhhdmmdhy//+osossssss\nyyyyyyyyyyysso+++/:://////////++/--:.``.--/shhddhshhdhdmdhhs:+oosyyyysss\nyyyyyyyyyyyyyyssoo+++////++///++:////://oyhmmmmhoyddmhmmdhhoosyyyhyyyyyy\nyyyyyyyyyhhhhhyyyyyssooo++/+o++/+/++oosyhdmmmmdyyddmmdmmdhhssyyyyysyyyyy\nyyyyyyyyyyyyyyyyyyyyyssssssssso/:///+yyhddmmmmdhddmmmmNmddhyyyyyyyyyyyyy\nhhyyyyyyyyyyyyyyyyyyyyyyyyysyyos//+osyhdmmmmmmdddmmNNNmddmyyysssyyyyyyyy\nddhhhhhhhhyyyyhhhhhhhhyhhhsyhy+://oyshdmNNNmmmdmmNNNNNmddd++ossssyyyyyyy\nmmddddddddhhhhhhhhhhhhhhhyshyo::/ossydmNNmNNNmmmNNNNNmdddy+ooossssyyyyyy\nmmmmmddddddddhhhyyyyyoo+++oo/:/+syysdmmdddmNNmmmmNNNmmdhho/+ooossoooo+oo\nmmmmdddddddddhhhhysso++++o++:+osssydmdhdmmNNmmhddmmmdddyy///+/+////////+\nmmmmmddddddddhyhyysysssss++/+o/syyhhhdddmmmmmyyhddddhhhs+//:::::-.:://+/\nddddddddddhhhyhhhyyyyyss++/+o+sssoohddddmmmmhsssyhhhyyso/////://++++++++\nhhddddddddddhhhhsyhysosyh++o/ss++shhdddddddhssosssssosso--:://+++++//+oo\nyyyyhhhhhhhhyyyyyyyooyhho+/ooo+yhddhyhdhhhyss/:/ososooo:.---::::://:::/+\nssoossyyyyyyyysysoysssdso+++/ssshhyhhhhooo++.``-///o+++-.`.--::::::::--:\nyhyyyyyyyysssss+-+s+shy+oso:-+o+/+oosy+/+--/-`.-///+//+hs/:-::::/::----:\nhhhhhhyyyyso++/.:::/oy/++/:.-:/o/-///:::`./-::`---/:----:oss-.......----\nhhhhhhyyyyso+:.--.:/:::-/-:o--..-:-./..``:-++.+/.:/`-:````/yo...````.-..\nhhhyyyysssoo//--.:://:-+-.//-.-..-..`.``-/ohdoso+//::s/:shsoh:.-+syyo-`.\nssssssooo+//++/:::-.-:....--..:/+////:-.`oyddhhyyy+yhhyysyyoyyhhhdddo//+\noo+++++//:-::::/-....---:/+oso+//:/++:::--ysssyhhhhhdhhhdddhdmmdmmmh+ooo\nooossoo+oooooso++oosso+++///++//+//+++osoooo+odmmNmmmmmmmmhhhddmmmmddhhh\nddmmmmmmddddhhysssssyhhsyhhdddhhhhhhhyhhhhyhhsydhyyhhhyyyhhdddmdmddddddh\nddddmmmmdmddhhyyyyhdhhhhhddmmmmdddhhyooosso+oshdhhsyydhddmmmmmmmmmmmdhhh\nmNNNmmmmmmdmmmddddmmmdmddmmmmmmmmddhhhdhhdmmmNNNNmmmmmmmmmmmmmmmmmmmmddh\n\u003c/pre\u003e\n\nIt's like 2003 once again, \nand all our business cards say \"Webmaster\"\n\nby Craig Mod - [http://craigmod.com](http://craigmod.com)\n(c) Everyone\n\n------------------------------------------------------------------------  \n\n### Ahab! ###\n\nSuper-simple baseline .mobi templates. Here ya go. \n\nIt's also meant to be a bit geeky. It's for those of us who like to hand-code \nwebsites. Who want to know what's going on under the hood. Who are obsessive\nabout CSS class naming and indent styling and get pleasure knowing the \ninnards of the machines they produce are as beautiful and effecient as \npossible. \n\n\n### Mobi? ###\n\nMobi is Kindle's ebook format. It's sort of like EPUB's step-brother. \nIf you have a properly produced .mobi file you can publish on the \n[Kindle Direct Publishing](http://kdp.amazon.com) platform. \n\nWhy .mobi? [Pareto priciple](http://en.wikipedia.org/wiki/Pareto_principle) (\"80/20 rule\"). I want to leverage existing marketplaces for digital \npublishing, and Amazon covers 80%+ of the market I'm interested in reaching. \niBooks just doesn't have the audience, nor is the platform presently \ninviting (IMO) from a systems and ubiquity perspective. Kindle hits iPad, \niPhone, Android, web, desktop ... EVERYWHERE. And it does seamless syncing. \nI like all that. *Readers* like all that. \n\nThere's other engaged and energized communities emerging around products like\n[Readmill](http://readmill.com/) but I don't want to have to deal with \nselling stuff on my own. And I do want to sell stuff. That's part of the \nexperiment. And, I think it behooves anyone interested in the future of \npublishing to know the biggest guy in the room really well, even if you \ndon't like them. (I've got nothing against Amazon but it seems like\na lot of other folks do.) \n\n\n### This template ###\n\nThis template is meant to get you from *thinking* about publishing a piece of \ntext you have to *actually publishing* it on Kindle Direct Publishing. If you \nhave a long-form blog post composed mainly of text, I suspect you could \nconvert it to a proper .mobi file using this template in fifteen minutes. \nObviously, more complex texts (and cover production, etc) take more time. \n\nSo this template is mainly about minimizing friction. \n\n\n### Resources ###\n\n- Kindle Format 8 [Guidelines](http://www.amazon.com/gp/feature.html?docId=1000729511) are a good place to start\n- [Kindle Previewer](http://www.amazon.com/gp/feature.html?ie=UTF8\u0026docId=1000765261)\n- [Kindlegen](http://www.amazon.com/gp/feature.html?ie=UTF8\u0026docId=1000765211)\n\nIf you prefer, you may use a `COMMAND LINE PROGRAM`, kindlegen, to make .mobi \nfiles from your content.opf, but Kindle Previewer will do the same.\n\nAfter you install Kindle Previewer, open it and drag your carefully crafted `content.opf`\nit into the Kindle Previewer. It will then covert it to a .mobi file in the `Compiled-content.opf/` directory.\nKindle Previewer then opens the content.mobi file it spits out. \n\nYou should read the Compilation Details just to see if it warns of something crazy.\n\nKindle Previewer is pretty kludgy, but it gets the job done. It saves you from \ntrying to send .mobi files to seven different devices. And speeds up development / \ntesting / iteration time. \n\nYou will, at some point, want to send something to a bunch of Kindles. This \nutility is useful for that:\n\n- [Send to Kindle](http://www.amazon.com/gp/feature.html/?docId=1000778781)\n\nThere are a lot of people out there who have spent a lot more time working on\nthis stuff than I have. I referenced Liz Castro's [blog](http://www.pigsgourdsandwikis.com/)\nany number of times. \n\n\n### Covers ###\n\nSo Amazon revised their cover guidelines in early 2012. Here's the latest:\n- [Creating a catalog/cover image](https://kdp.amazon.com/self-publishing/help?topicId=A2J0TRG6OPX0VM)\n\nHere are the base requirements:\n\n\u003e Requirements for the size of your cover art: \n\u003e\n\u003e • Minimum of 1000 pixels on the longest side \n\u003e • Ideal height/width ratio of 1.6 \n\u003e \n\u003e For better quality, we recommend that images be 2500 pixels on the longest side. \n\nThe 1.6 ratio bit is weird. It's the dimensions for the Kindle Fire, which I \nhave to admit, feels odd. This is partially awkward since hardware eink Kindles have\na screen ratio closer to 1.3. \n\nAmazon currently doesn't offer the ability to include multiple covers for their\ndifferent devices. I feel inclined to design for hardware Kindles since I'm \nstill not convinced anyone actually uses/reads on first generation Kindle Fires. \n\nFor some reason, .png is not allowed for cover images. So make sure you stick with \n.jpg or .tiff. .pngs are allowed everywhere else. \n\n\n### CSS ###\n\nKindle Format 8 supports CSS media queries. It seems a little bit out of the\nscope of a baseline template, but if you're interested, [Liz Castro](http://www.pigsgourdsandwikis.com/2012/01/media-queries-for-formatting-poetry-on.html)\nexplains all. \n\n@font-face rules only work on Kindle Fire.\n\nActually, a lot of css rules only work on Fire. Floats, for example. The simpler\nyou keep your CSS, the saner you'll be. \n\nHere's the full list of KF8 HTML and CSS support:\n\n* [List of support HTML and CSS tags](http://www.amazon.com/gp/feature.html?ie=UTF8\u0026docId=1000729901)\n\n\n### What are these other files? ###\n\nToc.ncx \u0026 content.opf are the two slightly alien files of this collection.\n\nOPF means \"Open Packaging Format\". From [Wikipedia](http://en.wikipedia.org/wiki/EPUB#Open_Packaging_Format_2.0.1):\n\n\u003e The OPF file, traditionally named content.opf houses the EPUB book's \n\u003e metadata, file manifest, and linear reading order. This file has a \n\u003e root element package and four child elements: metadata, manifest, \n\u003e spine, and guide. All of these except guide are required. Furthermore, \n\u003e the package node must have the unique-identifier attribute. The .opf \n\u003e file's mimetype is application/oebps-package+xml.\n\nThe .ncx file is explained thusly: \n\n\u003e The NCX file (Navigation Control file for XML), traditionally named toc.ncx, \n\u003e contains the hierarchical table of contents for the EPUB file. The specification \n\u003e for NCX was developed for Digital Talking Book (DTB), is maintained by the DAISY \n\u003e Consortium, and is not a part of the EPUB specification. The NCX file has a \n\u003e mimetype of application/x-dtbncx+xml.\n\nExciting stuff! *zzzzzz*\n\nI've done my best to obviate thinking too much about these files.\n\n\n### Publish! ###\n\nSo you have your cover. You have your properly formated .mobi. You've tested it\nin Kindle Previewer and it looks pretty good on all the devices. Now, how do you\npublishg? \n\nYou can just mail the .mobi file to friends, put it up on a server, upload it \nto a forum — distribute any way — and any Kindle will be able to open the file. \n\nBut if you want to \"publish\" it on Amazon — set prices and get it properly listed — \nthen [Kindle Direct Publishing](http://kdp.amazon.com) is what you want. It should\nbe pretty self explainatory. \n\n\n### Extend ###\n\nThis is by no means exhaustive. It's meant to give anyone interested in .mobi a\nlittle boost. I've tried to strip away all the unnecessary gunk. What's remaining\nshould be relatively self explanatory. \n\n\n### Contact ###\n\nIf you do end up making a publishing something with this, please let us know. \nPost about it in the github project or shoot me an email: me@craigmod.com\n\n\n### Online ###\n\nA 'satellite' post on craigmod.com about this template lives here:\nhttp://craigmod.com/satellite/ahab/\n\n\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcmod%2Fahab","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcmod%2Fahab","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcmod%2Fahab/lists"}