### Start of Variables ###
# Variables that start with "_" are template variables
# If found, the leading "_" will be removed.
# They are used to match "%%Variable%% template variables in
# template pieces in the configuration files.
# _PageTitle is used in the Page Header template.
# i.e.
%%PageTitle%% etc.
_PageTitle = Intro to Frogdown
# _PageID isn't used yet. But it will be--make sure that every page has a unique _PageID.
_PageID = dogfood
### Optional variables ###
# New for version 1.10
# You can use define and use %%template%% variables in your own document.
# Well, if TemplateVarsInBody = 1 (below)
_Language = Frogdown
# or maybe
#_Language = Frogdown
# Force all images to be created?
# (Usually only needed when you are fiddling with image sizes.)
# Or if you are experimenting with ImageMagickConfig in the config files
ForceImageCreation = 0
# Put assorted config variables as comments at the start of the output file.
# Probably should only be used while debugging.
Debug = 0
ShowVars = 1
# Also generate a word wrapped version of this file?
# Only is needed if you want to make this file available on the site.
MakeTextFile = 1
### End of Variables ###
%%Include Frogymanheader-1.inc%%
%id dogfood nl|ht = If you are reading this you have discovered that I like hover text. So hover over things. Hover over the Froggy picture over there.%
###Eat your own dogfood
%#%We can include other files%/#%
%%Include DogFood-Include.inc%%
%ClearFloats%
> (Hover over the links for an overview.)
%%NameLinks%%
%id frogdown nl | ht = Frogdown is Markdown with a lot of extra features%
###What is Frogdown?
First, Frogdown is a superset of [Markdown](http://daringfireball.net/projects/markdown/), which is a very popular minimal text markup language. It is very popular because you don't need to add much markup code at all, so text that is formatted in Markdown is easy to write. Look at [Markdown Basics](http://daringfireball.net/projects/markdown/basics) and [Markdown: Syntax](http://daringfireball.net/projects/markdown/syntax) to see how to format Markdown.
However, Markdown is limited, so Frogdown was written to add more functionality to Markdown. For a demonstration of Frogdown syntax, look at [DogFood.text](DogFood.text) for the Frogdown markup for this page. (Might not work on the mobile version of this.)
FrogDown (as implemented in MarkdownWrapper.pl) is designed to run on both Windows and Linux (and maybe Macs). Because it is a Perl script, it works on a desktop machine, or can be used on a server. FrogDown (MarkdownWrapper.pl) is template driven. It is currently configured to generate both [normal](%%FullSite%%) and [mobile](%%MobileSite%%) versions of your web pages.
%id frogdowninline ht=These work within a block level structure (i.e., a paragraph or div). For things like bold or italic.%
###Frogdown inline markup tags
Look at [the original markup file](DogFood.text) to see the codes. Use your browser's "View/Source" function to see the HTML code that MarkdownWrapper.pl generated.
%b%This text is bold%/b% %i%This text is italic%/i% %bi%This text is bold/italic%/bi% %br%(There should have been a line break just before this because I used the `\%br%` tag.) %em%This text is emphasized%/em% %strong%This text is strong%/strong% %#%This text shouldn'be be here because it is an inline comment.%/#% %tt%This text is in the typewriter font. See how \%tt\% handles troublesome text.%/tt% This text is unadorned. %code%This text is in \%code\%. See how \%code\% handles troublesome text.%/code%
%sidebar sb=bqsidebar|t=Detail%
\%code\%%b%{Some Text}%/b%\%/code\% runs %b%{Some Text}%/b% through Markdown to escape special characters that HTML will interpret. \%tt\% just wraps %code%%/code% around the text, so the '%code%<>%/code%' characters aren't escaped. The previous paragraph illustrated the difference between how text that is enclosed in the Frogdown tags \%tt\% and \%code\% are handled.
And note that the '%' character needs to be escaped with a ’\\’ %#%We need a bit of ugly escaping to display the \\ character with adjacent single quotes. When SmartyPants is enabled.%/#% character when writing about Frogdown code. So that \%tt\% is displayed and is not treated as the start of a \%tt\%block. Sometimes the dogfood isn't tasty as one would hope.
%/sidebar%
%id sidebar ht = are text boxes that are set off in some way. Like with a lined border around them and a gray background. And maybe floating to the left or right. That kind of thing.%
###Sidebars
Sidebars are text boxes that are set off in some way. (The actual look and feel is defined in the CSS style sheet that is defined for the page.) Frogdown code for a sidebar would be
\%sidebar sb=bqsidebar|t=Detail\%
As much Frogdown/Markdown text as you want
\%/sidebar\%
where `\%sidebar` starts the sidebar block, `sb=bqsidebar` defines the type of sidebar (currently has support for `bqsidebar` for block quoted, `rsidebar` for right floating and `lsidebar` for left floating.) `t=Detail` is the text for the subheading. Arguments are separated with '|' characters.
%sidebar sb=bqsidebar|t=Detail%
The value for `\%sidebar sb=bqsidebar%` is passed to the HTML code so you can use any value that you have in your CSS sheet. I currently have CSS styles defined for `lsidebar`, `rsidebar`, and `bqsidebar`. i.e. `sb=bqsidebar%` gets translated to