#format wiki
#language en
#pragma section-numbers off
#acl IanRiley:read,write,delete,revert,admin All:read
#pragma supplementation-page on

<<TableOfContents>>

= HttpLink =

== Background and rationale ==

MoinMoin inserts internal links as hypertext, either the page name (usually a WikiName) or as alternative text, if provided. This is suitable for pages viewed on-line, but the link is lost in printed or saved pages. For situations where the link needs be retained off-line, displaying the full URL would be an appropriate solution. However, MoinMoin does not currently facilitate the automatic generation of a full URL for pages within the wiki. If links are entered explicitly, there is a risk of link rot and therefore require more maintenance.

== Description ==

!HttpLink is a macro to insert an external link to a local wiki page link for stituations where it would be helpful to show the full URL, such as pages intended to be printed or saved.

!HttpLink replaces spaces in page names with underscores to avoid the space character code (%20) being inserted into the URL, as such codes degrades URL readability.

== Usage ==

=== <<HttpLink(pagename)>> ===

{{{
Argument "pagename" is optional.

<<HttpLink(pagename)>> - inserts an external link to `pagename`, or nothing if the page does not exist.

<<HttpLink>> or << HttpLink()>> - insert an external link to the current page.

}}}

== Examples ==

{{{

<<HttpLink>>

<<HttpLink()>>

<<HttpLink(MoinMoin Matters)>> - Note: space replaced with underscore.

}}}

<<HttpLink>>

<<HttpLink()>>

<<HttpLink(MoinMoin Matters)>> - Note: space replaced with underscore.

== Download & Release Notes ==
|| Download || Release Version || Moin Version || Release Notes ||
|| [[attachment:HttpLink-1.1.py]] || 1.1 || 1.9.2 to 1.9.8 ||  ||

== Copyright ==

 . @copyright: 2014-2015 Ian Riley <ian@riley.asia>

== License ==

GNU GPL, see COPYING for details.

== Known issues and limitations ==

 * None known

-----

 Hits:: <<Hits>>