LinksUrl

Links Url

Contents:

Links Url

Back

General

To create a link to an external item, the default HTML URL can be used, with the format:

scheme://host.domain:port/path/filename [1].

Wikidpad supports the general schemes: http, https, ftp, mailto, outlook and file [2]. This means that those links can be defined, by simply typing or pasting them into your page; example:

http://www.w3schools.com/html/html_url.asp

Wikidpad supports two further links types of it's own, that are shaped as separate schemes:

wiki: used for linking to other (wikidpad) wiki's; see also External links: Wiki's.
rel: to make linking with relative path's possible; see Relative paths below.

Due to it's nature, Wikidpad cannot use relative paths until a page is exported/published to HTML. The reason for this, is that during preview it's not the wiki folder, that is the "home" folder, but the Wikidpad program folder or the temp folder. [3]

A absolute file URL can be quickly created, by using the menu item: "Editor / Add file URL"

Top

Link titles

As text

As in a standard HTML page, a link text can - in preview and HTML export - be replaced by a link title, that then serves as a clickable synonym for the link. For that the link has to be enclosed in square brackets and the link and title text have to be separated by a "|" character. Example:

W3 Schools: URL's

As images

As in a standard HTML page, a link text can - in preview and HTML export - be replaced by an image, that then serves as a clickable synonym for the link. For that the link has to be enclosed in square brackets and the link and the image specification have to be separated by vertical bar "|". Example:

W3 Schools: URL's

The image specification has the general form of a URL, with the possibility to add image formatting attributes; see Textformatting: Images for more information on specifying image links.

Top
Footnotes:
[1] See http://www.w3schools.com/html/html_url.asp for more information on url's
[2] Scheme is sometimes also referred to as "protocol"
[3] This means that you can also not use relative paths within html elements, like in the src="..." attribute for an image element. In order for them to show up in preview correctly, you háve to use absolute paths or a wikidpad rel link.

Files

Relative paths

In Wikidpad relative paths can't be used, the way they can in regular html. The way to do it in Wikidpad, is to use the "rel" scheme. This scheme has the format: "rel://" (without the backslash!) and is during preview replaced with the path to the folder of the active wiki. Html export turns it into a correct relative path reference. The rel scheme can be used both for file references and image references.

The rel reference follows the rules for the html relative path specification; this means that:

rel://filename.ext	refers to a file in the folder of the current wiki
rel://files/filename.ext	refers to a file in the "files" subfolder of the current wiki folder.
rel://../filename.ext	refers to a file in the folder above the current wiki folder in the file hiërarchie

In a wiki that has been exported to html, the "home" or "root" folder is not the current wiki folder, but the export folder. As of version 19beta 17 wikidpad copies all files with relatives path's over to the export folder, with the correct folder structure.

Remarks

A relative URL can easily be created, by draging it from Windows Explorer onto the editor, while holding down the shift key. This does however not work for files ending with ".wiki"; the created links for these files use the wiki scheme, that does not allow relative paths.
For those who are not realy into html and relative path declarations, a more comprehensive example can be found here.
For more information on URL links see Url links

File store

Each wiki can have a "file store", where you can collect all the images, documents and other files, that are related to the wiki in one place. The wiki file store is formed by the "files" folder in the wiki's directory. Wikidpad offers some special facilities, to help maintain the file store, with respect to relative links and export to html.

Files can of course be copied into the file store by hand; if the "files" folder does not yet exist, you have to create it first. Files can however also be copied, by dragging one or more of them from Windows Explorer onto the editor, while holding down the control key. The files are then copied to the file store and relative links to them are created in the editor. If a file with the same identity already exists in the store, only the link is created and no copying is performed. If a file with the same name, but a different identity already exists, a random sequence of 10 digits is appended to the file name, in order to make it unique. If the "files" folder does not yet exist, Wikidpad will create it.

For more information on how Wikidpad compares files and how you that can be influenced, see Wiki File Store: Copy control

Top

Settings

Options

Application settings: File Launcher

• Path to file launcher
The path to the script or program that takes the path or URL of a file and runs the application associated with this file. For Linux this would be the "xdg-open" script; it might in some cases have to be installed first.

On Windows and Linux, data files with a particular suffix can be associated with a particular application, so that the data file (e.g. "index.html") can be "executed" by starting the application with the file as parameter. On Windows this is a functionality of the OS itself while on Linux it is a functionality of the graphical environment like KDE or Gnome. To use this function there, a helper (normally the "xdg-open" script) must be called which detects the appropriate application and starts it.

When (double)clicking a URL in WikidPad on Linux, the script is called with a file path (for "file:"/"rel:" URLs) or the URL itself as parameter.

Application settings: Mouse, drag & drop files

• Dropping files
• Dropping files with SHIFT
• Dropping files with CTRL
Control what should happen if you drag and drop files from explorer into the editor with no key pressed, with SHIFT pressed or with CTRL pressed.

Possible choices are:

Nothing
Absolute URL: Insert absolute URL(s) to the file(s)
Relative URL: URL(s) starting with "rel:"
Relative into storage: Copy file(s) into file storage and create relative URL(s) to it

Top

previous: Back
parents: FilesRelativePathsIp, Intro3Formatting, LinksUrl, TextImages, TheEditor, UrlLinking
inserts: FilesRelativePathsIp; FilesWikiFileStoreIp
[help.status: done]