Links

Wiki_System*

technolowiki.org

[-edit SideBar-]

Links

%define=trail bgcolor=#eee block%%define=note font-style=italic color=green%%define=important block bgcolor=#fcc border='1px solid black' padding=5px%%define=audience class='frame rfloat' font-size:smaller bgcolor=#ffffcc%
%audience% authors (basic)
A key feature of WikiWikiWebs is the ease of creating links in the text of a document.
PmWiki provides multiple mechanisms for creating such links.

Links to other pages

To create a link to another page, simply enclose the name of the page inside double square brackets, as in [[wiki sandbox]] or [[installation]]. These result in links to sandbox* and installation, respectively.

PmWiki creates a link by using the text inside the double brackets. It does this by removing spaces between words, and automatically capitalizing words following spaces or other punctuation (like ~). Thus [[Wiki sandbox]], [[wiki sandbox]], and [[WikiSandbox]] all display differently but create the same link to the page titled WikiSandbox.

In other words, PmWiki will automatically create the link path name using title case as a rule, but link text will display in the format you have entered it.

A suffix can also be added to the end of a link, which becomes part of the link text but not the target. Thus [[wiki sandbox]]es is a link to WikiSandbox but displays as sandboxes*.

Link text in (parentheses) will not be not displayed, so that [[(wiki) sandbox]] links to WikiSandbox and displays as sandbox*.

Finally, you can specify the link text via a vertical brace, thus [[WikiSandbox | a play area]], which links to WikiSandbox but displays as a play area. You can use an arrow (->) to reverse the order of the text and target, as in a play area (a play area).

Some sites also recognize WikiWord links, in which a WikiWord appearing in the text is automatically treated as a link to a page of the same name.

Link Shortcuts

PageName* creates a link to PageName and uses that page's title as the link text, eg Links gives Links.

[1]* creates a reference link as shown below.

[[!PageName]]creates a link to the PageName in the group called Category.

[[~Author]] link creates a link to the page in the page called Author in the Profiles group. PmWiki will automatically generate that link for the current Author when it encounters three tilde characters (~) in a row (~~~). Adding a fourth tilde (~~~~) appends the current date and time.

Links to specific locations within a page

