The layout of a conference repository

An Act-enabled conference web site uses two subdirectories:


You organise wwwdocs as you please. To link to files stored in your wwwdocs directory, use [% make_uri("path/to/file").


The actdocs directory is laid out as follows:

In fact, you can already start to create some files for your Act website, you'll only need the static and templates subdirectories.

Links to the so-called "static" pages are created with the macro

    [% make_uri('news.html') %]

The parameter being the file path relative to actdocs/static.

Please note that at least one template is required: actdocs/templates/ui. This file contains a TT2 wrapper that will be used by the framework to create full pages from the bits of HTML it generates.

That means you have total control of the UI, the so-called "static" pages. What Act gives you is all the pages it can generate: users, talks, payment, schedule, etc. We have some ideas for future enhancements, but shhh.

One of the big features is that the templates are multilingual. Here an example of what you can do:

It is not possible to put <t>...</t> tags within TT2 [% ... %] blocs. But it is rarely needed.

Act manages the language of the generated pages according to the user's choice, but it will only produce pages in the languages configured in the conference. If you decide that your site must be in en/pt, even if Act know how to display pages in other languages, no language other than the official languages for the conference will be displayed.

Act provides menu templates for all the categories provided by the framework. You can therefore create your own menus very easily (e.g. in a file named templates/menu that can be PROCESSed in your templates/ui template):

    <!-- user info, login, language -->
    [% PROCESS menus/user %]
    <!-- users list, search, stats -->
    [% PROCESS menus/users %]
    <!-- wiki -->
    [% PROCESS menus/wiki %]
    <!-- talk lists, submission and schedule -->
    [% PROCESS menus/talks %]
    <!-- event management in the schedule -->
    [% PROCESS menus/events %]
    <!-- payment menu (for the treasurer) -->
    [% PROCESS menus/treasurer %]
    <!-- administrative pages -->
    [% PROCESS menus/admin %]
    <!-- other current Act conferences -->
    [% PROCESS menus/act_confs %]

If you want to integrate those menus in you UI, you'll only have to redefine the following templates in the actdocs/templates directory (because the submenus use the menus/item and menus/section templates). For example:

The various menus and links are activated and shown according to each user's rights and the conference current configuration.


Philippe Bruhat, Éric Cholet


This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.