emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* No-description <<target>> links
@ 2023-10-21 11:22 Rudolf Adamkovič
  2023-10-22  8:28 ` Ihor Radchenko
  0 siblings, 1 reply; 6+ messages in thread
From: Rudolf Adamkovič @ 2023-10-21 11:22 UTC (permalink / raw)
  To: emacs-orgmode

Hello there!

Consider the sentence

  "This is a [[link]]."

in a document with a "<<link>>" target.

Org exports the sentence to HTML as

  "This is a No description for this link."

and to PDF as

  "This is a ."

How about we export it as

  "This is a link."

where the word "link" is the actual link?

WDYT?

Rudy
-- 
"Simplicity is complexity resolved."
-- Constantin Brâncuși, 1876-1957

Rudolf Adamkovič <salutis@me.com> [he/him]
Studenohorská 25
84103 Bratislava
Slovakia


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

* Re: No-description <<target>> links
  2023-10-21 11:22 No-description <<target>> links Rudolf Adamkovič
@ 2023-10-22  8:28 ` Ihor Radchenko
  2023-10-22 21:01   ` Rudolf Adamkovič
  0 siblings, 1 reply; 6+ messages in thread
From: Ihor Radchenko @ 2023-10-22  8:28 UTC (permalink / raw)
  To: Rudolf Adamkovič; +Cc: emacs-orgmode

Rudolf Adamkovič <salutis@me.com> writes:

> Consider the sentence
>
>   "This is a [[link]]."
>
> in a document with a "<<link>>" target.
>
> Org exports the sentence to HTML as
>
>   "This is a No description for this link."
>
> and to PDF as
>
>   "This is a ."

Confirmed.

> How about we export it as
>
>   "This is a link."
>
> where the word "link" is the actual link?
>
> WDYT?

I think that we may need to introduce a customization for default link
description. Some backends hard-code the default description to
something non-trivial and some just use arbitrary fallback like ???
(ox-ascii), "No description" (ox-html), or "" (ox-latex).

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>


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

* Re: No-description <<target>> links
  2023-10-22  8:28 ` Ihor Radchenko
@ 2023-10-22 21:01   ` Rudolf Adamkovič
  2023-10-23  8:15     ` Ihor Radchenko
  0 siblings, 1 reply; 6+ messages in thread
From: Rudolf Adamkovič @ 2023-10-22 21:01 UTC (permalink / raw)
  To: Ihor Radchenko; +Cc: emacs-orgmode

Ihor Radchenko <yantar92@posteo.net> writes:

> I think that we may need to introduce a customization for default link
> description. Some backends hard-code the default description to
> something non-trivial and some just use arbitrary fallback like ???
> (ox-ascii), "No description" (ox-html), or "" (ox-latex).

I wonder, why not export [[link]] to <<link>> as "link" by default, if
no description is given, as is the case with URLs, Elisp, and the like?
And if that is not desirable, would the new customization allow for
doing that?

I am asking the second question because I am still hoping to solve my
problem with the impracticality of [[Literal link][literal link]]s in
densely linked text, as explained in my other thread.  If Org could
export [[link]] to <<link>> as "link", and offered a STARTUP for literal
links, then that would fix my problem for good.

Thank you!

Rudy
-- 
"Simplicity is complexity resolved."
-- Constantin Brâncuși, 1876-1957

Rudolf Adamkovič <salutis@me.com> [he/him]
Studenohorská 25
84103 Bratislava
Slovakia


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

* Re: No-description <<target>> links
  2023-10-22 21:01   ` Rudolf Adamkovič
@ 2023-10-23  8:15     ` Ihor Radchenko
  2023-10-24  8:15       ` Max Nikulin
  0 siblings, 1 reply; 6+ messages in thread
From: Ihor Radchenko @ 2023-10-23  8:15 UTC (permalink / raw)
  To: Rudolf Adamkovič; +Cc: emacs-orgmode

Rudolf Adamkovič <salutis@me.com> writes:

> Ihor Radchenko <yantar92@posteo.net> writes:
>
>> I think that we may need to introduce a customization for default link
>> description. Some backends hard-code the default description to
>> something non-trivial and some just use arbitrary fallback like ???
>> (ox-ascii), "No description" (ox-html), or "" (ox-latex).
>
> I wonder, why not export [[link]] to <<link>> as "link" by default, if
> no description is given, as is the case with URLs, Elisp, and the
> like?

Yes, something like that.

The main problem is how to properly design
this - the current approach is that individual backends decide. And we
have no control over third-party backends...

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>


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

* Re: No-description <<target>> links
  2023-10-23  8:15     ` Ihor Radchenko
@ 2023-10-24  8:15       ` Max Nikulin
  2023-10-24  9:34         ` Ihor Radchenko
  0 siblings, 1 reply; 6+ messages in thread
From: Max Nikulin @ 2023-10-24  8:15 UTC (permalink / raw)
  To: emacs-orgmode

On 23/10/2023 15:15, Ihor Radchenko wrote:
>> I wonder, why not export [[link]] to <<link>> as "link" by default, if
>> no description is given, as is the case with URLs, Elisp, and the
>> like?
> Yes, something like that.
> 
> The main problem is how to properly design
> this - the current approach is that individual backends decide. And we
> have no control over third-party backends...

If it were possible to customize fuzzy links through 
`org-link-parameters' then Rudolf would be able to easily try if 
proposed changes are feasible and to debug them in real life cases 
before adding them to Org code.



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

* Re: No-description <<target>> links
  2023-10-24  8:15       ` Max Nikulin
@ 2023-10-24  9:34         ` Ihor Radchenko
  0 siblings, 0 replies; 6+ messages in thread
From: Ihor Radchenko @ 2023-10-24  9:34 UTC (permalink / raw)
  To: Max Nikulin; +Cc: emacs-orgmode

Max Nikulin <manikulin@gmail.com> writes:

>> The main problem is how to properly design
>> this - the current approach is that individual backends decide. And we
>> have no control over third-party backends...
>
> If it were possible to customize fuzzy links through 
> `org-link-parameters' then Rudolf would be able to easily try if 
> proposed changes are feasible and to debug them in real life cases 
> before adding them to Org code.

I am afraid that supporting `org-link-parameters' for built-in link
types is much harder to implement compared to addressing the <<target>>
description problem.

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>


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

end of thread, other threads:[~2023-10-24  9:32 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2023-10-21 11:22 No-description <<target>> links Rudolf Adamkovič
2023-10-22  8:28 ` Ihor Radchenko
2023-10-22 21:01   ` Rudolf Adamkovič
2023-10-23  8:15     ` Ihor Radchenko
2023-10-24  8:15       ` Max Nikulin
2023-10-24  9:34         ` Ihor Radchenko

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).