Provided by: wiki2beamer_0.9.5-1_all bug



       wiki2beamer - convert wiki-formatted text to latex-beamer code


       wiki2beamer [OPTION...] [FILE...]


       FILE   the text-file(s) to be processed

              show a short usage help

              show version information

       -o,--output FILE
              write output to FILE instead of stdout


       Usually you want to pipe the output of wiki2beamer into a file:

       wiki2beamer footalk.txt > footalk.tex

       If  called  with  multiple  input  files,  wiki2beamer  processes them in order with their
       content being simply concatenated. If called without  any  input  file,  wiki2beamer  will
       attempt  to read input from STDIN. If no input files are supplied and nothing is available
       on STDIN, wiki2beamer prints its usage message and exits.

       If an error occurs, wiki2beamer returns a return code other then 0.


       Wiki2beamer has it's own wiki-syntax which (evolved without much of a concept ;)  and)  is
       described  below.  Everything that is unknown to wiki2beamer will be passed through to the
       LaTeX output (unless inside special environments).

       A wiki2beamer txt file can consist of two sections: the head and the body.   The  head  is
       optional  and  is  an  autotemplate  environment.   The  body  contains the content of the
       document. If the head (autotemplate) is not given, then only the code for the body will be
       generated and can be included into a manually crafted LaTeX template file.

       You  can  split  input to wiki2beamer into multiple files. This helps to keep things apart
       and avoids conflicts.  There are two ways to split input. The first  is  to  use  multiple
       input  files  which  wiki2beamer  will  read  and  process  in  order  as if they were one
       concatenated file. The second is to use the >>>include<<< syntax.

              Include the file  named  includefile  at  this  line.  Works  recursively.  Endless
              recursion  will  be  detected and treated as an error. Including files doesn't work
              inside [nowiki] and [code] environments (see below).

       == sectionname ==
              opens a section called sectionname

       == longsectionname ==[shortname]
              opens a section called longsectionname, passing the parameter shortname to latex

       === subsectname ===
              opens a subsection called subsectname

       === longsubsectname ===[shortname]
              opens a subsection called longsubsectname, passing the parameter shortname to latex

       ==== frametitle ====
              opens a frame with the title frametitle

       ==== frametitle ====[param]
              opens a frame with the title frametitle, passes frame parameters like  t,  fragile,
              verbatim etc. to latex

       !==== frametitle ====[param]
              the  !  added  in  front  of a frame, selects a frame for exclusive generation.  It
              makes wiki2beamer skip all frames that are not selected.  You can  select  multiple
              frames. This can speed up the edit-compile-view cycle massively.

       Sectioning commands work only at the beginning of a line.

       * text create a bullet (itemize) with text

       *<onslide> text
              create  a  bullet  (itemize)  with  text  that only appears on the specified slides

       # text create a numbered item (enumerate) with text

       #<onslide> text
              create a numbered item (enumerate) with text that only  appears  on  the  specified
              slides (onslide)

       Cascaded lists, mixed ordered and unordered items:

            * This is a crazy list.
            *# It contains different items.
            *# In different formats.
            *** On different levels.
            ***<2-> which are animated
            *<3-> Quite a lot of fun.
            **<4-> Isn't it?

       LaTeX knows many environments, some of which are as simple as \begin{center} \end{center},
       others are more complicated.  To use these in a more wiki-like  fashion,  use  <[name]  to
       open  and  [name]>  to close environments. It will be simply converted to \begin{name} and

              No parsing is done. The user is responsible for  closing  any  opened  environment.
              Environment-tags are only recognized at the beginning of a line.

       Unlike standard environments, some environment names are recognized by wiki2beamer.  These
       are: nowiki, code, autotemplate and frame. If wiki2beamer detects one of these it will  do
       some advanced parsing, which can even fail with a syntax error.

       Autotemplate  can  be  used  at  the  beginning  of a beamer .txt file. It will create the
       required LaTeX headers to compile the content.

              opens the autotemplate environment

              close the autotemplate environment

       key=value (inside [autotemplate])
              insert a template command \keyvalue

       key=value pairs are converted  to  \keyvalue  in  the  output  (except  special  keys)  --
       everything after = is just appended to \key.


       will be converted to \usepackage[utf8]{inputenc}.

       There is a built-in set of options:


       titleframe  is  a  special  key that tells wiki2beamer to create a title frame. To set the
       title, subtitle and author of the presentation use the keys title,  subtitle  and  author.
       Overriding of the default options works on

       · per-key level for: documentclass, titleframe

       · per-package level for: usepackage

       · no overriding for: everything else

       Use code-environments to display animated code listings.

              open a code environment

              open a code environment passing parameters to the latex lstlisting environment.

              close the code environment


       <[code]  opens  the  environment, [code]> closes it, everything after <[code] is passed to
       the LaTeX listings package as options for this listing.  Inside the  code  environment,  [
       and  ] must be escaped as \[ and \]. Things between [ and ] are animations.  There are two
       kinds of animations:

       · [<slidespec>some code] - show "some code" only on specified slides

       · [[<slidespec>some code][<slidespec>some other code]] - show "some code" on the slides in
         the  first  spec, show "some other code" on the slides in the second spec, fill up space
         on slides without content with spaces

       Slide-specs can be of the form:

       · n - one single frame n

       · n-m - sequence of frames n to m

       · spec,spec,... - combine multiple specs into on (e.g. <1-3,5>)

       Nowiki-Environments completely escape from wiki2beamer replacements. <[nowiki]  opens  the
       environment, [nowiki]> closes it.

       The  LaTeX-frame environment is where the content of a slide goes.  You can manually close
       a frame-environment which was opened with ==== Frametitle ==== with [frame]>.  Wiki2beamer
       is then aware that the last frame is already closed and doesn't try to close it again.

              typeset text bold

              typeset text italic

       @text@ typeset text in typewriter type, to ignore an @, escape it as \@

       !text! alert text, to ignore an !, escape it as \!

       _ color _ text _
              make text appear in color

              opens the column environment

       [[[ width ]]]
              creates a column of width, everything below goes into this column

              closes the column environment

              include image from pathtofile

              include image from pathtofile passing key=value parameters to latex

              create a footnote containing text

              when  found  at  start  of  line, with nothing afterwards, insert a \vspace{length}
              (vertical space of length length)

              same as above, but insert a \vspace* (a forced vspace)

              \uncover the content on the given overlay subframes. They will already take up  the
              space,  they need to be displayed, so the geometry of the frame doesn't change when
              the element pops up.

              \only show the content on the given overlay subframes. They will not  take  up  the
              space  they  need  to  be  displayed, so the geometry of the frame changes when the
              element pops up.

       -->    becomes $\rightarrow$

       ==>    becomes $\Rightarrow$

       <--    becomes $\leftarrow$

       <==    becomes $\Leftarrow$

       :-)    becomes \smiley (requires package wasysym)

       :-(    becomes \frownie (requires package wasysym)

       There are two variables, FRAMEHEADER  and  FRAMEFOOTER.  The  content  of  these  will  be
       inserted at the beginning/end of all following slides.

              set frameheader to text

              set framefooter to text

       Leave text empty to reset frame headers and footers.


       Copyright (C) 2009 Kai Dietrich, Michael Rentzsch and others.

       Permission  is  granted to copy, distribute and/or modify this document under the terms of
       the GNU Free Documentation License, Version 1.3 or any later version published by the Free
       Software Foundation;

       wiki2beamer  is free software: you can redistribute it and/or modify it under the terms of
       the GNU General Public License as  published  by  the  Free  Software  Foundation,  either
       version 2 of the License, or (at your option) any later version.

                                          31 March 2012                            wiki2beamer(1)