Skip to content

yunnysunny/vuepress-plugin-pdf-export

 
 

Repository files navigation

@whyun/vuepress-plugin-pdf-export

Vuepress plugin for exporting site as PDF. Forkend form @snowdog/vuepress-plugin-pdf-export.

Features

  • Exports whole Vuepress based page as a single PDF file
  • Applies styles to hide UI elements like navigation or sidebar
  • Doesn't require other runtimes like Java to operate
  • Designed to work well in headless environments like CI runners

Config options

  • theme - theme name (default @vuepress/default)
  • filter - function for filter pages (default false)
  • sorter - function for changing pages order (default false)
  • outputFileName - name of output file (default site.pdf)
  • puppeteerLaunchOptions - Puppeteer launch options object (default {})
  • pageOptions - Puppeteer page formatting options object (default {format: 'A4'})

Usage

Using this plugin:

// in .vuepress/config.js
module.exports = {
  plugins: ['@snowdog/vuepress-plugin-pdf-export']
}

Then run:

vuepress export [path/to/your/docs]

Tips

To run this plugin on Gitlab CI you may want to run Chrome with no-sandbox flag. Details

module.exports = {
  plugins: [
    ['@snowdog/vuepress-plugin-pdf-export', {
      puppeteerLaunchOptions: {
        args: ['--no-sandbox', '--disable-setuid-sandbox']
      }
    }]
  ]
}

About

Vuepress plugin for exporting as PDF without system wide dependencies suitable for headless environments

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 97.1%
  • Stylus 2.9%