#this is the driver file for a typical issue

#the issue command line should specify the same year and number as the file name;
#
#the way category, paper, and format command lines work should be self explanatory;
#    later we can change the syntax of these command lines if it is better to delimit fields in some other way;
#the "file name" is actually the directory in which the paper resides;
#    the files are assumed to be in the folder with the name year-i where i is the issue number;
#
#everything on a line after a sharp sign is ignored
#blank lines are ignored
#  \ as the last character of a line is a continuation indicator

#fix: deal with no author issue, e.g., call it Editorial staff
#fix: may not need trailing | any more -- may never have

#formats
#issue|year|number|publicationdate|published
             #where the last two fields are optional; the fifth
             #field indicates the issue status:  blank (meaning the issue is still in
             #draft format) or "published"; the previous field gives the publication date
             #in the format 2005-01-15
#category|category where category is Announcements, Articles, or Columns
#piece|title1|author|directory|title2|title3 where
             #title1 is in html display format, title2 is for sorting,
             #and title3 is for bibtex entries; title2 and title3 are optional

issue|2005|1|2005-01-15|published
category|Notices
piece|Welcome|Lance Carnes|carnes-welcome|
piece|Invitation to PracTeX'05|Steve Grathwohl|practex05||Invitation to Prac\TeX'05
piece|Highlights of the PracTeX'04 conference|Lance Carnes|carnes-conference||Highlights of the Prac\TeX'04 conference
category|Articles
piece|CTAN for Starters|Jim Hefferon|hefferon|
piece|Screen presentations, manuscripts, and posters from the same LaTeX source|David Allen|allen|
piece|Label replacement in graphics|Jenny Levine|levine|
category|Columns
piece|<tt>\begin{here} % getting started</tt>|Douglas Waud and Tim Null|waud|begin{here} % getting started|\
      \texttt{\char`\\begin\{here\} \% getting started}
piece|<tt>\starttext % Practical ConTeXt</tt>|Steve Peter|peter|starttext: Practical ConTeXt|\
      \texttt{\char`\\starttext \% Practical ConTeXt}
piece|Travels in TeX Land:  Tweaking LaTeX|David Walden|walden||Travels in \TeX\ Land:  Tweaking \LaTeX{}
piece|Ask Nelly: </a><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;What is ConTeXt?; <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;What is LaTeX3?; <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Why should a college student use LaTeX?; \
      <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;How do I make temporary margin notes?<a>|The Editors|asknelly|Ask Nelly: What is ConTeXt?; What is LaTeX3?; Why should a college student use LaTeX?; \
      How do I make temporary margin notes?|Ask Nelly\
      |Ask Nelly: What is ConTeXt?; What is LaTeX3?; Why should a college student use LaTeX?; \
      How do I make temporary margin notes?\
      |Ask Nelly: What is Con\TeX{}t?; What is \LaTeX{}3?; Why should a college student use \LaTeX?; \
      How do I make temporary margin notes?
piece|In my opinion|Peter Flynn|flynn|