{"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":3,"created_at":"2016-11-13T00:16:24Z","updated_at":"2016-11-18T08:32:21Z","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/261476242","html_url":"https://github.com/phoenixframework/phoenix_guides/issues/623#issuecomment-261476242","issue_url":"https://api.github.com/repos/phoenixframework/phoenix_guides/issues/623","id":261476242,"user":{"login":"josevalim","id":9582,"avatar_url":"https://avatars.githubusercontent.com/u/9582?v=3","gravatar_id":"","url":"https://api.github.com/users/josevalim","html_url":"https://github.com/josevalim","followers_url":"https://api.github.com/users/josevalim/followers","following_url":"https://api.github.com/users/josevalim/following{/other_user}","gists_url":"https://api.github.com/users/josevalim/gists{/gist_id}","starred_url":"https://api.github.com/users/josevalim/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/josevalim/subscriptions","organizations_url":"https://api.github.com/users/josevalim/orgs","repos_url":"https://api.github.com/users/josevalim/repos","events_url":"https://api.github.com/users/josevalim/events{/privacy}","received_events_url":"https://api.github.com/users/josevalim/received_events","type":"User","site_admin":false},"created_at":"2016-11-18T08:32:21Z","updated_at":"2016-11-18T08:32:21Z","body":"@milmazz beautiful. Do you think we can use the newly added :group attribute on epub too? It would be nice if the table of contents looked like:\r\n\r\n```\r\n## Guides\r\n\r\n1. ...\r\n2. ...\r\n35. ...\r\n\r\n## Modules\r\n\r\n36. ...\r\n51. ...\r\n\r\n## Exceptions\r\n\r\n...\r\n\r\n## Protocols\r\n\r\n...\r\n```\r\n\r\nBut I am not sure if that is possible."}}
{"actor":{"display_login":"josevalim"}}