pdf doc contains only white pages

[sebastian-sohr]

The pdf doc

dash-docs/pdf-docs/Dash_User_Guide_and_Documentation.pdf

has > 35 MB but contains only white pages.

That's a pity, I'd like to read the content.

I tested it on several systems/viewers.

[ben-sandham]

The pdf doc

dash-docs/pdf-docs/Dash_User_Guide_and_Documentation.pdf

has > 35 MB but contains only white pages.

That's a pity, I'd like to read the content.

I tested it on several systems/viewers.

I am also interested in viewing this content and have tried to troubleshoot without success.

[jdamiba]

Thanks for making us aware of this issue!

In the past, some corporate networks have blocked our website at https://dash.plot.ly. We created this PDF for those community members. We have since resolved these issues by moving to https://dash.plotly.com and we’ve stopped maintaining this PDF documentation.

@sebastian-sohr @benjamin-sandham Can you describe your use case for these docs? Is your network still blocking our docs and do you still need a PDF version?

[sebastian-sohr]

Am 03.07.2020 um 05:02 schrieb Joseph Damiba:

Thanks for making us aware of this issue!

In the past, some corporate networks have blocked our website at https://dash.plot.ly. We created this PDF for those community members. We have since resolved these issues by moving to https://dash.plotly.com and we’ve stopped maintaining this PDF documentation.

@sebastian-sohr https://github.com/sebastian-sohr @benjamin-sandham https://github.com/benjamin-sandham Can you describe your use case for these docs? Is your network still blocking our docs and do you still need a PDF version?

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/plotly/dash-docs/issues/897#issuecomment-653312591, or unsubscribe https://github.com/notifications/unsubscribe-auth/AMW6PKW4NYZDP3LS36ZZC43RZVC3FANCNFSM4N5N6WXA.

No, I am not affected by this network blocking and I can read the online documentation.

I simply use an old fashioned (calibre) ebook library which I like very much and where I'd put the PDF version. It's convenient to have all interesting documents, books, and papers at one place.

But, of cause, if you decide not to maintain the PDF documentation any more, I get along with the online version.

-- Dr. Sebastian Sohr Consileon Business Consultancy GmbH Solution Architect Maximilianstraße 5, 76133 Karlsruhe Mobil.: +49 178 8863045 E-Mail: [email protected] www.consileon.de

[codebraker]

Thanks for making us aware of this issue!

In the past, some corporate networks have blocked our website at https://dash.plot.ly. We created this PDF for those community members. We have since resolved these issues by moving to https://dash.plotly.com and we’ve stopped maintaining this PDF documentation.

@sebastian-sohr @benjamin-sandham Can you describe your use case for these docs? Is your network still blocking our docs and do you still need a PDF version?

Hello, I read through the thread and am a bit disappointed. The whole purpose of having a PDF documentation is to avail better than "help(dcc.Dropdown) in python terminal" while not having access to internet connection. I am connecting to the internet only when possible as I do not have a 24x7 access. That is my use case. Would be glad if there is some workaround possible to beat this.

[alexcjohnson]

@codebraker I don't think we actively chose to get rid of the PDF, we at Plotly just didn't see enough value in maintaining it for our own use cases. But if you're interested in making a PR to help bring this back we'd be happy to review.

That said, as we add more and more to these docs it will undeniably get harder to build the PDF. So another option to make you aware of is it's easy to run the docs locally, just clone the repo and follow the instructions in the README. (hmm, I'm realizing the README isn't clear that they're describing running the docs themselves... we'll have to fix that)

[ziliangok]

it is very sad, the pdf is still blank

[alexcjohnson]

FYI we removed the PDF link from the dash repo readme https://github.com/plotly/dash/pull/1454 - that doesn't mean we don't want to fix the PDF, just reducing confusion until this is resolved.

[nicolaskruchten]

I should add that for offline use, you'll get the best experience by cloning this dash-docs repo and running it locally: it's just a Dash app! :)

[meitetsu3]

I really like to read pdf document through e-ink tablet. Reading document through display/html causes eye fatigue. All the other open source project library I use has pdf document.

[liar666]

Hi,

I should add that for offline use, you'll get the best experience by cloning this dash-docs repo and running it locally: it's just a Dash app! :)

• Using the proposed approach:

  • Installing python => ~10MB downloaded+installed + not simple on Mobile Phone / e-Ink tablets
  • Cloning the repo => 300MB downloaded+DD-usage
  • Installing dependencies (including big ones: NumPy, Pandas, Scikit-Learn,Scikit-Image ...) => ~200MB downloaded+installed + CPU usage & time for compilation
  • a certain amount of time solving dependencies problems, compilation errors (pip install wheel), etc.
    • examples:
      • "error: package directory 'dash_bio_utils_62b871ba5bc34f61a24d8903dec35b22' does not exist" took me alomost 1hour of python/pip guru'ing. Ended-up installing from repository clone...
      • ERROR: Cannot install dash[testing]==1.18.1 and lxml==4.5.0 because these package versions have conflicting dependencies. The conflict is caused by: The user requested lxml==4.5.0 dash[testing] 1.18.1 depends on lxml==4.6.1 took me another... Same occurs with pytest-sugar & pytest-mock & pytest [It's a bug in your requirements.text file, the version number should be relaxed...]. And this is without counting the 20+ versions of dask pip has downloaded to find a suitable version.

• Using a PDF:

  • 25MB
  • Instantaneous opening on hatever device
  • Does not require internet access

So the uses cases are quite different:

• I like to read PDF docs/books in the subway to get a general overview of what a framework I'm discovering is capable of and know in advance where to look at if I have a specific need when I'l be coding.
• I like online documentations as a reference when I coding with this framework.

PS: Now I have a local version of the docs. Unfortunately, since they are full of JS dynamic rendering, I could not manage to dump them as HTML files and provide the latter to calibre for generating the PDF. I only get a single blank page... Exactly the same as when I dumped the website version :{

[liar666]

OK... This is above my computer skills :{ I was even ready to write a script that would simulate surfing on all pages of the docs and generate individual pdf, then merge them, but apparently, even commands using an actual browser like the following only return blank pages :{ : chromium --headless --disable-gpu --run-all-compositor-stages-before-draw --virtual-time-budget=10000 --print-to-pdf 'http://127.0.0.1:8000'

[hobbymarks]

We should update the dash-docs README.md and delete "A PDF version is also available."?