{"action":"opened","issue":{"url":"https://api.github.com/repos/dita-ot/dita-ot/issues/2349","repository_url":"https://api.github.com/repos/dita-ot/dita-ot","labels_url":"https://api.github.com/repos/dita-ot/dita-ot/issues/2349/labels{/name}","comments_url":"https://api.github.com/repos/dita-ot/dita-ot/issues/2349/comments","events_url":"https://api.github.com/repos/dita-ot/dita-ot/issues/2349/events","html_url":"https://github.com/dita-ot/dita-ot/issues/2349","id":154548064,"number":2349,"title":"PDF: Support additional definition list rendering options","user":{"login":"infotexture","id":129995,"avatar_url":"https://avatars.githubusercontent.com/u/129995?v=3","gravatar_id":"","url":"https://api.github.com/users/infotexture","html_url":"https://github.com/infotexture","followers_url":"https://api.github.com/users/infotexture/followers","following_url":"https://api.github.com/users/infotexture/following{/other_user}","gists_url":"https://api.github.com/users/infotexture/gists{/gist_id}","starred_url":"https://api.github.com/users/infotexture/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/infotexture/subscriptions","organizations_url":"https://api.github.com/users/infotexture/orgs","repos_url":"https://api.github.com/users/infotexture/repos","events_url":"https://api.github.com/users/infotexture/events{/privacy}","received_events_url":"https://api.github.com/users/infotexture/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":0,"created_at":"2016-05-12T18:19:13Z","updated_at":"2016-05-12T18:19:13Z","closed_at":null,"body":"The default definition list output differs significantly between HTML & PDF output, which often confuses new users. \r\n\r\n* In HTML output for `<dl>` & `<parml>`, terms are rendered on one line, with definitions on a line below. \r\n* In PDF output, definition list entries are converted to table rows, with term and definition in columns.\r\n* Parameter list entries render in PDF with an style reminiscent of HTML, with indented definitions.\r\n\r\nWe should consider adding a parameter that would toggle definition list rendering between the default (table) and an indented style as used for `<parml>` or [alternative presentation styles](https://github.com/dita-ot/dita-ot/issues/2198#issuecomment-171953011) such as those provided by the [dita-generator](http://dita-generator.elovirta.com/#p4).\r\n\r\nThis would permit users to configure the rendering style that best matches their needs and allow them to sync presentation between HTML & PDF, or render  `<dl>` & `<parml>` consistently.\r\n\r\nWhile some users [prefer](https://github.com/dita-ot/dita-ot/issues/2198#issuecomment-171953766) the default tabular output to conserve vertical space in simple scenarios where term and definition are both short, this format actually requires **more** space in lists where definitions are significantly longer than their terms.\r\n\r\n\r\n"}}