![[Image: The IceFrog]](../frog150.png)
To Do List
- New module "StripHTML", crudely removes HTML (to make a title with HTML suitable for meta tags or the field</li>
<li>Note: I use a tie'd hash. Stash::XS (the high speed version) does NOT
support tied hashes (yet). Warn users to use the old Perl version!
<li>BUG: If index.html is missing from a directory, attempts to build
.ifi files in that directory will die.
<li>BUG: <tt>[ASPATHTO PATH="../foo"]</tt>, when foo is a directory and the
current file is <em>in</em> foo generates the wrong entry (actually
generates path to <em>current file</em>). <em>May be fixed, retest</em>
<li>BUG! If have a .icefrog dir (for templates), you need to have a settings file.
<li>Cache .ifi file contents. Only hold any given value if the length of
the value is less than X bytes (1024?). If you need a value from the cache
and it's missing, re-read file.
<li>What if a chain of parents is recursive? Probably enters an infinite
loop. Add detection and reasonable fallback.
<li>settings: files and directories to ignore
<li>command line: specify settings, becomes the ROOT environment.
<li>Should I be using File::Spec::Functions or File::Spec?
<li> Database view templates:
<ul>
<li>Template:
<pre>
[% FOREACH entry = database %]
[% entry.name %] - [% entry.title %]
[% END %]
</pre>
<li>Src inline:
<pre>
database{db_inline}<<ENDDATABASE
--
Name: Alan
Title: Software Engineer
--
Name: Dave
Title: Director of Engineering
--
ENDDATABASE
</pre>
</ul>
<li>timestamp checks
<ul>
<li>Must be overridable with --ignore-timestamps option
<li>.ifi files: if the destination file's timestamp is > src file
and > .icefrog/settings files in current and parent directories, and >
appropriate template file, and > than any parent files, we don't need to
mess with.
<li>Other files: if the destination files's timestamp is > src file
timestamp, and the file size is the same, don't mess with.
</ul>
<li><a href="http://www.perldoc.com/perl5.8.0/lib/Getopt/Long.html">Getopt::Long</a>
<li>More magic variables?
<ul>
<li>Timestamp of file mod time (format specified by settings?)
<li>file mod time as seconds since epoch (for sorting children or
things like "Add '[NEW!]' to items changed in last 14 days.
</ul>
<li>Track filename and line number for templates through system so we can
provide them when reporting errors.
<li>make IceFrog::error non-fatal, add error counter, report number of errors at end.
look at IceFrog::warnings at same time.
<li>Improved support for section bar with current section being highlighted
<ul>
<li>Can be done with [% IF section = 'Docs' %], but clumsy
</ul>
<li>Add an [% WARNING("message") %] (which emits a warning) and [%
ERROR("message") %] (which emits an
error). If hit, print message to STDOUT, increment
warning counter, and continue. Useful for error checking. Similarly,
[% ASSERT(TEST) %] does an IF test and generates an ERROR.
<li>Support for _icefrog files to just be in same directory, maybe prefixed with .icefrog or _icefrog?
<li>Stop loading environment explicitly, assume the Page has it.
<li>Rename IceFrog::Environment::index function, it's a Perl function, may
cause problems in future.
<li>Specify list of web server acknowledged names. If relative link leads
to one, drop the filename, it's implied by the directory name. (That is,
index.html on sane systems.)
<li>Automatic support for compressed web pages:
In your root .htaccess, put add the line "Options MultiViews".
Now, to have an optionally compressed file foo.html, do _not_ put
a foo.html in the directory, instead put foo.html.html and
foo.html.gz. Obviously it would be good for the .gz version to
be based on and at least as new as the foo.html.html version.
Entertainingly, you can even refer to it as file (no extension).
<li>Unify path management, will make porting to windows/macos easier
<li>Nested templates: For example, a course.template might reuse
most of default.template:
<pre>@INHERIT: default
@REPLACE: title => <ASVAR NAME="courseno"> - <ASVAR="coursename">
@REPLACE: body => '<P><ASVAR NAME="summary"> <P><ASVAR
NAME="prereqs">
</pre>
<p>Hmmm, I think we get this free of charge with Template Toolkit.
W00t!
<li>Parent termination: Ability in settings file to say, if you get to this
directory and have processed the index, stop recursing upwards, I'm the
head of this web site.
<li>If --warn-destination if files in destination directory that
have no source equivalent.
<li>If --delete-destination, blow away destination directory before running.
<li>Ability to request that parent list skip the root (or perhaps more
generally, the top N or bottom N or both)
<li>Ability to give pages unique IDs and link by ID.
Say, name the support page "SUPPORT_PAGE" and
link with <A HREF="[% JUMP("SUPPORT_PAGE") %]. Being able to find the
target pretty much necessitates parsing the entire site or caching
jumps somewhere (probably the root). Perhaps in settings file or
_icefrog/PATHS.
<li>Ability to declare global replacements. Probably set in settings file
or other _icefrog/file.
Maybe
<pre>#define highprog <A HREF="/"><B>High Programmer</B></A></pre>
Then in text say, "Welcome to [% highprog %]"
</ul>
</div>
<p class="footerinfo">
<a href="/alan/email.html">Contact webmaster</a>
</p>
</div>
</BODY>
</HTML>