Index: openacs-4/packages/acs-templating/www/doc/requirements.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-templating/www/doc/requirements.html,v diff -u -r1.2 -r1.2.2.1 --- openacs-4/packages/acs-templating/www/doc/requirements.html 27 Oct 2014 16:40:14 -0000 1.2 +++ openacs-4/packages/acs-templating/www/doc/requirements.html 22 Jun 2016 07:48:43 -0000 1.2.2.1 @@ -21,7 +21,7 @@ The following is a requirements document for the ACS Templating System version 0.5. It has also been called Karl's Templates, the Dynamic Publishing System (DPS), and Stencil. The official package - name for the system is now acs-templating. + name for the system is now acs-templating.

II. Vision Statement

@@ -80,19 +80,19 @@ The template system is designed to be used by two classes of users: programmers and designers. In bulding a web site, programmers are generally responsible for defining and - implementing the application logic of the site, while + implementing the application logic of the site, while designers are more responsible for the - presentation. Generally speaking, the application logic + presentation. Generally speaking, the application logic generates data for the presentation to display to the user. The template system must provide mechanisms that supports both of these tasks and allows the designer and programmer to work seperately, but for their work to be combined at runtime into something that the user sees as a single page.

- Thus, pages are naturally split into two parts. The logic - part executes application logic and generates data, and the - presentation part that specifies the layout of the page + Thus, pages are naturally split into two parts. The logic + part executes application logic and generates data, and the + presentation part that specifies the layout of the page and so on.

@@ -102,8 +102,8 @@

  • A notation and API for the programmer specify the application logic and to generate the data to be displayed. In ACS, we - call the data that we wish to display a data source or - page property. Application logic is driven by the + call the data that we wish to display a data source or + page property. Application logic is driven by the inputs the page gathers from the user request (e.g. the HTTP request), and the computation that the page must perform on this input. This computation will generally create and @@ -224,8 +224,8 @@ 10.10.2 Use of Components

    To speed development and ensure consistency of design, template - authors are encouraged to assemble pages from distinct component - templates that may be recycled in different contexts. One typical + authors are encouraged to assemble pages from distinct component + templates that may be recycled in different contexts. One typical practice is to build a "master" template for an entire section of a site, with a common header, footer and sidebar layout. For each page request, the "content" template is incorporated dynamically @@ -255,9 +255,9 @@ specific data being presented. For example, when presenting a list of library books that a user has checked out, the designer might want to highlight the overdue ones in red. For this, designers - must have the ability to write simple program logic (Note: We + must have the ability to write simple program logic (Note: We run the risk of inventing our own language here, we must be - careful). + careful).

  • @@ -384,10 +384,10 @@

    VII. Revision History

    - - - - +
    Document Revision #Action Taken, Notes
    + + +
    Document Revision #Action Taken, Notes When? By Whom?