{"action":"created","issue":{"url":"https://api.github.com/repos/dlang/dlang.org/issues/1795","repository_url":"https://api.github.com/repos/dlang/dlang.org","labels_url":"https://api.github.com/repos/dlang/dlang.org/issues/1795/labels{/name}","comments_url":"https://api.github.com/repos/dlang/dlang.org/issues/1795/comments","events_url":"https://api.github.com/repos/dlang/dlang.org/issues/1795/events","html_url":"https://github.com/dlang/dlang.org/pull/1795","id":240467519,"number":1795,"title":"Fix Issue 17594 - Define DDOC_BLANKLINE as an empty HTML paragraph, t…","user":{"login":"andralex","id":566679,"avatar_url":"https://avatars2.githubusercontent.com/u/566679?v=3","gravatar_id":"","url":"https://api.github.com/users/andralex","html_url":"https://github.com/andralex","followers_url":"https://api.github.com/users/andralex/followers","following_url":"https://api.github.com/users/andralex/following{/other_user}","gists_url":"https://api.github.com/users/andralex/gists{/gist_id}","starred_url":"https://api.github.com/users/andralex/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/andralex/subscriptions","organizations_url":"https://api.github.com/users/andralex/orgs","repos_url":"https://api.github.com/users/andralex/repos","events_url":"https://api.github.com/users/andralex/events{/privacy}","received_events_url":"https://api.github.com/users/andralex/received_events","type":"User","site_admin":false},"labels":[{"id":133737021,"url":"https://api.github.com/repos/dlang/dlang.org/labels/Enhancement","name":"Enhancement","color":"0052cc","default":false}],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":2,"created_at":"2017-07-04T16:52:26Z","updated_at":"2017-07-04T17:14:29Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/dlang/dlang.org/pulls/1795","html_url":"https://github.com/dlang/dlang.org/pull/1795","diff_url":"https://github.com/dlang/dlang.org/pull/1795.diff","patch_url":"https://github.com/dlang/dlang.org/pull/1795.patch"},"body":"…hus obviating the need to wrap text in $(P ...)\r\n\r\nThere are two typographical notions related to DDOC_BLANKLINE: \"paragraph separator\" (LaTeX: \\par) and \"vertical space\" (LaTeX: \\vspace). Of these, \"paragraph separator\" is the closest and most useful.\r\n\r\nParagraph separators must enjoy somewhat special treatment: adjacent paragraph separators should be merged together so empty paragraphs do not increase vertical spacing. Even if a paragraph has only whitespace, it should be considered empty and merged along with surrounding separators. LaTeX's \\par is defined as such.\r\n\r\nFortunately, in HTML empty paragraphs designated as `<p></p>` do the same thing:\r\n\r\n* Runs of `<p></p>` and whitespace (either between the tags or between tag pairs) are always merged together so there's no difference in text rendering\r\n* If `<p></p>` is inserted between two paragraphs `<p>... text ...</p>` and `<p>... more text ...</p>`, it produces no additional spacing between paragraphs\r\n* If `<p></p>` is inserted between two blocks of text that are not tagged with `<p>` (e.g. are body-level), a paragraph separator space is inserted.\r\n\r\nThat all means with this PR, we don't need to use `$(P ...)` around text in .dd files.\r\n\r\nThis change will enter in effect after https://github.com/dlang/dmd/pull/5344 is merged."},"comment":{"url":"https://api.github.com/repos/dlang/dlang.org/issues/comments/312921804","html_url":"https://github.com/dlang/dlang.org/pull/1795#issuecomment-312921804","issue_url":"https://api.github.com/repos/dlang/dlang.org/issues/1795","id":312921804,"user":{"login":"aG0aep6G","id":9287500,"avatar_url":"https://avatars2.githubusercontent.com/u/9287500?v=3","gravatar_id":"","url":"https://api.github.com/users/aG0aep6G","html_url":"https://github.com/aG0aep6G","followers_url":"https://api.github.com/users/aG0aep6G/followers","following_url":"https://api.github.com/users/aG0aep6G/following{/other_user}","gists_url":"https://api.github.com/users/aG0aep6G/gists{/gist_id}","starred_url":"https://api.github.com/users/aG0aep6G/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/aG0aep6G/subscriptions","organizations_url":"https://api.github.com/users/aG0aep6G/orgs","repos_url":"https://api.github.com/users/aG0aep6G/repos","events_url":"https://api.github.com/users/aG0aep6G/events{/privacy}","received_events_url":"https://api.github.com/users/aG0aep6G/received_events","type":"User","site_admin":false},"created_at":"2017-07-04T17:14:29Z","updated_at":"2017-07-04T17:14:29Z","body":"We already have something similar in std.ddoc: `DDOC_BLANKLINE = $(DIVC blankline)$(LF)`.\r\n\r\nI suggest moving that to dlang.org.ddoc if the behavior is desired for the whole site. I'd prefer the `div` because it doesn't make a statement about its content, so it's less of a violation of [semantic HTML](https://en.wikipedia.org/wiki/Semantic_HTML)."}}
{"actor":{"display_login":"aG0aep6G"}}