Differences

This shows you the differences between two versions of the page.

--- plugin:dwinsect [2012-08-13 19:11] – [Examples/Usage] 94.216.49.20
+++ plugin:dwinsect [2018-05-30 21:59] (current) – [Installation] Klap-in
@@ Line 6: / Line 6: @@
 email      : dietrich.wittenberg@online.de
 type       : syntax, action
-lastupdate : 2012-08-11
+lastupdate : 2013-06-29
 compatible : 2012-01-25 "Angua"
-depends    :
+depends    : dwtools
 conflicts  :
 similar    : embed, include
-tags       : links, include, footnote
+tags       : links, include, footnotes
-downloadurl: http://github.com/dwittenb/dokuwiki-plugin-dwinsect/zipball/master
+downloadurl: https://github.com/dwittenb/dokuwiki-plugin-dwinsect/zipball/master
-bugtracker : http://github.com/dwittenb/dokuwiki-plugin-dwinsect/issues
+bugtracker : https://github.com/dwittenb/dokuwiki-plugin-dwinsect/issues
-sourcerepo : http://github.com/dwittenb/dokuwiki-plugin-dwinsect/
+sourcerepo : https://github.com/dwittenb/dokuwiki-plugin-dwinsect/
 donationurl:
 ----
 ===== Installation =====
-Install the plugin using the [[plugin:plugin|Plugin Manager]] and the download URL above, which points to latest version of the plugin. Refer to [[:Plugins]] on how to install plugins manually.
+Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually. Take care that the directory-name of the plugin is: ''dwinsect''
-:!: 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)
 ===== Purpose of this plugin =====
 ==== Basic purpose of DWinsect plugin ====
-With DW**insect** plugin you can easy **in**clude a **sect**ion of a page. \\
+With DW**insect** plugin you can easy **in**clude a **sect**ion of a page in two different ways: \\
-A section of a page is included in two different ways:
   - Include the whole section as it is (Headline, and section - text)
@@ Line 52: / Line 51: @@
 ^syntax  ^description                            ^usage    ^default value ^
 |''%%[*(%%'' |open-syntax                            |needed   | |
-|ns:     | any valid namespace                   |optional |[[#namespace-default]] |
+|ns:         | any valid namespace                   |optional |[[#namespace-default]] |
-|page    | any pagename in the namespace         |optional |default value can be set in the configuration page |
+|page        | any pagename in the namespace         |optional |default value can be set in the configuration page |
-|#       | delimiter                             |optional |needed if a namespace or pagename is used to seperate ns:page from anchor |
+|#           | delimiter                             |optional |needed if a namespace or pagename is used to seperate ns:page from anchor |
 |[[#anchor-syntax|anchor]] | name of the dokuwiki headline    |needed   | |
-|?       | delimiter                             |optional |needed if anchor parameters are used to seperate anchor from aparams|
+|?           | delimiter                             |optional |needed if anchor parameters are used to seperate anchor from aparams|
 |[[#aparams-syntax|aparams]] | anchor-parameters |optional |default value can be set in the configuration page |
 |[[#lparams-syntax|lparams]] | link-parameters   |optional |by default the link-parameter of the favorite link is used |
@@ Line 81: / Line 80: @@
 === lparams-Syntax ===
-Each valid value that is allowed in dokuwiki-links after the "|" or in media-links after the "?".
+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 50x200.
 With the aparams you can decide if the original or the DWinsect parameters are used.
@@ Line 98: / Line 98: @@
 You can try Yahoo too, but [[http://www.yahoo.de|this is not GOOGLE.]]Yahoo is another search engine.
 </code>
+=== Examples using the parameter link = translate with different lparams===
+^DWinsect - syntax                    ^Result                                              ^description                ^
+|''%%[*(Yahoo Deutschland)]%%''       |''%%[[http://www.yahoo.de|this is not GOOGLE.]]%%'' |use original linktext      |
+|''%%[*(Yahoo Deutschland|)]%%''      |''%%[[http://www.yahoo.de]]%%''                     |clear  linktext            |
+|''%%[*(Yahoo Deutschland| )]%%''     |''%%[[http://www.yahoo.de|Yahoo Deutschland]]%%''   |change linktext to headline|
+|''%%[*(Yahoo Deutschland|YAHOO)]%%'' |''%%[[http://www.yahoo.de|YAHOO]]%%''               |change linktext as defined |
 === Examples for using DWinsect ===
@@ Line 128: / Line 136: @@
 ===== ToDo/Wish List =====
+:-( There is a bug when usin the syntax inside a list:
-nothing to do yet.
+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:
+  * [[http://dokuwiki.org/plugin:dwinsect|test]]((Text before link))((Text after link))
+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.
 ===== FAQ =====
@@ Line 135: / Line 163: @@
 yet emty.
+===== Other Plugins =====
+  * [[plugin:dwinsect]]
+  * [[plugin: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.
+  * [[plugin:dwspecialist]]
+  * [[plugin:dwstatistic]] great Plugin to track and view page-access. comming soon :!:
+  * [[plugin:dwchart]] great Plugin to create Charts. comming soon :!: