From mboxrd@z Thu Jan 1 00:00:00 1970 From: Tobias Zawada Subject: Bug: Documentation of the html-export of links across files [8.2.10 (release_8.2.10 @ /usr/share/emacs/24.5/lisp/org/)] Date: Tue, 1 Mar 2016 08:27:51 +0100 (CET) Message-ID: <1591034494.378085.aca66df2-e579-423c-98e1-72ca1dffc547.open-xchange@email.1und1.de> Mime-Version: 1.0 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:57502) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aaeit-00039t-Nn for emacs-orgmode@gnu.org; Tue, 01 Mar 2016 02:28:04 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aaeio-0005V2-TI for emacs-orgmode@gnu.org; Tue, 01 Mar 2016 02:27:59 -0500 Received: from mout.kundenserver.de ([217.72.192.75]:65449) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aaeio-0005Un-K0 for emacs-orgmode@gnu.org; Tue, 01 Mar 2016 02:27:54 -0500 Received: from oxbaltgw07.schlund.de ([172.19.246.13]) by mrelayeu.kundenserver.de (mreue103) with ESMTPSA (Nemesis) id 0MSYbs-1aQiXU0feG-00Rcl7 for ; Tue, 01 Mar 2016 08:27:52 +0100 List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs-orgmode@gnu.org

This documentation bug exists also in org-mode 8.3.2 and th= e current online org-mode manual.

