#+TITLE:     Internal Links and org-odt.el
#+AUTHOR:    Jambunathan K
#+EMAIL:     kjambunathan@gmail.com
#+DATE:      2012-04-20 Fri
#+DESCRIPTION:
#+KEYWORDS:
#+LANGUAGE:  en
#+OPTIONS:   H:3 num:t toc:t \n:nil @:t ::t |:t ^:t -:t f:t *:t <:t
#+OPTIONS:   TeX:t LaTeX:dvipng skip:nil d:nil todo:t pri:nil tags:t

#+EXPORT_SELECT_TAGS: export
#+EXPORT_EXCLUDE_TAGS: noexport
#+LINK_UP:
#+LINK_HOME:
#+XSLT:


* Preface

- Hint :: To view the various links that are in this Org file do =M-x
          visible-mode=.
- Note :: Internal links that resolve to headlines will be replaced
          with their section numbers.  The description component of the
          internal links will be ignored.
- Tip 1 :: Always re-save the Org-exported ODT file once it is opened
           in LibreOffice.  This will force LibreOffice to rewrite the
           document.
- Tip 2 :: To identify unstable or broken internal links, from within
           LibreOffice do, /Tools->Update->Update All/ or
           /Tools->Update->Fields/.  Re-scan the document subsequently
           to identify problematic links.

* One
#<<#tag>>

  Some text.

* One Dot Five
  :PROPERTIES:
  :CUSTOM_ID: one-dot-five
  :END:

  Some text.

#<<invisible-target-in-the-middle-of-nowhere>>

  Some more text.

* One Dot Seven Five

  Some <<Visible Target>> text.

* Two

1. Section [[#tag][link]]

  This is a link destined for an invisible target. Note that the
  invisible target gets resolved (or bound) to the headline.

2. Section [[*One][One]]

  This is a link created with =C-c l= /(M-x org-store-link)/ and then
  inserting with =C-c C-l= /(M-x org-insert-link)/.  See /“(info "(org)
  Handling links")”/.

3. Section [[#one-dot-five][One Dot Five]]

  Link to a headline which has a /CUSTOM\_ID/. Created in the same
  manner as /Item (2)/.

4. Section [[One Dot Five]]

  This is a link created by hand.  This is another way to link to a
  headline.

5. Click this to land in a section text -  [[Visible%20Target][Visible Target]]

   This is a link to a visible target.  Recommended way of creating
   them is to proceed as in /Item (2)/ but modify the /Description:/
   offered at the prompt, so that the leading /file:/ component is
   stripped (=file:~/tmp-odt/foobar.org::Visible Target=) and just the
   part after =::= is used.

6. Section [[invisible-target-in-the-middle-of-nowhere][Invisible target in the middle of nothingness]]

  This link will be unstable.  Avoid such links.