DemoLinksUrl

Wikidpad supports the general schemes: http, https, ftp 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 a "|" character. 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 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

Remarks

Top

Todo's

done.demo.projectdemo.demo1: check out all posibilities

question.demo.development: Does wikidpad supports other schemes then: http, https, ftp and file (and img)?

Top

Results

[demo.status.waiting: question]
Top

previous: Back
parents: DemoExternalLinks, DemoFilesRelativePathsIp, DemoLinksUrl, DemoTextHtmlInternal, DemoTextImages
inserts: DemoFilesRelativePathsIp; DemoFilesWikiFileStoreIp
attributes: [tree_position: 1]