Re: [O] verbatim =[[link]]= and code ~[[link]]~ render as links

2017-08-08 Thread Kaushal Modi
On Tue, Aug 8, 2017, 1:02 PM Adam Porter  wrote:

>
>
> Well, here's what I've noticed:
>

My observations have been the same. I strongly believe that GitHub needs to
fix their parsing of Org verbatim/code text.

Here's another similar problem with GitHub rendering Org verbatim, in
tables:
https://github.com/kaushalmodi/ox-hugo/blob/master/README.org#formatting

Note the ==monospace== text in the table.

So maybe Wolfram is right here, and the the problems are with the way
> the ...[=description=]] links are rendered in Emacs and on GitHub.
>

Yup. Another reason to believe so is that

[[https://www.example.com][=description=]]

is equivalent to

[`description`](https://www.example.com)

in Markdown, and GitHub renders the Markdown version fine.

Also, below won't be rendered as a link :)

`[description](https://www.example.com)`

> --

Kaushal Modi


Re: [O] verbatim =[[link]]= and code ~[[link]]~ render as links

2017-08-08 Thread Adam Porter
Kaushal Modi  writes:

> Are you referring to:
>
> [[https://www.example.com][=verbatim link descr=]]
>
> ?

Well, here's what I've noticed:

+ [[https://www.example.com][=verbatim link descr=]]
  - Renders in the Emacs buffer as a link, colored as a link rather than
a code block, with visible =description=.
  - Exports to HTML as ..., which looks fine
  - Renders on GitHub as =description=, which is incorrect
  
+ =[[https://www.example.com][verbatim link descr]]=
  - Renders in the Emacs buffer as a link with the same color as other
=code= blocks.
  - Exports to HTML as [[https://www.example.com][verbatim link
descr]], which I guess makes sense.
  - Renders on GitHub as [[https://www.example.com][verbatim link
descr]], which is consistent.

So maybe Wolfram is right here, and the the problems are with the way
the ...[=description=]] links are rendered in Emacs and on GitHub.




Re: [O] verbatim =[[link]]= and code ~[[link]]~ render as links

2017-08-08 Thread Kaushal Modi
On Tue, Aug 8, 2017 at 11:07 AM Adam Porter  wrote:

> Wolfram Volpi  writes:
>
> > org-mode renders links in verbatim and code as links:
> >
> > verbatim: =[[link]]=
> >
> > code: ~[[link]]~
> >
> > They should be rendered as plain text.
>
> Hi Wolfram,
>
> Why do you think they should be rendered as plain text instead of as
> links?  I use verbatim/code-styled links often in documentation, and I
> would not want them to be displayed as plain-text; I want them to be
> rendered as links, because they are.  :)
>

 Are you referring to:

[[https://www.example.com][=verbatim link descr=]]

?

Because I use that all the time to show links to code like .el files.

Regarding Wolfram's suggestion.. it makes sense that if someone wants to
show the Org link representation verbatim, it should be possible.


-- 

Kaushal Modi


Re: [O] verbatim =[[link]]= and code ~[[link]]~ render as links

2017-08-08 Thread Adam Porter
Wolfram Volpi  writes:

> org-mode renders links in verbatim and code as links:
>
> verbatim: =[[link]]=
>
> code: ~[[link]]~
>
> They should be rendered as plain text.

Hi Wolfram,

Why do you think they should be rendered as plain text instead of as
links?  I use verbatim/code-styled links often in documentation, and I
would not want them to be displayed as plain-text; I want them to be
rendered as links, because they are.  :)