ℹ️ Note

This is a fork of the much appreciated mr-pdf. Our fork is just to ease maintenance for use with our Docusaurus sites, not the other systems that mr-pdf supports.

About docu-pdf

This is a command line tool for creating PDFs from documentation sites built with Docusaurus. While your browser can make pdfs of individual pages, this makes one of all the pages.

Usage

npx docu-pdf https://docs.bloomlibrary.org/

CLI Options

| Option | Required | Description | | ------------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | main argument | Yes | The root of your documentation. If you need multiple root urls, separate with commas. | | --outputPath | No | path to output PDF file. Default is site.pdf | | --pageSize | No | pdf format e.g. --pageSize="A3". Please check this link for available formats Puppeteer document | | --coverPath | No | file path to custom HTML file for cover. Top level should be like <div style="page-break-after:always"></div>. | | --disableTOC | No | Omit the table of contents | | --headerTemplate | No | HTML template for the print header. More info | | --footerTemplate | No | HTML template for the print footer. More info |

| Option | Required | Description | | --------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | '--tocLevel ' | No | 'The minimum header level to include in the table of contents. E.g. "1" (default), "2", or "3"' | | --contentSelector | No | CSS selector for the major sections. Default is article. | | --nextPageSelector | No | CSS selector for the link to follow to the next section | | --excludeURLs | No | URLs to be excluded in PDF. Comma separated. | | --excludeSelectors | No | CSS selector for HTML elements to omit from PDF. E.g. .nav,.sidebar. Separate each selector with comma and no space. You can use space in each selector. e.g. --excludeSelectors=".nav,.next > a" | | --cssStyle | No | CSS style to adjust PDF output. E.g. --cssStyle="body{padding-top: 0;}" *If you're project owner you can use @media print { } to edit CSS for PDF. | | --pdfMargin | No | set margin around PDF file. Separate each margin with comma and no space. E.g. --pdfMargin="10,20,30,40". This sets margin top: 10px, right: 20px, bottom: 30px, left: 40px |