{"action":"created","issue":{"url":"https://api.github.com/repos/phoenixframework/phoenix_guides/issues/623","repository_url":"https://api.github.com/repos/phoenixframework/phoenix_guides","labels_url":"https://api.github.com/repos/phoenixframework/phoenix_guides/issues/623/labels{/name}","comments_url":"https://api.github.com/repos/phoenixframework/phoenix_guides/issues/623/comments","events_url":"https://api.github.com/repos/phoenixframework/phoenix_guides/issues/623/events","html_url":"https://github.com/phoenixframework/phoenix_guides/issues/623","id":188942988,"number":623,"title":"Produce epub version of Guides and API docs","user":{"login":"wsmoak","id":20140,"avatar_url":"https://avatars.githubusercontent.com/u/20140?v=3","gravatar_id":"","url":"https://api.github.com/users/wsmoak","html_url":"https://github.com/wsmoak","followers_url":"https://api.github.com/users/wsmoak/followers","following_url":"https://api.github.com/users/wsmoak/following{/other_user}","gists_url":"https://api.github.com/users/wsmoak/gists{/gist_id}","starred_url":"https://api.github.com/users/wsmoak/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/wsmoak/subscriptions","organizations_url":"https://api.github.com/users/wsmoak/orgs","repos_url":"https://api.github.com/users/wsmoak/repos","events_url":"https://api.github.com/users/wsmoak/events{/privacy}","received_events_url":"https://api.github.com/users/wsmoak/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":1,"created_at":"2016-11-13T00:16:24Z","updated_at":"2016-11-18T01:34:52Z","closed_at":null,"body":"Now that the guides are included with the API docs, and ExDoc has epub support, should we configure the build so that both html and epub are produced?\r\n\r\nHere's a preview:  http://wsmoak.net/phoenix/Phoenix-v1.3.0-dev.epub  (It's not picking up the page titles of the 'extras' for the table of contents.  Not sure if that's a bug.)\r\n\r\nIt currently takes two steps:  `mix docs` and then `mix docs -f epub`.  \r\n\r\n(I tried combining them with `mix do ...` but was not successful.  There's probably a way.)\r\n\r\n(It's also possibly by adding `formatter:  \"epub\"` to the 'docs' config, but there's only one of those, so it would need to get merged in on the second run somehow.)\r\n\r\nThe change for this will need to be added to the phoenix `mix.exs` but I thought it was better to discuss here since it's documentation related.\r\n\r\nThe phoenix mix.exs has `preferred_cli_env: [docs: :docs],` so that you do not have to type `MIX_ENV=docs` every time.\r\n\r\nWhen I tried to define an alias in an attempt to get docs to run twice, it seemed to lose that preferred environment.\r\n\r\nAssuming we want to do this, is it possible to configure mix.exs so that both the html and the epub are created with a single command? "},"comment":{"url":"https://api.github.com/repos/phoenixframework/phoenix_guides/issues/comments/261424213","html_url":"https://github.com/phoenixframework/phoenix_guides/issues/623#issuecomment-261424213","issue_url":"https://api.github.com/repos/phoenixframework/phoenix_guides/issues/623","id":261424213,"user":{"login":"wsmoak","id":20140,"avatar_url":"https://avatars.githubusercontent.com/u/20140?v=3","gravatar_id":"","url":"https://api.github.com/users/wsmoak","html_url":"https://github.com/wsmoak","followers_url":"https://api.github.com/users/wsmoak/followers","following_url":"https://api.github.com/users/wsmoak/following{/other_user}","gists_url":"https://api.github.com/users/wsmoak/gists{/gist_id}","starred_url":"https://api.github.com/users/wsmoak/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/wsmoak/subscriptions","organizations_url":"https://api.github.com/users/wsmoak/orgs","repos_url":"https://api.github.com/users/wsmoak/repos","events_url":"https://api.github.com/users/wsmoak/events{/privacy}","received_events_url":"https://api.github.com/users/wsmoak/received_events","type":"User","site_admin":false},"created_at":"2016-11-18T01:34:52Z","updated_at":"2016-11-18T01:34:52Z","body":"@milmazz if you have time, do you have any insight on why the epub for the phoenix docs doesn't have 'chapter titles' in the table of contents for the 'extras' pages?\r\n\r\nThis is with `mix docs -f epub` in the phoenixframework/phoenix project, so that it builds both the API docs _and_ the guides together.\r\n\r\nIt looks like this:\r\n\r\n![phoenix-epub-toc](https://cloud.githubusercontent.com/assets/20140/20415125/5909e280-ad04-11e6-9846-90a35b6e25fe.png)\r\n\r\nThen if you look at the rendered pages, it's duplicating the page title:\r\n\r\n![phoenix-epub-duplicate-header](https://cloud.githubusercontent.com/assets/20140/20415222/e05de59c-ad04-11e6-84f0-29e1381e99b3.png)\r\n\r\nI tried it with a newly generated simple project with just README included as an extras page, and could not reproduce it.  (Though in that case I got uppercase README as the 'chapter title' which isn't what I wanted either -- it seems to be picking up the filename.)\r\n\r\nLet me know if I should open an issue in ex_doc, I wasn't sure if we've just got it configured wrong.\r\n"}}
{"actor":{"display_login":"wsmoak"}}