LinkingFormattingRules

Enter a topic name to show or a new topic name to create; then press Enter

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.

Anchors are also supported, see Anchors.

Namespace Linking

Words can also include WikiNamespaces, for example: Blog.HomePage becomes Blog.HomePage. The Namespace is not required when a topic being linked is in the same directory as the topic where the link is being made. However, if it is in a subdirectory then the link should be created as"

 SubDir.TopicName

If the topic is down a number of directories then the link can be specified:

 SubDir1/SubDir2.TopicName

When in a topic a number of levels deep in the Namespace hierarchy, it is possible to refer to a topic in the root Namespace by:

 Root.TopicName

When in a topic a number of levels deep in the Namespace hierarchy, it is possible to refer to a topic above the root Namespace by:

 Root/SubDir1.TopicName

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 htmla tag.

mailto:somebody@example.com

bold text

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

Add CC: or BCC:

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

Add Message Body:

mailto:somebody@example.com?subject=Hello%20my%20friend&body=Please%20Eat%20More%20Chicken

-- AaronSachs - 2007.04.23

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.

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 or . 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
"camel case":[camelCase]
"pascal case":FlexWiki.PascalCase "pascal case":FlexWiki.PascalCase
"camel case":FlexWiki.[camelCase] "camel case":FlexWiki.[camelCase]
"Microsoft Corp.":http://www.microsoft.com Microsoft Corp.
"http://www.flexwiki.com/images/go.gif":http://www.flexwiki.com http://www.flexwiki.com/images/go.gif http://www.flexwiki.com

Anchors/Bookmarks

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

 "Anchor":LinkingFormattingRules#AnchorReference

Version: 12   Revised: 2013-05-02 18:30:10 Last Updated by: 208.114.148.38 Rename Show Links to Topic