{"action":"created","issue":{"url":"https://api.github.com/repos/dita-ot/dita-ot/issues/1866","labels_url":"https://api.github.com/repos/dita-ot/dita-ot/issues/1866/labels{/name}","comments_url":"https://api.github.com/repos/dita-ot/dita-ot/issues/1866/comments","events_url":"https://api.github.com/repos/dita-ot/dita-ot/issues/1866/events","html_url":"https://github.com/dita-ot/dita-ot/issues/1866","id":60348687,"number":1866,"title":"Proposed metadata changes in plugin.xml for org.dita.xhtml plugin [DOT 2.0.1]","user":{"login":"raducoravu","id":1005979,"avatar_url":"https://avatars.githubusercontent.com/u/1005979?v=3","gravatar_id":"","url":"https://api.github.com/users/raducoravu","html_url":"https://github.com/raducoravu","followers_url":"https://api.github.com/users/raducoravu/followers","following_url":"https://api.github.com/users/raducoravu/following{/other_user}","gists_url":"https://api.github.com/users/raducoravu/gists{/gist_id}","starred_url":"https://api.github.com/users/raducoravu/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/raducoravu/subscriptions","organizations_url":"https://api.github.com/users/raducoravu/orgs","repos_url":"https://api.github.com/users/raducoravu/repos","events_url":"https://api.github.com/users/raducoravu/events{/privacy}","received_events_url":"https://api.github.com/users/raducoravu/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-03-09T14:14:39Z","updated_at":"2015-03-10T17:13:01Z","closed_at":null,"body":"Both the xhtml and html5 transtypes are defined in the plugin.xml like:\r\n\r\n        <transtype name=\"xhtml html5\" extends=\"base-html\" desc=\"HTML\">\r\n          <param name=\"args.xhtml.contenttarget\" desc=\"Specifies the value of the @target attribute on the &lt;base&gt; element in the TOC file.\" type=\"string\">\r\n            <val default=\"true\">contentwin</val>\r\n          </param>\r\n          <param name=\"args.xhtml.toc\" desc=\"Specifies the base name of the TOC file.\" type=\"string\">\r\n            <val default=\"true\">index</val>\r\n          </param>\r\n          <param name=\"args.xhtml.toc.class\" desc=\"Specifies the value of the @class attribute on the &lt;body&gt; element in the TOC file.\" type=\"string\"/>\r\n        </transtype>\r\n\r\nI don't think it would be a good idea for the name of a transtype to be an enumeration of values.\r\nPlus both transtypes share the same descriptors.\r\nThis could be re-written like:\r\n\r\n          <transtype name=\"common-xhtml-html5\" extends=\"base-html\" abstract=\"true\">\r\n            <param name=\"args.xhtml.contenttarget\" desc=\"Specifies the value of the @target attribute on the &lt;base&gt; element in the TOC file.\" type=\"string\">\r\n              <val default=\"true\">contentwin</val>\r\n            </param>\r\n            <param name=\"args.xhtml.toc\" desc=\"Specifies the base name of the TOC file.\" type=\"string\">\r\n              <val default=\"true\">index</val>\r\n            </param>\r\n            <param name=\"args.xhtml.toc.class\" desc=\"Specifies the value of the @class attribute on the &lt;body&gt; element in the TOC file.\" type=\"string\"/>\r\n          </transtype>\r\n          \r\n          <transtype name=\"xhtml\" extends=\"common-xhtml-html5\" desc=\"XHTML\">\r\n          </transtype>\r\n          \r\n          <transtype name=\"html5\" extends=\"common-xhtml-html5\" desc=\"HTML 5\">\r\n          </transtype>"},"comment":{"url":"https://api.github.com/repos/dita-ot/dita-ot/issues/comments/78100927","html_url":"https://github.com/dita-ot/dita-ot/issues/1866#issuecomment-78100927","issue_url":"https://api.github.com/repos/dita-ot/dita-ot/issues/1866","id":78100927,"user":{"login":"jelovirt","id":52934,"avatar_url":"https://avatars.githubusercontent.com/u/52934?v=3","gravatar_id":"","url":"https://api.github.com/users/jelovirt","html_url":"https://github.com/jelovirt","followers_url":"https://api.github.com/users/jelovirt/followers","following_url":"https://api.github.com/users/jelovirt/following{/other_user}","gists_url":"https://api.github.com/users/jelovirt/gists{/gist_id}","starred_url":"https://api.github.com/users/jelovirt/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jelovirt/subscriptions","organizations_url":"https://api.github.com/users/jelovirt/orgs","repos_url":"https://api.github.com/users/jelovirt/repos","events_url":"https://api.github.com/users/jelovirt/events{/privacy}","received_events_url":"https://api.github.com/users/jelovirt/received_events","type":"User","site_admin":false},"created_at":"2015-03-10T17:13:01Z","updated_at":"2015-03-10T17:13:01Z","body":"The current documentation generation generates documentation for abstract trantypes, like http://www.dita-ot.org/2.1/readme/ant-parameters-common-html-transtypes.html (OK, it really doesn't generate them yet, but it will.) If we add common-xhtml-html5, we'd need to make sure we don't redundantly generate page for it. Have to think about this, it may be a better way than the current one."}}