source: branches/mbutscher/work/WikidPadHelp/data/UrlLinking.wiki @ 195

Last change on this file since 195 was 178, checked in by mbutscher, 11 years ago

2.0preAlpha (internal)

Works so far, now editing help wiki.

File size: 4.2 KB
Line 
1++ Url Linking
2
3You may enter URLs to websites or local files into your document.  To
4open the link double click on it or press the Ctrl-L. If you drag a
5file from Windows explorer onto wikidPad a link will be created for
6you.
7
8Example:
9
10http://www.google.com/
11https://somewheresecure.com
12file:///C|/Documents%20and%20Settings/joeshmoe/readme.txt
13ftp://ftp.whereever.com/
14
15To create an absolute URL to a file you can also use "Add file URL" in "Editor" menu and choose the desired file in file dialog.
16
17To show a different title in the HTML preview/export as a link, use e.g.
18
19[ftp://ftp.whereever.com/ |Go somewhere]
20
21Switch to preview to see the "Go somewhere" only. You can also use an image URL (see below) as title to show a clickable image:
22
23[https://somewheresecure.com| rel://files/testimg.gif>r40%]
24
25
26++ Relative URLs
27You can create URLs which are relative to the wiki directory. These start with rel:// followed by the relative position. For HTML export the rel:// is removed to create a relative HTML link (without protocol). For HTML preview they are converted to "file:" URLs.
28
29You can drag a file from Windows Explorer while holding shift key to create a relative URL. This does not work with files ending with ".wiki", these are always absolute and have the "wiki:" protocol.
30
31Example:
32
33rel://../above/andBelow.txt
34
35
36++ File storage
37You can also copy files into a subdirectory of the wiki directory from within WikidPad. See [FileStorage] for details.
38
39
40++ Images
41If an URL file ends with ".jpg", ".gif", ".png" or ".bmp", the URL is automatically shown as an image in preview and HTML export (an image in the file storage with relative URL is copied to a subdirectory "files" in the export destination directory). The URL can be absolute or relative and can point into the file storage.
42
43Example (switch to preview to see the picture):
44
45rel://files/testimg.gif
46
47To show all such URLs as links instead, open "Options" dialog, page "HTML preview/export" and check "Show pics as links in preview" or "Show pics as links in export" or set it temporarily in the export dialog.
48
49For controlling of individual URLs, see "URL Appendix" below.
50
51
52++ Wiki: URLs
53To link from one wiki to another you can create links beginning with "wiki:", e.g.
54
55wiki:///C|/Documents%20and%20Settings/foowiki/foowiki.wiki
56
57
58You can add parameter "page" to specify the wiki page to open (replace spaces by "%20"):
59
60wiki:///C|/Documents%20and%20Settings/foowiki/foowiki.wiki?page=ThePage%20with%20spaces
61
62You can also specify an anchor on the page to jump to:
63
64wiki:///C|/Documents%20and%20Settings/foowiki/foowiki.wiki?page=ThePage%20with%20spaces&anchor=here
65
66
67To create these URLs you can also use in menu "Wiki Words" the function "Copy URL to clipboard" and then paste the URL where you like.
68
69The above menu entry is also available in context menus for wiki word tree items, tabs and for "anchor: ..." lines in the editor. In the last case the URL contains also the anchor you clicked on.
70
71
72++ URL Appendix
73You can control details of URL presentation, especially for images, by using an URL appendix. This consists of a '>' character directly after the URL (no space) and some code characters which can be delimited by semicolons. The following codes are defined:
74
75    i Show URL as image, even if it has none of the default suffixes
76    l Show URL as link. 'i' and 'l' are mutually exclusive.
77    s Set size of an image, following the code is the width and height in pixels or
78      as percentage of *surrounding* space on page (according to HTML standard),
79      delimited by 'x' (e.g. '200x300', "60%x70%")
80    r Set size in percent relative to image size (e.g. "50%x30%"). Only one given
81      percent value is used for width and height ("40%" is same as "40%x40%"). No value
82      at all is interpreted as "100%x100%".
83    a Set alignment of image, the following character defines which alignment (*t*op, vertically
84    *m*iddle, *b*ottom, *r*ight or *l*eft). This setting is not respected by the internal preview.
85
86Examples:
87
88Control size and alignment:
89rel://files/testimg.gif>s50x50;al
90
91Show the URL as link:
92rel://files/testimg.gif>l
93
94Relative size:
95rel://files/testimg.gif>r110%x60%
Note: See TracBrowser for help on using the repository browser.