{"action":"created","issue":{"url":"https://api.github.com/repos/rtomayko/ronn/issues/88","repository_url":"https://api.github.com/repos/rtomayko/ronn","labels_url":"https://api.github.com/repos/rtomayko/ronn/issues/88/labels{/name}","comments_url":"https://api.github.com/repos/rtomayko/ronn/issues/88/comments","events_url":"https://api.github.com/repos/rtomayko/ronn/issues/88/events","html_url":"https://github.com/rtomayko/ronn/issues/88","id":54539208,"node_id":"MDU6SXNzdWU1NDUzOTIwOA==","number":88,"title":"No way to suppress hyphenation / inline URL","user":{"login":"mcclure","id":277318,"node_id":"MDQ6VXNlcjI3NzMxOA==","avatar_url":"https://avatars3.githubusercontent.com/u/277318?v=4","gravatar_id":"","url":"https://api.github.com/users/mcclure","html_url":"https://github.com/mcclure","followers_url":"https://api.github.com/users/mcclure/followers","following_url":"https://api.github.com/users/mcclure/following{/other_user}","gists_url":"https://api.github.com/users/mcclure/gists{/gist_id}","starred_url":"https://api.github.com/users/mcclure/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mcclure/subscriptions","organizations_url":"https://api.github.com/users/mcclure/orgs","repos_url":"https://api.github.com/users/mcclure/repos","events_url":"https://api.github.com/users/mcclure/events{/privacy}","received_events_url":"https://api.github.com/users/mcclure/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":1,"created_at":"2015-01-16T04:40:45Z","updated_at":"2018-12-27T19:07:06Z","closed_at":null,"author_association":"NONE","body":"I am attempting to use ronn for a manpage. It is doing everything I need _EXCEPT_: I need to include a URL in the manpage. The convention in manpages for this is to enter the URL in angle brackets, like http://example.com\n\nIn my current ronn file, it says:\n\n```\nDocumentation of the Emily programming language can be found at <<http://emilylang.org>> or <<http://bitbucket.org/runhello/emily>>.\n```\n\nThe inner <> gets me an underline, and the outer <> gets me enclosing angle brackets. But unfortunately, when I look at my generated .1 file in man, I get:\n\n```\nDocumentation  of  the  Emily  programming  language can be found at <http://emily-\nlang.org> or <http://bitbucket.org/runhello/emily>.\n```\n\nThis is catastrophic, it makes it appear the URL is http://emily-lang.org , which is incorrect.\n\nThe documentation for roff notes that there is a syntax for suppressing hyphenation on something (prefix with %). But it does not appear ronn exposes a way to access this.\n\nIncluding URLs is a common thing for manpages. I would like to suggest ronn do one of the following to support this:\n- Auto-detect URLs within the document and automatically suppress hyphenation for them.\n- Support the standard Markdown URL syntax, when generating HTML turn this into a link, when generating roff turn it into the link text (if different from the URL) followed by the URL itself, underlined and surrounded by angle brackets and suppressing hyphenation.\n- Add a syntax to suppress hyphenation.\n\nIt appears that the man format also has some kind of standard \"extension\" for URLs. I cannot comment on whether it would make sense to leverage that.\n"},"comment":{"url":"https://api.github.com/repos/rtomayko/ronn/issues/comments/450211748","html_url":"https://github.com/rtomayko/ronn/issues/88#issuecomment-450211748","issue_url":"https://api.github.com/repos/rtomayko/ronn/issues/88","id":450211748,"node_id":"MDEyOklzc3VlQ29tbWVudDQ1MDIxMTc0OA==","user":{"login":"mcclure","id":277318,"node_id":"MDQ6VXNlcjI3NzMxOA==","avatar_url":"https://avatars3.githubusercontent.com/u/277318?v=4","gravatar_id":"","url":"https://api.github.com/users/mcclure","html_url":"https://github.com/mcclure","followers_url":"https://api.github.com/users/mcclure/followers","following_url":"https://api.github.com/users/mcclure/following{/other_user}","gists_url":"https://api.github.com/users/mcclure/gists{/gist_id}","starred_url":"https://api.github.com/users/mcclure/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mcclure/subscriptions","organizations_url":"https://api.github.com/users/mcclure/orgs","repos_url":"https://api.github.com/users/mcclure/repos","events_url":"https://api.github.com/users/mcclure/events{/privacy}","received_events_url":"https://api.github.com/users/mcclure/received_events","type":"User","site_admin":false},"created_at":"2018-12-27T19:07:06Z","updated_at":"2018-12-27T19:07:06Z","author_association":"NONE","body":"Hi,\r\nAs my original post was from three years ago I'm not quite sure what I was thinking…\r\nHowever, I do notice\r\n1. The GNU groff manual https://www.gnu.org/software/groff/manual/html_node/Manipulating-Hyphenation.html references a character sequence\r\n\r\n        \\%\r\n\r\n    which it says \"Preceding a word with this character prevents it from being hyphenated\". That is a backslash followed by a percent sign. Maybe either in my previous post I made a mistake or Github ate the backslash in my 2015 post.\r\n\r\n    If I put this in my .1 file and run it through man:\r\n\r\n        .P\r\n        Documentation of the Emily programming language can be found at <\\fIhttp://emilylang\\.org\\fR> or <\\fIhttp://bitbucket\\.org/runhello/emily\\fR>\\.\r\n\r\n    and view in Mac OS X 10.13.2 `man` at 96 columns, I find it hyphenates after emily, but if I insert the `\\%` characters as such:\r\n\r\n        .P\r\n        Documentation of the Emily programming language can be found at \\%<\\fIhttp://emilylang\\.org\\fR> or \\%<\\fIhttp://bitbucket\\.org/runhello/emily\\fR>\\.\r\n\r\n    the hyphen does not appear. I see the same behavior in Ubuntu 14.04.5 LTS `man` (although there I must use 90 columns to see the hyphen).\r\n\r\n    I do not know how to tell if `\\%` is part of standard roff or a GNU extension which OS X has somehow adopted.\r\n\r\n2. That GNU manual also references a `.nh` which can be used to disable hyphenation completely. It appears one could insert this before a URL and then `.hy 1` afterward to restore the default behavior. I do not know if this is more or less standard than `\\%`.\r\n\r\n3. **\"This appears to me to be an issue with the man page formatter used to display the resulting roff files. The hyphenation does not appear in the raw roff output from ronn:\"** While this is technically true, to me the goal of producing a roff file is to distribute it to a user so that the user can feed it into their local `man` executable. Therefore it should be the job of ronn to produce sufficiently standard roff files that we can assume a user's `man` will present it in the expected way. A standard behavior in `man` is to hyphenate, so it is desirable if for URLs ronn can suppress hyphenation in a standard way…"}}
{"actor":{"display_login":"mcclure"}}