{"id":13592264,"url":"https://github.com/ofosos/ox-epub","last_synced_at":"2025-04-08T23:31:42.606Z","repository":{"id":150853327,"uuid":"83170926","full_name":"ofosos/ox-epub","owner":"ofosos","description":"Org mode epub export","archived":false,"fork":false,"pushed_at":"2022-08-12T02:05:13.000Z","size":119,"stargazers_count":89,"open_issues_count":9,"forks_count":10,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-08-02T16:44:28.383Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Emacs Lisp","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ofosos.png","metadata":{"files":{"readme":"README.org","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2017-02-25T23:46:39.000Z","updated_at":"2024-07-03T13:53:34.000Z","dependencies_parsed_at":"2023-04-24T08:37:30.392Z","dependency_job_id":null,"html_url":"https://github.com/ofosos/ox-epub","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ofosos%2Fox-epub","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ofosos%2Fox-epub/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ofosos%2Fox-epub/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ofosos%2Fox-epub/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ofosos","download_url":"https://codeload.github.com/ofosos/ox-epub/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223346594,"owners_count":17130467,"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:07.481Z","updated_at":"2024-11-06T13:30:40.951Z","avatar_url":"https://github.com/ofosos.png","language":"Emacs Lisp","funding_links":["https://www.buymeacoffee.com/markZb"],"categories":["Emacs Lisp"],"sub_categories":[],"readme":"[[https://travis-ci.org/ofosos/ox-epub.svg?branch=master]]\n[[http://stable.melpa.org/packages/ox-epub-badge.svg]]\n\n\n* ox-epub\n\nGenerate =.epub= files directly from OrgMode. This will export EPUB\nversion 2, which should give broad compatibility. It should also be\nrelatiely easy to convert the resulting =.epub= to a =.mobi= (Kindle).\n\n** Prerequisites\n\nThis depends on Emacs 24.3 and OrgMode 9, it won't work on OrgMode 8 or\nany version of Emacs before 24.3.\n\nYou will also need a working version of the =zip= utility.\n\n** Installation\n\nIf you have MELPA stable activated, it is as simple as this:\n\n=M-x package-install RET ox-epub RET=\n\n** Usage\n\nSee the =sample= directory for a sample of what ox-epub can do.\n\nHit =C-c C-e E e= to publish the current buffer to an EPUB.\n\nThere are some required export options that need to be set. These are\n\n - =UID= a unique id of the document, otherwise known as uri, may be a url\n - =DATE= the date of the document, for valid values see\n   [[https://www.w3.org/TR/NOTE-datetime]]\n - =AUTHOR= the document author or editor, the creator in the EPUB spec\n - =TITLE= the document title\n\nFurthermore there are some properties which are optional:\n\n - =Subject= the subject matter of the book\n - =Description= a description of the book\n - =Publisher= the publisher of the book\n - =License= the rights associated with this book, the copyright\n   notice and further rights may be included in this option.\n - =EPUBCOVER= the cover image to use for the export\n - =EPUBSTYLE= the CSS file to use for the export, this is set by default\n   but can be set on a per document basis\n\nThe only other option that is exported:\n\n - =LANGUAGE= the language of the book, this is to be interpreted\n   according to RFC3066 or it's succeeding documents\n   [[https://www.ietf.org/rfc/rfc3066.txt]], no other interpretations are\n   allowed according to the EPUB spec.\n\n** Features\n\nCurrently =ox-epub= can do the following:\n\n - simple cover images\n - inclusion of png and jpg images\n - export of mathematical formulas\n - direct =.epub= generation\n - add stylesheets to your liking: Use the EPUBSTYLE property to add a\n   list of stylesheets and customize =html-head-include-default-style=\n   to toggle inclusion of the default stylesheet.\n\n** Caveats\n\n - Mathematical formulas only export well if you use the =dvipng=\n   backend. =dvipng= should be included in TeXlive.\n\n** Coffee\n\nI very much like coffee, so if you want to contribute to my coffee fund,\nyou can now do that :)\n\n[[https://www.buymeacoffee.com/markZb][https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png]]\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fofosos%2Fox-epub","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fofosos%2Fox-epub","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fofosos%2Fox-epub/lists"}