doc/forum/Formatting_algorithms.mdwn

   1 I'm using ikiwiki for a software project, and in the design process one of the things I sometimes write
   2 algorithms. It doesn't happen much, but for components of functional nature it's very useful.
   3
   4 I've been thinking how to write them in the wiki. I can use a numbered list and manually make
   5 keywords __bold__, but it's not optimal. I could also use plain text formatting and indent using tabs,
   6 but again there is no highlighting of any keywords or formatting of structures.
   7 Before I do that, I'd like to know if there are better options.
   8
   9 One option I know is LaTeX, which has some very nice packages. You write pseudo-code which looks
  10 very much like source code, and the result looks great, very readable and high quality.
  11
  12 I saw the [[plugins/teximg]] plugin, but the explanation there is poor: Does the plugin handle things
  13 that aren't formulas? Could it work with a LaTeX document or with an algorithm environment?
  14
  15 Of course, of you have other suggestions I'll be happy to hear. I want to make a careful choice before
  16 I start writing many algorithms :-)
  17
  18 > You may try to see if you can select a pseudo-code languages in one of the
  19 > highlight plugins ([[plugins/contrib/highlightcode]],
  20 > [[plugins/contrib/sourcehighlight]], [[plugins/highlight]], other ?). The
  21 > list of supported languages with the [[plugins/highlight]] plugin is
  22 > [[here|http://www.andre-simon.de/doku/highlight/en/langs.php]], and if you
  23 > cannot find your languages, I think you can define your own
  24 > [[here|http://www.andre-simon.de/doku/highlight/en/plugins.php]].
  25 >
  26 > -- [[Louis|spalax]]
  27
  28 >> Thanks, I looked at it. I don't think there's any special language for algorithms
  29 >> (anyway I couldn't find any), but for the record I found the following possibilities:
  30 >>
  31 >> 1. LaTeX: Not very readable in source form, but could be highlighted, didn't try
  32 >> 2. Writing in a subset of Python/Pascal/Fortran and using their highlighting
  33 >> 3. Define a new highlight syntax
  34 >>
  35 >> What about [[plugins/teximg]]? If it can be used to generate algorithms from LaTeX, it would be
  36 >> an easy excellent solution.
  37 >>
  38 >> --[[fr33domlover]]
  39
  40 > [[plugins/teximg]] is the best thing that currently exists. I think it would
  41 > be great if someone wrote a plugin for [math.js](http://mathjs.org), as
  42 > talking to my semantic-web/scientist colleagues, that's the current
  43 > state-of-the-art. -- [[Jon]].