Bug #65109 [Asn]: Extraneous empty paragraphs in generated HTML

From: Date: Tue, 03 Nov 2020 18:01:22 +0000
Subject: Bug #65109 [Asn]: Extraneous empty paragraphs in generated HTML
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-18072@lists.php.net to get a copy of this message
Edit report at https://bugs.php.net/bug.php?id=65109&edit=1

 ID:                 65109
 Updated by:         cmb@php.net
 Reported by:        pet dot draexler at gmail dot com
 Summary:            Extraneous empty paragraphs in generated HTML
 Status:             Assigned
 Type:               Bug
 Package:            Doc Build problem
 Operating System:   Windows 7
 PHP Version:        Irrelevant
 Assigned To:        salathe
 Block user comment: N
 Private report:     N

 New Comment:

The problem seems to be that PhD renders <para> as <p>, what is
certainly not quite right.


Previous Comments:
------------------------------------------------------------------------
[2014-03-04 08:54:29] salathe@php.net

Re-opening. Just because it's a PhD issue which might take a while for anyone to look at or
fix, doesn't mean we should close the ticket.

------------------------------------------------------------------------
[2014-03-04 04:30:51] levim@php.net

The PHD changes would be quite substantial and nobody has been up to the task. I'm going to
mark this as closed as it is very unlikely to happen.

------------------------------------------------------------------------
[2013-07-04 11:30:02] dragoonis@php.net

I have fixed this using JS and took out the CSS hack that didn't work and caused  
problematic formatting issues for all types of users.

Now users with JS (most of them) will not experience this layout problem. Users 
without JS will see a little extra spacing but if they don't have JS turned 
on then this isn't their worst problem.

Once PHD is fixed to remove this random empty paragraph tag then this JS can be 
removed.

https://github.com/php/web-php/commit/3042ff3b32f71c4b6b76329c128e56c8de22870e

Thanks,
Paul

------------------------------------------------------------------------
[2013-06-27 18:09:32] levim@php.net

I should have already posted that I know why this is an issue. Unfortunately it 
will most likely require a change in the PhD system. Short-term we can remove the 
style which will cause large spacing issues on the majority of pages but will fix 
the formatting for these cases.

------------------------------------------------------------------------
[2013-06-27 15:15:40] gabri dot ns at gmail dot com

When look into the doc.css,
I see some thing like this

.docs .refentry .parameters .title + p.para + dl,
.docs .refsect1.examples .title + p.para + *,
.docs .refsect1.seealso .title + p.para + * {
    margin-top:-1.5em;
    /* there's a p tag that has whitespace (not :empty).
       This simply covers it up */
}

The comment was explaining that this entry is used
to cover up other element. However, there is p.para
element that actually didn't empty. When i disable
this entry, it fix the problem.

------------------------------------------------------------------------


The remainder of the comments for this report are too long. To view
the rest of the comments, please view the bug report online at

    https://bugs.php.net/bug.php?id=65109


--
Edit this bug report at https://bugs.php.net/bug.php?id=65109&edit=1


Thread (6 messages)

« previous php.doc.bugs (#18072) next »