Add step to generate PDF artefact

[riteshakya037]

Changes

• Add docusaurus-prince-pdf to generate PDF artefacts
• Updated github workflow to include PDF generation step
• Remove package-lock.json as we are using yarn
• Update README to include PDF generation steps.

Sample output

rubix-ce.pdf

Additional Notes

• Workflow changes need testing.

[riteshakya037]

@RaiBnod Please reference this success report.

[riteshakya037]

Marking this as a Draft because the Prince library used here may require a commercial license.

More details here

[riteshakya037]

docusaurus-prince-pdf vs. docs-to-pdf

Prince creates visually appealing documents with excellent page navigation. However, it places a watermark on the first page of the generated PDF, which can be problematic. The high cost of the commercial license, at $3,800, is also a significant drawback.

On the other hand, docs-to-pdf is a free and open-source solution that integrates well with Docusaurus sites. However, docs-to-pdf struggles with rendering some components correctly, resulting in unusual shadows in places. Moreover, text in PDFs generated by docs-to-pdf cannot be copied or searched accurately because it's a Puppeteer-based build, and cross-links within the documentation also do not function properly.

I've attached a copy of the generated PDF by docs-to-pdf for your reference here.