PHP :: Request #74718 :: Offline documentation lacks CSS

Offline documentation lacks CSS

Submitted:

2017-06-08 20:50 UTC

Modified:

2017-06-09 14:37 UTC

Votes:	2
Avg. Score:	4.0 ± 1.0
Reproduced:	2 of 2 (100.0%)
Same Version:	1 (50.0%)
Same OS:	1 (50.0%)

From:

new dot new dot none at gmail dot com

Assigned:

Status:

Open

Package:

Documentation problem

PHP Version:

Irrelevant

OS:

Debain stretch/sid

Private report:

CVE-ID:

None

[2017-06-08 20:50 UTC] new dot new dot none at gmail dot com

Description:
------------
I was writing some PHP code until I decided to consult the offline doc on my PC at /usr/share/doc/php-doc to spare some of my internet connection. As soon as I opened the index, however, I lost enthusiasm in the idea of reading the offline doc. The page, indeed, lacks any kind of style facilitating the reading or formatting the information displayed. Even though it is certainly still readable, I would much prefer to include a style to it to make every page of the doc appear like the online version.

I tried downloading some CSS stylesheets from the online doc, but obviously the HTML files don't include any reference to CSS files. I also downloaded the offline doc at http://php.net/download-docs.php, but as it was to be expected, when I opened it, the index.html page looked exactly the same as the one located at /usr/share/doc/php-doc, and so I deleted the extracted archive.

Is adding some CSS to the offline documentation something that can be done? I am not an expert Web developer, and since I'm writing this "bug" report hastily I ignore any technical obstacle which makes difficult linking some online-like CSS stylesheet to the HTML files (although I doubt there are such problems, honestly).

This may not exactly be a documentation bug, but I knew of no other place where to submit this request (apart sending an e-mail) and so I chose this section of this site.

Patches

Pull Requests

History

[2017-06-08 22:55 UTC] requinix@php.net

-Status: Open +Status: Feedback

[2017-06-08 22:55 UTC] requinix@php.net

Both HTML formats look fine to me on Windows. Can you upload a screenshot somewhere?

Or are you saying that you want essentially a mirror of the online site?

[2017-06-09 14:15 UTC] new dot new dot none at gmail dot com

> Or are you saying that you want essentially a mirror of the online site?
I expected the pages to have the same style (that is, appearance) of the on-line version, and if it is possible it would be nice to make them display this way. Unless, certainly, something is not working properly on my PC (I doubt this, too).

Give a look at here for some screenshots: http://imgur.com/a/e8rNI .

[2017-06-09 14:37 UTC] requinix@php.net

-Status: Feedback +Status: Open -Type: Documentation Problem +Type: Feature/Change Request

[2017-06-09 14:37 UTC] requinix@php.net

No, you're seeing it as intended.

The offline docs are not a clone of the website. They're documentation. The point is not the pretty colors and nice images and fancy formatting.
I don't know how much work it would take to package up the CSS and fonts and other resources into the download builds, and I'm leave this open in case someone wants to do it, but frankly I don't think it's worth the effort.

Or maybe you want a mirror? https://secure.php.net/mirroring.php

	php.net \| support \| documentation \| report a bug \| advanced search \| search howto \| statistics \| random bug \| login
go to bug id or search bugs for


Copyright © 2001-2024 The PHP Group All rights reserved.	Last updated: Fri Apr 26 20:01:29 2024 UTC