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.

@@ -184,7 +194,9 @@

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.

diff --git a/viewvc.org/template-authoring-guide.html b/viewvc.org/template-authoring-guide.html index 5fe823a0..9e402d14 100644 --- a/viewvc.org/template-authoring-guide.html +++ b/viewvc.org/template-authoring-guide.html @@ -9,9 +9,13 @@ body { } table { margin-left: 1em; } td, th { padding: 0 0.5em; } -th { vertical-align: bottom; } -td { vertical-align: top; } -th { background: rgb(60%,70%,90%); } +th { + vertical-align: bottom; + background: rgb(60%,70%,90%); +} +td { + vertical-align: top; +} .h2, .h3 { padding: 0.5em 1em; border-color: black; @@ -39,7 +43,9 @@ th { background: rgb(60%,70%,90%); }

Introduction

-

### 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.

diff --git a/viewvc.org/url-reference.html b/viewvc.org/url-reference.html index afe31cc8..b8d7ecc3 100644 --- a/viewvc.org/url-reference.html +++ b/viewvc.org/url-reference.html @@ -2,50 +2,29 @@ ViewVC 1.0 URL Reference