|
|
@@ -2682,23 +2682,28 @@ insert it into an Org file, and to follow the link.
|
|
|
@item C-c l
|
|
|
Store a link to the current location. This is a @emph{global} command which
|
|
|
can be used in any buffer to create a link. The link will be stored for
|
|
|
-later insertion into an Org buffer (see below). For Org files, if there is a
|
|
|
-@samp{<<target>>} at the cursor, the link points to the target. Otherwise it
|
|
|
-points to the current headline, either by text, or, if @file{org-id.el} is
|
|
|
-loaded, by ID property. For VM, Rmail, Wanderlust, MH-E, Gnus and BBDB
|
|
|
-buffers, the link will indicate the current article/entry. For W3 and W3M
|
|
|
-buffers, the link goes to the current URL. For IRC links, if you set the
|
|
|
-variable @code{org-irc-link-to-logs} to non-nil then @kbd{C-c l} will store a
|
|
|
+later insertion into an Org buffer (see below).
|
|
|
+
|
|
|
+For Org files, if there is a @samp{<<target>>} at the cursor, the link points
|
|
|
+to the target. Otherwise it points to the current headline, either by text
|
|
|
+(unsafe), or, if @file{org-id.el} is loaded and @code{org-link-to-org-use-id}
|
|
|
+is set, by ID property.
|
|
|
+
|
|
|
+For VM, Rmail, Wanderlust, MH-E, Gnus and BBDB buffers, the link will
|
|
|
+indicate the current article/entry. For W3 and W3M buffers, the link goes to
|
|
|
+the current URL. For IRC links, if you set the variable
|
|
|
+@code{org-irc-link-to-logs} to non-nil then @kbd{C-c l} will store a
|
|
|
@samp{file:/} style link to the relevant point in the logs for the current
|
|
|
conversation. Otherwise an @samp{irc:/} style link to the user/channel/server
|
|
|
-under the point will be stored. For any other files, the link will point to
|
|
|
-the file, with a search string (@pxref{Search options}) pointing to the
|
|
|
-contents of the current line. If there is an active region, the selected
|
|
|
-words will form the basis of the search string. If the automatically created
|
|
|
-link is not working correctly or accurately enough, you can write custom
|
|
|
-functions to select the search string and to do the search for particular
|
|
|
-file types - see @ref{Custom searches}. The key binding @kbd{C-c l} is only
|
|
|
-a suggestion - see @ref{Installation}.
|
|
|
+under the point will be stored.
|
|
|
+
|
|
|
+For any other files, the link will point to the file, with a search string
|
|
|
+(@pxref{Search options}) pointing to the contents of the current line. If
|
|
|
+there is an active region, the selected words will form the basis of the
|
|
|
+search string. If the automatically created link is not working correctly or
|
|
|
+accurately enough, you can write custom functions to select the search string
|
|
|
+and to do the search for particular file types - see @ref{Custom searches}.
|
|
|
+The key binding @kbd{C-c l} is only a suggestion - see @ref{Installation}.
|
|
|
@c
|
|
|
@kindex C-c C-l
|
|
|
@cindex link completion
|
|
|
@@ -7884,14 +7889,15 @@ All lines between these markers are exported literally
|
|
|
@cindex links, in HTML export
|
|
|
@cindex internal links, in HTML export
|
|
|
@cindex external links, in HTML export
|
|
|
-Internal links (@pxref{Internal links}) will continue to work in HTML.
|
|
|
-Automatic links created by radio targets (@pxref{Radio targets}) will also
|
|
|
-work in the HTML file. Links to external files will still work if the HTML
|
|
|
-file is in the same directory as the Org file. Links to other @file{.org}
|
|
|
-files will be translated into HTML links under the assumption that an HTML
|
|
|
-version also exists of the linked file. For information related to linking
|
|
|
-files while publishing them to a publishing directory see @ref{Publishing
|
|
|
-links}.
|
|
|
+Internal links (@pxref{Internal links}) will continue to work in HTML. This
|
|
|
+does include automatic links created by radio targets (@pxref{Radio
|
|
|
+targets}). Links to external files will still work if the target file is on
|
|
|
+the same @i{relative} path as the published Org file. Links to other
|
|
|
+@file{.org} files will be translated into HTML links under the assumption
|
|
|
+that an HTML version also exists of the linked file, at the same relative
|
|
|
+path. @samp{id:} links can then be used to jump to specific entries across
|
|
|
+files. For information related to linking files while publishing them to a
|
|
|
+publishing directory see @ref{Publishing links}.
|
|
|
|
|
|
If you want to specify attributes for links, you can do so using a special
|
|
|
@code{#+ATTR_HTML} line to define attributes that wil be added to the
|
Carsten Dominik