specific document layout with ConTeXt

specific document layout with ConTeXt

[Brecht Machiels]

Hello,

I have some experience using LaTeX as I have used it to typeset two 
master theses. Having started a PhD a year ago, the need to write some 
publications arises. However, while IEEE conferences/journals used to 
offer LaTeX templates in the past (as far as I know), it seems that 
recently LaTeX support is being dropped and only MS Word templates are 
offered. Take for example the RFIC 2009 conference: 
http://www.rfic2009.org/rfic2009/authorguide.html

Considering my more-or-less good experiences with LaTeX in the past, I 
still prefer to write a publication using LaTeX, and not Word. This 
would require me to copy the MS Word template in LaTeX. However, I do 
remember that fine-tuning things to look just the way I want in LaTeX 
can result in quite the headache. That's why I started looking for 
alternatives.

Initially discarding TeX and all it's descendents because they are 'not 
very modern', I ended up with Lout (http://lout.wiki.sourceforge.net/). 
This looked quite promising, as I managed to closely approximate the 
Word template by means of adjusting the options to the "report" document 
class Lout offers (not considering images and tabled for the moment): 
http://homes.esat.kuleuven.be/~bmachiel/rfic/rfic2009f
By extending the reportf class definition, I also managed to add an 
"index terms" section:
http://homes.esat.kuleuven.be/~bmachiel/rfic/rfic2009f
This was all surprisingly painless. The document lout source and pdf are at:
http://homes.esat.kuleuven.be/~bmachiel/rfic/template.lout
http://homes.esat.kuleuven.be/~bmachiel/rfic/template_lout.pdf

However, trying to learn more about Lout -- for example to change 
subsection numbering -- it seems that the programming language that Lout 
offers confuses me almost as much as TeX macros do. Perhaps my mind is 
accustomed too much to nice object-oriented languages like Python and I 
simply cannot be bothered by this complex stuff anymore. (a Python-based 
typesetting system; now that would be heaven... maybe)

Some other things bother me about Lout:
* Much smaller userbase than (La)TeX. Will I find the help I need?
* No means of "inheriting" the report class and changing it. I have to 
physically copy the class definition and change the code. I recall it is 
possible to do some kind of redefinition in TeX, right?

In looking for an alternative to this alternative, I found that the TeX 
community is very much alive. Even though TeX's 'not very modern'-ness, 
these new developments might offer something interesting. I remembered 
that ConTeXt, unlike LaTeX, allows much finer control over the layout of 
a document. Hence, it would probably be the next candidate for this 
little typesetting adventure of mine. Today, I finally got my hands 
dirty and tried to recreate the RFIC2009 template using ConTeXt.

Unfortunately, due to a lack of a good document class to start with, it 
is proving to be much more difficult to create something that resembles 
the Word template. As I have also read on this mailing list, the 
documentation, while there is plently to be found, is a bit messy. 
Appareantly the documentation is not up to date with ConTeXt? Perhaps it 
would be good to remove outdated documentation and clearly present only 
one reference manual (the most up to date) to the new user.

I did find some samples on the wiki, but the first two that I tried to 
compile apparently required some extra packages. Also, while I always 
thought it was a good idea to seperate content and layout, some of the 
examples on the wiki seem to suggest to mix them. Or is this the 
philosophy behind ConTeXt?

May I suggest some work is put into creating some basic (plain) document 
templates (well-commented) which can be used by ConTeXt newbies, but can 
also be used as starting points for creating new templates?

On to the template then.

http://homes.esat.kuleuven.be/~bmachiel/rfic/rfic2009.tex
This is a first attempt at creating an environment to describe the 
layout of the template. As you can see, I have not yet gotten far. I 
copied the title code from the contextgarden wiki. The TeX code makes me 
shiver however. I will have to catch up on that.

http://homes.esat.kuleuven.be/~bmachiel/rfic/template.tex
This is the template itself. I basically want this file to contain as 
little layout stuff as possible. I would like to define the title, 
author, abstract and index terms before \starttext. If possible, the 
environment should place those parts automatically without having to 
specify \placetitle after \starttext.

I was hoping that the friendly people on this mailing list might help me 
get started in creating this template. Let's start with the following:
* title, author, abstract and index terms as explained above
* the fact that there are 2 columns should be specified in the environment
* define title, author, abstract and index terms fonts clearly, similar 
as in the Lout rfic2009 file and use this information to format the 
title stuff.

Looking at the countless documents that show off ConTeXt, it is obvious 
that it is very much possible of creating custom layouts. However, I 
wonder, how much TeX hacking is required?

Kind regards,
Brecht
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: specific document layout with ConTeXt

[Martin Schröder]

2008/12/28 Brecht Machiels <brecht@mos6581.org>:
> http://homes.esat.kuleuven.be/~bmachiel/rfic/template_lout.pdf

Two observations:
- AR8@Linux complains about a bad /BBox in Times-RomanSC
- none of the fonts are embedded

Best
   Martin
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: specific document layout with ConTeXt

[Wolfgang Schuster]

