DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:purplenumbers

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
plugin:purplenumbers [2013-08-28 22:06] Aleksandrplugin:purplenumbers [2024-01-21 01:35] (current) – updated plugin to work again ach
Line 2: Line 2:
  
 ---- plugin ---- ---- plugin ----
-description: Adds "Purple Numbers(granular IDs) and optionally comment links to every block level element.+description: Adds Purple Numbers” (granular IDs) and optionally comment links to every block level element
 author     : Anika Henke author     : Anika Henke
 email      : anika@selfthinker.org email      : anika@selfthinker.org
 type       : render type       : render
-lastupdate : 2012-10-26 +lastupdate : 2024-01-21 
-compatible : 2009-12-25 "Lemming"2010-11-07 "Anteater"2011-05-25 "Rincewind"2012-01-25 "Angua"2012-10-13 "Adora Belle""Weatherwax"+compatible : Lemming, Anteater, Rincewind, Angua, Adora Belle, Weatherwax, Binky, Ponder Stibbons, 2023-04-04
 depends    :  depends    : 
 conflicts  conflicts 
-similar    : +similar    : titlesanchorlink
 tags       : section, links tags       : section, links
  
Line 23: Line 23:
 ===== Download and Installation ===== ===== Download and Installation =====
  
-Download and install the plugin using the [[plugin:plugin|Plugin Manager]] using the URL given above. 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.
  
 ^ :!: After the installation you need to set the [[:config:renderer_xhtml|renderer_xhtml config option]] to ''purplenumbers'' to switch from the core renderer to the purplenumbers renderer.  ^ ^ :!: After the installation you need to set the [[:config:renderer_xhtml|renderer_xhtml config option]] to ''purplenumbers'' to switch from the core renderer to the purplenumbers renderer.  ^
Line 44: Line 44:
     * exclude (i.e. the plugin will only be used on pages excluded in those namespaces which are specified in ''restrictionNS'')     * exclude (i.e. the plugin will only be used on pages excluded in those namespaces which are specified in ''restrictionNS'')
   * **''annotationPage''**: pattern for links to annotation pages (leave empty to disable), this can include certain placeholders (''@PN@'' for just the numeral part of the Purple Number, ''@PNID@'' for the whole ID, ''@ID@'' for the whole page ID including namespaces and ''@PAGE@'' for just the pagename excluding namespaces), e.g. ''annotation:@PAGE@-@PNID@'' on a page like "articlename" with a PNID of "ID5" would result in the page "annotation:articlename-id5" and ''@ID@:note-@PN@'' on a page like "foo:bar:article" with a PN of "1.5:16" would result in "foo:bar:article:note-1_5-16"   * **''annotationPage''**: pattern for links to annotation pages (leave empty to disable), this can include certain placeholders (''@PN@'' for just the numeral part of the Purple Number, ''@PNID@'' for the whole ID, ''@ID@'' for the whole page ID including namespaces and ''@PAGE@'' for just the pagename excluding namespaces), e.g. ''annotation:@PAGE@-@PNID@'' on a page like "articlename" with a PNID of "ID5" would result in the page "annotation:articlename-id5" and ''@ID@:note-@PN@'' on a page like "foo:bar:article" with a PN of "1.5:16" would result in "foo:bar:article:note-1_5-16"
 +  * **''includeStartpage''**: display Purple Numbers on start pages? (makes it possible to exclude PNs on start pages)
  
  
Line 53: Line 54:
 ^ uniqueness = page-wide | ID1.5:16 (id1_5-16)                     | ID75 (id75)                     | ^ uniqueness = page-wide | ID1.5:16 (id1_5-16)                     | ID75 (id75)                     |
 ^ uniqueness = site-wide | wiki:syntax.1.5:16 (wiki-syntax_1_5-16) | wiki:syntax.75 (wiki-syntax_75) | ^ uniqueness = site-wide | wiki:syntax.1.5:16 (wiki-syntax_1_5-16) | wiki:syntax.75 (wiki-syntax_75) |
 +
 +===== Events =====
 +
 +This plugin triggers events when paragraphs are opened and closed, i.e. ''PLUGIN_PURPLENUMBERS_P_OPENED'' and ''PLUGIN_PURPLENUMBERS_P_CLOSED''.
  
 ===== Version history ===== ===== Version history =====
Line 90: Line 95:
 [[user>TotallyInformation|Julian Knight]] 20012-03-23 [[user>TotallyInformation|Julian Knight]] 20012-03-23
  
-> I agree that changing the CSS is the best way to do it. But I would advise against changing the CSS in the plugin, as those changes would be overwritten with an update. Better use [[devel:css#user_styles|user styles]] for that. --- [[user>ach|Anika Henke]] //2013/03/24 16:03//+> I agree that changing the CSS is the best way to do it. But I would advise against changing the CSS in the plugin, as those changes would be overwritten with an update. Better use [[devel:css#user_styles|user styles]] for that. --- [[user>ach|Anika Henke]] //2013/03/24 16:03//  
 + 
 +Hello. I think this plugin has a lot of potential. There's still a great need for fine-grained referncing, as is evidenced by programs like Obsidian, Logseq, and the Streams plugin for TiddlyWiki. Ted Nelson is also still promoting his ideas. 
 + 
 +This plugin, however, falls short on a few fronts. Firstly, it's a real bummer that links break when paragraphs are inserted or rearranged. The comment pages get associated with the wrong paragraphs as well, that's really bad. My request is for a third numbering system to be implemented where every paragraph gets a unique, randomly generated ID which persists. Perhaps anchor links can be inserted into the page code itself, so that they are seen when editing the text, and can be copy/pasted along with the paragraphs when one moves them around. My second request is that the paragraph gets highlighted when clicked, so that it becomes clear what paragraph is being referenced even when the article is too short for scroll operations. --- Antithesis //2022/09/22//
plugin/purplenumbers.1377720360.txt.gz · Last modified: 2013-08-28 22:06 by Aleksandr

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki