PCLT
Deprecated
"PCLT" is an abbreviation for "Parametric Composable Localizable
Templates" - in fact it should also hold Detalizable.
Term "Detailizable content (message)" in this package
has a following meaning: some content, representing which
it is possible to regulate, in how much details it is represented.
Conceptually, this package is a powerful extension to the well known
Show class, that (extension) is thought to be embeded in any
Haskell program, which requires multilanguage support, and/or where
messages should be detailizable.
The PCLT catalog consists of:
Catalog ID
Config, which defines rules and constraints,
that are used when catalog gets formed, and when it is used
to generate messages.
Tempates of messages, possibly related. Each catalog entry
is referenced by an ID, and is called "localizable (in languages)
template", while it's localization in concrete language is called
"localized (in a languages) template".
Each catalog entry (localizable template) consists of
ID
A requirement to detailization level (to used by reciever of
representation), which if is not statisfied, the template
isn't used.
A map of localized templates by languages - the different
translations of one same message.
Each localized template is a sequence of chunks:
plain texts,
named parameters placeholders,
placeholders for insertion of other template (reference on
other template, also called composites).
To make a message one needs to specify
a catalog,
a language,
detailization level to orient on
a localizable template ID,
a map of parameters together with their values.
The last two fields (localizable template ID + a map of parameters
together with their values) is called instaniation (of
templated message). In the program it wrapped in a PCSI data type.
A parameter value may be
plain text
newline
nothing
a reference to other instaniation (localizable template ID +
a map of parameters together with their values)
a list of other other instaniation
a parameter wrapping, where wrapper is an indentation of text
(N whitespaces insertion after each newline character)
a list of parameter values.
This package comes together with another one - a dependent package
PCLT-DB (section Database), which provides
a (PostgreSQL 8.4) DB structure where to keep/manage data
used for PCLT catalogs formation,
simple interface to read this data in haskell program, and
a prototype of a longterm service which regularly updates
catalog MVar with data from DB.
IMPORTANT!!! : It is highly recommended to use ISO 639(3) standard
for language names, since PCLT-DB package is oriented on 3 letters
(not bigger) language names. Without modifications PCLT-DB won't
work for bigger (then 3-letters) names.
ToDo considerations for the next versions:
Consider using state monad in order to put catalog into
an implicit context... and maybe also other uses if monads.
Rewrite MakeCatalog, so that it uses CatalogMaths functions.
Otherwise the both modules do similar work, and keeping double
code is a bad style.
Introduction of a new parameter value type: "reparsable"
wrapping for parameter value.
CatalogMaths extension.
Enchance required SDLs with min & max functions.
Sacrificing ldtSubcompositesMap of LocalizedTemplate,
which initially was introduced to enchance speed of messages
generation, in favor of making catalogs easier to modify
(which curently isn't supported and isn't an easy task).