{"action":"created","issue":{"url":"https://api.github.com/repos/asciidoctor/asciidoctor/issues/626","labels_url":"https://api.github.com/repos/asciidoctor/asciidoctor/issues/626/labels{/name}","comments_url":"https://api.github.com/repos/asciidoctor/asciidoctor/issues/626/comments","events_url":"https://api.github.com/repos/asciidoctor/asciidoctor/issues/626/events","html_url":"https://github.com/asciidoctor/asciidoctor/issues/626","id":19330585,"number":626,"title":"Support chunked (multi-page) HTML output in asciidoctor","user":{"login":"gAmUssA","id":433085,"avatar_url":"https://avatars.githubusercontent.com/u/433085?v=3","gravatar_id":"","url":"https://api.github.com/users/gAmUssA","html_url":"https://github.com/gAmUssA","followers_url":"https://api.github.com/users/gAmUssA/followers","following_url":"https://api.github.com/users/gAmUssA/following{/other_user}","gists_url":"https://api.github.com/users/gAmUssA/gists{/gist_id}","starred_url":"https://api.github.com/users/gAmUssA/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/gAmUssA/subscriptions","organizations_url":"https://api.github.com/users/gAmUssA/orgs","repos_url":"https://api.github.com/users/gAmUssA/repos","events_url":"https://api.github.com/users/gAmUssA/events{/privacy}","received_events_url":"https://api.github.com/users/gAmUssA/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/asciidoctor/asciidoctor/labels/enhancement","name":"enhancement","color":"009800"},{"url":"https://api.github.com/repos/asciidoctor/asciidoctor/labels/hackfest","name":"hackfest","color":"d4c5f9"}],"state":"open","locked":false,"assignee":{"login":"mojavelinux","id":79351,"avatar_url":"https://avatars.githubusercontent.com/u/79351?v=3","gravatar_id":"","url":"https://api.github.com/users/mojavelinux","html_url":"https://github.com/mojavelinux","followers_url":"https://api.github.com/users/mojavelinux/followers","following_url":"https://api.github.com/users/mojavelinux/following{/other_user}","gists_url":"https://api.github.com/users/mojavelinux/gists{/gist_id}","starred_url":"https://api.github.com/users/mojavelinux/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mojavelinux/subscriptions","organizations_url":"https://api.github.com/users/mojavelinux/orgs","repos_url":"https://api.github.com/users/mojavelinux/repos","events_url":"https://api.github.com/users/mojavelinux/events{/privacy}","received_events_url":"https://api.github.com/users/mojavelinux/received_events","type":"User","site_admin":false},"milestone":{"url":"https://api.github.com/repos/asciidoctor/asciidoctor/milestones/15","html_url":"https://github.com/asciidoctor/asciidoctor/milestones/v1.7.0","labels_url":"https://api.github.com/repos/asciidoctor/asciidoctor/milestones/15/labels","id":468432,"number":15,"title":"v1.7.0","description":"","creator":{"login":"graphitefriction","id":1124042,"avatar_url":"https://avatars.githubusercontent.com/u/1124042?v=3","gravatar_id":"","url":"https://api.github.com/users/graphitefriction","html_url":"https://github.com/graphitefriction","followers_url":"https://api.github.com/users/graphitefriction/followers","following_url":"https://api.github.com/users/graphitefriction/following{/other_user}","gists_url":"https://api.github.com/users/graphitefriction/gists{/gist_id}","starred_url":"https://api.github.com/users/graphitefriction/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/graphitefriction/subscriptions","organizations_url":"https://api.github.com/users/graphitefriction/orgs","repos_url":"https://api.github.com/users/graphitefriction/repos","events_url":"https://api.github.com/users/graphitefriction/events{/privacy}","received_events_url":"https://api.github.com/users/graphitefriction/received_events","type":"User","site_admin":false},"open_issues":134,"closed_issues":0,"state":"open","created_at":"2013-10-29T21:51:42Z","updated_at":"2016-01-11T10:40:02Z","due_on":null,"closed_at":null},"comments":42,"created_at":"2013-09-11T16:30:38Z","updated_at":"2016-01-13T22:25:38Z","closed_at":null,"body":"Asciidoc can produce chunked html output via docbook toolchain http://www.methods.co.nz/asciidoc/chunked/ch05.html#_asciidoc_docbook_xsl_stylesheets_drivers"},"comment":{"url":"https://api.github.com/repos/asciidoctor/asciidoctor/issues/comments/171456697","html_url":"https://github.com/asciidoctor/asciidoctor/issues/626#issuecomment-171456697","issue_url":"https://api.github.com/repos/asciidoctor/asciidoctor/issues/626","id":171456697,"user":{"login":"mojavelinux","id":79351,"avatar_url":"https://avatars.githubusercontent.com/u/79351?v=3","gravatar_id":"","url":"https://api.github.com/users/mojavelinux","html_url":"https://github.com/mojavelinux","followers_url":"https://api.github.com/users/mojavelinux/followers","following_url":"https://api.github.com/users/mojavelinux/following{/other_user}","gists_url":"https://api.github.com/users/mojavelinux/gists{/gist_id}","starred_url":"https://api.github.com/users/mojavelinux/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mojavelinux/subscriptions","organizations_url":"https://api.github.com/users/mojavelinux/orgs","repos_url":"https://api.github.com/users/mojavelinux/repos","events_url":"https://api.github.com/users/mojavelinux/events{/privacy}","received_events_url":"https://api.github.com/users/mojavelinux/received_events","type":"User","site_admin":false},"created_at":"2016-01-13T22:25:38Z","updated_at":"2016-01-13T22:25:38Z","body":"While in practice I agree we need to provide the ability to chunk the output (multiple output documents for a single input), I do want to point out that I think arbitrarily slicing of a document at a fixed section level is a very bad practice in terms of usability. It leads to pages like https://docs.fedoraproject.org/en-US/Fedora/23/html/System_Administrators_Guide/s2-email-types-mua.html, which is a complete waste of a click because it lacks any context or substance. It's a single glossary term in the middle of a book. That's not a page.\r\n\r\nI really like the emergent idea of topic-based authoring, information which is pre-chunked and can be combined together in different ways using includes to create different documents. The OpenShift Origin documentation is a great example of this (as supported by Asciibinder). See https://docs.openshift.org/latest/welcome/index.html\r\n\r\nWhere chunking is valuable is when a large book/document needs to be partitioned to avoid unnecessary grouping of information and lots of scrolling (like the current Asciidoctor user manual). But even then, that's a stop-gap measure. Topic-based authoring may be the correct solution."}}