srevinsaju / docusaurus-pdf Goto Github PK

This is a PDF generator from docusaurus document.

• This plugin is not intended to be used during build process. But you can run it as a post build script. See the instructions below.

This is generated PDF of official docusaurus website: https://drive.google.com/file/d/19P3qSwLLUHYigrxH3QXIMXmRpTFi4pKB/view

npx docusaurus-pdf <initialDocsUrl> [filename]

For example

npx docusaurus-pdf http://localhost:3000/myBaseUrl/docs/doc1 hoge.pdf

*NOTE!

• initialDocsUrl is required. You can spin up your dev-webserver of docusaurus with yarn start or use an already hosted page.
• filename is optional (default is docusaurus.pdf).

npx docusaurus-pdf from-build [options] <dirPath> <firstDocPagePath> [baseUrl]

For example

npx docusaurus-pdf from-build build/ docs/doc1 /myBaseUrl/

You can also try to automatically load the firstDocPagePath and baseUrl from docusaurus.config.js:

npx docusaurus-pdf from-build-config

• Mandatory: dirPath which points to the build directory created with docusaurus build.
• Mandatory: firstDocPagePath is the URL path segment (without baseUrl) of your first docs page you whish to have included in the PDF.
• Optional: If you have a baseUrl configured in your docusaurus.config.js then pass this value as baseUrl.
• Note: There is a optional parameter to set a custom filename. You can see further details using npx docusaurus-pdf from-build --help.

All dependencies needed to create a PDF from your docusaurus site are bundled in our Dockerfile.

docker run --rm -it -v /someDir/my-docusaurus:/workspace maxys/docusaurus-pdf:latest from-build --no-sandbox -o /workspace/build/docs.pdf /workspace/build docs/doc1 myBaseUrl

You can create the image locally without pulling maxys/docusaurus-pdf:latest from the Docker Hub with:

docker build -t "docusaurus-pdf" .

1. Move generated pdf file to static/img folder.
2. <a> tag with target="_blank"

<a href={useBaseUrl('img/docusaurus.pdf')} target="_blank">
  Download PDF
</a>

1. If this plugin cannot find next page link, PDF generation will stop.

2. Dark theme PDF cannot be generated correctly now.