**Custom Markup Cookbook** This is just a rough idea of things that can be done via the custom markup functionality of #301 and #405. It'll be a work in progress. *HTML Markup Shortcuts* Rather than having to do things like {quote:text}, you can define markups as shortcuts (the HTML would go in the custom formatter section): *: {quote:{big: big text}} using {quote:%k %a} *: {quote:{small: small text}} using {quote:%k %a} *: {quote:{strike: striked text}} using {quote:%k %a} *Emulating Other Wikis* Many other Wiki styles implement something like [wiki:page description]. This can be easily done with a {quote:{wiki: page description}} markup using as a formatter {quote:%a}. This can also be combined with an {quote:{anchor: name}} markup (which just formats as {quote:}) to link to different parts of a wiki page. That is, {quote:{wiki: page#anchorname}} would cause the browser to skip right to the {quote:{anchor:anchorname}} markup in the given _page_. Some wikis implement "verbatim" blocks. This can easily be done with two separate custom markups, {quote:{verbatim}} and {quote:{endverbatim}} which respectively generate
 and 
HTML tags. For contrast, {quote:{verbatim}} can use a inline style tag to generate an off-white background such as
.        
 
*CVSTrac Shortcuts*               
 
Want a link into the CVS repository without a cumbersome URL?               
{quote:{getfile cvstrac/main.c}} with               
{quote:%x}.  The %x substitution allows you             
to use things like {quote:{getfile cvstrac/main.c}} or             
{quote:{getfile cvstrac/main.c CVSTrac's main.c}}. 
 
Various tickets (#137, #122) have requested the ability to easily link to 
{link: reportlist reports}. A {quote: {rptview:n}} markup can be easily 
added with 
{quote:%x} as a formatter. 
        
*External Resources*               
               
Most external resources will simply be markups as convenient links. The               
advantage of using a custom markup rather than {quote:{link:}} markups or               
straight HTML is that if a service changes, you only have to change the custom               
markup.               
               
CPAN module? {quote: {cpan: module}} using               
{quote:%x}.               
               
An external resource section wouldn't be complete without              
{quote:{google: search terms}} with              
{quote:%k %a}.             
             
*Program Markups*             
             
It's possible to write custom markups that call external programs. This isn't             
always a good idea (from a performance and security perspective), but it may be             
the only way to do some things. *Note* that some of these examples are simply             
that, examples, and have *not* be exhaustively auditted from a security             
perspective.             
             
Trvial examples are markups which just run a command and spit out information.             
Date/time stamps, system information, etc. For example, a trivial         
{quote: {timestamp}} markup would simply use {quote: /bin/date} as a formatter         
with no substitution arguments.             
             
A more complicated example is a markup to inline something from the CVS             
repository into the wiki page, such as {quote:{include: cvstrac/main.c}}. Using             
the formatter {quote: /path/to/include '%r/%k'}, the following script could be             
used to inline the latest version of any file found under the repository:             
           
  #!/bin/sh             
  FILE=`/bin/echo $1 | /bin/sed 's/\.\.//g'`             
  /bin/cat <             
  `/usr/bin/co -q -p $FILE,v 2>/dev/null`             
  
END The really interesting markup happens when you start to interact with the SQLite database, allowing for things like custom reports and whatnot. The following script can be used to define a {quote:{wikitoc}} markup using {quote: /path/to/wikitoc '%r/%n'}: #!/bin/sh for p in `sqlite $1.db 'SELECT name FROM wiki GROUP BY name ORDER BY name;'` do echo "$p
" done Or, to list all the new and active tickets using an {quote:{activetkts}} markup, the following script: #!/bin/sh for t in `sqlite $1.db 'SELECT tn FROM ticket \ WHERE status IN ("new","active") ORDER BY tn;'` do echo "#$t " done