Differences

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

--- plugin:htmlabstract [2010-07-22 22:47] – [User feedback] - fuckin' smiley! 84.101.192.244
+++ plugin:htmlabstract [2024-02-08 09:56] (current) – Aleksandr
@@ Line 1: / Line 1: @@
-====== HtmlAbstract plugin ======
+====== HtmlAbstract Plugin ======
 ---- plugin ----
-description: Integrates any DokuWiki RSS feed with HTML formatted abstracts.
+description: Integrates any DokuWiki RSS feed with HTML formatted abstracts
 author     : Vincent Feltz
 email      : psycho@feltzv.fr
 type       : syntax
-lastupdate : 2010-07-22
+lastupdate : 2016-11-07
-compatible : >= 2009-02-14b
+compatible : 2009-02-14
 depends    :
 conflicts  :
 similar    :
-tags       : rss, abstract, html
+tags       : rss, abstract, html, feed
+downloadurl: http://xchange.feltzv.fr/doku/htmlabstract.tgz
 ----
 ===== Download and Installation =====
-Here are the last version links :
-  * [[http://www.feltzv.fr/xchange/doku_plugins/htmlabstract.zip| .zip]] package
-  -  Install the plugin :
+  -  Install the plugin:
-    * Automatically : use the [[plugin:plugin|Plugin Manager]].
+    * Automatically: Search and install the plugin using the [[plugin:extension|Extension Manager]].
-    * Manually : unzip archive directly in ''lib/plugins/'' directory.
+    * Manually: Refer to [[:Plugins]] on how to install plugins manually.
   -  That's done! Now you can configure it using the configuration page.
-\\
-PS (2009/11/29): I cleaned my ant rules for building packages, sorry for those who maybe had odd files in zip or tgz...
 ===== Syntax =====
   {{htmlabs><feed_url>[&feed=options] [integration options]}}
 ==== Feed URL (mandatory) ====
   * ''feed.php'' will work with the local RSS feed of the wiki being modified
-  * ''http://any_site.com/dokuwiki/feed.php'' will work with any DokuWiki-generated RSS feed.
+  * ''%%http://any_site.com/dokuwiki/feed.php%%'' will work with any DokuWiki-generated RSS feed.
 ==== Feed options ====
-This plugin is made for to work with the ''feed.php'' file available in the DokuWiki package, so most of options which are available for this feed are available for htmlabstract plugin too, except ''content'' option, which is automatically set to HTML, and ''type'' which is set to RSS 2.0 .\\
-These options (linkto, mode, num, minor) and their description are viewable on [[:syndication| this page]].\\
+This plugin is made for to work with the ''feed.php'' file available in the DokuWiki package, so most of options which are available for this feed are available for htmlabstract plugin too, except ''content'' option, which is automatically set to HTML, and ''type'' which is set to RSS 2.0.
-**Note :** these options must be separated by the ''&'' sign, and set with ''='' sign, like in URL schemes.
+These options (linkto, mode, num, minor) and their description are viewable on [[:syndication| this page]].
+**Note:** these options must be separated by the ''&'' sign, and set with ''='' sign, like in URL schemes.
 ==== Integration options ====
 By default, the feed will be integrated including
   * the title of the page as a link to the diff table (or whatever you configured using feed options)
   * the author of modifications
   * the date of the modifications
-If you want to skip one of these details, just add one of the following options :
+If you want to skip one of these details, just add one of the following options:
   * ''notitle'' (A link to the page will still append at the end of the preview)
   * ''noauthor''
@@ Line 48: / Line 52: @@
 ==== Plugin options ====
 These options are available in the config page.
-  * ''paragraph'' : if enabled, htmlabstract will try to cut the abstract at the end of a paragraph, instead of the middle of a sentence / word
+  * ''paragraph'' -- if enabled, htmlabstract will try to cut the abstract at the end of a paragraph, instead of the middle of a sentence/word
-  * ''maxlength'' : maximal length of the abstract's text
+  * ''maxlength'' -- maximal length of the abstract's text
-  * ''textlink''  : the text to be put at the end of abstracts as a link to the page
+  * ''textlink'' -- the text to be put at the end of abstracts as a link to the page
-  * ''bg_color''  : background color for abstracts
+  * ''bg_color'' -- background color for abstracts
 ===== Examples =====
   {{htmlabs>feed.php?num=42&ns=misc notitle noauthor}}
 will integrate the 42 last modifications in the namespace ''misc'', displaying the date of modification for each item.
   {{htmlabs>feed.php?minor=1 nodate}}
 will integrate the ''x'' last modifications, including minor changes, and displaying the page's title and the author of the modification for each item. (''x'' being what you configured for your DokuWiki.)
 ===== Demo =====
-A demonstration with different settings is available on [[http://www.dokutek.fr/doku.php?id=misc:demo_plugin|http://www.dokutek.fr/]].
+Please feel free to add your own links if you use it! ;-)
 ===== Changelog =====
+__**2016/11/07**__
+  * Fixed date info in plugin description to fix a permanent update warning.
+__**2011/07/10**__
+  * Resurrected download link thanks to Håkan Sandell who sent me a saved package of my lost code.
+  * Fixed date display problem.
+__**2010/07/23**__
+  * Fixed some bugs for W3C compliance. :!:**Be careful** : the __integration__ of previews in the DW page is W3C compliant, but it's yours to check that the pages you want to integrate are OK!
 __**2010/07/22**__ From suggestions by ''Vincent Fleury'' :
   * HtmlAbstract was severely revised, and doesn't add a feed builder anymore. This way, it shouldn't create RSS event conflicts!
@@ Line 84: / Line 105: @@
 ===== Nota Bene =====
 Don't hesitate to post feedback (or to mail me if I don't seem to notice your remarks), and to post links to pages where this plugin is used! It's particularly motivating for enhancement! =) \\
 And don't forget to use [[:plugin:popularity|popularity plugin]]! ;-)
@@ Line 89: / Line 111: @@
 ===== User feedback =====
+>**Bug**:
->** Bug ** :\\
 > cache file from htmlabstract's feed is in conflict with the usual DokuWiki feed
 >
->**Fixes : **\\
+>**Fixes: **
 >in feed.php change
 ><code>