diff --git a/viewvc.org/contributing.html b/viewvc.org/contributing.html index cd874904..e995ce6f 100644 --- a/viewvc.org/contributing.html +++ b/viewvc.org/contributing.html @@ -110,7 +110,7 @@ — Jamie Zawinski -
Of course, an symphony of insanity can be composed in any language, +
Of course, a symphony of insanity can be composed in any language,
so we do try to stick to some basic guiding principles. Maintain
whatever style is present in the code being modified. New code can
use anything sane (which generally means cgi/viewvc.conf.dist file and the library module
lib/config.py
in sync.
Because ViewVC is a Web-based application, people will have ViewVC + URLs hyperlinked from other sites, embedded in emails, bookmarked + in their browsers, etc. It is very important to ensure that those + URLs continue to retrieve the information they were intended to + retrieve even if ViewVC is upgraded on the hosting server. In + other words, as new features require modifications to the ViewVC URL schema, make sure those + modifications preserve the existing functionality of all ViewVC + URLs.
+The library subdirectory contains a module debug.py
,
which you may find useful for performance testing.
The library module ezt.py
contains a module docstring
which describes the directives used in the HTML templates used by
ViewVC. The templates themselves can be found in the
- templates
subdirectory.
templates
subdirectory. We're currently developing a
+ how-to guide for ViewVC
+ template customization.
### TODO ###
+This document represents an (unfinished) attempt at providing + documentation for how to customize ViewVC 1.0-dev's HTML output via + modification of its templates.