\r\n\r\n## Related\r\n\r\n- [vitepress-export-pdf](https://github.com/condorheroblog/vitepress-export-pdf)\r\n- [@condorhero/vuepress-plugin-export-pdf-v2](https://github.com/condorheroblog/vuepress-plugin-export-pdf/blob/main/packages/vuepress-plugin-export-pdf-v2/README.md)\r\n\r\n## Installation\r\n\r\n```sh\r\nnpm install @condorhero/vuepress-plugin-export-pdf -D\r\n```\r\nthen add script to your `package.json`:\r\n\r\n```json\r\n{\r\n \"scripts\": {\r\n \"export-pdf\": \"press-export-pdf export [path/to/your/docs]\"\r\n }\r\n}\r\n```\r\n\r\nThen run:\r\n\r\n```sh\r\nnpm run export-pdf\r\n```\r\n\r\n## `press-export-pdf` Command Options\r\n\r\nThe package provides the `press-export-pdf` command with the following command line options:\r\n\r\n\r\n\r\n- `export [sourceDir]`: Export your site to a PDF file\r\n - `-c, --config `: Set path to config file\r\n - `--outFile `: Name of output file\r\n - `--pdfOutlines `: Keep PDF outlines/bookmarks([**Node >= 18.5.0**](https://github.com/condorheroblog/vuepress-plugin-export-pdf/tree/v3.0.1/packages/vuepress-plugin-export-pdf-v1#qa))\r\n - `--urlOrigin `: Change the origin of the print url(Option `displayHeaderFooter` of `pdfOptions` is true)\r\n - `--outDir `: Directory of output files\r\n - `--theme `: Set VuePress theme\r\n - `--debug`: Enable debug mode\r\n- `info`: Display environment information\r\n- `--help`: Display help information\r\n- `--version`: Display version information\r\n\r\n## Config file options\r\n\r\nYou can create a new config file, we support the following files:\r\n\r\n- `vuepress-pdf.config.ts`\r\n- `vuepress-pdf.config.js`\r\n- `vuepress-pdf.config.cjs`\r\n- `vuepress-pdf.config.mjs`\r\n- `.vuepress/vuepress-pdf.config.ts`\r\n- `.vuepress/vuepress-pdf.config.js`\r\n- `.vuepress/vuepress-pdf.config.cjs`\r\n- `.vuepress/vuepress-pdf.config.mjs`\r\n\r\nIn addition, you can also customize the configuration file through `--config` or `-c`.\r\n\r\nIt is recommended to use TS(`.vuepress/vuepress-pdf.config.ts`) files, which are easy to manage and have **friendly code prompts**.\r\n\r\nex:\r\n\r\n```ts\r\n// .vuepress/vuepress-pdf.config.ts\r\nimport { defineUserConfig } from '@condorhero/vuepress-plugin-export-pdf'\r\n\r\nexport default defineUserConfig({\r\n theme: '@vuepress/theme-default',\r\n})\r\n```\r\nif you want to use JS files, **you can leverage your IDE's intellisense with jsdoc type hints**:\r\n\r\n```js\r\n/**\r\n * @type {import('@condorhero/vuepress-plugin-export-pdf').UserConfig}\r\n */\r\nconst config = {\r\n // ...\r\n}\r\n\r\nexport default config\r\n```\r\n\r\nconfig options:\r\n\r\n- `theme` - theme name (default `@vuepress/default`)\r\n- `sorter` - function for changing pages order (default `undefined`)\r\n- `outFile` - name of output file (default `vuepress-YYMMDD-HHmmss.pdf`)\r\n- `outDir` - Directory of output files (default `package.json` file exists in directory)\r\n- `routePatterns` - Specify the patterns of files you want to be exported. The patterns are relative to the source directory (default `[\"/**\", \"!/404.html\"]`).Patterns to match Route path using [multimatch](https://github.com/sindresorhus/multimatch)\r\n- `puppeteerLaunchOptions` - [Puppeteer launch options object](https://github.com/puppeteer/puppeteer/blob/main/docs/api/puppeteer.puppeteerlaunchoptions.md)\r\n- `pdfOptions` - [Valid options to configure PDF generation via Page.pdf()](https://github.com/puppeteer/puppeteer/blob/main/docs/api/puppeteer.pdfoptions.md) (default `{ format: 'A4 }`), **`pageNumber` and `totalPages` of `headerTemplate` and `footerTemplate` cannot be used because of [this reason](https://github.com/condorheroblog/vitepress-export-pdf/issues/5)**\r\n- `pdfOutlines` - Keep PDF outlines/bookmarks(default `true`)\r\n- `urlOrigin`: Change the origin of the print url(Option `displayHeaderFooter` of `pdfOptions` is true) - ([How do I change the URL point to the localhost](https://github.com/condorheroblog/vuepress-plugin-export-pdf/issues/5))\r\n- `outlineContainerSelector`: Specify an outline container selector.\r\n\r\n## Use via VuePress plugin\r\n\r\n`@condorhero/vuepress-plugin-export-pdf` exports a function called vuepressplugin, then use this function through VuePress plugin system.\r\n\r\nfor example:\r\n\r\n```js\r\nmodule.exports = {\r\n plugins: [\r\n require('./my-plugin.js'),\r\n ],\r\n}\r\n```\r\n\r\n`my-plugin.js`:\r\n\r\n```js\r\nconst { vuePressPlugin } = require('@condorhero/vuepress-plugin-export-pdf')\r\nmodule.exports = vuePressPlugin\r\n```\r\n\r\n## Examples\r\n\r\nA usable example of quick start [click here](./example/vue-press/).\r\n\r\n### Order of PDF\r\n\r\n`console.log` all the routes in the sort function and assign them to the variable `routeOrder` as a value. You can adjust the order of printing in the array `routeOrder`.\r\n\r\n```ts\r\nimport { defineUserConfig } from 'vitepress-export-pdf'\r\nconst routeOrder = [\r\n '/index.html',\r\n '/guide/what-is-vitepress.html',\r\n '/guide/getting-started.html',\r\n '/guide/configuration.html',\r\n // ...\r\n]\r\nexport default defineUserConfig({\r\n sorter: (pageA, pageB) => {\r\n const aIndex = routeOrder.findIndex(route => route === pageA.path)\r\n const bIndex = routeOrder.findIndex(route => route === pageB.path)\r\n return aIndex - bIndex\r\n },\r\n})\r\n```\r\n\r\n### Discard your outlines/bookmarks\r\n\r\n`.vuepress/vuepress-pdf.config.ts` add `pdfOutlines`:\r\n\r\n```ts\r\nexport default defineUserConfig({\r\n pdfOutlines: false,\r\n})\r\n```\r\n\r\n### Don't export homepage\r\n\r\n`.vuepress/vuepress-pdf.config.ts` add `routePatterns`:\r\n\r\n```ts\r\nexport default defineUserConfig({\r\n routePatterns: ['!/'],\r\n})\r\n```\r\n\r\n> Note: `!` at the beginning of a pattern will negate the match\r\n\r\n### PDF print style\r\n\r\nBy default, `A4` paper is used for printing, The size of A4 paper is (8.27in x 11.7in), One inch is equal to ninety-six pixels: `1 in = 96 pixel (X)` ,the inch unit of A4 is converted to (793.92px x 1123.2px).\r\n\r\nThe layout of VuePress itself is responsive, which should meet your needs. If you change the size of the printing paper or don't want some styles on the website to be input into PDF, you need to simply write some CSS styles.\r\n\r\nIt is recommended that you change it in the [global style](https://vuepress.vuejs.org/guide/directory-structure.html#default-page-routing) of VuePress(`docs/.vuepress/styles/index.styl`), use the `print` of `@media` to control CSS style.\r\n\r\nfor example:\r\n\r\n```styl\r\n@media print {\r\n .navbar,\r\n .sidebar,\r\n .sidebar-mask,\r\n .page-edit,\r\n .page-nav {\r\n display: none;\r\n }\r\n}\r\n```\r\n\r\n\r\n\r\n## Contributing\r\n\r\n1. Fork it!\r\n2. Create your feature branch: git checkout -b my-new-feature\r\n3. Commit your changes: git commit -am 'Add some feature'\r\n4. Push to the branch: git push origin my-new-feature\r\n5. Submit a pull request :D\r\n\r\n## Report Bug\r\n\r\nrun `vuepress info` or `press-export-pdf info` Shows debugging information about the local environment.\r\n\r\n## License\r\n\r\n[MIT](https://github.com/condorheroblog/vuepress-plugin-export-pdf/blob/main/LICENSE)\r\n","readmeFilename":"README.md"}
![\"NPM](\"https://img.shields.io/npm/v/@condorhero/vuepress-plugin-export-pdf.svg?color=a1b858\")
\r\n \r\n \r\n ![\"NPM](\"https://img.shields.io/npm/dm/@condorhero/vuepress-plugin-export-pdf.svg?color=50a36f\")
\r\n \r\n \r\n ![\"GitHub](\"https://img.shields.io/github/stars/condorheroblog/vuepress-plugin-export-pdf?style=social\")
\r\n \r\n