php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login

go to bug id or search bugs for

Request #74718 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: No CVE-ID: None
View Developer Edit
Welcome back! If you're the original bug submitter, here's where you can edit the bug or add additional notes.
If you forgot your password, you can retrieve your password here.
Password:
Status:
Package:
Bug Type:
Summary:
From: new dot new dot none at gmail dot com
New email:
PHP Version: OS:

 

 [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

AllCommentsChangesGit/SVN commitsRelated reports
 [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 Copyright © 2001-2024 The PHP Group
All rights reserved. 		Last updated: Thu Nov 21 20:01:29 2024 UTC