{"id":16832496,"url":"https://github.com/kennethormandy/hb-epub3","last_synced_at":"2026-03-15T23:39:26.229Z","repository":{"id":145823323,"uuid":"13235574","full_name":"kennethormandy/hb-epub3","owner":"kennethormandy","description":"A Harp boilerplate for creating EPUB3 ebooks.","archived":false,"fork":false,"pushed_at":"2013-10-01T16:28:57.000Z","size":813,"stargazers_count":10,"open_issues_count":2,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-24T09:41:34.415Z","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/kennethormandy.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":"2013-10-01T05:24:30.000Z","updated_at":"2019-07-09T05:31:06.000Z","dependencies_parsed_at":"2023-03-23T03:47:39.286Z","dependency_job_id":null,"html_url":"https://github.com/kennethormandy/hb-epub3","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/kennethormandy%2Fhb-epub3","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kennethormandy%2Fhb-epub3/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kennethormandy%2Fhb-epub3/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kennethormandy%2Fhb-epub3/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kennethormandy","download_url":"https://codeload.github.com/kennethormandy/hb-epub3/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244141479,"owners_count":20404837,"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-10-13T11:49:17.602Z","updated_at":"2025-10-26T21:08:12.328Z","avatar_url":"https://github.com/kennethormandy.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# hb-epub3\n\nA Harp boilerplate for generating EPUB3 ebooks.\n\n![An example made using this boilerplate.](https://raw.github.com/kennethormandy/hb-epub3/master/example.jpg)\n\n## Get started\n\n1. Install Harp\n\n  This boilerplate is for Harp, the static web server with built-in preprocessing. [Harp](http://harpjs.com) can flatten the preprocessed code—in this case, Jade, Stylus and Markdown—to HTML \u0026 CSS. Then, it can easily be turned into a `.epub` file.\n\n  Install Harp globally:\n\n  ```ssh\n  sudo npm install harp -g\n  ```\n\n2. Clone this boilerplate\n\n  Next, clone this boilerplate.\n\n  ```ssh\n  git clone https://github.com/kennethormandy/hb-epub3 ebook\n  cd ebook\n  ```\n\n3. Compile your `.epub` using Harp\n\n  Then, using the OS’ `zip` command, the generated folder can be compressed into a valid `.epub` file.\n\n  ```ssh\n  harp compile . ebook; cd ebook; zip -X0 \\../ebook.epub mimetype; zip -rDX9 \\../ebook.epub * -x \"*.DS_Store\" -x mimetype; cd \\../\n  ```\n\n  Now, if you want to make some quick changes and just view them in the browser, you can serve a locally:\n\n  ```ssh\n  harp server\n  # The content is now visible at http://harp.nu:9000/OPS/book/content\n  ```\n\n## Todo\n\n- [ ] Properly support everything listed in `harp.json`\n- [ ] Further improve typographic defaults\n- [ ] Automatically use any Markdown in `_content/`\n- [ ] Restore text sizing in iBooks\n- [ ] Run against accessibility checklist\n\n## Works Cited\n\n* [Candide by Voltaire, via Project Gutenberg](http://www.gutenberg.org/ebooks/19942)\n* [reitermarkus/epub3-boilerplate](https://github.com/reitermarkus/epub3-boilerplate)\n* [javierarce/epub-boilerplate](https://github.com/javierarce/epub-boilerplate)\n* [Saolee/epub-boilerplate](https://github.com/Saolee/epub-boilerplate)\n* [mattharrison/epub-css-starter-kit](https://github.com/mattharrison/epub-css-starter-kit)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkennethormandy%2Fhb-epub3","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkennethormandy%2Fhb-epub3","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkennethormandy%2Fhb-epub3/lists"}