The export of links like [[file= :a.org::#my-custom-id][Some link]] and
[[file:a.org::*Section header][So= me link to a section header]] is not
described in the org-mode manual. T= his leads to questions like the
following one:
http://emacs.stackexch= ange.com/questions/20461/org-mode-external-links-not-working-when-exported-= to-html/20658#20658

Emacs : GNU Emacs 24.5.1 (x86_6= 4-unknown-cygwin, GTK+ Version 3.14.13)
of 2015-06-23 on desktop-n= ew
Package: Org-mode version 8.2.10 (release_8.2.10 @ /usr/share/emacs/2= 4.5/lisp/org/)

current state:
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D
(setq
org-tab-first-hook '(org-hide-block-toggle-= maybe org-src-native-tab-command-maybe org-babel-hide-result-toggle-maybe o= rg-babel-header-arg-expand)
org-speed-command-hook '(org-speed= -command-default-hook org-babel-speed-command-hook)
org-occur-hook= '(org-first-headline-recenter)
org-metaup-hook '(org-babe= l-load-in-session-maybe)
org-confirm-shell-link-function 'y-or= -n-p
org-image-actual-width '(400)
org-highlight-late= x-and-related '(latex)
org-drawers '("SUMMARY" = 4;PROPERTIES" "CLOCK" "LOGBOOK" "RESULTS")
&= #160;org-after-todo-state-change-hook '(org-clock-out-if-current)
&#= 160;org-from-is-user-regexp "\\<U-ITIHQ\\\\Tobias\\.Zawada\\>&#= 34;
org-src-mode-hook '(hack-local-variables org-src-babel-con= figure-edit-buffer org-src-mode-configure-edit-buffer)
org-agenda-= before-write-hook '(org-agenda-add-entry-text)
org-babel-pre-t= angle-hook '(save-buffer)
org-font-lock-set-keywords-hook '= ;(org-hook-font-lock-todo #[nil "\301 \235\203 \207\301 B\211 \207"= ; [org-font-lock-extra-keywords (org-activate-hidden-links-additional (0 (q= uote (face org-target invisible org-link))))] 2]
   = 0;             (lambda n= il (let ((el (assoc-string "{{{.+}}}" org-font-lock-extra-keywords)= )) (when el (setcar el "{{{.+?}}}"))) (add-to-list (quote org-font-= lock-extra-keywords) (quote ("^[[:blank:]]*\$[?!]\$:[^?!]*\\1$" (= 0 (quote org-question-exclamation-face) t))))
     &= #160;              (add-t= o-list (quote org-font-lock-extra-keywords) (quote ("^[[:blank:]]*[A-Z]= [A-Z]+:.*$" (0 (quote org-user-defined-keywords-face) t)))))
&= #160;               = )
org-mode-hook '(org-hook-todo-regexp (lambda nil (loc= al-set-key (kbd "C-c b") (quote org-insert-block))) (lambda nil (ad= d-hook (quote text-scale-mode-hook) (quote org-text-scale-eye)))
&= #160;     (lambda nil (setq paste-image-prefix "[= [file:") (setq paste-image-postfix "]]") (setq paste-image-hook= (quote org-display-inline-images)) (local-set-key (kbd "C-c C-p C-p= 4;) (quote org-preview-latex-fragment))
       =    (let ((org-menu (cdr (assoc (quote menu-bar) org-mode-map)))) = (easy-menu-add-item org-menu (quote ("Org" "Show/Hide")) [&= #34;Toggle Show Images" org-toggle-inline-images t :help "Toggle Sh= ow Images"])
           (eas= y-menu-add-item org-menu (quote ("Org")) ["LaTeX Preview" o= rg-preview-latex-fragment t :help "If point is in latex fragment genera= te this fragment else all."])
       =    (easy-menu-add-item org-menu (quote ("Org" "Loggin= g work")) ["CLOCK summary in directory" org-clock-sum-dir t :he= lp "Summarize time used for project matching regexp."])
&#= 160;         (easy-menu-add-item org-menu (qu= ote ("Org")) ["Collect topic matching re from multiple files= 4; org-multifile t :help "Collect topics with main header matching regu= lar expression from multiple files."])
     = 0;     (easy-menu-add-item org-menu (quote ("Org")) = ["Collect this topic from multiple files" org-multifile-this-topic = :help "Collect topic matching the expression <<...>> fr= om the current main header line from multiple files."])
  =         (easy-menu-add-item org-menu (quote = ("Org")) ["Continue work with the current topic." org-conti= nue-this-topic :help "Look for an expression <<...>> in= the current main header line, find this topic at the current date or add i= t if not present yet."]))
       = 0; )
       (lambda nil (local-set-key (= kbd "C-c p") (quote org-patch)))
      = (lambda nil (local-set-key [f5] (quote trac-code-block)) (org-defke= y org-mouse-map [mouse-3] (quote org-mouse-3-menu)) (setq pcomplete-default= -completion-function (quote hippie-expand-first)) (local-set-key (kbd "= <C-tab>") (quote org-cycle-archived-TNG))
   = ;      (local-set-key (kbd "M-s M-s") (quote or= g-cycle-archived-look)) (add-hook (quote org-ctrl-c-ctrl-c-hook) (quote cal= c-inline-maybe)) (add-hook (quote org-ctrl-c-ctrl-c-hook) (quote org-update= -formula))
          (setq-local hipp= ie-expand-try-functions-list (cons (quote complete-org-link-at-point) hippi= e-expand-try-functions-list)) (setq require-final-newline t))
= 0;     #[nil "\300\301\302\303\304$\207" [org= -add-hook change-major-mode-hook org-show-block-all append local] 5] #[nil = "\300\301\302\303\304$\207" [org-add-hook change-major-mode-hook or= g-babel-show-result-all append local] 5] org-babel-result-hide-spec org-bab= el-hide-all-hashes)
org-ctrl-c-ctrl-c-hook '(org-update-formul= a calc-inline-maybe org-babel-hash-at-point org-babel-execute-safely-maybe)=
org-cycle-hook '(org-cycle-hide-archived-subtrees org-cycle-h= ide-drawers org-cycle-hide-inline-tasks org-cycle-show-empty-lines org-opti= mize-window-after-visibility-change)
org-babel-tangle-lang-exts &#= 39;(("maxima" . "max") ("perl" . "pl") (= 4;ruby" . "rb") ("python" . "py") ("emacs-l= isp" . "el"))
org-confirm-elisp-link-function 'y-o= r-n-p
org-metadown-hook '(org-babel-pop-to-session-maybe)
&= #160;org-structure-template-alist '(("m" org-structure-template= -latex org-structure-template-latex) ("s" "#+BEGIN_SRC ?\n\n#+E= ND_SRC" "<src lang=3D\"?\">\n\n</src>")= ("e" "#+BEGIN_EXAMPLE\n?\n#+END_EXAMPLE" "<example= >\n?\n</example>") ("q" "#+BEGIN_QUOTE\n?\n#+EN= D_QUOTE" "<quote>\n?\n</quote>")
  = ;             ("v= 4; "#+BEGIN_VERSE\n?\n#+END_VERSE" "<verse>\n?\n</v= erse>") ("V" "#+BEGIN_VERBATIM\n?\n#+END_VERBATIM" = "<verbatim>\n?\n</verbatim>") ("c" "#+B= EGIN_CENTER\n?\n#+END_CENTER" "<center>\n?\n</center= 2;") ("l" "#+BEGIN_LaTeX\n?\n#+END_LaTeX" "<lit= eral style=3D\"latex\">\n?\n</literal>")
&= #160;             ("= L" "#+LaTeX: " "<literal style=3D\"latex\">= ?</literal>") ("h" "#+BEGIN_HTML\n?\n#+END_HTML"= ; "<literal style=3D\"html\">\n?\n</literal>= 4;) ("H" "#+HTML: " "<literal style=3D\"html\&#= 34;>?</literal>") ("a" "#+BEGIN_ASCII\n?\n#+END= _ASCII" "") ("A" "#+ASCII: " "")
= 60;             (&= #34;i" "#+INDEX: ?" "#+INDEX: ?") ("I" "#+I= NCLUDE: %file ?" "<include file=3D%file markup=3D\"?\"&= #62;"))
org-babel-load-languages '((sh . t) (python . t) (= R . t) (ruby . t) (ditaa . t) (dot . t) (octave . t) (sqlite . t) (perl . t= ) (emacs-lisp . t) (maxima . t))
org-src-preserve-indentation t org-agenda-files '("~/Weiterbildung/contacts.org" "~= /Weiterbildung/agenda.org")
org-clock-out-hook '(org-clock= -remove-empty-clock-drawer)
org-confirm-babel-evaluate nil
= 0;org-entities-user '(("times" "\\times" t "&ti= mes;" "x" "x" "×") ("mapsto" "= \\mapsto" t "&mapsto;" "|->" "|->" = "=E2=86=A6") ("neg" "\\neg" t "&neg;" &= #34;/" "/" "¬") ("greatergreater" "\\g= g" t "&GreaterGreater;" ">>" ">>= ;" "=E2=AA=A2") ("nbsp" "\\medspace" t "= 8;nbsp;" " " " " " ") ("greatereq"= "\\geq" t "&greatereq;" ">=3D" ">= =3D" "≥")
         =     ("lesseq" "\\leq" t "&lesseq;= 4; "<=3D" "<=3D" "≤") ("lessless&= #34; "\\ll" t "&LessLess;" "<<" "&#= 60;<" "=E2=AA=A1") ("sqrt" "\\sqrt" t "= &Sqrt;" "sqrt" "sqrt" "√") ("plus= minus" "\\pm" t "&PlusMinus;" "+-" "+-&= #34; "±") ("bull" "\\bullet" nil "&bul= l;" "*" "*" "•"))
org-descriptiv= e-links nil
)