"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "docs/users_guide/libraries.rst" between
cheetah3-3.2.2.tar.gz and cheetah3-3.2.3.tar.gz

About: Cheetah3 is a template engine and code generation tool for e.g. for Web development or Java, SQL, LaTeX, form email ... (written in Python).

libraries.rst  (cheetah3-3.2.2):libraries.rst  (cheetah3-3.2.3)
skipping to change at line 67 skipping to change at line 67
- read/write {.ini style config files} (or strings) - read/write {.ini style config files} (or strings)
- read settings from Python source files (or strings) so that - read settings from Python source files (or strings) so that
complex Python objects can be stored in the application's settings complex Python objects can be stored in the application's settings
dictionary. For example, you might want to store references to dictionary. For example, you might want to store references to
various classes that are used by the application, and plugins to various classes that are used by the application, and plugins to
the application might want to substitute one class for another. the application might want to substitute one class for another.
- allow sections in {.ini config files} to be extended by settings - allow sections in {.ini config files} to be extended by settings
in Python src files. If a section contains a setting like in Python source files. If a section contains a setting like
"{importSettings=mySettings.py}", {SettingsManager} will merge all "{importSettings=mySettings.py}", {SettingsManager} will merge all
the settings defined in "{mySettings.py}" with the settings for the settings defined in "{mySettings.py}" with the settings for
that section that are defined in the {.ini config file}. that section that are defined in the {.ini config file}.
- maintain the case of setting names, unlike the ConfigParser - maintain the case of setting names, unlike the ConfigParser
module module
Cheetah uses {SettingsManager} to manage its configuration Cheetah uses {SettingsManager} to manage its configuration
settings. {SettingsManager} might also be useful in your own settings. {SettingsManager} might also be useful in your own
applications. See the source code and docstrings in the file applications. See the source code and docstrings in the file
{src/SettingsManager.py} for more information. {Cheetah/SettingsManager.py} for more information.
Templates Templates
--------- ---------
Package {Cheetah.Templates} contains stock templates that you can Package {Cheetah.Templates} contains stock templates that you can
either use as is, or extend by using the {#def} directive to either use as is, or extend by using the {#def} directive to
redefine specific { blocks}. Currently, the only template in here redefine specific { blocks}. Currently, the only template in here
is SkeletonPage, which is described in detail below in section is SkeletonPage, which is described in detail below in section
libraries.templates.skeletonPage. (Contributed by Tavis Rudd.) libraries.templates.skeletonPage. (Contributed by Tavis Rudd.)
skipping to change at line 196 skipping to change at line 196
:: ::
##doc-module: A Skeleton HTML page template, that provides basic structure a nd utility methods. ##doc-module: A Skeleton HTML page template, that provides basic structure a nd utility methods.
############################################################################ #### ############################################################################ ####
#extends Cheetah.Templates._SkeletonPage #extends Cheetah.Templates._SkeletonPage
#implements respond #implements respond
############################################################################ #### ############################################################################ ####
#cache id='header' #cache id='header'
$docType $docType
$htmlTag $htmlTag
<!-- This document was autogenerated by Cheetah (http://cheetahtemplate.org/ ). <!-- This document was autogenerated by Cheetah (https://cheetahtemplate.org /).
Do not edit it directly! Do not edit it directly!
Copyright $currentYr - $siteCopyrightName - All Rights Reserved. Copyright $currentYr - $siteCopyrightName - All Rights Reserved.
Feel free to copy any javascript or html you like on this site, Feel free to copy any javascript or html you like on this site,
provided you remove all links and/or references to $siteDomainName provided you remove all links and/or references to $siteDomainName
However, please do not copy any content or images without permission. However, please do not copy any content or images without permission.
$siteCredits $siteCredits
--> -->
skipping to change at line 245 skipping to change at line 245
:: ::
#def bodyContents #def bodyContents
Here's my new body. I've got some flesh on my bones now. Here's my new body. I've got some flesh on my bones now.
#end def bodyContents #end def bodyContents
All of the $placeholders used in the {SkeletonPage} template All of the $placeholders used in the {SkeletonPage} template
definition are attributes or methods of the {SkeletonPage} class. definition are attributes or methods of the {SkeletonPage} class.
You can reimplement them as you wish in your subclass. Please read You can reimplement them as you wish in your subclass. Please read
the source code of the file {src/Templates/\_SkeletonPage.py} the source code of the file {Cheetah/Templates/\_SkeletonPage.py}
before doing so. before doing so.
You'll need to understand how to use the following methods of the You'll need to understand how to use the following methods of the
{SkeletonPage} class: {$metaTags()}, {$stylesheetTags()}, {SkeletonPage} class: {$metaTags()}, {$stylesheetTags()},
{$javascriptTags()}, and {$bodyTag()}. They take the data you {$javascriptTags()}, and {$bodyTag()}. They take the data you
define in various attributes and renders them into HTML tags. define in various attributes and renders them into HTML tags.
- { metaTags()} - Returns a formatted vesion of the - { metaTags()} - Returns a formatted vesion of the
self.\_metaTags dictionary, using the formatMetaTags function from self.\_metaTags dictionary, using the formatMetaTags function from
{\_SkeletonPage.py}. {\_SkeletonPage.py}.
 End of changes. 4 change blocks. 
4 lines changed or deleted 4 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)