meta data for this page
  •  

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
wiki:advanced_user_hints [21 February 2015 15:57] – [Lab notebook / diary] shorter knaak@iqo.uni-hannover.dewiki:advanced_user_hints [26 April 2022 15:03] (current) – [Excel style calculations] more explicit knaak@iqo.uni-hannover.de
Line 1: Line 1:
-====== Advanced editor hints ======+====== Advanced features of the AP Wiki ======
 This page mostly deals with issues specific to the APwiki. For general help on dokuwiki see the [[wiki:syntax|local dokuwiki syntax help]] and/or the [[doku>manual|official manual]]. This page mostly deals with issues specific to the APwiki. For general help on dokuwiki see the [[wiki:syntax|local dokuwiki syntax help]] and/or the [[doku>manual|official manual]].
  
Line 61: Line 61:
  
 ==== Excel style calculations ==== ==== Excel style calculations ====
-The plugin [[doku>plugin:tablecalc|tablecalc]] adds the ability to do excel style calculations. There is a number of math functions. One of the most useful is ''sum(range)''. Check the table below for a simple example. The [[doku>plugin:tablecalc|manual of the plugin]] shows how more complex stuff can be done.+The plugin [[doku>plugin:tablecalc|tablecalc]] adds the ability to do excel style calculations. There is a number of math functions. One of the most useful is ''sum(range)''. Check the table below for a simple example. The [[doku>plugin:tablecalc|manual of the tablecalc plugin]] shows how to do more complex stuff.
  
 ==== In-place-editing of tables ==== ==== In-place-editing of tables ====
Line 71: Line 71:
  
 ==== Coloured table cells ==== ==== Coloured table cells ====
