Skip to content

Can <subtitle> not be used? #258

Description

@jb-lopez

I am wanting to update the (as yet unpublished) operator docbook. I was updating the the installation page to include the following:

[...]
  <section>
   <title>PECL</title>
   <subtitle>Deprecated</subtitle>
[...]

When I built the docs locally I got the following warning:

[18:13:24 - E_USER_WARNING        ] /raid/projects/ext/github.com/jb-lopez/phpdoc/phd/phpdotnet/phd/Format/Abstract/XHTML.php:45
        No mapper found for 'subtitle'

And the output is as unformatted text. The MWE I got to both build and produce the warning was this:

<?xml version="1.0" encoding="utf-8"?>
<chapter>
 <title>test</title>
 <subtitle>test</subtitle>
</chapter>

I tried with different parent elements not just chapter, but also section, simplesect, and sect1. It just seems that subtitle it not mapped? I can see it here but I haven't grokked this code so I don't know what is looking at this to know how things map.

I also grep'd through the doc-en and doc-base, and it seems like no one is using the <subtitle> tag. Should I avoid it as well?

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions