emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* How about Org Mode invalid link handling strategy for exporting?
@ 2019-01-02  0:12 stardiviner
  2019-01-02 14:16 ` Nicolas Goaziou
  2019-01-02 14:34 ` John Kitchin
  0 siblings, 2 replies; 4+ messages in thread
From: stardiviner @ 2019-01-02  0:12 UTC (permalink / raw)
  To: org-mode

When I use package "ox-epub" to export current Org buffer to EPUB file,
it is based on "ox-html", I got some issues. One issue is about the
external file resource link which can't add into EPUB, or internal link
but invalid (I use narrow to subtree to debug Org buffer when using
ox-epub, so some internal links to other headlines will be invalid).

I hope Org Mode can enhance this invalid link handling strategy to not
interrupt user exporting process. Just display warning to user. Or add
an option to controlled by user?

Because I'm exporting a big Clojure language reference to EPUB, so
really hard to handling those invalid links.

About the handling strategy, I have some ideas:

- raise warning about invalid links no matter internal links or external
  links.

- don't interrupt process when meet invalid links.

- keep link description part as link part. Replace the original link
  part with an empty link.

Do you any ideas?

--
[ stardiviner ]
       I try to make every word tell the meaning what I want to express.

       Blog: https://stardiviner.github.io/
       IRC(freenode): stardiviner, Matrix: stardiviner
       GPG: F09F650D7D674819892591401B5DF1C95AE89AC3

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

* Re: How about Org Mode invalid link handling strategy for exporting?
  2019-01-02  0:12 How about Org Mode invalid link handling strategy for exporting? stardiviner
@ 2019-01-02 14:16 ` Nicolas Goaziou
  2019-01-02 14:34 ` John Kitchin
  1 sibling, 0 replies; 4+ messages in thread
From: Nicolas Goaziou @ 2019-01-02 14:16 UTC (permalink / raw)
  To: stardiviner; +Cc: org-mode

Hello,

stardiviner <numbchild@gmail.com> writes:

> When I use package "ox-epub" to export current Org buffer to EPUB file,
> it is based on "ox-html", I got some issues. One issue is about the
> external file resource link which can't add into EPUB, or internal link
> but invalid (I use narrow to subtree to debug Org buffer when using
> ox-epub, so some internal links to other headlines will be invalid).
>
> I hope Org Mode can enhance this invalid link handling strategy to not
> interrupt user exporting process. Just display warning to user. Or add
> an option to controlled by user?

See `org-export-with-broken-links'.

Regards,

-- 
Nicolas Goaziou

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

* Re: How about Org Mode invalid link handling strategy for exporting?
  2019-01-02  0:12 How about Org Mode invalid link handling strategy for exporting? stardiviner
  2019-01-02 14:16 ` Nicolas Goaziou
@ 2019-01-02 14:34 ` John Kitchin
  2019-01-03 12:22   ` [SOLVED] " stardiviner
  1 sibling, 1 reply; 4+ messages in thread
From: John Kitchin @ 2019-01-02 14:34 UTC (permalink / raw)
  To: numbchild; +Cc: org-mode

Can you (setq org-export-with-broken-links t) to address some of these?

It looks like (setq org-export-with-broken-links 'mark)

will change them to [BROKEN LINK: path].

According to the docs:

This option can also be set with the OPTIONS keyword, e.g.,
"broken-links:mark".

stardiviner <numbchild@gmail.com> writes:

> When I use package "ox-epub" to export current Org buffer to EPUB file,
> it is based on "ox-html", I got some issues. One issue is about the
> external file resource link which can't add into EPUB, or internal link
> but invalid (I use narrow to subtree to debug Org buffer when using
> ox-epub, so some internal links to other headlines will be invalid).
>
> I hope Org Mode can enhance this invalid link handling strategy to not
> interrupt user exporting process. Just display warning to user. Or add
> an option to controlled by user?
>
> Because I'm exporting a big Clojure language reference to EPUB, so
> really hard to handling those invalid links.
>
> About the handling strategy, I have some ideas:
>
> - raise warning about invalid links no matter internal links or external
>   links.
>
> - don't interrupt process when meet invalid links.
>
> - keep link description part as link part. Replace the original link
>   part with an empty link.
>
> Do you any ideas?


--
Professor John Kitchin
Doherty Hall A207F
Department of Chemical Engineering
Carnegie Mellon University
Pittsburgh, PA 15213
412-268-7803
@johnkitchin
http://kitchingroup.cheme.cmu.edu

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

* [SOLVED] How about Org Mode invalid link handling strategy for exporting?
  2019-01-02 14:34 ` John Kitchin
@ 2019-01-03 12:22   ` stardiviner
  0 siblings, 0 replies; 4+ messages in thread
From: stardiviner @ 2019-01-03 12:22 UTC (permalink / raw)
  To: John Kitchin; +Cc: org-mode


I have not found that option. Thanks.

I checked the org-manual.org now, it's mentioned.

-- 
[ stardiviner ]
       I try to make every word tell the meaning what I want to express.

       Blog: https://stardiviner.github.io/
       IRC(freenode): stardiviner, Matrix: stardiviner
       GPG: F09F650D7D674819892591401B5DF1C95AE89AC3
      

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

end of thread, other threads:[~2019-01-03 12:20 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2019-01-02  0:12 How about Org Mode invalid link handling strategy for exporting? stardiviner
2019-01-02 14:16 ` Nicolas Goaziou
2019-01-02 14:34 ` John Kitchin
2019-01-03 12:22   ` [SOLVED] " stardiviner

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