search

FusionAuth / fusionauth-site

Website and documentation for FusionAuth
https://fusionauth.io
Other
48 stars 46 forks source link

Build documentation to pdf instead of web? #619

Open dhait opened 3 years ago

dhait commented 3 years ago

Is there a way, or a simple modification, that can generate the docs as a PDF file rather than web pages? I believe asciidoctor should support this, no?

mooreds commented 3 years ago

@dhait I've investigated this briefly. https://github.com/asciidoctor/jekyll-asciidoc/issues/171 seems to be related, as that project is what we use to build the doc html.

So we'd have to have a separate script that would run only against the asciidoctor files. I'd like to do this, but unfortunately have other priorities at the moment.

If you have any other ideas or want to take a go at writing such a script, I'd love to make a doc PDF available and would be happy to review a PR or take a look at anything you write or dig up.

robotdan commented 3 years ago

Can you just print a page as PDF from the docs? Or are you looking to export large sections of doc to PDF?

dhait commented 3 years ago

@robotdan The goal would be to have a full (paper) document that we can pass around and work from at leisure. Call me old-fashioned...

robotdan commented 3 years ago

Ha...

Call me old-fashioned...

Nothing wrong with that!