How-To Submit to IPAC Research BB  V0.1
AFB  1 April 2007



So here are quick step-by step "How-To" guidelines (on the preferred
method) for submitting your research preprints to the IPAC Research
BB.



1) Identify the information you'll need

These are the items you'll *need* to describe your research contribution:

 - The $title
     (e.g. $title = "Really-New Recent Seminal Results")

 - The $authorList and $year for your research contribution 
     (e.g. $authorList = "W.E. Coyote, Super Genius", $year = 2007)

 - The $disposition for your research contribution
     (e.g. $disposition = "ApJ in press")

 - The $URL for your research -- a link where people can go for more
     information on the contribution (e.g. an ADS, astro-ph, or
     journal link)

 - The $releaseDate for the research contribution
     (e.g. $releaseDate = "1 April 2007")



2) Format the HTML entry

The IPAC Research BB HTML is a simple format composed of HTML lists in
a number of categories (e.g. "Extragalactic Astronomy", Solar-System
Astronomy").  Each research contribution appears as a list entry in
the relevant list/category.  The generic form of the HTML list entry
is:


<li>
[$releaseDate]
"<a href="$URL">
$title</a>",
$authorList  $year,
$disposition
</li>




3) Send the (formatted) info/entry in email to bode@ipac.caltech.edu

You can either send the formatted list entry (preferred), just a list
of the required items (less preferred) to bode@ipac.caltech.edu





4) Extra Credit

Here are a few additional items that will further streamline my admin
of the researchBB.  Your attention to these is encouraged and
appreciated, but not required.




***  Received comment field  ***

I use an HTML comment tag to keep up with when and from whom I
received a contribution (and as a key for the lunch raffle!!!).  The
format for that comment (in the context of the contribution list
entry) is really simple:


<!-- Received from $submitter $receiveDate -->


as in:

<li>  <!-- Received from WE Coyote 28 March 2007 -->
[1 April 2007]
"<a href="http://reallyCoolResults.org">
Really-New Recent Seminal Results</a>",
W.E. Coyote, Super Genius 2007,
ApJ in press
</li>




***  Author List Encoding  ***

Of course much of our research is in collaboration with folks outside
of IPAC.  Since this is an _IPAC_ Research BB, I encode the author
list to call attention to the IPAC authors.  Many of you will have
seen that this is done in bold-face:

$authorList = 
"...non-IPAC-author, <b>IPAC-author</b>, non-IPAC-author, <b>IPAC-author</b>, ..."


To further call attention to an IPAC-affiliated _lead_ author I use italics:

$authorList =
"<b><i>IPAC-lead-author</i></b>, non-IPAC-author, <b>IPAC-author</b>, non-IPAC-author"



***  Disposition encoding  ***

It's traditional to italicize the journal where your contribution will
appear, as in:

$disposition = "<i>ApJ</i> in press"




***  URLs  ***

I intentionally *don't* have a policy on what URLs you can use -- you
can point to an URL you think best represents your results -- and I
don't intend on editorializing here.  But if I could venture a few
recommendations:

 -- ADS is probably the best place to point readers for us of the
    "touch it once" mindset.  Pointing to ADS means the status
    information gets updated for you as the manuscript moves through
    the processing cycle.


 -- I would *not* recommend pointing directly to the journal, as their
    content is typically protected (i.e. reader needs a subscription).




5) Examples

Here are a few illustrative examples:


<li>  <!-- Received from N Seymour 22 March 2007 -->
[9 Mar 2007]
"<a href="http://xxx.soton.ac.uk/abs/astro-ph/0703224">
The Massive Hosts of Radio Galaxies Across Cosmic Time</a>",
<b><i>N. Seymour </i></b>, D. Stern, C. De Breuck and the SHzRG collaboration 2007,
to appear in <i>ApJS</i>
</li>



<li>  <!-- Received from S Laine 20 March 2007 -->
[3 Jan 2007]
"<a href="http://arxiv.org/abs/astro-ph/0701040"
>The Role of Galaxy Interactions and Mergers in Star Formation at z<1.3: Mid-Infrared Properties in the Spitzer First Look Survey</a>",
C. R. Bridge, <b>P. N. Appleton</b>, C. J. Conselice, P. I Choi, <b>L. Armus</b>, <b>D. Fadda</b>, <b>S. Laine</b>,
<b>F. R. Marleau</b>, R. G. Carlberg, <b>G. Helou</b>, <b>L. Yan</b>,
accepted for publication in <i>ApJ</i>
</li>



<li>  <!-- Received from R Millan-Gabet 26 March 2007 -->
[25 Mar 2007]
"<a href="http://adsabs.harvard.edu/cgi-bin/nph-data_query?bibcode=2007astro.ph..2462K&db_key=PRE&link_type=ABSTRACT&high=4481dc806827497">
Visual/infrared interferometry of Orion Trapezium stars: Preliminary  
dynamical orbit and aperture synthesis imaging of the Theta 1 Orionis  
C system</a>",
Kraus, S.; Balega, Y. Y.; Berger, J. -P.; Hofmann, K. -H.;
<b>Millan-Gabet, R.</b>; Monnier, J. D.; Ohnaka, K.; Pedretti, E.; Preibisch,  
Th.; Schertl, D.; Schloerb, F. P.; Traub, W. A.; Weigelt, W. 2007,
to appear in <i>A&A</i>
</li>