Differences

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

--- plugin:autotooltip [2020-05-17 05:18] – zioth
+++ plugin:autotooltip [2024-02-11 03:39] (current) – zioth
@@ Line 6: / Line 6: @@
 email      : elifenton@this_is_not_a_real_email.fake
 type       : syntax, helper, action, renderer
-lastupdate : 2020-05-16
+lastupdate : 2024-02-10
-compatible : Greebo
+compatible : Greebo, Hogfather, Igor, Jack Jackrum, Kaos
 depends    :
 conflicts  :
@@ Line 28: / Line 28: @@
 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.
-==== Adding tooltips to every link ====
-This plugin allows you to manually insert tooltips one-by-one, or to generate them automatically for every wikilink on your site (or a subset thereof, limited by namespace).
+==== Automatically turning plain text into links with tooltips ====
-There are three ways to enable this feature:
+Install both this plugin and [[plugin:autolink4|Autolink 4]]. The configuration options for Autolink 4 allow you to specify text or regular expressions, and automatically turn those into links with tooltips.
-  - Go to //Admin// -> //Configuration// -> //Advanced// -> //renderer_xhtml//, and select "Auto-Tooltip."
-  - If you're already using another renderer plugin, install [[plugin:actionrenderer|ActionRenderer]] as your renderer, and the feature should work. This will have slightly worse performance than using the renderer directly.
-  - If neither of those options suits your needs, consider [[plugin:autolink4|Auto-link 4]], which can add tooltips to links that it generates, when installed alongside AutoTooltip.
+==== Adding tooltips to every link on your site, or specific namespaces ====
+If you're already using [[plugin:actionrenderer|ActionRenderer]] as your renderer, this will happen automatically. Otherwise, Go to //Admin// -> //Configuration// -> //Advanced// -> //renderer_xhtml//, and select "Auto-Tooltip." Note that you can only have one custom renderer, so this is not compatible with other renderer plugins.
+You can limit this to specific namespaces or pages using the configuration options.
 You won't see tooltips on self-referential links. In other words, a link to //wiki:whatever// on //wiki:whatever// will not have a tooltip.
@@ Line 42: / Line 45: @@
 ===== Examples/Usage =====
-[[http://zioth.com/dev/dokuwiki/autotooltip|See these examples live.]]
+[[http://zioth.com/dev/dokuwiki/autotooltip|See these examples live]].
+=== Generating tooltip content automatically ===
+  <autott>wiki:syntax</autott>
+This will generate a link to wiki:syntax, using the page's title as the link text. The tooltip will include the page's title and abstract.
+  <autott>wiki:syntax|Custom Title</autott>
+Same as above, but the link text will be "Custom Title."
 === Manual tooltips ===
@@ Line 53: / Line 66: @@
 This creates a simple tooltip for text on the page.
-=== Customizing a tooltip ===
+=== Customizing appearance ===
   <autott style1 style2>...</autott>
@@ Line 72: / Line 85: @@
   <autott picture>...</autott>
-=== Generating a tooltip ===
-  <autott>wiki:syntax</autott>
-This will generate a link to wiki:syntax, using the page's title as the link text. The tooltip will include the page's title and abstract.
-  <autott>wiki:syntax|Custom Title</autott>
-Same as above, but the link text will be "Custom Title."