emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* verbatim =[[link]]= and code ~[[link]]~ render as links
       [not found] <1145586952.1831161.1502199551475.ref@mail.yahoo.com>
@ 2017-08-08 13:39 ` Wolfram Volpi
  2017-08-08 15:06   ` Adam Porter
  0 siblings, 1 reply; 6+ messages in thread
From: Wolfram Volpi @ 2017-08-08 13:39 UTC (permalink / raw)
  To: emacs-orgmode@gnu.org

org-mode renders links in verbatim and code as links:


verbatim: =[[link]]=

code:     ~[[link]]~



They should be rendered as plain text.


I am running org-version 9.0.9.


#### System Info :computer:

- OS: gnu/linux

- Emacs: 25.2.1

- Spacemacs: 0.200.9

- Spacemacs branch: master (rev. 8e1af145)

- Graphic display: t

- Distribution: spacemacs

- Editing style: vim

- Completion: ivy

- Layers:

```elisp

(ivy evil-snipe emacs-lisp org spell-checking)

```

- System configuration features: XPM JPEG TIFF GIF PNG RSVG IMAGEMAGICK SOUND DBUS GCONF GSETTINGS NOTIFY ACL LIBSELINUX GNUTLS LIBXML2 FREETYPE M17N_FLT LIBOTF XFT ZLIB TOOLKIT_SCROLL_BARS GTK3 X11 MODULES XWIDGETS



Wolfram Volpi

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: verbatim =[[link]]= and code ~[[link]]~ render as links
  2017-08-08 13:39 ` verbatim =[[link]]= and code ~[[link]]~ render as links Wolfram Volpi
@ 2017-08-08 15:06   ` Adam Porter
  2017-08-08 15:35     ` Kaushal Modi
  0 siblings, 1 reply; 6+ messages in thread
From: Adam Porter @ 2017-08-08 15:06 UTC (permalink / raw)
  To: emacs-orgmode

Wolfram Volpi <wolf_volpi@yahoo.com> 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.  :)

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: verbatim =[[link]]= and code ~[[link]]~ render as links
  2017-08-08 15:06   ` Adam Porter
@ 2017-08-08 15:35     ` Kaushal Modi
  2017-08-08 16:06       ` Adam Porter
  0 siblings, 1 reply; 6+ messages in thread
From: Kaushal Modi @ 2017-08-08 15:35 UTC (permalink / raw)
  To: Adam Porter, emacs-orgmode

[-- Attachment #1: Type: text/plain, Size: 873 bytes --]

On Tue, Aug 8, 2017 at 11:07 AM Adam Porter <adam@alphapapa.net> wrote:

> Wolfram Volpi <wolf_volpi@yahoo.com> 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

[-- Attachment #2: Type: text/html, Size: 1560 bytes --]

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: verbatim =[[link]]= and code ~[[link]]~ render as links
  2017-08-08 15:35     ` Kaushal Modi
@ 2017-08-08 16:06       ` Adam Porter
  2017-08-08 17:27         ` Kaushal Modi
  0 siblings, 1 reply; 6+ messages in thread
From: Adam Porter @ 2017-08-08 16:06 UTC (permalink / raw)
  To: emacs-orgmode

Kaushal Modi <kaushal.modi@gmail.com> 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 <a...><code>...</code></a>, which looks fine
  - Renders on GitHub as <a...>=description=</a>, 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 <code>[[https://www.example.com][verbatim link
    descr]]</code>, which I guess makes sense.
  - Renders on GitHub as <code>[[https://www.example.com][verbatim link
    descr]]</code>, 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.

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: verbatim =[[link]]= and code ~[[link]]~ render as links
  2017-08-08 16:06       ` Adam Porter
@ 2017-08-08 17:27         ` Kaushal Modi
  0 siblings, 0 replies; 6+ messages in thread
From: Kaushal Modi @ 2017-08-08 17:27 UTC (permalink / raw)
  To: Adam Porter, emacs-org list

[-- Attachment #1: Type: text/plain, Size: 882 bytes --]

On Tue, Aug 8, 2017, 1:02 PM Adam Porter <adam@alphapapa.net> 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

[-- Attachment #2: Type: text/html, Size: 2170 bytes --]

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: verbatim =[[link]]= and code ~[[link]]~ render as links
       [not found] <1686732720.791601.1502323347465.ref@mail.yahoo.com>
@ 2017-08-10  0:02 ` Wolfram Volpi
  0 siblings, 0 replies; 6+ messages in thread
From: Wolfram Volpi @ 2017-08-10  0:02 UTC (permalink / raw)
  To: emacs-orgmode@gnu.org

>>Wolfram Volpi <address@hidden> writes:


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


>On Tue, Aug 8, 2017 at 11:07 AM Adam Porter <address@hidden> wrote:
>
>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.  :)

I didn't realize that links inside verbatum are a useful way to refer to source.
Maybe just update the documentation to be in agreement with the behavior:

http://orgmode.org/manual/Emphasis-and-monospace.html

 Wolfram Volpi

^ permalink raw reply	[flat|nested] 6+ messages in thread

end of thread, other threads:[~2017-08-10  0:02 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
     [not found] <1145586952.1831161.1502199551475.ref@mail.yahoo.com>
2017-08-08 13:39 ` verbatim =[[link]]= and code ~[[link]]~ render as links Wolfram Volpi
2017-08-08 15:06   ` Adam Porter
2017-08-08 15:35     ` Kaushal Modi
2017-08-08 16:06       ` Adam Porter
2017-08-08 17:27         ` Kaushal Modi
     [not found] <1686732720.791601.1502323347465.ref@mail.yahoo.com>
2017-08-10  0:02 ` Wolfram Volpi

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).