The source for
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
Makefile using podium features Jun 12, 2010
README wrap up the captcha creation, following changes made in Sep 27, 2009


These should be instructions for how the crank operation works,
what the directory structure is and how to generate

If anything is unclear, feel free to email me at or send
a patch for the documentation. code has several components:
* The (source) POD files under the "s" folder:
    The POD files are the core content of It's written in
    POD form. You can read the documentation of how to write POD on perldoc,
    using either the command "perldoc perlpod" or googling for "perlpod".
    These POD files are renderes to HTML by the generator script documented

* The static JS, images and design under the "static" folder:
    Some things are static, such as images, the CSS layout, javascript
    functions and the sorts. You can find those in the "static" folder.
    There is basic CSS for handheld, print and web.
    Currently the only image is the Perl101 logo.
    The Javascript files are the Jemplate engine (Jemplate can be found on
    CPAN) and a compiled Template Toolkit template file to Javascript.

* The Template::Toolkit templates under the "tt" folder:
    The generation engine uses the HTMLified POD content in templates in order
    to render the complete website. These are the templates in the "tt" folder.
    There is one single template called "" which is not directly used.
    It is compiled to javascript using "jemplate" command line tool and then
    put in the JS folder in "static".

    Each section in is rendered independently using the
    "" template. If you want to control each section, that's the
    template you want to check out.

    It's simple HTML with Template::Toolkit tags. Template::Toolkit can be
    found on CPAN.

* All the generated files under the "build" folder:
    Once the generation script generated the files, it saves them in the
    "build" folder. The folder doesn't exist by default ( is on and Git cannot monitor empty folders so you'll need to create
    this folder yourself. The generation script will alert you if it is

    This folder can be seen as the "htdocs" or "httpdocs" people are used

* The CGI scripts used for mailing and image creation, in the main folder:
    Right now there are only two scripts:
        - "": this script is not production-ready yet. It's creates
          captchas for the feedback form. It will try to create them in the
          default 'captcha' folder. You'll probably have to create it.
        - "": this script sends the form submitted (via AJAX)
          and returns an answer or error.

* The generator script in the main folder:
    The generator script goes over all the POD files in "s", renders them using
    the templates in folder "tt" and then puts them as static files in the
    "build" folder. You can specify a different "build" folder or it will
    by default look for a folder named "build".