-You can paint the cells of a table by preceding the entry with ''@FOOBAR:''. Replace "FOOBAR" with your favourite colour. You choose from every colour known to HTML. This includes numerical [[http://html-color-codes.info/|RGB-codes]]. +You can paint the cells of a table by preceding the entry with ''@FOOBAR:''. Replace "FOOBAR" with your favourite colour. You can choose from every colour known to HTML. This includes numerical [[http://html-color-codes.info/|RGB-codes]]. 
 ^ one   ^ two              ^ ^ one   ^ two              ^
 | three  | four and a half  | | three  | four and a half  |
Line 77: Line 77:
 | @lightgreen:seven | 25 | | @lightgreen:seven | 25 |
 |  sum:| ~~=sum(range(1,2,col(),row()-1))~~ €| |  sum:| ~~=sum(range(1,2,col(),row()-1))~~ €|
 +
 +==== Colored code ====
 +The [[doku>plugin:syntaxhighlighter4|syntaxhighlighter4]] plugin can render your code in a colorful way. It understands many common languages like python, c++, java and perl. LaTeX is supported, too. Basic usage is:
 +<code><sxh LANG> CODE </sxh></code>
 +LANG is the language of your code. Hello world example:
 +<sxh cpp>
 +#include <stdio.h>
 +int main()
 +{
 +   printf("Hello, World!");
 +   return 0;
 +}
 +</sxh>
 +For advanced options see [[https://github.com/crazy-max/dokuwiki-plugin-syntaxhighlighter4#syntax-and-usage|the github docs of the plugin]].
 +
 +Over the years, the regular code environment acquired highlighting ambitions, too:
 +<code cpp [enable_line_numbers="true",highlight_lines_extra="2"]>
 +#include <stdio.h>
 +int main()
 +{
 +   printf("Hello, World!");
 +   return 0;
 +}
 +</code>
  
 ===== List of files in a folder ===== ===== List of files in a folder =====
Line 86: Line 110:
  
 ===== Images and movies ===== ===== Images and movies =====
 +==== Acceptable image formats ====
 +  ? [[wp>JPG|JPG]] 
 +  : is the most abundant compressed image format on the www. Its ability to achieve arbitrary compression comes at a price: at some point image quality deteriorates significantly. JPG is great for photos. Not so great for graphics with sharp edges.
 +  ? [[wp>PNG|PNG]]
 +  : is an image format with lossless compression. It is particularily efficient for computer generated graphics with large areas of plain color. PNG is generally good for computer generated graphics and logos -- less so for photos
 +  ? [[wp>SVG|SVG]]
 +  :  is a vector image format developed for web pages, which is sanctioned by the [[wp>WWWC|WWWC]]. Vector images scale losslessly. A circle will keep its nice smooth boundry no matter the zoom scale. Because of this, SVG is particularily useful for detailed graphs and schematics. This format puts more demands on the local browser. Because of this, it took some time to be universally adopted. Since 2011, all major WWW browsers can deal with static SVG. The last to join the club was Microsoft with IE9.
 +
 +
 ==== Show all images in a folder ==== ==== Show all images in a folder ====
 The [[http://www.dokuwiki.org/plugin:gallery|gallery plugin]] shows a gallery of all images in a folder. The plugin understands quite a bunch of options. A useful choice is "lightbox" combined with "showname" The [[http://www.dokuwiki.org/plugin:gallery|gallery plugin]] shows a gallery of all images in a folder. The plugin understands quite a bunch of options. A useful choice is "lightbox" combined with "showname"
Line 115: Line 148:
 <code>{{ VideoURL | DokuwikiPathToVideo? WIDTHxHEIGHT & PathToPreviewImage | AlternateText}}</code> <code>{{ VideoURL | DokuwikiPathToVideo? WIDTHxHEIGHT & PathToPreviewImage | AlternateText}}</code>
  
-Example: +Example with default width and height: 
-<code>{{ http://bibo.iqo.uni-hannover.de/qtiplotvideo.mp4 ? & :wiki:playground:qtiplot_screenshot.jpg |}}</code> +<code>{{ :qti_faq:scatterplotundbeschriftung_kl.mp4? & :wiki:playground:qtiplot_screenshot.jpg |}}</code> 
-{{ http://bibo.iqo.uni-hannover.de/qtiplotvideo.mp4? & :wiki:playground:qtiplot_screenshot.jpg |}}+{{ :qti_faq:scatterplotundbeschriftung_kl.mp4? & :wiki:playground:qtiplot_screenshot.jpg |}}
  
  
Line 142: Line 175:
  
 ==== Colors, containers, columns and Co. ==== ==== Colors, containers, columns and Co. ====
-The [[http://www.dokuwiki.org/plugin:wrap|wrap plugin]] can do similars trick as the note plugin. But it also provides a ton of additional formatting options -- indent, outdent, highlight, highlight even more, multi columns, floating boxes. In general, formatting should be done by CSS sheets. But for a one-off a ''<wrap>'' may the appropriate tool.+The [[http://www.dokuwiki.org/plugin:wrap|wrap plugin]] can do similars tricks as the note plugin. But it also provides a ton of additional formatting options -- indent, outdent, highlight, highlight even more, multi columns, floating boxes. As a general rule, formatting should be done by CSS sheets. But for a one-off a ''<wrap>'' may the appropriate tool.
  
 The wrap can make portions of the page print but not show up on screen or the other way round. The wrap can make portions of the page print but not show up on screen or the other way round.
Line 171: Line 204:
   * ''<nowiki>:OK:</nowiki>'' transforms into :OK:   * ''<nowiki>:OK:</nowiki>'' transforms into :OK:
   * ''<nowiki>:no:</nowiki>'' transforms into :no:   * ''<nowiki>:no:</nowiki>'' transforms into :no:
 +
 +Admin advice: To add more local icons, you'd have to edit ''conf/smileys.local.conf'' and add an image in the folder ''lib/images/smileys/local/''.
 +==== A key to keys ====
 +The [[doku>plugin:keyboard|keyboard plugin]] provides a nifty way to communicate key presses. Most characters render as an icon of the corresponding key. But there is some magic going on. The plus ("+") and minus ("-") characters are interpreted as dividers for complex key sequences. In addition a capital A or C are rendered as the Alt- or Ctrl-key. Enclose characters in <nowiki>'</nowiki> to suppress the magic.
 +  * ''<nowiki><kbd>F1</kbd></nowiki>'' is rendered as <kbd>F1</kbd>
 +  * ''<nowiki><kbd>A</kbd></nowiki>'' is rendered as <kbd>A</kbd>
 +  * ''<nowiki><kbd>A+'A'</kbd></nowiki>'' is rendered as <kbd>A+'A'</kbd>
 +  * ''<nowiki><kbd>A+C+e</kbd></nowiki>'' is rendered as <kbd>A+C+e</kbd>
  
  
Line 213: Line 254:
  
 ===== Discussions ===== ===== Discussions =====
-The [[doku>discussion]] plugin provides a way to talk about the contents of a page.+The [[doku>plugin:discussion|discussion plugin]] provides a way to talk about the contents of a page.
 Put the string ''~~DISCUSSION~~'' on a page to add a discussion section. Put the string ''~~DISCUSSION~~'' on a page to add a discussion section.
  
Line 271: Line 312:
  
 {{tag>help APwiki}} {{tag>help APwiki}}
-{{indexmenu_n>3}}+{{indexmenu_n>4}}  /* sort this page after basic features */