Differences

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

--- plugin:commentsyntax [2015-04-18 09:28] – new release s.sahara
+++ plugin:commentsyntax [2019-11-28 14:29] – similar to the wrap plugin Aleksandr
@@ Line 2: / Line 2: @@
 ---- plugin ----
-description: Comment Syntax for DokuWiki.
+description: Allow to use source comment syntax to leave edit instructions of the page. Comments are visible only in the source view, not rendered as any page elements.
-author     : S.Sahara
+author     : Satoshi Sahara
 email      : sahara.satoshi@gmail.com
 type       : syntax
-lastupdate : 2015-04-17
+lastupdate : 2019-11-28
-compatible : Ponder Stibbons, Hrun
+compatible : Ponder Stibbons, Hrun, Detritus, Elenor Of Tsort, Frusterick Manners, Greebo+
 depends    :
 conflicts  :
-similar    : comment, commentsrc
+similar    : comment, commentsrc, wrap
 tags       : comment
@@ Line 24: / Line 24: @@
 ===== Installation =====
-Install the plugin through the [[plugin:extension|Extension Manager]] or [[plugin:plugin|Plugin Manager]] using the download URL above, which points to latest version of the plugin. Refer to [[:plugin_installation_instructions|plugin installation instructions]].
+Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
 ===== Feature =====
@@ Line 57: / Line 57: @@
 ==== 2. one-line comment ====
-The "one-line" comment syntax will be available if the ''use_oneline_style'' option is enabled (default off). The use of //italic// formatting markup ''%%//...//%%'' restricted so that it can not go over next line.
+The "one-line" comment syntax will be available if the ''use_oneline_style'' option is enabled (default off).
 <file>
   * non-ordered list item // comment
@@ Line 71: / Line 71: @@
   - item 1
   - item 3
+:!: **Adverse effect:** The one-line comment syntax ''%%//%%'' may interfere with the markup for //italics//. The use of //italic// formatting markup ''%%//...//%%'' will be restricted so that it can not go over next line.
+<file>
+This text //in italics.
+is rendered as normal // due to broken double-slash pairs
+</file>
+This text is rendered as normal
 ==== 3. Control Macro like Comments ====
@@ Line 98: / Line 106: @@
 |[[plugin:comment]]         | substition |special pattern |''%%^/\*.*?\*|\s+/\*.*?\*/%%'' |
 |[[plugin:commentsrc]]      | substition |special pattern |''%%!-.*-!%%''  |
-|commentsyntax   | protected   |entry pattern   |''%%\s/\*(?=.*?\*/)%%''  |
+|commentsyntax   | protected   |entry pattern   |''%%[ \t]*\n?/\*(?=.*?\*/)%%''  |
 | :::            | :::         |exit pattern    |''%%\*/%%''              |
 | :::            | substition  |special pattern |''%%\s//(?:[^/\n]*|[^/\n]*/[^/\n]*)(?=\n)%%''  |
-| :::            | substition  |special pattern |''%%~~\B.*?~~%%''  |
+| :::            | substition  |special pattern |''%%~~[^\r\n]+?~~%%''  |
@@ Line 110: / Line 118: @@
 ===== Discussion =====
+Is there plans to fix the current issues?
+> Which issues? There are none listed here nor in the bug tracker. --- [[user>ach|Anika Henke]] //2016-07-31 15:42//