Option to remove section pages

[majkinetor]

This quickly pile up on larger projects - I can have from 10-30 empty pages with this like it is now.

Here is an example:

• https://majkinetor.github.io/mm-docs-template/docs.pdf#page=16

Can we have an option to remove them ?

[timvink]

Definitely. If you inspect the print page, you can see that the section heading has the following HTML:

<h1 class="nav-section-title" id="section-extra">
                            Extra <a class="headerlink" href="#section-extra" title="Permanent link">↵</a>
</h1>

I could include some extra CSS. For example try:

.nav-section-title {
 display: hidden !important;
}

But probably you just want to avoid that sections have their own page because it takes so much space. That's controlled by some CSS from this plugin:

mkdocs-print-site-plugin/mkdocs_print_site_plugin/css/print-site.css

Lines 336 to 347 in ad73023

	/* PDF page breaks - separate title page for each section */
	#print-site-page .nav-section-title {
	page-break-before: always;
	page-break-after: always;
	align-content: center;
	text-align: center;
	vertical-align: middle;
	padding-top: 150px !important;
	padding-bottom: 0em;
	padding-left: 0em;
	font-size: 2.5em;
	}

You could try overriding it by adding:

 #print-site-page .nav-section-title { 
     page-break-before: avoid !important; 
     page-break-after: avoid !important; 
}

[majkinetor]

Mhm... that doesn't seem to be working right... page-break-before works, but page-break-after doesn't have any effect

details

I guess I should remove all breaks and eventually add them explicitly on sections I do want them. What is the easy way to remove them all, so that it looks like HTML one:

details

[timvink]

Looks there are some other CSS classes you need to overwrite, I think vertical-align is the culprit:

 #print-site-page .nav-section-title { 
     page-break-before: avoid !important; 
     page-break-after: avoid !important; 
     vertical-align: baseline !important;
     padding-top: 1em !important; 
}

[majkinetor]

Nah :)

You can see for yourself:

• download page
• using above css (see at the end of the file)

[majkinetor]

God damn, I experimented a lot with F12 tools in chrome, messing around with all CSS on that element, and I found some constellations would produce desired result, but I can't pinpoint exactly what CSS combination needs to be set for this.... freaking css...

[timvink]

Yeah this is too clunky. I will add an option to not include the CSS stylesheets. You can then add them yourself and modify them directly.

[timvink]

Released in v2.2

[majkinetor]

Works great.

Thanks m8 :)