documentation
documentation copied to clipboard
aurelia
Can't Print Docs
I may be old fashioned, but sometimes I do like to print things (especially "cheat sheets"). However, printing Aurelia documentation in Chrome results in a single page that includes sidebars and scrollbars, and is just a mess (try it, you'll see). Hopefully this can be easily fixed with some print-specific CSS rules. Thanks!
We are considering a solution of generating pdfs or all our articles automatically and making that available as a download.
Could you elaborate on why this is happening?
My concern is whether it happens for generic Aureila pages, or if it is something peculiar to "the Hub".
still no print stylesheet in docs.. but source of documents is open. can always go to github and find relevant .md..
I'm going to keep this open here and use it to track the documentation tech. I'm betting we could do some sort of PDF generation from the Markdown as part of the content build and just upload that and provide a link.
@EisenbergEffect hmmm.. seems like a solution for sales managers... not developers (-: and additional hurdle to jump through.
Believe it or not, PDF versions of docs were one of the most highly requested features of Microsoft documentation as well. There was a a pretty big infrastructure for doing it. In our case, it wouldn't be as complicated to do though I'm not sure it's the most important fix for our docs right now. There are a few other things we should probably do first.
My original request was just too be able to print some of the help pages. My guess is that fixing the CSS for printing would be easier than creating infrastructure for exporting to PDF.
Also Chrome has built-in support for "printing" to PDF, and there are PDF print drivers that can be used by any other browser (or any application that can print) to export to PDF. So, if you wanted a PDF of all the documentation (and the CSS is fixed), you could have a special all-in-one web page and "print" that to PDF.
That is maybe not as ideal as carefully crafted PDF support, but could work quite well with adequate CSS tweaks.
Also, I think it is more intuitive to be looking at some important help topic and then command the browser to print, rather than having to look for a PDF link.