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
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions