HTML Guidelines for Authors

Published on Monday, 08 August 2005 20:00
Written by Douglas Eadline
Hits: 4040
The following is guide to submitting HTML content to the ClusterMonkey.net website. Please note that Cluster Monkey will support only the basic HTML elements outlined below. Much of the final formating is done by the CMS (content management system). An example HTML file is available here.

IMPORTANT: You must be a registered user of Cluster Monkey in order to have your article published.

Contact Information:
At the beginning of each file, you must include, your name, email address, and phone number. Please note on whose behalf you are submitting the article (as an Individual, Company, Academic, Government) This information WILL NOT be public or appear in your article.

Article Title:
A title should be provided with each submission. Place <H1>,</H1> tags around the title.

Sub-Title
Subtitle may be included but is not necessary. It should be surrounded with <H2></H2> tags.

Author:
The authors name must be the same as the name registered on the ClusterMonkey website.

Headings:
All heading are to use <H3></H3> tags

Paragraphs:
Paragraphs are to be separated by <P> tags.

Italic and Bold Placement:
Use <I>,</I> for italic and <B>,</B> for bold. Please keep italic and bold use to a minimum.

Lists:
Use <UL>,</UL> or <OL>,</OL> tags for lists.

Tables:
Tables must use standard HTML table markup. For example, the following is an example of a table:

<TABLE cellpadding="2" cellspacing="3" border="1" align="center">
  <TR>
   <TH> Headling 1, row one</TH>
   <TH> Headling 2, row one</TH>
  </TR> 
  <TR>
   <TD> column 1, row one</TD>
   <TD> column 2, row one</TD>
  </TR> 
  <TR>
    <TD> column 1, row two</TD>
    <TD> column 2, row two</TD>
  </TR>
</TABLE>

Source Code:
Source code should be surrounded by <PRE></PRE> tags. Use <TT></TT> when refefring to code items in normal text.

<PRE> 
 1 #include <stdio.h>
 2 #include <mpi.h>
 3
 4 int main(int argc, char **argv) {
 5   int rank, size;
 6
 7   MPI_Init(&argv, &argv);
 8   MPI_Comm_size(MPI_COMM_WORLD, &size);
 9   MPI_Comm_rank(MPI_COMM_WORLD, &rank);
10   printf("Hello, world.  I am %d of %d.\n", rank, size);
11   MPI_Finalize();
12   return 0;
13 }
</PRE>

Sidebars:
All extra information should go in sidebars. In particular, if you have a list of resources or URLS, please place them in sidebars. And example sidebar follows. You can reference the sidebar in you page by placing an:

 <A name="SIDEBAR1"> 

tag in the sidebar and the referencing the sidebar by using

<A href="/#SIDEBAR1"> See Sidebar One</A> 

tag in the text.

<TABLE border="0" bgcolor="#CCCCCC" ALIGN="RIGHT" WIDTH="50%">
  <TR>
    <TD><A name="SIDEBAR1"><B>Sidebar One: Resources</B></TD>
  </TR>
  <TR>
    <TD> 
      Tom Sterling's <a href="http://www.linux-mag.com/2003-
      06/breakthroughs_01.html">Beowulf Breakthroughs</a>
     <P>
     <a href="http://www.beowulf.org">Beowulf mailing list 
     and Web Page</a>
     <P>
     Book: <I>How to Build a Beowulf</I>, by Sterling, Salmon, Becker,
     Savarese, MIT Press, ISBN 0-262-69218-X
    </TD> 
  </TR> 
</TABLE>

Links:
All external links can be put in place. Links to other ClusterMonkey pages need to use the full ClusterMonkey URL. For example:

You can contact the Head Monkey by clicking
<a href="http://clustermonkey.net/index.php?option=com_contact&task=view&contact_id=1&Itemid=3">
here</a>.

Equations:
If the number of equations is small, equations are best handled by creating images and including them in the text. You can create equations in HTML by using tools such as this.

Images:
All image files should submitted with the HTML document or a URL that points to where the image can be obtained. Our CMS requires that the image be local, so we need a copy. Image <IMG> tags should indicate where the image should be placed in the text. Use only ALT and SRC attributes. For example:

<IMG ALT="ClusterMonkey Logo" SRC="cm_logo.jpg">

Other Formating:
Please check with the Editor if you have other formating/linking issues.

Unfortunately you have Javascript disabled, please enable Javascript in order to experience the comments correctly