Basic Linking

Any "word" using PascalCase automatically becomes a link. For example, FlexWiki, HelloWorld or TheDemocraticParty. PascalCase words without topics (like HelloWorld) become links that will create topics when you click on them.

Words can also include WikiNamespaces, which will be automatically stripped off when displaying the link. FlexWiki.PascalCase becomes PascalCase.

FlexWiki tries to be somewhat smart about automatic linking, but it has severe limits. For instance, it removes the "S" off the end of WikiNamespaces to find WikiNamespace, but not the "D" off WikiNamespaced .

Anchors are also supported, see Anchors.

Linking to URLs

Like PascalCased words, any URL becomes a link:

http://www.blizzard.com.

Notice the formating changes for a link to an external site.

Care must be taken when using automatic URL linking, because punctuation immediately (before any whitespace) following the URL will be included. Periods are okay following a domain name ( http://www.blizzard.com. ) or after a path separator ( http://www.blizzard.com/inblizz/. ) but they will usually generate "file not found" errors when following a filename ( http://www.blizzard.com/inblizz/reviews.shtml. ). To place punctuation immediately after a URL, use a FreeLink.

Some URL links require URL Encoding before they will work. This won't work:

http://maps.google.com/maps?q=1000+Aerial+Center+Pky,+Cary,+NC+27513&spn=0.023328,0.034083&hl=en

You first have to encode it, then it works.

http://maps.google.com/maps?q=1000%20Aerial%20Center%20Pky%2C%20Cary%2C%20NC%2027513&spn=0.023328%2C0.034083&hl=en

Note that for intranet use you can also link to Windows shares using file:////server_name\share_name (this link doesn't go anywhere).

E-mails

Linking an e-mail address is similar to the html a tag.

mailto:somebody@example.com

You can even give more recipients:

mailto:somebody@example.com;somebodyelse@example.com

And subject:

mailto:somebody@example.com?subject=Hello%20my%20friend

You can give friendly name too

 "Contacts":mailto:somebody@example.com;somebodyelse@example.com

Contacts

 "Contacts":mailto:somebody@example.com?subject=Hello%20my%20friend

Contacts

-- SzaMa - 2006.04.16

And CC: or BCC:

mailto:somebody@example.com?subject=Hello%20my%20friend&cc=somebodyelse@example.com&bcc=onemoreelse@example.com

-- AaronSachs - 2006.12.07

Free Linking

Surrounding a word with square brackets is called a FreeLink and will give you a link whether you use PascalCase or not. So, putting square brackets around camelCase, gives you camelCase. However, you should generally use PascalCased words. I mean, whyNotUsePascalCaseHere.

It's also possible to have one word links (without using square brackets), but they're special; see: one-word topic names.

Preventing Linking

To prevent PascalCase words from being linked, start and end the word with two double-quotes. To show PascalCase non-linked, you enter:

 ""PascalCase""

This is particularly useful, for preventing linking to a FauxTopicName, one-word topic name, or plural forms of TLAs, such as ROMs.

"Relabel"ing links

If you know you want a link, but want to display text other than the linking text, you can "relabel" the link. These are sometimes called arbitrary links or piped link. They will have fomatting matching their link type. The pattern for them is <DisplayText>:<Link>. (Someone called this pattern a Textism, but I'm unfamiliar with the term.)

Examples:

You write	FlexWiki displays
"pascal case":PascalCase	pascal case
"camel case":[camelCase]	camel case
"pascal case":FlexWiki.PascalCase	pascal case
"camel case":FlexWiki.[camelCase]	camel case
"Microsoft Corp.":http://www.microsoft.com	Microsoft Corp.
"http://www.flexwiki.com/images/go.gif":http://www.flexwiki.com

This is a BasicLink followed by a relabeled link to IBM

A relabeled link to IBM followed by a BasicLink

A link to http://www.ibm.com followed by a BasicLink

Anchors/Bookmarks (available in build 1.8.0.1661 or later)

Any WikiPageProperty or HiddenWikiPageProperty (see FormattingRules#WikiPageProperty) becomes an anchor (or bookmark) on that page. You can reference that anchor by using the <TopicName>#<Anchor> form, e.g. FormattingRules#Properties