Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Can <subtitle> not be used?

オープン
#258 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
3/5
見積もり時間
1〜2日
初心者へのやさしさ
65/100
issue の種類
バグ
明瞭さ
おおむね明確
活発さ
静か
技術スタック
php
領域
documentation

調査の方向性

最小限の章 XML とローカルのドキュメントビルドで警告を再現し、その後 phpdotnet/phd/Format/Abstract/XHTML.php の 45 行目と、187 行目付近の phpdotnet/phd/Package/PEAR/XHTML.php で参照されている字幕マッピングを調べます。結果を doc-en と doc-base の既存の使用例と比較します。字幕の動作が正しくレンダリングされるか、または未対応であることが明確に確認され、文書化されれば完了です。

索引モデルが issue の本文から書いたものです。

説明

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?

主要言語
PHP
スター
91
フォーク
59
PR マージ指標
30日以内にマージされた PR はありません

環境構築

このプロジェクトの環境構築ファイルはまだ確認していません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

php/phd のほかの issue

php/phd の issue をすべて見る

似ている issue

PHP の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。