php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #66316 HTML is malformed
Submitted: 2013-12-18 12:04 UTC Modified: 2014-01-01 19:29 UTC
From: ivan dot enderlin at hoa-project dot net Assigned: salathe (profile)
Status: Closed Package: Doc Build problem
PHP Version: Irrelevant OS:
Private report: No CVE-ID: None
 [2013-12-18 12:04 UTC] ivan dot enderlin at hoa-project dot net
Description:
------------
The HTML markup is not well-formed. For example, on the page http://http://php.net/reserved.constants#constant.php-version-id, in the list of constants, we open a `dt`, we open a `dd`, we close a `dd`, and we close the `dt`. The `dt` closing tags are not in the right place, they should be place before the `dd` opening tag.

Expected result:
----------------
  <dt id="constant.php-version-id">
   <span class="term">
    <strong><code>PHP_VERSION_ID</code></strong>
    (<a href="language.types.integer.php" class="link">entier</a>)
   </span>
  </dt>

  <dd>
   <span class="simpara">
    La version courante de PHP sous la forme d&#039;un
    entier, utile pour la comparaison de versions
    (i.e., int(50207) depuis la version &quot;5.2.7-extra&quot;).
    Disponible depuis PHP 5.2.7.
   </span>
  </dd>

Actual result:
--------------
  <dt id="constant.php-version-id">
   <span class="term">
    <strong><code>PHP_VERSION_ID</code></strong>
    (<a href="language.types.integer.php" class="link">entier</a>)
   </span>
   <dd>

    <span class="simpara">
     La version courante de PHP sous la forme d&#039;un
     entier, utile pour la comparaison de versions
     (i.e., int(50207) depuis la version &quot;5.2.7-extra&quot;).
     Disponible depuis PHP 5.2.7.
    </span>
   </dd>

  </dt>

Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2013-12-29 12:03 UTC] salathe@php.net
-Summary: HTML is malformed (dt, dd, +Summary: HTML is malformed -Package: Documentation problem +Package: Doc Build problem
 [2013-12-29 12:03 UTC] salathe@php.net
The cited example (dd within dt) should be a small, simple fix in phd.

However, there is a wider problem of "malformed" HTML markup being generated; for example we wrap many, many block-level elements in <p> tags because we use lots of <para> in DocBook.  An example of this is surrounding the <dl> cited in the bug report.
 [2014-01-01 19:15 UTC] bjori@php.net
-Status: Open +Status: Closed -Assigned To: +Assigned To: salathe
 [2014-01-01 19:15 UTC] bjori@php.net
The fix for this bug has been committed. Since the websites are not directly
updated from the repository, the fix might need some time to spread
across the globe to all mirror sites, including PHP.net itself.

Thank you for the report, and for helping us make PHP.net better.


 [2014-01-01 19:29 UTC] bjori@php.net
Fixing <p> wrapping other block level tags would have to be a structural change to PhD. Not something that is going to happen any time soon considering development of PhD has been very minimal in the past 18 months :)
 
PHP Copyright © 2001-2024 The PHP Group
All rights reserved.
Last updated: Wed Oct 16 08:01:27 2024 UTC