[[PageOutline(2-5,Contents,pullout)]]

= Code Wiki Processor

== Description

This plugin provides a [wiki:WikiProcessors wiki processor] for code listing that uses file extensions for language detection rather than mimetypes. Normally you would - for [wiki:WikiProcessors#CodeHighlightingSupport more "exotic"] programming languages - have to specify the mimetype for a codelisting, like this:

{{{
{{{
#!text/css
div.lang-name-template {
  margin: -1em 1.75em 1em 1.75em;
  background: #F7F7F7;
  text-align: right;
  padding-right: 0.5em;
  border-style: solid;
  border-color: #D7D7D7;
  border-width: 0 1px 1px 1px;
}
}}}
}}}

Since mimetypes are often hard to remember (is it `text/...` or `application/...`?) and you have to dig to find the actual mimetype of a certain programming language this wiki processor addresses this problem. You only have to specify the ''file extension'' of the programming language. To specify to code block above using this plugin simply write:

{{{
{{{
#!code(lang=css)
div.lang-name-template {
  margin: -1em 1.75em 1em 1.75em;
  background: #F7F7F7;
  text-align: right;
  padding-right: 0.5em;
  border-style: solid;
  border-color: #D7D7D7;
  border-width: 0 1px 1px 1px;
}
}}}
}}}

This results in:

[[Image(screenshot.png)]]

'''Note:''' Some "programming languages" (such as Apache config files) may be supported by the installed syntax highlighting tool (such as Pygments) but not be supported by Trac. This plugin adds support for those less frequently used languages.

As a bonus the programming language is displayed in the lower right corner of the listing. This way a reader can easily identify the language the listing is written in.

== Source and Tickets

You'll find all information about this ticket [https://svn.mayastudios.de/mtpp/wiki/Plugins/CodeProcessor here]. Please file only tickets there.

== Author/Contributors

'''Author:''' [wiki:manski Sebastian Krysmanski] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''