Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually. Take care that the directory-name of the plugin is: dwinsect

You need the dwtools-library. (look to the end of description where to get it)

With DWinsect plugin you can easy include a section of a page in two different ways:

1. Include the whole section as it is (Headline, and section - text)
2. Include the first link¹⁾ that is found in the section
   and include the text before an after that link as
   1. plain text
   2. a footnote

The main purpose of the DWinsect plugin is to use it like you use your favorite links in your browser.
You can refer to that link everywhere in your dokuwiki. If the link is broken you have to change the link only one time an not everywhere in your dkuwiki.

Thats all you have to do:

1. craete a new page anywhere in your dokuwiki (e.g. name it “favorites” in the namespace “wiki:”)
2. edit the page and insert all your favorite links.
3. add to each link a headline with a symbolic name of the link
4. you can add any text before or after the link as a description (option).
5. use DWinsect-syntax anywhere in your dokuwiki

[*(ns:page#anchor?aparams|lparams)]

The name of the anchor is case sensitive und must match the name of a headline that exists.
The Headline “Google” is differnt to the Headline “google”. If the same headline occurs more than one time, the first hedline is choosen.

name1=value1&name2=value2name3=value3 ...

Each valid value that is allowed in dokuwiki-links after the “|” or in media-links after the “?”. If you want to use named medialinks something like |my named linktext?50x200 creates a name medialink (my named linktext) and changes the parameters to 50×200.

With the aparams you can decide if the original or the DWinsect parameters are used.

If no namespace is given, the plugin searches from the actual namespace looking for the page recursively until root is reached. If no page is found the DWinsect-syntax appears as *(ns:page#anchor?aparams|lparams) with the css used for non existing links (normally red font with a red dotted underline).

e.g.: content of “favorites” in the root

== Google ==
http://www.google.de
Google is a search engine. You can find more at [[http://de.wikipedia.org/wiki/Google|Wikipedia]].

== Yahoo Deutschland ==
You can try Yahoo too, but [[http://www.yahoo.de|this is not GOOGLE.]]Yahoo is another search engine.

Assume the plugin configuration defaults are:

The DWinsect - syntax results are:

DWinsect - syntax	Result	description
[*(Google)]	http://www.google.de	just take the original link
[*(google|GOOGLE)]	*(google|GOOGLE)	case sensitive: headline google is not defined
[*(Google|GOOGLE)]	[[http://www.google.de|GOOGLE]]	change the name of the link to “GOOGLE”
[*(Yahoo Deutschland|YAHOO)]	[[http://www.yahoo.de|YAHOO]]	change the name of the link to “YAHOO”
[*(Yahoo Deutschland?text=footnote|not YAHOO.)]	((You can try Yahoo too, but ))[[http://www.yahoo.de|not YAHOO.]]((Yahoo is another search engine.))	show the text before and after the link as a footnote
[*(Yahoo Deutschland?text=plain|not YAHOO.)]	You can try Yahoo too, but [[http://www.yahoo.de|not YAHOO.]]Yahoo is another search engine.	show the text before and after the link as plain text
[*(Yahoo Deutschland?include=plain|not YAHOO.)]	== Yahoo Deutschland == You can try Yahoo too, but [[http://www.yahoo.de|this is not GOOGLE.]]Yahoo is another search engine.	include the whole section as plain text

You can use the syntax inline. No additional paragraphs are added. The text is shown inside footnote with full dokuwiki-syntax

[preferable GitHub RSS feed or similar]

• 2012-07-01
  • Initial release

There is a bug when usin the syntax inside a list:

If in page links the link-section is defined as:

====Link to dwinsect-plugin====
Text before link
http://dokuwiki.org/plugin:dwinsect
Text after link

and a syntax like this is used:

* [*(links#linkname#Link to dwinsect-plugin|test)]

the output gets to:

• test²⁾³⁾

The text before or after the link, that is rendered as plain text or as a footnote is always placed after the link / url. Using the syntax not in a list works fine.

I am working to patch the bug.

bug fixed now, made several changes to the syntax.php.

yet emty.

• dwinsect
• dwtools
  • downloadurl: https://github.com/dwittenb/dokuwiki-plugin-dwlib/zipball/master
  • some functions that are needed by dwinsect plugin.
  • Installation: Create a directory named: dwtools und copy the lib.php inside it.
• dwspecialist
• dwstatistic great Plugin to track and view page-access. comming soon
• dwchart great Plugin to create Charts. comming soon