LogonBook

Background

This page (or possibly set of pages below LogonBook) serves a purpose internal to the LOGON project: help contributors to the final LOGON book coordinate their efforts. We expect to collect a complete initial set of chapters before the summer of 2007; these pages will be continuously updated with instructions to authors, specifically style recommendations and LaTeX information.

Collaborative Authoring

The LOGON book project will be compiled in LaTeX, with all source files organized in CVS version control; please consult the pages LogonInstallation/CvsBasics and LogonInstallation/InstallationBasics for background.

The main difference to our use of CVS in past development of the LOGON demonstrator is the name of the top-level CVS module. Instead of the module named logon, all book files are organized as a module named book. Thus, the following should yield a complete initial LaTeX tree:

  cvs -d :pserver:oe@cvs.emmtee.net:/logon/CVS checkout book

Remember to substitute your LOGON work space user name for oe in this example.

Once the checkout from CVS is complete, there will be a new directory book/ with sub-directories planning/ and submission/. Initial chapter versions that will go into the peer reviewing phase reside in the submission/ directory, with yet another sub-directory for each chapter. Take a look at the top-level LaTeX file master.tex to understand the directory structure and naming conventions. The only change(s) you should have to make to this file is in the \includeonly section, where removing the LaTeX comment character (which is the per cent sign) before each chapter name will activate inclusion of that chapter. When, to get started, you add an abstract for a chapter for which you are the primary author, say the chapter named fundamentals (with helge as the lead author), uncomment the corresponding line in master.tex and add your text to the file fundamentals/chapter.tex.

To typeset and preview your contributions, run latex on the master file, or (as a short-hand for the sequence of running both LaTeX and BibTeX as many times as is needed to include bibliographic references et al.) simply invoke the following within the submission/ directory:

  make

Common Acronyms and Abbreviations

Bibliographic References

For all citations and bibliographic references, we will use the BibTeX facilities, specifically, the [http://www.dante.de/CTAN//biblio/bibtex/contrib/apacite/apacite.pdf APA citation style]. Please consult the files logon.bib and master.bib (in the top-level submission/ directory of the book source tree) for existing entries and inspiration in creating new entries. Specifically, please obey the following format in creating citation keys:

• for references with a single author, use the last name suffixed with the last two

  digits of the year of publication, e.g. Alshawi:92. In case there are multiple entries by the same name in any given year, add additional letter suffices, e.g. Erbach:91a.

• for multi-authored references, compose the first three letter of the first three

  authors, plus the two-digit year, e.g. Ber:Hel:04 for Beermann and Hellan (2004) and Bon:Oep:Sie:05 for Bond, Oepen, Siegel, Copestake, and Flickinger (2005).

We plan to continually grow our collection of BibTeX entries and share it with all contributors, therefore consistency of entries is important. Also, note that master.bib provides a set of pre-defined strings, e.g. for the names of conferences and institutions; where applicable, please make good use of these or add additional ones, e.g.

  @string{MONS:04 = {Rapport fra det 10. møte om norsk språk}}

  @inproceedings{Joh:Nyg:04b,
    author = {Janne Bondi Johannessen and Lars Nygaard},
    title = {Oslo-skogen. {E}n trebank for norsk},
    booktitle = MONS:04,
    address = {Kristiansand, Norway},
    pages = {},
    year = 2004
  }

As regards in-text bibliographic references, the APA citation package provides three basic macros: \cite{}, \citeA{}, and \citeNP{}. The first form yields a reference enclosed in parenthesis, suitable for citations that serve as background information, i.e. typically act like parentheticals to their context of use. The second form only parenthesizes the year of publication and is suitable for references that serve a grammatical function in their context of use. Finally, the third form lacks all parentheses and can be used to avoid double embedding, i.e. when used within an enclosing set of parentheses. Consider the following example to see the three distinct forms:

  \citeA{Lon:Oep:Ber:04} sketch the LOGON MT system, which has some superficial similarity
  to the earlier VerbMobil effort \cite{Wahlster:00} and employs semantic transfer in the
  framework of Minimal Recursion Semantics (MRS; \citeNP{Cop:Fli:Pol:05}).

Once typeset and processed by BibTeX, this will yield:

• Lønning, et al. (2004) sketch the LOGON MT system, which has some superficial similarity to the earlier VerbMobil effort (Wahlster, 2000) and employs semantic transfer in the framework of Minimal Recursion Semantics (MRS; Copestake, et al., 2005).

As we aim to cross-reference within the book, we will frequently want to refer to other chapters in the LOGON volume. Our LaTeX set-up includes mock citation commands for in-volume references analoguous to the APA citation commands, viz. \Cite{}, \CiteA{}, and \CiteNP{}. Valid citation keys for these commands, are chapter identifiers (corresponding to each sub-directory below submission/, e.g. introduction, fundamentals, demonstrator, norgram, parsing, trepil, erg, redwoods, et al.

To create additional BibTeX entries, please add to the chapter-local file, within the same sub-directory as the chapter.tex file. The name of each per-chapter BibTeX file reflects the chapter name, e.g. introduction/introduction.bib for the first chapter. The editors will compare per-chapter entries and over time unify new entries into the shared master.bib.