Added CommentBlock handling.

Author: Martin Brecht-Precht

composer.json

@@ -24,7 +24,7 @@
   },
   "require": {
     "php": ">=5.3",
-    "markdom/handler-interface": "^1.0.2",
+    "markdom/handler-interface": "^1.0.3",
     "markenwerk/stack-util": "~1.0",
     "markenwerk/string-builder": "~1.0",
     "markenwerk/json-pretty-printer": "~1.0"

src/Handler/PhpObjectHandler.php

@@ -90,6 +90,19 @@ public function onCodeBlock($code, $hint = null)
 		);
 	}
 
+	/**
+	 * @param string $comment
+	 * @return void
+	 */
+	public function onCommentBlock($comment)
+	{
+		$parent = $this->blockParents->get();
+		$parent->blocks[] = (object)array(
+			KeyNameTranslator::ATTRIBUTE_COMMON_TYPE => KeyNameTranslator::TYPE_COMMENT,
+			KeyNameTranslator::ATTRIBUTE_COMMENT_COMMENT => $comment,
+		);
+	}
+
 	/**
 	 * @return void
 	 */

src/Handler/TypeNameTranslator/KeyNameTranslator.php

@@ -12,6 +12,7 @@ final class KeyNameTranslator
 
 	const TYPE_DOCUMENT = 'Document';
 	const TYPE_CODE = 'Code';
+	const TYPE_COMMENT = 'Comment';
 	const TYPE_DIVISION = 'Division';
 	const TYPE_HEADING = 'Heading';
 	const TYPE_UNORDERED_LIST = 'UnorderedList';
@@ -35,6 +36,7 @@ final class KeyNameTranslator
 	const ATTRIBUTE_DOCUMENT_VERSION_MINOR = 'minor';
 	const ATTRIBUTE_CODE_CODE = 'code';
 	const ATTRIBUTE_CODE_HINT = 'hint';
+	const ATTRIBUTE_COMMENT_COMMENT = 'comment';
 	const ATTRIBUTE_HEADING_LEVEL = 'level';
 	const ATTRIBUTE_ORDERED_LIST_START_INDEX = 'startIndex';
 	const ATTRIBUTE_IMAGE_URI = 'uri';

src/Handler/XmlHandler.php

@@ -123,6 +123,21 @@ public function onCodeBlock($code, $hint = null)
 		$parent->appendChild($codeNode);
 	}
 
+	/**
+	 * @param string $comment
+	 * @return void
+	 */
+	public function onCommentBlock($comment)
+	{
+		$commentNode = $this->document->createElement(KeyNameTranslator::TYPE_COMMENT);
+		if (!empty($comment)) {
+			$commentNode->appendChild($this->createTextNode($comment));
+		}
+		/** @var \DOMElement $parent */
+		$parent = $this->blockParents->get();
+		$parent->appendChild($commentNode);
+	}
+
 	/**
 	 * @return void
 	 */