ox-hugo/test/site/content-org/single-posts/links-to-org-elements.org

Links to Org Elements (tables, source blocks, ..)

• Links to source blocks
• Links to tables
• Links to images
• COMMENT Local Variables

Test for links generated for internal links to tables, source blocks, figures. Also the language is set to "de" to test the translation of Org element strings.

ox-hugo

Links to source blocks

From (org) Internal links,

If no dedicated target exists, the link will then try to match the exact name of an element within the buffer. Naming is done with the ‘#+name’ keyword, which has to be put in the line before the element it refers to, as in the following example

#+name: My Target
| a  | table      |
|----+------------|
| of | four cells |

Also, when targeting a #+name keyword, #+caption keyword is mandatory in order to get proper numbering for source blocks, images and tables.

So the below code block:

#+caption: Hello
#+name: code__hello
#+begin_src emacs-lisp
(message "Hello")
#+end_src
*Here we refer to [[code__helloagain]].*

#+include: "../misc/common.org::#lorem-ipsum" :only-contents t

#+caption: Hello Again
#+name: code__helloagain
#+begin_src emacs-lisp
(message "Hello again")
#+end_src
*Here we refer to [[code__hello]].*

will output below (lorem-ipsum added to increase page content so that the link jump is evident):

(message "Hello")

Here we refer to /wilderjds/ox-hugo/src/commit/ad9eb052033f196597e82b23c426d6b887156f60/test/site/content-org/single-posts/code__helloagain.

(message "Hello again")

Here we refer to /wilderjds/ox-hugo/src/commit/ad9eb052033f196597e82b23c426d6b887156f60/test/site/content-org/single-posts/code__hello.

Links to tables

Note: When targeting a #+name keyword, #+caption keyword is mandatory in order to get proper numbering for source blocks, images and tables.

#+caption: Simple table 1
#+name: tab__simple1
| a | b |
| c | d |
*Here we refer to [[tab__simple2]].*

#+include: "../misc/common.org::#lorem-ipsum" :only-contents t

Here's another table:

#+caption: Simple table 2
#+name: tab__simple2
| e | f |
| g | h |
*Here we refer to [[tab__simple1]].*

will output below (lorem-ipsum added to increase page content so that the link jump is evident):

a	b
c	d

Here we refer to /wilderjds/ox-hugo/src/commit/ad9eb052033f196597e82b23c426d6b887156f60/test/site/content-org/single-posts/tab__simple2.

Here's another table:

e	f
g	h

Here we refer to /wilderjds/ox-hugo/src/commit/ad9eb052033f196597e82b23c426d6b887156f60/test/site/content-org/single-posts/tab__simple1.

---

Reference: (org) Images and tables.

Links to images

Note: When targeting a #+name keyword, #+caption keyword is mandatory in order to get proper numbering for source blocks, images and tables.

#+caption: Org Logo
#+name: img__org_logo1
[[/images/org-mode-unicorn-logo.png]]
*Here we refer to [[img__org_logo2]].*

#+include: "../misc/common.org::#lorem-ipsum" :only-contents t

Here's the same image again, but with a different Org link ID:

#+caption: Same Org Logo
#+name: img__org_logo2
[[/images/org-mode-unicorn-logo.png]]
*Here we refer to [[img__org_logo1]].*

will output below (lorem-ipsum added to increase page content so that the link jump is evident):

Here we refer to /wilderjds/ox-hugo/src/commit/ad9eb052033f196597e82b23c426d6b887156f60/test/site/content-org/single-posts/img__org_logo2.

Here's the same image again, but with a different Org link ID:

Here we refer to /wilderjds/ox-hugo/src/commit/ad9eb052033f196597e82b23c426d6b887156f60/test/site/content-org/single-posts/img__org_logo1.

---

Reference: (org) Images and tables.

COMMENT Local Variables   ARCHIVE