Add support enum links (#188)

Author: SakiTakamachi

phpdotnet/phd/Index.php

@@ -454,7 +454,7 @@ public function setMembership($membership) {
     public function format_reference($open, $name, $attrs, $props) {
         if (isset($attrs[Reader::XMLNS_DOCBOOK]['role'])) {
             $name = match ($attrs[Reader::XMLNS_DOCBOOK]['role']) {
-                "class" => "phpdoc:classref",
+                "class", "enum" => "phpdoc:classref",
                 "exception" => "phpdoc:exceptionref",
                 default => $name,
             };

phpdotnet/phd/Package/PHP/XHTML.php

@@ -118,6 +118,13 @@ abstract class Package_PHP_XHTML extends Package_Generic_XHTML {
                 'classsynopsis' => 'format_classsynopsis_oo_name_text',
             ]
         ],
+        'enumname' => [
+            /* DEFAULT */ 'format_classname_text',
+            'ooenum' => [
+                /* DEFAULT */     'format_classname_text',
+                'classsynopsis' => 'format_classsynopsis_oo_name_text',
+            ]
+        ],
         'methodname'            => array(
             /* DEFAULT */          'format_function_text',
             'constructorsynopsis' => array(
@@ -708,6 +715,10 @@ public function format_type_text($type, $tagname) {
         default:
             /* Check if its a classname. */
             $href = Format::getFilename("class.$t");
+            if (!$href) {
+                /* Check if its an enumname. */
+                $href = Format::getFilename("enum.$t");
+            }
         }
 
         if ($href === false) {

tests/package/php/data/enum_link_rendering.xml

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="utf-8"?>
+<chapter xml:id="enum_link_rendering" xmlns="http://docbook.org/ns/docbook">
+
+ <section>
+  <para>1. Existing Enum linking</para>
+  <enumname>Enum\Namespace\Existing_Enum</enumname>
+  <enumname>\Enum\Namespace\Existing_Enum</enumname>
+ </section>
+
+ <section>
+  <para>2. Enum linking (non-FQN) in method/function parameter and return type</para>
+  <methodsynopsis>
+   <type>Enum\Namespace\Existing_Enum</type><methodname>method_name</methodname>
+   <methodparam><type>Enum\Namespace\Existing_Enum</type><parameter>paramName</parameter></methodparam>
+  </methodsynopsis>
+ </section>
+ 
+ <section>
+  <para>3. Enum linking (FQN) in method/function parameter and return type</para>
+  <methodsynopsis>
+   <type>\Enum\Namespace\Existing_Enum</type><methodname>method_name</methodname>
+   <methodparam><type>\Enum\Namespace\Existing_Enum</type><parameter>paramName</parameter></methodparam>
+  </methodsynopsis>
+ </section>
+
+</chapter>

tests/package/php/enum_link_rendering.phpt

@@ -0,0 +1,54 @@
+--TEST--
+Enum link rendering
+--FILE--
+<?php
+namespace phpdotnet\phd;
+
+require_once __DIR__ . "/../../setup.php";
+
+$config->xmlFile = __DIR__ . "/data/enum_link_rendering.xml";
+
+$format = new TestPHPChunkedXHTML($config, $outputHandler);
+$format->SQLiteIndex(
+    null, // $context,
+    null, // $index,
+    "enum.enum-namespace-existing-enum", // $id,
+    "enumname.enumpage", // $filename,
+    "", // $parent,
+    "", // $sdesc,
+    "", // $ldesc,
+    "phpdoc:classref", // $element,
+    "", // $previous,
+    "", // $next,
+    0, // $chunk
+);
+
+$format->addClassname("enum.enum-namespace-existing-enum", "enum\\namespace\\existing_enum");
+
+$render = new TestRender(new Reader($outputHandler), $config, $format);
+$render->run();
+?>
+--EXPECT--
+Filename: enum_link_rendering.html
+Content:
+<div id="enum_link_rendering" class="chapter">
+
+ <div class="section">
+  <p class="para">1. Existing Enum linking</p>
+  <span class="enumname"><a href="enum.enum-namespace-existing-enum.html" class="enumname">Enum\Namespace\Existing_Enum</a></span>
+  <span class="enumname"><a href="enum.enum-namespace-existing-enum.html" class="enumname">\Enum\Namespace\Existing_Enum</a></span>
+ </div>
+
+ <div class="section">
+  <p class="para">2. Enum linking (non-FQN) in method/function parameter and return type</p>
+  <div class="methodsynopsis dc-description"><span class="methodname"><strong>method_name</strong></span>(<span class="methodparam"><span class="type"><a href="enumname.enumpage.html" class="type Enum\Namespace\Existing_Enum">Enum\Namespace\Existing_Enum</a></span> <code class="parameter">$paramName</code></span>): <span class="type"><a href="enumname.enumpage.html" class="type Enum\Namespace\Existing_Enum">Enum\Namespace\Existing_Enum</a></span></div>
+
+ </div>
+ 
+ <div class="section">
+  <p class="para">3. Enum linking (FQN) in method/function parameter and return type</p>
+  <div class="methodsynopsis dc-description"><span class="methodname"><strong>method_name</strong></span>(<span class="methodparam"><span class="type"><a href="enumname.enumpage.html" class="type Enum\Namespace\Existing_Enum">\Enum\Namespace\Existing_Enum</a></span> <code class="parameter">$paramName</code></span>): <span class="type"><a href="enumname.enumpage.html" class="type Enum\Namespace\Existing_Enum">\Enum\Namespace\Existing_Enum</a></span></div>
+
+ </div>
+
+</div>