Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Scala docs should be made print friendly #9541

Closed
scabug opened this issue Oct 30, 2015 · 6 comments · Fixed by scala/scala#8147
Closed

Scala docs should be made print friendly #9541

scabug opened this issue Oct 30, 2015 · 6 comments · Fixed by scala/scala#8147

Comments

@scabug
Copy link

scabug commented Oct 30, 2015

When I try to print scala documentation, the format on the print page does come good. For example I open http://www.scala-lang.org/api/current/index.html#scala.collection.immutable.StringOps and click Ctrl+P it shows me incorrect print preview.

@scabug
Copy link
Author

scabug commented Oct 30, 2015

Imported From: https://issues.scala-lang.org/browse/SI-9541?orig=1
Reporter: Narsi Reddy Nallamilli (Narsi)
Attachments:

  • 1.png (created on Aug 11, 2016 4:48:29 AM UTC, 628120 bytes)
  • 2.png (created on Aug 11, 2016 4:48:29 AM UTC, 342479 bytes)
  • 3.png (created on Aug 11, 2016 4:48:29 AM UTC, 656132 bytes)
  • 4.png (created on Aug 11, 2016 4:50:54 AM UTC, 567169 bytes)

@scabug
Copy link
Author

scabug commented Nov 4, 2015

@SethTisue said:
incorrect in what way? does it depend on what browser you use?

this PDF (which I made using "Print" in Safari) looks OK to me: http://cl.ly/432b2w3j2F1Z/stringops.pdf

@scabug
Copy link
Author

scabug commented Jun 7, 2016

David Allsopp (dallsoppuk) said:
In Firefox 46, the main content is cropped into a small rectangle in the top-right corner - it is barely big enough to even see the page title.

A similar problem occurs in Internet Explorer 11.0 and Chrome 27.0.

@scabug
Copy link
Author

scabug commented Aug 10, 2016

@SethTisue said:
Scaladoc has been overhauled for Scala 2.12. Does the problem still occur in 2.12.0-M5? http://www.scala-lang.org/api/2.12.0-M5/

@scabug
Copy link
Author

scabug commented Aug 11, 2016

Narsi Reddy Nallamilli (Narsi) said:
Basically, I mean the alignment of the content what we see on web page is not retained when we print the web page. Image 1 shows print of java.lang.Object which is clean and it is actually represents the way it is shown on web page. Image 2 is the scala doc 2.12.0-M5. Image 3 represents it's print where we can see the alignment of the content is not alike of that on the web page. The package names on right side of web page Image 3 are actually not required when we print the document, it is creating a 30 page document from simple 3 page web page as shown in Image 4. This is the case for all the browsers.

@scabug
Copy link
Author

scabug commented Aug 11, 2016

@felixmulder said:
[~Narsi] - thanks for reporting this. The problem can be remedied by adding a proper css for printing à la:

<link rel="stylesheet" media="print" href={toRoot + "/resources/print.css"}>

To headers in:

src/scaladoc/tools/nsc/doc/html/page/Entity.scala

I'm sure @SethTisue agrees that we'd love a contribution on this :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging a pull request may close this issue.

4 participants