Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
60 lines (49 sloc) 2.92 KB
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".