[-- Attachment #1: template_paper.tex --]
[-- Type: application/octet-stream, Size: 20115 bytes --]

\usemodule[ieee]

\starttext

\setuptitle
  [title={Submission Format for RFIC2009 (Title in 18-point Times font)},
   author={J. Clerk Maxwell, Michael Faraday, and André M. Ampère (List authors on this line using 12 point Times font – use a second line if necessary)},
   affiliation={Microwave Research, City, State/Region, Mail/Zip Code, Country (authors' affiliation(s) listed here in 12 point Times font – use a second line if necessary)}]

\placetitle

\startcolumns

\startabstract
{\bi Abstract} — Use 9 point Times New Roman Bold font for the abstract. Set your line spacing to be 10 points rather than single space. Indent the first line by 0.125 inches and type the word \quotation{Abstract} in 9 point Times New Roman Bold Italic. This should be followed by two spaces, a long dash (option / shift / minus), two spaces, and then the first word of your abstract (as shown above). Please try to keep the length of your abstract to 100 words or less. Times font is an acceptable substitute for Times New Roman font. After the abstract, you should list a few key words from the IEEE approved \quotation{Index Terms} LIST that describe your paper. The index terms are used by automated IEEE search engines to quickly locate your paper. Typically, you should list about 5 to 7 key words, in alphabetical order, using 9 point Times New Roman Bold font. An example is shown next.

{\bi Index Terms} — Ceramics, coaxial resonators, delay filters, delay-lines, power amplifiers.
\stopabstract

\section{Introduction}

Please read through this entire template before you start using it to create your paper! This will save you and the RFIC Committee considerable time, and improve your chances for acceptance. The following information is provided to help you prepare the Initial Submission as well as the Final Paper for submission to RFIC2006. (Many authors submit the same paper for the initial as well as the final submission. This is a common practice. See item \#4 below.) A contributor should remember that:

\startitemize[n][stopper={)}]

\item Deadlines are absolute, don't even ask!

\item Summaries may not exceed four pages, including all figures, tables, references, etc. Additionally, there is a size limit on the electronic version of all Summaries. In Adobe Portable Document Format (PDF), submissions may not exceed 1 Megabyte.

\item Acceptance rates have historically run at approx-imately 50\%. There is not sufficient room within the Technical Program to accept all submissions.

\item Many submitters with previous experience realize that, if their submission is accepted, they will be required to submit a version of their Final Paper to be published in the Symposium Digest. As the Digest paper will be similar in length to the Summary, many contributors opt to prepare their Summary in the format required for the Digest. This template contains the instructions for the proper preparation of such a document.

\item Although not required, you are encouraged to employ this format. This document is being made available as a template for your convenience. If you elect not to use this template, please remember that you must still adhere to the general guidelines embodied in this document concerning, but not limited to, font size, margin size, page limits, file size, etc. (Note: Starting in 2004, Index Terms are required.)

\stopitemize

\section{Overview of the Digest Format}

We are requesting that you follow these guidelines as closely as possible so that the Digest has a professional look and resembles the MTT Transactions. All paragraphs of text, including the abstract, figure captions, and refer-ences, should be justified at the left and the right edges.

For the Title use 18-point Times (Roman) font. Its paragraph description should be set so that the line spacing is single with 6-point spacing before and 6-point spacing after (Format --> Paragraph --> Indents and Spacing). The font description for the Author List and Authors' Affiliation(s) should be 12-point Times. The paragraph descriptions should be set so that the line spacing is single with 6-point spacings before and after. Use an additional line spacing of 12 points before the beginning of the double column section, as shown above.

\placetable
  {Summary of Typographical Settings}
  {\setupTABLE[textwidth=\makeupwidth,option=stretch]
   \setupTABLE[c][each][align=middle]
   \setupTABLE[c][1][align=right]
   \setupTABLE[r][1,2][bottomframe=off]
   \setupTABLE[r][2,3][topframe=off]
   \bTABLE
     \bTR
       \bTD \eTD
       \bTD[nc=3] \bf Font specifics \eTD
       \bTD[nc=5] \bf Paragraph Description \eTD
     \eTR
     \bTR
       \bTD \bf Section \eTD
       \bTD[nc=3] (Times Roman unless specified) \eTD
       \bTD[nc=3] spacing (in points) \eTD
       \bTD alignment \eTD
       \bTD indent \eTD
     \eTR
     \bTR
       \bTD \eTD
       \bTD style \eTD
       \bTD size \eTD
       \bTD special \eTD
       \bTD line \eTD
       \bTD before \eTD
       \bTD after \eTD
       \bTD \eTD
       \bTD (in inches) \eTD
     \eTR
     \bTR
       \bTD Title \eTD
       \bTD plain \eTD
       \bTD 18 \eTD
       \bTD none \eTD
       \bTD single \eTD
       \bTD 6 \eTD
       \bTD 6 \eTD
       \bTD centered \eTD
       \bTD none \eTD
     \eTR
     \bTR
       \bTD Author List \eTD
       \bTD plain \eTD
       \bTD 12 \eTD
       \bTD none \eTD
       \bTD single \eTD
       \bTD 6 \eTD
       \bTD 6 \eTD
       \bTD centered \eTD
       \bTD none \eTD
     \eTR
     \bTR
       \bTD Affiliations \eTD
       \bTD plain \eTD
       \bTD 12 \eTD
       \bTD none \eTD
       \bTD single \eTD
       \bTD 6 \eTD
       \bTD 6 \eTD
       \bTD centered \eTD
       \bTD none \eTD
     \eTR
     \bTR
       \bTD Abstract \eTD
       \bTD bold \eTD
       \bTD 9 \eTD
       \bTD none \eTD
       \bTD exactly 10 \eTD
       \bTD 0 \eTD
       \bTD 0 \eTD
       \bTD justified \eTD
       \bTD 0.125 1\high{st} line \eTD
     \eTR
     \bTR
       \bTD Index Terms \eTD
       \bTD bold \eTD
       \bTD 9 \eTD
       \bTD none \eTD
       \bTD exactly 10 \eTD
       \bTD 0 \eTD
       \bTD 0 \eTD
       \bTD justified \eTD
       \bTD 0.125 1\high{st} line \eTD
     \eTR
     \bTR
       \bTD Headings \eTD
       \bTD plain \eTD
       \bTD 10 \eTD
       \bTD small caps \eTD
       \bTD exactly 12 \eTD
       \bTD 18 \eTD
       \bTD 6 \eTD
       \bTD centered \eTD
       \bTD none \eTD
     \eTR
     \bTR
       \bTD Subheadings \eTD
       \bTD italic \eTD
       \bTD 10 \eTD
       \bTD none \eTD
       \bTD exactly 12 \eTD
       \bTD 6 \eTD
       \bTD 6 \eTD
       \bTD left \eTD
       \bTD none \eTD
     \eTR
     \bTR
       \bTD Body paragraphs \eTD
       \bTD plain \eTD
       \bTD 10 \eTD
       \bTD none \eTD
       \bTD exactly 12 \eTD
       \bTD 0 \eTD
       \bTD 0 \eTD
       \bTD justified \eTD
       \bTD 0.125 1\high{st} line \eTD
     \eTR
     \bTR
       \bTD Equations \eTD
       \bTD[nc=3] Symbol font for special characters \eTD
       \bTD single \eTD
       \bTD 6 \eTD
       \bTD 6 \eTD
       \bTD centered \eTD
       \bTD none \eTD
     \eTR
     \bTR
       \bTD Figures \eTD
       \bTD[nc=3] 6 to 9 point sans serif (Helvetica) \eTD
       \bTD single \eTD
       \bTD 0 \eTD
       \bTD 0 \eTD
       \bTD centered \eTD
       \bTD none \eTD
     \eTR
     \bTR
       \bTD Figure captions \eTD
       \bTD plain \eTD
       \bTD 9 \eTD
       \bTD none \eTD
       \bTD 10 \eTD
       \bTD 0 \eTD
       \bTD 0 \eTD
       \bTD justified \eTD
       \bTD none, tab at 0.5 \eTD
     \eTR
     \bTR
       \bTD References \eTD
       \bTD plain \eTD
       \bTD 9 \eTD
       \bTD none \eTD
       \bTD 10 \eTD
       \bTD 0 \eTD
       \bTD 0 \eTD
       \bTD justified \eTD
       \bTD 0.25 hanging \eTD
     \eTR
   \eTABLE}

\section{Detailed Text Formatting}

Using 8.5 x 11-inch paper, the top and bottom margins are 1.125 inches, and the left and right margins are 0.85 inches. Except for Title, Authors and Affiliations, use a double column format. The column width is 3.275 inches and the column spacing is 0.25 inch.

Each major section begins with a Heading in 10 point Times font centered within the column and numbered using Roman numerals (except for ACKNOWLEDGEMENT and REFERENCES), followed by a period, a single space,
and the title using an initial capital letter for each word. The remaining letters are in SMALL CAPITALS. The
paragraph description of the section heading line should be set for 18 points before, 6 points after, and the line spacing should be set to exactly 12 points.

For the body of your paper, use 10-point Times font and set your line spacing at \quotation{exactly 12 points} with 0 points before and after. Indent each paragraph by 0.125 inches.

Further details are provided in the remainder of this paper for specific situations.

\subsection{Major Subsections}

As shown, denote subsections with left justified 10-point Times Italic. Order them with capitalized alphabetic characters (A, B,...). Follow the letter designation with a period, a single space, and then the subsection title capitalizing the first letter of each word. The paragraph description of the subsection heading is set to \quotation{exactly 12-point} line spacing with 6 points before and after.

\subsection{Equations}

Equations should be centered in the column and numbered sequentially. Place the equation number to the right of the equation within a parenthesis, with right justification within its column. An example would be

\placeformula
\startformula
\int_c E \cdot dL = - \frac{\partial}{\partial t} \iint B \cdot dS
\stopformula

or

\placeformula
\startformula
\nabla \times H = J + \frac{\partial D}{\partial t}
\stopformula

Note that a period is used to properly punctuate the previous sentence. It is placed at the end of the second equation. Make sure that any subscripts in your equations are legible and are not too small to read! When referring to an equation, use the number within parenthesis. For example, you would usually refer to the second equation as (2) rather than equation (2). If possible, use the Symbol font for all special characters, or better yet, use Equation Editor™ or MathType™. The paragraph description of the line containing the equation should be set for 6 points before and 6 points after. The paragraph spacing will need to be set to \quotation{single} rather than \quotation{exactly 12 point} so that the height will autoscale to fit the equation.

\section{Figures}

Figures should utilize as much of the column width as possible in order to maximize legibility. Use a sans serif font, such as Helvetica or Arial. Helvetica and Arial are larger and much easier to read than Times. Using 6- to 9-point Helvetica usually results in a legible figure. Do not use any font smaller than 6-point! It must be legible. When referring to a figure, use the abbreviation Fig. followed by its number. Place figure captions directly below each figure. Use 9-point Times with the paragraph spacing set at \quotation{exactly 10 points}. Set a tab at 0.5 inch. Type \quotation{Fig. \#.} (\# is the numeral) then tab over to the 0.5 inch mark before beginning the text of the figure caption. Note that figure captions are always (left and right) justified, rather than centered, even if they are less than a single full line in length. See the captions for Fig. 1 and Fig. 2.

Within Microsoft Word there are several options for placing figures within your paper. Often the easiest is to insert them between existing paragraphs allowing the figures to remain in that relative position. The paragraph description where the figure is inserted must be set to \quotation{single} spacing rather than \quotation{exactly 12 points} in order to allow the line to autoscale in height to display the entire figure. Some disadvantages of this approach are that you don't have total flexibility in placing figures, and that the figures will move as text is inserted or deleted in any part of the document before the figure. If you elect to use this approach, it is recommended that you nearly complete the editing of your text before inserting any figures. Remember to allow room for them, however. Then begin inserting figures starting from the beginning of your document. Do not lump all figures at the end of the paper!

If you have difficulties with the titles on your figures, you can always elect to add in the titles as separate text boxes, rather than importing the titles with the graph. This is sometimes helpful in getting a lengthy vertically-oriented title to display correctly.

\placefigure
  {Estimated relationship between the time an author spends reading these instructions and the quality of the author's digest article.}
  {\externalfigure[figure-1][width=.98\textwidth]}

Notice that prior to the graph, a single 12-point line is used to separate the preceding text from the graph. The equivalent of a blank line should exist between the bottom of the graph (the x-axis caption) and the figure caption. (In this particular case, there was no need to add a blank line between the x-axis label and the figure caption, because there was already adequate spacing provided by the image border.) After the figure caption, there should be a single 12-point blank line before the text resumes.

More flexibility is obtained in inserting figures if you can place them exactly where you would like them to be on a page. This can be accomplished by inserting the figure, selecting the figure, and then choosing \quotation{Format Picture…}. Various settings allow you to place the figure at an absolute position on a page; specify if the text is supposed to flow around the figure or if the figure should move with the text, etc. If you elect to let the text flow around the figure, then remember that you will have to insert a separate text box for the caption, otherwise the figure caption is likely to become separated from the figure.

When importing a graph from Excel into Word, it is often helpful to special-paste it in as a \quotation{Picture (Enhanced Meta-file)}. This saves file memory for Word documents. Be aware that the usual Copy --> Paste procedure will copy the entire Excel spreadsheet into your Word file. The Copy --> Paste Special --> Picture (Enhanced Metafile) command copies only the graph as a static picture.

If you decide to use color traces in your graphical data, be absolutely certain that there is no ambiguity about your graphical information when printed on a B\&W printer.

Here is a common example of what can go wrong with the numbering and sizing of axis titles on a graph. In this case, the graph was initially pasted at a much larger size than the column width, and then reduced to fit:

\placefigure
  {Example of an improperly titled figure. The numerics and the labels on the axes are illegible. This will cause a submission to be rejected. Don’t let this happen to you!}
  {\externalfigure[figure-2][width=.98\textwidth]}

Table I on the second page was inserted using \quotation{Insert}, \quotation{Text Box}, creating the text contained in Table I, and then formatting the text box using all the settings available under \quotation{Format}, \quotation{Text Box…}. Table I also serves as an illustration of one of the rare instances when the double column format requirement can be violated. Certain figures and tables will require the full-page width to display. It is usually best to place these figures and tables at the top or bottom, rather than in the middle of a page. Tables should be entered within a single column if this can be done cleanly, without the entry becoming too crowded.

\section{Citing Previous Work}

When referencing a journal article [1], a conference digest article [2] or a book [3], place the reference numbers within square brackets. To simultaneously cite these references [1]-[3] use the format just demonstrated. The reference list is the last section and references are listed in the order cited. Use 9 point Times. The paragraph description is set for a line spacing of exactly 10 points with 0 point spacing before and after. A 0.25 inch hanging indention should be specified.

Generally speaking, references should be very detailed. For journal articles, list all authors by initials and last name, the title of the paper in quotations (capitalizing only the first letter of the first word, unless it would be capitalized in a sentence, e.g., a proper noun), the journal name in italics, the volume number, the issue number, the page numbers, and the date. Use the examples provided [1]–[3] as a guide.

\section{File Submission Formats}

Beginning in 2004, the IEEE has mandated that all published papers comply with certain IEEE conference standards for electronic searchability. Please note that a detailed checklist is available on the submission site to help guide authors through the task of converting their Word documents into PDFs. Going forward, this will ensure compatibility with the new search requirements for the IEEE Xplore database.

Therefore for RFIC2009, we ask all authors to convert their Word documents to Portable Document Format (PDF), prior to submission for verification purposes. A simple and specific guideline is posted on the submission site. This will also avoid some of the pitfalls associated with having the author submit a paper using Word, and then having an automated system convert it to PDF without a through check. As always, with a conversion to PDF, authors should very carefully check a printed copy. Some conversion problems that have been known to occur are:

\startitemize[n][stopper={)}]

\item A full 4-page Word document may \quotation{spill over} onto a fifth page, upon being converted.

\item A text box that overlays a graph in Word might disappear when converted to PDF. This depends on how the graph was pasted into the Word document (the text box may become covered by the graphic in the PDF).

\item Arrows in a drawing may become slightly discon-nected from their stems, and/or shifted in position.

\item Check all special symbols and equations, especially right-hand brackets.

\item Don’t expect the two bottom lines of a double column to line-up exactly with each other.
Authors should perform a careful check to catch minor nuisances and resolve any problems encountered.

\stopitemize

To ensure compatibility with the new search requirements for the IEEE Xplore database and maintain the quality of the published work, we require you to submit your final manuscript electronically in two formats:
\startitemize[text,n][stopper=,lefttext=]%
\item pdf file, and
\item the source file. The accepted source file formats are: MS Word, TeX DVI format, Adobe Framemaker interchange format or RTF format, and (La)TeX. All source files must be contained in a single file such as a single MS Word (.doc), rich text (.rtf) or Framemaker (.fm) file. For (La)TeX source files, create a single ZIP-file which contains the DVI-file and the corresponding EPS-files for the graphics. Name the ZIP-file \filename{xxxx_dvi.zip}, where the \filename{xxxx} part of the name is whatever you wish.
\stopitemize

\section{Conclusion}

Although reading these instructions may have been an unpleasant experience, following them will improve the quality of your paper and the RFIC Digest. Table I summarizes much of the detail provided and illustrates one of the rare instances where the double column format can be violated. If you have comments, suggestions, or are willing to volunteer your time to improve these instructions, please contact one of the RFIC TPC Co-Chairs.

\subject{Acknowledgement}

The authors wish to acknowledge the assistance and support of the RFIC Steering Committee.

\stopcolumns

\stoptext

[-- Attachment #2: s-ieee.tex --]
[-- Type: application/octet-stream, Size: 2724 bytes --]

\unprotect

%%%% Fonts

\usetypescript[postscript]
\setupbodyfont[postscript,10pt]

\definefont [Title]       [Serif       at 18pt]
\definefont [AuthorList]  [Serif       at 12pt]
\definefont [Affiliation] [Serif       at 12pt]
\definefont [Heading]     [SerifCaps   at 10pt]
\definefont [Subheading]  [SerifItalic at 10pt]
\definefont [Abstract]    [SerifBold   at  9pt]

\setupbodyfontenvironment [9pt][interlinespace=10pt]
\setupbodyfontenvironment[10pt][interlinespace=12pt]
\setupbodyfontenvironment[12pt][interlinespace=14pt]
\setupbodyfontenvironment[18pt][interlinespace=22pt]


%%%% Environments

\definestartstop
  [abstract]
  [style=Abstract]


%%%% Layout

%% Papersize

\setuppapersize[letter][letter]

%% Margins

\setuplayout
  [header=0pt,
   footer=0pt,
   top=1.125in,
   bottom=1.125in,
   backspace=0.85in,
   width=middle,
   height=fit]

%% Columns

\setupcolumns
  [distance=.25in]

%% Sections

\setupsection
  [section]
  [conversion=R]

\setupsection
  [subsection]
  [conversion=A,
   previousnumber=no]

%% Headings

\setupheads
  [indentnext=yes]

\setuphead
  [section]
  [style=Heading,
   align=middle,
   numbercommand=\groupedcommand{}{.},
   before={\blank[18pt]},
   after={\blank[6pt]}]

\setuphead
  [subsection]
  [style=Subheading,
   align=right,
   numbercommand=\groupedcommand{}{.},
   before={\blank[6pt]},
   after={\blank[6pt]}]

%% Captions

\setupcaption
  [figure]
  [headstyle=,
   width=max]

\setupcaption
  [table]
  [headstyle=,
   conversion=R,
   location=top]

%% Floats

\setupfloat
  [table]
  [inner=\ss]

%% Indenting

\setupindenting[yes,0.125in]

%% Itemize

\setupitemize[each][packed,joinedup]


%%%% Document title

\definesystemvariable {dt} % DocumentTitle

\def\setuptitle
  {\dodoubleempty\dosetuptitle}

\def\dosetuptitle[#1][#2]%
  {\ifsecondargument
     \dodosetuptitle[#1][#2]%
   \else
     \dodosetuptitle[\v!content][#1]%
   \fi}

\def\dodosetuptitle[#1][#2]%
  {\def\dododosetuptitle##1%
     {\getparameters[\??dt##1][#2]}%
   \processcommalist[#1]\dododosetuptitle}

\def\placetitle
  {\startalignment[\v!middle]
   %\blank[\v!force,2*\v!big]
   \doattributes{\??dt\c!title}\c!style\c!color\@@dtcontenttitle
   \blank[6pt]
   \doattributes{\??dt\c!author}\c!style\c!color\@@dtcontentauthor
   \blank[6pt]
   \doattributes{\??dt affiliation}\c!style\c!color\@@dtcontentaffiliation
   \blank[18pt]
   \stopalignment}

\setuptitle
  [\c!title]
  [\c!style=Title,
   \c!color=]

\setuptitle
  [\c!author,affiliation]
  [\c!style=AuthorList,
   \c!color=]

\setuptitle
  [\c!title=,
   \c!author=,
   affiliation=]


%%%% Language specific settings

\setuplabeltext[en][figure={{Fig.~},{.}}]
\setuplabeltext[en][table=TABLE~]

\protect \endinput

[-- Attachment #3: Type: text/plain, Size: 685 bytes --]


Am 28.12.2008 um 16:56 schrieb Aditya Mahajan:

> On Sun, 28 Dec 2008, Brecht Machiels wrote:
>
>> Looking at the countless documents that show off ConTeXt, it is  
>> obvious that it is very much possible of creating custom layouts.  
>> However, I wonder, how much TeX hacking is required?
>
> I have submitted around 3-4 IEEE conference documents using ConTeXt.  
> I am attaching my private t-IEEE.tex module, which takes care of  
> formatting things in IEEE format. I also have a bbl file for  
> formatting in IEEE style, which is used by the above module.

I wrote a style too based on the information Machiel used in his style
and I got from the example document.

Wolfgang


[-- Attachment #4: Type: text/plain, Size: 487 bytes --]

___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: specific document layout with ConTeXt

[Aditya Mahajan]

On Sun, 28 Dec 2008, Wolfgang Schuster wrote:

> Am 28.12.2008 um 16:56 schrieb Aditya Mahajan:
> 
> > On Sun, 28 Dec 2008, Brecht Machiels wrote:
> >
> > > Looking at the countless documents that show off ConTeXt, it is 
> obvious that it is very much possible of creating
> > > custom layouts. However, I wonder, how much TeX hacking is required?
> >
> > I have submitted around 3-4 IEEE conference documents using ConTeXt. I 
> am attaching my private t-IEEE.tex module,
> > which takes care of formatting things in IEEE format. I also have a bbl 
> file for formatting in IEEE style, which is
> > used by the above module.
> 
> I wrote a style too based on the information Machiel used in his style
> and I got from the example document.

Your style is cleaner than mine in certain places. I will try to merge them into
my style the next time I work on this style.

BTW, why use the terse conversion=A|R, rather than the more versbose Characters
and Romannumberals. We are not trying to make context code look like latex, are
we? ;-)

Aditya
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: specific document layout with ConTeXt

[John Devereux]

Aditya Mahajan <adityam@umich.edu> writes:

> On Sun, 28 Dec 2008, Brecht Machiels wrote:
>
>> Looking at the countless documents that show off ConTeXt, it is
>> obvious that it is very much possible of creating custom
>> layouts. However, I wonder, how much TeX hacking is required?
>
> I have submitted around 3-4 IEEE conference documents using ConTeXt. I
> am attaching my private t-IEEE.tex module, which takes care of
> formatting things in IEEE format. I also have a bbl file for
> formatting in IEEE style, which is used by the above module.
>
> Unfortunately, I do not have any documentation (this was meant to be a
> private module). It also has a lot of private macros which are not
> layout specific, but I use them in almost all my documents. I haven't
> used this style in almost 6 months, so they may not conform to the
> latest spec. (IEEE keeps on changing specs with time and with
> conferences, which is a bit frustating).
>
> If others are interested, I can also release it on ConTeXt garden and
> provide some documentation.
>
> Aditya

Hi Aditya,

In general I find other peoples "templates" very educational.

> PS: In your environment file you have
>
> \setuplayout[
>   header          = 0pt,
>   footer          = 0pt,
>   headerdistance  = 0pt,
>   footerdistance  = 0pt,
>   top             = 1.125in,
>   topdistance     = 0pt,
>   bottom          = 1.125in,
>   bottomdistance  = 0pt,
>   leftedge        = 0.85in,
>   rightedge       = 0.85in,
>   height          = fit]
>
> ConTeXt will silently ignore all of this. You must not have space
> between keywords and options. Write this as

I've been using context, on and off, for 5 years and I did not know
that!

Does anyone know if there is a way to get context to stop when it sees
an unknown option, instead of silently ignoring it?

[...]

-- 

John Devereux
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: specific document layout with ConTeXt

[Aditya Mahajan]

On Sun, 28 Dec 2008, John Devereux wrote:

> Aditya Mahajan <adityam@umich.edu> writes:
>
> In general I find other peoples "templates" very educational.
>
>> PS: In your environment file you have
>>
>> \setuplayout[
>>   header          = 0pt,
>>   footer          = 0pt,
>>   headerdistance  = 0pt,
>>   footerdistance  = 0pt,
>>   top             = 1.125in,
>>   topdistance     = 0pt,
>>   bottom          = 1.125in,
>>   bottomdistance  = 0pt,
>>   leftedge        = 0.85in,
>>   rightedge       = 0.85in,
>>   height          = fit]
>>
>> ConTeXt will silently ignore all of this. You must not have space
>> between keywords and options. Write this as
>
> I've been using context, on and off, for 5 years and I did not know
> that!
>
> Does anyone know if there is a way to get context to stop when it sees
> an unknown option, instead of silently ignoring it?

The way this is dealt with in the core is by specifying options using 
\c!header, etc. This has two advantages: First we get a multi-lingual 
interface for free. Second any typos in the keys are caught. This does not 
catch "mistakes" like giving an new option to a command, for example 
specifying headstyle=something to \setuphead (headstyle is valid for 
\setupitemgroup, but not for \setuphead).

There is, however, no way of catching "errors" like

height= fit,

Here context thinks that height is set to " fit" (with the space), and 
this does not match any of the cases in the code, so is ignored.

Aditya
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: specific document layout with ConTeXt

[Andrea Valle]

[-- Attachment #1.1: Type: text/plain, Size: 1898 bytes --]

>
>> PS: In your environment file you have
>>
>> \setuplayout[
>>   header          = 0pt,
>>   footer          = 0pt,
>>   headerdistance  = 0pt,
>>   footerdistance  = 0pt,
>>   top             = 1.125in,
>>   topdistance     = 0pt,
>>   bottom          = 1.125in,
>>   bottomdistance  = 0pt,
>>   leftedge        = 0.85in,
>>   rightedge       = 0.85in,
>>   height          = fit]
>>
>> ConTeXt will silently ignore all of this. You must not have space
>> between keywords and options. Write this as
>
> I've been using context, on and off, for 5 years and I did not know
> that!

I understood that after many testings. I think it should be specified  
very clearly in docs.

Best

-a-


--------------------------------------------------
Andrea Valle
--------------------------------------------------
CIRMA - DAMS
Università degli Studi di Torino
--> http://www.cirma.unito.it/andrea/
--> http://www.myspace.com/andreavalle
--> andrea.valle@unito.it
--------------------------------------------------

- La Repubblica promuove lo sviluppo della cultura e la ricerca  
scientifica e tecnica.
- La Repubblica detta le norme generali sull'istruzione ed istituisce  
scuole statali per tutti gli ordini e gradi.
(Costituzione della Repubblica Italiana, art. 9 e 33)



--------------------------------------------------
Andrea Valle
--------------------------------------------------
CIRMA - DAMS
Università degli Studi di Torino
--> http://www.cirma.unito.it/andrea/
--> http://www.myspace.com/andreavalle
--> andrea.valle@unito.it
--------------------------------------------------

"The objectives of SuperCollider have been taken a stage further with  
the development of SAOL, the fruits of a research project based at  
MIT, launched in 1998"
(P. Manning, Electronic and Computer Music, revised and expanded  
edition, 2004)


[-- Attachment #1.2: Type: text/html, Size: 15614 bytes --]

[-- Attachment #2: Type: text/plain, Size: 487 bytes --]

___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: specific document layout with ConTeXt

[Brecht Machiels]

Hello,

A big thanks to both Aditya and Wolfgang for their example 
styles/documents. This will help me (and perhaps also others) get 
familiar with ConTeXt much faster than any manual could. Aditya, could 
you also post a document that uses the IEEE module? It is not clear to 
me how I should specify the title, for example.

Wolfgang's module looks very clean and is even somewhat similar to the 
way Lout's report class can be configured by means of the parameters. 
This, I like alot and is basically what I was looking for in ConTeXt.

Unfortunately there is no small caps included in URW Times. I have tried 
installing the Gyre fonts, but that was not very successful. What is the 
easiest way to end up with a SC Times font? Or should I just fake it 
using a construct simular to what is described in 
http://www.ntg.nl/pipermail/ntg-context/2006/020929.html? This will not 
allow me to specify it as a style to \setuphead however, I assume?

Kind regards,
Brecht

PS. Sorry for not properly replying to the thread. But I only subscribed 
  just now and Mailman does not support retrieving old messages...
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: specific document layout with ConTeXt

[Wolfgang Schuster]

Am 29.12.2008 um 00:56 schrieb Brecht Machiels:

> Hello,
>
> A big thanks to both Aditya and Wolfgang for their example styles/ 
> documents. This will help me (and perhaps also others) get familiar  
> with ConTeXt much faster than any manual could. Aditya, could you  
> also post a document that uses the IEEE module? It is not clear to  
> me how I should specify the title, for example.

\article[title for the document]

or

\setvariables[article][title={title for the document}]

\article % without brackets

> Wolfgang's module looks very clean and is even somewhat similar to  
> the way Lout's report class can be configured by means of the  
> parameters. This, I like alot and is basically what I was looking  
> for in ConTeXt.
>
> Unfortunately there is no small caps included in URW Times. I have  
> tried installing the Gyre fonts, but that was not very successful.  
> What is the easiest way to end up with a SC Times font? Or should I  
> just fake it using a construct simular to what is described in http://www.ntg.nl/pipermail/ntg-context/2006/020929.html? 
>  This will not allow me to specify it as a style to \setuphead  
> however, I assume?

I used LuaTeX for the document, to use it with pdfTeX you need a few
additional settings.

- replace \usetypescript[postscript] with \usetypescript[postscript][ec]
- if you use a older ConTeXt version, add \usetypescriptfile[type-gyr]
   to the style file
- add \enableregime[utf] to the sample document

Wolfgang

___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: specific document layout with ConTeXt

[Brecht Machiels]

Hello,

> I used LuaTeX for the document, to use it with pdfTeX you need a few
> additional settings.
> 
> - replace \usetypescript[postscript] with \usetypescript[postscript][ec]
> - if you use a older ConTeXt version, add \usetypescriptfile[type-gyr]
>   to the style file
> - add \enableregime[utf] to the sample document

Both solutions worked (once I got 'texexec --lua' working anyway).

In your original style file, you put:
\setupbodyfontenvironment [9pt][interlinespace=10pt]

I assume this should set the interline spacing of the Abstract section 
to 10pt? This doesn't work however. I assume this is because the style 
option to \definestartstop[abstract] does not change the bodyfont, and 
thus not the interline spacing.

I have tried using \setupinterlinespace in the 
\definestartstop[abstract], but to no avail.

Regards,
Brecht
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: specific document layout with ConTeXt

[Wolfgang Schuster]

Am 29.12.2008 um 18:55 schrieb Brecht Machiels:

> Hello,
>
>> I used LuaTeX for the document, to use it with pdfTeX you need a few
>> additional settings.
>> - replace \usetypescript[postscript] with \usetypescript[postscript] 
>> [ec]
>> - if you use a older ConTeXt version, add \usetypescriptfile[type- 
>> gyr]
>>  to the style file
>> - add \enableregime[utf] to the sample document
>
> Both solutions worked (once I got 'texexec --lua' working anyway).
>
> In your original style file, you put:
> \setupbodyfontenvironment [9pt][interlinespace=10pt]
>
> I assume this should set the interline spacing of the Abstract  
> section to 10pt? This doesn't work however. I assume this is because  
> the style option to \definestartstop[abstract] does not change the  
> bodyfont, and thus not the interline spacing.
>
> I have tried using \setupinterlinespace in the  
> \definestartstop[abstract], but to no avail.


\definestartstop
   [abstract]
   [style={\switchtobodyfont[9pt]\bf}]

Wolfgang

___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: specific document layout with ConTeXt

[Brecht Machiels]

Wolfgang Schuster wrote:
> Am 29.12.2008 um 18:55 schrieb Brecht Machiels:
> 
>> Hello,
>>
>>> I used LuaTeX for the document, to use it with pdfTeX you need a few
>>> additional settings.
>>> - replace \usetypescript[postscript] with \usetypescript[postscript][ec]
>>> - if you use a older ConTeXt version, add \usetypescriptfile[type-gyr]
>>>  to the style file
>>> - add \enableregime[utf] to the sample document
>>
>> Both solutions worked (once I got 'texexec --lua' working anyway).
>>
>> In your original style file, you put:
>> \setupbodyfontenvironment [9pt][interlinespace=10pt]
>>
>> I assume this should set the interline spacing of the Abstract section 
>> to 10pt? This doesn't work however. I assume this is because the style 
>> option to \definestartstop[abstract] does not change the bodyfont, and 
>> thus not the interline spacing.
>>
>> I have tried using \setupinterlinespace in the 
>> \definestartstop[abstract], but to no avail.
> 
> 
> \definestartstop
>   [abstract]
>   [style={\switchtobodyfont[9pt]\bf}]

I had also tried this... but this results in some weird effects. Using:
\setupbodyfontenvironment [9pt][interlinespace=10pt]
it does not seem to change the interline spacing (when comparing it to
\setupbodyfontenvironment [9pt][interlinespace=12pt]
)

Trying to see what is going on, I try:
\setupbodyfontenvironment [9pt][interlinespace=20pt]
and I get something that cannot be correct:
http://homes.esat.kuleuven.be/~bmachiel/rfic/template.pdf

Any ideas?
Brecht
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: specific document layout with ConTeXt

[Wolfgang Schuster]

Am 29.12.2008 um 19:52 schrieb Brecht Machiels:

> Wolfgang Schuster wrote:
>> Am 29.12.2008 um 18:55 schrieb Brecht Machiels:
>>> Hello,
>>>
>>>> I used LuaTeX for the document, to use it with pdfTeX you need a  
>>>> few
>>>> additional settings.
>>>> - replace \usetypescript[postscript] with  
>>>> \usetypescript[postscript][ec]
>>>> - if you use a older ConTeXt version, add \usetypescriptfile[type- 
>>>> gyr]
>>>> to the style file
>>>> - add \enableregime[utf] to the sample document
>>>
>>> Both solutions worked (once I got 'texexec --lua' working anyway).
>>>
>>> In your original style file, you put:
>>> \setupbodyfontenvironment [9pt][interlinespace=10pt]
>>>
>>> I assume this should set the interline spacing of the Abstract  
>>> section to 10pt? This doesn't work however. I assume this is  
>>> because the style option to \definestartstop[abstract] does not  
>>> change the bodyfont, and thus not the interline spacing.
>>>
>>> I have tried using \setupinterlinespace in the  
>>> \definestartstop[abstract], but to no avail.
>> \definestartstop
>>  [abstract]
>>  [style={\switchtobodyfont[9pt]\bf}]
>
> I had also tried this... but this results in some weird effects.  
> Using:
> \setupbodyfontenvironment [9pt][interlinespace=10pt]
> it does not seem to change the interline spacing (when comparing it to
> \setupbodyfontenvironment [9pt][interlinespace=12pt]
> )
>
> Trying to see what is going on, I try:
> \setupbodyfontenvironment [9pt][interlinespace=20pt]
> and I get something that cannot be correct:
> http://homes.esat.kuleuven.be/~bmachiel/rfic/template.pdf
>
> Any ideas?

Try a newer LuaTeX version.

Wolfgang


___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: specific document layout with ConTeXt

[richard.stephens]

Aditya wrote:
>
> If others are interested, I can also release it on ConTeXt garden and
> provide some documentation.
>
> Aditya
>

Please, please, please can you (or someone) post on the wiki? I was looking
for a two-column layout for and IFAC conference which is very similar to
IEEE and I ended-up writing my own.  I'm not a ConTeXt programmer so it was
all done in the document itself rather than setting environments etc, so
the source code looked awful.  You example, and Wolfgang's, look much much
nicer and I cannot wait to try one of them out.

Thanks,

Richard


Converteam UK Ltd. Registration Number: 5571739 and Converteam Ltd. Registration Number: 2416188  
Registered in England and Wales.  
Registered office: Boughton Road, Rugby, Warwickshire, CV21 1BU.  

CONFIDENTIALITY : This e-mail and any attachments are confidential and may be privileged. If you are not a named recipient, please notify the sender immediately and do not disclose the contents to another person, use it for any purpose or store or copy the information in any medium.  

Please consider the environment before printing this e-mail 
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: specific document layout with ConTeXt

[Aditya Mahajan]

On Mon, 5 Jan 2009, richard.stephens@converteam.com wrote:

> Aditya wrote:
>>
>> If others are interested, I can also release it on ConTeXt garden and
>> provide some documentation.
>>
>> Aditya
>>
>
> Please, please, please can you (or someone) post on the wiki? I was looking
> for a two-column layout for and IFAC conference which is very similar to
> IEEE and I ended-up writing my own.  I'm not a ConTeXt programmer so it was
> all done in the document itself rather than setting environments etc, so
> the source code looked awful.  You example, and Wolfgang's, look much much
> nicer and I cannot wait to try one of them out.

I will merge the code from Wolfgang's and my examples and put it into a 
module in a week or so.

Aditya
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________