Module:Sandbox/Wnt/WikiLink

Module documentation[view] [edit] [history] [purge]

This module is invoked by {{#invoke:WikiLink|function|parameters}}.

Functions

The functions that can be invoked are:

• dewiki: converts [[Link]] to Link, [[Link|Text]] to Text.

• keepfile: Use before dewiki (i.e. {{#invoke:WikiLink|main|function=keepfile dewiki|text}}) to preserve images from being turned into text. Otherwise images become the alt= text or, if that is lacking, whatever is in the last field of the [[File:|]] or [[Image:|]] block.

• delink: converts [http://Link Text] to Text.
• wikiall: converts "Sequence of words" to [[Sequence]] [[of]] [[words]]
• wikiline: also converts a sequence of words to wikilinks, but all words on one line of text end up as a single wikilink. Note that a single line break will be taken out in the display (all the words will appear on one line) but still counts for purposes of grouping which words become one link.
• main: does nothing by itself. For this and all functions, component words of the parameter function will be applied afterward.

Parameters

• function=: allows the specification of multiple functions, which are done in order after the function specified (not that the order should usually matter...). Thus {{#invoke:WikiLink|dewiki|function=delink|text}} will first dewiki, then delink the text.
• nowiki=: anything nonblank leads to the <nowiki> tag enclosing the output.
• text=: the text to process. It may be convenient to #invoke Module:Page to generate this in some cases. The text= parameter must be used if your text might have an = in it - otherwise it will be interpreted as the name and value of some long and unused parameter.

Bugs

• Note that a stray "[[" will prevent interpretation of the module call if it is written in the #invoke directly; however this does not happen if it is transcluded.

The above documentation is transcluded from Module:Sandbox/Wnt/WikiLink/doc. (edit | history)
Editors can experiment in this module's sandbox (create | mirror) and testcases (edit) pages.
Subpages of this module.

 ---- This module is meant to be processed by putting "{{#invoke:WikiLinkEverything|main}}" into an existing page of flat text to deliver all Wikilinked text (nowiki) for you to copy and paste.  For starting a new page from a Special: index that you can't directly access for example, or a list of place names most of which should exist etc.

local p = {}

function p.main(frame)
   local page=mw.title.getCurrentTitle() --- in the long run this cheesy tactic won't fly - I should rewrite as a proper module and recommend Module:Page invocation in the #invoke instead.
   if page then input=page.getContent(page) else return "error didn't get the page contents :(" end
   input=mw.ustring.gsub(input,"{{#invoke:WikiLinkEverything|main}}","") --we don't want loops, etc.
   input=mw.ustring.gsub(input,"(%S+)","[[%1]]")
   return frame.preprocess(frame, "<nowiki>" .. input .. "</nowiki>")
end

function p.dewiki(frame)
   local args=frame.args
   local parent=frame.getParent(frame)
   if parent then pargs=parent.args else pargs={} end
   local text=args.text or args[1] or pargs.text or pargs[1] or ""
   local nowiki=args.nowiki or pargs.nowiki
   text=mw.ustring.gsub(text,"%[%[([^[]-)%]%]","%1")
   if nowiki then text="<nowiki>" .. text .. "</nowiki>" end
   return frame.preprocess(frame,text)
end

return p

-- I wonder if there's a way to put this directly back into an open edit window...