Differences

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

--- plugin:creole [2016-04-29 19:01] – Adjusted author/email LarsDW223
+++ plugin:creole [2024-04-22 03:42] (current) – Added Kaos compatibility 2001:9e8:5ccd:7d00:b9e0:f457:42be:a6c4
@@ Line 6: / Line 6: @@
 email      : freaks@dokuwiki.org
 type       : syntax
-lastupdate : 2015-08-08
+lastupdate : 2020-12-13
-compatible : 2010-11-07, 2011-05-25, 2011-11-10, 2012-01-25, 2012-10-13, 2013-05-10, 2013-12-08, 2014-05-05, 2014-09-29, 2015-08-10
+compatible : !Frusterick Manners, !Greebo, Hogfather, Igor, Jack Jackrum, Kaos
 depends    :
 conflicts  :
@@ Line 18: / Line 18: @@
 ----
-Download:
-  * [[https://github.com/dokufreaks/plugin-creole/zipball/master|Current Version]] (for DokuWiki Versions starting from 2010-11-07)
-  * [[http://www.chimeric.de/_src/plugin-creole.tgz|Version 2008-02-12]] (for DokuWiki Versions 2006-11-06 to 2009-12-25c)
 ===== Description =====
-[[http://www.wikicreole.org/|Creole]] is an initiative to bring a common basic set of wiki markup to different wiki engines. The [[http://www.wikicreole.org/wiki/Creole0.3|Creole 0.3 Specs]] (2006-12-19) are very close to the [[:wiki:syntax]] used by DokuWiki. Only those elements differ:
+[[http://www.wikicreole.org/|Creole]] is an initiative to bring a common basic set of wiki markup to different wiki engines. The [[http://www.wikicreole.org/wiki/Creole1.0|Creole 1.0 Specs]] (2007-07-04) are very close to the [[:wiki:syntax]] used by DokuWiki. Only those elements differ:
   * [[#Listblock]]
@@ Line 34: / Line 31: @@
   * [[#Monospace]] (since Creole 1.0, see http://www.wikicreole.org/wiki/CreoleAdditions)
-This [[plugins|Plugin]] will interpret Creole elements that are not understood by DokuWiki. If the markup collides (as with the header level order), by default DokuWiki's standard markup takes precedence.((You can change the markup precedence to Creole with the [[:config]] manager, if you want full Creole support.)) With the exception of the changed behaviour for linebreaks, all your existing wiki pages will look the same.
+This plugin will interpret Creole elements that are not understood by DokuWiki. If the markup collides (as with the header level order), by default DokuWiki's standard markup takes precedence.((You can change the markup precedence to Creole with the [[:config]] manager, if you want full Creole support.)) With the exception of the changed behaviour for linebreaks, all your existing wiki pages will look the same.
 If you use this plugin to support the Creole syntax, you might want to list your wiki at http://www.wikicreole.org/wiki/WikisSupportingCreole
-This plugin originally matched the Creole 0.3 specification. It is now "under construction" to move to the [[http://www.wikicreole.org/wiki/Creole1.0|Creole 1.0 specification]].
 ===== Installation =====
@@ Line 44: / Line 39: @@
 To install the Creole plugin
-  * Go to the Admin page and then Extension Manager
+  * Go to the Admin page and then [[plugin:extension|Extension Manager]]
   * Search for the plugin "Creole" at the ''Search and Install'' tab
   * Use the ''Install'' button
@@ Line 50: / Line 45: @@
 In the Configuration Settings you can change the Markup precedence over the DokuWiki syntax if you like.
+:!: Since release 2020-08-21 the creole plugin is incompatible with DokuWiki release Greebo and the releases before it. If you are using DokuWiki releases before Hogfather then the latest compatible release is [[https://github.com/dokufreaks/plugin-creole/archive/2019-02-06.zip|2019-02-06]]. :!:
 ===== Components =====
@@ Line 254: / Line 249: @@
 >>>> The original file is overwritten, a backup is made to oldname.BAK.
 >>>> If you want to convert a single file, just type ''perl revheaders FILENAME''. To rename a whole directory, go to the base of it and type ''find . -regex '.*txt' | xargs perl revheaders''. That will convert all .txt-files in this and all subsequent folders. If you want to undo your changes, just run the script again with the same file(s). It's especially useful to mass rename the built-in wiki pages in ''/inc/lang/''.  --- //[[unixprog@gmail.com|konstantin baierer]] 2007-03-31 22:27//
+I couldn't resist re-writing that Perl script into a one-liner command (for Mac or Linux - Windows would need different quoting) with a single regex. Admittedly, it's less readable than Konstantin's script, but I like the single formula to revert the number of "''=''". The ''-i.bak'' option makes it do the replacements in-place, saving the original with a .bak extension.
+<code bash>
+perl -i.bak -pe 's/^(={2,6})(.*?)\1/"="x(2+abs(length($1)-6)).$2/e' YOUR_ORIGINAL_FILE.txt
+</code>
+To do it on a whole folder (but be sure to be in the right folder!):
+<code bash>
+perl -i.bak -pe 's/^(={2,6})(.*?)\1/"="x(2+abs(length($1)-6)).$2/e' *.txt
+</code>
+Or by searching, also in subfolders:
+<code bash>
+find /path/to/wiki/data/pages -type f -name "*.txt" -exec perl -i.bak -pe 's/^(={2,6})(.*?)\1/"="x(2+abs(length($1)-6)).$2/e' "{}" \;
+</code>
+--- [[user>Albert25|Albert25]] //2019-09-24 18:24//
 Thank you, for this very nice plugin.  --- //[[dokuwiki@companje.nl|Rick Companje]] 2007-12-20 17:52//