Indic-Computing Logo

The Project Website

SourceForge Logo
Home Project Documentation Mailing Lists Site Map

The Indic-Computing Project > Indic-Computing Documentation Infrastructure > The Project Website

4 The Project Website

The project website serves as a central point of contact for our users. From this site, users can look up indian language information, check on the status of our projects, join mailing lists and contribute to the community.

Our website has the following major components:

Managing a large site can rapidly suck up the little time that we have for our work. Automation is an imperative.

Website Management Goals

  1. Be able to incorporate information from independently managed sources into the website.

  2. Offer a consistent ``look and feel'' with convenient navigational aids to our readers.

  3. Scalability to thousands of pages and a few tens of volunteer maintainers.

  4. The ability to maintain and modify the site ``offline'', since it is not reasonable to require our volunteer maintainers living in developing countries to be well-connected to the Internet.

    The entire process of building and verifying the website should be feasible even without Internet access.

  5. The ability for multiple people to be able maintain the website without colliding with each other's efforts.

  6. The use of open-source tools, in keeping with the overall goals of our project.

4.1 Overview

The core of our website management structure is built over a small number of design decisions:

4.2 System Description

In this section we will describe the website generation scripts.

Website generation is done from checked out documentation sources. Generation of documentation is done from these sources as described in Section 3. Once the main documentation has been generated successfully, the website creation scripts do the task of integrating everything into a consistent website.

4.2.1 Location in the source tree

The website sources are kept in a separate language-specific toplevel directory (see Figure 3)

Figure 3. Location of the website sources

    doc/ (1)
    |
    +---- en_US.ISO8859-1/ (2)
    |     |
    |     +---- website/ (3)
    |     |     |
    |     |     +---- contents/ (4)
    |     |
    |     +---- articles
    |     |
    |     +---- books
    |
    +---- src/
             

1Description of Figure 3

(1)
The root of the documentation source. tree
(2)
Language specific directory.
(3)
Website directory.
(4)
Glue content.

Location of the site in the source tree. Directory structure. Controlling makefile (adding a new external source). Handling images. Building the site. Publishing the site.

4.3 Further Reading

The concept of managing a large website using make is very likely to be new to readers unfamiliar with the unix way of life.

Nik Clayton wrote a series of articles for the DaemonNews magazine on using make to manage websites. These are listed in in the section on additional reading.

The FreeBSD website is managed using make.

This, and other project documentation, can be downloaded from [ http://indic-computing.sourceforge.net/documentation.html ].


Copyright © 2001--2009 The Indic-Computing Project.
Contact: jkoshy
View document revision history
Built With WebMake
Site Search Google