Some of my group's pages don't show up properly. Why?

Gigascale Systems Research Center
FAQ
Editing group pages, and other forms of rocket science

Previous section	\|	This section	\|	Next section
Previous question	\|	This question	\|	Next question

Some of my group's pages don't show up properly. Why?
John Reekie, 17 Sep 1999

Because the gigascale server takes pages that you authored and "wraps" them in its own HTML to generate the GSRC header, footer, and on on, authored pages have some (reasonable) restrictions on what they can contain.

Frames don't work. In theory, frames could be supported but it hasn't been a high enough priority yet. Please just write simple flat HTML pages and let the server add the headers and other decoration. See the customization FAQ if you would like to have the server add your own margins or footers to your pages.
Pages need to be "well-formed." Because we are processing your HTML and embedding it within the GSRC pages, it's a lot easier for the server to extract what it needs from your pages if it contains correctly-formed HTML. The overall structure of the page should be like this:
```
<html>
<head>
<title>My Title</title>
</head>
<body>
...
</body>
</html>
```
Other things that can prevent your page from displaying are:
- No <body> tag.
- Too many <body> and </body> tags.
- Malformed tables. Each <table>, <tr>, and <td> tag must have a matching end tag.
- Igor Markov points out that another trick is to read a page into Netscape Composer and then write it out again. This technique is especially useful in fixing table errors.

Links

When you are authoring your own pages, you are better off using relative links whereever you can. Relative links allow a copy of your pages to be viewed from anywhere.

If you must use an absolute link, consider using

< a href="/workgroup/myfile.html">myfile.html</a>

instead of < a href="http://www.gigascale.org/workgroup/myfile.html">myfile.html</a>

HTML links from forum pages to the main workgroup pages should take into account that the main workgroup pages are can be found in /workgroup>/, whereas the forum is in /workgroup>/forum.

Detection

The GSRC Website uses the Htdig search engine. The search engine is run each night, and a log file is generated. We run a short script over that log file and send email about broken links to webmaster. The webmasters then either fix the links themselves, or send email to the authors.

If your pages are publicly readable, you can use one of the services from the Yahoo HTML Validation and Checkers Page Most of the services cost money, and most of them can only read pages that are accessible to the public, but some services provide a free sample run. (The GSRC website has been specially modified to allow out htdig process to be able to index non-public pages).

If you have a remote subsite, see also the remote subsite faq.