Content Tabs that exceed a page not working

[psalaberria002]

When using the content tabs feature, if the concatenation of the tabs exceeds a single page, the PDF breaks.

Reproduction in psalaberria002@83e8a88

Checkout that commit, and make docs. You will notice the PDF stops rendering after that page.

[Nickyang00]

I encountered same problem, but can tab be nomarlly rendered in pdf? I just removed them.

[psalaberria002]

I encountered same problem, but can tab be nomarlly rendered in pdf? I just removed them.

The plugin supports rendering tabs yes. It renders all tabs one after another. There is an example in the repo.

[nihalshah-dev]

I have around 7 tabs and each tab has long tables in it. The pdf either breaks when the table size is too long or it overlaps all tabs one on each other like layers.

i managed the table breaks from discussion here.

no idea why content tabs don't work. Does it really support this feature at all? @domWalters

I think the root cause is likely in how tabbed content is expanded and wrapped for PDF output. The function wrap_tabbed_set_content in tabbed_set_util.py expands all tabs, wrapping their content, so the PDF generator sees all tab content concatenated. If this concatenated content exceeds a single page, the PDF rendering breaks, possibly due to a missing or incorrect page break, or a layout/CSS issue.

possible solution -

#tabbed_set_util.py

import itertools
from logging import Logger

from bs4 import PageElement


def wrap_tabbed_set_content(soup: PageElement, logger: Logger = None):
    for ts in soup.select('div.tabbed-set'):
        for radio in ts.select('input'):
            els = [i for i in itertools.takewhile(
                lambda x: x.name not in ['input'],
                radio.next_siblings)]
            wrapper = soup.new_tag('div', **{'class': 'tabbed-content--wrap'})
            radio.wrap(wrapper)
            for tag in els:
                wrapper.append(tag)
           
            # new addition
            # insert a page-break after each tabbed-content--wrap for PDF rendering
            page_break = soup.new_tag('div', style='page-break-after: always;')
            wrapper.insert_after(page_break)

    for d in soup.select('details'):
        d['open'] = ''

[nihalshah-dev]

@hkato it would be a great help, if you have some time here. 😁

[hkato]

Hi, @nihalshah-dev san,

It seems to be a cross-page issue, but I'm not sure what the cause is at the moment. Did you fix it with your code?

[nihalshah-dev]

No @hkato, haven't tried fully in my local machine. at the moment its little difficult considering my responsibilities. I briefly peaked through the code and suggested the above possible resolution.

Fork and customize will need a lot of effort and time TBH which is not possible soon atm.

I wish these 3 topics shall be resolved soon as we use the plugin extensively for multiple and huge repos.

1. Bug: codeblocks with ´linenums´ option that are too long to fit a page break the PDF generation #62 - long code blocks
2. Content Tabs that exceed a page not working #92 - content tabs
3. FYI: MkDocs to PDF + various diagrams (Mermaid, PlantUML, ...) #68 - plantuml & mermaid (waiting for the branch to merge into main)

cc/ @domWalters