To define a location within a page to which you may jump directly, use the markup [[#name]]. This creates an "anchor" that uniquely identifies that location in the page. Then to have a link jump directly to that anchor, use one of

  • [[#name|link text]] within the same page, or
  • [[PageName#name]] or [[PageName#name|link text]] for a location on another page
  • The form [[PageName(#name)]] may be useful for hiding the anchor text in a link.

For example, here's a link to the Intermaps section, below.

Links to external sites (URLs)

Links to external sites simply begin with a prefix such as 'http:', 'ftp:', etc. Thus http://google.com/ and [[http://google.com/]] both link to Google. As with the above, an author can specify the link text by using the vertical brace or arrow syntax, as in [[http://google.com/ | Google]] and Google.

Links as References

Links may also be specifed as References, so the target appears as an anonymous numeric reference rather than a textual reference. The following markup is provided to produce sequential reference numbering within a PmWiki page:

Formatting the link as: [2] produces: [3] as the link.

Subsequent occurrence of the reference link format on the same page will be incremented automatically as per the following example: Entering [4] produces [5], [6] produces [7], and so on for further reference links.

Intermaps

InterMap links are also supported (see InterMap). In particular, the Path: InterMap entry can be used to create links using relative or absolute paths on the current site (e.g., Path:../../somedir/foo.html or ).

Links to pages in other groups*

See WikiGroup.

Links that open a new browser window

To have a link open in another window, use %newwin%:

  • %newwin% http://www.pmichaud.com produces %newwin% http://www.pmichaud.com
  • %newwin% [[http://google.com/ | Google]] produces %newwin% Google
  • %newwin% Main.WikiSandbox produces %newwin% Main.WikiSandbox

You can also specify that links should open in a new window via the target attribute:

%target=_blank% Any links on this line like http://www.pmichaud.com 
will open in a new window.

%target=_blank% Any links on this line like http://www.pmichaud.com
will open in a new window.

%trail%<< | DocumentationIndex | >>

%div faq apply=div%

Q: How do I put a link that will open as a new window?

A: Use the %newwin% wikistyle, as in:

%newwin%http://www.example.com/

%newwin%http://www.example.com/

Q: How do I place a mailing address in a page?

A: Use the
@] markup, as in one of the following:

    [@myaddress@example.com
    [[myaddress@example.com]]
    [[myaddress@example.com | email me]]

See also Cookbook:EProtect for information on protecting email addresses from spammers.

Q: How do I make a WikiWord link to an external page instead of a WikiPage?

A: Use link markup. There are two formats:

    [[http://www.example.com/ | WikiWord]]
    WikiWord

Q: How do I find all of the pages that link to another page (i.e., backlinks)?

A: Use the link= option of the (:pagelist:) directive, as in

    (:pagelist link=SomePage:)   -- show all links to SomePage
    (:pagelist link={$FullName}:)  -- show all links to the current page
Category /
AlgorithmsImplementations
Category
CommunicationProtocols
ComputerHardware
Cryptography
Databases
FileFormats
LawLegal
LinuxPlatform
Programming
RecentChanges
Virtualization
WebDesign
WindowsPlatform
Main /
Access
ASPKeywords
BiosBeepCodes
BitAndNumberManipulation
BrandsProducersAndMergers
BuildTools
Categories
CategoryList
CharSets
ChecksumsBarcodes
ClosuresAndDelegates
CompleteBooleanEvaluation
ConvertWithStyle
CSharpAttributes
CSharpClasses
CSharpExceptions
CSSResetter
DataTypes
DirectShow
FalseExpressions
FileMaker
GeneralProgrammingTechniques
HMAC
HomePage
HTML4
HtmlBodyElements
HtmlComments
HtmlFormElements
HTMLForms
HtmlFramesetElements
HtmlHeadElements
HtmlRareElements
HtmlScriptElements
HtmlStyleElements
HtmlTableElements
HtmlVcard
HttpP3p
IRBT
JavaScript
JavascriptPerformance
JSDOM
JsEvents
JsLibraries
NetworkProgramming
PHPTricks
PHPVersions
PlatformIndependentProgramming
RAS-DUN
RecentChanges
SMTPProtocol
SqlDups
SqlNulls
SSIKeywords
TableOfOperations
VMware
WikiSandbox
WindowsADErrors
WindowsCompatibility
WindowsDCandAD
WindowsDCRolesAndFunctions
WindowsErrors
WindowsMultimedia
WindowsRegistry
WindowsReleasesAndLimits
WindowsRoamingProfiles
WindowsSvcAndRegistrySettings
WindowsTricksAndCmdLineSwitches
ZPC
PmWiki /
AccessKeys
Audiences
AuthUser
AvailableActions
BackupAndRestore
BasicEditing
BasicVariables
Categories
ChangeLog
ChangesFromPmWiki1
ConditionalMarkup
Contributors
CreatingNewPages
CustomInterMap
CustomMarkup
CustomWikiStyles
DebugVariables
DeletingPages
DesignNotes
DocumentationIndex
EditVariables
FAQ
FilePermissions
FmtPageName
Functions
Glossary
GroupHeader
GroupHeaders
I18nVariables
Images
IncludeOtherPages
InitialSetupTasks
Installation
InterMap
Internationalizations
LayoutVariables
Links
LinkVariables
LocalCustomizations
MailingLists
MailPosts
MarkupMasterIndex
Notify
OtherVariables
PageDirectives
PageFileFormat
PageHistory
PageLists
PagelistVariables
PageVariables
Passwords
PasswordsAdmin
PathVariables
PatrickMichaud
PerGroupCustomizations
PmWiki
PmWikiPhilosophy
RecentChanges
RefCount
ReleaseNotes
Requirements
Security
SecurityVariables
SimultaneousEdits
SitePreferences
Skins
SkinTemplates
SpecialCharacters
TableDirectives
Tables
TextFormattingRules
Troubleshooting
Upgrades
UpgradingFromPmWiki1
Uploads
UploadsAdmin
UploadVariables
UrlApprovals
Variables
WebFeeds
WikiAdministrator
WikiFarms
WikiFarmTerminology
WikiGroup
WikiGroups
WikiPage
WikiSandbox
WikiStructure
WikiStyleExamples
WikiStyles
WikiTrails
WikiWikiWeb
WikiWord
WikiWords
Site /
AllRecentChanges
AuthForm
AuthUser
EditForm
EditQuickReference
GroupAttributes
LeanEditForm
LeanXLPage
PageActions
PageListTemplates
PageNotFound
Preferences
RecentChanges
Search
SideBar
Site
UploadQuickReference
Recent Changes (All) | Edit SideBar Page last modified on April 03, 2010, at 07:37 PM Edit Page | Page History
Powered by TechnoloWiki