Changes between Version 2 and Version 3 of CookBook/TracLayoutRecipe

Timestamp:

Aug 16, 2014, 6:49:45 AM (10 years ago)

Author:

Ryan J Ollos

Comment:

Some clarifications about where to put the CSS file(s), and using the [inherit] file option for a global configuration.

CookBook/TracLayoutRecipe

@@ -9 +9 @@
 
 There are two ways to specify a `site.html` template for an environment:
-1. Set the `templates_dir` in the `[inherit]` section of each `trac.ini` to the same directory (e.g. `/path/to/common/templates`), and save the `site.html` file in that directory.
+1. Set the `templates_dir` in the `[inherit]` section of each `trac.ini` to a shared directory (e.g. `/path/to/common/templates`), and save the `site.html` file in that directory. The `templates_dir` may also be specified in a [TracIni#GlobalConfiguration global configuration] that is included in each environment's configuration through the `file` option in the `[inherit]` section of trac.ini.
 1. Copy the `site.html` file to the `templates` directory of all environments (or better yet, create symlink in all directories to a single common location).
 
@@ -22 +22 @@
 
 == Adjust the Site Style Sheet #SiteCss
-A reference `projects.css` style sheet is included in the attached [attachment:TracLayoutRecipe.zip zip archive] (under the `css` directory), with the styles of the edgewall.org site.
+A reference `projects.css` stylesheet is included in the attached [attachment:TracLayoutRecipe.zip zip archive] (under the `css` directory), with the styles of the edgewall.org site. As with the site template, the stylesheet must also be accessible by each project environment. It may be placed in the directory specified by the `htdocs_dir` option in the `[inherit]` section of trac.ini, or in the project environment's `htdocs` directory.
 
 You may modify and adjust the style sheet to meet your artistic taste.
@@ -28 +28 @@
 One important thing to notice with respect to the `projects.css` file is that it refers to various images (used for backgrounds, gradients, etc.).
 
-All images needed may be found in the `gfx` directory of the attached [attachment:TracLayoutRecipe.zip zip archive],
+The images are found in the `gfx` directory of the attached [attachment:TracLayoutRecipe.zip zip archive],
 but the `projects.css` file assumes that the images are available under the `../gfx` directory, where `..` refers to one level up relative to the directory in which the `projects.css` is located.