Differences between revisions 15 and 16
Revision 15 as of 2007-07-03 11:12:25
Size: 3840
Editor: amk@amk
Comment: Migrated to Confluence 4.0
Revision 16 as of 2015-03-04 05:29:55
Size: 3798
Editor: msapiro
Comment: Cleanup
Deletions are marked like this. Additions are marked like this.
Line 45: Line 45:
 * [[http://sourceforge.net/tracker/index.php?func=detail&aid=1415956&group_id=103&atid=300103|Patch #1415956]]  * [[https://bugs.launchpad.net/mailman/+bug/558223|Patch #558223]]
Line 50: Line 50:
 * MailMan.HTMLFormatter
 * The CGI scripts in MailMan/Cgi (they use htmlformat.Table all over the place).
 * Mailman.HTMLFormatter
 * The CGI scripts in Mailman/Cgi (they use htmlformat.Table all over the place).

As a first step before adding full templating, the existing pages
can be restyled to use CSS and to look more up-to-date.

Currently being developed in the html-cleanup bzr branch.


  • Avoid using tables for layout.
  • Make pages look more modern.
  • Add a stylesheet URL setting, and use it when generating HTML output.

OPEN: is the stylesheet URL a list-specific or site-wide setting?

Logical scopes and a proposed representation of those scopes within the style sheet cascade:

  • server level - defaults.css , not represented in the XHTML at all.
    • site level - mailman.css, the "global" stylesheet linked into every page. it uses an @include statement to incorporate defaults.css.
      • domain level - example.com.css added if present as a linked stylesheet into every page of that domain.
        • list level - listname.css if present.
          • page level - included within style elements.
            • tag/code level - use setting class="$values" for most style manipulations. Ideally no style="$style" use though browser bugs may require it

OPEN: where does the default stylesheet live? Is there a suitable static directory created by installing mailman?


  • ./mailman/archives/public/ is accessible by HTTP whether by design or oversight
    • What other issues might stem from this?

OPEN: Allow embedding style directives in the output HTML?

This is 'considered harmful' as style="" overrides everything. We should never need to do this. 

CSS requirements

  • the bits of the template which define <head>, <body> etc. are defined in one pair of header and footer files, so they can be turned off easily;

  • the CSS files "namespace" everything by placing all Mailman content within a div, e.g. <div id="mailman">...</div> and then prefix all CSS rules with "#mailman" - this stops the Mailman styles from leaking out into the parent page elements.


Does anyone know of heavily customized MM archives that we could look at for ideas?

Places to change

  • The HTML templates in templates/.
  • Mailman.HTMLFormatter
  • The CGI scripts in Mailman/Cgi (they use htmlformat.Table all over the place).


Particular changes to each template are recorded below.

For all templates:

  • Lowercase all HTML tags.
  • Wrap entire <body> inside <div id="mailman">...</div>.

  • Update the DOCTYPE declaration (to HTML 4.0?)
  • Check validity of generated pages












  • Wrap archive listing with a <div>


  • Wrap archive listing with a <div>

  • OPEN: Merge this with archtoc by using a 'display:ignore' around the link to the raw archive?


  • Add class=subject, author, date
  • Wrap body with a <div class="message">

  • Wrap "More information" with a <div class="?">.

  • OPEN: wrap the links to the various indexes with a special class?


No specific changes.







MailmanWiki: DEV/StyledPages (last edited 2015-03-04 05:29:55 by msapiro)