Next: , Previous: Distributions, Up: Top

10 Web Pages

Please write pages about your package for installation on www.gnu.org. The pages should follow our usual standards for web pages (see http://www.gnu.org/server); we chose them in order to support a wide variety of browsers, to focus on information rather than flashy eye candy, and to keep the site simple and uniform.

The simplest way to maintain the web pages for your project is to register the project on savannah.gnu.org. Then you can edit the pages using CVS. You can keep the source files there too, but if you want to use savannah.gnu.org only for the web pages, simply register a “web-only” project.

If you don't want to use that method, please talk with webmasters@gnu.org about other possible methods. For instance, you can mail them pages to install, if necessary. But that is more work for them, so please use CVS if you can.

Some GNU packages have just simple web pages, but the more information you provide, the better. So please write as much as you usefully can, and put all of it on www.gnu.org. However, pages that access databases (including mail logs and bug tracking) are an exception; set them up on whatever site is convenient for you, and make the pages on www.gnu.org link to that site.

Web pages for GNU packages should not include GIF images, since the GNU project avoids GIFs due to patent problems. See Ethical and Philosophical Consideration.

The web pages for the package should include its manuals, in HTML, DVI, Info, PostScript, PDF, plain ASCII, and Texinfo format (source). (All of these can be generated automatically from the Texinfo source using Makeinfo and other programs.) When there is only one manual, put it in a subdirectory called manual; the file manual/index.html should have a link to the manual in each of its forms.

If the package has more than one manual, put each one in a subdirectory of manual, set up index.html in each subdirectory to link to that manual in all its forms, and make manual/index.html link to each manual through its subdirectory.

See the section below for details on a script to make the job of creating all these different formats and index pages easier.

We would like to include links to all these manuals in the page http://www.gnu.org/manual. Just send mail to webmasters@gnu.org telling them the name of your package and asking them to edit http://www.gnu.org/manual, and they will do so based on the contents of your manual directory.