Differences

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

--- plugin:txt2tags [2014-05-19 10:31] – 83.206.38.117
+++ plugin:txt2tags [2018-06-06 00:18] (current) – [Download] Klap-in
@@ Line 1: / Line 1: @@
-====== txt2tags plugin ======
+====== txt2tags Plugin ======
 ---- plugin ----
-description: Parses txt2tags.
+description: Parses txt2tags
 author     : Eric Forgeot, derived from markdownextra plugin by Joonas Pulakka and Jiang Le
 email      :
 type       : syntax
-lastupdate : 2014-05-18
+lastupdate : 2014-05-19
 compatible : Adora Belle, Weatherwax, Binky, Ponder Stibbons
 depends    :
@@ Line 17: / Line 17: @@
 ----
+==== Download ====
-===== Download and Installation =====
+Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually. If installed manually, rename the plugin folder to ''txt2tags''.
-Download and install the plugin using the [[plugin:plugin|Plugin Manager]] using the following URL. Refer to [[:Plugins]] on how to install plugins manually. (hint: copy it into dokuwiki/lib/plugins/)
   * https://bitbucket.org/farvardin/txt2tags-tools/downloads/txt2tags_dokuwiki.zip
@@ Line 30: / Line 28: @@
-You can edit config.t2t located in the txt2tags plugin folder (lib/plugins/txt2tags/) of your dokuwiki installation so you can tweak more your txt2tags rendering.
+==== Installation and usage ====
+=== Txt2tags light users ===
-===== Usage =====
+//(for an occasional usage of txt2tags)//
-If the page name ends with //.t2t// suffix, it gets automatically parsed using txt2tags-php. To use that markup in other pages, the content must be embedded in a txt2tags block. For example:
+By default, if the page name ends with ''.t2t'' suffix, it gets automatically parsed using txt2tags-php.
+To use that txt2tags markup in other pages, the content must be embedded in a ''t2t'' block. For example:
 <code>
-    <t2t>
+<t2t>
-    = Header =
+= Header =
-    ```
+```
-    some code
+some code
-    ```
+```
-    Paragraph
+Paragraph
-    == Header ==
+== Header ==
-    - A
+- A
-    - simple
+- simple
-    - list
+- list
-    + And
++ And
-    + numbered
++ numbered
-    + list
++ list
-    Quite intuitive:
-    //italic//, **strong**, __underlined__, --strike-through-- etc.
-    </t2t>
-</code>
-For complete syntax, refer to http://www.txt2tags.org
+Quite intuitive:
+//italic//, **strong**, __underlined__, --strike-through-- etc.
+</t2t>
+</code>
+For the full syntax, refer to http://www.txt2tags.org
-=== Change Log ===
+=== Txt2tags heavy users ===
+//(enable txt2tags globally)//
-  * **2012-12-11**
+If you want to enable txt2tags for the whole website, just delete or comment in ''action.php'' this line:
-    * Initial release
-  * **2014-05-18**
-    * update with an external t2t file to add more control on the result
+  if(substr($ID,-4) != '.t2t') return true;
-===== Discussion =====
+==== Toolbar ====
-**Feature requests:**
+You may wish to replace ''toolbar.php'' in ''dokuwiki/inc/'' so you'll get a txt2tags-aware toolbar for your dokuwiki installation. For enabling internal link support, you'll also have to replace ''linkwiz.js'' into ''dokuwiki/lib/scripts/''
+You may wish to enable the table creation wizard, to do so, include this just before the </body> tag, at the end of your template main.php file, like this:
+  <script src="lib/plugins/txt2tags/tables.js" type="text/javascript"></script>
-**Bugs:**
+==== Power user usage ====
-It's basically a simple adaptation from the [[plugin:markdownextra]] plugin, using a txt2tags converter instead of the markdown one. While it seems to works well, there might be some glitches. If you find any, please report them on the bug tracker
+You can edit config.t2t located in the txt2tags plugin folder (''lib/plugins/txt2tags/'') of your dokuwiki installation so you can tweak more your txt2tags rendering using regex.
-**Support:**
+==== changelog ====
+  * 2014-05-19: improved toolbar
+  * 2014-05-18: update with an external t2t file to add more control on the result
+  * 2012-12-11: Initial release
-**Notes:**
+==== bugs ====
-This version enables txt2tags markup only on pages which has the .t2t extension. If you want to enable txt2tags for the whole website (some dokuwiki elements in the admin panel, especially titles, can be incorrectly rendered then), just delete or comment in action.php this line:
-   if(substr($ID,-4) != '.t2t') return true;
-In this case, you may wish to replace toolbar.php in dokuwiki/inc/ so you'll get a txt2tags-aware toolbar for your dokuwiki installation.
+It's basically a simple adaptation from the [[plugin:markdownextra]] plugin, using a txt2tags converter instead of the markdown one. While it seems to works well, there might be some glitches. If you find any, please report them on the bug tracker