Difference between revisions of "Manual:Extension/BlueSpiceBookshelf/Customized PDF Output"

[quality revision][quality revision]

How to adjust page breaks in multi-page PDFs.

Adjusting page breaks[edit | edit source]

By default, each chapter and sub-chapter in a Book-PDF is started on a new page. To avoid these page breaks and to create a continuous chapter flow, an administrator can add the following code to the page MediaWiki:Common.css:
                    /*PDF book or PDF with subpages - no page breaks between chapters*/
.bs-page-content { page-break-after: avoid; }

                
If you want to start the main chapters on separate pages, use this code instead:
                    /*PDF book or PDF with subpages - page break only after chapter levl 1 */
.bs-page-content { page-break-after: avoid; }
.bs-page-content.booklevel-1 { page-break-before: always; }

                

You can add further chapter levels as needed:

                    /*PDF book or PDF with subpages - page breaks after chapter levels 1 and 2*/
.bs-page-content { page-break-after: avoid; }
.bs-page-content.booklevel-1, .bs-page-content.booklevel-2 { page-break-before: always; }

                

Note: These settings apply both to the PDF output of books and to the PDF export which includes linked pages or subpages of a wiki page.

How to adjust page breaks in multi-page PDFs.
        
        
        
        ==Adjusting page breaks==
        
        
        
        By default, each chapter and sub-chapter in a Book-PDF is started on a new page. To avoid these page breaks and to create a continuous chapter flow,  an administrator can add the following code to the page MediaWiki:Common.css:<syntaxhighlight lang="css">
        
        /*PDF book or PDF with subpages  - no page breaks between chapters*/
        
        .bs-page-content { page-break-after: avoid; }
        
        
        </syntaxhighlight>If you want to start the main chapters on separate pages, use this code instead:<syntaxhighlight lang="css">
        
        /*PDF book or PDF with subpages  - page break only after chapter levl 1 */
        
        .bs-page-content { page-break-after: avoid; }
        
        .bs-page-content.booklevel-1 { page-break-before: always; }
        
        
        </syntaxhighlight>
        
        
        
        You can add further chapter levels as needed:
        
        
        
        
        <syntaxhighlight lang="css">
        
        /*PDF book or PDF with subpages - page breaks after chapter levels 1 and 2*/
        
        .bs-page-content { page-break-after: avoid; }
        
        .bs-page-content.booklevel-1, .bs-page-content.booklevel-2 { page-break-before: always; }
        
        
        </syntaxhighlight>
        
        
        
            
            {{Box Note|boxtype=note|Note text=These settings apply both to the PDF output of books and to the PDF export which includes linked pages or subpages of a wiki page.|bgcolor=}}
            
            
        [[Category:Customization]]
        
        
        
        [[en:{{FULLPAGENAME}}]]
        
        [[de: Handbuch:Erweiterung/BlueSpiceBookshelf/PDF_Ausgabe_anpassen]]
Line 4: Line 4:
  
 
By default, each chapter and sub-chapter in a Book-PDF is started on a new page. To avoid these page breaks and to create a continuous chapter flow,  an administrator can add the following code to the page MediaWiki:Common.css:<syntaxhighlight lang="css">
 
By default, each chapter and sub-chapter in a Book-PDF is started on a new page. To avoid these page breaks and to create a continuous chapter flow,  an administrator can add the following code to the page MediaWiki:Common.css:<syntaxhighlight lang="css">
/*PDF book or PDF with subpages - no page breaks between chapters*/
+
/*PDF book - no page breaks between chapters*/
 
.bs-page-content { page-break-after: avoid; }
 
.bs-page-content { page-break-after: avoid; }
 
</syntaxhighlight>If you want to start the main chapters on separate pages, use this code instead:<syntaxhighlight lang="css">
 
</syntaxhighlight>If you want to start the main chapters on separate pages, use this code instead:<syntaxhighlight lang="css">
/*PDF book or PDF with subpages - page break only after chapter levl 1 */
+
/*PDF book - page break only after chapter levl 1 */
 
.bs-page-content { page-break-after: avoid; }
 
.bs-page-content { page-break-after: avoid; }
 
.bs-page-content.booklevel-1 { page-break-before: always; }
 
.bs-page-content.booklevel-1 { page-break-before: always; }
Line 15: Line 15:
  
 
<syntaxhighlight lang="css">
 
<syntaxhighlight lang="css">
/*PDF book or PDF with subpages - page breaks after chapter levels 1 and 2*/
+
/*PDF book - page breaks after chapter levels 1 and 2*/
 
.bs-page-content { page-break-after: avoid; }
 
.bs-page-content { page-break-after: avoid; }
 
.bs-page-content.booklevel-1, .bs-page-content.booklevel-2 { page-break-before: always; }
 
.bs-page-content.booklevel-1, .bs-page-content.booklevel-2 { page-break-before: always; }
 
</syntaxhighlight>
 
</syntaxhighlight>
 
{{Box Note|boxtype=note|Note text=These settings apply both to the PDF output of books and to the PDF export which includes linked pages or subpages of a wiki page.|bgcolor=}}
 
 
[[Category:Customization]]
 
[[Category:Customization]]
  
 
[[en:{{FULLPAGENAME}}]]
 
[[en:{{FULLPAGENAME}}]]
 
[[de: Handbuch:Erweiterung/BlueSpiceBookshelf/PDF_Ausgabe_anpassen]]
 
[[de: Handbuch:Erweiterung/BlueSpiceBookshelf/PDF_Ausgabe_anpassen]]

Attachments

Discussions