Differences

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

--- plugin:codeprettify [2018-03-21 10:13] – description of nolinenums option s.sahara
+++ plugin:codeprettify [2023-12-04 19:42] (current) – [Installation] 2607:f8d8:2:1:dda3:ffb:6ae1:ebca
@@ Line 2: / Line 2: @@
 ---- plugin ----
-description: syntax highlighting of source code snippets in wiki page using google-code-prettify (javascript module with CSS files)
+description: Syntax highlighting of source code snippets in wiki page using google-code-prettify (javascript module with CSS files)
 author     : s.sahara
 email      : sahara.satoshi@gmail.com
 type       : syntax
-lastupdate : 2017-11-05
+lastupdate : 2019-09-29
-compatible : Hrun, 2015-08-10, 2016-06-26, 2017-02-19
+compatible : 2015-08-10, 2016-06-26, 2017-02-19, 2018-04-22a
 depends    :
 conflicts  :
@@ Line 23: / Line 23: @@
 ===== 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]].
+Require PHP 7.0.x or later!
+Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:plugin_installation_instructions|plugin installation instructions]].
 Note: After updated to 2015-09-12 release, you can remove older "google-code-prettify" subfolder in this plugin directory.
+<Code:txt>
+Test of text
+</Code>
+<Code:css>
+<style> hello </style>
+</Code>
 ===== Feature =====
@@ Line 33: / Line 43: @@
   * You can configure Code Prettifier plugin to override DokuWiki built-in syntax ''%%<code>%%'' for code blocks.
   * you may use skin (css file) for code block.
 ===== Examples/Usage =====
   * Enclose code snippets using ''%%<Code>%%'' and ''%%</Code>%%'' tag to show it //pretty-printed// in wiki page.
   * Prettify module makes a best effort to guess the language but works best with C-like and HTML-like languages.
-  * To specify language hint for Prettify, you can use \\ 1) ''%%<Code:ext>%%'' (file extension, you must put it just after "Code:" keyword) or \\ 2) ''%%<Code lang-ext>%%'' option.
+  * To specify language hint for Prettify, you can use
+    - ''%%<Code:ext>%%'' (file extension, you must put it just after "Code:" keyword)
+    - ''%%<Code lang-ext>%%'' option
   * For example, use ''%%<Code:css>%%'' or ''%%<Code lang-css>%%'' to specify that the code is Cascading Style Sheets (CSS).
   * use ''linenums'' or ''nolinenums'' option to turn on/off line numbering. You can add a colon and the number to the end of the option, eg. ''linenums:12'' to specify start line number.
-  * If you want to add title for code block, you can specify it after ''|'' that will be shown just above the code box.
+  * If you want to add title for code block, you can specify it after ''%%|%%'' that will be shown just above the code box.
@@ Line 87: / Line 97: @@
 === Change Log from github repository ===
 {{rss>https://github.com/ssahara/dw-plugin-codeprettify/commits/master.atom date 5}}
 === ToDo/Wish List ===
   * Collapse/Expand Code Feature
   * follow recent updates of [[https://github.com/google/code-prettify|Japascript code prettifier]] project
 ===== FAQ =====
 ==== Non-highlight code block ====
 use ''%%<Code:none>%%'' or ''%%<Code lang-none>%%'' to prevent highlight code. Maybe useful to show error log output or console output.
   <Code:none>
   This is not any kind of code.
+  </Code>
+==== Geshi options in DowkuWiki ====
+DowkuWiki suppports some [[:syntax_highlighting|additional Geshi options]] for syntax highlighting
+since its 2018-04-22 release (Greebo). The extra Geshi options are to be specified inside ''['' and '']''.
+The code prettifier plugin should also recognize them, and following example will work fine for both DokuWiki original syntax and code prettifier plugin (except ''%%<code>%%'' and ''<**__C__**ode>'' markup tag respectively).
+  <Code C [enable_line_numbers=1, start_line_numbers_at=42]>
+  void main () {
+      printf ("Hello World!");
+      exit 0;
+  }
   </Code>
 ===== Known Bugs and Issues =====
-see also: https://github.com/ssahara/dw-plugin-codeprettify/issues
+See also: https://github.com/ssahara/dw-plugin-codeprettify/issues
 ===== Discussion =====