Quantcast

Splitting blocks across pages with asciidoctor-pdf

classic Classic list List threaded Threaded
6 messages Options
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Splitting blocks across pages with asciidoctor-pdf

AndreaC
Hello,

I'm rendering some technical documentation which has some code blocks and some blockquotes. Those blocks are maybe half a page long, and would not fit in their current page, thus a page-break is inserted and the blocks start on a new page leaving the first one half empty. Is there an option I can use that allows splitting such blocks across pages?

Thanks,

.a.c.
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: Splitting blocks across pages with asciidoctor-pdf

mojavelinux
Administrator
No, this is just how Asciidoctor PDF works right now. It tries to make the block fit on a page by itself and only splits it if it doesn't fit on a single page.

I suppose it's reasonable that we not try to keep block quotes together by default. Perhaps this feature should only be enabled when the unbreakable option is present on the block.

-Dan

On Thu, Aug 11, 2016 at 5:07 AM, AndreaC [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Hello,

I'm rendering some technical documentation which has some code blocks and some blockquotes. Those blocks are maybe half a page long, and would not fit in their current page, thus a page-break is inserted and the blocks start on a new page leaving the first one half empty. Is there an option I can use that allows splitting such blocks across pages?

Thanks,

.a.c.



If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Splitting-blocks-across-pages-with-asciidoctor-pdf-tp4863.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML



--
Dan Allen | @mojavelinux | https://twitter.com/mojavelinux
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: Splitting blocks across pages with asciidoctor-pdf

AndreaC
Hi Dan, thanks for your answer,

I would personally say it makes sense if it's not too hard to implement.

Asciidoctor is great: keep up the good work!

.a.c.

mojavelinux wrote
No, this is just how Asciidoctor PDF works right now. It tries to make the
block fit on a page by itself and only splits it if it doesn't fit on a
single page.

I suppose it's reasonable that we not try to keep block quotes together by
default. Perhaps this feature should only be enabled when the unbreakable
option is present on the block.

-Dan
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: Splitting blocks across pages with asciidoctor-pdf

mojavelinux
Administrator
Would you be willing to file an issue at the following URL to request it?


On Fri, Aug 12, 2016 at 3:32 AM, AndreaC [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Hi Dan, thanks for your answer,

I would personally say it makes sense if it's not too hard to implement.

Asciidoctor is great: keep up the good work!

.a.c.

mojavelinux wrote
No, this is just how Asciidoctor PDF works right now. It tries to make the
block fit on a page by itself and only splits it if it doesn't fit on a
single page.

I suppose it's reasonable that we not try to keep block quotes together by
default. Perhaps this feature should only be enabled when the unbreakable
option is present on the block.

-Dan



If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Splitting-blocks-across-pages-with-asciidoctor-pdf-tp4863p4865.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML



--
Dan Allen | @mojavelinux | https://twitter.com/mojavelinux
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: Splitting blocks across pages with asciidoctor-pdf

AndreaC
Here it is: https://github.com/asciidoctor/asciidoctor-pdf/issues/509

Thanks,

mojavelinux wrote
Would you be willing to file an issue at the following URL to request it?

https://github.com/asciidoctor/asciidoctor-pdf/issues/new

-Dan
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: Splitting blocks across pages with asciidoctor-pdf

mojavelinux
Administrator
Thanks! I'll follow-up there.

-Dan

On Fri, Aug 12, 2016 at 4:01 AM, AndreaC [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Here it is: https://github.com/asciidoctor/asciidoctor-pdf/issues/509

Thanks,

mojavelinux wrote
Would you be willing to file an issue at the following URL to request it?

https://github.com/asciidoctor/asciidoctor-pdf/issues/new

-Dan



If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Splitting-blocks-across-pages-with-asciidoctor-pdf-tp4863p4867.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML



--
Dan Allen | @mojavelinux | https://twitter.com/mojavelinux
Loading...