====== konsole Plugin ======

---- plugin ----
description: Konsole look like terminal, with bash syntax highlight
author     : Fabrice DEJAIGHER
email      : fabrice@chtiland.com
type       : syntax
lastupdate : 2016-05-15
compatible : Greebo, Hogfather, Igor, Jack Jackrum
depends    : 
conflicts  : 
similar    :  xterm, xterm2, cli
tags       : formatting, terminal, syntaxhighlight

downloadurl: https://github.com/chtiland/dokuwiki_plugin_konsole/archive/master.zip
bugtracker : https://github.com/chtiland/dokuwiki_plugin_konsole/issues
sourcerepo : https://github.com/chtiland/dokuwiki_plugin_konsole
donationurl: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=9WKZNAQ46U7G6&lc=FR&currency_code=EUR&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted

screenshot_img : https://www.chtiland.fr/contribs/dokuwiki/plugins/konsole/konsole_user.png
----

This is my first published plugin I developed for a website in project, so it could have some bugs, mistakes, but I tried it on two DokuWiki, and this one seems to work fine.

===== Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

===== Examples/Usage =====

**User Konsole:**

  <konsole> ... </konsole>

{{https://www.chtiland.fr/contribs/dokuwiki/plugins/konsole/konsole_user.png?recache}}


**Root Konsole:**

  <konsole root> ... </konsole>

{{https://www.chtiland.fr/contribs/dokuwiki/plugins/konsole/konsole_root.png?recache}}

**There's also a little toolbar:**

{{https://www.chtiland.fr/contribs/dokuwiki/plugins/konsole/konsole_toolbar.png?recache}}


===== Change Log =====

  * **2015-05-15**
    * Bootstrap 3 Compatibility [[https://github.com/chtiland/dokuwiki_plugin_konsole/issues/10|Issue]]
    * Few little corrections
  * **2015-07-25**
    * Translations update.
  * **2014-05-16**
    * Compatibility check
    * New translations: ja, nl, de (Thanks to translators ;-))
  * **2012-02-01**
    * Initial release

===== ToDo/Wish List =====

  * Plugin in french and English((Report any mistake ;-) )), so other translations are welcome! ;-)
  * Only Linux bash highlighting, DOS commands will be soon available.
  * Ability to add personal keywords.
  * Adding new style for terminal, Windows, MacOS.

===== Discussion =====

> Would be nice if there was control of the height, I have two commands and it takes up about 50 lines. I rather it have it take 2 lines.

>> You can change the height in style.css.

>>> Wolud be nice, if heigth and width are dynamic parameters e.g. <code><konsole 600 300> ... </konsole></code> do you think that is possible?

>>>>I second a request for this dynamic resizing, it is clunky without.

> The wiki syntax works inside the <koncole> tags, can you disable that please?

>> The wiki syntax inside the <konsole> tags is wonderful, if you want to highlight interaction inside a konsole session or mark some important output.\\
>> If you want to disable the wiki syntax, then the konsole plugin should understand and you could use the normal [[:wiki:syntax#no_formatting|No Formatting wiki syntax]], eg. **''<nowiki>%%</nowiki>''** or **''%%<nowiki>your konsole output</nowiki>%%''** inside the <konsole> tags. This should be the same like working with the [[:plugin:xterm|xterm plugin]]\\
>> Something like:
  <konsole>
  linux1:~ # **cd /etc**
  linux1:/etc # **cat /etc/SuSE-release** %%
  SUSE LINUX 10.1 (X86-64)
  VERSION = 10.1 %%
  linux1:/etc # **ls apache2** <nowiki>
  .htpasswd            errors.conf       listen.conf
  charset.conv         extra             magic
  conf.d               httpd.conf        mime.types
  default-server.conf  httpd.conf.local  mod_autoindex-defaults.conf </nowiki>
  linux1:/etc #
  </konsole>

 --- [[user>kirbach|kirbach]] //2012/07/16 16:07// 

Thanks to [[user>kirbach|kirbach]] for this really nice answer :-)  --- [[user>Chtiland|chtiland]]

> Printing a page does not render correctky the <konsole> tag

>> I also encountered this problem, this should work by activating "printing background images" in browser options but can't make it work too (Tried Firefox, Chrome and Opera) still investigating ;-)  --- [[user>Chtiland|chtiland]] //2014/01/03 13:04//