From 273b76dcd2208b1ec892b19752d928cb5dce2246 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 11 Sep 2010 23:13:58 +0000 Subject: confproc 0.7 (6aug10) git-svn-id: svn://tug.org/texlive/trunk@19668 c570f23f-e606-0410-a88d-b1316a301751 --- .../texmf-dist/source/latex/confproc/confproc.drv | 114 + .../texmf-dist/source/latex/confproc/confproc.dtx | 10782 +++++++++++++------ .../texmf-dist/source/latex/confproc/confproc.ins | 70 +- 3 files changed, 7720 insertions(+), 3246 deletions(-) create mode 100644 Master/texmf-dist/source/latex/confproc/confproc.drv (limited to 'Master/texmf-dist/source/latex/confproc') diff --git a/Master/texmf-dist/source/latex/confproc/confproc.drv b/Master/texmf-dist/source/latex/confproc/confproc.drv new file mode 100644 index 00000000000..2a2d97c0e14 --- /dev/null +++ b/Master/texmf-dist/source/latex/confproc/confproc.drv @@ -0,0 +1,114 @@ +%% +%% This is file `confproc.drv', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% confproc.dtx (with options: `driver') +%% +%% This is `confproc.drv', the documentation driver for the confproc package. +%% Copyright (c) 2010 by Vincent Verfaille +%% +%% This file is part of the confproc package. +%% ------------------------------------------- +%% +%% It may be distributed and/or modified under the conditions of the +%% LaTeX Project Public License, either version 1.2 of this license or +%% (at your option) any later version. +%% +%% The latest version of this license is in +%% http://www.latex-project.org/lppl.txt +%% and version 1.2 or later is part of all distributions of LaTeX version +%% 1999/12/01 or later. +%% +%% This file may not be distributed without the original source file +%% `confproc.dtx'. +%% +%% The list of all files belonging to the confproc package is given in +%% the `readme.txt' file. +%% +%% This is the driver file to produce the LaTeX documentation +%% from the original source file `confproc.dtx'. +%% +%% Make changes to it as needed. (Never edit the file `confproc.dtx'!) +%% +\def\docdate{2010/08/05} +\NeedsTeXFormat{LaTeX2e}[1994/12/01]% +\ProvidesFile{confproc.drv} + [2010/08/05 v0.7: Driver for confproc (VV)] + % We do not specify any options by default and its recommended not to + % change this. If you want to use a4paper the proper way is to add + % a line + % \PassOptionsToClass{a4paper}{article} + % to your `ltxdoc.cfg'. +\documentclass{ltxdoc} + % Only use fontenc if it is present + \IfFileExists{fontenc.sty}{% + \usepackage[T1]{fontenc}}{} +\usepackage{mathptmx} +\usepackage[super]{nth} +\usepackage{graphicx} +\usepackage{url} +\usepackage{amssymb,amsmath} +\usepackage{manfnt} +\usepackage{xcolor} +\usepackage[braces]{colordoc} +\usepackage{layout} +\RequirePackage[pdftex,colorlinks=true,linkcolor=blue!80!black,citecolor=blue!80!black,% + urlcolor=blue!80!black,bookmarksopen=true,bookmarksopenlevel=1,raiselinks,% + hyperindex,backref,pagebackref,plainpages=false,pdfpagelabels,% + breaklinks,linktocpage=false,pdfstartview=XYZ]{hyperref} +\usepackage{supertabular} + + % By default this file will build the `user' documentation. It + % covers the basic information you need as an user and provides + % (if you want to) a compact index with the most important + % commands. To get the `programmer' documentation (with code + % listing, extended command index and change history), comment out + % the next line + + % To produce the compact command index: + % run makeindex -s confproc.ist confproc + + % If you commented out \OnlyDescription, you are able to control the + % index and change history with the following commands: + + % To produce the extended command index: add the following line + % one run, then run makeindex -s gind.ist confproc + % and re-process, with or without this line (much faster without) + % + % This will only have an effect if you commented out + % \OnlyDescription above! +\EnableCrossrefs + + % Next you can control the index numbering by the two commands + % \PageIndex and \CodelineIndex (I prefer the latter one..). If + % you don't want any index, comment out both commands. + % + % Description index entries refer to page numbers, code listing + % index entries refer to code lines +\CodelineIndex + % Make all index entries (description and code listing) refer to + % page numbers (if you add the following line you should comment + % out the \CodelineIndex) + + % Produce a 2 column index (if any) + \setcounter{IndexColumns}{2} + +\setlength{\textwidth}{14cm} +\setlength{\headheight}{-1.5cm} +\setlength{\textheight}{22cm} +%% Increase the marginpar width slightly, for long command names. And increase the left margin by a similar amount +\let\oldmarginpar\marginpar +\renewcommand\marginpar[1]{\-\oldmarginpar[\raggedleft\footnotesize #1]% +{\raggedright\footnotesize #1}} + \setcounter{StandardModuleDepth}{1} + + % To produce a change history: add the following line for one run, + % then run makeindex -s gglo.ist -o confproc.gls confproc.glo + % and re-process, with or without this line (faster without) + \RecordChanges + +\begin{document} + \DocInput{confproc.dtx} +\end{document} diff --git a/Master/texmf-dist/source/latex/confproc/confproc.dtx b/Master/texmf-dist/source/latex/confproc/confproc.dtx index b921dcaeedc..bfc7555a453 100644 --- a/Master/texmf-dist/source/latex/confproc/confproc.dtx +++ b/Master/texmf-dist/source/latex/confproc/confproc.dtx @@ -1,8 +1,7 @@ %^^A ================================================================= %^^A Some basic integrity-test stuff %^^A ================================================================= -%^^A\changes{0.1c}{2007/07/31}{Removing checksum} -% \CheckSum{841} +% \CheckSum{1704} % % \iffalse %<*ID> @@ -22,53 +21,51 @@ % Grave accent \` Left brace \{ Vertical bar \| % Right brace \} Tilde \~} %^^A ================================================================= -%^^A Here is a `conference proceedings' package developed for DAFx-06. +%^^A Here is a `conference proceedings' class. %^^A For a short installation guide, see below %^^A ================================================================= %%% @LaTeX-package-file{ %%% author = "Vincent Verfaille", -%%% version = "v0.4f", -%%% date = "$Date: 2007/10/17 00:00:01 $", +%%% version = "v0.7", +%%% date = "$Date: 2010/08/05 00:00:01 $", %%%^^A ^^A\changes{0.1d}{2007/07/31}{Renaming 'procconf' into 'confproc'} -%%% filename = "confproc.dtx, -%%% address = "Vincent Verfaille -%%% Sound Processing and Control Lab. -%%% Input Device and Music Interaction Lab. -%%% Schulich School of Music -%%% McGill University -%%% 555, Sherbrooke street west -%%% Montreal, Quebec, H3A 1E3 -%%% Canada", -%%% URL = "http://www.music.mcgill.ca/musictech/spcl/vincent_verfaille", -%%% email = "vincent@music.mcgill.ca", -%%% codetable = "ISO/ASCII", -%%% keywords = "McGill University, conference proceedings, DAFx-06, -%%% documentclass", -%%% dependencies = "\LaTeXe", -%%% supported = "yes", -%%% abstract = "This is a LaTeX2e package for building conference proceedings. It derives form LaTeX scripts written for the DAFx-06 conference proceedings, mainly based on the \package{pdfpages} package for including the proceedings papers and the \package{hyperref} package for creating proper table of contents, bookmarks and general bibliography back references. It also uses many other packages for fine tuning of table of contents, bibliography and index of authors. The added value of this class is in the time it saves for you to quickly design your proceedings.", -%%% docstring = "When making the DAFx-06 proceedings, I -%%% designed a set of LaTeX macros to simplify the work. -%%% As those secret scripts became relatively popular, I -%%% updated them, under the form of the provided package.", -%%% copyright = "confproc.dtx, the documented macro-file for -%%% the confproc package -%%% Copyright (C) 2007 by Vincent Verfaille -%%% +%%% filename = "confproc.dtx, +%%% address = "Vincent Verfaille, Montreal, QC, Canada", +%%% URL = "http://vincent.verfaille.free.fr/confproc/", +%%% email = "verf[...].confproc@gmail.com", +%%% codetable = "ISO/ASCII", +%%% keywords = "conference, proceedings, documentclass, build, tools", +%%% dependencies = "\LaTeXe", +%%% supported = "yes", +%%% abstract = " Confproc is a LaTeX2e package providing a new document-class together +%%% with various tools (Perl and Unix/bash scripts) for building conference +%%% proceedings, or concatenating any set of PDFs with a table of contents, +%%% index, bookmarks and general bibliography. The LaTeX2e class is mainly +%%% based on the 'pdfpages' package for PDF papers inclusion, and the +%%% 'hyperref' package for creating proper links, bookmarks and general +%%% bibliography back references. It also uses many other packages for fine +%%% tuning the table of contents, bibliography and index of authors. +%%% Current version 0.7 is a major update with key-value option management. +%%% The added value of this class is in the time saved to quickly design +%%% conference proceedings or any collection of PDFs." +%%% docstring = "LaTeX2e package providing a new document-class together +%%% with various tools (Perl and Unix/bash scripts) for building conference +%%% proceedings, or concatenating any set of PDFs with a table of contents, +%%% index, bookmarks and general bibliography.", +%%% copyright = "confproc.dtx, the documented macro-file for the confproc package +%%% Copyright (c) 2010 by Vincent Verfaille +%%% %%% -%%% This program may be distributed and/or -%%% modified under the conditions of the LaTeX -%%% Project Public License, either version 1.2 -%%% of this license or (at your option) any -%%% later version. +%%% This program may be distributed and/or modified under the conditions +%%% of the LaTeX Project Public License, either version 1.2 of this license +%%% or (at your option) any later version. %%% -%%% The latest version of this license is in -%%% http://www.latex-project.org/lppl.txt -%%% and version 1.2 or later is part of all -%%% distributions of LaTeX version 1999/12/01 or -%%% later. +%%% The latest version of this license is in +%%% http://www.latex-project.org/lppl.txt +%%% and version 1.2 or later is part of all distributions of LaTeX version +%%% 1999/12/01 or later. %%% -%%% This program consists of the confproc.dtx file." +%%% This program consists of the confproc.dtx file." %%% } % % @@ -76,8 +73,18 @@ %^^A ================================================================= %^^A Purpose of this package %^^A ================================================================= -% This is a LaTeX2e package providing a new document-class for building conference -% proceedings. It derives form LaTeX scripts written for the DAFx-06 conference proceedings. +% +% Confproc is a LaTeX2e package providing a new document-class together +% with various tools (Perl and Unix/bash scripts) for building conference +% proceedings, or concatenating any set of PDFs with a table of contents, +% index, bookmarks and general bibliography. The LaTeX2e class is mainly +% based on the \package{pdfpages} package for PDF papers inclusion, and the +% \package{hyperref} package for creating proper links, bookmarks and general +% bibliography back references. It also uses many other packages for fine +% tuning the table of contents, bibliography and index of authors. +% Current version 0.7 is a major update with key-value option management. +% The added value of this class is in the time saved to quickly design +% conference proceedings or any collection of PDFs. % %^^A ================================================================= %^^A Installation of this package @@ -87,7 +94,7 @@ % confproc.ins, readme.txt AND the (LaTeX2e) % documentation % (La)TeX confproc.ins: creates class file confproc.cls, example -% file example.tex and documentation +% file exampleN.tex and documentation % driver confproc.drv % % Docstrip options available: @@ -99,7 +106,7 @@ % % \fi % \iffalse -%^^A\changes{0.1a}{2007/07/27}{Readme: updated!} +%\changes{0.1}{2007/08/01}{Readme updated} %<*readme> %^^A ================================================================= %^^A Here is the readme.txt file @@ -108,99 +115,119 @@ \begin{filecontents*}{readme.txt} The confproc package - ($Date: 2007/10/17 00:00:01 $) + ($Date: 2010/08/05 00:00:01 $) - Copyright (C) 2007 by Vincent Verfaille - + Copyright (c) 2010 by Vincent Verfaille + Purpose: - This is a LaTeX2e package providing a new document-class - for building conference proceedings, mainly based on the - 'hyperref' and 'pdfpages' packages. + Confproc is a LaTeX2e package providing a new document-class together + with various tools (Perl and Unix/bash scripts) for building conference + proceedings, or concatenating any set of PDFs with a table of contents, + index, bookmarks and general bibliography. The LaTeX2e class is mainly + based on the 'pdfpages' package for PDF papers inclusion, and the + 'hyperref' package for creating proper links, bookmarks and general + bibliography back references. It also uses many other packages for fine + tuning the table of contents, bibliography and index of authors. + Current version 0.7 is a major update with key-value option management. + The added value of this class is in the time saved to quickly design + conference proceedings or any collection of PDFs. Files: - confproc.dtx Docstrip archive - --> To generate the doc, run this through LaTeX. - -Generated File: - confproc.ins Batch file, run through LaTeX. - --> Generated by running confproc.dtx through LaTeX. - confproc.drv Driver for documentation. - The file will be generated from confproc.ins - To generate customized documentation, edit this - file and run it through LaTeX. - confproc.cls LaTeX package. - --> Generated by running confproc.ins through LaTeX. - confproc.cfg Configuration file. - --> Generated by running confproc.ins through LaTeX. - confproc.dvi Package documentation. - --> Generated from confproc.drv. - - example.tex Example file demonstrating how to use this package. - --> Generated by running confproc.ins through LaTeX. - expapersswitch.tex Example of paper switch, to simplify paper insertion. - --> Generated by running confproc.ins through LaTeX. - exclasspre.tex Class and options declaration for the 1st LaTeX runs. - --> Generated by running confproc.ins through LaTeX. - exclasslast.tex Class and options declaration for the last LaTeX run. - --> Generated by running confproc.ins through LaTeX. - exbiblio.bib Bibliography for the example. - --> Generated by running confproc.ins through LaTeX. - - procswitchandtoc.pl Perl script used to generate the program (ie. - expaperswitch.tex) from the exprogram.csv file. - --> Generated by running confproc.ins through LaTeX. - exprogram.csv Example of comma-separated program of the conference. - --> Generated by running confproc.ins through LaTeX. - - buildproc Unix script to build the example proceedings. - --> Generated by running confproc.ins through LaTeX. - buildpapers Unix script to re-build all the papers. - --> Generated by running confproc.ins through LaTeX. - buildcppdfpapers Unix script to copy all PDf papers in the right spot. - --> Generated by running confproc.ins through LaTeX. - - readme.txt This file. - --> Generated by running confproc.dtx through LaTeX. + - main file: + confproc.dtx Docstrip archive + To generate the doc, run this through LaTeX. + + - class files: + confproc.ins Batch file (do: pdflatex confproc.dtx) + confproc.drv Driver for documentation (do: pdflatex confproc.ins) + Edit to generate customized doc + pdflatex confproc.drv + confproc.cls LaTeX package (do: pdflatex confproc.ins) + confproc.cfg Configuration file (do: pdflatex confproc.ins) + confproc.dvi Package documentation (do: pdflatex confproc.drv) + + - example files (do: pdflatex confproc.ins): + confproc1.ist Index style + confproc2.ist Index style + example1empty.tex Simplest example file + example2custom.tex Customized example file + example3optim.tex Idem with automatic program generation + example4optim.tex Idem with option management + expapersswitch.tex Paper switch for paper insertion + exsessions.tex Program sessions + exclasspre.tex Class options for 1st pdflatex runs on 'example4optim.tex' + exclasslastpb.tex Class options for last pdflatex run (paperback version) + exclasslastel.tex Class options for last pdflatex run (electronic version) + exbiblio.bib Bibliography for example*optim.tex + exprogram.csv Comma-separated conference program + newapave.bst Bibliography style from 'newapa.bst' + newapave.sty Bibliography style from 'newapa.sty' + + - example scripts (do: pdflatex confproc.ins): + prepareexample.sh Unix/bash script to prepare example files and + folders (used it after running LaTeX on .dtx and .ins) + buildproc.sh Unix/bash script: build the 'example3optim.tex' example + buildprocelpb.sh Unix/bash script: build the 'example4optim.tex' + example with paperback and electronic PDF versions + & individual papers extracted + buildpapers.sh Unix/bash script: re-build all the papers + buildcppdfpapers.sh Unix/bash script: copy papers to the right spot + countnbpages.sh Unix/bash script: count PDFs nb of pages + Requires 'pdftk' to be installed. Get it from: + http://www.pdftk.com or http://www.accesspdf.com/pdftk/ + exportIndividualPDFs.sh Unix/bash scrit using pdftk to extract + each individual paper from the proceedings, + for proper page numbering and headers. + Requires 'pdftk' and 'Ghostscript' to be installed. + generateswitch.pl Perl script generating 'expapersswitch.tex' + from 'exprogram.csv'. + Requires Perl to be installed. + papersinfo.sh Unix/bash script to generate individual PDFs + with proper metadata. Requires 'pdftk' to be installed. + paperssplitpreamble.sh preamble of a Unix/bash script (papersplit.sh) + generated by exportIndividualPDFs.sh + removeLaTeXcmds.sh Unix/bash script to remove LaTeX accents and + commands for titles in PDF metadata. + Requires Perl to be installed. + + +Read me: + readme.txt This file (do: pdflatex confproc.dtx) -Installation: - LaTeX confproc.dtx Creates docstrip installation file +Installation: + pdflatex confproc.dtx Creates docstrip installation file confproc.ins and this file - (La)TeX confproc.ins Creates class file confproc.cls, example - files and scripts and documentation driver - confproc.drv + pdflatex confproc.ins Creates 'confproc.cls' class file, example + files, scripts and documentation drive 'confproc.drv' Docstrip options available: package - to produce a (LaTeX2e) class file (.cls) driver - to produce a driver file to print the documentation example - to produce an example file, which demonstrates the - possibilities of the package + possibilities of the package Move confproc.cls into a directory searched by LaTeX. - LaTeX confproc.dtx Creates the (LaTeX2e) documentation. - - optionally: - Edit confproc.drv and customize the documentation to your wishes. - LaTeX confproc.drv Generates customized documentation. - Depending on your customization you will - have to run - makeindex confproc.idx -s gind.ist -o confproc.ind - and/or - makeindex confproc.glo -s gglo.ist -o confproc.gls - LaTeX example.tex Demonstrates the possibilities of this - package. + pdflatex confproc.dtx Creates the (LaTeX2e) documentation. + +optionally: + Edit confproc.drv and customize the documentation to your wishes. + LaTeX confproc.drv Generates customized documentation. + Depending on your customization you will have to run + makeindex confproc.idx -s gind.ist -o confproc.ind + and/or + makeindex confproc.glo -s gglo.ist -o confproc.gls + pdfLaTeX example*.tex Demonstrate the possibilities of this package. + Contact: - E-Mail: vincent@music.mcgill.ca - Address: Vincent Verfaille, Schulich School of Music, - McGill University, 555 Sherbrooke street west, - Montreal, Quebec, H3A 1E3, Canada + E-Mail: verf[...].confproc@gmail.com + Address: Vincent Verfaille, Montreal, QC, Canada Legal stuff: readme.txt, the ReadMe file for the confproc package - Copyright (C) 2007 by Vincent Verfaille - + Copyright (c) 2010 by Vincent Verfaille + This file is part of the confproc package. ------------------------------------------- @@ -234,24 +261,335 @@ Legal stuff: \end{filecontents*} % % -%^^A\changes{0.1d}{2007/08/01}{Adding the confproc.ist creation.} -%<*indexstyle> +%\changes{0.1}{2007/08/01}{Class package finished. Switching to docstrip} +%\changes{0.1}{2007/08/01}{Adding creation of all Unix scripts and example files (using \cmd{\nopreamble} and \cmd{\nopostamble}} +%<*installer> %^^A ================================================================= -%^^A Here is the creation of the index style file confproc.ist +%^^A Here is the docstrip installation file %^^A It is written on first LaTeX run if it does not already exist %^^A ================================================================= -\begin{filecontents*}{confproc.ist} +\begin{filecontents}{confproc.ins} +%% confproc.ins, the batch file for the confproc package +%% Copyright (c) 2010 by Vincent Verfaille +%% %% -%% This is file `confproc.ist', -%% generated with the docstrip utility. +%% This file is part of the confproc package. +%% ------------------------------------------- %% -%% The original source files were: +%% It may be distributed and/or modified under the conditions of the +%% LaTeX Project Public License, either version 1.2 of this license or +%% (at your option) any later version. +%% +%% The latest version of this license is in +%% http://www.latex-project.org/lppl.txt +%% and version 1.2 or later is part of all distributions of LaTeX +%% version 1999/12/01 or later. +%% +%% In particular, NO PERMISSION is granted to modify the contents of +%% this file since it contains the legal notices that are placed in +%% the files it generates. +%% +%% This file may not be distributed without the original source file +%% confproc.dtx. +%% +%% The list of all files belonging to the confproc package is given +%% in the `readme.txt' file. +%% +%% This file will generate fast loadable files and documentation +%% driver files from the .dtx files in this package when run through +%% LaTeX or TeX. +%% +%% ------------------- start of docstrip commands ------------------- +\def\batchfile{confproc.ins} +\input docstrip.tex +% +\ifToplevel{\ifx\askonceonly\undefined% +\Msg{******************}% +\Msg{*}% +\Msg{* This installation requires docstrip}% +\Msg{* version 2.4e or later.}% +\Msg{*}% +\Msg{* An older version of docstrip has been input}% +\Msg{*}% +\Msg{******************}% +\errhelp{Move or rename old docstrip.tex.}% +\errmessage{Old docstrip in input path}% +\batchmode% +\csname @@end\endcsname% +\fi% +}% +% +%% Define standard text: +% +\def\nline{^^J\MetaPrefix\space}% +\def\stdtext{% +Copyright (c) 2010 by Vincent Verfaille + \nline\nline% +This file is part of the confproc package.\nline% +-------------------------------------------\nline\nline% +It may be distributed and/or modified under the conditions of the\nline% +LaTeX Project Public License, either version 1.2 of this license or\nline% +(at your option) any later version.\nline\nline% +The latest version of this license is in\nline% +\space\space http://www.latex-project.org/lppl.txt\nline% +and version 1.2 or later is part of all distributions of LaTeX version\nline% +1999/12/01 or later.\nline\nline% +This file may not be distributed without the original source file\nline% +`\inFileName'.\nline\nline% +The list of all files belonging to the confproc package is given in\nline% +the `readme.txt' file.} +% +%% Declare preambles (and use \stdtext): +% +\declarepreamble\driver + +This is `\outFileName', the documentation driver for the confproc package. +\stdtext + +This is the driver file to produce the LaTeX documentation +from the original source file `\inFileName'. + +Make changes to it as needed. (Never edit the file `\inFileName'!) + +\endpreamble% +% +\declarepreamble\package + +This is `\outFileName', a LaTeX2e package to build conference proceedings. +\stdtext + +For more details, LaTeX the source `\inFileName'. + +\endpreamble% +% +\declarepreamble\scripts +\endpreamble% +% +\declarepreamble\example + +This is `\outFileName', an example file for the confproc package. +\stdtext + +For more details, LaTeX the source `\inFileName'. + +\endpreamble% +% +\declarepreamble\config + +This is `\outFileName', a configuration file for the confproc package. +\stdtext + +For more details, LaTeX the source `\inFileName'. + +\endpreamble% +% +\keepsilent% +% +%% Greeting: +% +\askforoverwritefalse +%%\askforoverwritetrue% uncomment if you wish to avoid over-writing a file +%%\askonceonly% better of commented as it asks SEVERAL times +% +\ifToplevel{% + \Msg{}% + \Msg{**********************}% + \Msg{* Hello to the installation of the `confproc' package. *}% + \Msg{**********************}% + \Msg{}% + \Msg{*********}% + \Msg{* Generating files... *}% + \Msg{*********}% +}% +% +%% File generation: +% +\generate{% + \nopreamble\nopostamble\file{prepareexample.sh}{\from{confproc.dtx}{prepareexample}}% + \usepreamble\example\file{example1empty.tex}{\from{confproc.dtx}{example1empty}}% + \file{example2custom.tex}{\from{confproc.dtx}{example2custom}}% + \file{example3optim.tex}{\from{confproc.dtx}{example3optim}}% + \file{expapersswitch.tex}{\from{confproc.dtx}{expapersswitch}}% + \file{expages.tex}{\from{confproc.dtx}{expages}}% + \nopreamble\nopostamble\file{exclasspre.tex}{\from{confproc.dtx}{exclasspre}}% + \file{exclasslastel.tex}{\from{confproc.dtx}{exclasslastel}}% + \file{exclasslastpb.tex}{\from{confproc.dtx}{exclasslastpb}}% + \file{exbiblio.bib}{\from{confproc.dtx}{exbiblio}}% + \file{generateswitch.pl}{\from{confproc.dtx}{generateswitch}}% + \file{exprogram.csv}{\from{confproc.dtx}{exprogram}}% + \file{buildpapers.sh}{\from{confproc.dtx}{buildpapers}}% + \file{buildproc.sh}{\from{confproc.dtx}{buildproc}}% + \file{buildprocelpb.sh}{\from{confproc.dtx}{buildprocelpb}}% + \file{buildcppdfpapers.sh}{\from{confproc.dtx}{buildcppdfpapers}}% + \file{countnbpages.sh}{\from{confproc.dtx}{countnbpages}}% + \file{removeLaTeXcmds.sh}{\from{confproc.dtx}{removeLaTeXcmds}}% + \file{exportIndividualPDFs.sh}{\from{confproc.dtx}{exportIndividualPDFs}}% + \file{papersinfo.sh}{\from{confproc.dtx}{papersinfo}}% + \file{paperssplitpreamble.sh}{\from{confproc.dtx}{paperssplitpreamble}}% +% \nopreamble\nopostamble\file{newapave.bst}{\from{confproc.dtx}{newapavebst}}% +% \nopreamble\nopostamble\file{newapave2.sty}{\from{confproc.dtx}{newapavesty}}% DO NOT UNCOMMENT OTHERWISE IT STRIPS A SECONDTIME THE COMMENTS... +% \usepreamble\example\file{example4optim.tex}{\from{confproc.ins}{example4optim}}% +% \usedir{tex/latex/misc}% + \usepreamble\driver\file{confproc.drv}{\from{confproc.dtx}{driver}}% + \usepreamble\config\file{confproc.cfg}{\from{confproc.dtx}{config}}% + \usepreamble\package\file{confproc.cls}{\from{confproc.dtx}{package}% + \nopreamble\nopostamble\file{buildcls.sh}{\from{confproc.dtx}{buildcls}}% + \nopreamble\nopostamble\file{cleancls.sh}{\from{confproc.dtx}{cleancls}}% + }% +}% +% +%% Report: +% +\ifToplevel{% + \Msg{}% + \Msg{********************}% + \Msg{*}% +\makeatletter\@ifundefined{basedir}{% + \Msg{* To finish the installation you have to move the following}% + \Msg{* file into a directory searched by LaTeX:}% +}{% + \Msg{* The following file has been automatically created in a}% + \Msg{* directory searched by LaTeX:}% +}\makeatother% + \Msg{*}% + \Msg{* \space\space confproc.cls}% + \Msg{*}% +\makeatletter\@ifundefined{basedir}{% + \Msg{* Using a TDS compatible TeX distribution, this would be e.g.}% + \Msg{* tex/latex/misc of your main or your local or your private}% + \Msg{* texmf path. If you don't know these paths, have a look}% + \Msg{* at your `texmf.cnf' or try:}% + \Msg{* \space\space kpsexpand \string\$TEXMFMAIN}% + \Msg{* \space\space kpsexpand \string\$TEXMFLOCAL}% + \Msg{* \space\space kpsexpand \string\$HOMETEXMF}% + \Msg{* You may also use another folder at your TEXINPUTS path.}% +}{}\makeatother% + \Msg{* To produce the documentation and a example, run the}% + \Msg{* following files through LaTeX:}% + \Msg{*}% + \Msg{* \space\space confproc.drv (three times)}% + \Msg{* \space\space exampleN.tex}% + \Msg{*}% + \Msg{* For the legal stuff please have a look at:}% + \Msg{*}% + \Msg{* \space\space readme.txt}% + \Msg{*}% + \Msg{*}% + \Msg{* Happy TeXing!}% + \Msg{*}% + \Msg{********************}% + \Msg{}% +}% +\endbatchfile +\end{filecontents} +% +% +%^^A\changes{0.1c}{2007/07/30}{Head: new} +%^^A ================================================================= +%^^A Here is the header that is written to driver-, example- and +%^^A class-file +%^^A ================================================================= +% +% The docdate info. It specifies the date of the documentation, which +% may differ from the filedate. (Its ok if docdate is younger. If it +% is older, then I forgot documenting. In that case: kick me... ;-) +%<*dtx|driver> +\def\docdate{2010/08/05} +% +% +% The required LaTeX version: +%<*dtx|driver|package|example> +\NeedsTeXFormat{LaTeX2e}[1994/12/01]% +% +% +% Identification of the docstrip file: +%<*dtx> +\ProvidesFile +%===================================================================== + {confproc.dtx} +%===================================================================== +% +% +% Identification of the driver file: +%\ProvidesFile{confproc.drv} +% +% Identification of the example files: +% +% \ProvidesFile{example1empty.tex} +% \ProvidesFile{example2custom.tex} +% \ProvidesFile{example3optim.tex} +% \ProvidesFile{expapersswitch.tex} +% \ProvidesFile{expages.tex} +% \ProvidesFile{exclasspre.tex} +% \ProvidesFile{exclasslastel.tex} +% \ProvidesFile{exclasslastpb.tex} +% \ProvidesFile{exbiblio.bib} +% \ProvidesFile{generateswitch.pl} +% \ProvidesFile{exprogram.csv} +% \ProvidesFile{buildpapers.sh} +% \ProvidesFile{buildproc.sh} +% \ProvidesFile{buildprocelpb.sh} +% \ProvidesFile{buildcppdfpapers.sh} +% \ProvidesFile{countnbpages.sh} +% \ProvidesFile{removeLaTeXcmds.sh} +% \ProvidesFile{exportIndividualPDFs.sh} +% \ProvidesFile{papersinfo.sh} +% \ProvidesFile{paperssplitpreamble.sh} +% +% Identification of the configuration file: +%\ProvidesFile{confproc.cfg} +% +% Identification of the package file: +%\ProvidesClass{confproc} +% +% Provide command to identify example files: +%\def\DescribesFile#1 [#2 #3 #4 (#5)] +% {\def\filedate{#2}\def\fileversion{#3}} +% +% Identification of the example files: +%\DescribesFile{confproc.cls} +% +% The next three lines: +% 1.: Identification of the included .dtx-file. +% 2.: The date and version for docstrip, driver, example, config, package and dtx file. +% 3.: A short description and author for the included .dtx-file. +% \fi +% \ProvidesFile{confproc} +% [2010/08/05 v0.7: Documentation for confproc (VV)] +% \iffalse +% +% A short description and author for driver, example, config +% and package file: +% [2010/08/05 v0.7: Conference Proceedings class (VV)] +% [2010/08/05 v0.7: Example for confproc (VV)] +% [2010/08/05 v0.7: Configuration for confproc (VV)] +% [2010/08/05 v0.7: Driver for confproc (VV)] +% +% A short description and author for the docstrip file: +%<*dtx> + [2010/08/05 v0.7: Documented source for confproc (VV)] +% +% +% +% +% +% +%<*indexstyle> +%\changes{0.1}{2007/08/01}{added the creation of \file{confproc.ist} file} +%\changes{0.6}{2009/08/18}{Modified \file{confproc.ist} with lines} +%^^A ================================================================= +%^^A Here is the creation of the first index style file confproc1.ist +%^^A It is written on first LaTeX run if it does not already exist +%^^A ================================================================= +\begin{filecontents*}{confproc1.ist} %% -%% confproc.dtx (with options: `doc') +%% This is file `confproc1.ist', generated with the docstrip utility. +%% The original source files were: +%% confproc.dtx (with options: `doc') %% -%% This is `confproc.ist', an index formatting example, for the confproc package. -%% Copyright (C) 2007 by Vincent Verfaille -%% +%% This is `confproc1.ist', an index formatting example, for the confproc package. +%% Copyright (c) 2010 by Vincent Verfaille +%% %% %% This file is part of the confproc package. %% ------------------------------------------- @@ -284,31 +622,85 @@ delim_0 "\\dotfill" delim_1 "\\dotfill" delim_2 "\\dotfill" \end{filecontents*} -% -% -% -%^^A\changes{0.1d}{2007/08/01}{Adding the \package{threecolindex.sty} creation} -%^^A\changes{0.2a}{2007/08/12}{Removing the \package{threecolindex.sty} file: corresponding cmds moved into the class!} -% -%^^A\changes{0.1d}{2007/08/01}{Installer: adding newapave.bst.} -%<*newapavebst> -\begin{filecontents*}{newapave.bst} -%$$$ newapave.bst $$$ -% BibTeX `newapave' style file for BibTeX version 0.99c, LaTeX version 2e -% Place it in a file called newapave.bst in the BibTeX search path. -%(Placing it in the same directory as the LaTeX document should also work.) -% Support for named citations is provided by named.sty +% +%^^A ================================================================= +%^^A Here is the creation of the second index style file confproc2.ist +%^^A It is written on first LaTeX run if it does not already exist +%^^A ================================================================= +\begin{filecontents*}{confproc2.ist} +%% +%% This is file `confproc2.ist', generated with the docstrip utility. +%% The original source files were: +%% confproc.dtx (with options: `doc') +%% +%% This is `confproc2.ist', an index formatting example, for the confproc package. +%% Copyright (c) 2010 by Vincent Verfaille +%% +%% +%% This file is part of the confproc package. +%% ------------------------------------------- +%% +%% It may be distributed and/or modified under the conditions of the +%% LaTeX Project Public License, either version 1.2 of this license or +%% (at your option) any later version. +%% +%% The latest version of this license is in +%% http://www.latex-project.org/lppl.txt +%% and version 1.2 or later is part of all distributions of LaTeX version +%% 1999/12/01 or later. +%% +%% This file may not be distributed without the original source file +%% `confproc.dtx'. +%% +%% The list of all files belonging to the confproc package is given in +%% the file `readme.txt'. +%% +%% For more details, LaTeX the source `confproc.dtx'. +%% + +%%--add a letter between 2 lists, and horizontal lines + slashes around letters +heading_prefix "{\\bfseries\\hfil------/\\hfil " +heading_suffix "\\hfil/------\\hfil}\\nopagebreak\n" +headings_flag 1 + +%%-- Add lines with points between name and page numbers +delim_0 "\\dotfill" +delim_1 "\\dotfill" +delim_2 "\\dotfill" +\end{filecontents*} +% +% +% +%\changes{0.1d}{2007/08/01}{added the \package{threecolindex.sty} creation} +%\changes{0.2a}{2007/08/12}{removed \package{threecolindex.sty} file: corresponding cmds moved into the class} +% +% +%\changes{0.1}{2007/08/01}{Installer: adding \file{newapave2.sty}} +%^^A ================================================================= +%^^A Here is the creation of the bibliography style file newapave.bst +%^^A It is written on first LaTeX run if it does not already exist +%^^A ================================================================= +% +% +%\changes{0.1}{2007/08/01}{Installer: added \file{newapave.bst}} +%<*newapavebst> +\begin{filecontents*}{newapave.bst} +%$$$ newapave.bst $$$ +% BibTeX `newapave' style file for BibTeX version 0.99c, LaTeX version 2e +% Place it in a file called newapave.bst in the BibTeX search path. +%(Placing it in the same directory as the LaTeX document should also work.) +% Support for named citations is provided by named.sty % % This version was modified by V. Verfaille, from the already modified master file made by % Oren Patashnik, and the 'named' BibTeX style of Peter F. Patel-Schneider. % -% Copyright (C) 2006, all rights reserved. +% Copyright (c) 2006, all rights reserved. % Copying of this file is authorized only if either % (1) you make absolutely no changes to your copy, including name, or % (2) if you do make changes, you name it something other than 'newapave.bst'. % There are undoubtably bugs in this style. If you make bug fixes, % improvements, etc. please let me know. My e-mail address is: -% vincent@music.mcgill.ca +% verf[...].confproc@gmail.com % % This style was made from 'plain.bst', 'named.bst', and 'apalike.bst', % with lots of tweaking to make it look like APA style, along with tips @@ -510,7 +902,7 @@ FUNCTION {output.year.check} } { write$ ", " year * "." * "~\hfill " * % shorter and simpler without label (2002a, 2002b useless) -%% ", " year * extra.label * "." * " \Pointinghand{} " * % shorter +% ", " year * extra.label * "." * " \Pointinghand{} " * % shorter mid.sentence 'output.state := % mid.sentence 'output.state := * "}" } @@ -1764,14 +2156,15 @@ EXECUTE {end.bib} \end{filecontents*} % % -%^^A\changes{0.1d}{2007/08/01}{Installer: adding newapave.sty.} -%<*newapavesty> +% +%\changes{0.1}{2007/08/01}{Installer: added \file{newapave2.sty}} %^^A ================================================================= -%^^A Here is the creation of the bibliography style file newapave.sty +%^^A Here is the creation of the bibliography style file newapave2.sty %^^A It is written on first LaTeX run if it does not already exist %^^A ================================================================= -\begin{filecontents*}{newapave.sty} -%$$$ newapave.sty $$$ --- July 31, 2006 (Version 2.1) +%<*newapavesty> +\begin{filecontents*}{newapave2.sty} +%$$$ newapave2.sty $$$ --- July 15, 2010 (Version 2.21) % - Version 2.1. % % This file implements citations for the ``newapave'' bibliography style. @@ -1820,7 +2213,7 @@ EXECUTE {end.bib} % The difference between `\shortciteXXX' and `\citeXXX': % is that `\shortciteXXX' gives `First author et al.' % if no. authors >= 3. -% +% % \shortcite[optional notes]{Key(s)} % -> (Short Authors1, Year1; Short Authors2, Year2; ..., optional notes) % \shortciteA[optional notes]{key} @@ -1957,7 +2350,7 @@ EXECUTE {end.bib} \def\@biblabel#1{} \newlength{\bibhang} %\setlength{\bibhang}{1em} % ORIGINAL -\setlength{\bibhang}{0.5em} % DAFx-06 +\setlength{\bibhang}{0.5em} % DAFx-06 % \def\thebibliography#1{% \section*{\bibname} @@ -1967,7 +2360,7 @@ EXECUTE {end.bib} \setlength{\itemindent}{-\bibhang} \setlength{\leftmargin}{\bibhang}} % \def\newblock{\hskip .11em plus .33em minus .07em} % ORIGINAL - \def\newblock{\hskip 0em plus 0.0em minus .07em} % DAFx-06 + \def\newblock{\hskip 0em plus 0.0em minus .07em} % DAFx-06 \sloppy\clubpenalty4000\widowpenalty4000 \sfcode`\.=1000\relax} % @@ -2043,303 +2436,243 @@ EXECUTE {end.bib} \end{filecontents*} % % -%^^A\changes{0.1b}{2007/07/27}{Class package finished. Switching to docstrip.} -%^^A\changes{0.1d}{2007/08/01}{Adding creation of all Unix scripts and example files (using '\nopreamble' and '\nopostamble'.} -%<*installer> -%^^A ================================================================= -%^^A Here is the docstrip installation file -%^^A It is written on first LaTeX run if it does not already exist -%^^A ================================================================= -\begin{filecontents}{confproc.ins} -%% confproc.ins, the batch file for the confproc package -%% Copyright (C) 2007 by Vincent Verfaille -%% -%% -%% This file is part of the confproc package. -%% ------------------------------------------- -%% -%% It may be distributed and/or modified under the conditions of the -%% LaTeX Project Public License, either version 1.2 of this license or -%% (at your option) any later version. -%% -%% The latest version of this license is in -%% http://www.latex-project.org/lppl.txt -%% and version 1.2 or later is part of all distributions of LaTeX -%% version 1999/12/01 or later. -%% -%% In particular, NO PERMISSION is granted to modify the contents of -%% this file since it contains the legal notices that are placed in -%% the files it generates. -%% -%% This file may not be distributed without the original source file -%% confproc.dtx. -%% -%% The list of all files belonging to the confproc package is given -%% in the file `readme.txt'. -%% -%% This file will generate fast loadable files and documentation -%% driver files from the .dtx files in this package when run through -%% LaTeX or TeX. -%% -%% ------------------- start of docstrip commands ------------------- -\def\batchfile{confproc.ins} -\input docstrip.tex -% -\ifToplevel{\ifx\askonceonly\undefined% -\Msg{******************}% -\Msg{*}% -\Msg{* This installation requires docstrip}% -\Msg{* version 2.4e or later.}% -\Msg{*}% -\Msg{* An older version of docstrip has been input}% -\Msg{*}% -\Msg{******************}% -\errhelp{Move or rename old docstrip.tex.}% -\errmessage{Old docstrip in input path}% -\batchmode% -\csname @@end\endcsname% -\fi% -}% -% -%% Define standard text: -% -\def\nline{^^J\MetaPrefix\space}% -\def\stdtext{% -Copyright (C) 2007 by Vincent Verfaille - \nline\nline% -This file is part of the confproc package.\nline% --------------------------------------------\nline\nline% -It may be distributed and/or modified under the conditions of the\nline% -LaTeX Project Public License, either version 1.2 of this license or\nline% -(at your option) any later version.\nline\nline% -The latest version of this license is in\nline% -\space\space http://www.latex-project.org/lppl.txt\nline% -and version 1.2 or later is part of all distributions of LaTeX version\nline% -1999/12/01 or later.\nline\nline% -This file may not be distributed without the original source file\nline% -`\inFileName'.\nline\nline% -The list of all files belonging to the confproc package is given in\nline% -the file `readme.txt'.} -% -%% Declare preambles (and use \stdtext): % -\declarepreamble\driver - -This is `\outFileName', the documentation driver for the confproc package. -\stdtext - -This is the driver file to produce the LaTeX documentation -from the original source file `\inFileName'. - -Make changes to it as needed. (Never edit the file `\inFileName'!) - -\endpreamble% % -\declarepreamble\package +%^^A ================================================================= +% \changes{0.7}{2010/08/05}{Example: added \file{example4optim.tex}} +%<*example4optim> +\begin{filecontents*}{example4optim.tex} +\usepackage{setspace} +\usepackage{xkeyval} +\usepackage{newapave} +\usepackage[utf8]{inputenc} +\usepackage[T1]{fontenc} +\usepackage{mathptmx} +\usepackage[super]{nth} -This is `\outFileName', a LaTeX2e package to build conference proceedings. -\stdtext +\setlength{\LaTeXxShift}{0pt} +\setlength{\LaTeXyShift}{-3mm} %letter +\setlength{\WordxShift}{10pt} +\setlength{\WordyShift}{-40pt} -For more details, LaTeX the source `\inFileName'. +\definecolor{colorforlink}{rgb}{0,0,0.8} +\definecolor{colorforcite}{rgb}{0,0.8,0} +\definecolor{colorforurl}{rgb}{0,0,1} + +\newcommand{\DAFxname}{Proc.~of the \nth{9} % + Int.~Conference on Digital Audio Effects (DAFx-06)} +\newcommand{\DAFxdate}{September 18-20, 2006} +\newcommand{\DAFxaddress}{Montreal, Canada} + +\renewcommand{\procpdfauthor}{Vincent Verfaille, McGill University} +\renewcommand{\procpdftitle}{DAFx-06 Proceedings - \DAFxaddress} +\renewcommand{\procpdfsubject}{Conference proceedings} + +\renewcommand{\procchead}{} % +\renewcommand{\proclhead}{{\em \small \DAFxname, \DAFxaddress, \DAFxdate}} +\renewcommand{\proccfoot}{{\small DAFX-\thepage}} +\setlength{\procfootvskip}{1.2mm} +\setlength{\procoptfootvskip}{4mm} + +\author{\procpdfauthor} +\title{\DAFxname\\ \DAFxaddress} +\date{\DAFxdate} + +\renewcommand{\contentsname}{Day-by-Day Conference Program} +\renewcommand{\bibname}{General Bibliography} +\renewcommand{\indexname}{List of Authors} +\renewcommand{\PAPERPATH}{papers/} +\newcommand{\PICTPATH}{pictures/} + \newcommand{\TEXTPATH}{} + \newcommand{\BIBPATH}{} +\newcommand{\procbibfile}{\BIBPATH exbiblio} +\newcommand{\myaddhruletotoc}{\vspace*{0.1cm}% + \noindent\protect\hrulefill\par\vspace*{-0.15cm}} +\newcommand{\myaddthickhruletotoc}{\vspace*{0.5cm}% + \noindent\protect\hrule height 0.6ex \hfill\par\vspace*{0.1cm}} +\renewcommand{\procday}[1]{% + \phantomsection% + \addcontentsline{toc}{part}{#1}} % \centerline{#1} +\renewcommand{\session}[1]{% + \phantomsection% + \addcontentsline{toc}{chapter}{#1}} + \renewcommand{\mainmattertocstyle}{ + \titlecontents{section}[2.5em]% + {\vspace*{0.25em}}% + {\hspace*{-2.5em}\contentspage\hspace*{2.5em}}% + {\hspace*{-2.5em}\contentspage\hspace*{2.5em}}% + {}% + \titlecontents{chapter}[0pt]% + {\addvspace{0.5pc}\bfseries\itshape}% + {\myaddhruletotoc\contentsmargin{0pt}\bfseries % + \makebox[0pt][r]{\huge\contentspage\enspace}\large}% + {\myaddhruletotoc\contentsmargin{0pt}\large}% + {}[\addvspace{.3pc}]% + \titlecontents{part}[0pt]% + {\addvspace{0.5pc}\bfseries}% + {\myaddthickhruletotoc\contentsmargin{0pt}\bfseries % + \makebox[0pt][r]{\huge\contentspage\enspace}\large}% + {\myaddthickhruletotoc\contentsmargin{0pt}\large}% + {}[\addvspace{.3pc}]% +} + \renewcommand{\backmattertocstyle}{% + \titlecontents{section}[]{}{}{}{}[]% + \titlecontents{part}% + [0pt]% + {\addvspace{2pc}}% + {\contentspage\hspace*{2.5em}\vspace*{-8mm}\contentsmargin{0pt}% + \bfseries\makebox[0pt][r]{\huge\contentspage\enspace}\large\bfseries}% + {\contentspage\hspace*{2.5em}\vspace*{-8mm}\contentsmargin{0pt}\large\bfseries}% + {}% + [\addvspace{.5pc}]% +}% +%%\renewcommand{\papertitlestyle}{} +\renewcommand{\papertitlestyle}{\texorpdfstring{}{\scshape}} +%%\renewcommand{\paperauthorstyle}{\texorpdfstring{\newline\itshape}{\break}} +\renewcommand{\paperauthorstyle}{\texorpdfstring{, \hfill}{\break}} +\renewcommand{\proctoctitleauthor}[2]{% + \texorpdfstring{{\paperauthorstyle #2}{\papertitlestyle #1}}{{\papertitlestyle #1}}} +\renewcommand{\paperauthorstyle}{\texorpdfstring{\itshape}{}} +\renewcommand{\papertitlestyle}{\texorpdfstring{\newline}{\break}} +\renewcommand{\confstylechecktitle}{\vspace*{0.3cm} % + \bf \sc \Large \noindent \centerline} +\renewcommand{\confstylecheckauthor}{\large \it \noindent \centerline} +\makeindex -\endpreamble% -% -\declarepreamble\example +%%%=========== PROCEEDINGS =========== +\begin{document} -This is `\outFileName', an example file for the confproc package. -\stdtext +\frontmatter +\frontmattertocstyle +%%\layout +%%\begin{figure} +%% \setlayoutscale{0.8} \tocdiagram +%% \caption{Table of Contents entry parameters} \label{fig:tocp} +%%\end{figure} +%%\begin{figure} +%% \setlayoutscale{0.8} \currenttoc \tocdesign +%% \caption{Typical Table of Contents entry for this document} +%% \label{fig:thistoc} +%%\end{figure} +%%\clearsingleordoublepage +\setcounter{page}{1} +\pdfbookmark[0]{Preamble}{preamble} +\pdfbookmark[1]{Cover}{cover} +\maketitle +%%\includepdf[noautoscale,pages=1,link]{\PICTPATH ex_1stpage.pdf} +\addtocontents{toc}{\vskip 1cm} +\addtocontents{toc}{\centerline{\huge\textsc{Conference Program}}} +\renewcommand{\contentsname}{\texorpdfstring{}{Conference Program}} +\newpage +\vspace*{1.7cm} +\pdfbookmark[1]{Publishing informations}{publishing} +\thispagestyle{empty} +\noindent {\bf Published by:}\\ Laboratory Name\\ Department name\\ +School Name\\ University Name\\ +\url{http://www.conferencesite.com}\\ +\vspace*{0.15cm}\newline +\noindent {\bf ISBN: X-XXXX-XXXXXX}\\ +\vspace*{0.35cm}\newline +\noindent {\bf Credits:}\\ +Cover design: Firstname Lastname\\ +Logo photo: Firstname Lastname\\ +\LaTeX{} editor: Firstname Lastname\\ +using \LaTeX's `confproc' package, version 0.7 (optional: by V. Verfaille)\\ +\vspace*{0.35cm}\newline +\noindent Printed in City by Print-Company --- Month Year +\otherpagestyle +%%%-- Welcome letters +\clearsingleordoublepage +\vspace*{0.6cm} +\thisotherpagestyle +\pdfbookmark[1]{Welcome from Firstname Lastname}{welcome} +\section*{Welcome from Firstname Lastname, Conference Chair} +\vspace*{1.1cm} +\onehalfspace +\begin{center} + \begin{minipage}[h]{14cm} + Text of the welcome letter, with 1.5 lines spacing, blah blah... + Text of the welcome letter, with 1.5 lines spacing, blah blah... + Text of the welcome letter, with 1.5 lines spacing, blah blah... + Text of the welcome letter, with 1.5 lines spacing, blah blah... + \end{minipage} +\end{center} +\doublespace +\begin{center} + \begin{minipage}[h]{14cm} + Text of the welcome letter, with 2 lines spacing, blah blah... + Text of the welcome letter, with 2 lines spacing, blah blah... + Text of the welcome letter, with 2 lines spacing, blah blah... + Text of the welcome letter, with 2 lines spacing, blah blah... + \end{minipage} +\end{center} +\singlespace +\tableofcontents -For more details, LaTeX the source `\inFileName'. +%%%==== BEGINNING OF PAPERS ==== +\setcounter{npagespreamble}{\arabic{page}-1} % only useful for the 'pdftk' option +\mainmatter +\mainmattertocstyle +\input{\TEXTPATH expapersswitch} +\procday{Day 1} + \session{Oral Session 1} + \paperid{45}{p_001} + \paperid{21}{p_003} + \session{Poster Session 1} + \paperid{33}{p_005} +\procday{Day 2} + \session{Oral Session 2} + \paperid{75}{p_007} + \paperid{27}{p_009} -\endpreamble% +%%%==== END OF PAPERS ==== +\backmatter +\backmattertocstyle +\bibliographystyle{newapave} +%%\bibliographystyle{newapa} +{\footnotesize\bibliography{\procbibfile}} +\insertindex +\end{document} +\end{filecontents*} +% % -\declarepreamble\config - -This is `\outFileName', a configuration file for the confproc package. -\stdtext - -For more details, LaTeX the source `\inFileName'. - -\endpreamble% % -\keepsilent% % -%% Greeting: % -\askforoverwritetrue% -\askonceonly% +%^^A ================================================================= +%^^A Here is the driver for customized documentation +%^^A ================================================================= +%<*driver> % -\ifToplevel{% - \Msg{}% - \Msg{**********************}% - \Msg{* Hello to the installation of the `confproc' package. *}% - \Msg{**********************}% - \Msg{}% - \Msg{*********}% - \Msg{* Generating files... *}% - \Msg{*********}% -}% + % We do not specify any options by default and its recommended not to + % change this. If you want to use a4paper the proper way is to add + % a line + % \PassOptionsToClass{a4paper}{article} + % to your `ltxdoc.cfg'. +\documentclass{ltxdoc} % -%% File generation: +%\changes{0.1}{2007/08/01}{Doc style: added \package{hyperref} package} + % Only use fontenc if it is present + \IfFileExists{fontenc.sty}{% + \usepackage[T1]{fontenc}}{} +% \changes{0.4b}{2007/10/12}{Pkg: \package{mathptmx} replaces \package{times}} +\usepackage{mathptmx} +% \changes{0.4b}{2007/10/12}{Pkg: \package{nth} for superscript ordinals} +\usepackage[super]{nth} +\usepackage{graphicx} +\usepackage{url} +\usepackage{amssymb,amsmath} +% \changes{0.5}{\datevzfive}{Pkg: \package{manfnt} for `danger' sign} +\usepackage{manfnt} +\usepackage{xcolor} +\usepackage[braces]{colordoc} +\usepackage{layout} +\RequirePackage[pdftex,colorlinks=true,linkcolor=blue!80!black,citecolor=blue!80!black,% + urlcolor=blue!80!black,bookmarksopen=true,bookmarksopenlevel=1,raiselinks,% + hyperindex,backref,pagebackref,plainpages=false,pdfpagelabels,% + breaklinks,linktocpage=false,pdfstartview=XYZ]{hyperref} +%\usepackage[color=orange!40]{todonotes} % [colorinlistoftodos] must be placed AFTER hyperref % -\generate{% - \usepreamble\example\file{example.tex}{\from{confproc.dtx}{example}}% - \usepreamble\example\file{expapersswitch.tex}{\from{confproc.dtx}{expapersswitch}}% - \usepreamble\example\file{expages.tex}{\from{confproc.dtx}{expages}}% - \usepreamble\example\file{exclasspre.tex}{\from{confproc.dtx}{exclasspre}}% - \usepreamble\example\file{exclasslast.tex}{\from{confproc.dtx}{exclasslast}}% - \nopreamble\nopostamble\file{exbiblio.bib}{\from{confproc.dtx}{exbiblio}}% - \nopreamble\nopostamble\file{procswitchandtoc.pl}{\from{confproc.dtx}{procswitchandtoc}}% - \nopreamble\nopostamble\file{exprogram.csv}{\from{confproc.dtx}{exprogram}}% - \nopreamble\nopostamble\file{buildpapers}{\from{confproc.dtx}{buildpapers}}% - \nopreamble\nopostamble\file{buildproc}{\from{confproc.dtx}{buildproc}}% - \nopreamble\nopostamble\file{buildcppdfpapers}{\from{confproc.dtx}{buildcppdfpapers}}% - \usepreamble\driver\file{confproc.drv}{\from{confproc.dtx}{driver}}% - \usepreamble\config\file{confproc.cfg}{\from{confproc.dtx}{config}}% -% \usedir{tex/latex/misc}% - \usepreamble\package\file{confproc.cls}{\from{confproc.dtx}{package}% - \nopreamble\nopostamble\file{buildcls}{\from{confproc.dtx}{buildcls}}% - \nopreamble\nopostamble\file{cleancls}{\from{confproc.dtx}{cleancls}}% - }% -}% -% -%% Report: -% -\ifToplevel{% - \Msg{}% - \Msg{********************}% - \Msg{*}% -\makeatletter\@ifundefined{basedir}{% - \Msg{* To finish the installation you have to move the following}% - \Msg{* file into a directory searched by LaTeX:}% -}{% - \Msg{* The following file has been automatically created in a} - \Msg{* directory searched by LaTeX:} -}\makeatother% - \Msg{*}% - \Msg{* \space\space confproc.cls}% - \Msg{*}% -\makeatletter\@ifundefined{basedir}{% - \Msg{* Using a TDS compatible TeX distribution, this would be e.g.}% - \Msg{* tex/latex/misc of your main or your local or your private}% - \Msg{* texmf path. If you don't know these paths, have a look}% - \Msg{* at your `texmf.cnf' or try:}% - \Msg{* \space\space kpsexpand \string\$TEXMFMAIN}% - \Msg{* \space\space kpsexpand \string\$TEXMFLOCAL}% - \Msg{* \space\space kpsexpand \string\$HOMETEXMF}% - \Msg{* You may also use another folder at your TEXINPUTS path.}% -}{}\makeatother% - \Msg{* To produce the documentation and a example, run the}% - \Msg{* following files through LaTeX:}% - \Msg{*}% - \Msg{* \space\space confproc.drv (three times)}% - \Msg{* \space\space example.tex}% - \Msg{*}% - \Msg{* For the legal stuff please have a look at:}% - \Msg{*}% - \Msg{* \space\space readme.txt}% - \Msg{*}% - \Msg{*}% - \Msg{* Happy TeXing!}% - \Msg{*}% - \Msg{********************}% - \Msg{}% -}% -% -\endbatchfile -\end{filecontents} -% -% -%^^A\changes{0.1c}{2007/07/30}{Head: new} -%^^A ================================================================= -%^^A Here is the header that is written to driver-, example- and -%^^A class-file -%^^A ================================================================= -% -% The docdate info. It specifies the date of the documentation, which -% may differ from the filedate. (Its ok if docdate is younger. If it -% is older, then I forgot documenting. In that case: kick me... ;-) -%<*dtx|driver> -\def\docdate{2007/10/17} -% -% -% The required LaTeX version: -%<*dtx|driver|package|example> -\NeedsTeXFormat{LaTeX2e}[1994/12/01]% -% -% -% Identification of the docstrip file: -%<*dtx> -\ProvidesFile -%===================================================================== - {confproc.dtx} -%===================================================================== -% -% -% Identification of the driver file: -%\ProvidesFile{confproc.drv} -% -% Identification of the example file: -%\ProvidesFile{example.tex} -% -% Identification of the configuration file: -%\ProvidesFile{confproc.cfg} -% -% Identification of the package file: -%\ProvidesClass{confproc} -% -% Provide command to identify example file: -%\def\DescribesFile#1 [#2 #3 #4 (#5)] -% {\def\filedate{#2}\def\fileversion{#3}} -% -% Identification of the example file: -%\DescribesFile{confproc.cls} -% -% The next three lines: -% 1.: Identification of the included .dtx-file. -% 2.: The date and version for docstrip, driver, example, config, -% package and dtx file. -% 3.: A short description and author for the included .dtx-file. -% \fi -% \ProvidesFile{confproc} -% [2007/10/17 v0.4f: Documentation for confproc (VV)] -% \iffalse -% -% A short description and author for driver, example, config -% and package file: -% [2007/10/17 v0.4f: Conference Proceedings class (VV)] -% [2007/10/17 v0.4f: Example for confproc (VV)] -% [2007/10/17 v0.4f: Configuration for confproc (VV)] -% [2007/10/17 v0.4f: Driver for confproc (VV)] -% -% A short description and author for the docstrip file: -%<*dtx> - [2007/10/17 v0.4f: Documented source for confproc (VV)] -% -% -%^^A ================================================================= -%^^A Here is the driver for customized documentation -%^^A ================================================================= -%<*driver> - % - % We do not specify any options by default and its recommended not to - % change this. If you want to use a4paper the proper way is to add - % a line - % \PassOptionsToClass{a4paper}{article} - % to your `ltxdoc.cfg'. -\documentclass{ltxdoc} - -%^^A\changes{0.1f}{2007/08/03}{Doc style: adding hyperref package} - % Only use fontenc if it is present - \IfFileExists{fontenc.sty}{% - \usepackage[T1]{fontenc}}{} -% \changes{0.4b}{2007/10/12}{Pkg: \package{mathptmx} replaces \package{times}} -\usepackage{mathptmx} -% \changes{0.4b}{2007/10/12}{Pkg: \package{nth} for superscript ordinals} -\usepackage[super]{nth} -\usepackage{amssymb,amsmath} -\RequirePackage[pdftex,colorlinks=true,linkcolor=red,citecolor=red,pagecolor=red,urlcolor=blue,bookmarksopen=true,bookmarksopenlevel=1,raiselinks,hyperindex,backref,pagebackref,plainpages=false,pdfpagelabels,breaklinks,linktocpage,pdfstartview=XYZ]{hyperref} - \usepackage{supertabular} %\usepackage{tweaklist} %\renewcommand{\enumhook}{\setlength{\topsep}{0pt}% @@ -2351,7 +2684,7 @@ For more details, LaTeX the source `\inFileName'. % commands. To get the `programmer' documentation (with code % listing, extended command index and change history), comment out % the next line -% \OnlyDescription +%\OnlyDescription % To produce the compact command index: % run makeindex -s confproc.ist confproc @@ -2365,7 +2698,7 @@ For more details, LaTeX the source `\inFileName'. % % This will only have an effect if you commented out % \OnlyDescription above! - \EnableCrossrefs +\EnableCrossrefs % Next you can control the index numbering by the two commands % \PageIndex and \CodelineIndex (I prefer the latter one..). If @@ -2373,15 +2706,28 @@ For more details, LaTeX the source `\inFileName'. % % Description index entries refer to page numbers, code listing % index entries refer to code lines - \CodelineIndex +\CodelineIndex % Make all index entries (description and code listing) refer to % page numbers (if you add the following line you should comment % out the \CodelineIndex) % \PageIndex - % Produce a 2 column index (if ever) + % Produce a 2 column index (if any) \setcounter{IndexColumns}{2} +\setlength{\textwidth}{14cm} +\setlength{\headheight}{-1.5cm} +\setlength{\textheight}{22cm} +%\setlength{\voffset}{-28truept} +%% Increase the marginpar width slightly, for long command names. And increase the left margin by a similar amount +\let\oldmarginpar\marginpar +\renewcommand\marginpar[1]{\-\oldmarginpar[\raggedleft\footnotesize #1]% +{\raggedright\footnotesize #1}} +% \addtolength\marginparwidth{30pt} +% \addtolength\oddsidemargin{20pt} +% \addtolength\evensidemargin{20pt} + \setcounter{StandardModuleDepth}{1} + % To produce a change history: add the following line for one run, % then run makeindex -s gglo.ist -o confproc.gls confproc.glo % and re-process, with or without this line (faster without) @@ -2393,25 +2739,26 @@ For more details, LaTeX the source `\inFileName'. % % \fi % +% +% +% %^^A ================================================================= %^^A We continue with the `normal' .dtx-file %^^A ================================================================= % % %^^A ======= LIST OF GENERAL CHANGES ====== -%^^A\changes{0.1c}{2007/07/30}{Docu: new} +%^^A\changes{0.1c}{2007/07/30}{Doc: new} %^^A\changes{0.1c}{2007/07/30}{Introduction: new} %^^A\changes{0.2d}{2007/08/18}{Index: removing from index all commands not related to the 'confproc' package} %^^A\changes{0.2e}{2007/09/01}{Introduction: reorganized} %^^A\changes{0.2e}{2007/09/01}{Introduction: history shortened} -%^^A \changes{0.3}{2007/09/28}{Docu: typo and spell checks} -% \changes{0.3}{2007/09/24}{Initial version} -% \changes{0.4a}{2007/10/03}{Move formatting issues in re-defined commands} +%^^A \changes{0.3}{2007/09/28}{Doc: typo and spell checks} +% \changes{0.3}{2007/09/24}{initial version} +% \changes{0.4a}{2007/10/03}{move formatting issues in re-defined commands} % \changes{0.4b}{2007/10/12}{changes from Will Robertson's advices} -% \changes{0.4c}{2007/10/12}{Bug correction: author is back in the bookmark} -% \changes{0.4d}{2007/10/12}{Re-organize changes history (use `macro' environment)} -% \changes{0.4e}{2007/10/12}{Clean up the use of \cmd{\DescribeMacro} and \cmd{\begin\{macro\}\{\}} commands} -% \changes{0.4f}{2007/10/7}{Explain that the `draft' option removes the bookmarks} +% \changes{0.4d}{2007/10/12}{re-organize changes history (use `macro' environment)} +% \changes{0.4e}{2007/10/12}{clean up the uses of \cmd{\DescribeMacro} and \cmd{\begin\{macro\}\{\}} commands} % %^^A ================================================================= %^^A Even with enabled crossrefs do not index all macros. @@ -2422,30 +2769,43 @@ For more details, LaTeX the source `\inFileName'. % \DoNotIndex{\@ne} % \DoNotIndex{\@plus} % \DoNotIndex{\@tempboxa, \@tempcnta, \@tempdima} -% \DoNotIndex{\\, \", \{, \}, \&, \ , \', \`, \^, \:, \~} -% \DoNotIndex{\@authorlistbyfirstname} +% \DoNotIndex{\\, \", \{, \}, \&, \ , \', \`, \^, \:, \~, \&, \(, \), \-, \,, \^} +% \DoNotIndex{\{} +% \DoNotIndex{\}} +% \DoNotIndex{\$} +% \DoNotIndex{\.} +% \DoNotIndex{\~} +% \DoNotIndex{\ } +% \DoNotIndex{\1} +% \DoNotIndex{\@arabic} +% \DoNotIndex{\@authorlistbyfirstname} % \DoNotIndex{\@authorlistbysurname} % \DoNotIndex{\@authors} +% \DoNotIndex{\@clubpenalty, \@biblabel, \@latex@warning, \@mainmatterfalse, \@mainmattertrue, \@mkboth, \@openbib@code, \@starttoc, \@twoside} % \DoNotIndex{\@idxitem} +% \DoNotIndex{\@ifnextchar} +% \DoNotIndex{\@m} % \DoNotIndex{\@mparswitchfalse} % \DoNotIndex{\@mparswitchtrue} -% \DoNotIndex{\@twosidefalse } -% \DoNotIndex{\@twosidetrue} +% \DoNotIndex{\@noitemerr} % \DoNotIndex{\@ptsize} % \DoNotIndex{\@restonecolfalse} % \DoNotIndex{\@restonecoltrue} % \DoNotIndex{\@twosidefalse} % \DoNotIndex{\@twosidetrue} -% \DoNotIndex{\addcontentsline} -% \DoNotIndex{\addtocontents} -% \DoNotIndex{\addtolength, \AtEndDocument, \advance} +% \DoNotIndex{\addvspace, \arabic, \AtBeginDocument, \addcontentsline, \addtocontents, \addtocounter, \addtolength, \AtEndDocument, \advance} % \DoNotIndex{\afterassignment} % \DoNotIndex{\begin, \begingroup, \bf, \bfseries, \box} % \DoNotIndex{\baselineskip} -% \DoNotIndex{\bigskip} +% \DoNotIndex{\bigskip, \bibhang, \break} % \DoNotIndex{\caption, \centerline, \ClassError, \ClassWarning, \ClassWarningNoLine} +% \DoNotIndex{\c@enumiv} % \DoNotIndex{\ClassInfo, \CurrentOption, \cdot, \count, \centering, \cleardoublepage, \clearpage, \CodelineIndex} -% \DoNotIndex{\conf@FinalVersion, \conf@BibMerge, \conf@BibBackRef} +% \DoNotIndex{\changes} +% \DoNotIndex{\closeout, \clubpenalty} +% \DoNotIndex{\columnsep} +% \DoNotIndex{\columnseprule} +% \DoNotIndex{\confproc, \conf@FinalVersion, \conf@BibMerge, \conf@BibBackRef} % \DoNotIndex{\conf@procWithColors, \conf@procWithoutColors} % \DoNotIndex{\conf@PrintNoLayout, \conf@PrintAllLayouts} % \DoNotIndex{\conf@NoFancyHeaders, \conf@FancyHeadersOnPapers, \conf@FancyHeadersExceptPapers} @@ -2457,28 +2817,29 @@ For more details, LaTeX the source `\inFileName'. % \DoNotIndex{\conf@procWithDebug} % \DoNotIndex{\conf@IncludePDFs, \conf@DoNotIncludePDFs} % \DoNotIndex{\DeclareRobustCommand, \def, \DeclareOption, \dimen, \divide, \documentclass} -% \DoNotIndex{\em, \else, \end, \ExecuteOptions, \endgroup, \expandafter} +% \DoNotIndex{\em, \else, \end, \ExecuteOptions, \endgroup, \expandafter, \endlist, \enspace, \equal} % \DoNotIndex{\fontfamily, \fontseries, \fontsize, \footnoterule, \footnotesize, \frontmatter} % \DoNotIndex{\fboxrule, \fboxsep \framebox, \fi, \filedate, \fileversion} % \DoNotIndex{\gdef, \global, \GenericWarning} -% \DoNotIndex{\href, \hfill, \hfil, \hskip, \hspace, \hbox, \hss, \hb@xt@, \headheight, \headsep, \hoffset, \hspace} -% \DoNotIndex{\i, \it, \item, \IfFileExists, \InputIfFileExists, \ifx, \if} +% \DoNotIndex{\hline, \hrule, \hrulefill, \Huge \huge, \href, \hfill, \hfil, \hskip, \hspace, \hbox, \hss, \hb@xt@, \headheight, \headsep, \hoffset, \hspace} +% \DoNotIndex{\i, \it, \iffalse, \item, \IfFileExists, \InputIfFileExists, \ifx, \if, \itshape, \itemindent, \ifdefined, \ifnum, \ifthenelse, \immediate, \index, \index@prologue, \input, \itemindent} +% \DoNotIndex{\jobname} % \DoNotIndex{\kern} -% \DoNotIndex{\label, \LARGE, \Large, \large, \let, \lineskip, \LoadClass} -% \DoNotIndex{\line, \linethickness} -% \DoNotIndex{\mainmatter, \mbox, \MessageBreak, \makebox} +% \DoNotIndex{\label, \LARGE, \Large, \large, \let, \lineskip, \LoadClass, \LaTeX, \layout, \leftmaergin, \list, \labelsep, \labelwidth} +% \DoNotIndex{\line, \linethickness, \leftmargin} +% \DoNotIndex{\mainmatter, \mbox, \MessageBreak, \makebox, \makeindex, \MakeUppercase} % \DoNotIndex{\multiput, \m@ne} -% \DoNotIndex{\n, \newcommand, \newlength, \null, \noexpand, \newbox, \newif, \next@tpage, \noindent} -% \DoNotIndex{\o, \oddsidemargin} -% \DoNotIndex{\par, \PackageError, \PackageWarningNoLine, \put, \PageIndex} +% \DoNotIndex{\n, \newcommand, \newlength, \null, \noexpand, \newbox, \newif, \next@tpage, \noindent, \newcounter, \newline, \newpage, \newwrite, \nocite, \normalsize, \nth} +% \DoNotIndex{\o, \oddsidemargin, \openout, \or, \opnecolumn, \onehalfspace, \otherpagestyle} +% \DoNotIndex{\par, \PackageError, \PackageWarningNoLine, \put, \PageIndex, \p@enumiv, \parindent, \parskip, \PassOptionsToPackage, \phantomsection, \printindex} % \DoNotIndex{\PassOptionsToClass, \ProcessOptions, \providecommand, \protect, \parbox, \p@} -% \DoNotIndex{\r, \relax, \renewcommand, \rule, \RequirePackage, \RecordChanges} -% \DoNotIndex{\selectfont, \setcounter, \setlength, \small, \setbox, \space, \stop, \scriptsize} -% \DoNotIndex{\today, \texttt, \typeout, \thinlines, \the, \textwidth, \thispagestyle, \topmargin, \topskip} -% \DoNotIndex{\u, \usepackage, \undefined, \underline, \unitlength, \unkern} +% \DoNotIndex{\r, \relax, \renewcommand, \rule, \RequirePackage, \RecordChanges, \renewenvironment} +% \DoNotIndex{\s, \sc, \scshape, \section, \setkeys, \setlayoutscale, \setpagenumber, \settowidth, \SetupKeyvalOptions, \sfcode, \singlespace, \sloppy, \selectfont, \setcounter, \setlength, \small, \setbox, \space, \stop, \scriptsize} +% \DoNotIndex{\today, \texttt, \typeout, \thinlines, \the, \textwidth, \thispagestyle, \topmargin, \topskip, \textbf, \textheight, \textsc, \theenumiv, \thepage, \tocdesign, \tocdiagram} +% \DoNotIndex{\u, \usepackage, \undefined, \underline, \unitlength, \unkern, \url, \usecounter} % \DoNotIndex{\vfil, \vskip, \vbox, \vss, \vspace, \vfill} -% \DoNotIndex{\voffset} -% \DoNotIndex{\wd} +% \DoNotIndex{\voffset, \value} +% \DoNotIndex{\wd, \whiledo, \widowpenalty, \write} % \DoNotIndex{\x, \xbf} % \DoNotIndex{\z@} % @@ -2502,17 +2863,26 @@ For more details, LaTeX the source `\inFileName'. % ^^A for length registers % \DeclareRobustCommand*{\Llength}[1]{\cmd{#1}} % ^^A for package options -% \DeclareRobustCommand*{\Lopt}[1]{\textsf{#1}} +% \DeclareRobustCommand*{\Lopt}[1]{\textsf{\color{red!100!black}#1}} +% \DeclareRobustCommand*{\LoptDescribe}[1]{\DescribeMacro{#1}\textsf{\color{red!100!black}#1}} +% \DeclareRobustCommand*{\cmdDescribe}[1]{\DescribeMacro{#1}\cmd{#1}} % \DeclareRobustCommand*{\smiley}{|:-)|} % \DeclareRobustCommand*{\winkey}{|;-)|} % \DeclareRobustCommand*{\koma}{\textsf{K\kern.05em O\kern.05em% % M\kern.05em A\kern.1em-\kern.1em Script}} % \DeclareRobustCommand*{\tds}{TDS} +% \DeclareRobustCommand*{\TeXLive}{\TeX{}Live} % \DeclareRobustCommand*{\ctan}{\textsc{ctan}} % \DeclareRobustCommand*{\mail}[2]{\person{#1} % \url{\textless #2\textgreater}} % \DeclareRobustCommand*{\ie}{{\em i.e.}} % \DeclareRobustCommand*{\eg}{{\em e.g.}} +% \DeclareRobustCommand*{\marginBIB}{\marginpar{{\raggedleft\footnotesize \color{blue}\textsc{[bib]}}}} +% \DeclareRobustCommand*{\datevzfive}{2009/08/19} +% \DeclareRobustCommand*{\newvzdseven}{\marginpar{{\raggedleft\color{red!80!black} New [v0.7]}}} +% \DeclareRobustCommand*{\margindanger}{\marginpar{\raggedleft\footnotesize \color{red}\textdbend}} +% \DeclareRobustCommand*{\danger}{{\footnotesize\textdbend~}} +% % %^^A ================================================================= %^^A If there is a multicol.sty present, we'll print the table of @@ -2526,13 +2896,20 @@ For more details, LaTeX the source `\inFileName'. %^^A ================================================================= % \GetFileInfo{confproc} % +%^^A Version depending scripts +% \newcommand{\versionPerl}{} +% \newcommand{\versionpdftk}{1.12} %^^A to update in the text too +% \newcommand{\versionghostscript}{8.71} %^^A to update in the text too +% \newcommand{\currentpkgversion}{0.7} %^^A to update in the text too +% +% +%^^A\changes{0.1g}{2007/08/07}{Typo in my email} %^^A ================================================================= %^^A Title definition %^^A ================================================================= % \title{The \package{\filename}~package\thanks{This file version number is \fileversion~ last revision on \filedate; doc is dated \docdate.}} % \author{Vincent -%^^A\changes{0.1g}{2007/08/07}{Typo in my email} -% Verfaille\thanks{\url{vincent@music.mcgill.ca}}} +% Verfaille\thanks{\url{verf[...].confproc@gmail.com}}} % \date{Printed on \today} % \maketitle % @@ -2541,7 +2918,23 @@ For more details, LaTeX the source `\inFileName'. %^^A A small abstract %^^A ================================================================= % \begin{abstract} -% The \package{\filename} package is a new \LaTeXe\ document-class for building conference proceedings. It derives form LaTeX scripts written for the DAFx-06 conference proceedings, mainly based on the \package{pdfpages} package for including the proceedings papers and the \package{hyperref} package for creating proper table of contents, bookmarks and general bibliography back-references. It also uses many other packages for fine tuning of table of contents, bibliography and index of authors. The added value of this class resides in its time-saving aspects when designing conference proceedings. See \file{readme.txt} for a short overview and additional (legal) information, and \file{example.tex} and corresponding files and scripts for an example of use. +% The \package{\filename} package provided a \LaTeXe\ document-class +% together with various tools (Perl and Unix/bash scripts) for +% building conference proceedings, or concatenating any set of +% PDFs with a table of contents, index and bookmarks. The LaTeX2e +% class derives from \LaTeXe\ scripts written for the DAFx-06 +% conference proceedings. It is mainly +% based on the 'pdfpages' package for PDF papers including, and +% the 'hyperref' package for creating proper links, bookmarks and +% general bibliography back references. It also uses many other +% packages for fine tuning of table of contents, bibliography and +% index of authors. +% Current version 0.7 is a major update with key-value option management. +% The added value of this class is in the time it +% saves for you to quickly design conference proceedings. +% See \file{readme.txt} for a short overview and additional (legal) +% information, and \file{exampleN.tex} and corresponding files and +% scripts for an example of use. % \end{abstract} % % {\parskip 0pt ^^A We have to reset \parskip (bug in \LaTeX, @@ -2550,6 +2943,57 @@ For more details, LaTeX the source `\inFileName'. % \tableofcontents % } % +% +% \newpage +% +%^^A \listoftodos %^^A TO COMMENT OUT FOR FINAL DOC VERSION +% +%^^A ================================================================= +% \subsection*{I do not want to read all this!!!\newvzdseven{}} +% +% Yes, that's a fairly long table of contents... Let me give you some shortcuts: +% \begin{itemize} +% \item \margindanger{}\textbf{very busy people can directly jump to +% section~\ref{sec:twomin:guide} for a first documented +% example, provided they have a full \TeX{}Live installation (at least 2008)}; +% \item smart people can jump to the other and condensed documentation: +% \newvzdseven{}\file{confproc-short.tex},\changes{0.7}{2010/08/05}{Doc: added +% a summary documentation (\file{confproc-short.tex/.pdf}} +% should they come back to this one for more details; +% \item curious people +% should rather read the not so short introduction in section~\ref{sec:usage}---it provides +% some more details, such as the options and commands description---and the full example +% in section~\ref{sec:example3}---which illustrates other functionalities +% such as the general bibliography). +% \item compulsive readers are welcome to read everything, starting from +% the introduction :-). Their comments about the contents, typos, etc.~are much appreciated. +% \item \TeX{} Programmers are not encouraged to read the implementation in +% section~\ref{sec:implement}, as my \LaTeX{} programming skills are, let's say, still improving! +% Their comments are much appreciated too. +% \end{itemize} +% +% \vspace*{2cm} +% +%^^A ================================================================= +% \subsection*{Color code and pictograms\newvzdseven{}} +% +%^^A\changes{0.7}{2010/08/05}{Doc: added color code} +% This documentation uses the following color code: +% \begin{itemize} +% \item {\color{red}red: package options; new in this version (margin notes);} +% \item {\color{blue}blue: reference, URLs, internal links to sections, chapters, etc;} +% \item {\color{black!50}grey: portions of example code that do not differ from similar portions of the last example previously described in the documentation;} +% \item important things to pay attention at are noticed with this `danger' margin sign\margindanger{}; +% \changes{0.7}{2010/08/05}{Doc: added `what's new in version 0.7' margin notes} +% \item new elements in current version are acknowledged with this margin note\newvzdseven{}. +% \changes{0.7}{2010/08/05}{Doc: added `danger' margin pictogram for important things} +% \end{itemize} +% N.B.: this code documentation also uses the \package{colordoc} package, by \person{Federico Garcia} (\ctan: \href{http://www.ctan.org/tex-archive//macros/latex/contrib/colordoc}{macros/latex/contrib/colordoc}). +% \changes{0.7}{2010/08/05}{Doc code: clarified with \package{colordoc}} +% \changes{0.7}{2010/08/05}{Doc code: clarified with grey/black colors (incremental learning)} +% +% \cleardoublepage +% %^^A ================================================================= %^^A Short description of what is done by the package %^^A Miscellaneous comments @@ -2557,142 +3001,286 @@ For more details, LaTeX the source `\inFileName'. % \section{Introduction} % \label{sec:intro} % -%^^A ================================================================= -% \subsection{Short history} -% -% \changes{0.4b}{2007/10/12}{Pkg: \package{nth} for superscript ordinals} -%^^A ================================================================= -%^^A \subsubsection{The origins} +% The provided \package{\filename} class is based on several great packages, among +% which \package{pdfpages} \cite{Matthias:2004:pdfpages} by \person{Andreas Matthias} +% (IMHO, the most useful package to build proceedings) together with \package{hyperref} +% \cite{Oberdiek:2006:hyperref} by \person{Sebastian Rahtz} and \person{Heiko Oberdiek} +% (to manage all PDF and hyperlinks issues). So, you may consider \package{\filename} +% as a time saving package to faster design conference proceedings or a compilation of +% PDFs (such as an article collection). % -% When editing the proceedings of the \nth{9} International Conference on Digital Audio Effects\footnote{DAFx-06: \href{http://www.dafx.ca/dafx06_proceedings.html}{\sf http://www.dafx.ca/dafx06\_proceedings.html}} (DAFx-06, Montr\'eal, Qc, Canada), I developed a set of \LaTeX{} commands to produce the best quality proceedings we could achieve. The developed solution was partially documented on the DAFx-06 website \cite{Verfaille:2006:howto:web} and in a technical report \cite{Verfaille:2006:howto:confproc}. % -% Later on, I created a shorter example version on which other proceedings editors could build up their proceedings. It was used for the 5th International Linux Audio Conference\footnote{LAC2007: \href{http://www.kgw.tu-berlin.de/~lac2007/proceedings.shtml}{\sf http://www.kgw.tu-berlin.de/$\sim$lac2007/proceedings.shtml}} (March 2007, Berlin, Germany; edited by \person{Marije Baalman}); for the 13th International Conference on Auditory Display\footnote{ICAD-07: \href{http://www.music.mcgill.ca/icad2007/proceedings.php}{\sf http://www.music.mcgill.ca/icad2007/proceedings.php}} (June 2007, Montreal, Qc, Canada; edited by \person{Gary Scavone}); for the Journal on Multimodal User Interfaces\footnote{JMUI: \href{http://www.jmui.org/index.php/JMUI/issue/view/1/showToc}{\sf http://www.jmui.org/index.php/JMUI/issue/view/1/showToc}} (Vol. 1(1), 2007; edited by \person{Christian Frisson}); and for the 10th International Conference on Digital Audio Effects\footnote{DAFx-07: \href{http://dafx.labri.fr/}{\sf http://dafx.labri.fr/}} (September 2007, Bordeaux, France; edited by \person{Sylvain Marchand}). % %^^A ================================================================= -%^^A \subsubsection{A class? A package!} +% \subsection{Short history} % -% To better share this example with other users of the \LaTeXe\ community, I converted this set of \LaTeXe\ commands into a document class using the information provided in \cite{LaTeX:class:writers}, and then into a package producing all necessary files (the class, the documentation, the example, the scripts, etc.) using {\sf Docstrip} \cite{mittelbach:1999:docstrip} together with the documentation by \person{Scott Pakin} \cite{Pakin:2004:howto:package}. -% -%^^A ================================================================= -%^^A \subsubsection{Bases} +% \changes{0.4b}{2007/10/12}{Pkg: \package{nth} for superscript ordinals} +% +% When editing the DAFx-06 proceedings, I developed a set of \LaTeXe\ commands to +% produce the best quality proceedings we could achieve thanks to \LaTeXe\. This was +% documented on the DAFx-06 website \cite{Verfaille:2006:howto:web} and in a technical +% report \cite{Verfaille:2006:howto:confproc}. +% Later on, I created a shorter example version, that has been used as a basis by other +% proceedings editors for their own needs (LAC 2007, ICAD 2007, DAFx-07, JMUI). +% For better sharing of this example with other \LaTeXe\ users, I converted the set of +% \LaTeXe{} commands into a document class---thanks to the information provided +% by the \LaTeX{}3 team \cite{LaTeX:class:writers}---and then into a package producing +% all necessary files (\ie{}~the class, the documentation, the example, the scripts, etc---using +% {\sf Docstrip} \cite{mittelbach:1999:docstrip} together with the documentation by +% \person{Scott Pakin}~\cite{Pakin:2004:howto:package}. Then, after using this class with +% new scripts for the ICMC'09 conference proceedings, I wrapped it up into a package +% (\file{.dtx} file) that generates all needed files. % -% The provided \package{confproc} class is based on several great packages, among which \package{pdfpages} \cite{Matthias:2004:pdfpages} by \person{Andreas Matthias} (the most useful package for proceedings making) together with \package{hyperref} \cite{hyperref} by \person{Sebastian Rahtz} and \person{Heiko Oberdiek} (to manage with all PDF and hyperlinks issues). So, you may consider it as a time saving package to faster produce your conference proceedings. % % %^^A\changes{0.2e}{2007/09/01}{Finish to re-test and document the pros/cons of other packages} %^^A ================================================================= -%^^A The rivalry ;-) %^^A ================================================================= % \subsection{Other packages or softwares} % \label{subsec:other} % -% I tried several alternative solutions, before deciding to create my own package. There are so many talented people out there developing great \LaTeX\ packages that I would have preferred to use anybody else's solution! Unfortunately, I have not been able to make any of them work in the way I needed. ^^A I would not say that they are no other `alive' other packages doing the same, since there are! +% I tried several alternative solutions in the fall of 2005. Indeed, there are so many talented people out there developing great \LaTeX\ packages that I would have preferred to use anybody else's solution! Unfortunately, I have not been able to make any of them work in the way I needed. ^^A I would not say that they are no other `alive' other packages doing the same, since there are! +% So I before finally decided to create my own package. % -%^^A ================================================================= -% \subsubsection{Using Acrobat} +% N.B.: since the following information dates back to the fall of 2005, some of the following packages may have evolved in the meantime. Please take a look at them in order to get the latest information (which I obviously did not do)! +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Adobe Acrobat} % % Eventhough it is nothing related to a \LaTeX{} package, nor a free application, the Acrobat Professional software \cite{Adobe:2007:Acrobat} is a solution to create proceedings with proper internal links for a set of PDF papers with internal links. Some useful explanations will help to understand al that has to be done \cite{Brazil:2002}. Indeed, you have to do all the links for the table of contents, the index of authors and the general bibliography by hand. This sounds like hours of work! Would you really plan to do that, and potentially having to re-do it all when discovering any small error, as it happens during both the editing and the printing processes? Any \LaTeX{} solution would provide automatization of proceedings building. % % -%^^A ================================================================= +%^^A------------------------------------------------------------------------ % \subsubsection{The \package{combine} package} % -% The one I would have loved to be able to use is the \package{combine} package by \person{Peter Wilson} \cite{Wilson:2004:combine}, as it was especially designed for the purpose of combining articles into proceedings. It would have been perfect if it did not have incompatibilities with our \package{dafx06.sty} proceedings template (or conference style), since many commands are added in the header file. I encountered problems with the \package{hyperref} package as well as some minor problems with \package{fancyhdr.sty}: eventually, no paper was inserted in the proceedings, and the \LaTeX\ run would always fail (stopped without any notice during the first paper inclusion). Very frustrating, as it was too late for changing our conference proceedings style to make them compatible with \package{combine}. I contacted \person{Peter Wilson}, to which I am indebt for all the precious advices he gave me, among which was the use of a concurrent solution, \ie{} the \package{pdfpages} package! ^^A Many of his comments were motivations for finding my own way in the world of proceedings. +% The one I would have loved to be able to use in 2006 is the \package{combine} package by \person{Peter Wilson} \cite{Wilson:2004:combine}, as it was especially designed for the purpose of combining articles into proceedings. It would have been perfect if it did not have incompatibilities with our \package{dafx06.sty} proceedings template (or conference style), since many commands are added in the header file. I encountered problems with the \package{hyperref} package as well as some minor problems with \package{fancyhdr.sty}: eventually, no paper was inserted in the proceedings, and the \LaTeX\ run would always fail (stopped without any notice during the first paper inclusion). Very frustrating, as it was too late for changing our conference proceedings style to make them compatible with \package{combine}. I contacted \person{Peter Wilson}, to which I am indebt for all the precious advices he gave me, among which was the use of a concurrent solution, \ie{} the \package{pdfpages} package! ^^A Many of his comments were motivations for finding my own way in the world of proceedings. % -%^^A ================================================================= +%^^A------------------------------------------------------------------------ % \subsubsection{The \package{pdfpages} package} % % As no magic solution do exist (yet?), the \package{pdfpages} package by \person{Andreas Matthias} \cite{Matthias:2004:pdfpages} is a very easy way to combine several PDF documents into a single document. Unfortunately, where \package{combine} seemed to be able to preserve internal references of each paper, \package{pdfpages} does not provide such feature, as papers are included as a set of single PDF pages. As I am not a specialist of the PDF format and so on, I can imagine that it is extremely complex to achieve such a feature. Anyway, it means that if your original PDF documents had internal links, hyper-references, links to URL, etc, they will simply be all broken. % % With this in mind, we used this package as a basis (so it then is not a concurrent), especially for the following feature: clicking on a page in the proceedings will open the corresponding paper (with its proper internal links). Simple! % -%^^A ================================================================= -% \subsubsection{The \package{mini.sty} package} +%^^A------------------------------------------------------------------------ +% \subsubsection{The \package{mini} style} % % The \package{mini.sty} package \cite{mini:eConf} does a very good job for concatenating abstracts in a single proceedings document. However, it is not suited (to my knowledge) for conference proceedings, where each paper has to be compiled with the conference style and has its very own title, authors, etc. (that cannot be inserted as (sub)sections). % -%^^A ================================================================= +%^^A------------------------------------------------------------------------ % \subsubsection{The AMS \package{editor} package} % % The \package{editor} package from the AMS \cite{AMS:editor} provides information and documents to produce both the front end and the back end of proceedings, which is of great help to understand all that has to be done (particularly the table of contents and the re-numbering of all papers). However, as they explicitely say it, there is no mechanism to assemble the files together. % % -%^^A\changes{0.2a}{2007/08/12}{Docu: added the description from the report} -% \changes{0.4f}{2007/10/7}{Explain that the `draft' option removes the bookmarks} +%^^A\changes{0.2a}{2007/08/12}{Doc: added the description from the report} +% \changes{0.4f}{2007/10/7}{bug: \Lopt{draft} removes papers from bookmarks} +% \changes{0.5}{\datevfive}{\Lopt{draft} does not remove papers from the bookmarks anymore} %^^A ================================================================= %^^A Description %^^A ================================================================= -% \subsection{Description of the solution provided} +% \subsection{A solution: the \package{\filename} package} +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Short description} % % Using all the knowledge I could find around (and in the previously cited documentations about how to do a good PDF document for the proceedings), together with many tricks I found, this \LaTeX{} class provides the following features: % \begin{enumerate} % \item automatically generates the whole proceedings, after changing any of its paper information (thanks to \LaTeX!); -% \item concatenates papers by inserting several individual documents into one document (with \package{pdfpages}); -% \item provides `clickable' links (hyper-references) from the table of contents, the index of authors and the full bibliography to access to the corresponding page(s) (with \package{hyperref}); -% \item provides access to individual papers: a click on any paper's page opens the corresponding PDF paper (that still has its internal links); this feature comes with \package{pdfpages}. -% \item left-numbers the table of contents (using \package{titlesec}); -% \item displays the index of authors with two or three columns (hack derived from \package{twocolindex}, and using \package{multicolumn}); +% \item concatenates papers by inserting several individual documents into one document (with the \package{pdfpages} package); +% \item provides `clickable' links (hyper-references) from the table of contents, the index of authors and the full bibliography to access to the corresponding page(s) (with the \package{hyperref} \cite{Oberdiek:2006:hyperref} package); +% \item provides access to individual papers: a click on any paper's page opens the corresponding PDF paper (that still has its internal links); this feature comes with the \package{pdfpages} package. +% \item left-aligned page numbers in the table of contents (using the \package{titlesec}) package; +% \item displays the index of authors with two or three columns (hack derived from \package{twocolindex}, and using the \package{multicolumn} package); % \item organizes the bookmarks by proceedings' sections: the preamble, the table of contents, the days/sessions, the full bibliography, and the index of authors. Also, authors' names appear under their relative paper title. -% \item organizes the table of contents: only the index of authors appearing in the table of contents (using \package{tocbibind}); +% \item organizes the table of contents: only the index of authors appearing in the table of contents (using the \package{tocbibind} package); % \item provides full bibliography, or at least help and informations for you to build one, with right-flushed back-reference page numbers. % \item enables fast \LaTeX\ run, using the \Lopt{draft} option of \package{pdfpages}. Useful when repetitively correcting errors, changing the layout (index, bookmarks, table of contents), merging bibliographies, etc. However, note that with this option, \package{pdfpages} does not generate the bookmark data. So, do not use it for final \LaTeX{} runs! -% \item orders the packages. As \package{hyperref} redefines most of LaTeX internal commands, a lot of care has to be taken when ordering the insertion of packages, otherwise some of the features can disappear. +% \item orders the packages. As \package{hyperref} \cite{Oberdiek:2006:hyperref} redefines most of LaTeX internal commands, a lot of care has to be taken when ordering the insertion of packages, otherwise some of the features can disappear. % \item gives information about the merging process involved to generate a general bibliography, as well as about production issues. +% \item offers various \package{bash/Unix} scripts to help automatize the making of conference proceedings. % \end{enumerate} % % %^^A\changes{0.2e}{2007/09/01}{Pros and cons reorganized} %^^A ================================================================= %^^A Pros and cons -%^^A ================================================================= -% \subsection{The pros and cons} +%^^A------------------------------------------------------------------------ +% \subsubsection{Pros} % \label{subsec:prosandcons} % -% There are numerous advantages with the \package{\filename} class, as it: +% There are numerous advantages with the \package{\filename} class: % \begin{itemize} -% \item provides an all-in-one package (with various useful scripts); -% \item saves time: you can directly re-use the tricks I found; -% \item provides several commands and options to customize your document; -% \item correctly inserts the \package{hyperref} package as the last one, so that it can properly redefine all internal macros as it does. +% \item help: it simplifies operations such as generating a conference program as the table of contents, generating the index of authors, generating the bookmarks, having the same layout for the proceedings as for the paper templates; +% \item convenient: it provides an all-in-one package (with various useful scripts); +% \item time saving: directly and elegantly re-use all the tricks previously collected or developed; +% \item customization: it provides several commands and options to customize your document; +% \item package ordering: it correctly inserts the \package{hyperref} package as the last one (all internal macros are redefined), except for packages requiring to be inserted after (like \package{hypcap}); +% \item reliability: the \package{\filename} package is getting older and mature, and has been used for 8 issues. Its documentaton and option set make it now easy to use (however, editing conference proceedings is always a big job). %^^A: its functionalities were only used 4 times, but not under the form of this class, but in its previous form of \LaTeX{} commands. I however successfully used it to re-generate the DAFx-06 proceedings. % \end{itemize} +% +% \subsubsection{Cons} +% \label{subsec:cons} +% % There are also disadvantages, among which: % \begin{itemize} -% \item the order of package insertion is fixed, and you may not change it. Otherwise, by adding packages after the class insertion, you may break the \LaTeX{} commands redefined by \package{hyperref}. This package has to be inserted last, but will not be anymore after you add packages in your document. This is the main limitation I can think of, and would appreciate any feedback, comments, tricks, that would help to resolve this issue. -% \item not everything is transparent to the user (or look into the class code); -% \item customization is limited to the class designer's defined commands; -% \item creates DAFx-like proceedings: if you liked it, great; otherwise, well, you will need to work more to change what you do not like; -% \item the \package{\filename} package is young: its functionalities were only used 4 times, but not under the form of this class, but in its previous form of \LaTeX{} commands. I however successfully used it to re-generate the DAFx-06 proceedings. +% \item package ordering: the order of package insertion is fixed, and may not be changed: \package{hyperref} has to be inserted last because it redefines many internal. After you add packages in your document, this will not be the case anymore!!! This is the main limitation I can think of, and would appreciate any feedback, comments, tricks, that would help to resolve this issue. +% \item PDFs: \package{pdfpages} inserts PDFs as vectorial images (my understanding), so internal links are broken and the text cannot anymore be copied/paste. Hopefully, clicking on a paper page from the proceedings opens the original file! +%^^A \item not everything is transparent to the user (or look into the class code); +% \item customization is a bit limited to the class designer's defined commands (which are hopefully expanding in each version); +% \item does not deal with parallel session programs. % \end{itemize} % % +% %^^A ================================================================= -%^^A Left empty and commented out until version 1.0 is reached -%^^A ================================================================= -% \subsection{What's new} -% \label{subsec:new} -% -% Version 0.4e enhances the package by redefining book commands, and fixes several issues. Here is a list of the recent fixes (bold version numbers correspond to the uploaded version: -% \begin{itemize} -% \item[\bf (0.4e)] define page layout with the \package{geometry} package (thanks to \person{Will Robertson}); -% \item[(0.4d)] re-organize changes history using \file{macro} environment: shorter and clearer; -%^^A \item[(0.4c)] bug correction: author is back in the bookmark (disappeared in v0.4a); -% \item[(0.4b)] -% \begin{itemize} -% \item bug correction: have \cmd{\hypersetup} evaluated only at the document beginning (then taking into account the user changes in the PDF metadata); -% \item remove formatting from footer and name-like commands: author, title, etc. (thanks to \person{Will Robertson}); -% \item use \package{mathptmx} package instead of \package{times} package, and \package{nth} package instead of \cmd{\textsuperscript} command (thanks to \person{Will Robertson}); -% \item redefine \cmd{\thebibliography} to avoid inserting a phantom item to set the introductory paragraph (thanks to \person{Will Robertson}); -% \end{itemize} -% \item[(0.4a)] -% \begin{itemize} -% \item allows to insert 1-page long papers (did not work in v0.3 and previous); -% \item instead of replacing each paper's last page by the list of its bibliography items, print them on top of the header of the last page; -% \item incorporate font style changes by redefining the \cmd{\mainmatter}, \cmd{\backmatter}, \cmd{\thebibliography}, \cmd{\thecontents} commands (thanks to \person{Will Robertson}); -% \end{itemize} -% \item[\bf (0.3)] initial version. +%^^A------------------------------------------------------------------------ +% \subsubsection{Hall of fame} +% +% Under one of its various forms, this package has been used for (at least) the following conferences: +% \begin{itemize} +% \item version 0.4e (class/package): +% \begin{itemize} +% \item July 2010: Proceedings of the International Society for Photogrammetry and Remote Sensing (ISPRS) Technical Commission VII Symposium: ``100 Years ISPRS --- Advancing Remote Sensing Science'', Volume XXXVIII, Part 7A and 7B --- Vienna, Austria; +% used by \person{Alexandra von Beringe}, \person{Peter Dorninger}, \person{Sebastian Fl\"ory}, \person{Josef Jansa}, \person{Clemens Nothegger}, \person{Norbert Pfeifer}, \person{Andreas Roncat}; +% \begin{itemize} +% \item Part 7A: \href{http://www.isprs.org/proceedings/XXXVIII/part7/a/proceedings_partAweb.pdf}{\sf www.isprs.org/proceedings/XXXVIII/part7/a/proceedings\_partAweb.pdf} +% \item Part 7B: \href{http://www.isprs.org/proceedings/XXXVIII/part7/b/proceedings_partBweb.pdf}{\sf www.isprs.org/proceedings/XXXVIII/part7/b/proceedings\_partBweb.pdf} +% \end{itemize} +% \item March 2010: Proceedings of the Workshop on Inverse Problems for Waves --- Palaiseau, France; +% used by \person{Armin Lechleiter};\\ +% \href{http://www.cmap.polytechnique.fr/~defi/mmsn2010/MMSN-2010.pdf}{\sf www.cmap.polytechnique.fr/$\sim$defi/mmsn2010/MMSN-2010.pdf} +% \item September 2009: Pre-Proceedings of the UC09 Hypercomputation Workshop --- Ponta Delgada, The Azores, Portugal; +% used by \person{Mike Stannett};\\ +% \href{http://hypercomputation.net/uc09/preproc.pdf}{\sf hypercomputation.net/uc09/preproc.pdf} +% \item August 2009: Book of abstracts of the 16th European Young Statisticians Meeting (EYSM 2009) --- Bucharest, Romania; +% used by \person{Luiza B\u{a}din} and \person{Roxana Ciumara};\\ +% \href{http://www.eysm2009.ase.ro/}{\sf www.eysm2009.ase.ro/} +% \item August 2009: Proceedings of the International Computer Music Conference (ICMC 2009) --- Montreal, Qc, Canada; +% used by \person{Gary Scavone} and myself; +% \href{http://www.icmc2009.org/}{\sf www.icmc2009.org/} +% \item June 2009: Nanophotonics Down Under 2009: Devices and Applications (SMONP: Sir Mark Oliphant Conference on NanoPhotonics) --- Melbourne, Australia; +% used by \person{Michael James Ventura}; +% \href{http://www.smonp2009.com/}{\sf www.smonp2009.com/} +% \end{itemize} +% \item version 0.2e (scripts): +% \begin{itemize} +% \item 2008 and 2009: numediart's Quartely Progress Scientific Report (QPSR); +% used by \person{Christian Frisson}; +% \begin{itemize} +% \item Vol. 2(4), Dec. 2009: \href{http://www.numediart.org/docs/numediart_2009_s08_qpsr.pdf}{\sf www.numediart.org/docs/numediart\_2009\_s08\_qpsr.pdf} +% \item Vol. 2(3), Sept. 2009: \href{http://www.numediart.org/docs/numediart_2009_s07_qpsr.pdf}{\sf www.numediart.org/docs/numediart\_2009\_s07\_qpsr.pdf} +% \item Vol. 2(2), June 2009: \href{http://www.numediart.org/files/numediart_2009_s06_qpsr.pdf}{\sf www.numediart.org/files/numediart\_2009\_s06\_qpsr.pdf} +% \item Vol. 2(1), March 2009: \href{http:www.numediart.org/files/numediart_2009_s05_qpsr.pdf}{\sf www.numediart.org/files/numediart\_2009\_s05\_qpsr.pdf} +% \item Vol. 1(4), Dec. 2008: \href{http://www.numediart.org/files/numediart_2008_s04_qpsr.pdf}{\sf www.numediart.org/files/numediart\_2008\_s04\_qpsr.pdf} +% \item Vol. 1(3), Sept. 2008: \href{http://www.numediart.org/files/numediart_2008_s03_qpsr.pdf}{\sf www.numediart.org/files/numediart\_2008\_s03\_qpsr.pdf} +% \item Vol. 1(2), June 2008: \href{http://www.numediart.org/files/numediart_2008_s2_qpsr.pdf}{\sf www.numediart.org/files/numediart\_2008\_s2\_qpsr.pdf} +% \item Vol. 1(1), March 2008: \href{http://www.numediart.org/files/numediart_2008_s1_qpsr.pdf}{\sf www.numediart.org/files/numediart\_2008\_s1\_qpsr.pdf} +% \end{itemize} +% \item September 2007: \nth{10} International Conference on Digital Audio Effects (DAFx-07) in Bordeaux, France; +% used by \person{Sylvain Marchand}; +% \href{http://dafx.labri.fr/}{\sf dafx.labri.fr/} +% \item December 2007: Proceedings of the eNTERFACE'07 Workshop on Multimodal Interfaces -- Istanbul, Turkey; +% used by \person{Christian Frisson} and \person{R\'emy Lehembre};\\ +% \href{http://www.cmpe.boun.edu.tr/enterface07/outputs/final/eNTERFACE07.pdf}{\sf www.cmpe.boun.edu.tr/enterface07/outputs/final/eNTERFACE07.pdf} +% \item 2007: Journal on Multimodal User Interfaces (JMUI) Vol. 1(1) and 1(2); +% used by \person{Christian Frisson}; +% \href{http://www.jmui.org/index.php/JMUI/issue/view/1/showToc}{\sf www.jmui.org/index.php/JMUI/issue/view/1/showToc} +% \item June 2007: \nth{13} International Conference on Auditory Display (ICAD-07) --- Montreal, Qc, Canada; +% used by \person{Gary Scavone}; +% \href{http://www.music.mcgill.ca/icad2007/proceedings.php}{\sf www.music.mcgill.ca/icad2007/proceedings.php} +% \end{itemize} +% \item version 0.1 (scripts): +% \begin{itemize} +% \item March 2007: \nth{5} International Linux Audio Conference (LAC2007) --- Berlin, Germany; +% used by \person{Marije Baalman}; +% \href{http://www.kgw.tu-berlin.de/~lac2007/proceedings.shtml}{\sf www.kgw.tu-berlin.de/$\sim$lac2007/proceedings.shtml} +% \item September 2006: \nth{9} International Conference on Digital Audio Effects (DAFx-06) --- Montreal, Qc, Canada; used by myself; +% \href{http://www.dafx.ca/dafx06_proceedings.html}{\sf www.dafx.ca/dafx06\_proceedings.html} +% \end{itemize} % \end{itemize} % % +%^^A ================================================================= +%^^A Version history +%^^A ================================================================= +% \subsection{Version history}\label{subsec:version:history}\label{subsec:new} +% +% Here is a list of versions (red versions are public releases): +% \begin{description} +% \item[{\color{red} v0.7}] this last version\newvzdseven{} is a major revision. It took me a while to add functionalities and modify the option interface (as kindly suggested by \person{Andreas Matthias} more than a year ago): +% \begin{itemize} +% \item class design: +% \begin{itemize} +% \item class options: interface re-designed, now uses key-values style (with \package{kvoptions} package); +% \item tested with \TeX{}Live 2008, 2009 and 2010 (as of July 18th. 2010); +% \item code clarified, using key-values (with the \package{keyval} package) but also \cmd{\ifthenelse} (from the \package{xifthen} package); +% \end{itemize} +% \item PDF insertion: +% \begin{itemize} +% \item command \cmdDescribe{\procpaper} with 1 argument (file name) and 8 optional arguments replaces \cmdDescribe{\insertprocpaper} with its 9 arguments. This re-design also makes use of key-values style options (using \package{keyval}); +% \item removed the limitation to a minimum of 2 pages and a maximum of 8 pages (now 1 to anything); +% \end{itemize} +% \item class options: +% \begin{itemize} +% \item \package{hyperref}/\package{geometry}: can now directly pass options to the \package{hyperref} and \package{geometry} packages with the new \DescribeMacro{hyperref}\Lopt{hyperref=\{option list\}} and \DescribeMacro{geometry}\Lopt{geometry=\{option list\}} options; +% \item added \LoptDescribe{papers=empty} option and mode. This offers a much faster fake paper insertion, compared to \LoptDescribe{papers=draft} (\Lopt{draft} mode of \package{pdfpages}, but not checking if pages actually exist); +% \item added new options for layout fine tuning and debug: +% \begin{itemize} +% \item \DescribeMacro{binding}\Lopt{binding=Xmm} to indicate the binding of the paperback version; +% \item \LoptDescribe{checktitle} and \LoptDescribe{checkauthor} to overlay the title and author list onto the 1st page of each paper, for checking the consistency of the table of contents with individual PDF papers; +% \item \LoptDescribe{showmarginlines} to draw the margin lines (so that one can match each page fits the template); +% \item \LoptDescribe{showpapernumber} to show the paper number below the page number; +% \item \DescribeMacro{colorheaders}\Lopt{colorheaders=red} to color the header/footer; +% \item \LoptDescribe{pdftk} to output commands for later setting PDF metadata of individual PDFs; +% \item \LoptDescribe{verbose} and \Lopt{debug} are now different options, and their output texts have been clarified and now makes use of \cmd{\PackageInfo} and \cmd{\PackageWarning}. +% \end{itemize} +% \item options' default values: reset to simplify the most possible the first tests; +% \end{itemize} +% \item documentation: +% \begin{itemize} +% \item added a 2-minutes documentation (\file{confproc-short.tex}) that summarizes commands and options; +% \item added a second (and simpler) example; +% \item improved \& re-organized for incremental learning, and clarified with margin notes and color code (using gray/black color code to show differences between successive versions of the code, and using the 'colordoc' package for color code); +% \end{itemize} +% \item scripts: added some \file{bach/Unix} scripts for more functionalities, such as: +% \begin{itemize} +% \item \file{buildprocelpb.sh}: for optimized example (generates both paperback and electronic versions of proceedings). +% \item \file{prepareexample.sh}: prepare example files and scripts. +% \item \file{exportIndividualPDFs.sh}: extracts individual paper with new page numbers and proper metadata; +% \item \file{countnbpages.sh}: counts number of pages in each individual PDF paper. +% \end{itemize} +% \end{itemize} +% \item[v0.6] undistributed: integrated and enhanced changes made for ICMC 2009; +% \item[v0.5] undistributed: hacked version with \package{kvoptions} plus many fixes for ICMC 2009; +% \item[{\color{red} v0.4e}] +% \begin{itemize} +% \item enhance package by redefining book commands; +% \item fixed several issues; +% \item define page layout with the \package{geometry} package (thanks to \person{Will Robertson}); +% \end{itemize} +% \item[v0.4d] changes history: re-organized using \file{macro} environment (shorter and clearer); +% \item[v0.4c] bug correction: author is back in the bookmark (disappeared in v0.4a); +% \item[v0.4b] +% \begin{itemize} +% \item debug: \cmd{\hypersetup} evaluated only at the document beginning (then taking into account the user changes in the PDF metadata); +% \item remove formatting from footer and name-like commands: author, title, etc. (suggested by \person{Will Robertson}); +% \item use \package{mathptmx} package instead of \package{times} package (thanks to \person{Will Robertson}); +% \item use \package{nth} package instead of \cmd{\textsuperscript} command (thanks to \person{Will Robertson}); +% \item redefine \cmd{\thebibliography} to avoid inserting a phantom item to set the introductory paragraph (thanks to \person{Will Robertson}); +% \end{itemize} +% \item[{\color{red} v0.4a}] +% \begin{itemize} +% \item allows to insert 1-page long papers (did not work in v0.3 and previous); +% \item instead of replacing each paper's last page by the list of its bibliography items, print them on top of the header of the last page; +% \item incorporate font style changes to the class: redefining the \cmd{\mainmatter}, \cmd{\backmatter}, \cmd{\thebibliography}, \cmd{\thecontents} commands (thanks to \person{Will Robertson}); +% \end{itemize} +% \item[{\color{red} v0.3}] first released version of the package. +% \item[v0.2e] first distributed version of the scripts. +% \item[v0.1] first version of the scripts (DAFx-06). +% \end{description} +% +% %^^A\changes{0.1c}{2007/07/30}{Todo: created} %^^A ================================================================= %^^A What have to be done? @@ -2700,33 +3288,41 @@ For more details, LaTeX the source `\inFileName'. % \subsection{To do / bugs} % \label{subsec:todo} % -% At this time this package offers all the features the original scripts did, and even more. So, as far as I am concerned, it is `complete' as is. You may however consider debugging/adding the following functionalities for you own use: +% At this time this package offers many more features than the original +% scripts did. It looks `complete' to me, and fully functional as is. +% I however would like to debug/add the following functionalities: % \begin{itemize} -%^^A \item replace all \verb+\def+ by \verb+\newcommand+ -% \item fix the right-flush issue for a small number back-references in the bibliography; -% \item have the pdf link pointing to the top of the page of the index/bibliography, and not to a particular position in the text; -% \item provide a mechanism to set the argument of \verb+\pdfbookmark[0]{Program}{contents}+, that customizes the table of contents bookmark entry (does not work yet); -% \item use the \package{keyval} package to properly manage options like \verb+ % \end{macrocode} -% -%^^A\changes{0.1f}{2007/08/02}{merging welcome and publishing in the example} -% +% \end{macro} +% \color{black} +% \begin{macrocode} +% +% \end{macrocode} +% +%^^A ================================================================= +% \subsection{\LaTeX{} runs}\label{sec:simple:ex2:latex} % +% To build this example, run the following \LaTeX{} steps: +% \begin{enumerate} +% \item generates the first \file{.aux} and \file{.idx} files (use option \Lopt{papers=empty} to go faster, as this time the number of pages for each paper has been defined):\\ +% \texttt{pdflatex example2custom.tex} +% \item generates the author index:\\ +% \texttt{makeindex -s confproc2.ist example2custom.idx} +% \item inserts table of contents and index, and update their page numbers for next run (use option \Lopt{papers=final} to ensure internal links are correct):\\ +% \texttt{pdflatex example2custom.tex} +% \item final \LaTeX{} run inserting table of contents and index with proper page numbers; useful only if the table of contents is longer than a single page (\Lopt{papers=final}):\\ +% \texttt{pdflatex example2custom.tex} +% \end{enumerate} % % -%^^A ================================================================= -% \subsection{Paper switch!} -% \label{sec:ex:paper:switch} % -% Let us now take a look at the paper switch, which is central to the proceedings. -% In fact, it contains a switch to all proceedings papers, so that you can work on the -% proceedings itself without knowing yet the final order of papers! +% Next section provide another working example (\file{example3optim.tex}) with several +% tricks to help optimizing the proceedings building process, and that was tested by +% re-generating the DAFx-06 proceedings (several years after the conference). The +% resulting PDFs were identical (appart from the improvements for bookmarks managements), +% but the work line is much easier to use and read. To generate the example proceedings, run +% \file{\filename.ins} through \LaTeX . Better, run the \verb+bash+ script called \file{buildproc} (see +% sec.~\ref{sec:scripts:buildproc}): it will run all the steps for you. % -%^^A ================================================================= -% \subsubsection{First way: redefining local commands} % -%^^A\changes{0.1d}{2007/08/01}{File: create expapersswitch.tex.} -%^^A\changes{0.1f}{2007/08/03}{Cmds: renaming loc as paper} %^^A ================================================================= -%^^A Here is the creation of the expapersswitch.tex file, part of the example. -%^^A It is written on first LaTeX run if it does not already exist +%^^A A good example (used afterwards to check if still working for DAFx-06) %^^A ================================================================= +% \newpage +% \section[Example 3 (\file{example3optim.tex} \& others): Full working example]{Example 3 (\file{example3optim.tex} \& others)\\ Full working example} +% \label{sec:example3} % -% We define the \cmd{\paperid} command: +% Incremental learning... +% Compared to the previous customization example in sec.~\ref{sec:example2}, this third +% example illustrates a complete and working example with: %the use of some more tools: +% various package option sets depending on the compilation step, the publishing informations, +% a welcome letter, a paper switch to simplify the paper insertion and program changes, and a +% general bibliography. Morevoer, the conference program is directly generated from a \file{.csv} +% file by the \file{generateswitch.pl} Perl script. Tools to ensure that all pages of each PDF are +% inserted without having to run \LaTeX\ on the whole document (quite slow) are provided. +% +% +% +%^^A ================================================================= +% \subsection{\file{example3optim.tex}: Main file} +% \label{sec:ex:main} +% +% The main file is named \file{example3optim.tex}. Once again, lines of code that do no +% differ from previous example (ie.~\file{example2custom.tex}) appear in grey color. % \begin{macrocode} -%<*expapersswitch> -\newcommand{\paperid}[2]{ +%<*example3optim> % \end{macrocode} -% Inside the switch, the \cmd{\paperswitch} command is set to the paper reference: +% % +%^^A------------------------------------------------------------------------ +% \subsubsection{Using the \package{\filename} class} +% +% The class is to be called as would have been the \package{book.cls}. +% For this example, the exhaustive list of option values is given (as well as a comment with +% possible values and default values between squared brackets): +% \begin{macrocode} +\documentclass[letterpaper,% [letterpaper] | a4paper + 10pt,% [10pt] | 11pt | 12pt + twoside,% [twoside] | oneside + twosidepapers,% [twosidepapers] | onesidepapers + electronic,% [electronic] | printed + binding=0mm,% [0mm] + papers=final,% empty | draft | [final] + headers=exceptpdf,% none | pdfonly | exceptpdf | [allpages] + bib=backref,% [none] | merge | backref | final + paperselec=all,% [all] | p_001 | paper_2 | 3 ... + onecoltoc,% [onecoltoc] | twocoltoc + tocnum=left,% [left] | right + twocolbib,% [twocolbib] | onecolbib + threecolindex,% [threecolindex] | twocolindex + checktitle=false,% true | [false] + checkauthor=false,% true | [false] + showpapernumber=false,% true | [false] + movepagenumber=false,% true | [false] + showmarginlines=false,% true | [false] + colorheaders=black,% [black] | red | any color! + debug=false,% true | [false] + verbose=false,% true | [false] + pdftk=true,% true | [false] + hyperref={bookmarksdepth=1,bookmarksopen,bookmarksopenlevel=0,% + linkcolor=colorforlink,urlcolor=colorforurl}, % [blue, blue, blue] + geometry={text={175truemm,226truemm},% A4 & letter + inner=0.805in,top=29.15mm,bottom=24.5mm,footskip=9.68mm,voffset=-5mm},%letter + ]{confproc} +%%% inner=0.69in,top=33.9mm,bottom=38mm,footskip=10.4mm,voffset=-4.8mm},%A4 +% \end{macrocode} +% To simplify the proceedings building, we can use the \file{bash} scripts in sec.~\ref{sec:ex:input:class} to insert a file containing this command with the list of options: +%^^A\changes{0.1g}{2007/08/08}{Example: adding color options} % \begin{macrocode} -\renewcommand{\paperswitch}{#1} +%%\input{exclass} % \end{macrocode} -% We then define the insertion command for the paper with ID=01: +%^^A\changes{0.5}{\datevzfive}{Example: document class with new option set and partial documentation in comments.}\changes{0.2h}{2007/09/12}{Example: using \Lopt{utf8} instead of \Lopt{latin} inputenc option (no more pb with special accents).} +% Inserting options that way allows to switch between class options for various +% \LaTeX\ runs by using 2 files (\file{exclasspre.tex} and \file{exclasslast.tex}). In those +% two files, the class is defined with different options set, and each one is temporary +% renamed as \file{exclass.tex} before being inserted. +% +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Loading extra packages} +% +% We define the other packages to be used. +% +% \noindent {\bf Important note}\margindanger{}: any package that redefines \LaTeX{} macros should be inserted before \package{hyperref}. At present, \package{\filename} does not provide any mechanism for this, so adding other such packages may result in surprises. A temporarily solution is to add them in the class definition itself... %^^Awhich is not a satisfactory solution yet. +%^^A \color{red} {\sc Should we use something like \verb+\AtBeginDocument+ to insert the hyperref package in the class definition?} \color{black} +%^^A\changes{0.2e}{2007/09/01}{Layouts: moved to the example} +% +% We use \package{setspace} to change the line spacing in the welcome letter (which text is not as dense as the papers themselves): % \begin{macrocode} -%=========== PAPER ID = 45 =========== -\ifnum\paperswitch=45 { +\usepackage{setspace} % \end{macrocode} -% For this first paper inclusion, we chose to use intermediary commands: +% The \package{xkeyval} package ensures further compatibility with other packages using it: % \begin{macrocode} - \renewcommand{\papertitle}{Templates for One Author} - \renewcommand{\paperauthors}{Alfred Alabama} - \renewcommand{\paperindex}{\index{Alabama, Alfred}} - \renewcommand{\paperref}{\paperswitch} - \renewcommand{\paperpagenum}{6} - \renewcommand{\papercite}{Serra:1996:sms,% - Moorer:2000:AES:audio:millenium,Arfib:1998:DAFx,% - Mitra:Kaiser:1993:DSP:handbook} +\usepackage{xkeyval} % \end{macrocode} -% We use the \cmd{\procinsertpaper} command to insert papers. It has 9 arguments: -% \begin{enumerate} -% \item X and Y shifts (with a space in between, as in \verb+{10 12}+); -% \item the number of pages; -% \item the paper reference; -% \item the title; -% \item the list of authors; -% \item the index entries; -% \item the citations for the general bibliography; -% \item the name of the PDF file to insert; -% \item the bookmark entries for the authors. -% \end{enumerate} +% We then use a bibliography style for the general bibliography\marginBIB: +%^^A\changes{0.5}{\datevzfive}{Pkg: \package{newapave} is now insert only on user request.} % \begin{macrocode} - \procinsertpaper{\LaTeXxShift{} \LaTeXyShift}{\paperpagenum}% - {\paperref}{\papertitle}{\paperauthors}{\paperindex}{\papercite}% - {#2}{\pdfbookmark[2]{Alfred Alabama}{#2.author1}}} -\fi +\usepackage{newapave} % \end{macrocode} +% We then specify the input and font encodings, to allow for running \LaTeX{} on a document with accents (in the list of authors and paper titles): +%^^A\changes{0.5}{\datevzfive}{Example: document class with new option set and partial documentation in comments.}\changes{0.2h}{2007/09/12}{Example: using \Lopt{utf8} instead of \Lopt{latin} inputenc (no more pb with special accents).} +% \color{black!50} +% \begin{macrocode} +\usepackage[utf8]{inputenc} +\usepackage[T1]{fontenc} +% \end{macrocode} +% \color{black} +% We change the default \LaTeX{} font to `Times', as it displays better in PDF files: +% \changes{0.4b}{2007/10/12}{Pkg: \package{mathptmx} replaces \package{times}} +% \color{black!50} +% \begin{macrocode} +\usepackage{mathptmx} +% \end{macrocode} +% \color{black} +%^^A N.B.: the \package{mathptmx} package better behaves than \package{times}: it doesn't change the maths font, and does not load Helvetica and Courier at horrible sizes (they look even worse than the default sans and mono fonts in combination)\footnote{Thanks to \person{Will Robertson} for this information.}. % -%^^A ================================================================= -% \subsubsection{Second way: shorter but less readible} -% -% Even though less readible, it may be shorter not to redefine local commands, and to directly pass arguments to the \cmd{\procinsertpaper} command. This is presented in the next example, and corresponds to what is provided by the Perl script (see sec. \ref{sec:scripts:perl}) that converts the .csv data into \LaTeX{} code to insert in this current file: -% +% The header of DAFx-06 proceedings had a `$9\textsuperscript{th}$', that requires: +% \changes{0.4b}{2007/10/12}{Pkg: \package{nth} for superscript ordinals} +% \color{black!50} % \begin{macrocode} -%=========== PAPER ID = 21 =========== -\ifnum\paperswitch=21 - \procinsertpaper{\LaTeXxShift{} \LaTeXyShift}{5}{\paperswitch}% - {Templates for One Author with Two Affiliations}% paper title - {Bob Boogie-Woogie}% list of authors - {\index{Boogie-Woogie, Bob}}% authors index entries - {Serra:1996:sms,Moorer:2000:AES:audio:millenium,% - Arfib:1998:DAFx,Haykin:1991:adaptive:filter}% - {#2}{\pdfbookmark[2]{Bob Boogie-Woogie}{#2.author1}} -\fi - -%=========== PAPER ID = 27 =========== -\ifnum\paperswitch=27 - \procinsertpaper{\LaTeXxShift{} \LaTeXyShift}{7}{\paperswitch}% - {Templates f\'or F\`o\"ur Àuthors}% - {J\o{}hn J\"oe, K\'e\~{n}t K\^{\i}ng, L\`ou L\'ou, % - M\`anfr\'ed J. M\^ost\u{e}k\i}% - {\index{J\"oe, J\o{}hn}\index{K\^{\i}ng, K\'e\~{n}t}% - \index{L\'ou, L\`ou}\index{M\^ost\u{e}k\i, M\`anfr\'ed J.}}% - {Serra:1996:sms,Moorer:2000:AES:audio:millenium,% - Dutilleux:1991,Fitz:Haken:2003:Web:morphing:loris}% - {#2}{\pdfbookmark[2]{J\o{}hn J\"oe}{#2.author1}% - \pdfbookmark[2]{K\'e\~{n}t K\^{\i}ng}{#2.author2}% - \pdfbookmark[2]{L\`ou L\'ou}{#2.author3}% - \pdfbookmark[2]{M\`anfr\'ed J. M\^ost\u{e}k\i}{#2.author4}} -\fi +\usepackage[super]{nth} -%=========== PAPER ID = 33 =========== -\ifnum\paperswitch=33 - \procinsertpaper{\LaTeXxShift{} \LaTeXyShift}{4}{\paperswitch}% - {Templates for Two Authors}% - {Alfred Alabama, Chris Christmas}% - {\index{Alabama, Alfred}\index{Christmas, Chris}}% - {Serra:1996:sms,Moorer:2000:AES:audio:millenium,% - Arfib:1998:DAFx,Askenfelt:1976:automatic:transcription}% - {#2}{\pdfbookmark[2]{Alfred Alabama}{#2.author1}% - \pdfbookmark[2]{Chris Christmas}{#2.author2}} -\fi - -%=========== PAPER ID = 75 =========== -\ifnum\paperswitch=75 - \procinsertpaper{\LaTeXxShift{} \LaTeXyShift}{6}{\paperswitch}% - {Templates for Three Authors}% - {Bob Boogie-Woogie, Chris Christmas, Don Didon}% - {\index{Boogie-Woogie, Bob}\index{Christmas, Chris}% - \index{Didon, Don}}% - {Serra:1996:sms,Moorer:2000:AES:audio:millenium,% - Arfib:1998:DAFx,Egozy:1995:MIT:features:gesture}% - {#2}{\pdfbookmark[2]{Bob Boogie-Woogie}{#2.author1}% - \pdfbookmark[2]{Chris Christmas}{#2.author2}% - \pdfbookmark[2]{Don Didon}{#2.author3}} -\fi -} -% % \end{macrocode} +% \color{black} % -% If you do not use the \verb+pd1enc.def+ file if you want \package{hyperref} to correctly convert all accents\footnote{and there are many beautiful accents in non-english languages :-).} in the PDF file, such messages will appear at \LaTeX\ runs:\begin{verbatim} -% Package hyperref Warning: Glyph not defined in PD1 encoding, -% (hyperref) removing `\u' on input line 184. -%\end{verbatim} -% -%^^A\changes{0.2d}{2007/08/18}{Adding the description and examples for day and session organized conferences} -%^^A\changes{0.2d}{2007/08/18}{Adding examples of table of contents and bookmarks layouts} -% -%^^A ================================================================= -% \subsubsection{Get page numbers and recompile all papers} % -% In the case where your papers have headers/footers, you may have to recompile them all with the proper page numbers. Before doing so, compile the proceedings enough times so that the table of contents is generated and inserted. Then, use the page number indicated for each paper to edit accordingly the \file{expages.tex} file. An example is provided here: +% \changes{0.4b}{2007/10/12}{Layout: set \cmd{\footskip}} +%^^A------------------------------------------------------------------------ +% \subsubsection{Fine tuning the document layout} % +% To refine the document layout, we may use the \package{layout} package: % \begin{macrocode} -%<*expages> -\newcommand{\setpagenumber}[1]{ - \newcommand{\paperswitch}{#1} - \ifnum\paperswitch=01 {\setcounter{page}{1}}\fi - \ifnum\paperswitch=02 {\setcounter{page}{7}}\fi - \ifnum\paperswitch=03 {\setcounter{page}{13}}\fi - \ifnum\paperswitch=04 {\setcounter{page}{17}}\fi - \ifnum\paperswitch=05 {\setcounter{page}{23}}\fi -} -% +%\usepackage{layout} % \end{macrocode} +% as well as \package{layouts} to refine the table of contents layout: +% \begin{macrocode} +%\usepackage{layouts} +% \end{macrocode} +% \margindanger{} \noindent N.B.: When the table of contents layout is inserted too early, it is not properly displayed! % -% You may then recompile all papers (use the \file{buildpapers} Unix script, see sec.~\ref{sec:scripts:buildpapers}), provided that they all have the corresponding line in their preamble:\\ -% \verb+\input{../../expages.tex}\setpagenumber{01}+\\ -% where \verb+01+ is the paper reference (to be changed for each paper). Using the following:\\ -% \verb+\setcounter{page}{1}+\\ -% would of course have the equivalent effect, except that you would have to re-edit each paper after changing your program order. +%^^A------------------------------------------------------------------------ +% \subsubsection{PDF vertical and horizontal shifts} % -%^^A ================================================================= -% \subsection{Generate the conference program} -% \label{sec:ex:program} +% \changes{0.5}{\datevzfive}{Layout: options for \texttt{geometry} package not directly provided to the class} +% \changes{0.4e}{2007/10/12}{Layout: use the \package{geometry} package} +% We set the default $x$ (left/right) and $y$ (up/down) shifts used to insert PDFs files: +% \color{black!50} +% \begin{macrocode} +\setlength{\LaTeXxShift}{0pt} +\setlength{\LaTeXyShift}{-3mm} %letter +%\setlength{\LaTeXyShift}{1mm} %A4 +\setlength{\WordxShift}{10pt} +\setlength{\WordyShift}{-40pt} + +% \end{macrocode} +% \color{black} +%^^A The commented line is used with the A4 format (see also sec.~\ref{sec:custom:layout:doc}). +%^^A The values may differ depending if the papers were generated using a \LaTeX\ template +%^^A and a Word template, in the case your templates are not perfectly identical (which is often +%^^A the case). The default values provided by the class are those used for the DAFx-06 +%^^A proceedings, and were tested for both letter and A4 format. % -%^^A ================================================================= -% \subsubsection{Organize the conference program by sessions of by day?} +% \margindanger{}Those global values are used by default for each paper, except if +% \cmd{\procpaper} has other values specified for the option arguments: \Lopt{xshift=...} and \Lopt{yshift=...}. +% \changes{0.5}{\datevzfive}{Layout: \LaTeX{} $x$ and $y$ shift values updated (\texttt{geometry} package)} % -% Depending on the size of your conference, you may only have a few sessions during 2 or 3 days, or many sessions during 4 to 7 days (or even more). Then, you need to choose wether you want to organize the table of contents and the bookmarks: -% \begin{itemize} -% \item by sessions and then by related papers; or -% \item by day, then by sessions and then by papers (in the case of long conferences where the list of sessions may be too long in the PDF bookmark); -% \end{itemize} -% The mechanism used in \package{\filename} is based on section levels: days are inserted in the table of contents and bookmarks as parts, whereas sessions are inserted as chapters and papers as sections. +%^^A------------------------------------------------------------------------ +% \subsubsection{Define colors for internal and external hyper-links} % -% Note that the \package{\filename} does not handle programs with parallel sessions. It is then up to you to decide in which order they may appear in the table of contents. +%^^A\changes{0.1g}{2007/08/08}{Example: adding example of color definition for links} +%^^A\changes{0.1g}{2007/08/08}{Example: moving color definitions} +% When inserting the document class, we have used home-made colors for the links +% (\Lopt{citecolor}, \Lopt{linkcolor} and \Lopt{urlcolor}); those colors remain to be defined +% in the document preamble before being used: +% \color{black!50} +% \begin{macrocode} +\definecolor{colorforlink}{rgb}{0,0,0.8} +\definecolor{colorforcite}{rgb}{0,0.8,0} +\definecolor{colorforurl}{rgb}{0,0,1} + +% \end{macrocode} +% \color{black} +% See section~\ref{sec:custom:colors} for complementary information. % -%^^A\changes{0.2e}{2007/09/01}{Docu: all sessions/days tables redone with tabular instead of minipage (smaller and easier to read)} -%^^A ================================================================= -% \paragraph{Program organized by sessions} % -% For a small size conference, if not using days (comment the \cmd{\procday{}} lines in the example), you will obtain the table of contents corresponding to Tab~\ref{tab:program:session}. The corresponding bookmark is depicted closed in Tab.~\ref{tab:program:session:bkmrk0}, opened at its first level in Tab.~\ref{tab:program:session:bkmrk1}, and opened at its second level in Tab.~\ref{tab:program:session:bkmrk2}. +%^^A------------------------------------------------------------------------ +% \subsubsection{Customize PDF metadata} +% +%^^A As \package{\filename} is to be used with pdf\LaTeX{} and generates a PDF, it makes sense +%^^A to customize the PDF metadata, that correspond to the PDF file information that are provided from the +%^^A operating system. +% At least three PDF metadata should be set, given here with their default values. +% To do so, we start by defining generic strings that will be used: +% \begin{macro}{\DAFxname} +% \begin{itemize} +% \item firstly, the conference name +% \end{itemize} +% \color{black!50} +% \begin{macrocode} +\newcommand{\DAFxname}{Proc.~of the \nth{9} % + Int.~Conference on Digital Audio Effects (DAFx-06)} +% \end{macrocode}\color{black} +% \end{macro} +% \begin{macro}{\DAFxdate} +% \begin{itemize} +% \item secondly, the conference date(s): +% \end{itemize} +% \color{black!50} +% \begin{macrocode} +\newcommand{\DAFxdate}{September 18-20, 2006} +% \end{macrocode}\color{black} +% \end{macro} +% \begin{macro}{\DAFxaddress} +% \begin{itemize} +% \item thirdly, the conference address: +% \end{itemize} +% \color{black!50} +% \begin{macrocode} +\newcommand{\DAFxaddress}{Montreal, Canada} + +% \end{macrocode}\color{black} +% \end{macro} +% +% We can then define the 3 PDF metadata as follows: +% \begin{macro}{\procpdfauthor} +% \begin{itemize} +% \item use \cmd{\procpdfauthor} to change the PDF author (default: `[Proceedings author/editor]'): +%^^A\changes{0.1f}{2007/08/03}{\cmd{\locpdfauthor} renamed \cmd{\procpdfauthor}} +% \color{black!50} +% \begin{macrocode} +\renewcommand{\procpdfauthor}{Vincent Verfaille, McGill University} +% \end{macrocode} +% \color{black} +% \end{itemize} +% \end{macro} +% \begin{macro}{\procpdftitle} +% \begin{itemize} +% \item use \cmd{\procpdftitle} to change the PDF short title (default: `[Proceedings title]'): +%^^A\changes{0.1f}{2007/08/03}{\cmd{\locpdftitle} renamed \cmd{\procpdftitle}} +% \color{black!50} +% \begin{macrocode} +\renewcommand{\procpdftitle}{DAFx-06 Proceedings - \DAFxaddress} +% \end{macrocode} +% \color{black} +% \end{itemize} +% \end{macro} +% \begin{macro}{\procpdfsubject} +% \begin{itemize} +% \item use \cmd{\procpdfsubject} to change the PDF subject (default: `[Proceedings description]'): +%^^A\changes{0.1f}{2007/08/03}{\cmd{\locpdfsubject} renamed \cmd{\procpdfsubject}} +% \color{black!50} +% \begin{macrocode} +\renewcommand{\procpdfsubject}{Conference proceedings} + +% \end{macrocode} +% \color{black} +% \end{itemize} +% \end{macro} +% Those values are used to ser the \cmdDescribe{\hypersetup} command. They are only evaluated when the document begins, and can also be replaced by redefining \cmd{\hypersetup} in the document preamble.\\ +% \margindanger{}N.B.: depending on the PDF viewer, only the first 30 or so characters of those metadata may be displayed (eg.~Apple's Preview, Adobe Reader). It is then advised to use the shortest possible texts.\\ +% N.B.: an alternative way to change the PDF metadata consist in using the \cmdDescribe{\hypersetup} command (see the \package{hyperref} package). +% +% +% \changes{0.4b}{2007/10/12}{Pkg: \package{nth} for superscript ordinals} +%^^A------------------------------------------------------------------------ +% \subsubsection{Header and footer} +% +% The paper templates often have a header and footer, so we may want to use the same headers/footers for the whole proceedings (using the \Lopt{headers} option). This is costumized by redefining the left \cmdDescribe{\proclhead} and centre \cmdDescribe{\procchead} header commands: +%^^A\changes{0.2e}{2007/09/01}{\cmd{\loclhead} renamed \cmd{\proclhead}} +%\changes{0.5}{\datevzfive}{added \cmd{\procchead} command} +% \color{black!50} +% \begin{macrocode} +\renewcommand{\procchead}{} % +\renewcommand{\proclhead}{{\em \small \DAFxname, \DAFxaddress, \DAFxdate}} +% \end{macrocode} +% \color{black} +% as well as \cmdDescribe{\proccfoot} for the central footers (the page number being centered by default): +%\changes{0.4b}{2007/10/12}{uses \cmd{\vspace} instead of \cmd{\vskip}} +%\changes{0.5}{\datevzfive}{added \cmd{\proccfoot} length} +% \color{black!50} +% \begin{macrocode} +\renewcommand{\proccfoot}{{\small DAFX-\thepage}} +% \end{macrocode} +% \color{black} +% The \cmdDescribe{\procfootvskip} length adjusts the footer vertical position: +% \color{black!50} +% \begin{macrocode} +\setlength{\procfootvskip}{1.2mm} +% \end{macrocode} +% \color{black} +% \begin{macro}{\procoptfootvskip} +% When checking the page numbering for papers which template already includes +% the page number, we may change the amount of vertical shift applied to move down +% by a few millimeters (default: 3mm) the footer when using the \Lopt{movepagenumber} +% option. Then, use the \cmd{\procoptfootvskip} command: +% \begin{macrocode} +\setlength{\procoptfootvskip}{4mm} + +% \end{macrocode} +% As soon as you remove the \Lopt{movepagenumber} option, the footer comes back to its normal position. +% \end{macro} +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Define front page and title commands} +% +% To generate the front page with \cmd{\maketitle}, we redefine usual \LaTeX\ commands: +% \begin{macro}{\author} +% \begin{itemize} +% \item the proceedings' author/editor: +% \end{itemize} +% \color{black!50} +% \begin{macrocode} +\author{\procpdfauthor} +% \end{macrocode} +% \color{black} +% \end{macro} +% \begin{macro}{\title} +% \begin{itemize} +% \item the proceedings' title: +% \end{itemize} +% \changes{0.4b}{2007/10/12}{Pkg: \package{nth} for superscript ordinals} +% \color{black!50} +% \begin{macrocode} +\title{\DAFxname\\ \DAFxaddress} +% \end{macrocode} +% \color{black} +% \end{macro} +% \begin{macro}{\date} +% \begin{itemize} +% \item the proceedings' date: +% \end{itemize} +% \color{black!50} +% \begin{macrocode} +\date{\DAFxdate} + +% \end{macrocode} +% \color{black} +% \end{macro} +% using the \cmd{\procpdfauthor} and \cmd{\procpdftitle} commands previously defined. +% +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Special section titles (toc, index, biblio)} +% +% To change special section titles, redefine the \LaTeX{} commands already modified by \package{confproc}: +% \begin{macro}{\contentsname} +% \begin{itemize} +% \item title of the table of contents (default: `Conference Program'): +% \end{itemize} +% \color{black!50} +% \begin{macrocode} +\renewcommand{\contentsname}{Day-by-Day Conference Program} +% \end{macrocode} +% \color{black} +% \end{macro} +% \begin{macro}{\bibname} +% \begin{itemize} +% \item title of the general bibliography (default: `Full Bibliography'): +% \end{itemize} +%^^A\changes{0.1g}{2007/08/05}{add an example of \cmd{\bibnametoc} change} +% \changes{0.4a}{2007/10/01}{remove formatting} +% \changes{0.4a}{2007/10/01}{renamed from \cmd{\procbibname}} +% \color{black!50} +% \begin{macrocode} +\renewcommand{\bibname}{General Bibliography} +% \end{macrocode} +% \color{black} +% \end{macro} +% \begin{macro}{\indexname} +% \begin{itemize} +% \item title of the index (default: `Index of Authors'): +% \end{itemize} +%^^A\changes{0.1g}{2007/08/05}{add an example of \cmd{\indexnametoc} change} +% \changes{0.4a}{2007/10/01}{remove formatting} +% \changes{0.4a}{2007/10/01}{renamed from \cmd{\procindexname}} +% \color{black!50} +% \begin{macrocode} +\renewcommand{\indexname}{List of Authors} +% \end{macrocode} +% \color{black} +% \end{macro} +% +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Declare paths to pictures, papers, texts...} +% +% We then define paths to different resources that the \package{example3optim.tex} file uses, \ie{}: +% \begin{macro}{\PAPERPATH} +% \begin{itemize} +% \item papers (containing both PDF papers and related folders to re-generate them): +% \end{itemize} +% \color{black!50} +% \begin{macrocode} +\renewcommand{\PAPERPATH}{papers/} +% \end{macrocode} +% \color{black} +% \end{macro} +% \begin{macro}{\PICPATH} +% \begin{itemize} +% \item pictures (\eg{} logos used in your first page and welcome letters): +% \end{itemize} +% \begin{macrocode} +\newcommand{\PICTPATH}{pictures/} +% \end{macrocode} +% \end{macro} +% \begin{macro}{\TEXTPATH} +% \begin{itemize} +% \item texts (\eg{} publishing informations, welcome letters, the paper switch): +% \end{itemize} +% \begin{macrocode} + \newcommand{\TEXTPATH}{} +% \end{macrocode} +% \end{macro} +% \begin{macro}{\BIBPATH} +% \begin{itemize} +% \item bibliographies (\eg{} 3 files as explained in sec.~\ref{sec:general:bib}): +% \end{itemize} +% \begin{macrocode} + \newcommand{\BIBPATH}{} +% \end{macrocode} +% \end{macro} +% +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Declare bibliographic files} +% +% \begin{macro}{\procbibfile} +% We now define the file name of the main bibliography: +%^^A at the beginning, providing all customization commands at the same place: +% \begin{macrocode} +\newcommand{\procbibfile}{\BIBPATH exbiblio} +% \end{macrocode} +% Several \texttt{.bib} files may be used to build the general bibliography (see sec.~\ref{sec:general:bib}). +%^^A for instance one for common bibliography items, one with the other bibliography items and another one with common strings for journals, conferences, etc. +% \end{macro} +% +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Chapter and section styles} +% +% Chapter and section styles can also be modified (for instance with the \package{titletoc} package) +% to adapt them to your needs. Remember that days appear as parts in the TOC and +% bookmarks, sessions as chapters, and papers as sections. Here is an +% example taken from the ICMC 2009 proceedings, where a TOC with left-aligned numbers +% is added with horizontal lines of different thickness before days and sessions. +% To do so, we first define our horizontal rulers: +% \begin{macrocode} +\newcommand{\myaddhruletotoc}{\vspace*{0.1cm}% + \noindent\protect\hrulefill\par\vspace*{-0.15cm}} +\newcommand{\myaddthickhruletotoc}{\vspace*{0.5cm}% + \noindent\protect\hrule height 0.6ex \hfill\par\vspace*{0.1cm}} +% \end{macrocode} +% We then redefine the \cmdDescribe{\procday} command to add an empty line in the TOC before each day: +% \begin{macrocode} +\renewcommand{\procday}[1]{% + \phantomsection% + \addcontentsline{toc}{part}{#1}} % \centerline{#1} +% \end{macrocode} +% as well as the \cmdDescribe{\session} command to add an empty line in the TOC before each session: +% \begin{macrocode} +\renewcommand{\session}[1]{% + \phantomsection% + \addcontentsline{toc}{chapter}{#1}} +% \end{macrocode} +% \margindanger{}We can finally use the \package{titletoc} package and syntax to modify the TOC layout by +% adding the horizontal rulers. Note that given the way it is redefined, it will +% work properly for both left-aligned and right-aligned TOC numbers. Here is the definition for the main matter (\cmdDescribe{\mainmattertocstyle}): +% \begin{macrocode} +%% idem for left/right numbering +\renewcommand{\mainmattertocstyle}{ + \titlecontents{part}[0pt]% + {\addvspace{3mm}}% + {\myaddthickhruletotoc\Large\bfseries}% + {\myaddthickhruletotoc\Large\bfseries}% + {}% + [\addvspace{0.5mm}]% + \titlecontents{chapter}[0pt]% + {\addvspace{2mm}}% + {\myaddhruletotoc\large\bfseries\itshape}% + {\myaddhruletotoc\large\bfseries\itshape}% + {}% + [\addvspace{0.5mm}]% +} +% \end{macrocode} +% +% +% +%^^A \changes{0.4b}{2007/10/12}{Format: changing \cmd{\sc} to \cmd{\scshape}} +%^^A------------------------------------------------------------------------ +% \subsubsection{Title/author layout}\label{sec:custom:title:author} +% +% The \DescribeMacro{\texorpdfstring}\cmd{\texorpdfstring} command allows for a different +% text in LaTeX and for the PDF (which is good for having different bookmark titles and table +% of contents entries). It is then used by default to add a line break between the paper title +% and the authors' names in the table of contents. We customize the title font style using +% the \cmdDescribe{\papertitlestyle} command as in: +% \color{black!50} +% \begin{macrocode} +%%\renewcommand{\papertitlestyle}{} +% \end{macrocode} +% \color{black} +% \begin{macrocode} +\renewcommand{\papertitlestyle}{\texorpdfstring{}{\scshape}} +% \end{macrocode} +% that defines the paper's title in small capitals (default with the comment). The +% \cmdDescribe{\paperauthorstyle} command is used to customize the author font style. For +% instance, to replace the line break (between paper title and list of authors, in the table of +% contents) by a comma in the table of contents only (and not in the PDF bookmark) and have +% names right-flushed\footnote{\noindent Such option usually works well for short titles and author list:\\ +% My short title, \hfill FirstName1 LastName1, FirstName2 LastName2\\ +% but longer titles/author list may unfortunately give a different result, for instance:\\ +% My very long title that I like and do not want to shorten, \hfill FirstName1 LastName1, +% FirstName2 LastName2, FirstName3 LastName3, FirstName4 LastName4}: +% \color{black!50} +% \begin{macrocode} +%%\renewcommand{\paperauthorstyle}{\texorpdfstring{\newline\itshape}{\break}} +% \end{macrocode} +% \color{black} +% \begin{macrocode} +\renewcommand{\paperauthorstyle}{\texorpdfstring{, \hfill}{\break}} +% \end{macrocode} +% Again, the default appears with the comment sign. +% +% Consider now that we prefer to invert the paper title and the author list positions. +% We first redefine \cmdDescribe{\proctoctitleauthor}, that defines how the paper title +% and author list are ordered and formatted in the TOC: +% \begin{macrocode} +\renewcommand{\proctoctitleauthor}[2]{% + \texorpdfstring{{\paperauthorstyle #2}{\papertitlestyle #1}}% + {{\papertitlestyle #1}}} +% \end{macrocode} +% We then redefine the formatting of the author list (italic) and paper title (boldface), and also which of the +% two commands is responsible for the line break (before the paper title): +% \begin{macrocode} +\renewcommand{\paperauthorstyle}{\texorpdfstring{\itshape}{}} +\renewcommand{\papertitlestyle}{\texorpdfstring{\newline}{\break}} +% \end{macrocode} +% +% \begin{macro}{\confstylechecktitle} +% In the case we want to check each title and author list, that can be useful to specify how the +% overlayed text is formatted. +% To do so, we define the format for the check title: +% \color{black!50} +% \begin{macrocode} +\renewcommand{\confstylechecktitle}{\vspace*{0.3cm} % + \bf \sc \Large \noindent \centerline} +% \end{macrocode} +% \end{macro} +% \begin{macro}{\confstylecheckauthor} +% \color{black} +% and for the check author list: +% \color{black!50} +% \begin{macrocode} +\renewcommand{\confstylecheckauthor}{\large \it \noindent \centerline} +% \end{macrocode} +% \color{black} +% \end{macro} +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Make the index} +% +% The last step of the preamble is to build the index: +% \color{black!50} +% \begin{macrocode} +\makeindex + +% \end{macrocode} +% \color{black} +% +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Start the document: front matter (cover page and table of contents)} +% +% We can now start the document and its front matter by using: +% \color{black!50} +% \begin{macrocode} +%%%=========== PROCEEDINGS =========== +\begin{document} + +\frontmatter +% \end{macrocode} +% \color{black} +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Display the document layout} +% +% To check the document layout (thanks to the \package{layout} package), uncomment: +% \begin{macrocode} +%%\layout +% \end{macrocode} +%^^A\changes{0.2e}{2007/09/01}{Layouts: moved to the example} +% To specifically check the table of contents layout (thanks to the \package{layouts} package), uncomment: +% \begin{macrocode} +%%\begin{figure} +%% \setlayoutscale{0.8} \tocdiagram +%% \caption{Table of Contents entry parameters} \label{fig:tocp} +%%\end{figure} +%%\begin{figure} +%% \setlayoutscale{0.8} \currenttoc \tocdesign +%% \caption{Typical Table of Contents entry for this document} +%% \label{fig:thistoc} +%%\end{figure} +% \end{macrocode} +% Then can either be inserted at the end of the document (not changing page numbering, but may be forgetten as we do not so often check the last page) or at its beginning (changing page numbering but being the first page you see when opening it). +% \begin{macro}{\clearsingleordoublepage} +% To go to the next page (right-opening page in two-side mode), use: +% \begin{macrocode} +%%\clearsingleordoublepage +% \end{macrocode} +% \end{macro} +% We then force the cover (ie.~the first page of the proceedings) to be numbered `1': +% \color{black!50} +% \begin{macrocode} +\setcounter{page}{1} +% \end{macrocode} +% \color{black} +% +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Cover page} +% +% We now add a bookmark chapter in the front matter: +% \color{black!50} +% \begin{macrocode} +\pdfbookmark[0]{Preamble}{preamble} +% \end{macrocode} +% \color{black} +% That way, we ensure that all the sections in the front matter/preamble (cover page, welcome letters, etc) except the table of contents appear in a same bookmark as sub-items, thus reducing the number of lines appearing that do not deal with days, sessions, papers, etc. +% Note that we do it by hand. This is not as beautiful and general as if the class was doing it for you (which could have been done); however, not automatizing this bookmark entry allows the proceedings editor to decide if he wishes to link to the first pages or not. +% +% We then include the first page and generate its bookmark entry: +% \color{black!50} +% \begin{macrocode} +\pdfbookmark[1]{Cover}{cover} +% \end{macrocode} +% \color{black} +% and produce the first page: +% \color{black!50} +% \begin{macrocode} +\maketitle +% \end{macrocode} +% \color{black} +% An alternative to the \cmd{\maketitle} command consists in inserting the first page as a PDF 1-page document generated with another software: +% \begin{macrocode} +%%\includepdf[noautoscale,pages=1,link]{\PICTPATH ex_1stpage.pdf} +% \end{macrocode} +% +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Customize TOC formatting} +% +% We can now change some of the TOC formatting (centered, lower and small capitals TOC name) with the following hack: +% \begin{itemize} +% \item[(i)] add a 1cm vertical space: +% \end{itemize} +% \begin{macrocode} +\addtocontents{toc}{\vskip 1cm} +% \end{macrocode} +% \begin{itemize} +% \item[(ii)] add the TOC name in the text of the TOC contents, with the formatting we want: +% \end{itemize} +% \begin{macrocode} +\addtocontents{toc}{\centerline{\huge\textsc{Conference Program}}} +% \end{macrocode} +% \begin{itemize} +% \item[(iii)] remove the TOC name in the TOC only (not in the PDF bookmarks): +% \end{itemize} +% \begin{macrocode} +\renewcommand{\contentsname}{\texorpdfstring{}{Conference Program}} +% \end{macrocode} +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Publishing informations} +% +% Publishing informations are then given on page 2, inside the cover: +% \begin{macrocode} +\newpage +\vspace*{1.7cm} +\pdfbookmark[1]{Publishing informations}{publishing} +% \end{macrocode} +% with no header nor footer on this page: +% \begin{macrocode} +\thispagestyle{empty} +% \end{macrocode} +% We then provide the publishing information itself: +% \begin{macrocode} +\noindent {\bf Published by:}\\ Laboratory Name\\ Department name\\ +School Name\\ University Name\\ +\url{http://www.conferencesite.com}\\ +% \end{macrocode} +% We also indicate the ISBN number: +% \begin{macrocode} +\vspace*{0.15cm}\newline +\noindent {\bf ISBN: X-XXXX-XXXXXX}\\ +% \end{macrocode} +% and the credits: +% \begin{macrocode} +\vspace*{0.35cm}\newline +\noindent {\bf Credits:}\\ +Cover design: Firstname Lastname\\ +Logo photo: Firstname Lastname\\ +\LaTeX{} editor: Firstname Lastname\\ +% \end{macrocode} +% If you think \package{\filename} is a time-saving solution, that's a good place to spread the word\footnote{Do not forget to send me a postcard too :-).}. +% \begin{macrocode} +using \LaTeX's `confproc' package, version 0.7 (optional: by V. Verfaille)\\ +% \end{macrocode} +% We then indicate where and when the proceedings were printed: +% \begin{macrocode} +\vspace*{0.35cm}\newline +\noindent Printed in City by Print-Company --- Month Year +% \end{macrocode} +% +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Welcome letters} +% +% To ensure next page is numbered and has proper headers/footers, use: +% \color{black!50} +% \begin{macrocode} +\otherpagestyle +% \end{macrocode} +% \color{black} +% Roman page numbers now start to appear. We include all welcome letters\footnote{There is only one welcome letter in this example, but there usually are many others: from the faculty dean, the department dean, the conference chair, etc.}: +% \begin{macrocode} +%%%-- Welcome letters +\clearsingleordoublepage +\vspace*{0.6cm} +\thisotherpagestyle +% \end{macrocode} +% We create the bookmark entry by hand (so that you can remove it): +% \begin{macrocode} +\pdfbookmark[1]{Welcome from Firstname Lastname}{welcome} +% \end{macrocode} +% and the corresponding section (and table of contents entry): +% \begin{macrocode} +\section*{Welcome from Firstname Lastname, Conference Chair} +% \end{macrocode} +% Depending on the text length, you may use either 1.5 line spacing: +% \begin{macrocode} +\vspace*{1.1cm} +\onehalfspace +\begin{center} + \begin{minipage}[h]{14cm} + Text of the welcome letter, with 1.5 lines spacing, blah blah... + Text of the welcome letter, with 1.5 lines spacing, blah blah... + Text of the welcome letter, with 1.5 lines spacing, blah blah... + Text of the welcome letter, with 1.5 lines spacing, blah blah... + \end{minipage} +\end{center} +% \end{macrocode} +% or double line spacing (both are using the \package{setspace} style): +% \begin{macrocode} +\doublespace +\begin{center} + \begin{minipage}[h]{14cm} + Text of the welcome letter, with 2 lines spacing, blah blah... + Text of the welcome letter, with 2 lines spacing, blah blah... + Text of the welcome letter, with 2 lines spacing, blah blah... + Text of the welcome letter, with 2 lines spacing, blah blah... + \end{minipage} +\end{center} +\singlespace +% \end{macrocode} +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Table of contents} +% +% We now insert the conference program (table of contents): +% \color{black!50} +% \begin{macrocode} +\tableofcontents + +% \end{macrocode} +% \color{black} +% N.B.: the bookmark entries are automatically generated from the table of contents. +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Main matter: the papers} +% +% We can then beginning inserting the papers. +% \color{black!50} +% \begin{macrocode} +%%%==== BEGINNING OF PAPERS ==== +% \end{macrocode} +% \color{black} +% Before doing so however, we use the following line to set a counter that is used by +% the \Lopt{pdftk} option to properly count page numbers taking into account the preamble. +% \begin{macrocode} +\setcounter{npagespreamble}{\arabic{page}-1} % only useful for the 'pdftk' option +% \end{macrocode} +% \margindanger{}\textbf{Why do we need to do so?} Since page numbers change from roman to arabic, +% page numbers in the document do restart at 1, whereas for the PDF document (when +% opened into a viewer), page numbers are different and go on increasing! Therefore, +% the export of individual papers with \package{pdftk}\footnote{Get \file{pdftk} at: \url{http://www.accesspdf.com/pdftk/}} could not work without this trick, that I still +% did not figure out how to hide from the user. +% +% \begin{macro}{\mainmatter} +% We now (and only after last line) switch to the main matter and to arabic page numbering: +% \color{black!50} +% \begin{macrocode} +\mainmatter +% \end{macrocode} +% \color{black} +% \end{macro} +% Since version 0.5\newvzdseven{}, switching to the main matter does not anymore automatically changes the style of table of contents entries. +% \begin{macro}{\mainmattertocstyle} +% We then explicitely use the optional style: +% \color{black!50} +% \begin{macrocode} +\mainmattertocstyle +% \end{macrocode} +% \color{black} +% \end{macro} +% and can even redefine it in the preamble (it uses the \package{titletoc} package). +% Then, we include the file with all papers' information organized with a switch: +% \begin{macrocode} +\input{\TEXTPATH expapersswitch} +% \end{macrocode} +% +% We then insert the papers, day-by-day and session-by-session. +% \begin{macro}{\procday} +% \margindanger{} Remember that from the bookmark structure point of view, a day appears as a part: +% \end{macro} +% \color{black!50} +% \begin{macrocode} +\procday{Day 1} +% \end{macrocode} +% \color{black} +% \begin{macro}{\session} +% a session appears as a chapter: +% \end{macro} +% \color{black!50} +% \begin{macrocode} + \session{Oral Session 1} +% \end{macrocode} +% \color{black} +% \begin{macro}{\paperid} +% and a paper appears as a section. +% Each paper is inserted by the \cmd{\paperid\{ID\}\{PDFname\}} command, that uses the switch in \file{expapersswitch.tex} to get the information about paper ID: +% \end{macro} +% \begin{macrocode} + \paperid{45}{p_001} + \paperid{21}{p_003} +% \end{macrocode} +% We also insert a poster session with one paper: +% \color{black!50} +% \begin{macrocode} + \session{Poster Session 1} +% \end{macrocode} +% \color{black} +% \begin{macrocode} + \paperid{33}{p_005} +% \end{macrocode} +% and a second oral presentation session with two more papers: +% \color{black!50} +% \begin{macrocode} +\procday{Day 2} + \session{Oral Session 2} +% \end{macrocode} +% \color{black} +% \begin{macrocode} + \paperid{75}{p_007} + \paperid{27}{p_009} +% \end{macrocode} +% \color{black!50} +% \begin{macrocode} + +%%%==== END OF PAPERS ==== +% \end{macrocode} +% \color{black} +% +% +%^^A ================================================================= +%^^A Loading +%^^A ================================================================= +% \subsubsection{Back matter} +% +% \begin{macro}{\backmatter} +% After all papers are inserted, we switch to the document back matter (bibliography \& index): +% \color{black!50} +% \begin{macrocode} +\backmatter +% \end{macrocode} +% \color{black} +% Once again, we use the optional style for table of contents entries: +% \color{black!50} +% \begin{macrocode} +\backmattertocstyle +% \end{macrocode} +% \color{black} +% that we may have redefine it in the preamble (it uses the \package{titletoc} package). +% \end{macro} +% +%^^A------------------------------------------------------------------------ +% \subsubsection{General bibliography} +% +% The general bibliography is inserted with the following style: +% \begin{macrocode} +\bibliographystyle{newapave} +% \end{macrocode} +% This DAFx-06 style is a modification of the \file{newapa} style: the year is indicated at the end, before the back-references, instead of being between parenthesis right after the list of authors. +% If you prefer the \package{newapa} style (or any other style), simply replace this last line by: +% \begin{macrocode} +%%\bibliographystyle{newapa} +% \end{macrocode} +% and comment the line that inserts the \file{newapave} style. +% +% The bibliography is then inserted: +% \begin{macrocode} +{\footnotesize\bibliography{\procbibfile}} +% \end{macrocode} +% Note that the general bibliography may be very long. Changing the font size (for instance to \verb+\footnotesize+ as in the previous line) may then be a good idea. +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Index of authors} +% +% \begin{macro}{\insertindex} +% We finally insert the index: +% \end{macro} +% \color{black!50} +% \begin{macrocode} +\insertindex +\end{document} +% \end{macrocode} +% \color{black} +% \begin{macrocode} +% +% \end{macrocode} +% +%^^A\changes{0.1f}{2007/08/02}{merging welcome and publishing in the example} +% +% +% +%^^A ================================================================= +% \subsection{\file{expapersswitch.tex}: Paper switch!} +% \label{sec:ex:paper:switch} +% +% Let us now take a look at the paper switch, which is central to this version of the proceedings. +% It contains a switch to proceedings papers, allowing to work on the document without needing +% to know yet the final order of papers (which is useful when working in parallel on the document +% and on the conference program). +% +% +%^^A\changes{0.1}{2007/08/01}{File: create \file{expapersswitch.tex}} +%^^A\changes{0.1f}{2007/08/03}{Cmds: renaming loc as paper} +%^^A ================================================================= +%^^A Here is the creation of the expapersswitch.tex file, part of the example. +%^^A It is written on first LaTeX run if it does not already exist +%^^A ================================================================= +% +% \newvzdseven{}Version 0.7 of \package{\filename} redefines the paper insertion interface +% with \cmdDescribe{\procpaper}, that uses key-values options and thus clarifies the \LaTeX{} code. +% We define the \cmd{\paperid} command: +% \begin{macro}{\paperid} +% \begin{macrocode} +%<*expapersswitch> +\newcommand{\paperid}[2]{ +% \end{macrocode} +% \end{macro} +% \begin{macro}{\paperswitch} +% Inside the switch, the \cmd{\paperswitch} command is set to the paper reference: +% \end{macro} +% \begin{macrocode} +\renewcommand{\paperswitch}{#1} +% \end{macrocode} +% +% Papers can still be inserted using the pre-version 0.5 \cmd{\procinsertpaper} command +% (see next section), but it is strongly recommanded to forget it and use the new interface +% of the \cmd{\procpaper} command (version 0.5 and above). +% +%^^A------------------------------------------------------------------------ +% \subsubsection{First and old way: pre-version 0.5 interface} +% +% To insert the first paper (ID=45) with the pre-version 0.5 command (compatibility check), +% we first define commands to help making this old code readible: +% \begin{macrocode} +%=========== PAPER ID = 45 =========== +\ifnum\paperswitch=45 { + \newcommand{\papertitle}{Templates for One Author} + \newcommand{\paperauthors}{Alfred Alabama} + \newcommand{\paperindex}{\index{Alabama, Alfred}} + \newcommand{\paperref}{\paperswitch} + \newcommand{\paperpagenum}{6} + \newcommand{\papercite}{Serra:1996:sms,% + Moorer:2000:AES:audio:millenium,Arfib:1998:DAFx,% + Mitra:Kaiser:1993:DSP:handbook} +% \end{macrocode} +% We then use the old \cmdDescribe{\procinsertpaper} command to insert papers\footnote{This +% command has 9 arguments that must be used in this exact order: +% (i) X and Y shifts (with a space in between, as in `{10 12}'); +% (ii) the number of pages; +% (iii) the paper reference; +% (iv) the title; +% (v) the list of authors; +% (vi) the index entries; +% (vii) the citations for the general bibliography; +% (viii) the name of the PDF file to insert; +% (ix) the bookmark entries for the authors. Hopefully, \person{Andreas Matthias} +% suggested me to use key-values options, and it is no more useful to do it this old way!}: +% \begin{macrocode} + \procinsertpaper{\LaTeXxShift{} \LaTeXyShift}{\paperpagenum}% + {\paperref}{\papertitle}{\paperauthors}{\paperindex}{\papercite}% + {#2}{\pdfbookmark[2]{Alfred Alabama}{#2.author1}}} +\fi +% \end{macrocode} +% As we can see, it still works; this is however too ugly. Why would you still want to use +% such an bad interface to set arguments? +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Second and preferred way: shorter and more readible} +% +% Thanks to the new \cmdDescribe{\procpaper} command, it is much simpler and more +% \newvzdseven{}readible to insert papers: except the paper file name, the other arguments are +% optional, and their name is clear enough! The lines of next code correspond to what is +% generated by the \file{generateswitch.pl} Perl script (see sec.~\ref{sec:scripts:perl}), which +% converts the \file{.csv} data into \LaTeX{} code to insert in this current file: +% +% \begin{macrocode} +\ifnum\paperswitch=21 + \procpaper[xshift=\LaTeXxShift{}, yshift=\LaTeXyShift{}, npages=5, switch=21,% + title={Templates for One Author with Two Affiliations},% + author={Bob Boogie-Woogie},% + index={\index{Boogie-Woogie, Bob}},% + cite={Serra:1996:sms,Moorer:2000:AES:audio:millenium,Arfib:1998:DAFx,% + Haykin:1991:adaptive:filter},% + bookmark={\pdfbookmark[2]{Bob Boogie-Woogie}{#2.author1}}% + ]{#2} +\fi + +\ifnum\paperswitch=27 + \procpaper[xshift=\LaTeXxShift{}, yshift=\LaTeXyShift{}, npages=7, switch=27,% + title={Templates f\'or F\`o\"ur Àuthors},% + author={J\o{}hn J\"oe, K\'e\~{n}t K\^{\i}ng, L\`ou L\'ou,% + M\`anfr\'ed J. M\^ost\u{e}k\i},% + index={\index{J\"oe, J\o{}hn}\index{K\^{\i}ng, K\'e\~{n}t}% + \index{L\'ou, L\`ou}\index{M\^ost\u{e}k\i, M\`anfr\'ed J.}},% + cite={Serra:1996:sms,Moorer:2000:AES:audio:millenium,Dutilleux:1991,% + Fitz:Haken:2003:Web:morphing:loris}, + bookmark={\pdfbookmark[2]{J\o{}hn J\"oe}{#2.author1}% + \pdfbookmark[2]{K\'e\~{n}t K\^{\i}ng}{#2.author2}% + \pdfbookmark[2]{L\`ou L\'ou}{#2.author3}% + \pdfbookmark[2]{M\`anfr\'ed J. M\^ost\u{e}k\i}{#2.author4}}% + ]{#2} +\fi + +\ifnum\paperswitch=33 + \procpaper[xshift=\LaTeXxShift{}, yshift=\LaTeXyShift{}, npages=4, switch=33,% + title = {Templates for Two Authors},% + author={Alfred Alabama, Chris Christmas},% + index={\index{Alabama, Alfred}\index{Christmas, Chris}},% + cite={Serra:1996:sms,Moorer:2000:AES:audio:millenium,% + Arfib:1998:DAFx,Askenfelt:1976:automatic:transcription}, + bookmark={\pdfbookmark[2]{Alfred Alabama}{#2.author1}% + \pdfbookmark[2]{Chris Christmas}{#2.author2}}% + ]{#2} +\fi + +\ifnum\paperswitch=75 + \procpaper[xshift=\LaTeXxShift{}, yshift=\LaTeXyShift{}, npages=6, switch=75,% + title={Templates for Three Authors},% + author={Bob Boogie-Woogie, Chris Christmas, Don Didon},% + index={\index{Boogie-Woogie, Bob}\index{Christmas, Chris}% + \index{Didon, Don}},% + cite={Serra:1996:sms,Moorer:2000:AES:audio:millenium,% + Arfib:1998:DAFx,Egozy:1995:MIT:features:gesture},% + bookmark={\pdfbookmark[2]{Bob Boogie-Woogie}{#2.author1}% + \pdfbookmark[2]{Chris Christmas}{#2.author2}% + \pdfbookmark[2]{Don Didon}{#2.author3}}% + ]{#2} +\fi +% \end{macrocode} +% We're done with the papers data, but \textbf{we must not forget to close the +% curly brace!} +% \begin{macrocode} +} +% +% \end{macrocode} +% +%^^A\changes{0.2d}{2007/08/18}{Adding the description and examples for day and session organized conferences} +%^^A\changes{0.2d}{2007/08/18}{Adding examples of table of contents and bookmarks layouts} +% +% +% +% +%^^A------------------------------------------------------------------------ +% \subsection{\file{expages.tex}: Get page numbers and recompile all papers} +% +% In the case where inserted papers have headers/footers, we may have to recompile them all +% with the proper page numbers. Before doing so, compile the proceedings enough times so +% that the table of contents is generated and inserted. Then, use the page number indicated for +% each paper to edit accordingly the \file{expages.tex} file. An example is provided here: +%^^A\changes{0.7}{2010/08/05}{Example: corrected switch numbers on \file{expages.tex}} +% \begin{macrocode} +%<*expages> +\newcommand{\setpagenumber}[1]{ + \newcommand{\paperswitch}{#1} + \ifnum\paperswitch=45 {\setcounter{page}{1}}\fi + \ifnum\paperswitch=21 {\setcounter{page}{7}}\fi + \ifnum\paperswitch=27 {\setcounter{page}{13}}\fi + \ifnum\paperswitch=33 {\setcounter{page}{17}}\fi + \ifnum\paperswitch=75 {\setcounter{page}{23}}\fi +} +% +% \end{macrocode} +% +% You may then recompile all papers (use the \file{buildpapers} Unix script, see sec.~\ref{sec:scripts:buildpapers}), provided that they all have the corresponding line in their preamble:\\ +% \verb+\input{../../expages.tex}\setpagenumber{01}+\\ +% where \verb+01+ is the paper reference (to be changed for each paper). Using the following:\\ +% \verb+\setcounter{page}{1}+\\ +% would of course have the equivalent effect, except that you would have to re-edit each paper after changing your program order. +% +%^^A ================================================================= +% \subsection{\file{exsessions.tex}: Organize the conference program by sessions/day} +%^^A \subsection{Generate the conference program} +% \label{sec:ex:program} +% +% +% Depending on the conference duration, the program may feature a few sessions during 2 or 3 days, or many sessions during 4 to 7 days (or even more). Then, the table of contents and the bookmarks may be organized: +% \begin{itemize} +% \item by sessions and then by related papers (short conferences): see sec. \ref{sec:sec:sessions}; +% \item by day, then by sessions and then by papers (long conferences, to avoid a too long list of sessions in the PDF bookmark): see sec. \ref{sec:sec:days}. +% \end{itemize} +% +% The mechanism used in \package{\filename} to build the table fo contents and bookmarks +% is based on section levels: days are inserted in the table of contents and bookmarks as parts, +% whereas sessions are inserted as chapters and papers as sections. +% +% Note that the {\bf \package{\filename} does not handle programs with parallel sessions}. +% It is then up to you to decide in which order they may appear in the table of contents. +% +%^^A\changes{0.2e}{2007/09/01}{Doc: all sessions/days tables redone with tabular instead of minipage (smaller and easier to read)} +%^^A ================================================================= +% \subsubsection{\file{exsessions.tex}: Program organized by sessions}\label{sec:sec:sessions} +% +% For a small size conference, if not using days (comment the \cmd{\procday{}} lines in the example), +% you will obtain the table of contents corresponding to Tab~\ref{tab:program:session}. +% The corresponding bookmark is depicted closed in Tab.~\ref{tab:program:session:bkmrk0}, +% opened at its first level in Tab.~\ref{tab:program:session:bkmrk1}, and opened at its second level +% in Tab.~\ref{tab:program:session:bkmrk2}. +% +% \begin{table}[htb!] +% \centering +% \framebox{ +% \begin{tabular}{ll} +% \multicolumn{2}{l}{\bf Conference Program}\\ +% & \vspace*{-0.1cm}\\ +% \multicolumn{2}{l}{\textbf{\textit{Oral Session 1}}}\\ +% 1 & Templates for One Author\\ +% & {\it Alfred Alabama}\\ +% & \vspace*{-0.3cm}\\ +% 7 & Templates for One Author with Two Affiliations\\ +% & {\it Bob Boogie-Woogie}\\ +% & \vspace*{-0.1cm}\\ +% \multicolumn{2}{l}{\textbf{\textit{Poster Session 1}}}\\ +% 11 & Templates for Two Authors\\ +% & {\it Alfred Alabama, Chris Christmas}\\ +% & \vspace*{-0.1cm}\\ +% \multicolumn{2}{l}{\textbf{\textit{Oral Session 2}}}\\ +% 15 & Templates for Three Authors\\ +% & {\it Bob Boogie-Woogie, Chris Christmas, Don Didon}\\ +% & \vspace*{-0.3cm}\\ +% 21 & Templates f\'or F\`o\"ur \`Authors\\ +% & {\it John J\"oe, K\'e\~{n}t K\^{\i }ng, L\`ou L\'ou, M\`anfr\'ed J. M\^ost\u{e}ki} \\ +% & \vspace*{-0.1cm}\\ +% 27 & {\bf Full Bibliography}\\ +% & \vspace*{-0.1cm}\\ +% 28 & {\bf Index of Authors}\\ +% \end{tabular}} +% \caption{{\it Example of table of contents for a conference organized by sessions.}} +% \label{tab:program:session} +% \end{table} +% +% \begin{table}[htb!] +% \centering +% \textsf{% +% \begin{tabular}{l@{\,}l} \hline +% $\blacktriangleright$ & Preamble\\ +% & Program\\ +% $\blacktriangleright$ & Oral Session 1\\ +% $\blacktriangleright$ & Poster Session 1\\ +% $\blacktriangleright$ & Oral Session 2\\ +% & Full Bibliography\\ +% & Index of Authors\\ \hline +% \end{tabular}} +% \caption{{\it Closed bookmarks for a conference organized by sessions.}} +% \label{tab:program:session:bkmrk0} +% \end{table} +% +% \begin{table}[htb!] +% \centering +% \textsf{% +% \begin{tabular}{l@{\,}l@{\,}l} \hline +% $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Preamble} \\ +% & & Cover\\ +% & & Publishing informations\\ +% & & Welcome from Firstname Lastname\\ +% & \multicolumn{2}{@{\,}l}{Program} \\ +% $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Oral Session 1} \\ +% & $\blacktriangleright$ & Template for One Author\\ +% & $\blacktriangleright$ & Template for One Author with Two Affiliations\\ +% $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Poster Session 1} \\ +% & $\blacktriangleright$ & Template for Two Authors\\ +% $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Oral Session 2} \\ +% & $\blacktriangleright$ & Template for Three Authors\\ +% & $\blacktriangleright$ & Template f\'or F\`o\"ur \`Authors\\ +% & \multicolumn{2}{@{\,}l}{Full Bibliography} \\ +% & \multicolumn{2}{@{\,}l}{Index of Authors} \\ \hline +% \end{tabular}} +% \caption{{\it First-level opened bookmarks for a conference organized by sessions.}} +% \label{tab:program:session:bkmrk1} +% \end{table} +% +% \begin{table}[htb!] +% \centering +% \textsf{% +% \begin{tabular}{l@{\,}l@{\,}ll} \hline +% $\blacktriangledown$ & \multicolumn{3}{@{\,}l}{Preamble} \\ +% & & \multicolumn{2}{@{\,}l}{Cover}\\ +% & & \multicolumn{2}{@{\,}l}{Publishing informations}\\ +% & & \multicolumn{2}{@{\,}l}{Welcome from Firstname Lastname}\\ +% & \multicolumn{3}{@{\,}l}{Program} \\ +% $\blacktriangledown$ & \multicolumn{3}{@{\,}l}{Oral Session 1} \\ +% & $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Template for One Author}\\ +% & & & Alfred Alabama\\ +% & $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Template for One Author with Two Affiliations}\\ +% & & & Bob Boogie-Woogie\\ +% $\blacktriangledown$ & \multicolumn{3}{@{\,}l}{Poster Session 1} \\ +% & $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Template for Two Authors}\\ +% & & & Alfred Alabama\\ +% & & & Chris Christmas\\ +% $\blacktriangledown$ & \multicolumn{3}{@{\,}l}{Oral Session 2} \\ +% & $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Template for Three Authors}\\ +% & & & Bob Boogie-Woogie\\ +% & & & Chris Christmas\\ +% & & & Don Didon\\ +% & $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Template f\'or F\`o\"ur \`Authors}\\ +% & & & John J\"oe\\ +% & & & K\'e\~{n}t K\^{\i}ng\\ +% & & & L\`ou L\'ou\\ +% & & & M\`anfred J. M\^ost\u{e}k\i\\ +% & \multicolumn{3}{@{\,}l}{Full Bibliography} \\ +% & \multicolumn{3}{@{\,}l}{Index of Authors} \\ \hline +% \end{tabular}} +% \caption{{\it Second-level opened bookmarks for a conference organized by sessions.}} +% \label{tab:program:session:bkmrk2} +% \end{table} +% +% \clearpage +% +%^^A ================================================================= +% \subsubsection{Program organized by days}\label{sec:sec:days} +% +% In the case of bigger conferences with a program organized by day, you will get the +% table of contents corresponding to Tab~\ref{tab:program:day}. The corresponding bookmark +% is depicted closed in Tab.~\ref{tab:program:day:bkmrk0}, opened at its first level in +% Tab.~\ref{tab:program:day:bkmrk1}, and opened at its second level Tab.~\ref{tab:program:day:bkmrk2}. +% +% \begin{table}[htb!] +% \centering +% \framebox{ +% \begin{tabular}{ll} +% \multicolumn{2}{l}{\bf Conference Program}\\ +% & \vspace*{-0.1cm}\\ +% \multicolumn{2}{l}{\bf Day 1}\\ +% & \vspace*{-0.1cm}\\ +% \multicolumn{2}{l}{\textbf{\textit{Oral Session 1}}}\\ +% 1 & Templates for One Author\\ +% & {\it Alfred Alabama}\\ +% & \vspace*{-0.3cm}\\ +% 7 & Templates for One Author with Two Affiliations\\ +% & {\it Bob Boogie-Woogie}\\ +% & \vspace*{-0.1cm}\\ +% \multicolumn{2}{l}{\textbf{\textit{Poster Session 1}}}\\ +% 11 & Templates for Two Authors\\ +% & {\it Alfred Alabama, Chris Christmas}\\ +% & \vspace*{-0.1cm}\\ +% \multicolumn{2}{l}{\bf Day 2}\\ +% & \vspace*{-0.1cm}\\ +% \multicolumn{2}{l}{\textbf{\textit{Oral Session 2}}}\\ +% 15 & Templates for Three Authors\\ +% & {\it Bob Boogie-Woogie, Chris Christmas, Don Didon}\\ +% & \vspace*{-0.3cm}\\ +% 21 & Templates f\'or F\`o\"ur \`Authors\\ +% & {\it John J\"oe, K\'e\~{n}t K\^{\i }ng, L\`ou L\'ou, M\`anfr\'ed J. M\^ost\u{e}ki} \\ +% & \vspace*{-0.1cm}\\ +% 27 & {\bf Full Bibliography}\\ +% & \vspace*{-0.1cm}\\ +% 28 & {\bf Index of Authors}\\ +% \end{tabular}} +% \caption{{\it Example of table of contents for a conference organized by day.}} +% \label{tab:program:day} +% \end{table} +% +% \begin{table}[htb!] +% \centering +% \textsf{% +% \begin{tabular}{@{\,}l@{\,}l} \hline +% $\blacktriangleright$ & Preamble\\ +% & Program\\ +% $\blacktriangleright$ & Day 1\\ +% $\blacktriangleright$ & Day 2\\ +% & Full Bibliography\\ +% & Index of Authors\\ \hline +% \end{tabular}} +% \caption{{\it Closed bookmarks for a conference organized by days.}} +% \label{tab:program:day:bkmrk0} +% \end{table} +% +% +% \begin{table}[htb!] +% \centering +% \textsf{% +% \begin{tabular}{@{\,}l@{\,}l@{\,}l} \hline +% $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Preamble}\\ +% & & Cover\\ +% & & Publishing informations\\ +% & & Welcome from Firstname Lastname\\ +% & \multicolumn{2}{@{\,}l}{Program}\\ +% $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Day 1}\\ +% & $\blacktriangleright$ & Oral Session 1\\ +% & $\blacktriangleright$ & Poster Session 1\\ +% $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Day 2}\\ +% & $\blacktriangleright$ & Oral Session 2\\ +% & \multicolumn{2}{@{\,}l}{Full Bibliography}\\ +% & \multicolumn{2}{@{\,}l}{Index of Authors}\\ \hline +% \end{tabular}} +% \caption{{\it First-level opened bookmarks for a conference organized by days.}} +% \label{tab:program:day:bkmrk1} +% \end{table} +% +% \begin{table}[htb!] +% \centering +% \textsf{% +% \begin{tabular}{@{\,}l@{\,}l@{\,}l@{\,}l} \hline +% $\blacktriangledown$ & \multicolumn{3}{@{\,}l}{Preamble}\\ +% & & \multicolumn{2}{@{\,}l}{Cover}\\ +% & & \multicolumn{2}{@{\,}l}{Publishing informations}\\ +% & & \multicolumn{2}{@{\,}l}{Welcome from Firstname Lastname}\\ +% & \multicolumn{3}{@{\,}l}{Program}\\ +% $\blacktriangledown$ & \multicolumn{3}{@{\,}l}{Day 1}\\ +% & $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Oral Session 1}\\ +% & & $\blacktriangleright$ & Template for One Author\\ +% & & $\blacktriangleright$ & Template for One Author with Two Affiliations\\ +% & $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Poster Session 1}\\ +% & & $\blacktriangleright$ & Template for Two Authors\\ +% $\blacktriangledown$ & \multicolumn{3}{@{\,}l}{Day 2}\\ +% & $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Oral Session 2}\\ +% & & $\blacktriangleright$ & Template for Three Authors\\ +% & & $\blacktriangleright$ & Template f\'or F\`o\"ur \`Authors\\ +% & \multicolumn{3}{@{\,}l}{Full Bibliography}\\ +% & \multicolumn{3}{@{\,}l}{Index of Authors}\\ \hline +% \end{tabular}} +% \caption{{\it Second-level opened bookmarks for a conference organized by days.}} +% \label{tab:program:day:bkmrk2} +% \end{table} +% +% \clearpage +% +% +%^^A ================================================================= +% \subsection{\file{exprogram.csv}: Generate the conference program from a CSV file} +% \label{sec:scripts:program} +% +% It may be easier to collect data about the papers from a server, manipulate them +% in a spreadsheet software (for example M\$ Excel), and then generate the program from a +% \file{.csv} file. The provided \file{generateswitch.pl} Perl script (see sec.~\ref{sec:scripts:perl}) +% generates the corresponding \file{expaperswitch.tex} and \file{exsessions.tex} files +% for the example. +% First, let's take a look at the following CSV file, that contains the example's conference +% program\footnote{This is normal that this text goes on after the margin. +% Please check the generated file if you wish to read each line.}: +% +%^^A ================================================================= +%^^A Here is the creation of the procwitchandtoc.pl file, part of the example. +%^^A It is written on first LaTeX run if it does not already exist +%^^A ================================================================= +% {\scriptsize +% \begin{macrocode} +%<*exprogram> +Type,Paper Number,PC Decision,Pages,Title,File Name,Generated,Citations,Auth1 First Name,Auth1 Last Name,Auth2 First Name,Auth2 Last Name,Auth3 First Name,Auth3 Last Name,Auth4 First Name,Auth4 Last Name,, +Type,-2,O,,,,,,First Name,Last Name,First Name,Last Name,First Name,Last Name, F.Name, L.Name,, +Day,0,,,"Day 1: September 18, 2007",,,,,,,,,,,,, +Session,0,,,Oral Session 1,,,,,,,,,,,,, +paper,45,O,6,Templates for One Author,p_001,LaTeX,"Serra:1996:sms,Moorer:2000:AES:audio:millenium,Arfib:1998:DAFx,Mitra:Kaiser:1993:DSP:handbook",Alfred,Alabama,,,,,,,, +paper,21,O,5,Templates for One Author with Two Affiliations,p_003,LaTeX,"Serra:1996:sms,Moorer:2000:AES:audio:millenium,Arfib:1998:DAFx,Haykin:1991:adaptive:filter",Bob,Boogie-Woogie,,,,,,,, +Poster Session,0,,,Poster Session 1,,,,,,,,,,,,, +paper,33,P,4,Templates for Two Authors,p_005,LaTeX,"Serra:1996:sms,Moorer:2000:AES:audio:millenium,Arfib:1998:DAFx,Askenfelt:1976:automatic:transcription",Alfred,Alabama,Chris,Christmas,,,,,, +Day,0,,,"Day 2: September 19, 2007",,,,,,,,,,,,, +Session,0,,,Oral Session 2,,,,,,,,,,,,, +paper,75,O,6,Templates for Three Authors,p_007,LaTeX,"Serra:1996:sms,Moorer:2000:AES:audio:millenium,Arfib:1998:DAFx,Egozy:1995:MIT:features:gesture",Bob,Boogie-Woogie,Chris,Christmas,Don,Didon,,,, +paper,27,O,7,Templates fór Fòür Àuthors,p_009,LaTeX,"Serra:1996:sms,Moorer:2000:AES:audio:millenium,Dutilleux:1991,Fitz:Haken:2003:Web:morphing:loris",John,Jöe,Kéñt,Kîng,Lòu,Lóu,Mànfréd J.,Môst\u{e}k\i,, +% +% \end{macrocode} +% } +% +% As expected fromt its first line, it contains the following columns: +% \begin{enumerate} +% \item {\bf Type:} the script will accept the following values: +% \begin{itemize} +% \item use \verb+Type+ for the items/lines to be ignored; +% \item Day: use \verb+Day+; +% \item Session: for oral session, use \verb+Session+, \verb+Paper Session+ or +% \verb+Oral Session+; for poster sessions, use \verb+poster session+; +% for demonstration sessions, use \verb+Demo Session+; +% \item Paper: use \verb+paper+ or \verb+oral+ for oral presentation; \verb+poster+ +% for poster presentation; \verb+demo+ for demo. The 3 output identical code anyway: +% the different values only help to organize the program!. +% \end{itemize} +% N.B.: theses values are not case sensitively processed by the \file{generateswitch.pl} Perl script. +% \item {\bf Number:} paper number or reference, often generated by the submission system. +% It will be used for paper insertion, for ordering the program, etc. +% \item {\bf PC Decision:} \verb+oral+ or \verb+poster+. +% It does not change the \LaTeX\ generated code, so you may not use it; +% \item {\bf Pages:} number of pages; +% \item {\bf Title:} paper/session title; +% \item {\bf File Name:} name of the corresponding \file{.pdf} file; +% \item {\bf Generated:} software used to generate the \file{.pdf} files (e.g.: \verb+LaTeX+, \verb+Word+): +% this allows to use different $X$ and $Y$ offset values +% (we however used the same value for all papers of one kind); +% \item {\bf Citations:} list of bibliography items for the general bibliography \\(ex: \verb+\cite{bibitem1,bibitem2,bibitem3}+); blank if no general bibliography; +% \item {\bf Auth1 First Name:} first name of author 1; +% \item {\bf Auth1 Last Name:} last name of author 1; +% \item {\bf Auth2 First Name:} first name of author 2, blank if none; +% \item {\bf Auth2 Last Name:} last name of author 2, blank if none; +% \item {\bf Auth3 First Name:} first name of author 3, blank if none; +% \item {\bf Auth3 Last Name:} last name of author 3, blank if none; +% \item {\bf Auth4 First Name:} first name of author 4, blank if none; +% \item {\bf Auth4 Last Name:} last name of author 4, blank if none; +% \item {\bf comments:} there is an extra column, that is not used by the script. +% \end{enumerate} +% +% +%^^A ================================================================= +% \subsection{\file{exbiblio.bib}: Common bibliography items} +% \label{sec:ex:bib:common} +% +%^^A\changes{0.1d}{2007/08/01}{Biblio: adding the \file{exbiblio.tex} file creation} +%^^A\changes{0.1i}{2007/08/10}{Biblio: code cleanup} +%^^A\changes{0.1i}{2007/08/10}{Biblio: adding the \cmd{\procbibintro} command to customize the biblio introduction} +%^^A ================================================================= +%^^A Here is the creation of the exbibcommon.tex file, part of the example. +%^^A It is written on first LaTeX run if it does not already exist +%^^A ================================================================= +% +% Let us now take a look at the common bibliographic items of this example: +% \changes{0.4b}{2007/10/12}{bibliography: removed item containing introductory paragraph} +% \begin{macrocode} +%<*exbiblio> +%-- references to a book +@book{Mitra:Kaiser:1993:DSP:handbook, + Author = {S.~K. Mitra and J.~F. Kaiser}, + Title = {Handbook for Digital Signal Processing}, + Publisher = {J. Wiley {\&} Sons}, + Year = {1993}} + +@book{Haykin:1991:adaptive:filter, + Author = {Simon Haykin}, + Title = {Adaptive Filter Theory}, + Publisher = {Prentice Hall}, + Address = {Englewood Cliffs}, + Edition = {Second}, + Year = {1991}} + +%-- reference to a book chapter +@inbook{Serra:1996:sms, + Author = {X. Serra}, + Chapter = {Musical Sound Modeling with Sinusoids plus Noise}, + Publisher = {G. D. Poli, A. Picialli, S. T. Pope and C. Roads,% + Eds.~Swets~\&~Zeitlinger}, + Title = {Musical Signal Processing}, + Pages = {91--122}, + Year = {1996}} + +%-- reference to a journal paper +@article{Moorer:2000:AES:audio:millenium, + Author = {James A. Moorer}, + Title = {Audio in the New Millennium}, + Journal = {Journal of the {AES}}, + Volume = 48, + Number = 5, + Year = 2000, + Month = may, + Pages = {490--498}} + +%-- reference to a proceeding paper +@inproceedings{Arfib:1998:DAFx, + Author = {D. Arfib}, + Booktitle = {Proc. of the COST-G6 Workshop on Digital Audio Effects % + (DAFx-98)}, + Title = {Different Ways to Write Digital Audio Effects Programs}, + Address = {Barcelona, Spain}, + Pages = {188--91}, + Year = {1998}} + +%-- reference to a technical report +@techreport{Askenfelt:1976:automatic:transcription, + Author = {A. Askenfelt}, + Title = {Automatic notation of played music (status report)}, + Institution = {{STL-QPSR, Vol. 1, pp. 1--11}}, + Year = {1976}} + +%-- reference to a master thesis +@mastersthesis{Egozy:1995:MIT:features:gesture, + Author = {E.~B. Egozy}, + title = {Deriving musical control features from a real-time timbre % + analysis of the clarinet}, + School = {Massachusetts Institute of Technology}, + Year = {1995}} + +%-- reference to a PhD thesis +@phdthesis{Dutilleux:1991, + Author = {P. Dutilleux}, + School = {University of Aix-Marseille II}, + Title = {Vers la machine \`a sculpter le son, modification en % + temps-r\'eel des caract\'eristiques fr\'equentielles et temporelles% + des sons}, + Year = {1991}} + +%-- reference to a web page +@unpublished{Fitz:Haken:2003:Web:morphing:loris, + Author = {K. Fitz and L. Haken}, + Title = {{Current Research in Real-time Sound Morphing}}, + Note = {Available at \href{http://www.cerlsoundgroup.org/RealTimeMorph/}% + {http://www.cerlsoundgroup.org/RealTimeMorph/}}, + Year = {Accessed March 08, 2006}} +% +% \end{macrocode} +% +% Please refer to sec.~\ref{sec:general:bib} for details about the bibliography merging process. +% +%^^A {\sc Explain also that each paper's bibitems' tags were renamed using the paper ID, and each paper was then recompiled with this general bibliography, to ensure coherence between local bibliographies and general bibliography. This implies to work on each paper afterwards to ensure then do not become overlengthen...} +% +% +% +% +% +%^^A\changes{0.2i}{2007/09/21}{Doc: finishing biblio merging and other biblio-related stuff} +%^^A ================================================================= +% \subsection{General bibliography}\label{sec:general:bib} +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Making the general bibliography} +% +% For the DAFx-06 proceedings (but not for the provided example), we worked with three bibliography files in order to simplify the bibliography merging process: +% \begin{itemize} +% \item \texttt{exbibconcat.bib} containing all citations for all papers; +% \item \texttt{exbibcommon.bib} containing common bibliography items, added one by one during the merging process; +% \item \texttt{exbibstrings.bib} containing all common strings (conference names, journal names, etc), to ensure coherence among citations from same sources (journal, conference). +% \end{itemize} +% Here is how those files were created and used: +% \begin{enumerate} +% \item create the complete bibliography: +% \begin{enumerate} +% \item for each paper, change its bib item tags to a tag that cannot be common to 2 papers (we used a format starting with the paper number: \verb+paperID:originaltag+)\footnote{You may ask authors to do so when sending them editor's notes.}; +% \item ensure that each paper has a proper list of bibliography items using those new tags; +% \item add individual paper bibliography items into the file named \file{exbibconcat.bib}; +% \item set the proceedings bibliography file to:\begin{verbatim} +%\renewcommand{\procbibfile}{\BIBPATH exbibconcat.bib} +%\end{verbatim} +% \item run \LaTeX\ with the complete bibliography (using the \Lopt{compil=bibmerge} option that uses \verb+\nocite{*}+) so bib items are include twice: by the paper and globally. You are now ready to merge bibliographies. +% \end{enumerate} +% \item merge the bibliographic items (long step): +% \begin{enumerate} +% \item first, add the \file{exbibcommon.bib} file to the list of bibliography files by setting the proceedings bibliography files to: \begin{verbatim} +%\renewcommand{\procbibfile}{\BIBPATH exbibcommon.bib,% +% \BIBPATH exbibconcat.bib} +%\end{verbatim} +% \item for each item appearing multiple times: +% \begin{enumerate} +% \item create a corresponding entry in the \file{exbibcommon.bib} file; +% \item remove all of its appearances in \file{exbibconcat.bib}; +% \item take this opportunity to correct inconsistent information (title, list of authors, page numbers, etc)! Note that this process requires a lot of time, as it is the slowest in the bibliography merging process. +% \end{enumerate} +% \end{enumerate} +% \item merge the bibliography strings: +% \begin{enumerate} +% \item add \file{exbibstrings.bib} to the list of bibliography files: \begin{verbatim} +%\renewcommand{\procbibfile}{\BIBPATH exbibstrings.bib,% +% \BIBPATH exbibcommon.bib,\BIBPATH exbibconcat.bib} +%\end{verbatim} +% \item merge the common strings. For each string shared by several items: +% \begin{enumerate} +% \item define the corresponding string in the \file{exbibstring.bib} file. For instance, for the IEEE Transactions on Acoustics, Speech, and Signal Processing, add:\begin{verbatim} +%@string{IEEE-TASSP = "{IEEE Trans. Acoust., Speech, +% and Signal Proc.}"} +%\end{verbatim} +% \item use such definitions (\eg{} \file{IEEE-TASSP}) to replace any of its appearance in \file{exbibconcat.bib}. For instance, use:\begin{verbatim} +%@article{paper027:Mcaulay86, +% Author = {Robert J. McAulay and Thomas F. Quatieri}, +% Title = {Speech Analysis/Synthesis Based on a% +% Sinusoidal Representation}, +% Journal = IEEE-TASSP, +% Volume = {34}, +% Number = {4}, +% Pages = {744-754}, +% Year = {1986}} +%\end{verbatim} +% \end{enumerate} +% \end{enumerate} +% \item optimal: update each paper once the general bibliography is ok: +% \begin{enumerate} +% \item for each paper: +% \begin{enumerate} +% \item generate a new bibliography file (\eg{} \file{p\_027.bib} for \file{p\_027.tex}) that only includes its non-common bibliography items remaining in \file{exbibconcat.bib}; +% \item edit each paper so that it uses both this new bibliography file (\file{p\_027.bib}) together with \file{exbibcommon.bib} and \file{exbibstrings.bib}. This will provide common and coherent contents to both local and general bibliographies. Since \file{p\_027.tex} is placed in the \file{papers/pdftex/p\_027/} folder, its bibliography insertion will then become something like:\begin{verbatim} +%\bibliography{../../exbibstrings.bib,% +% ../../exbibcommon.bib,p_027.bib} +%\end{verbatim} +% \end{enumerate} +% \item re-run \LaTeX\ on all papers, using the \file{buildpapers} Unix script (see sec.~\ref{sec:scripts:buildpapers}). This script also copies all resulting PDFs to the right place. +% \item if you did not use the previous script, copy all PDF papers to the \file{papers/} folder. The \file{buildcppdfpapers} Unix script (see sec.~\ref{sec:scripts:buildcppdfpapers}) can do it for you, for instance if you changed some of the papers but not all, and do not remember which were to be copied. +% \end{enumerate} +% \end{enumerate} +% You are now done with bibliography merging, and are ready to re-run \LaTeX\ on the proceedings using the \Lopt{compil=backref} options as many times as necessary to provide proper back-references and page numbering. +% +% +% +% +% +%^^A everything else in the proceedings is done (table of contents. index, etc), create the back references with one of those two solutions: +%^^A \begin{itemize} +%^^A \item Good trick: {\sc check this as it seems that it has changed} labels/refs +%^^A \begin{itemize} +%^^A \item insert the $N_i-1$ pages of each paper $i$ and replace last page by a citation of local bibliography. Then, bib items properly appear in the full bibliography +%^^A \item save the \file{DAFx06\_Proceedings.brf} file under another name +%^^A \item recompile the Proceedings without replacing last page by bibliography +%^^A \item rename properly the file \file{DAFx06\_Proceedings.brf} +%^^A \item one last compile, and the backref are ok! +%^^A \item Rk: one should NOT recompile the bibliography without doing this manipulation again +%^^A \end{itemize} +%^^A \item generate the \file{DAFx06\_Proceedings.brf} file by hand! +%^^A \begin{itemize} +%^^A \item create the general backref file \file{DAFx06\_Proceedings.brf} using lines such as:\\ +%^^A \begin{verbatim} +%^^A\backcite{Ref1,Ref2,Ref3}{{12}% +%^^A {(document)}{Doc-Start}} +%^^A \end{verbatim} +%^^A \item update all pages numbers in the \file{DAFx06\_Proceedings.brf} back references file +%^^A \item have a back reference for each page where the reference is appearing (maybe several for each paper). +%^^A \item save your \file{DAFx06\_Proceedings.brf} file under another name, since it will be erase by the next bib compilation +%^^A \end{itemize} +% +% +% +%^^A------------------------------------------------------------------------ +%^^A \subsubsection{Some considerations on bibliographies} +% +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Which bib styles for the templates?} +% +% Concerning the paper bibliography style, each conference has its own style, often derived from other ones. For instance, the DAFx-06 templates were using the \package{IEEEbib.bst} style. It however is quite old (1993), and not as compact as the latest \package{IEEEtran.bst}. As the DAFx proceedings use the order of appearance and not alphabetical sorting (as do the IEEE publications it was inspired from), the more recent \package{IEEEtranS.bst} style was not suited. The DAFx-06 templates were corrected so as to use \package{IEEEtran.bst} instead of \package{IEEEbib.bst} before insertion of papers into the proceedings. +% +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Which bib styles for the general bibliography?} +% +% The general bibliography style may be a bit different, as it does not require item numbering in order to not get confused with each paper's bibliography item number. Moreover, alphabetical order is more suited as it simplifies the search for any particular author cited. Therefore, we need to use a bibliographic style on its own, other than the paper templates one! +% +% The style to use has to look more like APA style, with the first author's last name coming first. For that reason, we used the \package{newapa} style, and derived the \package{newapave} style with minor cosmetic tweaking (those styles have no numbering, the author list is like ``Lastname, F.'', etc). +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Right-flushing the biblio back-references} +% +% Back-references provided by the \package{hyperref} package are a list of numbers at the end of the bibliographic items (after the last dot). The example using the \package{newapa} bibliographic style would provide:\\ +% +%^^A\changes{0.7}{2010/08/05}{Example: corrected layout example for the general bibliography} +% \begin{center} +% \begin{minipage}[c]{9.2cm} +% \vspace*{-0.2cm}Arfib, D. (1998). Different ways to write digital audio effects programs. +% In {\em Proc. of the COST-G6 Workshop on Digital Audio Effects (DAFx-98)}, +% Barcelona, Spain, (pp. 188--91). \color{red}6, 11, 16, 22, 29 \color{black} +% \end{minipage} +% \end{center} +% +% We modified \package{newapa.bst} (resp. \package{newapa.sty}) by making slight changes (but in many places), and renamed it \package{newapave.bst} (resp. \package{newapave.sty}) for the DAFx-06 proceedings. This modification process was carried out to provide some changes and adjustements in the bibliography style and layout\footnote{no parenthesis around page numbers nor around the year; and year is placed at the end.}, as well as right-flushed back-references. Using the \package{newapa} bibliographic style, the previous example is then modified into something like:\\ +% +% \begin{center} +% \begin{minipage}[c]{9.2cm} +% \vspace*{-0.2cm}Arfib, D. Different ways to write digital audio effects programs. +% In {\em Proc. of the COST-G6 Workshop on Digital Audio Effects (DAFx-98)}, +% Barcelona, Spain, pp. 188--91. 1998. ~~~ \color{red}6, 11, 16, 22, 29\color{black} +% \end{minipage} +% \end{center} +% +% Together with the color links, back-references are easier to see when they are right-flushed that when they are left-flushed. +% +% \margindanger{}To apply the right-flushed back-references to another style, here is the only trick to keep from the hack. +% Edit the function that displays the last item of the bibliographic element list (\package{output.year.check} in our case, because it was reformatted) so as to add a \package{$\backslash$hfill} at the end of that command (the year definition in our example):\begin{verbatim} +%FUNCTION {output.year.check} +%{ year empty$ +% { ``empty year in `` cite$ * warning$ } +% { write$ +% `` (" year * extra.label * ``)" * +% mid.sentence 'output.state := +% } +% if$ +%} +%\end{verbatim} +% +% {\bf Important note}: if the last displayed item (in our case, the year) was not in last position, you also need to edit the following functions defined under the \verb+FUNCTION {name}+ format (not exhaustive list): \verb+article+, \verb+book+, \verb+booklet+, \verb+inbook+, \verb+incollection+, \verb+inproceedings+, \verb+manual+, \verb+masterthesis+, \verb+misc+, \verb+phdthesis+, \verb+proceedings+, \verb+techreport+, and \verb+unpublished+. +% For instance:\begin{verbatim} +%FUNCTION {misc} +%{ output.bibitem +% format.authors output +% author format.key output % added +% output.year.check % added +% title howpublished new.block.checkb +% format.title output +% new.block +% howpublished output +% new.block +% note output +% fin.entry +%\end{verbatim} was replaced with:\begin{verbatim} +%FUNCTION {misc} +%{ output.bibitem +% format.authors output +% author format.key output +% title howpublished new.block.checkb +% format.title output +% new.block +% howpublished output +% new.block +% note output +% output.year.check % !!! MOVED !!! +% fin.entry +%\end{verbatim} +% The Unix \verb+diff+ command may help you to compare the original (\package{newapa.bst}) and modified (\package{newapave.bst}) versions of the bibliography style files. +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Ensuring that the biblio back-references are right-flushed} +% +% With this hack in the bibliography style, all bibliography back-references should appear as right-flushed. However, it sometimes does not work, due to some \LaTeX{} formatting mechanisms I am not competent to identify. Then, sometimes, a list of numbers will see its last item appearing alone on next line, even though there obviously was enough space on the previous line where the other numbers appear. I noticed that some minor reformatting of the concerned bibliographic item could solve this issue. There is no way to automatically do this, nor general rule, only a few tricks I found efficient to solve this issue in 6 items of the DAFx-06 proceedings' general bibliography: +% \begin{itemize} +% \item moving from optional to compulsory a bib item field; %^^A (such as the proceedings volume number for a proceedings paper); +% \item replacing a \verb+---+ by a \verb+--+ (arg! so ugly...); +% \item adding a missing space (\eg{} between the thesis number and the URL); +% \item using hyphenation at your advantage: you may sometimes get a reference for which the layout will not hyphen the end of the title, just before the last line (I suspect this is what messes the whole process behind the \verb+\hfill+ command). +% \end{itemize} +% +% \color{black} +% +%^^A ================================================================= +% \subsection{\LaTeX{} runs}\label{sec:custom:ex:latex} % -% \begin{table}[htb!] -% \centering -% \framebox{ -% \begin{tabular}{ll} -% \multicolumn{2}{l}{\bf Conference Program}\\ -% & \vspace*{-0.1cm}\\ -% \multicolumn{2}{l}{\textbf{\textit{Oral Session 1}}}\\ -% 1 & Templates for One Author\\ -% & {\it Alfred Alabama}\\ -% & \vspace*{-0.3cm}\\ -% 7 & Templates for One Author with Two Affiliations\\ -% & {\it Bob Boogie-Woogie}\\ -% & \vspace*{-0.1cm}\\ -% \multicolumn{2}{l}{\textbf{\textit{Poster Session 1}}}\\ -% 11 & Templates for Two Authors\\ -% & {\it Alfred Alabama, Chris Christmas}\\ -% & \vspace*{-0.1cm}\\ -% \multicolumn{2}{l}{\textbf{\textit{Oral Session 2}}}\\ -% 15 & Templates for Three Authors\\ -% & {\it Bob Boogie-Woogie, Chris Christmas, Don Didon}\\ -% & \vspace*{-0.3cm}\\ -% 21 & Templates f\'or F\`o\"ur \`Authors\\ -% & {\it John J\"oe, K\'e\~{n}t K\^{\i }ng, L\`ou L\'ou, M\`anfr\'ed J. M\^ost\u{e}ki} \\ -% & \vspace*{-0.1cm}\\ -% 27 & {\bf Full Bibliography}\\ -% & \vspace*{-0.1cm}\\ -% 28 & {\bf Index of Authors}\\ -% \end{tabular}} -% \caption{{\it Example of table of contents for a conference organized by sessions.}} -% \label{tab:program:session} -% \end{table} +% We now provide the \LaTeX{} compilation steps to build this example (wich is also done by the \file{buildproc.sh} script provided in section \ref{sec:scripts:buildproc}): +% \begin{enumerate} +% \item generates the first \file{.aux}, and \file{.idx} files (use option \Lopt{papers=empty} to go faster, and \Lopt{bib=backref} for the bibliography):\\ +% \texttt{pdflatex example3optim.tex} +% \item generates the general bibliography and \file{.brf}, \file{.bbl} files:\\ +% \texttt{bibtex example3optim} +% \item generates the author index:\\ +% \texttt{makeindex -s confproc2.ist example3optim.idx} +% \item inserts table of contents and index, update their page numbers and internal links for next run (use option \Lopt{papers=final,bib=backref} to ensure internal links are correct):\\ +% \texttt{pdflatex example3optim.tex} +% \item insert table of contents and index with proper page numbers, and remove links to bibliography for next run (\Lopt{papers=final,bib=final}):\\ +% \texttt{pdflatex example3optim.tex} +% \end{enumerate} % -% \begin{table}[htb!] -% \centering -% \textsf{% -% \begin{tabular}{l@{\,}l} \hline -% $\blacktriangleright$ & Preamble\\ -% & Program\\ -% $\blacktriangleright$ & Oral Session 1\\ -% $\blacktriangleright$ & Poster Session 1\\ -% $\blacktriangleright$ & Oral Session 2\\ -% & Full Bibliography\\ -% & Index of Authors\\ \hline -% \end{tabular}} -% \caption{{\it Closed bookmarks for a conference organized by sessions.}} -% \label{tab:program:session:bkmrk0} -% \end{table} % -% \begin{table}[htb!] -% \centering -% \textsf{% -% \begin{tabular}{l@{\,}l@{\,}l} \hline -% $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Preamble} \\ -% & & Cover\\ -% & & Publishing informations\\ -% & & Welcome from Firstname Lastname\\ -% & \multicolumn{2}{@{\,}l}{Program} \\ -% $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Oral Session 1} \\ -% & $\blacktriangleright$ & Template for One Author\\ -% & $\blacktriangleright$ & Template for One Author with Two Affiliations\\ -% $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Poster Session 1} \\ -% & $\blacktriangleright$ & Template for Two Authors\\ -% $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Oral Session 2} \\ -% & $\blacktriangleright$ & Template for Three Authors\\ -% & $\blacktriangleright$ & Template f\'or F\`o\"ur \`Authors\\ -% & \multicolumn{2}{@{\,}l}{Full Bibliography} \\ -% & \multicolumn{2}{@{\,}l}{Index of Authors} \\ \hline -% \end{tabular}} -% \caption{{\it First-level opened bookmarks for a conference organized by sessions.}} -% \label{tab:program:session:bkmrk1} -% \end{table} +%^^A\changes{0.2g}{2007/09/07}{Doc: starting a more organized `proceedings making'} +%^^A ================================================================= +%^^A More about building conference proceedings +%^^A ================================================================= +% \section{More about building conference proceedings (for warriors)} +% \label{sec:conference:proc:making} % -% \begin{table}[htb!] -% \centering -% \textsf{% -% \begin{tabular}{l@{\,}l@{\,}ll} \hline -% $\blacktriangledown$ & \multicolumn{3}{@{\,}l}{Preamble} \\ -% & & \multicolumn{2}{@{\,}l}{Cover}\\ -% & & \multicolumn{2}{@{\,}l}{Publishing informations}\\ -% & & \multicolumn{2}{@{\,}l}{Welcome from Firstname Lastname}\\ -% & \multicolumn{3}{@{\,}l}{Program} \\ -% $\blacktriangledown$ & \multicolumn{3}{@{\,}l}{Oral Session 1} \\ -% & $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Template for One Author}\\ -% & & & Alfred Alabama\\ -% & $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Template for One Author with Two Affiliations}\\ -% & & & Bob Boogie-Woogie\\ -% $\blacktriangledown$ & \multicolumn{3}{@{\,}l}{Poster Session 1} \\ -% & $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Template for Two Authors}\\ -% & & & Alfred Alabama\\ -% & & & Chris Christmas\\ -% $\blacktriangledown$ & \multicolumn{3}{@{\,}l}{Oral Session 2} \\ -% & $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Template for Three Authors}\\ -% & & & Bob Boogie-Woogie\\ -% & & & Chris Christmas\\ -% & & & Don Didon\\ -% & $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Template f\'or F\`o\"ur \`Authors}\\ -% & & & John J\"oe\\ -% & & & K\'e\~{n}t K\^{\i}ng\\ -% & & & L\`ou L\'ou\\ -% & & & M\`anfred J. M\^ost\u{e}k\i\\ -% & \multicolumn{3}{@{\,}l}{Full Bibliography} \\ -% & \multicolumn{3}{@{\,}l}{Index of Authors} \\ \hline -% \end{tabular}} -% \caption{{\it Second-level opened bookmarks for a conference organized by sessions.}} -% \label{tab:program:session:bkmrk2} -% \end{table} +%^^A\changes{0.2h}{2007/09/12}{Example: adding class switch and generation of corresponding files} +%^^A ================================================================= +% \subsection{Compilation steps: class option switch} +% \label{sec:ex:input:class} +% +% When built, the current example with general bibliography requires various \LaTeX\ runs with different option sets. Since \LaTeX-runs can only be automatized with Unix scripts when options are not changed, it is proposed to automatize the option sets switch too. Two files are created, that the script renames when needed, so that the main example file inserts the proper file. +% +% The \file{example4optim.tex} example file is generated from \file{example3optim.tex}, after removing the first lines that declare the document class and its options. +% +% +% \changes{0.4f}{2007/10/7}{bug: \Lopt{draft} removes bookmarks} +%^^A------------------------------------------------------------------------ +% \subsubsection{Options set for non-final \LaTeX\ runs: \file{exclasspre.tex}} +% +% This first file (\file{exclasspre.tex}) is used for all \LaTeX\ runs except the final one. In this example, it adds headers on all pages (\Lopt{headers=allpages}), and move the footer (\Lopt{movepagenumber}) so that we can check page numbers. Also, the option \Lopt{compil=bibbackref} creates proper back-references. +% \begin{macrocode} +%<*exclasspre> +\documentclass[letterpaper,10pt,twoside,twosidepapers,% + electronic,% [printed] | electronic + papers=countpages,% empty | draft | [final] | countpages + headers=allpages,% none | pdfonly | exceptpdf | [allpages] + paperselec=all, %[all] | p_001 | p_fake + bib=backref,% + colorheaders=red,% + verbose,% + pdftk,% + pdftkfolder={pdftk_info/},% + pdftksubject={DAFx-06 Conference},% + movepagenumber,% + hyperref={bookmarksdepth=1,bookmarksopen,bookmarksopenlevel=0,% + citecolor=colorforcite,linkcolor=colorforlink,urlcolor=colorforurl},% + geometry={text={175truemm,226truemm},% A4 & letter + inner=0.805in,top=29.15mm,bottom=24.5mm,footskip=9.68mm,voffset=-5mm},%letter +]{confproc} +% +% \end{macrocode} +% As previously said, the \Lopt{draft} option of \package{pdfpages} does not generate the bookmark data. So, we do not use it for any of those final \LaTeX{} runs. You can of course use it any time during the layout fine tuning, conference program definition, etc. +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Options set for final \LaTeX\ run on the paperback version: \file{exclasslastpb.tex}} +% +% This second file is used for the final \LaTeX\ run: it removes options such as \Lopt{movepagenumber}, and uses headers only on the pages where it is necessary (using \Lopt{headers=exceptpdf}, as you may have finished the page numberings before). It also uses the \Lopt{compil=last} option, in order to insert the last page of each paper with proper back-references generated during the previous \LaTeX\ runs: +% \begin{macrocode} +%<*exclasslastpb> +\documentclass[letterpaper,10pt,twoside,twosidepapers,% + printed,% [printed] | electronic + papers=final,% empty | draft | [final] | countpages + headers=exceptpdf,% none | pdfonly | exceptpdf | [allpages] + paperselec=all, %[all] | p_001 | p_fake + bib=last,% + pdftk,% + pdftkfolder={pdftk_info/},% + pdftksubject={DAFx-06 Conference},% + binding=5mm,% [0mm] -> adjust the binding depending on the proceedings thickness + hyperref={bookmarksdepth=1,bookmarksopen,bookmarksopenlevel=0,% + citecolor=colorforcite,linkcolor=colorforlink,urlcolor=colorforurl},% + geometry={text={175truemm,226truemm},% A4 & letter + inner=0.805in,top=29.15mm,bottom=24.5mm,footskip=9.68mm,voffset=-5mm},%letter +]{confproc} +% +% \end{macrocode} +% +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Options set for final \LaTeX\ run on the electronic version: \file{exclasslastel.tex}} +% +% This third file differs from the second by its \Lopt{electronic} option, and the geometry settings (the document has no inner margin): +% \begin{macrocode} +%<*exclasslastel> +\documentclass[letterpaper,10pt,twoside,twosidepapers,% + electronic,% [printed] | electronic + papers=final,% empty | draft | [final] | countpages + headers=exceptpdf,% none | pdfonly | exceptpdf | [allpages] + paperselec=all, %[all] | p_001 | p_fake + bib=last,% + pdftk,% + pdftkfolder={pdftk_info/},% + pdftksubject={DAFx-06 Conference},% + binding=0mm,% [0mm] -> no binding for electronic version + hyperref={bookmarksdepth=1,bookmarksopen,bookmarksopenlevel=0,% + citecolor=colorforcite,linkcolor=colorforlink,urlcolor=colorforurl},% + geometry={text={175truemm,226truemm},% A4 & letter + inner=0.0in,top=29.15mm,bottom=24.5mm,footskip=9.68mm,voffset=-5mm},%letter +]{confproc} +% +% \end{macrocode} +% +% +% \color{black} +% +% +% +%^^A ================================================================= +% \subsection{Option management: examples of option combinations} +% +%^^A\changes{0.2b}{2007/08/16}{Options: description added for \package{\filename} options} +%^^A------------------------------------------------------------------------ +% \subsubsection{Fasten compilation steps} +% +% As the \LaTeX\ run may be long when only making a small change, we may want to speed up the process by using the \LoptDescribe{papers=draft} or even better with \LoptDescribe{papers=empty} (see sec.~\ref{sec:proc:specific:formatting}). This is useful for instance when making layout changes, editing the welcome letters, or working on generating proper page numbering. This will replace each PDF page by an almost blank page. +% The difference between the two is that \Lopt{papers =draft} uses the draft mode of \package{pdfpages}, whereas the \Lopt{papers =empty} options uses an internal command, and displays more information about each \file{.pdf} file: paper title, author list, file name, tags of bibliography items, and page number. Note that both preserve the bookmark, and \Lopt{empty} is much faster than \Lopt{draft}, which is already way faster than \Lopt{last}. +% +% The other possible compilation option is \DescribeMacro{final} \Lopt{final}. Note that it is configured by default depending on the \Lopt{compil} option you used, but can be modified anyway. +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Verbose/debug} +% +% Also, the \DescribeMacro{verbose}\Lopt{verbose} or \DescribeMacro{debug}\Lopt{debug} option adds some debug comments in the \LaTeX{} console, both from \package{\filename} and \package{hyperref} packages, that might help to track problems if any. It can be used at any compilation step, of course! +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Clear single/double page} +% +% Depending on wether your document is \Lopt{oneside} or \Lopt{twoside}, you may want to force it to always: +% \begin{itemize} +% \item clear double page after each paper in 1-side mode using \DescribeMacro{cleardoublepage} \Lopt{cleardoublepage} (used with \Lopt{oneside}); +% \item not clear double page after each paper in 2-side mode using \DescribeMacro{clearsinglepage} \Lopt{clearsinglepage} (used with \Lopt{twoside}). +% \end{itemize} +% +% +%^^A\changes{0.2g}{2007/09/07}{Doc: e-organizing steps' section} +%^^A ================================================================= +%^^A Compilations +%^^A ================================================================= +% \subsection{Steps to generate the final version of the proceedings}\label{sec:confproc:compil} +% +%\changes{0.6}{\datevzdsix}{Doc: added diagram with suggested building steps} +% \begin{figure}[htbp] +% \includegraphics[width=1.1\textwidth]{confproc_diag.pdf} +% \caption{Suggested stages to build proceedings} +% \label{fig:confproc_diag} +% \end{figure} +% +% Now that all options and commands to build proceedings are know, we need more insight +% about what to do with which option/command and when. This is the purpose of this section, +% that proposed some building stages (as depicted in the diagram in Fig.~\ref{fig:confproc_diag}) +% to produce both the electronic and paperback final versions of the provided example +% proceedings with the following constraints: +% \begin{itemize} +% \item the template for papers has a header and footer, so the proceedings must have the same header/footer; +% \item a general bibliography is used; +% \item the final PDF papers must be named after their first page number. +% \end{itemize} +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Generate the program and the paper switch} +% +% Once the general proceedings structure is there (see the \file{example3optim.tex} file), +% the first step is to generate the conference program and its corresponding paper switch: +% \begin{itemize} +% \item by hand (read sec.~\ref{sec:ex:paper:switch} for an example); +% \item using the \file{generateswitch.pl} Perl script described in sec.~\ref{sec:scripts:perl} to generate both the \file{exsessions.tex} and \file{expapersswitch.tex} files from your \file{exprogram.csv} program file. +% \end{itemize} +% +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Make sure each PDF is fully inserted}\label{sec:compare:page:numbers} +% At some point, we want to make sure all pages of each paper are inserted. The simplest way +% is to always use the \Lopt{papers=countpages}, but this is unfortunately very time consuming +% when working on setting various layout aspects, the program, and also when adding contents +% to the preamble. Therefore, if using \Lopt{papers=empty} for instance, we want to make sure +% no paper has been truncated by error. Checking this by hand is a long and fastidious task, so +% two solutions are offered: the \file{countnbpages.sh} script (see sec.~\ref{sec:scripts:countnbpages}) +% and the \file{*.np*} files generated when running \LaTeX\ with either \Lopt{papers=countpages} +% or \Lopt{papers=empty}. +% +% \paragraph{For Unix users:} +% \begin{enumerate} +% \item launch once the \file{countnbpages.sh} script (see sec.~\ref{sec:scripts:countnbpages}) to generate \file{example.npc}, which contains each paper's real number of pages; +% \item run pdflatex onto \file{example.tex} with \LoptDescribe{papers=empty} (faster mode to emulate paper insertion with your settings such as the number of pages); it generates a \file{example.nps} file with the user-defined number of pages; +% \item compare the content of both files, using +%\begin{verbatim} +%diff example.nps example.npc +%\end{verbatim} +% \item each paper appearing in the \file{diff} command output has a page number discrepancy, that has to be corrected. +% \end{enumerate} +% Once all discrepancies have been corrected, re-do this procedure once for a last check, just in case! +% \paragraph{For non-Unix users (sorry, it's much slower!):} +% \begin{enumerate} +% \item run pdflatex onto \file{example3optim.tex} with \DescribeMacro{papers=countpages}\Lopt{papers=countpages} (real full paper insertion); it generates \file{example.npc} (real number of pages); +% \item run pdflatex onto \file{example3optim.tex} with \DescribeMacro{papers=empty}\Lopt{papers=empty} (faster mode to emulate paper insertion with your selected number of pages); it generates \file{example.nps} (supposed number of pages); +% \item compare both files (with your favorite text editor's `compare file' function). +% \end{enumerate} +% If some page numbers indicated in \file{expapersswitch.tex} are not identical to the real page number, we just edit the file to correct the error, and can now g on with building the proceedings. +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Changing papers' first page number} +% +% When the paper template includes the page number in the footer, we need to correct each individual paper's first page number as it appears in the proceedings' table of contents\footnote{When clicking on a paper, the PDF file of this paper will open with the same first page number. Also, if the conference papers are available on the web, knowing the proper page numbers will help readers to properly cite them.}. To do so: +% \begin{enumerate} +% \item make at least two runs with the following options:\begin{verbatim} +%\documentclass[a4paper,10pt,twoside,twosidepapers,% +% compil=last,headers=allpages,movepagenumber,electronic]{confproc} +%\end{verbatim} +% to include all papers and build a table of contents with proper page numbers. +% \item prepare each paper for insertion. There are two ways to do this: +% \begin{enumerate} +% \item lazy way: use the \verb+\setcounter{page}{XXX}+ command in each paper, with \verb+XXX+ replaced by the real number; +% \item alternative way (simplifies program changes): centralize page numbers in the \file{expages.tex} file, organized by the paper ID. Then, the two steps are: +% \begin{itemize} +% \item add the following in the preamble of each paper:\begin{verbatim} +%\input{../../expages.tex}\setpagenumber{04} +%\end{verbatim} +% Here, the ID paper is \verb+04+, and has to be updated for each paper. +% \item update the \file{expages.tex} file for each paper: set its first page number as it appears in the table of contents. +% \end{itemize} +% By doing so, we can update the program to re-build the table of contents as many times as wanted, without having to re-edit each paper. +% \end{enumerate} +% \item once the program and the corresponding paper order are ok, (re)generate each paper independently with proper first page number (using the \file{buildpapers.sh} script in sec.~\ref{sec:scripts:buildpapers}); +% \item check that no error was made when numbering the first page. Run \LaTeX\ with at least the \Lopt{headers=allpages,movepagenumber} options. In case of error, re-do step 2--3 till the page numbers are ok. +% \end{enumerate} +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Renaming papers} +% +% Renaming all papers according to their first page number (\eg{} \file{p\_NNN.pdf} if only PDF files are renamed) is very helpful to ensure the proceedings' CD version is ISO compliant, and has file names with less than 8 characters (+ extensions). This can only be done once the program is definitive. Then file names can be changed accordingly in the \file{.csv} file; the \file{expapersswitch.tex} file has to be re-generated, and the proceedings rebuilt. It is easily done using the Unix scripts. +% +% +% +%^^A ================================================================= +% \subsection{Quality and production} +% +% We present here some other ideas dealing with the production and the quality of the proceedings. Indeed, to provide the best possible quality proceedings, individual papers may be edited (see sec.~\ref{sec:misc:editing}), which can be simplified by sending notes to authors before they submit the final version (see sec.~\ref{sec:misc:notes}). Using only \LaTeX{} to typeset may require to convert some Word files to \LaTeX, in the case where the proceedings templates are provided in the 2 formats to authors (see sec.~\ref{sec:misc:word2latex}). The last comments are about the graphical quality (sec.~\ref{sec:misc:graph:quality}) and the necessary font embedding in the PDF images (see sec.~\ref{sec:misc:images:fonts}). +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Editing the papers}\label{sec:misc:editing} +% +% To provide the best possible quality proceedings for DAFx-06, each individual paper was edited by checking the following items (non-exhaustive list): +% \begin{itemize} +% \item proper page format used (US letter instead of A4 format), as the authors were from various continents around the worlds; +% \item break the title line at the right place using \verb+\break+; +% \item affiliation type is properly indicated; +% \item affiliation is properly layed out; +% \item author's email exists and works; +% \item captions are italic, with a ``.'' at the end; +% \item all figures are referenced in the text; +% \item bibliographic items have a volume and number, as well as page number or preprint number (AES convention); +% \item bibliographic items use generally defined strings, and are identical each time they are cited; +% \item math units: Physics convention is roman, not italic (\ie{} not LaTeX's math style). Ex: $5$ Hz, and not $5Hz$. +% \end{itemize} +% +% \noindent So as to ensure papers look uniform as possible, we changed for each: +% \begin{itemize} +% \item the URL font to sans-serif, as its default font is too wide. We added the following command in the preamble of each paper:\\ +% \verb+\usepackage{url}\urlstyle{sf}+ +% \item all \verb+\href{}{}+ commands related to URL (\ie{} all except emails) where converted to URL, as it is more apropriated (it does the hyphenations for you and most of the time it does it better). +% \end{itemize} +% +% \noindent Some not-so-minor comments: +% \begin{itemize} +% \item to do a valid line break in the paper title (at least with the \file{dafx06.sty} style, but not only) use \verb+\break+, instead of \verb+\newline+, \verb+\\+, or \verb+\linebreak+ (that creates unbalanced titles). That way, it works similarly for both the title and the pdftitle in the metadata. +% \item using the \package{balance.sty} package allows to well balance the last page, which is especially useful for the bibliography. +% \end{itemize} +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Sending editing notes to authors to improve the layout quality}\label{sec:misc:notes} +% +% In order to improve aspects of the quality of the proceedings, we listed many common errors and gave a feedback to authors of all accepted papers, that they were kindly asked to take care of. This is how we proceeded: +% \begin{enumerate} +% \item examine all papers and list the common errors and electronic paper info (PDF version, PDF generator, valid hyperref, etc.) (10h); +% \item in an \file{.csv} file, indicate all problems, paper's title, index and author's email (0.5h); +% \item column by column, fill in the data (30h) with errors detected in each paper; +% \item use a combination of Perl script and an AppleScript to convert info in this file into usual sentences and indications of what to do in order to improve the paper quality (4h), and then into a series of emails, ready to be sent to authors (4h). +% \end{enumerate} +% N.B.: Those scripts are not provided in the package, but can be obtained on demand. +% +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Manual Word to \LaTeX\ conversion}\label{sec:misc:word2latex} +% +% To automatize all the processes in proceedings making, we may want to convert all non-\LaTeX\ generated documents into \LaTeX{} documents. If that cannot be asked to the conference authors, we need to do it ourselves. Here is an example of the steps to follow: +% \begin{enumerate} +% \item copy and paste the whole text; +% \item update the header (author, title, affiliation); +% \item add sections, subsections, etc. according to the original text;\\ +% update labels and references for sections, subsections, etc.; +% \item insert figures and tables with the proceedings template style;\\ +% update labels and references for figures and tables; +% \item update captions with the proceedings template style; +% \item edit equations (inside the text and as separated formulae);\\ +% update labels and references for equations ; +% \item replace all Word quotes ^^A(double “”‟ and single ‛’ quotes) +% by \LaTeX\ quotes (double ``'', and single `' quotes) to avoid they disappear (Unicode-related issue); +% \item correct any specific formatting such as italic, capitals, bold, etc; +% \item remove useless hyphenations ``-'' produced as line breaks by Word; +% \item replace remaining hyphens by the proper corresponding one: dash `-' (hyphen), semi-quadratin `--' (ex: number range) and quadratin `---'. +% \end{enumerate} +% +%^^A------------------------------------------------------------------------ +% \subsubsection{How to ensure the graphical quality?}\label{sec:misc:graph:quality} +% +% The best way to ensure excellent quality for you graphics in the electronic version of you proceedings consists in using vectorial images, \ie{} postscript (\file{.ps} or \file{.eps}) or \file{.pdf} files. It should be the same for the printed version, except that the font problem with Matlab described in sec.~\ref{sec:misc:images:fonts} may imply to convert vectorial images to bitmap images (such as \file{.png} or \file{.gif}). +% +% +% +%^^A------------------------------------------------------------------------ +% \subsubsection{How to ensure your fonts are embedded in the PDF?}\label{sec:misc:images:fonts} +% +% Various important things have to be checked to ensure a great PDF file quality. (Please read \href{http://www.prepressure.com/pdf/basics/preflight}{www.prepressure.com/pdf/basics/preflight} for more information). +% One of these important things is the font embedding. +% If not checked, you may end up with a document where fonts will disappear and be replaced by random characters (which are not random in fact)\footnote{Indeed, when printing on a system that is not yours (\eg{} in a professional print center), the printer may be set such as not to replace a missing font by a similar one. This is why, Matlab text can be totally scrapped, replaced by other numbers, letters, and so on!}. +% Unfortunately for non-experts user of Matlab, the system fonts such as Arial or Helvetica are not embedded by default in the \file{.pdf} nor in the \file{.eps} file. This can be checked by converting any of the two into another format using Ghostscript. For instance, converting a \file{.pdf} to \file{.ps} using \file{pdf2ps} will show the following log info:\begin{verbatim} +% **** Warning: Fonts with Subtype = /TrueType should be embedded. +% The following fonts were not embedded: +% Arial-ItalicMT +% ArialMT +% +% **** This file had errors that were repaired or ignored. +% **** The file was produced by: +% **** >>>> pdfTeX-0.14h <<<< +% **** Please notify the author of the software that produced this +% **** file that it does not conform to Adobe's published PDF +% **** specification. +%\end{verbatim} +% This can also be checked by processing a PDF files produced by Matlab using Acrobat Distiller (\$), and you will get the same errors... % -% \clearpage +% A way to correct this in Matlab is use the \file{print\_pdf.m}\footnote{get it at: \href{http://www.mathworks.com/matlabcentral/fileexchange/22018-printpdf}{\sf www.mathworks.com/matlabcentral/fileexchange/22018-printpdf})} file by \person{Oliver Woodford} to save the figure as PDF with embedded fonts. % -%^^A ================================================================= -% \paragraph{Program organized by days} +% If you cannot have it fixed by the author, then you need to use Acrobat Professional to do the job for you. +% Utilities like \file{pdfinfo} and \file{pdffonts} are helpful to detect such problems as well as missing bounding boxes, with commands like:\\ +% \texttt{pdffonts [filename.pdf]}\\ +% \texttt{pdfinfo -box [filename.pdf]} % -% In the case of bigger conferences with a program organized by day, you will get the table of contents corresponding to Tab~\ref{tab:program:day}. The corresponding bookmark is depicted closed in Tab.~\ref{tab:program:day:bkmrk0}, opened at its first level in Tab.~\ref{tab:program:day:bkmrk1}, and opened at its second level Tab.~\ref{tab:program:day:bkmrk2}. % -% \begin{table}[htb!] -% \centering -% \framebox{ -% \begin{tabular}{ll} -% \multicolumn{2}{l}{\bf Conference Program}\\ -% & \vspace*{-0.1cm}\\ -% \multicolumn{2}{l}{\bf Day 1}\\ -% & \vspace*{-0.1cm}\\ -% \multicolumn{2}{l}{\textbf{\textit{Oral Session 1}}}\\ -% 1 & Templates for One Author\\ -% & {\it Alfred Alabama}\\ -% & \vspace*{-0.3cm}\\ -% 7 & Templates for One Author with Two Affiliations\\ -% & {\it Bob Boogie-Woogie}\\ -% & \vspace*{-0.1cm}\\ -% \multicolumn{2}{l}{\textbf{\textit{Poster Session 1}}}\\ -% 11 & Templates for Two Authors\\ -% & {\it Alfred Alabama, Chris Christmas}\\ -% & \vspace*{-0.1cm}\\ -% \multicolumn{2}{l}{\bf Day 2}\\ -% & \vspace*{-0.1cm}\\ -% \multicolumn{2}{l}{\textbf{\textit{Oral Session 2}}}\\ -% 15 & Templates for Three Authors\\ -% & {\it Bob Boogie-Woogie, Chris Christmas, Don Didon}\\ -% & \vspace*{-0.3cm}\\ -% 21 & Templates f\'or F\`o\"ur \`Authors\\ -% & {\it John J\"oe, K\'e\~{n}t K\^{\i }ng, L\`ou L\'ou, M\`anfr\'ed J. M\^ost\u{e}ki} \\ -% & \vspace*{-0.1cm}\\ -% 27 & {\bf Full Bibliography}\\ -% & \vspace*{-0.1cm}\\ -% 28 & {\bf Index of Authors}\\ -% \end{tabular}} -% \caption{{\it Example of table of contents for a conference organized by day.}} -% \label{tab:program:day} -% \end{table} % -% \begin{table}[htb!] -% \centering -% \textsf{% -% \begin{tabular}{@{\,}l@{\,}l} \hline -% $\blacktriangleright$ & Preamble\\ -% & Program\\ -% $\blacktriangleright$ & Day 1\\ -% $\blacktriangleright$ & Day 2\\ -% & Full Bibliography\\ -% & Index of Authors\\ \hline -% \end{tabular}} -% \caption{{\it Closed bookmarks for a conference organized by days.}} -% \label{tab:program:day:bkmrk0} -% \end{table} +%^^A\changes{0.1c}{2007/07/30}{Customization: \file{confproc.cfg}} % +% \color{black} % -% \begin{table}[htb!] -% \centering -% \textsf{% -% \begin{tabular}{@{\,}l@{\,}l@{\,}l} \hline -% $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Preamble}\\ -% & & Cover\\ -% & & Publishing informations\\ -% & & Welcome from Firstname Lastname\\ -% & \multicolumn{2}{@{\,}l}{Program}\\ -% $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Day 1}\\ -% & $\blacktriangleright$ & Oral Session 1\\ -% & $\blacktriangleright$ & Poster Session 1\\ -% $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Day 2}\\ -% & $\blacktriangleright$ & Oral Session 2\\ -% & \multicolumn{2}{@{\,}l}{Full Bibliography}\\ -% & \multicolumn{2}{@{\,}l}{Index of Authors}\\ \hline -% \end{tabular}} -% \caption{{\it First-level opened bookmarks for a conference organized by days.}} -% \label{tab:program:day:bkmrk1} -% \end{table} % -% \begin{table}[htb!] -% \centering -% \textsf{% -% \begin{tabular}{@{\,}l@{\,}l@{\,}l@{\,}l} \hline -% $\blacktriangledown$ & \multicolumn{3}{@{\,}l}{Preamble}\\ -% & & \multicolumn{2}{@{\,}l}{Cover}\\ -% & & \multicolumn{2}{@{\,}l}{Publishing informations}\\ -% & & \multicolumn{2}{@{\,}l}{Welcome from Firstname Lastname}\\ -% & \multicolumn{3}{@{\,}l}{Program}\\ -% $\blacktriangledown$ & \multicolumn{3}{@{\,}l}{Day 1}\\ -% & $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Oral Session 1}\\ -% & & $\blacktriangleright$ & Template for One Author\\ -% & & $\blacktriangleright$ & Template for One Author with Two Affiliations\\ -% & $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Poster Session 1}\\ -% & & $\blacktriangleright$ & Template for Two Authors\\ -% $\blacktriangledown$ & \multicolumn{3}{@{\,}l}{Day 2}\\ -% & $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Oral Session 2}\\ -% & & $\blacktriangleright$ & Template for Three Authors\\ -% & & $\blacktriangleright$ & Template f\'or F\`o\"ur \`Authors\\ -% & \multicolumn{3}{@{\,}l}{Full Bibliography}\\ -% & \multicolumn{3}{@{\,}l}{Index of Authors}\\ \hline -% \end{tabular}} -% \caption{{\it Second-level opened bookmarks for a conference organized by days.}} -% \label{tab:program:day:bkmrk2} -% \end{table} +%\changes{0.6}{\datevzdsix}{Doc: moved scripts after the full example and before implementation} +%^^A\changes{0.2f}{2007/09/05}{Scripts: Unix `buildcls' script added} +%^^A\changes{0.2g}{2007/09/07}{Scripts: Unix `buildcls' script shorten} +%^^A\changes{0.2g}{2007/09/07}{Scripts: Unix `buildcls' script with chmod on the Perl script, + example of use of the script} +%^^A\changes{0.2h}{2007/09/12}{Scripts: Unix `buildcls' script moves example files in `example/'} +%^^A\changes{0.2i}{2007/09/24}{Scripts: Unix `buildcls' script moves the index style `confproc.ist' in `example/'} % -% \clearpage % +%^^A ================================================================= +% \section{Various scripts and utilities to save time} \label{sec:scripts} % %^^A ================================================================= -% \subsubsection{CSV Program of the conference} -% \label{sec:scripts:program} +% \subsection{\file{buildcls.sh}: Build the class documentation and files} +% +% \begin{description} +% \item[Name] \file{buildcls.sh} +% \item[Type] Unix/bash script +% \item [Purpose] generates the class files and documentation, and prepares the example-related files. +% \item [Note] first set the path to \LaTeXe\ binaries before using it! +% \end{description} +% \begin{macrocode} +%<*buildcls> +#!/bin/sh + +wd=`pwd` + +% \end{macrocode} +% First, you may set the path to \LaTeXe\ binaries: +% \begin{macrocode} +#-- set path to LaTeX binaries +LaPath="/usr/texbin/" # TeXLive + +% \end{macrocode} +% and then, only if necessary, change the names to the \LaTeX{} compilers: +% \begin{macrocode} +#-- set names of LaTeX and related compilers +Latex=$LaPath"pdflatex" +Index=$LaPath"makeindex" +% \end{macrocode} +% as well as the document and example target names: +% \begin{macrocode} +Target="confproc" #- set document's name +extarget="example/" #- set the example folder name + +% \end{macrocode} +% We can start building the documentation and the \file{.ins} file: +% \begin{macrocode} +#-- build doc, class and example files +$Latex $Target.dtx #- build doc. and .ins file +$Latex $Target.ins #- build class and example files + +% \end{macrocode} +% We then rename the bibliography style (HACK: the file is generated under the \file{newapave2.sty}, because if there already exist a \file{newapave.sty} on your system, it will not be generated again under that name; we now have to properly rename it): +% \begin{macrocode} +#-- HACK: rename newapave2.sty +mv newapave2.sty newapave.sty + +% \end{macrocode} +% Once it is done, we can finish the documentation. this full sequence is only necessary if you generate the implementation, index and changes history: +% \begin{macrocode} +cd $wd/ +#-- finish to build the documentation +$Latex $Target.dtx #- re-run doc for toc update +$Latex $Target.dtx #- re-run doc for proper back-references +$Index -s gind.ist $Target #- with \CodelineIndex of \PageIndex +$Index -s gglo.ist -o $Target.gls $Target.glo #- with \RecordChanges +$Latex $Target.dtx #- insert index & list of changes, re-number +$Latex $Target.dtx #- last run with proper page numbers + +% \end{macrocode} +% Since there are 2 scripts, one to install (this one) and one to clean up all the mess (mainly used by me during building tests), we also prepare the latter: +% \begin{macrocode} +#-- prepare scripts for cleaning package +cd $wd +chmod +x cleancls.sh + +% \end{macrocode} +% We then create the example folder and move all related files thanks to the \file{prepareexample.sh} script (sec. \ref{sec:script:prepareexample}): +% \begin{macrocode} +#-- prepare scripts for building example +chmod +x prepareexample.sh +./prepareexample.sh + +% \end{macrocode} +% By uncommenting the last line, you will also build the example! +% \begin{macrocode} +#-- build example +cd $extarget +#./buildproc.sh +% +% \end{macrocode} +% This script is generated by the first \LaTeX\ run on \package{confproc.dtx}. You then have to change its permission in the \verb+bash+ shell to make it executable:\begin{verbatim} +%chmod +x buildcls +%\end{verbatim} +% Then, you can run it from the \verb+bash+ shell:\begin{verbatim} +%./buildcls +%\end{verbatim} +% % -% It may be easier for you to collect data about the papers from a server, manipulate them in a spreadsheet software (for example M\$ Excel), and then generate the program from a \file{.csv} file. We used a Perl script (see sec. \ref{sec:scripts:perl}) to generate the corresponding \file{.tex} files for the example. First, take a look at the following CSV file, that contains the conference program for the example\footnote{This is normal that this text goes on after the margin. Please check the generated file if you wish to read each line.}: % +% +%^^A\changes{0.2f}{2007/09/05}{Scripts: Unix `cleancls' script added} +%^^A\changes{0.2g}{2007/09/07}{Scripts: Unix `cleancls' script shorten} %^^A ================================================================= -%^^A Here is the creation of the procwitchandtoc.pl file, part of the example. -%^^A It is written on first LaTeX run if it does not already exist +% \subsection{\file{cleancls.sh}: Clean up the class folder} +% +% \begin{description} +% \item[Name] \file{cleancls.sh} +% \item[Type] Unix/bash script +% \item [Purpose] cleans up the folder where the class was generated. +% \end{description} +% \begin{macrocode} +%<*cleancls> +#!/bin/sh + +% \end{macrocode} +% Create a back up folder: +% \begin{macrocode} +mkdir backup #--- move the files to be kept +% \end{macrocode} +% Move original class documentation materials: +% \begin{macrocode} +mv confproc.dtx backup/ +mv confproc_diag.pdf backup/ +mv confproc-short.tex backup/ +mv confproc-short.pdf backup/ +% \end{macrocode} +% Move building and cleaning scripts: +% \begin{macrocode} +mv buildcls.sh backup/ +cp cleancls.sh backup/ +% \end{macrocode} +% Cleanup and place back the original minimal file set: +% \begin{macrocode} +rm *.* #--- clean up! +mv backup/* . #--- move the backed up files +rm -r backup #--- remove the temporary backup folder +% +% \end{macrocode} +% You may want to use it to re-generate the whole package from the \file{.dtx} file. +% Note that this script too is generated by the first \LaTeX\ run on the \package{confproc.dtx} file. +% +% +% %^^A ================================================================= +% \subsection{\file{prepareexample.sh}: Prepare the example files, scripts and folders}\label{sec:script:prepareexample} +% +% \begin{description} +% \item[Name] \file{prepareexample.sh} +% \item[Type] Unix/bash script +% \item [Purpose] prepares the example-related files, scripts and folders +% \item [Note] first set the path to \LaTeXe\ binaries before using it! +% \end{description} % \begin{macrocode} -%<*exprogram> -Type,Paper Number,PC Decision,Pages,Title,File Name,Generated,Citations,Auth1 First Name,Auth1 Last Name,Auth2 First Name,Auth2 Last Name,Auth3 First Name,Auth3 Last Name,Auth4 First Name,Auth4 Last Name,, -Type,-2,O,,,,,,First Name,Last Name,First Name,Last Name,First Name,Last Name, F.Name, L.Name,, -Day,0,,,Day 1: September 18 2007,,,,,,,,,,,,, -Session,0,,,Oral Session 1,,,,,,,,,,,,, -paper,45,O,6,Templates for One Author,p_001,LaTeX,"Serra:1996:sms,Moorer:2000:AES:audio:millenium,Arfib:1998:DAFx,Mitra:Kaiser:1993:DSP:handbook",Alfred,Alabama,,,,,,,, -paper,21,O,5,Templates for One Author with Two Affiliations,p_003,LaTeX,"Serra:1996:sms,Moorer:2000:AES:audio:millenium,Arfib:1998:DAFx,Haykin:1991:adaptive:filter",Bob,Boogie-Woogie,,,,,,,, -Poster Session,0,,,Poster Session 1,,,,,,,,,,,,, -paper,32,P,4,Templates for Two Authors,p_005,LaTeX,"Serra:1996:sms,Moorer:2000:AES:audio:millenium,Arfib:1998:DAFx,Askenfelt:1976:automatic:transcription",Alfred,Alabama,Chris,Christmas,,,,,, -Day,0,,,Day 2: September 19 2007,,,,,,,,,,,,, -Session,0,,,Oral Session 2,,,,,,,,,,,,, -paper,75,O,6,Templates for Three Authors,p_007,LaTeX,"Serra:1996:sms,Moorer:2000:AES:audio:millenium,Arfib:1998:DAFx,Egozy:1995:MIT:features:gesture",Bob,Boogie-Woogie,Chris,Christmas,Don,Didon,,,, -paper,27,O,7,Templates fór Fòür Àuthors,p_009,LaTeX,"Serra:1996:sms,Moorer:2000:AES:audio:millenium,Dutilleux:1991,Fitz:Haken:2003:Web:morphing:loris",John,Jöe,Kéñt,Kîng,Lòu,Lóu,Mànfréd J.,Môst\u{e}k\i,, -% +% \changes{0.7}{2010/08/05}{added \file{prepareexample.sh}} +%<*prepareexample> +#!/bin/sh + +wd=`pwd` + +% \end{macrocode} +% Set the example folder name: +% \begin{macrocode} +extarget="example" #- set the example folder name + +% \end{macrocode} +% Then create the example folder: +% \begin{macrocode} +#-- prepare scripts for building example +mkdir $extarget #- create the folder + +#-- generate the program session files +perl generateswitch.pl % \end{macrocode} +% \noindent N.B.: This script is generated by the first \LaTeX\ run on \package{confproc.dtx}. You then have to change its permission in the \verb+bash+ shell to make it executable:\begin{verbatim} +% chmod +x prepareexample.sh # change its permissions +%\end{verbatim} +% Then, you can run it from the \verb+bash+ shell:\begin{verbatim} +%./prepareexample.sh +%\end{verbatim} +% % -% As we expect when reading the first line, it contains the following columns: -% \begin{enumerate} -% \item {\bf Type:} the script will accept the following values: -% \begin{itemize} -% \item use \verb+Type+ for the items to ignore; -% \item Day: use \verb+Day+; -% \item Session: use \verb+Session+ or \verb+Paper Session+ or \verb+Oral Session+ for oral sessions, \verb+poster session+ for Poster Sessions, and \verb+Demo Session+ for demo sessions; -% \item Paper: use \verb+paper+ or \verb+oral+ for oral presentation; \verb+poster+ for poster presentation; \verb+demo+ for demo. The 3 output identical code anyway: it only helps to organize the program!. -% \end{itemize} -% Note that theses values are not case sensitively processed by the Perl script. -% \item {\bf Number:} paper number or reference, often generated by the submission system. It will be used for paper insertion, for ordering the program, etc. -% \item {\bf PC Decision:} \verb+oral+ or \verb+poster+. it does not change the \LaTeX\ generated code, so you may not use it; -% \item {\bf Pages:} number of pages; -% \item {\bf Title:} title; -% \item {\bf File Name:} name of the corresponding \file{.pdf} file; -% \item {\bf Generated:} \verb+LaTeX+ for \LaTeX\ generated files, and \verb+Word+ for Word generated file. This allows to use different $X$ and $Y$ offset values (we however used the same value for all papers of one kind); -% \item {\bf Citations:} list of bibliography items for the general bibliography (ex: \verb+\cite{bibitem1,bibitem2,bibitem3}+); blank if no general bibliography; -% \item {\bf Auth1 First Name:} first name of author 1; -% \item {\bf Auth1 Last Name:} last name of author 1; -% \item {\bf Auth2 First Name:} first name of author 2, blank if none; -% \item {\bf Auth2 Last Name:} last name of author 2, blank if none; -% \item {\bf Auth3 First Name:} first name of author 3, blank if none; -% \item {\bf Auth3 Last Name:} last name of author 3, blank if none; -% \item {\bf Auth4 First Name:} first name of author 4, blank if none; -% \item {\bf Auth4 Last Name:} last name of author 4, blank if none; -% \item {\bf comments:} there is an extra column, that is not used by the script. -% \end{enumerate} % %^^A ================================================================= -% \subsubsection{Perl script to generate the paper switch and program} +% \subsection{\file{generateswitch.pl}: Generate the paper switch and program [Perl]} % \label{sec:scripts:perl} % -%^^A\changes{0.2c}{2007/08/17}{Scripts: Perl script 'procswitchandtoc.pl' to generate 'paperswitch.tex' and 'sessions.tex' added} -%^^A\changes{0.2d}{2007/08/18}{Scripts: Perl script to generate 'procswitchandtoc.pl' added} -%^^A\changes{0.2d}{2007/08/18}{Scripts: Perl script 'procswitchandtoc.pl' modified to insert bookmarks, and text shorten} +%^^A\changes{0.2c}{2007/08/17}{Scripts: Perl script 'generateswitch.pl' to generate 'paperswitch.tex' and 'sessions.tex' added} +%^^A\changes{0.2d}{2007/08/18}{Scripts: Perl script to generate 'generateswitch.pl' added} +%^^A\changes{0.2d}{2007/08/18}{Scripts: Perl script 'generateswitch.pl' modified to insert bookmarks, and text shorten} %^^A\changes{0.2d}{2007/08/20}{Scripts: Perl script modified and authors pdfboomarks added} %^^A\changes{0.2g}{2007/09/07}{Scripts: changing input file line break style (Unix instead of Max)} %^^A\changes{0.2h}{2007/09/12}{Scripts: Perl script is case insensitive for session names 9and has more options)} @@ -4453,15 +7400,23 @@ paper,27,O,7,Templates fór Fòür Àuthors,p_009,LaTeX,"Serra:1996:sms,Moorer:2 %^^A Here is the creation of the procwitchandtoc.pl file, part of the example. %^^A It is written on first LaTeX run if it does not already exist %^^A ================================================================= +% +% \begin{description} +% \item[Name] \file{generateswitch.pl} +% \item[Type] Perl script +% \item [Purpose] generates TOC-related example files: paper switch in \file{expapersswitch.tex} and papers order by sessions and days in \file{exsessions.tex}. +% \item to use it, type in a bash terminal: \verb+perl generateswitch.pl +%<*generateswitch> #!/usr/bin/perl -w -# procswitchandtoc.pl +# generateswitch.pl # created as dafxproctoc.pl by Marc Zadel, 2006-04-28 -# modified for confproc.cls by Vincent Verfaille, 2007-08-08 +# modified for confproc.cls by Vincent Verfaille, 2007-08-08 (v0.4) & 2009-10-30 (v0.7) # Execute as -# ./procswitchandtoc.pl < intputfile.txt > +# ./generateswitch.pl < intputfile.txt > use strict; use Text::ParseWords; @@ -4481,24 +7436,24 @@ $\ = "\n"; # line endings for the output file sub parseinputline { my ($inputline) = @_; - # escape single quotes on the input line: they interfere with quotewords()'s + # escape single quotes on the input line: they interfere with quotewords()'s # quote handling (ie, they start to quote stuff) $inputline =~ s/'/\\'/g; # parse the input line my @wordlist = "ewords($fieldseparator, 0, $inputline); - # replace accented characters with latex escaped equivalents. To be done after + # replace accented characters with latex escaped equivalents. Use it after # quotewords() so the '\' don't get interpreted by quotewords() as escapes foreach my $word ( @wordlist ) { if ( $word ) { $word = &latexifyaccentedcharacters($word); } } # extract the fields into local variables. Author names stored as a list - my ($type, $number, $pcdecision, $nbpages, $title, $filename, + my ($type, $number, $pcdecision, $nbpages, $title, $filename, $generatedfrom, $cite) = @wordlist; - # remove the first 8 elements (just parsed out), leaving only author names. + # remove the first 8 elements (just parsed out), leaving only author names. # reminder: list of 8 scalars, though some may be "" if less than 4 authors splice( @wordlist, 0, 8 ); @@ -4507,8 +7462,8 @@ sub parseinputline { my @authors = (); while ( $wordlist[0] ) { push( @authors, [splice( @wordlist, 0, 2 )] ); - # "splice( @wordlist, 0, 2 )": cuts the first 2 scalars off of @wordlist - # and returns them; calling [splice(@wordlist,0,2)] returns a *reference* + # "splice( @wordlist, 0, 2 )": cuts the first 2 scalars off of @wordlist + # and returns them; calling [splice(@wordlist,0,2)] returns a *reference* # to a list containing the first two scalars. (see perldoc perldsc.) } @@ -4527,11 +7482,11 @@ sub parseinputline { return $fields; } -# -- takes a string in Mac OS Roman encoding and encode the accented +# -- takes a string in Mac OS Roman encoding and encode the accented # characters with latex escapes (only for a subset of available characters). sub latexifyaccentedcharacters { # for mapping between unicode and mac os western encoding, see: - # http://www.unicode.org/Public/MAPPINGS/VENDORS/APPLE/ROMAN.TXT + # http://www.unicode.org/Public/MAPPINGS/VENDORS/APPLE/ROMAN.TXT my ($inputstring) = @_; $inputstring =~ s/\x8a/\\"a/g; # \"a: unicode 0xe4, mac os western 0x8a $inputstring =~ s/\x87/\\'a/g; # \'a: unicode 0xe9, mac os western 0x87 @@ -4546,7 +7501,7 @@ sub latexifyaccentedcharacters { $inputstring =~ s/\xbf/\\o /g; # \o: unicode 0xf8, mac os western 0xbf $inputstring =~ s/\x96/\\~n /g; # \~n: unicode 0xF1, mac os western 0x96 $inputstring =~ s/\x94/\\^{\\i}/g; # \^{\i}: unicode 0xee, mac os western 0x94 - $inputstring =~ s/\x/\\i/g; # \i: unicode , mac os western + $inputstring =~ s/\x/\\i/g; # \i: unicode , mac os western $inputstring =~ s/\x9f/\\"u/g; # \"u: unicode 0xfc, mac os western 0x9f $inputstring =~ s/\x5c/\\/g; # \: unicode 0x5C, mac os western 0x5C @@ -4594,728 +7549,1045 @@ sub authorsbysurname { # -- in: ref. to a list of author names: "Zoelzer, Udo" and "Arfib, Daniel" # out: LaTeX index entries: "\index{Zoelzer, Udo}\index{Arfib, Daniel}" sub genindex { - my ($authorsbysurname) = @_; - my @indexentries = map { "\\index{$_}" } @$authorsbysurname; - return join('', @indexentries); -} - -# -- in: ref. to a list of author names: "Zoelzer, Udo" and "Arfib, Daniel" -# out: bookmarks cmds: "\pdfbookmark[2]{Udo Zoelzer}{#2.Udo Zoelzer} -# \pdfbookmark[2]{Daniel Arfib}{#2.Daniel Arfib}" -sub genbookmark { - my ($authorsbyfirstname) = @_; - my @indexentries = map { "\\pdfbookmark[2]{$_}{#2.$_}" } - @$authorsbyfirstname; - return join('', @indexentries); -} - -# -- output the information for a paper line -sub outputpaperlatex { - my ($fields) = @_; - open(SWI, ">>expapersswitch.tex"); #open for append - print SWI '%=========== PAPER ID = ', $fields->{'number'}, ' ==========='; - print SWI '\ifnum\paperswitch=', $fields->{'number'}; - print SWI ' \procinsertpaper{\LaTeXxShift{} \LaTeXyShift}{', - $fields->{'nbpages'}, '}{\paperswitch}%'; - print SWI ' {', $fields->{'title'}, '}% paper title'; - print SWI ' {', join( ', ', @{&authorsbyfirstname($fields->{'authors'})}), - '}% list of authors'; - print SWI ' {', &genindex(&authorsbysurname($fields->{'authors'})), - '}% authors index entries'; - print SWI ' {', $fields->{'cite'}, '}% cited bib items'; -# print SWI ' {#2}{\paperbookmark}'; - print SWI ' {#2}{', &genbookmark(&authorsbyfirstname($fields->{'authors'})),'}'; - print SWI '\fi'; - print SWI ' '; - open(SESSIONS, ">>exsessions.tex"); #open for write, overwrite - print SESSIONS '\paperid{', $fields->{'number'}, '}{', $fields->{'filename'}, '}'; -} - -# ----- Main -# FIXME: parse a line, and confirm that all of the fields are set up properly -# --> correct number of fields, and the fields have the correct values -open(SWI, ">>expapersswitch.tex"); #open for write, overwrite -print SWI '\newcommand{\paperid}[2]{'; -print SWI ' '; -print SWI '\renewcommand{\paperswitch}{#1}'; -print SWI ' '; - -while ( <> ) { - chomp; # clear the newline character from the end of the line - my $fields = &parseinputline($_); # parse the line into fields - # take some action depending on what type of line it is; case insensitive - if ( lc($fields->{'type'}) eq lc('day') ) { - &outputdaylatex($fields); - } elsif ( lc($fields->{'type'}) eq lc('session') - || lc($fields->{'type'}) eq lc('paper session') - || lc($fields->{'type'}) eq lc('demo session') - || lc($fields->{'type'}) eq lc('poster session') ) { - &outputsessionlatex($fields); - } elsif ( lc($fields->{'type'}) eq lc('oral') - || lc($fields->{'type'}) eq lc('paper') - || lc($fields->{'type'}) eq lc('demo') - || lc($fields->{'type'}) eq lc('poster') ) { - &outputpaperlatex($fields); - } elsif ( lc($fields->{'type'}) eq lc('Type')) { - } else { print '!!! a day, session or paper (', - $fields->{'type'},') is lost by the script...'; - } -open(SWI, ">>expapersswitch.tex"); #open for append -} -print SWI '}'; -close(SWI); -close(SESSIONS); -% -% \end{macrocode} -% -% -%^^A ================================================================= -% \subsection{Common bibliography items} -% \label{sec:ex:bib:common} -% -%^^A\changes{0.1d}{2007/08/01}{Biblio: adding the \file{exbiblio.tex} file creation} -%^^A\changes{0.1i}{2007/08/10}{Biblio: code cleanup} -%^^A\changes{0.1i}{2007/08/10}{Biblio: adding the \cmd{\procbibintro} command to customize the biblio introduction} -%^^A ================================================================= -%^^A Here is the creation of the exbibcommon.tex file, part of the example. -%^^A It is written on first LaTeX run if it does not already exist -%^^A ================================================================= -% -% Let us take a look at the common bibliographic items of this example: -% \changes{0.4b}{2007/10/12}{General biblio: remove item containing introductory paragraph} -% \begin{macrocode} -%<*exbiblio> -%-- This item generates the text under the bibliography title -%-- references to a book -@book{Mitra:Kaiser:1993:DSP:handbook, - Author = {S.~K. Mitra and J.~F. Kaiser}, - Title = {Handbook for Digital Signal Processing}, - Publisher = {J. Wiley {\&} Sons}, - Year = {1993}} - -@book{Haykin:1991:adaptive:filter, - Author = {Simon Haykin}, - Title = {Adaptive Filter Theory}, - Publisher = {Prentice Hall}, - Address = {Englewood Cliffs}, - Edition = {Second}, - Year = {1991}} - -%-- reference to a book chapter -@inbook{Serra:1996:sms, - Author = {X. Serra}, - Chapter = {Musical Sound Modeling with Sinusoids plus Noise}, - Publisher = {G. D. Poli, A. Picialli, S. T. Pope and C. Roads,% - Eds.~Swets~\&~Zeitlinger}, - Title = {Musical Signal Processing}, - Pages = {91--122}, - Year = {1996}} - -%-- reference to a journal paper -@article{Moorer:2000:AES:audio:millenium, - Author = {James A. Moorer}, - Title = {Audio in the New Millennium}, - Journal = {Journal of the {AES}}, - Volume = 48, - Number = 5, - Year = 2000, - Month = may, - Pages = {490--498}} - -%-- reference to a proceeding paper -@inproceedings{Arfib:1998:DAFx, - Author = {D. Arfib}, - Booktitle = {Proc. of the COST-G6 Workshop on Digital Audio Effects % - (DAFx-98)}, - Title = {Different Ways to Write Digital Audio Effects Programs}, - Address = {Barcelona, Spain}, - Pages = {188--91}, - Year = {1998}} - -%-- reference to a technical report -@techreport{Askenfelt:1976:automatic:transcription, - Author = {A. Askenfelt}, - Title = {Automatic notation of played music (status report)}, - Institution = {{STL-QPSR, Vol. 1, pp. 1--11}}, - Year = {1976}} - -%-- reference to a master thesis -@mastersthesis{Egozy:1995:MIT:features:gesture, - Author = {E.~B. Egozy}, - title = {Deriving musical control features from a real-time timbre % - analysis of the clarinet}, - School = {Massachusetts Institute of Technology}, - Year = {1995}} - -%-- reference to a PhD thesis -@phdthesis{Dutilleux:1991, - Author = {P. Dutilleux}, - School = {University of Aix-Marseille II}, - Title = {Vers la machine \`a sculpter le son, modification en % - temps-r\'eel des caract\'eristiques fr\'equentielles et temporelles% - des sons}, - Year = {1991}} - -%-- reference to a web page -@unpublished{Fitz:Haken:2003:Web:morphing:loris, - Author = {K. Fitz and L. Haken}, - Title = {{Current Research in Real-time Sound Morphing}}, - Note = {Available at \href{http://www.cerlsoundgroup.org/RealTimeMorph/}% - {http://www.cerlsoundgroup.org/RealTimeMorph/}}, - Year = {Accessed March 08, 2006}} -% -% \end{macrocode} -% -% See sec. \ref{sec:general:bib} for details about the bibliography merging process. -% -%^^A {\sc Explain also that each paper's bibitems' tags were renamed using the paper ID, and each paper was then recompiled with this general bibliography, to ensure coherence between local bibliographies and general bibliography. This implies to work on each paper afterwards to ensure then do not become overlengthen...} -% -%^^A ================================================================= -% \subsection{Unix scripts} -% \label{sec:scripts} -% -% \subsubsection{Compile all papers}\label{sec:scripts:buildpapers} -% -% First, you will notice that you need to make modifications to all papers, then needing to re-compile them all. For instance, you want each individual paper to have the same first page number as the one it has in the proceedings (for papers with page numbers included in the footer). Hopefully, they were all produced in \LaTeX{}, so you can automatize the process with a Unix script, such as: -% -%^^A\changes{0.1d}{2007/08/01}{Adding the exbiblio.tex creation} -%^^A ================================================================= -%^^A Here is the creation of the buildpapers script file, part of the example. -%^^A It is written on first LaTeX run if it does not already exist -%^^A ================================================================= -% \begin{macrocode} -%<*buildpapers> -#!/bin/sh - -# Compile all papers with 'pdflatex' of 'latex' -# (depending if they are in 'sources_pdftex' or 'sources_tex') -# and copy resulting pdf files in the 'papers' folder. -# Expected tree structure: -# proceedings/papers/sources_pdftex/ -# proceedings/papers/sources_tex/ -# with this script in 'proceedings/' - -#--- choose if you compile from scratch or only once -#BUILD_TYPE=final #recompile and re-do biblio -BUILD_TYPE=renumber #recompile only once for re-numbering - -#--- set system dependent variables -#LATEXPATH="/usr/local/teTeX/bin/i386-apple-darwin-current/" # teTeX -LATEXPATH="/usr/texbin/" # TexLive 2007 - -#--- paths -LATEX=$LATEXPATH"latex" -DVIPDF=/usr/local/bin/dvipdf -PDFLATEX=$LATEXPATH"pdflatex" -BIBTEX=$LATEXPATH"bibtex" -MAKEINDEX=$LATEXPATH"makeindex" -PROCSTY='dafx_06.sty' - -#--- Compiling .tex files with pdfLaTeX -cd papers/sources_pdftex -for i in *; do - echo; echo; echo '=====> Compiling' $i '.tex with pdfLaTeX <=====' - cd $i - # copy the paper style (in case you changed it) - cp ../../$PROCSTY . - echo; echo ' ---> 1st compilation of ' $i '.tex' - $PDFLATEX $i - if [ $BUILD_TYPE = final ]; then - echo; echo ' ---> Compiling the bibliography ' $i '.tex' - $BIBTEX $i - echo; echo ' --- 2nd compilation of ' $i '.tex' - $PDFLATEX $i - echo; echo ' ---> 3rd compilation of ' $i '.tex' - $PDFLATEX $i - fi - #--- copy the pdf where the proceedings will be assembled - cp $i.pdf ../.. - cd .. -done -#--- Compiling .tex files with LaTeX (problems related with hyperref) -cd ../sources_tex -for i in *; do - echo; echo; echo '=====> Compiling' $i '.tex with LaTeX <=====' - cd $i - #--- copy the paper proceedings style (if you changed the tree) - cp ../../$PROCSTY . - echo; echo ' ---> 1st compilation of ' $i '.tex ' - $LATEX $i.tex - if [ $BUILD_TYPE = final ]; then - echo; echo ' ---> Compiling the bibliography ' $i '.tex ' - $BIBTEX $i - echo; echo ' ---> 2nd compilation of ' $i '.tex ' - $LATEX $i - echo; echo ' ---> 3rd compilation of ' $i '.tex ' - $LATEX $i - fi - #--- produce the pdf from dvi - $DVIPDF $i.dvi $i.pdf - #--- copy the pdf where the proceedings will be assembled - cp $i.pdf ../.. - cd .. -done -% + my ($authorsbysurname) = @_; + my @indexentries = map { "\\index{$_}" } @$authorsbysurname; + return join('', @indexentries); +} + +# -- in: ref. to a list of author names: "Zoelzer, Udo" and "Arfib, Daniel" +# out: bookmarks cmds: "\pdfbookmark[2]{Udo Zoelzer}{#2.Udo Zoelzer} +# \pdfbookmark[2]{Daniel Arfib}{#2.Daniel Arfib}" +sub genbookmark { + my ($authorsbyfirstname) = @_; + my @indexentries = map { "\\pdfbookmark[2]{$_}{#2.$_}" } + @$authorsbyfirstname; + return join('', @indexentries); +} + +# -- output the information for a paper line +sub outputpaperlatex { + my ($fields) = @_; + open(SWI, ">>expapersswitch.tex"); #open for append + print SWI '%======= PAPER ID = ', $fields->{'number'}, ' ======='; + print SWI '\ifnum\paperswitch=', $fields->{'number'}; + print SWI ' \procpaper[xshift=\LaTeXxShift{}, yshift=\LaTeXyShift{}, npages=', + $fields->{'nbpages'}, ', switch=\paperswitch,%'; + print SWI ' title={', $fields->{'title'}, '},% paper title'; + print SWI ' author={', join( ', ', @{&authorsbyfirstname($fields->{'authors'})}), + '},% list of authors'; + print SWI ' index={', &genindex(&authorsbysurname($fields->{'authors'})), + '},% authors index entries'; + print SWI ' cite={', $fields->{'cite'}, '},% cited bib items'; +# print SWI ' {#2}{\paperbookmark}'; + print SWI ' bookmark={', &genbookmark(&authorsbyfirstname($fields->{'authors'})),'}% for PDF bookmark structure'; + print SWI ' ]{#2}'; + print SWI '\fi'; + print SWI ' '; + open(SESSIONS, ">>exsessions.tex"); #open for write, overwrite + print SESSIONS '\paperid{', $fields->{'number'}, '}{', $fields->{'filename'}, '}'; +} + +# ----- Main +# FIXME: parse a line, and confirm that all of the fields are set up properly +# --> correct number of fields, and the fields have the correct values +open(SWI, ">>expapersswitch.tex"); #open for write, overwrite +print SWI '\newcommand{\paperid}[2]{'; +print SWI ' '; +print SWI '\renewcommand{\paperswitch}{#1}'; +print SWI ' '; + +while ( <> ) { + chomp; # clear the newline character from the end of the line + my $fields = &parseinputline($_); # parse the line into fields + # take some action depending on what type of line it is; case insensitive + if ( lc($fields->{'type'}) eq lc('day') ) { + &outputdaylatex($fields); + } elsif ( lc($fields->{'type'}) eq lc('session') + || lc($fields->{'type'}) eq lc('paper session') + || lc($fields->{'type'}) eq lc('demo session') + || lc($fields->{'type'}) eq lc('poster session') ) { + &outputsessionlatex($fields); + } elsif ( lc($fields->{'type'}) eq lc('oral') + || lc($fields->{'type'}) eq lc('paper') + || lc($fields->{'type'}) eq lc('demo') + || lc($fields->{'type'}) eq lc('poster') ) { + &outputpaperlatex($fields); + } elsif ( lc($fields->{'type'}) eq lc('Type')) { + } else { print '!!! a day, session or paper (', + $fields->{'type'},') is lost by the script...'; + } +open(SWI, ">>expapersswitch.tex"); #open for append +} +print SWI '}'; +close(SWI); +close(SESSIONS); +% % \end{macrocode} % -% \subsubsection{Copy all PDFs papers at the right place}\label{sec:scripts:buildcppdfpapers} % -% Eventhough the previous Unix script already does it, you may have to re-copy all PDF files at the right place (\ie{} in 'papers/') without recompiling all the papers. This is achieved with a script such as: % +%^^A ================================================================= +% \subsection{\file{buildproc.sh}: Build the proceedings}\label{sec:confproc:compil:script}\label{sec:scripts:buildproc} % -%^^A\changes{0.1d}{2007/08/01}{Unix scripts: creating buildcppdfpapers.} -%^^A\changes{0.1f}{2007/08/03}{Unix scripts: cleanup for buildcppdfpapers.} +% \begin{description} +% \item[Name] \file{buildproc.sh} +% \item[Type] Unix/bash script +% \item[Purpose] describes all compilation steps to produce the final version of the proceedings +% \item[Note] This script is the most important! +% \end{description} +% This script applies several \LaTeX{} runs to create valid table of content, index, bibliography, index of authors, and proper back references from the bibliography. It also manages the renaming of the class insertion file, so we do not need anymore to run a last time by hand after changing the \Lopt{compil=backref} option to \Lopt{compil=last} (as this option change, and others, are in the \file{exclasspre.tex} and \file{exclasslast.tex} files). +% +% +%^^A\changes{0.1d}{2007/08/01}{Adding the buildproc script creation.} %^^A ================================================================= -%^^A Here is the creation of the buildcppdfpapers script file, part of the example. +%^^A Here is the creation of the buildproc script file, part of the example. %^^A It is written on first LaTeX run if it does not already exist %^^A ================================================================= +% % \begin{macrocode} -%<*buildcppdfpapers> +%<*buildproc> #!/bin/sh -cd papers/sources_tex -for i in *; do - echo '*********' $i '*********' - cp $i/$i.pdf .. -done -cd ../sources_pdftex -for i in *; do - echo '*********' $i '*********' - cp $i/$i.pdf .. -done -% + +% \end{macrocode} +% We set the user-dependent the original file name (no extension): +% \begin{macrocode} +#--- set user dependent file name +TEXFILE="example3optim" +% \end{macrocode} +% Let us now set system-dependent variables: the path the the \LaTeX{} distribution as well as the binaries: +% \begin{macrocode} +#--- set system-dependent variables +LATEXPATH="/usr/texbin/" # for TexLive +#--- set compilers' paths +PDFLATEX=$LATEXPATH"pdflatex" +BIBTEX=$LATEXPATH"bibtex" +MAKEINDEX=$LATEXPATH"makeindex" +mkdir pdftk_info/ + +% \end{macrocode} +% \begin{itemize} +% \item we copy the class options (including \Lopt{bib=backref}) to the file called by the core file: +% \end{itemize} +% \begin{macrocode} +#--- class settings: "empty" option and binding +cp exclasspre.tex exclass.tex +% \end{macrocode} + +% \begin{itemize} +% \item we run \LaTeX{} once to generate the table of contents: +% \end{itemize} +% \begin{macrocode} +#--- Compile +separator='___________________________________________________' +echo; echo; echo; echo; echo; echo; echo $separator; echo $separator; +echo '*** PdfLaTeX: create toc (1/6) ***' +$PDFLATEX $TEXFILE.tex + +% \end{macrocode} +% \begin{itemize} +% \item we run bib\TeX{} once to generate the bibliography: +% \end{itemize} +% \begin{macrocode} +echo; echo; echo; echo; echo; echo; echo $separator; echo $separator; +echo '*** Bibtex: generate the general biblio. (2/6) ***' +$BIBTEX $TEXFILE + +% \end{macrocode} +% \begin{itemize} +% \item we run \package{makeindex} once to generate the author index: +% \end{itemize} +% \begin{macrocode} +echo; echo; echo; echo; echo; echo; echo $separator; echo $separator; +echo '*** Makeindex: create index of authors (3/6) ***' +$MAKEINDEX -s confproc2.ist $TEXFILE.idx + +% \end{macrocode} +% \begin{itemize} +% \item we run \LaTeX{} once to insert the table of contents, index and bibliography, and update their page numbers for next run: +% \end{itemize} +% \begin{macrocode} +echo; echo; echo; echo; echo; echo; echo $separator; echo $separator; +echo '*** PdfLaTeX: add toc + insert index and bibliography (4/6) ***' +$PDFLATEX $TEXFILE.tex + +% \end{macrocode} +% \begin{itemize} +% \item we run \LaTeX{} once again to insert update page numbers in the table of contents, index and bibliography: +% \end{itemize} +% \begin{macrocode} +echo; echo; echo; echo; echo; echo; echo $separator; echo $separator; +echo '*** PdfLaTeX: createupdate toc, index and bib page numbers (5/6) ***' +$PDFLATEX $TEXFILE.tex + +% \end{macrocode} +% \begin{itemize} +% \item we do the final \LaTeX{} run: +% \end{itemize} +% \begin{macrocode} +echo; echo; echo; echo; echo; echo; echo $separator; echo $separator; +echo '*** PdfLaTeX: mod. class insertion, for proper PDF links for full papers (6/6) ***' +$PDFLATEX $TEXFILE.tex +% % \end{macrocode} % % +% %^^A ================================================================= -% \subsubsection{Make the proceedings}\label{sec:confproc:compil:script}\label{sec:scripts:buildproc} +% \subsection{\file{buildprocelpb.sh}: Generate both paperback and electronic final versions}\label{sec:scripts:buildprocelpb} % -% This script if the most important, as it describes all compilation steps to produce the final version of the proceedings. As you can see, it requires many compilations, to create valid table of content, index, bibliography, index of authors, and proper back references from the bibliography. It also manages for you the renaming of the class insertion file, so that you do not need anymore to run a last time by hand after changing the \Lopt{compil=backref} option to \Lopt{compil=last} (as this option change, and others, are in the \file{exclasspre.tex} and \file{exclasslast.tex} files). +% \begin{description} +% \item[Name] \file{buildprocelpb.sh} +% \item[Type] Unix/bash script +% \item[Purpose] describes all compilation steps to produce the final version of both paperback and electronic proceedings +% \item[Note] This script helps to automatize the whole production process; its is described/commented as an incrementation from \file{buildproc.sh}. +% \end{description} % % -%^^A\changes{0.1d}{2007/08/01}{Adding the buildproc script creation.} %^^A ================================================================= -%^^A Here is the creation of the buildproc script file, part of the example. +%^^A Here is the creation of the buildprocelpb.sh script file, part of the example. %^^A It is written on first LaTeX run if it does not already exist %^^A ================================================================= +%\changes{0.6}{\datevzdsix}{added \file{buildproc2.sh}} +%\changes{0.7}{2010/08/05}{renamed \file{buildproc2.sh} into \file{buildprocelpb.sh}} +% +% We first set the user-dependent file names and folders, namely: % \begin{macrocode} -%<*buildproc> -#!/bin/sh +% \changes{0.7}{2010/08/05}{added \file{buildprocelpb.sh}} +% \color{black!50} +%<*buildprocelpb> +#!/bin/bash #--- set user dependent file name -TEXFILE="example" -#--- set system dependent variables -#LATEXPATH="/usr/local/teTeX/bin/i386-apple-darwin-current/" # for teTeX -LATEXPATH="/usr/texbin/" # for TexLive 2007 +% \end{macrocode} +% \color{black} +% \begin{itemize} +% \item the original file name (no extension): +% \end{itemize} +% \begin{macrocode} +INTEXFILE="example4optim" +% \end{macrocode} +% \begin{itemize} +% \item the target file name (no extension): +% \end{itemize} +% \begin{macrocode} +TEXFILE="proceedings" +% \end{macrocode} +% \begin{itemize} +% \item the working directory: +% \end{itemize} +% \begin{macrocode} +TEXFILEPATH="example" +% \end{macrocode} +% \begin{itemize} +% \item the target directories for paperback and electronic versions: +% \end{itemize} +% \begin{macrocode} +PAPERBACKFOLDER="PDF_printed/" +ELECTRONICFOLDER="PDF_electronic/" + +% \end{macrocode} +% We then define the names of \LaTeX{} files containing the class options before the last run (ie. with bibliography back-references): +% \begin{macrocode} +#--- different class options for electronic vs paperback version +class_paperback_pre=exclasspre +% \end{macrocode} +% and the names of \LaTeX{} files containing the class options for the last run for both paperback and electronic versions: +% \begin{macrocode} +class_paperback_final=exclasslastpb +class_electronic_final=exclasslastel + +% \end{macrocode} +% Let us now set system-dependent variables: the path the the \LaTeX{} distribution as well as the binaries: +% \color{black!50} +% \begin{macrocode} +#--- set system-dependent variables +LATEXPATH="/usr/texbin/" # TexLive + #--- set compilers' paths PDFLATEX=$LATEXPATH"pdflatex" BIBTEX=$LATEXPATH"bibtex" MAKEINDEX=$LATEXPATH"makeindex" +% \end{macrocode} +% \color{black} +% We then define temporary folders for splitting the proceedings back into separate files with proper PDF metadata: +% \begin{macrocode} +#--- set script-specific paths +GPATH=`pwd` # general proc path +PAPERBACKFOLDER=${GPATH}/${PAPERBACKFOLDER} +ELECTRONICFOLDER=${GPATH}/${ELECTRONICFOLDER} +PDFPATH="${ELECTRONICFOLDER}/papers" +PDFTKPATH="pdftk_info/" +INPATH="tmp/papersinfo/" +SPPATH="tmp/papers_split/" + +% \end{macrocode} +% Let us now create the needed folders: +% \begin{macrocode} +#=== prepare output folders +mkdir -p ${PAPERBACKFOLDER} +mkdir -p ${ELECTRONICFOLDER} +rm -r ${ELECTRONICFOLDER}/papers/ +mkdir -p ${ELECTRONICFOLDER}/papers/ +mkdir -p $INPATH +mkdir -p $SPPATH +mkdir -p $PDFTKPATH + +% \end{macrocode} +% We can now move to the working directory and start building the paperback version: +% \begin{macrocode} +#=== GO TO LaTeX FOLDER !!! +cd ${GPATH} + +% \end{macrocode} +% \begin{itemize} +% \item we generate the \LaTeX{} file by concatenating the class options (including \Lopt{bib=backref}) with the file core: +% \end{itemize} +% \begin{macrocode} +#=== MAKE PAPERBACK VERSION +#--- class settings: "empty" option and binding +cat ${class_paperback_pre}.tex ${INTEXFILE}.tex >${TEXFILE}.tex + +% \end{macrocode} +% \begin{itemize} +% \item we run \LaTeX{} once to generate the table of contents: +% \end{itemize} +% \color{black!50} +% \begin{macrocode} #--- Compile -echo; echo; echo '*** bash: copying class insertion file ***' -cp exclasspre.tex exclass.tex -echo; echo; echo '*** PdfLaTeX: create toc (1/7) ***' +separator='___________________________________________________' +echo; echo; echo; echo; echo; echo; echo $separator; echo $separator; +echo '*** PdfLaTeX: create toc (1/6) ***' $PDFLATEX $TEXFILE.tex -echo; echo; echo '*** Bibtex: generate the general biblio. (2/7) ***' + +% \end{macrocode} +% \color{black} +% \begin{itemize} +% \item we run bib\TeX{} once to generate the bibliography: +% \end{itemize} +% \color{black!50} +% \begin{macrocode} +echo; echo; echo; echo; echo; echo; echo $separator; echo $separator; +echo '*** Bibtex: generate the general biblio. (2/6) ***' $BIBTEX $TEXFILE -echo; echo; echo '*** Makeindex: create index of authors (3/7) ***' -$MAKEINDEX -s confproc.ist $TEXFILE.idx -echo; echo; echo '*** PdfLaTeX: create toc + include index (4/7) ***' + +% \end{macrocode} +% \color{black} +% \begin{itemize} +% \item we run \package{makeindex} once to generate the author index: +% \end{itemize} +% \color{black!50} +% \begin{macrocode} +echo; echo; echo; echo; echo; echo; echo $separator; echo $separator; +echo '*** Makeindex: create index of authors (3/6) ***' +$MAKEINDEX -s confproc2.ist $TEXFILE.idx + +% \end{macrocode} +% \color{black} +% \begin{itemize} +% \item we run \LaTeX{} once to insert the table of contents, index and bibliography, and update their page numbers for next run: +% \end{itemize} +% \color{black!50} +% \begin{macrocode} +echo; echo; echo; echo; echo; echo; echo $separator; echo $separator; +echo '*** PdfLaTeX: add toc + insert index and bibliography (4/6) ***' +$PDFLATEX $TEXFILE.tex + +% \end{macrocode} +% \color{black} +% \begin{itemize} +% \item we run \LaTeX{} once again to insert update page numbers in the table of contents, index and bibliography: +% \end{itemize} +% \color{black!50} +% \begin{macrocode} +echo; echo; echo; echo; echo; echo; echo $separator; echo $separator; +echo '*** PdfLaTeX: createupdate toc, index and bib page numbers (5/6) ***' $PDFLATEX $TEXFILE.tex -echo; echo; echo '*** PdfLaTeX: create backrefs (5/7) ***' + +% \end{macrocode} +% \color{black} +% \begin{itemize} +% \item we generate the final \LaTeX{} file by concatenating the class options (with \Lopt{bib=final} being the only diference, otherwise you may break more than just the back-references and get a non-functioning table of content and index series of links) with the file core: +% \end{itemize} +% \begin{macrocode} +#--- class settings: "final" option and binding +cat ${class_paperback_final}.tex ${INTEXFILE}.tex >${TEXFILE}.tex + +% \end{macrocode} +% \begin{itemize} +% \item we do the final \LaTeX{} run: +% \end{itemize} +% \color{black!50} +% \begin{macrocode} +echo; echo; echo; echo; echo; echo; echo $separator; echo $separator; +echo '*** PdfLaTeX: mod. class insertion, for proper PDF links for full papers (6/6) ***' $PDFLATEX $TEXFILE.tex -echo; echo; echo '*** PdfLaTeX: give proper toc and backrefs (6/7) ***' + +% \end{macrocode} +% \color{black} +% \begin{itemize} +% \item and save the file in the appropriate folder: +% \end{itemize} +% \begin{macrocode} +#--- save PDF +cp ${TEXFILE}.pdf $PAPERBACKFOLDER/${TEXFILE}.pdf + +% \end{macrocode} +% The process is the exact same for the electronic version: +% \begin{macrocode} +#=== MAKE ELECTRONIC VERSION FOR CD, FROM PAPERBACK VERSION +#--- class settings: "final" option and no binding +cd ${GPATH}/${TEXFILEPATH} +cat ${class_electronic_final}.tex ${INTEXFILE}.tex >${TEXFILE}.tex + +% \end{macrocode} +% \color{black!50} +% \begin{macrocode} +#--- Compile +echo; echo; echo; echo; echo; echo; echo $separator; echo $separator; +echo '*** PdfLaTeX: create toc (1/6) ***' +$PDFLATEX $TEXFILE.tex + +echo; echo; echo; echo; echo; echo; echo $separator; echo $separator; +echo '*** Bibtex: generate the general biblio. (2/6) ***' +$BIBTEX $TEXFILE + +echo; echo; echo; echo; echo; echo; echo $separator; echo $separator; +echo '*** Makeindex: create index of authors (3/6) ***' +$MAKEINDEX -s confproc2.ist $TEXFILE.idx + +echo; echo; echo; echo; echo; echo; echo $separator; echo $separator; +echo '*** PdfLaTeX: add toc (4/6) ***' +$PDFLATEX $TEXFILE.tex + +echo; echo; echo; echo; echo; echo; echo $separator; echo $separator; +echo '*** PdfLaTeX: create toc + include index (5/6) ***' $PDFLATEX $TEXFILE.tex -echo; echo; echo '*** bash: copying class insertion file ***' -cp exclasslast.tex exclass.tex -echo; echo; echo '*** PdfLaTeX: full papers (mod. class insertion) (7/7) ***' + +% \end{macrocode} +% \color{black} +% \begin{macrocode} +#--- class settings: "final" option and binding +cat ${class_paperback_final}.tex ${INTEXFILE}.tex >${TEXFILE}.tex + +% \end{macrocode} +% \color{black!50} +% \begin{macrocode} +echo; echo; echo; echo; echo; echo; echo $separator; echo $separator; +echo '*** PdfLaTeX: mod. class insertion, for proper PDF links for full papers (6/6) ***' $PDFLATEX $TEXFILE.tex -% + +% \end{macrocode} +% \color{black} +% Once the PDF file is generated, is ts saved: and +% \begin{macrocode} +mkdir ${ELECTRONICFOLDER}/papers/ +#--- save PDF +echo "cmd: cp ${TEXFILE}.pdf ${GPATH}/${ELECTRONICFOLDER}/${TEXFILE}.pdf" +cp ${TEXFILE}.pdf $ELECTRONICFOLDER/${TEXFILE}.pdf + +% \end{macrocode} +% We can then generate individual PDFs with proper PDF metadata: +% \begin{macrocode} +#=== EXPORT individual pdf papers back from the proceedings + hdr/footers/metadata +cd ${GPATH} +echo; echo; echo; echo; echo; echo; echo $separator; echo $separator; +echo '*** Export individual PDFs ***' +echo "cmd: ./exportIndividualPDFs.sh ${GPATH} ${TEXFILEPATH}/${TEXFILE} ${INPATH} ${SPPATH} ${PDFPATH} ${PDFTKPATH}" +./exportIndividualPDFs.sh ${GPATH} ${TEXFILE} ${INPATH} ${SPPATH} ${PDFPATH} ${PDFTKPATH} + +% \end{macrocode} +% and clean up the temporary folder if uncommented: +% \begin{macrocode} +# rm -r ${GPATH}/tmp/ +% % \end{macrocode} % -%^^A\changes{0.2g}{2007/09/07}{Docu: starting a more organized `proceedings making'} -%^^A ================================================================= -%^^A Why developing confproc +% \color{black} +% +% +% +% %^^A ================================================================= -% \section{More about conference proceedings making} -% \label{sec:conference:proc:making} +% \subsection{\file{countnbpages.sh}: Count the number of pages of individual PDFs}\label{sec:scripts:countnbpages} % +% \begin{description} +% \item[Name] \file{countnbpages.sh} +% \item[Type] Unix/bash script +% \item [Purpose] counts each \file{.pdf}'s number of pages, and stores them in a \file{proceedings.npc} file. +% \end{description} +% It is basically used to check that there is no discrepancy between the number of pages indicated in the proceedings file (\file{proceedings.tex} or \file{expapersswitch.tex}) and the actual number of pages of each paper. % -%^^A\changes{0.2g}{2007/09/07}{Docu: e-organizing steps' section} +%^^A\changes{0.5}{\datevzfive}{Add the `countnbpages' script creation.} %^^A ================================================================= -%^^A Compilations +%^^A Here is the creation of the countnbpages.sh script file, part of the example. +%^^A It is written on first LaTeX run if it does not already exist %^^A ================================================================= -% \subsection{Steps to generate the final version of your proceedings}\label{sec:confproc:compil} % -% We now describe the methodology and steps used to produce the final version of the provided example proceedings with the following constraints: -% \begin{itemize} -% \item paper templates have header and footer; -% \item the proceedings must have the same header/footer; -% \item we want a general bibliography; -% \item we want the PDF papers to be named after their first page number; -% \end{itemize} +% \begin{macrocode} +% \changes{0.7}{2010/08/05}{added \file{countnbpages.sh}} +%<*countnbpages> +#!/bin/sh + +% \end{macrocode} +% We first set the path to \LaTeX{} binaries and names of \LaTeX{} compiler: +% \begin{macrocode} +#-- set path to LaTeX binaries +LATEXPATH="/usr/texbin/" # TeXLive +#-- set names of LaTeX and related compilers +PDFLATEX=$LATEXPATH"pdflatex" + +% \end{macrocode} +% We then set the document name and papers' folder name: +% \begin{macrocode} +TEXFILE="simple_proceedings" #- set document's name +PDFSPATH="papers" #- set the papers' folder name + +% \end{macrocode} +% We remove previous \file{.npt} file: +% \begin{macrocode} +rm -f ${TEXFILE}.npt # count pages from terminal +cd ${PDFSPATH} +% \end{macrocode} +% For each \file{.pdf} file, we count its number of pages using the \file{pdfinfo}\footnote{\file{pdfinfo} can be downloaded from \url{}} script: +% \begin{macrocode} +for file in *.pdf +do + pdfinfo -meta $file | grep "Pages:" > tmp0 + echo "file $file has `sed 's/.*\([0-9]\).*/\1/' < tmp0` pages" >> ../${TEXFILE}.npt +done +rm -f tmp0 +cd .. +more ${TEXFILE}.npt +% +% \end{macrocode} % +% \paragraph{Alternative} Non-Unix afficionados can use the \DescribeMacro{papers=countpages}\Lopt{papers=countpages} option (results are stored in \file{proceedings.npc}); this is however \margindanger{}much much much slower, as \package{pdfpages} has to insert each and every page for each and every paper. % -%^^A ================================================================= -% \subsubsection{Generate the program and the paper switch} % -% You may generate the conference program and its corresponding paper switch: -% \begin{itemize} -% \item by hand (read sec. \ref{sec:ex:paper:switch} for an example); -% \item using the \file{procswitchandtoc.pl} Perl script described in sec.~\ref{sec:scripts:perl} to generate both the \file{exsessions.tex} and \file{expapersswitch.tex} files from your \file{exprogram.csv} program file; -% \end{itemize} -% %^^A ================================================================= -% \subsubsection{Changing papers' first page number} +% \subsection{\file{exportIndividualPDFs.sh}: Export individual PDF papers from the proceedings}\label{sec:scripts:exportIndividualPDFs} % -% If you paper template has page numbers included in the footer, you may want each individual paper to have the same first page number as the one it has in the proceedings' table of contents\footnote{When clicking on a paper, the PDF file of this paper will open with the same first page number. Also, if the conference papers are available on the web, knowing the page numbers will help readers to properly cite them.}. To do so, The way to do that is: -% \begin{enumerate} -% \item make at least two runs with the following options:\begin{verbatim} -%\documentclass[a4paper,10pt,twoside,twosidepapers,% -% compil=last,headers=allpages,movepagenumbers,electronic]{confproc} -%\end{verbatim} -% to include all papers and build a table of contents with proper page numbers. -% \item prepare each paper for insertion. There are two ways to do this: -% \begin{enumerate} -% \item lazy way: use the \verb+\setcounter{page}{1}+ line in the paper, and replace the \verb+1+ by the real number; -% \item better way: centralize page numbers in the \file{expages.tex} file, organized by the paper ID. Then, the two steps are: -% \begin{itemize} -% \item add the following in the preamble of each paper:\begin{verbatim} -%\input{../../expages.tex}\setpagenumber{04} -%\end{verbatim} -% Here, the ID paper is \verb+04+, and has to be updated for each paper. -% \item update the \file{expages.tex} file for each paper: set its first page number as it appears in the table of contents. -% \end{itemize} -% By doing so, you can update the program to re-build the table of contents as many times as yuo want, without having to re-edit all papers. -% \end{enumerate} -% \item when the program (and the corresponding paper ordering) is defined, (re)generate each paper independently with proper first page number (using the \file{buildpapers} Unix script provided in sec.~\ref{sec:scripts:buildpapers}); -% \item check that you did not make errors in numbering the first page. You may run \LaTeX\ with at least the \Lopt{headers=allpages,movepagenumbers} options. If there are still errors, re-do step 2--3 till the page numbers are ok. -% \end{enumerate} +% \begin{description} +% \item[Name] \file{exportIndividualPDFs.sh} +% \item[Type] Unix/bash script +% \item[Purpose] exports each individual paper from the whole proceedings, provided that a \file{proceedings.pdftk} file exists +% \item[Dependencies] \file{paperssplitpreamble.sh} and \file{papersinfo.sh} +% \item[Note] It is only meant to be used once a valid PDF version of the electronic proceedings exist (ie.~once all formatting issues have been solved and final content have been added), before creating a CD-ROM. +% \end{description} % -%^^A ================================================================= -% \subsubsection{Renaming papers} +% \color{black} % -% You may consider renaming all papers according to their first page number (\eg{} \file{p\_NNN.pdf} if you decide to only rename the PDF files). This is very helpful to ensure you CD version of the proceedings is ISO compliant, and has file names with less than 8 characters (+ extensions). This means that you only do this when you are sure of your page numbering. You then have to change file names accordingly in the \file{.csv} file, re-generate the \file{expapersswitch.tex} file, and rebuild the proceedings. It is easily done using the Unix scripts. -% -%^^A\changes{0.2i}{2007/09/21}{Docu: finishing biblio merging and other biblio-related stuff} %^^A ================================================================= -% \subsubsection{General bibliography}\label{sec:general:bib} +%^^A Here is the creation of the exportIndividualPDFs.sh script file, part of the example. +%^^A It is written on first LaTeX run if it does not already exist +%^^A ================================================================= % -% As said previously, for DAFx-06 (but not for the provided example), we worked with three files in order to simplify the bibliography merging process: -% \begin{itemize} -% \item \texttt{exbibconcat.bib} containing all citations for all papers; -% \item \texttt{exbibcommon.bib} containing common bibliography items, added one by one during the merging process; -% \item \texttt{exbibstrings.bib} containing all common strings (conference names, journal names, etc), to ensure coherence among citations from same sources (journal, conference). -% \end{itemize} -% Here is how those files are created and used: -% \begin{enumerate} -% \item create the complete bibliography: -% \begin{enumerate} -% \item for each paper, change its bib item tags to a tag that cannot be common to 2 papers (we used a \verb+paperID:originaltag+ format)\footnote{You may ask your authors to do so if you send them editor's notes.}; -% \item ensure that each paper has a proper list of bibliography items using those new tags; -% \item concat the bibliographys of all individual paper into a single file named \file{exbibconcat.bib}; -% \item set the proceedings bibliography file to \begin{verbatim} -%\renewcommand{\procbibfile}{\BIBPATH exbibconcat.bib} -%\end{verbatim} -% \item run \LaTeX\ with the complete bibliography (using the \Lopt{compil=bibmerge} option that uses \verb+\nocite{*}+) so bib items are include twice: by the paper and globally. You are now ready to merge bibliographies. -% \end{enumerate} -% \item merge the bibliographic items (long step): -% \begin{enumerate} -% \item first, add the \file{exbibcommon.bib} file to the list of bibliography files by setting the proceedings bibliography files to: \begin{verbatim} -%\renewcommand{\procbibfile}{\BIBPATH exbibcommon.bib,% -% \BIBPATH exbibconcat.bib} -%\end{verbatim} -% \item for each item appearing multiple times: -% \begin{enumerate} -% \item create a corresponding entry in the \file{exbibcommon.bib} file; -% \item remove each appearance of it in \file{exbibconcat.bib}; -% \item this is the perfect time for correcting inconsistent references (title, list of authors, page numbers, etc)! Note that this process requires a lot of time, as it is the slowest in the bibliography merging process. -% \end{enumerate} -% \end{enumerate} -% \item merge the bibliography strings: -% \begin{enumerate} -% \item add the \file{exbibstrings.bib} file to the list of bibliography files by setting the proceedings bibliography files to: \begin{verbatim} -%\renewcommand{\procbibfile}{\BIBPATH exbibstrings.bib,% -% \BIBPATH exbibcommon.bib,\BIBPATH exbibconcat.bib} -%\end{verbatim} -% \item merge the common strings. For each string shared by several items: -% \begin{enumerate} -% \item define the corresponding string in the \file{exbibstring.bib} file. For instance, for the IEEE Transactions on Acoustics, Speech, and Signal Processing, add:\begin{verbatim} -%@string{IEEE-TASSP = "{IEEE Trans. Acoust., Speech, -% and Signal Proc.}"} -%\end{verbatim} -% \item use this definition (\eg{} \file{IEEE-TASSP}) to replace any appearance of its in the \file{exbibconcat.bib} file. For instance, use:\begin{verbatim} -%@article{paper027:Mcaulay86, -% Author = {Robert J. McAulay and Thomas F. Quatieri}, -% Title = {Speech Analysis/Synthesis Based on a% -% Sinusoidal Representation}, -% Journal = IEEE-TASSP, -% Volume = {34}, -% Number = {4}, -% Pages = {744-754}, -% Year = {1986}} -%\end{verbatim} -% \end{enumerate} -% \end{enumerate} -% \item updating papers once the general bibliography is ok: -% \begin{enumerate} -% \item for each paper: -% \begin{enumerate} -% \item generate a new bibliography file (\eg{} \file{p\_027.bib} for \file{p\_027.tex}) that included only their own non-common bibliography items remaining in the \file{exbibconcat.bib} file; -% \item edit each paper so that it uses both this new bibliography file (\file{p\_027.bib}) together with the \file{exbibcommon.bib} and the \file{exbibstrings.bib} files. This will provide common and coherent contents to both local and general bibliographies. Since the \file{p\_027.tex} file is placed in the \file{papers/pdftex/p\_027/} folder, its bibliography insertion will then become something like:\begin{verbatim} -%\bibliography{../../exbibstrings.bib,% -% ../../exbibcommon.bib,p_027.bib} -%\end{verbatim} -% \end{enumerate} -% \item re-run \LaTeX\ on all papers, using the \file{buildpapers} Unix script (see sec. \ref{sec:scripts:buildpapers}). This script also copies all resulting PDFs to the right place. -% \item if you did not use the previous script, copy all PDF papers to the \file{papers/} folder. The \file{buildcppdfpapers} Unix script (see sec. \ref{sec:scripts:buildcppdfpapers}) can do it for you, for instance if you changed some of the papers but not all, and do not remember which were to be copied. -% \end{enumerate} -% \end{enumerate} -% You are now done with bibliography merging, and are ready to re-run \LaTeX\ on the proceedings using the \Lopt{compil=backref} options as many times as necessary to provide proper back-references and page numbering. +% We first set macros from the script arguments (path, \TeX\ file name without extension, +% paper info folder, split PDFs folder, PDF proceedings folder): +%\changes{0.6}{\datevzdsix}{added \file{exportIndividualPDFs.sh}} +% \begin{macrocode} +% \changes{0.7}{2010/08/05}{added \file{exportIndividualPDFs.sh}} +%<*exportIndividualPDFs> +#!/bin/bash + +args=("$@") +GPATH=${args[0]} #= ~/e-proceedings +TEXFILE=${args[1]} #= proceedings +INPATH=${args[2]} #= papers_info +#mkdir -p $INPATH +SPPATH=${args[3]} #= papers_split +#mkdir -p $SPPATH +PDFPATH=${args[4]} +PDFTKPATH=${args[5]} + +PDFFILE=${TEXFILE}.pdf # for use in the paper_split.sh and paper_info.sh scripts + +echo "-PATH (working path): $GPATH" +echo "-TeX file (orig. TeX proc): $TEXFILE" +echo "-PDF: $PDFFILE (original PDF proc)" +echo "-PDFPATH (indiv. PDFs): $PDFPATH " +echo "-PDFTKPATH (pdftk info): $PDFTKPATH" +echo "-INPATH (papers info): $INPATH" +echo "-SPPATH (split papers): $SPPATH" + +% \end{macrocode} +% we move to the PDFtk folder: +% \begin{macrocode} +cd $PDFTKPATH +list=`ls *.pdftk` +% \end{macrocode} +% Then for each file: +% \begin{macrocode} +for tmpfile in $list +do +% \end{macrocode} +% we concatenate all lines by removing carriage returns: +% \begin{macrocode} + cp ${tmpfile} test.txt + #-- 2-concat all lines, removing carriage returns + sed -e :a -e '$!N;s/\n/LineBreak/;ta' -e 'P;D' test.txt >test2.txt + perl -ne ' s/LineBreakInfoKey/\nInfoKey/g; print ' test2.txt >test3.txt + perl -ne ' s/LineBreakInfoValue/\nInfoValue/g; print ' test3.txt >test4.txt + perl -ne ' s/LineBreak//g; print ' test4.txt >test5.txt + mv test5.txt $tmpfile +done + +% \end{macrocode} +% After a quick clean up: +% \begin{macrocode} +rm -f tmp* +rm -f test*.txt + +% \end{macrocode} +% we generate the \file{paper\_split.sh} bash script that will soon be used: +% \begin{macrocode} +cd $GPATH +echo "__________" +echo "__ split PDFs: generate bash script file" +pwd +echo "cmd: cat paperssplitpreamble.sh $TEXFILE.pdftk >tmp.sh" +cat paperssplitpreamble.sh $TEXFILE.pdftk >tmp.sh +mv tmp.sh ${GPATH}/papers_split.sh + +% \end{macrocode} +% to which we add the Perl command that helps to adds echo command to +% each \package{pdftk}\footnote{Get \package{pdftk} at: \url{http://www.accesspdf.com/pdftk/}} command in \file{paper\_split.sh}: +% \begin{macrocode} +echo "__________" +echo "__ split PDFs: Perl to add echo lines to 'papers_split.sh' script" + +#echo "cmd: Perl to copy/add 'echo' cmd to each pdftk command, in 'papers_split.sh'" +perl -p -e 's/^pdftk(.*[\n\r])/echo \"pdftk $1\"\npdftk $1/gm' ${GPATH}/papers_split.sh >tmp.txt +mv tmp.txt ${GPATH}/papers_split_all.sh + +% \end{macrocode} +% We can now launch the \file{papers\_split\_all.sh} bash script: +% \begin{macrocode} +echo; echo "__________" +echo "__ split PDFs: launch bash script file" +#echo "cmd: chmod +x papers_split_all.sh" +chmod +x papers_split_all.sh + +echo "cmd: ./papers_split_all.sh" +#echo " ./papers_split_all.sh ${GPATH} ${TEXFILE} ${INPATH} ${SPPATH} ${PDFPATH}" +./papers_split_all.sh ${GPATH} ${TEXFILE} ${INPATH} ${SPPATH} ${PDFPATH} +# rm ${SPPATH}/*.ps #useful only if 'pdf2ps -> ps2pdf', not useful with 'gs' + + +% \end{macrocode} +% and once all individual PDFs have been split, we generate new individual PDFs +% with corrected and homogeneous metadata: +% \begin{macrocode} +#--- generate PDF with corrected metadata +echo "__________" +echo "__ Correct PDF metadata with papersinfo.sh" +./papersinfo.sh ${GPATH} ${TEXFILE} ${INPATH} ${SPPATH} ${PDFPATH} ${PDFTKPATH} + +% \end{macrocode} +% we're now good for a real spring cleaning: +% \begin{macrocode} +##--- clean +#rm -r ${INPATH} +#rm -r ${SPPATH} +#rm papers_split.sh +#rm -r tmp +% +% \end{macrocode} % % +%^^A ================================================================= +% \subsection{\file{removeLaTeXcmds.sh}: Convert \LaTeX\ strings for PDF metadata}\label{sec:scripts:removeLaTeXcmds} % +% \begin{description} +% \item[Name] \file{removeLaTeXcmds.sh} +% \item[Type] Unix/bash script that makes use of Perl commands +% \item[Purpose] converts \LaTeX\ strings for PDF metadata +% \item[Note] to be used when using the metadata in \file{proceedings.pdftk} (generated by the \Lopt{pdftk} option), as we need to remove all \LaTeX\ commands and accents that are not recognized by the PDF format. +% \end{description} % % -%^^A everything else in the proceedings is done (table of contents. index, etc), create the back references with one of those two solutions: -%^^A \begin{itemize} -%^^A \item Good trick: {\sc check this as it seems that it has changed} labels/refs -%^^A \begin{itemize} -%^^A \item insert the $N_i-1$ pages of each paper $i$ and replace last page by a citation of local bibliography. Then, bib items properly appear in the full bibliography -%^^A \item save the \file{DAFx06\_Proceedings.brf} file under another name -%^^A \item recompile the Proceedings without replacing last page by bibliography -%^^A \item rename properly the file \file{DAFx06\_Proceedings.brf} -%^^A \item one last compile, and the backref are ok! -%^^A \item Rk: one should NOT recompile the bibliography without doing this manipulation again -%^^A \end{itemize} -%^^A \item generate the \file{DAFx06\_Proceedings.brf} file by hand! -%^^A \begin{itemize} -%^^A \item create the general backref file \file{DAFx06\_Proceedings.brf} using lines such as:\\ -%^^A \begin{verbatim} -%^^A\backcite{Ref1,Ref2,Ref3}{{12}% -%^^A {(document)}{Doc-Start}} -%^^A \end{verbatim} -%^^A \item update all pages numbers in the \file{DAFx06\_Proceedings.brf} back references file -%^^A \item have a back reference for each page where the reference is appearing (maybe several for each paper). -%^^A \item save your \file{DAFx06\_Proceedings.brf} file under another name, since it will be erase by the next bib compilation -%^^A \end{itemize} +%^^A ================================================================= +%^^A Here is the creation of the removeLaTeXcmds.sh script file, part of the example. +%^^A It is written on first LaTeX run if it does not already exist +%^^A ================================================================= % +% We first get the script arguments (path, input file name, output file name): +%\changes{0.6}{\datevzdsix}{added \file{removeLaTeXcmds.sh}} +% \begin{macrocode} +%<*removeLaTeXcmds> +#!/bin/bash + +# arg 0: path, arg 1: input file; arg 2: output file + +#-- save arguments for use +args=("$@") +path=${args[0]} +file=${args[1]} +outputfile=${args[2]} +% \end{macrocode} +% We go to the folder where we want to work, and copy the input file in order to work on a copy: +% \begin{macrocode} +cd ${path} +cp ${file} tmp.txt +#echo "__ ORIGINAL: $file ___" +#cat tmp.txt + +% \end{macrocode} +% We then remove accents with Perl commands:: +% \begin{macrocode} +#echo " " +#echo "__ removed accents: __" +perl -p -i -e " s/\\\'e/e/g " tmp.txt +perl -p -i -e " s/\\'{e}/e/g " tmp.txt +perl -p -i -e " s/\\\`e/e/g " tmp.txt +perl -p -i -e ' s/\\"e/e/g ' tmp.txt +perl -p -i -e " s/\\\`{e}/e/g " tmp.txt +perl -p -i -e " s/\\\'a/a/g " tmp.txt +perl -p -i -e " s/\\\`a/a/g " tmp.txt +perl -p -i -e " s/\\\`{a}/a/g " tmp.txt +perl -p -i -e ' s/\\"{o}/oe/g ' tmp.txt +perl -p -i -e ' s/\\"o/o/g ' tmp.txt +perl -p -i -e ' s/\\o{}/o/g ' tmp.txt +perl -p -i -e ' s/\\\^o/o/g ' tmp.txt +perl -p -i -e " s/\\\'o/o/g " tmp.txt +perl -p -i -e " s/\\\`o/o/g " tmp.txt +perl -p -i -e " s/\\\'u/u/g " tmp.txt +perl -p -i -e ' s/\\u //g ' tmp.txt +perl -p -i -e ' s/\\"u/u/g ' tmp.txt +perl -p -i -e ' s/\\i /i/g ' tmp.txt +perl -p -i -e ' s/\\i/i/g ' tmp.txt +perl -p -i -e " s/\\\'{i}/i/g " tmp.txt +perl -p -i -e ' s/\\"{i}/i/g ' tmp.txt +perl -p -i -e ' s/\\c {c}/c/g ' tmp.txt + +% \end{macrocode} +% We also remove \LaTeX\ text formatting commands (such as \verb+\textit+, \verb+\textbf+,, etc), simple math symbols ($\sim$, $\mu$ for instance; this list is to be customized depending on the proceedings data) and remove backquotes (\verb+\+): +% \begin{macrocode} +#echo " " +#echo "__ removed textit, texbf, {, }: __" +perl -p -i -e ' s/\--/-/g ' tmp.txt +perl -p -i -e " s/\\ss/ss/g " tmp.txt +perl -p -i -e ' s/\\textsuperscript //g ' tmp.txt +perl -p -i -e " s/\\&/&/g " tmp.txt +perl -p -i -e ' s/\\mu/mu\:/g ' tmp.txt +perl -p -i -e ' s/\\sim\s//g ' tmp.txt +perl -p -i -e ' s/\\sim//g ' tmp.txt +perl -p -i -e ' s/\s:/:/g ' tmp.txt + +perl -p -i -e ' s/\$//g ' tmp.txt +perl -p -i -e " s/textit //g " tmp.txt +perl -p -i -e " s/textbf //g " tmp.txt +% \end{macrocode} +% We finally remove other left-overs \LaTeX\ text formatting commands only at the end (such as \verb+{+, \verb+}+, etc), and accents reminders (\verb+'+, \verb+`+, \verb+"+, etc): +% \begin{macrocode} +perl -p -i -e " s/\{//g " tmp.txt +perl -p -i -e " s/\}//g " tmp.txt +perl -p -i -e ' s/\`\`/"/g ' tmp.txt +perl -p -i -e " s/\'\'/\"/g " tmp.txt + +#echo " " +#echo "__ removed \: ___" +perl -pi -e 's/\\//g' tmp.txt +perl -pi -e 's/\s{2,10}\{\}/ /g' tmp.txt +perl -pi -e 's/\s{2,10}/ /g' tmp.txt + +cp tmp.txt $outputfile +% +% \end{macrocode} % % -%^^A ================================================================= -% \subsection{Some considerations on bibliographies} % % %^^A ================================================================= -% \subsubsection{Which bib styles for the templates?} +% \subsection{\file{paperssplitpreamble.sh}: Preamble of \file{papersplit.sh}}\label{sec:scripts:paperssplitpreamble} % -% Concerning the paper bibliography style, each conference has its own style, often derived from other ones. For instance, the DAFx-06 templates were using the \package{IEEEbib.bst} style. It however is quite old (1993), and not as compact as the latest \package{IEEEtran.bst}. As the DAFx proceedings use the order of appearance and not alphabetical sorting (as do the IEEE publications it was inspired from), the more recent \package{IEEEtranS.bst} style was not suited. The DAFx-06 templates were corrected so as to use \package{IEEEtran.bst} instead of \package{IEEEbib.bst} before insertion of papers into the proceedings. +% \begin{description} +% \item[Name] \file{paperssplitpreamble.sh} +% \item[Type] Unix/bash script preamble +% \item[Purpose] preamble for the \file{paperssplit.sh} script, that is generated by running \file{exportIndividualPDFs.sh} +% \item[Note] it is not meant to be directly used by the user. +% \end{description} +% +% \color{black} % %^^A ================================================================= -% \subsubsection{Which bib styles for the general bibliography?} +%^^A Here is the creation of the paperssplitpreamble.sh script file, part of the example. +%^^A It is written on first LaTeX run if it does not already exist +%^^A ================================================================= % -% Concerning the general bibliography, the style may be a bit different, as it does not need any numbering. Moreover, we want alphabetical sorting this time, in order to simplify the search for any particular author cited. Therefore, we need to use another bibliographic style than the paper templates one! +% We set macros from the script arguments (path, \TeX\ file name without extension, +% paper info folder, split PDFs folder, PDF proceedings folder): +%\changes{0.6}{\datevzdsix}{added \file{paperssplitpreamble.sh}} +% \begin{macrocode} +%<*paperssplitpreamble> +#!/bin/bash + +args=("$@") +GPATH=${args[0]} +TEXFILE=${args[1]} # example1 +INPATH=${args[2]} # papers_info +SPPATH=${args[3]} #papers_split +PDFPATH=${args[4]} + +cd ${GPATH} +SPPATH=${GPATH}/${SPPATH} +PDFFILE=${GPATH}/${TEXFILE}.pdf # PDF proceedings +echo "PDF proc used for individual PDFs extraction:\n --> $PDFFILE" +echo "saving tmp .ps and .pdf files into\n --> $SPPATH" +% +% \end{macrocode} % -% The style to use has to look more like APA style, with the first author's last name coming first. For that reason, we used the \package{newapa} style, and derived the \package{newapave} style with minor cosmetic tweaking (those styles have no numbering, the author list is like ``Lastname, F.'', etc). +% \color{black} % -%^^A ================================================================= -% \subsubsection{Right-flushing the biblio back-references} % -% Usually, the back-references provided by the \package{hyperref} package are a list of numbers that follow the end of the bibliographic items (after the last dot). For instance in the example using the \package{newapa} bibliographic style, one would obtain:\\ % -% \begin{center} -% \begin{minipage}[c]{9cm} -% \vspace*{-0.2cm}Arfib, D. (1998). Different ways to write digital audio effects programs. -% In {\em Proc. of the COST-G6 Workshop on Digital Audio Effects (DAFx-98)}, -% Barcelona, Spain, (pp. 188--91). \color{blue}6, 11, 16, 22, 29 \color{black} -% \end{minipage} -% \end{center} % -% We modified the \package{newapa.bst} (resp. \package{newapa.sty}) file by making slight changes (but in many places), and renamed it \package{newapave.bst} (resp. \package{newapave.sty}) for the DAFx-06 proceedings. This modification process was carried out to provide some changes and adjustements in the bibliography style and layout (no parenthesis around page numbers nor around the year; and year is placed at the end), as well as right-flushed back-references. Using the \package{newapa} bibliographic style, the previous example is then modified in:\\ % -% \begin{center} -% \begin{minipage}[c]{9cm} -% \vspace*{-0.2cm}Arfib, D. Different ways to write digital audio effects programs. -% In {\em Proc. of the COST-G6 Workshop on Digital Audio Effects (DAFx-98)}, -% Barcelona, Spain, pp. 188--91. 1998. \hfill \color{blue}6, 11, 16, 22, 29\color{black} -% \end{minipage} -% \end{center} +%\changes{0.6}{\datevzsix}{Scripts: Unix \file{papersinfo.sh} script added} +%\changes{0.6}{\datevzsix}{Scripts: Unix \file{papers\_split\_preamble.sh} script added} +%^^A ================================================================= +% \subsection{\file{papersinfo.sh}: Generate individual PDFs with proper metadata}\label{sec:pdftk:add:PDF:metadata} % -% With the color links, it is visually easier to see the back-references when they are right-flushed that when they are left-flushed. If you wanted to apply the right-flushed back-references to another style, here is the only trick to keep from the hack. -% Edit the function that displays the last item of the bibliographic element list (\package{output.year.check} in our case, because it was reformatted) so as to add a \package{$\backslash$hfill} at the end of that command (the year definition in our example):\begin{verbatim} -%FUNCTION {output.year.check} -%{ year empty$ -% { ``empty year in `` cite$ * warning$ } -% { write$ -% `` (" year * extra.label * ``)" * -% mid.sentence 'output.state := -% } -% if$ -%} -%\end{verbatim} +% \begin{description} +% \item[Name] \file{papersinfo.sh} +% \item[Type] Unix/bash script +% \item[Purpose] adds proper metadata to each paper +% \item[Dependencies] \file{removeLaTeXcmds.sh} and working \file{pdftk} +% \item[Note] to be used once individual papers have been exported from the whole PDF proceedings. +% \end{description} % -% {\bf Important note}: if the last displayed item (in our case, the year) was not in last position, you also need to edit the following functions defined under the \verb+FUNCTION {name}+ format (not exhaustive list): \verb+article+, \verb+book+, \verb+booklet+, \verb+inbook+, \verb+incollection+, \verb+inproceedings+, \verb+manual+, \verb+masterthesis+, \verb+misc+, \verb+phdthesis+, \verb+proceedings+, \verb+techreport+, and \verb+unpublished+. -% For instance:\begin{verbatim} -%FUNCTION {misc} -%{ output.bibitem -% format.authors output -% author format.key output % added -% output.year.check % added -% title howpublished new.block.checkb -% format.title output -% new.block -% howpublished output -% new.block -% note output -% fin.entry -%\end{verbatim} was replaced with:\begin{verbatim} -%FUNCTION {misc} -%{ output.bibitem -% format.authors output -% author format.key output -% title howpublished new.block.checkb -% format.title output -% new.block -% howpublished output -% new.block -% note output -% output.year.check % moved -% fin.entry -%\end{verbatim} -% The Unix \verb+diff+ command may help you to compare the original (\package{newapa.bst}) and modified (\package{newapave.bst}) versions of the bibliography style files. +% \color{black} % %^^A ================================================================= -% \subsubsection{Ensuring that the biblio back-references are right-flushed} -% -% With this hack in the bibliography style, all bibliography back-references should appear as right-flushed. However, it sometimes does not work, due to some \LaTeX{} formatting mechanisms I am not competent to identify. Then, sometimes, a list of numbers will see its last item appearing alone on next line, even though there obviously was enough space on the previous line where the other numbers appear. I noticed that some minor reformatting of the concerned bibliographic item could solve this issue. There is no way to automatically do this, nor general rule, only a few tricks I found efficient to solve this issue in 6 items of the DAFx-06 proceedings: +%^^A Here is the creation of the papersinfo.sh script file, part of the example. +%^^A It is written on first LaTeX run if it does not already exist +%^^A ================================================================= +% \begin{macrocode} +%<*papersinfo> +#!/bin/bash + +% \end{macrocode} +% We first get the script arguments, which are in the order: +% \begin{macrocode} +args=("$@") +% \end{macrocode} % \begin{itemize} -% \item moving from optional to compulsory a bib item field; %^^A (such as the proceedings volume number for a proceedings paper); -% \item replacing a \verb+---+ by a \verb+--+ (arg! so ugly...); -% \item adding a missing space (\eg{} between the thesis number and the URL); -% \item using hyphenation at your advantage: you may sometimes get a reference for which the layout will not hyphen the end of the title, just before the last line (this is the reason I suspect to mess the whole process behind the \verb+\hfill+ command). +% \item[1.] the folder where individual PDFs are stored: % \end{itemize} -% -% -%^^A ================================================================= -% \subsection{Quality and production} -% -% We present here some other ideas dealing with the production and the quality of the proceedings. Indeed, to provide the best possible quality proceedings, you may have to edit the individual papers (see sec. \ref{sec:misc:editing}), which can be simplified by sending notes to authors before they submit the final version (see sec. \ref{sec:misc:notes}). You may also want to use only \LaTeX, which may require to convert all Word files to \LaTeX\ when the proceedings templates are provided in the 2 formats to authors (see sec. \ref{sec:misc:word2latex}). The last comments are about the graphical quality (sec. \ref{sec:misc:graph:quality}) and the necessary font embedding in the PDF images (see sec. \ref{sec:misc:images:fonts}). -% -% -%^^A------------------------------------------------------------------------ -% \subsubsection{Editing the papers}\label{sec:misc:editing} -% -% For each paper, we checked: +% \begin{macrocode} +GPATH=${args[0]} #= ~/proceedings/e-proceedings +% \end{macrocode} % \begin{itemize} -% \item proper use of US letter instead of A4 format; -% \item title has a \verb+\break+ at the right place; -% \item affiliation type chosen is the good one and has the minimal size; -% \item affiliation is properly layed out; -% \item author's email exists and works; -% \item captions are italic, with a ``.'' at the end; -% \item all figures are referenced in the text; -% \item bibliographic items have a volume and number, as well as page number or preprint number (AES convention); -% \item bibliographic items are using generally defined strings, so as to be identical each time they are cited; -% \item math units: Physics convention is roman, not italic (\ie{} not LaTeX's math style). Ex: $5$ Hz, and not $5Hz$. +% \item[2.] the finished proceedings (PDF file, without extension): % \end{itemize} -% -% \noindent So as to ensure a uniform look, we changed for all papers: +% \begin{macrocode} +TEXFILE=${args[1]} #= ICMC2009_proceedings +% \end{macrocode} % \begin{itemize} -% \item the URL font to sans-serif, as its default font is too wide. We added the following command in the preamble of each paper:\\ -% \verb+\usepackage{url}\urlstyle{sf}+ -% \item all \verb+\href{}{}+ commands related to URL (\ie{} all except emails) where converted to URL, as it is more apropriated (it does the hyphenations for you and most of the time it does it better). +% \item[3.] the folder where \file{pdftk} information files are stored (same as in \file{buildprocelpb.sh}): % \end{itemize} -% -% \noindent Some not-so-minor comments: +% \begin{macrocode} +INPATH=${args[2]} #= papers_info +% \end{macrocode} % \begin{itemize} -% \item the only way to do a valid line breaks (with the \file{dafx06.sty} style) in the paper title was not with \verb+\newline+, nor \verb+\\+, but with the \verb+\break+ command (we also noticed that using \verb+\linebreak+ creates unbalanced titles). That way, it works similarly for both the title and the pdftitle in metadata. -% \item using the \package{balance.sty} package allows to well balance the last page, which is especially useful for the bibliography. +% \item[4.] the folder (same as in \file{buildprocelpb.sh}) where are stored individual \file{pdf} files (obtained from splitting the proceedings): % \end{itemize} +% \begin{macrocode} +SPPATH=${args[3]} #= papers_split +% \end{macrocode} +% \begin{itemize} +% \item[5.] the folder where final individual \file{pdf} files with proper PDF metadata will be stored: +% \end{itemize} +% \begin{macrocode} +PDFPATH=${args[4]} #= ~/proceedings/e-proceedings +% \end{macrocode} +% \begin{itemize} +% \item[6.] the folder where individual \file{.pdftk} files were generated by \LaTeX{} (ex: \file{pdtk\_info/}): +% \end{itemize} +% \begin{macrocode} +PDFTKPATH=${args[5]} #= ~/pdftk_info + +% \end{macrocode} +% Let's go! We build the proceedings file name, and list individual PDF files: +% \begin{macrocode} +PDFFILE=${TEXFILE}.pdf # for use in the paper_split.sh and paper_info.sh scripts + +cd ${GPATH}/${SPPATH} +filelist=`ls *.pdf` +mkdir ${PDFPATH} + +% \end{macrocode} +% Then, for each PDF file: +% \begin{macrocode} +cd ${GPATH} +chmod +x removeLaTeXcmds.sh + +for file in $filelist +do + base=${file%%.*} +% \end{macrocode} +% \begin{itemize} +% \item remove \LaTeX{} commands (and accents) from the \file{pdftk} information files generated by the \LaTeX{} run with the \Lopt{pdftk=true} option: +% \end{itemize} +% \begin{macrocode} + echo "removing LaTeX accents: ${base}.pdftk -> ${base}_clean.info" +# echo "cmd: removeLaTeXcmds.sh ${GPATH} ${PDFTKPATH}/${base}.pdftk ${INPATH}/${base}_clean.info" + ${GPATH}/removeLaTeXcmds.sh ${GPATH} ${PDFTKPATH}/${base}.pdftk ${INPATH}/${base}_clean.info +% \end{macrocode} +% \begin{itemize} +% \item use \package{pdftk}\footnote{Get \package{pdftk} at: \url{http://www.accesspdf.com/pdftk/}}to update each \file{.pdf} file's info: +% \end{itemize} +% \begin{macrocode} + echo "adding PDF metadata: ${base}_clean.info -> ${base}.pdf" +# echo "cmd: pdftk ${SPPATH}/${base}.pdf update_info ${INPATH}/${base}_clean.info output ${PDFPATH}/${base}.pdf" + echo "pdftk ${GPATH}/${SPPATH}/${base}.pdf update_info ${GPATH}/${INPATH}/${base}_clean.info output ${PDFPATH}/${base}.pdf" + pdftk ${GPATH}/${SPPATH}/${base}.pdf update_info ${GPATH}/${INPATH}/${base}_clean.info output ${PDFPATH}/${base}.pdf +done +% +% \end{macrocode} % % -%^^A------------------------------------------------------------------------ -% \subsubsection{Improving the layout quality: Sending editing notes to authors}\label{sec:misc:notes} -% -% In order to improve the quality of the proceedings, we listed many common errors and gave a feedback to authors of all accepted papers. This is how we proceeded: -% \begin{enumerate} -% \item examine all papers and list the common errors and electronic paper info (PDF version, PDF generator, valid hyperref, etc) (10 h); -% \item create the full list of problems, in an \file{.csv} file, with papers' title, index and author's email (1/2 h); -% \item fill in, column by column, the data (30 h) with people's errors; -% \item write a Perl script to convert info in this file into usual sentences and indications of what to do in order to improve the paper quality (4 h); -% \item write an AppleScript converting this text file into a list of email texts, ready to be sent to authors (4 h). -% \end{enumerate} -% Those scripts are not provided in the package, but could be on popular demand. -% -% -%^^A------------------------------------------------------------------------ -% \subsubsection{Manual Word to \LaTeX\ conversion}\label{sec:misc:word2latex} -% -% If you really want to automatize all the processes in you proceedings making, you may want to get rid of non-\LaTeX\ generated documents. If you really cannot ask the conference authors to use \LaTeX, you will have to convert files by yourself. From our experience in DAFx-06, here are the steps to follow: -% \begin{enumerate} -% \item copy and paste the whole text; -% \item update the header (author, title, affiliation); -% \item add sections, subsections, etc. according to the original text; -% \item insert figures and tables with the proceedings template style; -% \item update captions with the proceedings template style; -% \item update labels and references for figures and tables; -% \item edit equations (inside the text and as separated formulae); -% \item update labels and references for equations ; -% \item update labels and references for sections, subsections, etc.; -% \item replace all Word quotes ^^A(double “”‟ and single ‛’ quotes) -% by \LaTeX\ quotes (double ``'', and single `' quotes) to avoid they disappear (Unicode-related issue); -% \item correct any specific formatting such as italic, capitals, bold, etc; -% \item remove useless hyphenations ``-'' produced as line breaks by Word; -% \item replace remaining hyphens by the proper corresponding one: hyphen `-', semi-quadratin `--' and quadratin `---'. -% \end{enumerate} -% -%^^A------------------------------------------------------------------------ -% \subsubsection{How to ensure the graphical quality?}\label{sec:misc:graph:quality} -% -% The best way to ensure excellent quality for you graphics in the electronic version of you proceedings consists in using vectorial images, \ie{} postscript (\file{.ps} or \file{.eps}) or \file{.pdf} files. It should be the same for the printed version, except that the font problem with Matlab described in sec. \ref{sec:misc:images:fonts} may imply to convert vectorial images to bitmap images (such as \file{.png} or \file{.gif}). -% +%^^A ================================================================= +% \subsection{\file{buildpapers.sh}: Re-compile all papers}\label{sec:scripts:buildpapers} % -%^^A------------------------------------------------------------------------ -% \subsubsection{How to ensure your fonts are embedded in the PDF?}\label{sec:misc:images:fonts} +% \begin{description} +% \item[Name] \file{buildpapers.sh} +% \item[Type] Unix/bash script +% \item[Purpose] run \LaTeX{} on each paper +% \item[Note] Useful if you need to make modifications to all papers; for instance to force each individual paper to have the same first page number as the one it has in the proceedings (for papers with page numbers included in the footer). +% \end{description} % -% With Matlab, the system fonts such as Arial or Helvetica are not embedded at all in the \file{.pdf} nor in the \file{.eps} file. This can be checked by converting any of the two into another format using Ghostscript. For instance, converting a \file{.pdf} to \file{.ps} using \file{pdf2ps} will show the following log info:\begin{verbatim} -% **** Warning: Fonts with Subtype = /TrueType should be embedded. -% The following fonts were not embedded: -% Arial-ItalicMT -% ArialMT +%^^A\changes{0.1d}{2007/08/01}{Adding the exbiblio.tex creation} +%^^A ================================================================= +%^^A Here is the creation of the buildpapers script file, part of the example. +%^^A It is written on first LaTeX run if it does not already exist +%^^A ================================================================= +% \begin{macrocode} +%<*buildpapers> +#!/bin/sh + +# Compile all papers with 'pdflatex' of 'latex' +# (depending if they are in 'sources_pdftex' or 'sources_tex') +# and copy resulting pdf files in the 'papers' folder. +# Expected tree structure: +# proceedings/papers/sources_pdftex/ +# proceedings/papers/sources_tex/ +# with this script in 'proceedings/' + +#--- choose if you compile from scratch or only once +#BUILD_TYPE=final #recompile and re-do biblio +BUILD_TYPE=renumber #recompile only once for re-numbering + +#--- set system dependent variables +LATEXPATH="/usr/texbin/" # TeXLive + +#--- paths +LATEX=$LATEXPATH"latex" +DVIPDF=/usr/local/bin/dvipdf +PDFLATEX=$LATEXPATH"pdflatex" +BIBTEX=$LATEXPATH"bibtex" +MAKEINDEX=$LATEXPATH"makeindex" +PROCSTY='dafx_06.sty' + +#--- Compiling .tex files with pdfLaTeX +cd papers/sources_pdftex +for i in *; do + echo; echo; echo '=====> Compiling' $i '.tex with pdfLaTeX <=====' + cd $i + # copy the paper style (in case you changed it) + cp ../../$PROCSTY . + echo; echo ' ---> 1st compilation of ' $i '.tex' + $PDFLATEX $i + if [ $BUILD_TYPE = final ]; then + echo; echo ' ---> Compiling the bibliography ' $i '.tex' + $BIBTEX $i + echo; echo ' --- 2nd compilation of ' $i '.tex' + $PDFLATEX $i + echo; echo ' ---> 3rd compilation of ' $i '.tex' + $PDFLATEX $i + fi + #--- copy the pdf where the proceedings will be assembled + cp $i.pdf ../.. + cd .. +done +#--- Compiling .tex files with LaTeX (problems related with hyperref) +cd ../sources_tex +for i in *; do + echo; echo; echo '=====> Compiling' $i '.tex with LaTeX <=====' + cd $i + #--- copy the paper proceedings style (if you changed the tree) + cp ../../$PROCSTY . + echo; echo ' ---> 1st compilation of ' $i '.tex ' + $LATEX $i.tex + if [ $BUILD_TYPE = final ]; then + echo; echo ' ---> Compiling the bibliography ' $i '.tex ' + $BIBTEX $i + echo; echo ' ---> 2nd compilation of ' $i '.tex ' + $LATEX $i + echo; echo ' ---> 3rd compilation of ' $i '.tex ' + $LATEX $i + fi + #--- produce the pdf from dvi + $DVIPDF $i.dvi $i.pdf + #--- copy the pdf where the proceedings will be assembled + cp $i.pdf ../.. + cd .. +done +% +% \end{macrocode} % -% **** This file had errors that were repaired or ignored. -% **** The file was produced by: -% **** >>>> pdfTeX-0.14h <<<< -% **** Please notify the author of the software that produced this -% **** file that it does not conform to Adobe's published PDF -% **** specification. -%\end{verbatim} -% You can check the same by processing a PDF files produced by Matlab using Acrobat Distiller (\$), and you will get the same errors.. % -% Therefore, when printing on a system that is not yours (and that may be the one you will use to print the proceedings), the printer may be set such as not to replace a missing font by a similar one. Then, Matlab text can be totally scrapped, replaced by other numbers, letters, and so on! +%^^A ================================================================= +% \subsection{\file{buildcppdfpapers.sh}: Copy all PDFs papers at the right place}\label{sec:scripts:buildcppdfpapers} % -% One first step of a solution was to use Acrobat Professional (\$), with the PitStop plug-ins (\$ again), and set is so as to create a report and solve problems concerning partially or not embedded fonts. Unfortunately, the problem is not exactly the font embedding, but the glyph table mapping that is wrong. % -% Another solution consists in converting the PDF files into a bitmap format. It is quite dirty, since it pixellizes a vectorial image, but at least, it is able to print! For instance, we converted {\file{.pdf} images with font problems into \file{.png} format, with a figure width of 8cm and a 600 dpi resolution (this seems too much resolution for printers, as 300 dpi may be enough), and it did the trick. +% \begin{description} +% \item[Name] \file{buildcppdfpapers.sh} +% \item[Type] Unix/bash script +% \item[Purpose] copies all PDF files at the right place (\ie{} in 'papers/') +% \item[Note] the previous Unix script already does it, but you may want to only copy the files, not re-run \LaTeX{} them. +% \end{description} % +%^^A\changes{0.1d}{2007/08/01}{Unix scripts: creating buildcppdfpapers.} +%^^A\changes{0.1f}{2007/08/03}{Unix scripts: cleanup for buildcppdfpapers.} +%^^A ================================================================= +%^^A Here is the creation of the buildcppdfpapers script file, part of the example. +%^^A It is written on first LaTeX run if it does not already exist +%^^A ================================================================= +% \begin{macrocode} +%<*buildcppdfpapers> +#!/bin/sh + +cd papers/sources_tex +for i in *; do + echo '*********' $i '*********' + cp $i/$i.pdf .. +done +cd ../sources_pdftex +for i in *; do + echo '*********' $i '*********' + cp $i/$i.pdf .. +done +% +% \end{macrocode} % -%^^A\changes{0.1c}{2007/07/30}{Customization: \file{confproc.cfg}} % % % % % -% \vspace*{2cm} -% It now seems that you have all the necessary files and information with a functional and complete example in order to produce you own conference proceedings! +% \newpage +% \section*{Conclusion and copyright} +% It now seems that you have all the necessary files, scripts and information with a series of working and complete examples, in order to produce your v own conference proceedings! +% Have fun using \package{\filename}!!! % %^^A\changes{0.1d}{2007/07/31}{Example: removing old code from previous example} -% Have fun using \package{\filename}!!! % %^^A ================================================================= %^^A We insert the `small print' here. %^^A ================================================================= -% {\vfill\hfill\scriptsize\package{\filename} is Copyright -% \copyright\ 2007 by Vincent Verfaille -% +% {\vfill\hfill\scriptsize\package{\filename} is Copyright \copyright\ 2010 by Vincent Verfaille +% % \vspace{1cm} % % There is no warranty for the \package{\filename}~package. I @@ -5333,7 +8605,7 @@ $PDFLATEX $TEXFILE.tex % of this license or (at your option) any later version. % % The latest version of this license is in -% \href{http://www.latex-project.org/lppl.txt}{\sf http://www.latex-project.org/lppl.txt} and version 1.2 or +% \href{http://www.latex-project.org/lppl.txt}{www.latex-project.org/lppl.txt} and version 1.2 or % later is part of all distributions of \LaTeX\ version 1999/12/01 % or later.}\par\newpage % @@ -5353,76 +8625,108 @@ $PDFLATEX $TEXFILE.tex %^^A We can't get enough! Of course we also want a bibliography ;-) %^^A ================================================================= % \addcontentsline{toc}{section}{References} +% {\small % \begin{thebibliography}{1} % % \bibitem{Pakin:2004:howto:package} -% Scott Pakin -% \newblock How to Package Your \LaTeX{} Package -% \newblock \ctan: \href{http://www.ctan.org/tex-archive/info/dtxtut/}{\sf www.ctan.org/tex-archive/info/dtxtut/}, November 2004. +% Scott Pakin. +% \newblock How to Package Your \LaTeX{} Package. +% \newblock \ctan: \href{http://www.ctan.org/tex-archive/info/dtxtut/}{\sf info/dtxtut/}. +% \newblock November 2004. Cited page % % \bibitem{LaTeX:class:writers} % The \LaTeX{}3 Project. % \newblock \LaTeX2e for class and package writers. -% \newblock \ctan: \href{http://tug.ctan.org/tex-archive/macros/latex/base/cls.dtx}{\sf macros/latex/base/cls.dtx}, March 1999. +% \newblock \ctan: \href{http://tug.ctan.org/tex-archive/macros/latex/base/cls.dtx}{\sf macros/latex/base/cls.dtx}. +% \newblock March 1999. Cited page % % \bibitem{mittelbach:1999:docstrip} % Frank Mittelbach, Denys Duchier, Johannes Braams, Marcin % Woli{\'{n}}ski, and Mark Wooding. % \newblock The {DocStrip} program. -% \newblock \ctan: \href{http://tug.ctan.org/tex-archive/macros/latex/base/docstrip.dtx}{\sf macros/latex/base/docstrip.dtx}, March 1999. +% \newblock \ctan: \href{http://tug.ctan.org/tex-archive/macros/latex/base/docstrip.dtx}{\sf macros/latex/base/docstrip.dtx}. +% \newblock March 1999. Cited page % % \bibitem{latex3-project:1999:lppl} % The~{\LaTeX}3 Project. % \newblock The {\LaTeX} {P}roject {P}ublic {L}icense. -% \newblock {\sc Url:} \href{http://www.latex-project.org/lppl.txt}{\sf www.latex-project.org/lppl.txt}, September 1999. +% \newblock {\sc Url:} \href{http://www.latex-project.org/lppl.txt}{\sf www.latex-project.org/lppl.txt}. +% \newblock September 1999. Cited page % % \bibitem{Brazil:2002} % Eoin Brazil. % \newblock Creating Conference Proceedings: Tips And Tricks From The Trenches. UL-IDC-02-03. -% \newblock {\sc Url:} \href{http://richie.idc.ul.ie/eoin/research/UL-IDC-02-03.pdf}{\sf richie.idc.ul.ie/eoin/research/UL-IDC-02-03.pdf}, -% \newblock Interactive Design Centre, University of Limerick, 2002. +% \newblock {\sc Url:} \href{http://richie.idc.ul.ie/eoin/research/UL-IDC-02-03.pdf}{\sf richie.idc.ul.ie/eoin/research/UL-IDC-02-03.pdf}. +% \newblock Interactive Design Centre, University of Limerick, 2002. Cited page % % \bibitem{mini:eConf} -% SLAC -% \newblock eConf: Full-Text Proceeding Instructions and Templates -% \newblock {\sc Url:} \href{http://www.slac.stanford.edu/econf/editors/fulltext-template/instructions.html}{\sf www.slac.stanford.edu/econf/editors/fulltext-template/instructions.html}, Retrieved on Sept. 2007 +% SLAC. +% \newblock eConf: Full-Text Proceeding Instructions and Templates. +% \newblock {\sc Url:} \href{http://www.slac.stanford.edu/econf/editors/fulltext-template/instructions.html}{\sf www.slac.stanford.edu/econf/editors/fulltext-template/instructions.html}. +% \newblock Retrieved on Sept. 2007. Cited page % % \bibitem{AMS:editor} -% American Mathematical Society -% \newblock Guide to AMS Editor's package -% \newblock {\sc Url:} \href{http://www.ams.org/authors/editpkg.html}{\sf www.ams.org/authors/editpkg.html}, Retrieved on Sept. 2007 +% American Mathematical Society. +% \newblock Guide to AMS Editor's package. +% \newblock {\sc Url:} \href{http://www.ams.org/authors/editpkg.html}{\sf www.ams.org/authors/editpkg.html}. +% \newblock Retrieved on Sept. 2007. Cited page % % \bibitem{Adobe:2007:Acrobat} % Adobe systems Inc. -% \newblock Acrobat Professional -% \newblock {\sc Url:} \href{http://www.adobe.com/products/acrobatpro/}{\sf www.adobe.com/products/acrobatpro/}, Retrieved on Sept. 2007. +% \newblock Acrobat Professional. +% \newblock {\sc Url:} \href{http://www.adobe.com/products/acrobatpro/}{\sf www.adobe.com/products/acrobatpro/} +% \newblock Retrieved on Sept. 2007. Cited page % % \bibitem{Wilson:2004:combine} % Peter Wilson. % \newblock The \package{combine} class and the \package{combinet}, \package{combnat} and \package{combcite} packages -% \newblock \ctan: \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/combine/}{\sf macros/latex/contrib/combine/}, March 2004. +% \newblock \ctan: \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/combine/}{\sf macros/latex/contrib/combine/}. +% \newblock March 2004. Cited page % -% \bibitem{hyperref} +% \bibitem{Oberdiek:2006:hyperref} % Sebastian Rahtz and Heiko Oberdiek. % \newblock The \package{hyperref} package. -% \newblock \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/contrib/hyperref/}{\sf macros/latex/contrib/hyperref/}, September 2006. +% \newblock \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/contrib/hyperref/}{\sf macros/latex/contrib/hyperref/}. +% \newblock September 2006. Cited page % % \bibitem{Matthias:2004:pdfpages} % Andreas Matthias. % \newblock The \package{pdfpages} package. -% \newblock \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/contrib/pdfpages/}{\sf macros/latex/contrib/pdfpages/}, 2004. +% \newblock \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/contrib/pdfpages/}{\sf macros/latex/contrib/pdfpages/}. +% \newblock 2004. Cited page +% +% \bibitem{Oberdiek:2009:kvoptions} +% Heiko Oberdiek. +% \newblock The \package{kvoptions} package. +% \newblock \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/contrib/oberdiek/kvoptions.pdf}{\sf macros/latex/contrib/oberdiek/kvoptions.pdf}. +% \newblock July 2009. Cited page +% +% \bibitem{Wright:2009:TUGboat:keyval} +% Joseph Wright and Christian Feuers\"anger. +% \newblock Implementing key--value input: An introduction. +% \newblock 1st draft: \href{http://www.texdev.net/wp-content/uploads/2009/03/keyval.pdf}{\sf www.texdev.net/wp-content/uploads/2009/03/keyval.pdf}. +% \newblock Vol.~30, Number~1, pp.110--122, 2009. Cited page % % \bibitem{Verfaille:2006:howto:web} % Vincent Verfaille. % \newblock How to make your own proceedings for another conference? -% \newblock {\sc Url:} \href{http://www.dafx.ca/dafx06_proceedings_diy.html}{\sf http://www.dafx.ca/dafx06\_proceedings\_diy.html}, October 2006. +% \newblock {\sc Url:} \href{http://www.dafx.ca/dafx06_proceedings_diy.html}{\sf www.dafx.ca/dafx06\_proceedings\_diy.html}. +% \newblock October 2006. Cited page % % \bibitem{Verfaille:2006:howto:confproc} % Vincent Verfaille. % \newblock Report on the making of the DAFx-06 proceedings. -% \newblock {\sc Url:} \href{http://www.dafx.ca/proceedings/report.pdf}{\sf http://www.dafx.ca/proceedings/report.pdf}, MUMT-SPCL-07-01 report, McGill University, March 2007. +% \newblock {\sc Url:} \href{http://www.dafx.ca/proceedings/report.pdf}{\sf www.dafx.ca/proceedings/report.pdf}. +% \newblock MUMT-SPCL-07-01 report, McGill University, March 2007. Cited page +% +% \bibitem{Verfaille:2007:PracTeX:confproc} +% Vincent Verfaille +% \newblock A new package for conference proceedings. +% \newblock The PracTeX Journal, Volume 4. +% \newblock {\sc Url}: \href{http://www.tug.org/pracjourn/2007-4/verfaille/verfaille.pdf}{\sf www.tug.org/pracjourn/2007-4/verfaille/verfaille.pdf}. +% \newblock November 2007. Cited page % -% \end{thebibliography} +% \end{thebibliography}} % %^^A\bibliography{confproc} %^^A\bibliographystyle{plain} @@ -5451,6 +8755,11 @@ $PDFLATEX $TEXFILE.tex % \let\PrintIndex=\relax % } ^^A end of \StopEventually % +% +% +% \color{black} +% +% %^^A\changes{0.1d}{2007/07/31}{Implementation: bug for creating class corrected} %^^A\changes{0.1d}{2007/07/31}{Implementation: moved into the document itself} %^^A ================================================================= @@ -5470,322 +8779,840 @@ $PDFLATEX $TEXFILE.tex % resist\ldots % %^^A ================================================================= -%^^A Initial initialization +%^^A Key=value options %^^A ================================================================= -% \subsection{Initialization} -% \label{subsec:init} +% \subsection{Key-value option management}\newvzdseven{} % -% As you can see, this package is based on the \package{book} package for all its layout aspects. -%^^A\changes{0.1g}{2007/08/06}{Doc: adding comments to the class code} +% We use the following two packages to manage the options with the \Lopt{key=value} format \cite{Oberdiek:2009:kvoptions,Wright:2009:TUGboat:keyval}:\changes{0.7}{2010/08/05}{Pkg: now uses \package{kvoptions} and \package{kvoptions-patch} packages to manage \package{\filename} package options as key/values} % \begin{macrocode} %<*package> -\LoadClass{book} +\RequirePackage{kvoptions} +\RequirePackage{kvoptions-patch} % \end{macrocode} -% +% as well as the \package{xifthen} package for simpler if/then tests (related to the option management):\changes{0.7}{2010/08/05}{Pkg: now uses \package{xifthen} package and \cmd{\ifthenelse} command to clarify code} +% \begin{macrocode} +\RequirePackage{xifthen} +% \end{macrocode} +% I know that next step is useless (it corresponds to the default values provided by \package{keyval} if no value is given)... but let's explicitly set the \package{keyval}-key to be used: +% \begin{macrocode} +\SetupKeyvalOptions{family=confproc,prefix=confproc@} +% \end{macrocode} +% and the \cmd{\confproc} command for managing key values: +% \begin{macrocode} +\newcommand*{\confproc}[1]{\setkeys{confproc}{#1}} +% \end{macrocode} +% +% %^^A\changes{0.2g}{2007/09/07}{Options: adding DescribeMacro for all} %^^A ================================================================= -%^^A Declaration of the options we want to provide +%^^A Declaration and management of the options we want to provide %^^A ================================================================= -% \subsection{Option declaration} -% \label{subsec:optiondeclare} +% \subsection{Options declaration}\label{subsec:optiondeclare}\label{sec:def:options:confproc} % -% \subsubsection{Options of the \package{book} package} % -% Right now, options about paper size and font sizes are used to set the document parameters. For paper size, only \DescribeMacro{a4paper}\Lopt{a4paper}: +%^^A------------------------------------------------------------------------ +% \subsubsection{Obsolete options} +% +% We then define pre-version 0.5 options that became obsolete (their name has changed or their functionality has disappeared): % \begin{macrocode} -\DeclareOption{a4paper} - {\setlength\paperheight {297mm}% - \setlength\paperwidth {210mm}% - \setlength\oddsidemargin {-4.95truemm}% - \setlength\evensidemargin {-10.95truemm}% - \def\shiftsafourpaper{}} +\DeclareStringOption{compil}{\PackageWarning{confproc}{Option % + "compil=bib*" ignored since v0.5; use "bib=*" instead of "compil=bib*"}} +\DeclareVoidOption{draft}{\PackageWarning{confproc}{Option "draft" % + ignored since v0.5; use "papers=draft" instead}} +\DeclareVoidOption{final}{\PackageWarning{confproc}{Option "final" % + ignored since v0.5; use "papers=final" instead}} +\DeclareVoidOption{tocnumleft}{\PackageWarning{confproc}{Option % + "tocnumleft" ignored since v0.5; use "tocnum=left" instead}} +\DeclareVoidOption{tocnumright}{\PackageWarning{confproc}{Option % + "tocnumright" ignored since v0.5; use "tocnum=right" instead}} +\DeclareVoidOption{cleardoublepage}{\PackageWarning{confproc}{Option % + "cleardoublepage" ignored since v0.5; use "twosidepapers" instead}} +\DeclareVoidOption{clearsinglepage}{\PackageWarning{confproc}{Option % + "clearsinglepage" ignored since v0.5; use "onesidepapers" instead}} % \end{macrocode} -% and \DescribeMacro{letterpaper}\Lopt{letterpaper}: +% +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Options of the \package{book} package} +% +% The usual font sizes and paper size options are used to set the document parameters. +% Right now, only three font sizes are supported\footnote{It still wonder how bigger/smaller font sizes could be useful for proceedings; so if you need it, please ask!}, namely 10pt\DescribeMacro{10pt}, 11pt\DescribeMacro{11pt}, and 12pt\DescribeMacro{12pt}): +% \begin{macrocode} +\DeclareVoidOption{10pt}{% + \expandafter\PassOptionsToPackage + \expandafter{\CurrentOption}{book}} +\DeclareVoidOption{11pt}{% + \expandafter\PassOptionsToPackage + \expandafter{\CurrentOption}{book}} +\DeclareVoidOption{12pt}{% + \expandafter\PassOptionsToPackage + \expandafter{\CurrentOption}{book}} +% \end{macrocode} +% For paper size, we define only the two usual ones for proceedings, namely \DescribeMacro{letterpaper}\Lopt{letterpaper}: % \begin{macrocode} -\DeclareOption{letterpaper} - {\setlength\paperheight {11in}% +\newif\if@proc@letterpaper +\DeclareVoidOption{letterpaper}{% + \@proc@letterpapertrue + \setlength\paperheight {11in}% \setlength\paperwidth {8.5in}% \setlength\oddsidemargin {-4.95truemm}% \setlength\evensidemargin {-4.95truemm}% - \def\shiftsletterpaper{}} + \def\shiftsletterpaper{}% + \PassOptionsToClass{\CurrentOption}{book}% + \PassOptionsToPackage{\CurrentOption}{hyperref}} % \end{macrocode} -% are defined. They are use to set the document and also passed to the book package. +% and \DescribeMacro{a4paper}\Lopt{a4paper}: % \begin{macrocode} -\PassOptionsToPackage{a4paper,letterpaper}{book} -\PassOptionsToPackage{a4paper,letterpaper}{hyperref} -% \end{macrocode} -% Only three font sizes are supported yet (namely 10pt\DescribeMacro{10pt,11pt,12pt}, 11pt and 12pt), as it did not seem obvious to me how bigger/smaller font sizes could be useful for proceedings. +\DeclareVoidOption{a4paper}{% + \@proc@letterpaperfalse + \setlength\paperheight {297mm}% + \setlength\paperwidth {210mm}% + \setlength\oddsidemargin {-4.95truemm}% + \setlength\evensidemargin {-10.95truemm}% + \def\shiftsafourpaper{}% + \PassOptionsToClass{\CurrentOption}{book}% + \PassOptionsToPackage{\CurrentOption}{hyperref}} +% \end{macrocode} +% They are used to set the document, and then passed to the \package{book} and \package{hyperref} packages. +% Both \DescribeMacro{oneside} \Lopt{oneside} and \DescribeMacro{twoside} \Lopt{twoside} options are re-defined as they were in the \package{book} package, and then passed to it: % \begin{macrocode} -\DeclareOption{10pt}{\renewcommand\@ptsize{0}} -\DeclareOption{11pt}{\renewcommand\@ptsize{1}} -\DeclareOption{12pt}{\renewcommand\@ptsize{2}} +\DeclareVoidOption{oneside}{\@twosidefalse \@mparswitchfalse% + \PassOptionsToPackage{\CurrentOption}{book}} +\DeclareVoidOption{twoside}{\@twosidetrue \@mparswitchtrue% + \PassOptionsToPackage{\CurrentOption}{book}} % \end{macrocode} -% Both \DescribeMacro{oneside} \Lopt{oneside} and \DescribeMacro{twoside} \Lopt{twoside} options are re-defined, exactly as they were in the book package: +% +%^^A\changes{0.2b}{2007/08/16}{Options: changing \Lopt{bibmergecompil} to 'compil=bibmerge', \Lopt{bibbackrefcompil} to 'compil=bibbackref' and \Lopt{finalcompil} to 'compil=final'} +%^^A\changes{0.2d}{2007/08/18}{Cmds: renaming all internal commands by adding the `conf\@' prefix} +%^^A\changes{0.2e}{2007/09/01}{Options: finishing the description of the class options} +%^^A------------------------------------------------------------------------ +%^^A \subsubsection{Declaration of \package{\filename}-specific options} +% +%^^A ------------------------------------------------------------------------------------------------------------------ +% \subsubsection{Proceedings-specific formatting options} +% +% We define a pair of complementary options (\LoptDescribe{twosidepapers} $\mid$ \LoptDescribe{onesidepapers}) that allow for a double/single page clear after each paper: % \begin{macrocode} -\DeclareOption{oneside}{\@twosidefalse \@mparswitchfalse% - \def\conf@WithClearsinglepage{}} -\DeclareOption{twoside}{\@twosidetrue \@mparswitchtrue% - \def\conf@WithCleardoublepage{}} -% \end{macrocode} -% Right now, they are not passed to the book package. -%^^A \begin{macrocode} -%^^A\PassOptionsToPackage{10pt,11pt,12pt,twoside,oneside}{book} -%^^A \end{macrocode} -% We define both \DescribeMacro{onesidepapers} \Lopt{onesidepapers} and \DescribeMacro{twosidepapers} \Lopt{twosidepapers} options, to allow or not for a double page clear after each paper (so that they all start on a right and odd page, as for chaters in a book): +\DeclareBoolOption[true]{twosidepapers} +\DeclareComplementaryOption{onesidepapers}{twosidepapers} +% \end{macrocode} +% +% \begin{macro}{papers} +% \changes{0.4f}{2007/10/7}{bug: \Lopt{draft} removes bookmarks} +% \changes{0.6}{2009/09/08}{\Lopt{draft} option replaced by \Lopt{draft} value for option \Lopt{papers}} +% The \Lopt{papers} option is a string defaulted to \Lopt{final}: % \begin{macrocode} -\DeclareOption{onesidepapers}{% - \def\conf@WithClearsinglepagePapers{}} -\DeclareOption{twosidepapers}{% - \def\conf@WithCleardoublepagePapers{}} +\DeclareStringOption[final]{papers} % \end{macrocode} +% that can have three values: \Lopt{empty} (very fast run, with faked insertion of user-selected pages by \package{confproc}, and without page existence check), \Lopt{draft} (not too slow run, with page existence check and faked insertion of user-selected pages by \package{pdfpages}), \Lopt{final} (slow run with real insertion of user-selected pages by \package{pdfpages}) and \Lopt{countpages} (slow run, with real insertion of all pages by \package{pdfpages}). +% \end{macro} % -% \subsubsection{Options passed to the \package{hyperref} package} +% \begin{macro}{electronic} +% The \Lopt{electronic} is a boolean defaulted to \Lopt{true}: +% \begin{macrocode} +\DeclareBoolOption[true]{electronic} +% \end{macrocode} +% (that generates an electronic document with color hyperlinks) +% \end{macro} +% \begin{macro}{printed} +% and \Lopt{printed} is declared as its complementary: +% \begin{macrocode} +\DeclareComplementaryOption{printed}{electronic} +% \end{macrocode} +% (and generates black color links). +% \end{macro} % -%^^A\changes{0.1i}{2007/08/10}{Options: no more re-definition of \package{hyperref} options: all options specific to the \package{hyperref} package are passed to it as unknown options of \package{\filename}.} -% In its very first version, the \package{\filename} package was passing the following \package{hyperrref}-specific options to it: \Lopt{colorlinks}, \Lopt{colorlinks} and \Lopt{colorlinks=true}, \Lopt{colorlinks=false}, \Lopt{linkcolor}, \Lopt{citecolor}, \Lopt{urlcolor}, \Lopt{pagecolor}, \Lopt{bookmarksopen}, \Lopt{bookmarksopen=true}, \Lopt{bookmarksopen=false}. Not knowing how to use the \package{keyval} package, I used a simple and dirty trick, re-defining and passing these options, but it was limitating the customization of \package{hyperref} to what I believed was useful. So, to remove this biais, I treat them as any unknown options, that are passed to the \package{hyperref} package. If you decide to use other options of \package{hyperref}, you may unfortunately break some of the mechanisms for the proceedings making. +% \begin{macro}{binding} +% \newvzdseven{}The \Lopt{binding} is a string defaulted to \Lopt{0mm}:\changes{0.7}{2010/08/05}{Pkg: added `binding=' option} +% \begin{macrocode} +\DeclareStringOption[0mm]{binding} +% \end{macrocode} +% it in facts defines a length used for the inner binding. +% \end{macro} +% +% \begin{macro}{headers} +% The \Lopt{headers} is a string defaulted to \Lopt{allpages}: +% \begin{macrocode} +\DeclareStringOption[allpages]{headers} +% \end{macrocode} +% It can take four values: \Lopt{headers=no} to add no headers on any page, \Lopt{headers=pdfonly} to add headers on PDF papers only, \Lopt{headers=exceptpdf} to add headers on all pages except the inserted PDFs, and \Lopt{headers=allpages} to add headers on all pages. +% \end{macro} +% +% \begin{macro}{bib} +% \newvzdseven{}The \Lopt{bib} is a string defaulted to \Lopt{none}: +% \begin{macrocode} +\DeclareStringOption[none]{bib} +% \end{macrocode} +% that indicates the general bibliography status (four values): \Lopt{bib=none}, \Lopt{bib=merge} (merging process, only 1st and last page are inserted), \Lopt{bib=backref} (generating proper back-references: citations still appear in green in the last page's header) and \Lopt{bib=final} (removing last page's citation, but also breaking back-references in next \LaTeX{} runs). +% \end{macro} +% +%^^A ------------------------------------------------------------------------------------------------------------------ +% \subsubsection{List of inserted papers} +% +% \begin{macro}{paperselec} +% \newvzdseven{}The \Lopt{paperselec} is a string defaulted to \Lopt{all}: +% \begin{macrocode} +\DeclareStringOption[all]{paperselec} +% \end{macrocode} +% \end{macro} % -%^^A\changes{0.2b}{2007/08/16}{Options: changing \Lopt{bibmergecompil} to 'compil=bibmerge', \Lopt{bibbackrefcompil} to 'compil=bibbackref' and \Lopt{finalcompil} to 'compil=final'} -%^^A\changes{0.2d}{2007/08/18}{Cmds: renaming all internal commands by adding the `conf\@' prefix} -%^^A\changes{0.2e}{2007/09/01}{Options: finishing the description of the class options} -%^^A ================================================================= -% \subsubsection{Options specific to the \package{\filename} package}\label{sec:def:options:confproc} +%^^A ------------------------------------------------------------------------------------------------------------------ +% \subsubsection{Lists formatting} % -% \subsubsection*{Compilation step:} changes the page numbering and the speed of the \LaTeX\ run. -% For working on the bibliography merging process with \Lopt{compil=bibmerge}\DescribeMacro{compil=bibmerge}: +% \begin{macro}{twocoltoc} +%^^A\changes{0.1i}{2007/08/10}{Options: adding \Lopt{onecoltoc} and \Lopt{twocoltoc} options} +% The \Lopt{twocoltoc} is a boolean defaulted to \Lopt{false}: % \begin{macrocode} -\DeclareOption{compil=bibmerge} - {\typeout{confproc: LaTeX run-> bib. items only (merging process)}% - \def\conf@BibMerge{}} +\DeclareBoolOption[false]{twocoltoc} % \end{macrocode} -% The \Lopt{compil=bibbackref} \DescribeMacro{compil=bibbackref} option is to be used to create proper index and table of contents page numbering, as well as back-references: +% that allows to produce a 2-columns table of contents. +% \end{macro} +% +% \begin{macro}{onecoltoc} +% The \Lopt{onecoltoc} is its complementary: % \begin{macrocode} -\DeclareOption{compil=bibbackref} - {\typeout{confproc: LaTeX run-> generating biblio back references}% - \def\conf@BibBackRef{}} +\DeclareComplementaryOption{onecoltoc}{twocoltoc} % \end{macrocode} -% The compilation option \Lopt{compil=last} \DescribeMacro{compil=last} option is to be used at last (when all proper page numbers and back references have been generated): +% used to produce a usual 1-column table of contents. +% \end{macro} +% +% \begin{macro}{tocnum} +% The \Lopt{tocnum} is a string defaulted to \Lopt{left}: % \begin{macrocode} -\DeclareOption{compil=last} - {\typeout{!!! confproc: LaTeX run-> LAST !!!}% - \def\conf@FinalVersion{}} +\DeclareStringOption[left]{tocnum} % \end{macrocode} +% that allows to place TOC numbers either on the left or the right side. +% \end{macro} % -% \subsubsection*{Draft/final} -% \begin{macro}{draft} -% \changes{0.4f}{2007/10/7}{Explain that the `draft' option removes the bookmarks} -% The \Lopt{draft} option is passed to the \package{pdfpages} package to speed up \LaTeX\ runs: +% \begin{macro}{twocolbib} +%^^A\changes{0.2c}{2007/08/17}{Options: adding \Lopt{onecolbib} and \Lopt{twocolbib} options} +% The \Lopt{twocolbib} is a boolean defaulted to \Lopt{true}: % \begin{macrocode} -\DeclareOption{draft} - {\typeout{confproc: not including PDF files}% - \PassOptionsToPackage{draft}{pdfpages}% - \def\conf@DoNotIncludePDFs{}} +\DeclareBoolOption[true]{twocolbib} % \end{macrocode} -% Note that with this option, \package{pdfpages} does not generate the bookmark data. \end{macro} -% The \Lopt{final} \DescribeMacro{final} option too is passed to the \package{pdfpages} package (no speed up of \LaTeX\ runs): +% that produces either a tow- or a one-column(s) general bibliography. +% \end{macro} +% +% \begin{macro}{onecolbib} +% The \Lopt{onecolbib} is its complementary: % \begin{macrocode} -\DeclareOption{final} - {\typeout{confproc: including PDF files}% - \PassOptionsToPackage{final}{pdfpages}% - \def\conf@IncludePDFs{}} +\DeclareComplementaryOption{onecolbib}{twocolbib} % \end{macrocode} +% \end{macro} % -% \subsubsection*{Electronic/printed} -% For an electronic document (color hyperlinks), we define the \Lopt{electronic} \DescribeMacro{electronic} option: +% \begin{macro}{twocolindex} +% The \Lopt{twocolindex} is a boolean defaulted to \Lopt{true}: % \begin{macrocode} -\DeclareOption{electronic}% - {\typeout{confproc: adding colors for hyperlinks}% - \PassOptionsToPackage{colorlinks=true}{hyperref}% - \def\conf@procWithColors{}} +\DeclareBoolOption[true]{twocolindex} % \end{macrocode} -% For a printed document (black hyperlinks), we define the \Lopt{printed} \DescribeMacro{printed} option: +% that provides a 2-columns index of authors. +% \end{macro} +% +% \begin{macro}{threecolindex} +% The \Lopt{threecolindex} is its complementary: % \begin{macrocode} -\DeclareOption{printed}% - {\typeout{confproc: hyperref with no color for hyperlinks} - \PassOptionsToPackage{colorlinks=false}{hyperref}% - \def\conf@procWithoutColors{}} +\DeclareComplementaryOption{threecolindex}{twocolindex} % \end{macrocode} +% and therefore provides a 3-columns index of authors. +% \end{macro} +% +%^^A ------------------------------------------------------------------------------------------------------------------ +% \subsubsection{Help for checking data and layout} % -% \subsubsection*{Headers} -% We define four options for adding headers on some specific pages only:\\ -% on no page with the \Lopt{headers=no} \DescribeMacro{headers=no} option (default): +% \begin{macro}{checktitle} +% The \Lopt{checktitle} is a boolean defaulted to \Lopt{false}:\changes{0.7}{2010/08/05}{new option that superimposes each paper's title in color (for proofchecking)} % \begin{macrocode} -\DeclareOption{headers=no}% - {\typeout{confproc: no fancy headers}% - \def\conf@NoFancyHeaders{}} +\DeclareBoolOption[false]{checktitle} % \end{macrocode} -% on inserted PDFs only with the \Lopt{headers=pdfonly} \DescribeMacro{headers=pdfonly} option: +% \end{macro} +% +% \begin{macro}{checkauthor} +% The \Lopt{checkauthor} is a string defaulted to \Lopt{false}:\changes{0.7}{2010/08/05}{new option that superimposes each paper's author list in color (for proofchecking)} % \begin{macrocode} -\DeclareOption{headers=pdfonly}% - {\typeout{confproc: fancy headers on inserted PDFs only}% - \def\conf@FancyHeadersOnPapers{}} +\DeclareBoolOption[false]{checkauthor} % \end{macrocode} -% on all pages except the inserted PDFs, with the \Lopt{headers=exceptpdf} \DescribeMacro{headers=exceptpdf} option: +% \end{macro} +% +% \begin{macro}{colorheaders} +% The \Lopt{colorheaders} is a string defaulted to \Lopt{black}:\changes{0.7}{2010/08/05}{new option used to set the headers/footers color (for proofchecking)} % \begin{macrocode} -\DeclareOption{headers=exceptpdf}% - {\typeout{confproc: fancy headers for all pages except PDFs}% - \def\conf@FancyHeadersExceptPapers{}} +\DeclareStringOption[black]{colorheaders} % \end{macrocode} -% and on all pages with the \Lopt{headers=allpages} \DescribeMacro{headers=allpages} option: +% \end{macro} +% +% \begin{macro}{showmarginlines} +% The \Lopt{showmarginlines} is a boolean defaulted to \Lopt{false}:\changes{0.7}{2010/08/05}{new option used to add left, right, up and down margin lines with colors (for layout checking)} % \begin{macrocode} -\DeclareOption{headers=allpages}% - {\typeout{confproc: fancy headers on all pages, PDFs included}% - \def\conf@FancyHeadersOnPapers{}% - \def\conf@FancyHeadersExceptPapers{}} +\DeclareBoolOption[false]{showmarginlines} % \end{macrocode} +% \end{macro} % -% \subsubsection*{Two/three columns index of authors} -% The \Lopt{twocolindex} \DescribeMacro{twocolindex} option provides a 2 columns index of authors: +% \begin{macro}{showpapernumber} +% The \Lopt{showpapernumber} is a boolean defaulted to \Lopt{false}:\changes{0.7}{2010/08/05}{new option that adds each paper's page number (for proofchecking)} % \begin{macrocode} -\DeclareOption{twocolindex} - {\typeout{confproc: 2 columns index}% - \def\conf@TwoColumnIndex{}} +\DeclareBoolOption[false]{showpapernumber} % \end{macrocode} -% whereas the \Lopt{threecolindex} \DescribeMacro{threecolindex} provides a 3 column index of authors (default): +% \end{macro} +% +% \begin{macro}{movepagenumber} +% The \Lopt{movepagenumber} is a boolean defaulted to \Lopt{false}:\changes{0.7}{2010/08/05}{new option that moves down each paper's page number added with \Lopt{showpapernumber} (for proofchecking)} % \begin{macrocode} -\DeclareOption{threecolindex} - {\typeout{confproc: 3 columns index}% - \def\conf@ThreeColumnIndex{}} +\DeclareBoolOption[false]{movepagenumber} % \end{macrocode} -%^^A\changes{0.2c}{2007/08/17}{Options: adding \Lopt{onecolbib} and \Lopt{twocolbib} options} +% that is used to move the footer in order to check page numbers, when the PDF papers already have a page number before insertion. +% \end{macro} +% +%^^A ------------------------------------------------------------------------------------------------------------------ +% \subsubsection{Verbose and \package{pdftk} options} % -% \subsubsection*{One/two columns general bibliography} -% The \Lopt{twocolbib} \DescribeMacro{twocolbib} option provides a 2 columns bibliography (default): +% \begin{macro}{debug} +%^^A\changes{0.2b}{2007/08/16}{Options: adding the \Lopt{debug} option} +% The \Lopt{debug} is a boolean defaulted to \Lopt{false}: +% \changes{0.7}{2010/08/05}{now for the developer (differents from and complements \Lopt{verbose})} % \begin{macrocode} -\DeclareOption{twocolbib} - {\typeout{confproc: 2 columns biblio}% - \def\conf@TwoColumnBib{}} +\DeclareBoolOption[false]{debug} % \end{macrocode} -% whereas the \Lopt{onecolbib} \DescribeMacro{onecolbib} option provides a 1 column bibliography: +% \end{macro} +% +% \begin{macro}{verbose} +%^^A\changes{0.2a}{2007/08/12}{Options: adding the \Lopt{verbose} option} +% The \Lopt{verbose} is a boolean defaulted to \Lopt{false}: +% \changes{0.7}{2010/08/05}{now for the user; all purpose (differs from and complements \Lopt{debug})} % \begin{macrocode} -\DeclareOption{onecolbib} - {\typeout{confproc: 1 column biblio}% - \def\conf@OneColumnBib{}} +\DeclareBoolOption[false]{verbose} % \end{macrocode} +% \end{macro} % -%^^A\changes{0.1i}{2007/08/10}{Options: adding \Lopt{onecoltoc} and \Lopt{twocoltoc} options} -% \subsubsection*{One/two columns table of contents} -% The \Lopt{twocoltoc} \DescribeMacro{twocoltoc} option provides a 2 columns table of contents: +% \begin{macro}{pdftk} +% The \Lopt{pdftk} is a boolean defaulted to \Lopt{false}:\changes{0.7}{2010/08/05}{option added to generate individual \file{.pdftk} instructions for each paper} % \begin{macrocode} -\DeclareOption{twocoltoc} - {\typeout{confproc: 2 columns TOC}% - \def\conf@TwoColumnTOC{}} +\DeclareBoolOption[false]{pdftk} % \end{macrocode} -% whereas the \Lopt{onecoltoc} \DescribeMacro{onecoltoc} option provides a usual 1 column table of contents (default): +% \end{macro} +% When used, it allows to generate bash commands (in a file with \file{.pdftk} extension) that will call \package{pdftk}\footnote{Get \package{pdftk} at: \url{http://www.accesspdf.com/pdftk/}} to set the \file{.pdf} file's author, subject and producer/creator, and save thse data in a temporary folder for future use +% \begin{macro}{pdftksubject} +% The \Lopt{pdftkfolder} is a string that indicates the (temporary) folder into which individual \file{.pdftk} files are writtne. Note that\margindanger{} the folder has to exist prior to run \LaTeX{}, otherwise error will be displayed: % \begin{macrocode} -\DeclareOption{onecoltoc} - {\typeout{confproc: 1 column TOC}% - \def\conf@OneColumnTOC{}} +\DeclareStringOption[.]{pdftkfolder} % \end{macrocode} -% -% \subsubsection*{Numbering the table of contents} -% the table of contents can be numbered on the left using the \Lopt{tocnumleft} \DescribeMacro{tocnumleft} option: +% \end{macro} +% \begin{macro}{pdftksubject} +% The \Lopt{pdftksubject} is a string that indicates the PDF subject to \package{pdftk}: % \begin{macrocode} -\DeclareOption{tocnumleft} - {\typeout{confproc: TOC numbering on left}% - \def\conf@TocNumberingLeft{}} +\DeclareStringOption[Conference]{pdftksubject} % \end{macrocode} -% or on the right using the \Lopt{tocnumright} \DescribeMacro{tocnumright} option: +% \end{macro} +% \begin{macro}{pdftkproducer} +% The \Lopt{pdftkproducer} is a string that indicates the PDF creator (ie.~the program generating the new PDF) to \package{pdftk}: % \begin{macrocode} -\DeclareOption{tocnumright} - {\typeout{Confproc: TOC numbering on right}% - \def\conf@TocNumberingRight{}} +\DeclareStringOption[pdftk 1.12 + Ghostscript 8.71]{pdftkproducer} % \end{macrocode} -% -% \subsubsection*{Moving footer with page number} -% Move the footer (to check page numbers) with the \Lopt{movepagenumbers} \DescribeMacro{movepagenumbers} option: +% \end{macro} +% \begin{macro}{pdftkcreator} +% The \Lopt{pdftkcreator} is a string that indicates the PDF creator (ie.~the program that initially created the PDF) to \package{pdftk}: % \begin{macrocode} -\DeclareOption{movepagenumbers} - {\typeout{confproc: moving page numbers to check PDFs numbering}% - \def \conf@TestPageNumbering{}} +\DeclareStringOption[LaTeX2e + confproc 0.7]{pdftkcreator} % \end{macrocode} +% \end{macro} +% +% +%^^A ------------------------------------------------------------------------------------------------------------------ +% \subsubsection{Options passed to \package{hyperref} and \package{geometry}} % -% \subsubsection*{Clearpage} clear single or double page, depending if the document is oneside or twoside, with the \Lopt{clearsinglepage} \DescribeMacro{clearsinglepage} and \Lopt{cleardoublepage} \DescribeMacro{cleardoublepage} options: \\ -%^^A \color{red} {\sc Is this still useful???}\color{black}\\ +% \begin{macro}{hyperref} +% The \Lopt{hyperref} is a string: % \begin{macrocode} -\DeclareOption{cleardoublepage}% - {\typeout{confproc: using double page clearing}% - \def\conf@WithCleardoublepage{}} -\DeclareOption{clearsinglepage}% - {\typeout{confproc: using double page clearing}% - \def\conf@WithClearsinglepage{}} -% \end{macrocode} -% Define \Lopt{debug} \DescribeMacro{debug,verbose} and \Lopt{verbose} options to print debug (\package{\filename} and \package{hyperref}): -%^^A\changes{0.2a}{2007/08/12}{Options: adding the \Lopt{verbose} option} -%^^A\changes{0.2b}{2007/08/16}{Options: adding the \Lopt{debug} option} -% \begin{macrocode} -\DeclareOption{debug} - {\typeout{Confproc: printing debug for confproc, hyperref}% - \PassOptionsToPackage{debug}{hyperref}% - \def\conf@procWithDebug{}} -\DeclareOption{verbose} - {\typeout{Confproc: printing debug for confproc, hyperref}% - \PassOptionsToPackage{debug}{hyperref}% - \def\conf@procWithDebug{}} -% \end{macrocode} -% We are now done with the options declarations. +\DeclareStringOption{hyperref}[] +\DeclareStringOption{geometry}[] +\DeclareStringOption{afterhyperref}[] +\DeclareStringOption{beforehyperref}[] +% \end{macrocode} +% \end{macro} % -%^^A ================================================================= -% \subsection{Options processing} % -%^^A ================================================================= -% \subsubsection{Unknown options} +%^^A------------------------------------------------------------------------ +% \subsubsection{Unknown options: passed to the \package{hyperref} package} +% +%^^A\changes{0.1i}{2007/08/10}{Options: no more re-definition of \package{hyperref} options: all options specific to the \package{hyperref} package are passed to it as unknown options of \package{\filename}.} +% In its very first version (0.1i), the \package{\filename} package was passing the following \package{hyperrref}-specific options to it: \Lopt{colorlinks}, \Lopt{colorlinks} and \Lopt{colorlinks=true}, \Lopt{colorlinks=false}, \Lopt{linkcolor}, \Lopt{citecolor}, \Lopt{urlcolor}, \Lopt{pagecolor}, \Lopt{bookmarksopen}, \Lopt{bookmarksopen=true}, \Lopt{bookmarksopen=false}. Not knowing how to use the \package{keyval} package, I used a simple and dirty trick, re-defining and passing these options, but it was limitating the customization of \package{hyperref} to what I believed was useful. To remove this biais, versions 0.2 to 0.5 treated them as any unknown options, that were passed to the \package{hyperref} package. +% \margindanger{}\newvzdseven{} While this behavior is still true, \emph{it will be discontinued in the next versions, so please refrain to using it.} % -% Give a warning for unknown options, and pass them by default to \package{hyperref}: +% We print a warning message for unknown options, and pass them to \package{hyperref}: %^^A\changes{0.1i}{2007/08/10}{Options: passing all unknown options to \package{hyperref}, to avoid redefining all link colors, etc.} % \begin{macrocode} -\DeclareOption*{\PackageWarning{procconf}% - {Unknown option `\CurrentOption'; passed to 'hyperref'}% - \PassOptionsToClass{\CurrentOption}{hyperref}} +\DeclareDefaultOption{\PackageWarning{confproc}{Unknown % + option `\CurrentOption'; passed to 'hyperref'}% + \PassOptionsToClass{\CurrentOption}{hyperref}} % \end{macrocode} % +% +% %^^A ================================================================= +% \subsection{Options processing} +% +%^^A------------------------------------------------------------------------ % \subsubsection{Default values for options} % -% Options that are not set by the user have the following default settings: +% When not set by the user, options have the following default settings: %^^A\changes{0.1i}{2007/08/10}{Option: changing default link colors for \package{hyperref}} -% \begin{macrocode} -\ExecuteOptions{letterpaper,10pt,twoside,% - twosidepapers,electronic,headers=no,compil=bibbackref,% - tocnumleft,onecoltoc,threecolindex,twocolbib,% - colorlinks=true,linkcolor=red,citecolor=blue,pagecolor=red,urlcolor=blue,% - bookmarksopen=true,bookmarksopenlevel=1} +% \changes{0.7}{2010/08/05}{changed the package default option set (simpler examples)} +% \begin{macrocode} +\ExecuteOptions{letterpaper,10pt,twoside,twosidepapers,% + electronic,binding=0mm,papers=final,paperselec=all,headers=allpages,% + onecoltoc,tocnum=left,threecolindex,twocolbib,bib=none,% + checktitle=false,checkauthor=false,showmarginlines=false,% + showpapernumber=false,movepagenumber=false,colorheaders=black,% + verbose=false,debug=false,pdftk=false,% +% beforehyperref={},afterhyperref={},% + hyperref={colorlinks=true,linkcolor=red,citecolor=blue,urlcolor=blue,% + bookmarksopen=true,bookmarksopenlevel=1}% + geometry={text={6.9in,9in},% + inner=0.8in,top=1in,bottom=1in,% + headsep=7.05mm,footskip=10mm,voffset=-5mm}} % \end{macrocode} % -%^^A ================================================================= +%^^A------------------------------------------------------------------------ % \subsubsection{Options processing} % -% Options can now be processed: +% Options can now be processed thatnks to \package{kvoptions}: % \begin{macrocode} -\ProcessOptions +\ProcessKeyvalOptions* +% \end{macrocode} +% +% +% +%^^A ================================================================= +% \subsection{Application of option values}\label{sec:option:apply} +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Package information messages and option settings} +% +% The \Lopt{electronic} version only makes use of visible hyper-references (clickable links): +% \begin{macrocode} +\ifconfproc@electronic% + \PassOptionsToPackage{colorlinks=true}{hyperref}% + \PackageInfo{confproc}{use color links with hyperref}% +\else + \PassOptionsToPackage{colorlinks=false}{hyperref}% + \PackageInfo{confproc}{does not use color links with hyperref}% +\fi + +% \end{macrocode} +% The \Lopt{binding} option manages the binding length for both the \package{geometry} package and paper insertion with \package{pdfpages}: +% \begin{macrocode} +\newlength{\proc@binding} +\ifthenelse% + {\equal{\confproc@binding}{}} + {\setlength{\proc@binding}{0mm} + \PackageInfo{confproc}{setting binding to default (0mm)}} + {\setlength{\proc@binding}{\confproc@binding} + \PackageInfo{confproc}{setting binding to \confproc@binding}} + +% \end{macrocode} +% With \Lopt{papers=}, papers are inserted either normally from page 1 to a user-defined value: +% \begin{macrocode} +\newif\if@proc@IncludePDFs +% \end{macrocode} +% replaced from page 1 to a user-defined value: +% \begin{macrocode} +\newif\if@proc@ReplacePDFs +% \end{macrocode} +% or fully inserted (discarding the user-defined paper number of pages): +% \begin{macrocode} +\newif\if@proc@IncludeFullPDFs +% \end{macrocode} +% We define a new file into which the number of pages will be counted: +% \begin{macrocode} +\newwrite\npagesfile +% \end{macrocode} +% For \Lopt{papers=empty}, papers are replaced by a \package{\filename}-specific layout:\changes{0.7}{2010/08/05}{Pkg: new \Lopt{empty} value for \Lopt{papers} option (not using \package{pdfpages})} +% \begin{macrocode} +\ifthenelse% + {\equal{\confproc@papers}{empty}}% + {\PackageInfo{confproc}{replacing PDF files by information pages}% + \@proc@ReplacePDFstrue + \@proc@IncludeFullPDFsfalse + \@proc@IncludePDFsfalse + \immediate\openout\npagesfile=\jobname.nps} + {\ifthenelse% +% \end{macrocode} +% For \Lopt{papers=draft}, papers are replaced by a \package{pdfpages}-specific layout (also called \Lopt{draft}): +% \begin{macrocode} + {\equal{\confproc@papers}{draft}}% + {\PackageInfo{confproc}{not including PDF files with 'pdfpages'}% + \PassOptionsToPackage{draft}{pdfpages}% + \@proc@ReplacePDFsfalse + \@proc@IncludeFullPDFsfalse + \@proc@IncludePDFsfalse + \immediate\openout\npagesfile=\jobname.nps} +% \end{macrocode} +% For \Lopt{papers=final}, papers are normally inserted from page 1 to the user-defined number of pages: +% \begin{macrocode} + {\ifthenelse% + {\equal{\confproc@papers}{final}} + {\PackageInfo{confproc}{including PDF files with 'pdfpages'}% + \PassOptionsToPackage{final}{pdfpages}% + \@proc@ReplacePDFsfalse + \@proc@IncludeFullPDFsfalse + \@proc@IncludePDFstrue + \immediate\openout\npagesfile=\jobname.nps} +% \end{macrocode} +% For \Lopt{papers=countpages}, papers are fully inserted, discarding the user-defined number of pages: +% \begin{macrocode} + {\ifthenelse% + {\equal{\confproc@papers}{countpages}} + {\PackageInfo{confproc}{counting each paper's number of % + pages by including all its pages} +% \PassOptionsToPackage{draft}{pdfpages} + \@proc@ReplacePDFsfalse + \@proc@IncludeFullPDFstrue + \@proc@IncludePDFsfalse + \immediate\openout\npagesfile=\jobname.npc} +% \end{macrocode} +% In case of unknown value for \Lopt{papers=}, the default is to insert papers using \Lopt{papers=final}: +% \begin{macrocode} + {\PackageWarning{confproc}{unknown option % + `papers=\confproc@papers' ; using `papers=final'}% + \@proc@ReplacePDFsfalse{} + \@proc@IncludeFullPDFsfalse + \@proc@IncludePDFstrue + \immediate\openout\npagesfile=\jobname.nps} + } + } + } + +% \end{macrocode} +% To manage fancy headers, we need two new ifs so as to process differently pages with papers and pages without papers. +% \begin{macrocode} +\newif\if@proc@FancyHeadersOnPapers +\newif\if@proc@FancyHeadersExceptPapers +% \end{macrocode} +% For \Lopt{headers=none}, no headers/footers are added: +% \begin{macrocode} +\ifthenelse% + {\equal{\confproc@headers}{none}} + {\PackageInfo{confproc}{no headers}% + \@proc@FancyHeadersOnPapersfalse + \@proc@FancyHeadersExceptPapersfalse} +% \end{macrocode} +% For \Lopt{headers=pdfonly}, headers/footers are only added to inserted PDFs: +% \begin{macrocode} + {\ifthenelse% + {\equal{\confproc@headers}{pdfonly}} + {\PackageInfo{confproc}{headers on inserted PDFs only}% + \@proc@FancyHeadersOnPaperstrue + \@proc@FancyHeadersExceptPapersfalse} +% \end{macrocode} +% For \Lopt{headers=exceptpd}, headers/footers are added to all pages but inserted PDFs: +% \begin{macrocode} + {\ifthenelse% + {\equal{\confproc@headers}{exceptpdf}} + {\PackageInfo{confproc}{headers for all pages except PDFs}% + \@proc@FancyHeadersOnPapersfalse + \@proc@FancyHeadersExceptPaperstrue} +% \end{macrocode} +% For \Lopt{headers=allpages}, headers/footers are added to all pages including inserted PDF: +% \begin{macrocode} + {\ifthenelse% + {\equal{\confproc@headers}{allpages}} + {\PackageInfo{confproc}{headers on all pages, PDFs included}% + \@proc@FancyHeadersOnPaperstrue + \@proc@FancyHeadersExceptPaperstrue} + {\PackageWarning{confproc}{unknown % + 'headers=\confproc@headers' option (using 'headers=allpages')}} + } + } + } + +% \end{macrocode} +% To manage the general bibliography, we need two new ifs: one for the existence of the general bibliography and one for the appearance of the bibliographic items at the last page of each paper's header. +% \begin{macrocode} +\newif\if@proc@BibNone +\newif\if@proc@BibRemoveCiteHdr +% \end{macrocode} +% For \Lopt{bib=merge}, each paper is replaced by its first and last page only, where the bibliography is displayed: +% \begin{macrocode} +\ifthenelse% + {\equal{\confproc@bib}{merge}}% + {\PackageInfo{confproc}{bib: display 1st+last page of each paper}% + \@proc@BibNonefalse% + \def\conf@BibMerge{}% + \@proc@BibRemoveCiteHdrfalse}% +% \end{macrocode} +% For \Lopt{bib=backref}, each paper is inserted as defined by the user, and back-references appear on the last page (upper left, in green): +% \begin{macrocode} + {\ifthenelse% + {\equal{\confproc@bib}{backref}}% + {\PackageInfo{confproc}{bib: displays back references}% + \@proc@BibNonefalse% + \def\conf@BibBackRef{}% + \@proc@BibRemoveCiteHdrfalse}% +% \end{macrocode} +% For \Lopt{bib=final}, each paper is inserted as defined by the user, and back-references do not more appear (which means they are broken on successive \LaTeX{} runs): +% \begin{macrocode} + {\ifthenelse% + {\equal{\confproc@bib}{final}}% + {\PackageInfo{confproc}{bib: hide bib items using `nocite'}% + \@proc@BibNonefalse% + \@proc@BibRemoveCiteHdrtrue}% % \end{macrocode} +% For \Lopt{bib=none}, no bibliography is displayed at the end of the proceedings: +% \begin{macrocode} + {\PackageInfo{confproc}{bibliography: none}% + \@proc@BibNonetrue}% + }% + } +%\confproc@bib\@empty +% \typeout{confproc/bibliography: no setting for "bib="! 5 +% Please use one of: none, backref, merge of final.}% +% \end{macrocode}\changes{0.7}{2010/08/05}{Pkg: now uses \cmd{\PackageInfo} and \cmd{\PackageWarning} for proper package info and warnings} +% \begin{macro}{\proccite} +% \newvzdseven{}We define the \cmd{\confcite} citation function that can be changed depending on the citation function used by the chosen bibliography style: +% \begin{macrocode} +\if@proc@BibRemoveCiteHdr + \newcommand{\confcite}[1]{\nocite{#1}} + \PackageInfo{confproc}{removing citations (with nocite{*}): % + next run should be the last (will loose hyperlinks)} +\else \newcommand{\confcite}[1]{\cite{#1}} +\fi +% \end{macrocode} +% \end{macro} +% To manage the left or right numbergin of the table of contents, we need a new if: +% \begin{macrocode} +\newif\if@proc@TocNumberingRight +\ifthenelse% + {\equal{\confproc@tocnum}{left}}% + {\PackageInfo{confproc}{TOC numbering on left}% + \@proc@TocNumberingRightfalse} + {\ifthenelse% + {\equal{\confproc@tocnum}{right}}% + {\PackageInfo{confproc}{TOC numbering on right}% + \@proc@TocNumberingRighttrue} + {\PackageWarning{confproc}{unknown tocnum=\confproc@tocnum % + (using 'right' instead)}% + \@proc@TocNumberingRighttrue} + } + +% \end{macrocode} +% Then come various options for checking the document layout and content. When willing to check spelling errors in the papers' author list: +% \begin{macrocode} +\ifconfproc@checkauthor + \PackageInfo{confproc}{add 'author list' field on the paper's 1st page}% +\else \PackageInfo{confproc}{do not add author list}% +\fi +% \end{macrocode} +% and in the paper titles: +% \begin{macrocode} +\ifconfproc@checktitle + \PackageInfo{confproc}{add title field on the paper's 1st page}% +\else \PackageInfo{confproc}{do not add title}% +\fi +% \end{macrocode} +% We also show margin lines: +% \begin{macrocode} +\ifconfproc@showmarginlines + \PackageInfo{confproc}{show margin lines to check template-complience}% +\else \PackageInfo{confproc}{do not show margin lines}% +\fi +% \end{macrocode} +% add the paper number (useful when not using the \Lopt{papers=empty} option): +% \begin{macrocode} +\ifconfproc@showpapernumber + \PackageInfo{confproc}{add paper number below page number}% +\else \PackageInfo{confproc}{do not add paper number below page number}% +\fi + +% \end{macrocode} +% With the \Lopt{twosidepapers} option, papers always start on the right side (like book chapters): +% \begin{macrocode} +\ifconfproc@twosidepapers + \PackageInfo{confproc}{papers opening on right (odd) side} +\else + \PackageInfo{confproc}{papers opening on any side} +\fi + +% \end{macrocode} +% With the \Lopt{verbose} option, more information about paper insertion is provided to the user: +% \begin{macrocode} +\newif\if@proc@verbose +\@proc@verbosefalse +\ifconfproc@verbose + \@proc@verbosetrue + \PackageInfo{confproc}{verbose mode turned on} +\else \PackageInfo{confproc}{verbose mode turned off} +\fi +% \end{macrocode} +% With the \Lopt{debug} option, even more information is provided to the class developer: +% \begin{macrocode} +\ifconfproc@debug + \@proc@verbosefalse + \PackageInfo{confproc}{verbose mode turned off and debug turned on} + \PassOptionsToPackage{debug}{hyperref} +\else \PackageInfo{confproc}{debug mode turned on} +\fi +% \end{macrocode} +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Package information messages and option settings} +% +% We pass options to specific packages, possibly overwriting previous settings: +% \changes{0.7}{2010/08/05}{Pkg: (New) \package{hyperref} option to directly pass options to \package{hyperref} package} +% \changes{0.7}{2010/08/05}{Pkg: (New) \package{geometry} option to directly pass options to \package{geometry} package} +% \begin{macrocode} +\PassOptionsToPackage{\confproc@hyperref}{hyperref} +\PassOptionsToPackage{\confproc@geometry}{geometry} +% \end{macrocode} +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Print option values (hard debug mode)} +% +%^^A\changes{0.7}{2010/08/05}{Options: \Lopt{verbose} defaulted to \Lopt{false}} +% \newvzdseven{}With the \Lopt{verbose=true} option, all option values and defaults are printed in the \file{.log} file and window: +% \begin{macrocode} +\ifconfproc@verbose + \typeout{________________} + \if@proc@letterpaper + \typeout{| | Document formatting:} + \typeout{| | ____ letterpaper} + \else + \typeout{| | Document formatting:} + \typeout{| | ____ a4paper} + \fi + \iffalse\@twoside \typeout{| | ____ twoside=false (=oneside)} + \else \typeout{| | ____ twoside=true} + \fi + \ifconfproc@twosidepapers \typeout{| | ____ twosidepapers=true} + \else \typeout{| | twosidepapers=false (=onesidepaper)} + \fi + \typeout{| | Proceedings-specific formatting:} + \ifconfproc@electronic \typeout{| | ____ electronic=true (file version)} + \else \typeout{| | ____ electronic=false (printed)} + \fi + \typeout{| | ____ binding=\confproc@binding (for printed version)} + \typeout{| | ____ papers=\confproc@papers (paper insertion)} + \typeout{| | ____ headers=\confproc@headers (header add to pages)} + + \typeout{| | List of papers:} + \typeout{| | ____ paperselec=\confproc@paperselec} + + \typeout{| | Lists (toc, bib, index):} + \ifconfproc@twocoltoc \typeout{| | ____ twocoltoc=true} + \else \typeout{| | ____ twocoltoc=false (=onecoltoc)} + \fi + \ifthenelse{\equal{\confproc@tocnum}{left}}% + {\typeout{| | ____ tocnum=left}} + {\typeout{| | ____ tocnum=right}} + \ifconfproc@twocolbib \typeout{| | ____ twocolbib=true} + \else \typeout{| | ____ twocolbib=false (=onecolbib)} + \fi + \typeout{| | ____ bib=\confproc@bib} + \ifconfproc@twocolindex \typeout{| | ____ twocolindex=true} + \else \typeout{| | ____ twocolindex=false (=threecolindex)} + \fi + + \typeout{| | Help for layout design:} + \ifconfproc@checkauthor + \typeout{| | ____ checkauthor=true (add author list to 1st page)} + \else + \typeout{| | ____ checkauthor=false (do not add author list to 1st page)} + \fi + \ifconfproc@checktitle + \typeout{| | ____ checktitle=true (add title to 1st page)} + \else + \typeout{| | ____ checktitle=false (do not add title to 1st page)} + \fi + + \ifconfproc@showpapernumber + \typeout{| | ____ showpapernumber=true (add paper number)} + \else + \typeout{| | ____ showpapernumber=false (do not add paper number)} + \fi + \ifconfproc@movepagenumber + \typeout{| | ____ movepagenumber=true (move paper number for checking)} + \else + \typeout{| | ____ movepagenumber=false (do not move paper number)} + \fi + \ifconfproc@showmarginlines + \typeout{| | ____ showmarginlines=true (add template format)} + \else + \typeout{| | ____ showmarginlines=false (do not add template format)} + \fi + \typeout{| | ____ colorheaders=\confproc@colorheaders (color for header/footer)} + + \typeout{| | Verbose:} + \ifconfproc@debug \typeout{| | ____ debug=true (for hyperref)} + \else \typeout{| | ____ debug=false (for hyperref)} + \fi + \ifconfproc@verbose \typeout{| | ____ verbose=true (for confproc+hyperref)} + \else \typeout{| | ____ verbose=false (for confproc+hyperref)} + \fi + \ifconfproc@pdftk + \typeout{| | ____ pdftk=true (for use with pdftk to add PDF metadata)} + \typeout{| | ____ pdftkfolder=\confproc@pdftkfolder (folder where .pdftk files are saved)} + \typeout{| | ____ pdftksubject=\confproc@pdftksubject (subject for individual PDF metadata)} + \typeout{| | ____ pdftkproducer=\confproc@pdftkproducer (producer for individual PDF metadata)} + \typeout{| | ____ pdftkcreator=\confproc@pdftkcreator (creator for individual PDF metadata)} + \else \typeout{| | ____ pdftk=false (for use with pdftk to add PDF metadata)} + \fi + \typeout{| | passed to hyperref: \confproc@hyperref} + \typeout{| | passed to geometry: \confproc@geometry} + \typeout{________________} + \typeout{ } +\fi +% \end{macrocode} +% With the \Lopt{pdftk=true} option, we also generate a general \file{.pdftk} file containing ann \file{pdftk} commands: +% \begin{macrocode} +\ifconfproc@pdftk + \newwrite\pdftkinfoall + \immediate\openout\pdftkinfoall=\jobname.pdftk + \newwrite\pdftkinfofile +\fi +% \end{macrocode} +% +% +% +%^^A ================================================================= +%^^A Initial initialization +%^^A ================================================================= +% \subsection{Initialization} +% \label{subsec:init} +% +% As you can see, this package is based on the \package{book} package for all its layout aspects. +%^^A\changes{0.1g}{2007/08/06}{Doc: adding comments to the class code} +% \begin{macrocode} +\LoadClass[10pt,letterpaper]{book} +% \end{macrocode} +% +% +% %^^A ================================================================= % \subsection{Required packages} % % Several packages are included, among which many are required. \\ -% The \package{graphicx} package is for users to insert logos (first page, welcome letters): +% Use \package{graphicx} to insert logos (first page, welcome letters): % \begin{macrocode} \RequirePackage{graphicx} % \end{macrocode} -% Use the \package{pdfpages} package (core of this class) to insert the paers as PDF documents, page-by-page, as images: +% Use \package{pdfpages} (core of this class) to insert individual papers as PDF documents, page-by-page: % \begin{macrocode} \RequirePackage{pdfpages} % \end{macrocode} -% Use the \package{fancyhdr} package to customize the headers and footers so that they match those of the paper templates: +% Use \package{fancyhdr} to customize the headers and footers (for instance so that they match those of the paper templates): % \begin{macrocode} \RequirePackage{fancyhdr} % \end{macrocode} -% Use the \package{tocbibind} package to change the \cmd{\indexname} command; its options are to disable automatic insertion in the table of contents (hand made insertion instead): +% Use \package{tocbibind} to change the \cmd{\indexname} command; its options disable the automatic insertion in the table of contents (hand made insertion instead): % \begin{macrocode} \RequirePackage[nottoc,notbib,notindex]{tocbibind} % \end{macrocode} -% Use the \package{titletoc} package (part of the \package{titelsec} package) to change the table of contents layout (order of text, numbers, fonts, etc.): +% Use \package{titletoc} (part of the \package{titelsec} package) to change the table of contents layout (order of text, numbers, fonts, etc.): % \begin{macrocode} -\RequirePackage{titletoc} +\RequirePackage[rightlabels]{titletoc} % \end{macrocode} % Use \package{multitoc} with the \Lopt{toc} option for a two columns table of contents: %^^A\changes{0.1i}{2007/08/10}{Options: adding \Lopt{onecoltoc} and \Lopt{twocoltoc} options} % \begin{macrocode} -\ifdefined\conf@TwoColumnTOC +\ifconfproc@twocoltoc \RequirePackage[toc]{multitoc} \fi % \end{macrocode} @@ -5799,10 +9626,10 @@ $PDFLATEX $TEXFILE.tex % \begin{macrocode} \RequirePackage{multicol} % \end{macrocode} -% \begin{macro}{\theindex} -% Also, when asking for a 2 or 3 columns index, redefine the \cmd{\theindex} environment (modified form the \package{gatech-thesis-index.sty} package) as: +% \begin{macro}{\theindex} +% Also, when asking for a 2 or 3 columns index, redefine the \cmd{\theindex} environment (modified from the \package{gatech-thesis-index.sty} package) as: % \begin{macrocode} -\ifdefined\conf@TwoColumnIndex +\ifconfproc@twocolindex \renewenvironment{theindex}{% \if@twocolumn \@restonecolfalse \else \@restonecoltrue \fi @@ -5822,7 +9649,6 @@ $PDFLATEX $TEXFILE.tex \if@restonecol \onecolumn \else \clearpage \fi} \else - \ifdefined\conf@ThreeColumnIndex% \renewenvironment{theindex}{% \if@twocolumn \@restonecolfalse \else \@restonecoltrue \fi @@ -5841,20 +9667,13 @@ $PDFLATEX $TEXFILE.tex }{\end{multicols}% \if@restonecol \onecolumn \else \clearpage \fi } - \fi \fi % \end{macrocode} -% \end{macro} +% \end{macro} % Use the \package{sectsy} package to change the sections font in the table of contents: % \begin{macrocode} \RequirePackage{sectsty} % \end{macrocode} -% \begin{macro}{\confcite} -% We define the \cmd{\confcite} citation function, that can be changed depending on the citation function used by the chosen bibliography style: -% \begin{macrocode} -\newcommand{\confcite}[1]{\cite{#1}} -% \end{macrocode} -% \end{macro} % Use the \package{newapave} style for the general bibliography: % \begin{macrocode} \RequirePackage{newapave} @@ -5875,42 +9694,47 @@ $PDFLATEX $TEXFILE.tex % \end{macrocode} % together with the \package{hyperref} package with the following default options: % \begin{macrocode} +%\confproc@beforehyperref{} %^^A TODO: not functioning yet \RequirePackage[pdftex,raiselinks,hyperindex,backref,pagebackref,% plainpages=false,pdfpagelabels,breaklinks,linktocpage,% pdfstartview=XYZ]{hyperref} +%\confproc@afterhyperref{} %^^A TODO: not functioning yet % \end{macrocode} -% and with the \package{hypcap} package, for including floats (figures or tables): +% and with the \package{bookmark} package: % \begin{macrocode} -\RequirePackage[figure,table]{hypcap} +%%\RequirePackage[figure,table]{hypcap} +\RequirePackage{bookmark} % \end{macrocode} % +% %^^A ================================================================= % \subsection{Proceedings specific commands} % % We now define the default values of some proceedings-specific commands. % -%^^A ================================================================= +%^^A------------------------------------------------------------------------ % \subsubsection{PDF metadata} % -% \begin{macro}{\procpdfauthor} +% \begin{macro}{\procpdfauthor} % Define commands to set the PDF metadata: \cmd{\procpdfauthor} for the author: % \begin{macrocode} -\newcommand{\procpdfauthor}{Proceedings author/editor} +\newcommand{\procpdfauthor}{[Proceedings author/editor]} % \end{macrocode} -% \end{macro} -% \begin{macro}{\procpdftitle} +% \end{macro} +% \begin{macro}{\procpdftitle} % \cmd{\procpdftitle} for the title: % \begin{macrocode} -\newcommand{\procpdftitle}{Proceedings title} +\newcommand{\procpdftitle}{[Proceedings title]} % \end{macrocode} -% \end{macro} -% \begin{macro}{\procpdfsubject} +% \end{macro} +% \begin{macro}{\procpdfsubject} % and \cmd{\procpdfsubject} for the subject: % \begin{macrocode} -\newcommand{\procpdfsubject}{Proceedings description} +\newcommand{\procpdfsubject}{[Proceedings short title] % + ([Proceedings Acronym]), [City], [Country], [Dates]} % \end{macrocode} -% \end{macro} -% \begin{macro}{\hypersetup} +% \end{macro} +% \begin{macro}{\hypersetup} % These commands are used in the \cmd{\hypersetup} command that is evaluated only when the document begins (so that you can redefine its author, title and subject): % \changes{0.4b}{2007/10/12}{Only evaluated At Begin Document} % \begin{macrocode} @@ -5920,683 +9744,689 @@ $PDFLATEX $TEXFILE.tex pdftitle = \procpdftitle, pdfsubject = \procpdfsubject, pdfkeywords = {}, - pdfcreator = {LaTeX with `confproc' package}, + pdfcreator = {LaTeX + confproc v0.7}, pdfproducer = {pdfLaTeX}}} % \end{macrocode} -% \end{macro} +% \end{macro} % % \changes{0.4b}{2007/10/12}{Layout: set \cmd{\footskip}} -%^^A ================================================================= -% \subsubsection{Page layout} +% \changes{0.6}{2009/09/08}{Layout: all commands replaced by use of \texttt{geometry} package} +%^^A------------------------------------------------------------------------ +% \subsubsection{Page layout with \package{geometry}} % -% The proceedings default page layout is: +% The proceedings default page layout is defined thanks to \package{geometry}: % \begin{macrocode} -\topmargin 0truept -\headheight 12truept -\footskip 14mm -\textheight 229truemm -\textwidth 175truemm -\voffset -28truept -\headsep 20truept +\iffalse\@twoside + \usepackage[bindingoffset=\proc@binding]{geometry} +\else% + \usepackage[twoside,bindingoffset=\proc@binding]{geometry} +\fi % \end{macrocode} % Those values may be changed in the preamble, depending on your paper template. % -%^^A ================================================================= +%^^A------------------------------------------------------------------------ % \subsubsection{Special section names} % -% \begin{macro}{\contentsname} +% \begin{macro}{\contentsname} % We redefine the names of the table of contents (as it should appear in itself): % \begin{macrocode} \renewcommand{\contentsname}{Conference Program} % \end{macrocode} -% \end{macro} -% \begin{macro}{\bibname} -% of the general bibliography as it appears in the document and in the table of contents: +% \end{macro} +% \begin{macro}{\bibname} +% the general bibliography as it appears in the document and in the table of contents: %^^A\changes{0.1g}{2007/08/05}{\cmd{\bibnametoc} renamed \cmd{\procbibname}} -% \changes{0.4a}{2007/10/01}{Remove formatting} -% \changes{0.4a}{2007/10/01}{Renamed from \cmd{\procbibname}} +% \changes{0.4a}{2007/10/01}{remove formatting} +% \changes{0.4a}{2007/10/01}{renamed from \cmd{\procbibname}} % \begin{macrocode} \renewcommand{\bibname}{Full Bibliography} % \end{macrocode} -% \end{macro} -% \begin{macro}{\indexname} -% and of the index of authors as it appears in the document and in the table of contents: +% \end{macro} +% \begin{macro}{\indexname} +% and the index of authors as it appears in the document and in the table of contents: %^^A\changes{0.1g}{2007/08/05}{\cmd{\indexnametoc} renamed \cmd{\procindexname}} -% \changes{0.4a}{2007/10/01}{Remove formatting} -% \changes{0.4a}{2007/10/01}{Renamed from \cmd{\procindexname}} +% \changes{0.4a}{2007/10/01}{remove formatting} +% \changes{0.4a}{2007/10/01}{renamed from \cmd{\procindexname}} % \begin{macrocode} \renewcommand{\indexname}{Index of Authors} % \end{macrocode} -% \end{macro} -%^^A ================================================================= +% \end{macro} +%^^A------------------------------------------------------------------------ % \subsubsection{Header and footer} % -% \begin{macro}{\proclhead} -% We first define the default header: -%^^A\changes{0.2e}{2007/09/01}{\cmd{\loclhead} renamed \cmd{\proclhead}} +% \begin{macro}{\proclhead} +% We first define the default left header: +%^^A\changes{0.2e}{2007/09/01}{renamed\cmd{\loclhead} into \cmd{\proclhead}} +% \changes{0.6}{2009/09/08}{replaced \cmd{\proclhead} by \cmd{\procchead}} +% \changes{0.6}{2009/09/08}{added empty \cmd{\proclhead} and \cmd{\procrhead}} +% \begin{macrocode} +\newcommand{\proclhead}{} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\procchead} +% the default central header: +% \begin{macrocode} +\newcommand{\procchead}{{\color{red}Proceedings of the... \hfill % + 01--29 February, 2001}} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\procrhead} +% and the default right header: +% \begin{macrocode} +\newcommand{\procrhead}{} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\proclfoot} +% Similarly, we define the default left footer (empty): +% \begin{macrocode} +\newcommand{\proclfoot}{} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\proccfoot} +% the default central footer: +% \changes{0.4b}{2007/10/12}{use \cmd{\vspace} instead of \cmd{\vskip}} +% \changes{0.4b}{2007/10/12}{remove \cmd{\vspace}} +% \changes{0.6}{2009/09/08}{empty \cmd{\proclfoot} and \cmd{\procrfoot} added} % \begin{macrocode} -\newcommand{\proclhead}{\em \small Proceedings of the blah blah blah} +\newcommand{\proccfoot}{{\small \color{red} Proc-\thepage}} % \end{macrocode} -% \end{macro} -% \begin{macro}{\proccfoot} -% and the default footer: -% \changes{0.4b}{2007/10/12}{Use \cmd{\vspace} instead of \cmd{\vskip}} -% \changes{0.4b}{2007/10/12}{Remove \cmd{\vspace}} +% \end{macro} +% +% \begin{macro}{\procrfoot} +% and the default right footer (empty): % \begin{macrocode} -\newcommand{\proccfoot}{\small Proc-\thepage} +\newcommand{\procrfoot}{} % \end{macrocode} -% \end{macro} +% \end{macro} % % We now define the default page styles for use with headers: % \begin{macrocode} \pagestyle{fancyplain} % \end{macrocode} -% \begin{macro}{\headrulewidth} +% +% \begin{macro}{\headrulewidth} % together with the corresponding rule width for the headers: % \begin{macrocode} \renewcommand{\headrulewidth}{0pt} % \end{macrocode} -% \end{macro} -% \begin{macro}{\footrulewidth} +% \end{macro} +% +% \begin{macro}{\footrulewidth} % and for the footers: % \begin{macrocode} \renewcommand{\footrulewidth}{-5mm} % \end{macrocode} -% \end{macro} -% \begin{macro}{\proclhead} +% \end{macro} +% +% \begin{macro}{\procfootvskip} +% We also define the vertical skip length to be applied to the footer: +% \begin{macrocode} +\newlength{\procfootvskip} +\setlength{\procfootvskip}{0cm} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\procoptfootvskip} +%^^A \changes{0.1h}{2007/08/09}{removing \cmd{\testloccfoot} for a length \cmd{\procoptfootvskip}} +% and the option vertical skip length added to the footer with the \Lopt{movepagenumber} option: +% \begin{macrocode} +\newlength{\procoptfootvskip} +\ifconfproc@movepagenumber \setlength{\procoptfootvskip}{3mm}% +\else \setlength{\procoptfootvskip}{0mm} \fi +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\lhead} % The left header is given as: % \begin{macrocode} -\lhead{\proclhead} +\lhead{\color{\confproc@colorheaders}\proclhead} % \end{macrocode} -% \end{macro} -% \begin{macro}{\rhead} -% whereas the right hease is empty: +% \end{macro} +% +% \begin{macro}{\chead} +% the central header is: +% \begin{macrocode} +\chead{\color{\confproc@colorheaders}\procchead} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\rhead} +% and the right header is: % \begin{macrocode} -\rhead{} +\rhead{\color{\confproc@colorheaders}\procrhead} % \end{macrocode} -% \end{macro} -% \begin{macro}{\lfoot} +% \end{macro} +% +% \begin{macro}{\lfoot} % The left footer is also set empty: % \begin{macrocode} \lfoot{} % \end{macrocode} -% \end{macro} -% \begin{macro}{\rfoot} +% \end{macro} +% +% \begin{macro}{\rfoot} % as well as the right footer: % \begin{macrocode} \rfoot{} % \end{macrocode} -% \end{macro} -% \begin{macro}{\proccfoot} -% The center footer is the page number: +% \end{macro} +% +% \begin{macro}{\proccfoot} +% The center footer is the page number with option and mandatory vertical spaces: %^^A\changes{0.1h}{2007/08/09}\cmd{\loccfoot} renamed \cmd{\proccfoot}} % \begin{macrocode} -\cfoot{\proccfoot}{} +\cfoot{\color{\confproc@colorheaders}\vskip\procfootvskip% + \vskip\procoptfootvskip\proccfoot}% % \end{macrocode} -% \end{macro} -% Depending on the value of the \Lopt{headers} option, we change the default page style: +% \end{macro} +% +% Depending on the value of the \Lopt{headers} option, \DescribeMacro{\pagestyle} we change the default page style: % \begin{macrocode} \ifdefined \conf@FancyHeadersExceptPapers \pagestyle{fancy} \else \pagestyle{empty} \fi -% \end{macrocode} -% \begin{macro}{\procoptfootskip} -% We set \cmd{\procoptfootskip}, the optional footer vertical shift (to check page numbers): -%^^A\changes{0.1h}{2007/08/09}{removing \cmd{\testloccfoot} for a length \cmd{\procoptfootskip}} -% \begin{macrocode} -\newlength{\procoptfootskip} -\ifdefined\conf@TestPageNumbering% - \setlength{\procoptfootskip}{3mm}% - \cfoot{\vskip \procoptfootskip \proccfoot}% -\else% - \setlength{\procoptfootskip}{0mm}% -\fi -% \end{macrocode} -% \end{macro} +% \end{macrocode} % -%^^A ================================================================= +% +%^^A------------------------------------------------------------------------ % \subsubsection{Table of contents layouts} % -% Using the \package{titletoc} commands, we define the default table of contents layout. +% Using the \package{titletoc} commands, we define the various table of contents layout. +%^^A - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +% \subsubsection{Default} % -% \subsubsection*{Default} -% % For right numbering: % \begin{macrocode} -\ifdefined\conf@TocNumberingRight +\if@proc@TocNumberingRight % \end{macrocode} % we first set the left margin of papers inserted as sections: % \begin{macrocode} - \titlecontents{section}[2.5em]% left margin + \titlecontents{section}[0em]% left margin % \end{macrocode} % we then set the table of contents spacing between 2 papers: % \begin{macrocode} - {\vspace*{0.3em}}% space between two papers in the TOC + {\vspace*{0.5mm}}% space between two papers in the TOC % \end{macrocode} % and the filler and page number: % \begin{macrocode} - {}{}{\contentsmargin{0pt} \hfill \contentspage}% filler and page + {}% + {}% + {\hfill \hspace*{-2.5em}\makebox[0pt][r]{\contentspage}\hspace*{2.5em}}% filler and page + [\addvspace{0.5mm}]% space after % \end{macrocode} % For left numbering: % \begin{macrocode} \else% - \dottedcontents{section}[]{\fillright}{}{1pc} +% \dottedcontents{section}[]{\fillright}{}{1pc} \titlecontents{section}[2.5em]% - {\vspace*{0.3em}}% + {\vspace*{0.5mm}}% % \end{macrocode} % we set the left shift of page numbers: % \begin{macrocode} - {\hspace*{-2.5em}\contentspage\hspace*{2.5em}}% left shifting page num. - {\hspace*{-2.5em}\contentspage\hspace*{2.5em}}% idem + {\hspace*{-2.5em}\makebox[0pt][r]{\contentspage}\hspace*{2.5em}}% left shifting page num. + {\hspace*{-2.5em}\makebox[0pt][r]{\contentspage}\hspace*{2.5em}}% idem {}% filler and page + [\addvspace{0.5mm}]% space after +% \titlecontents{subsection}[2.5em]% +% {\vspace*{0.3em}}% +% {}% left shifting page num. +% {}% idem +% {}% filler and page +% \titlecontents{subsection*}[2.5em]% +% {\vspace*{0.3em}}% +% {}% left shifting page num. +% {}% idem +% {}% filler and page \fi % \end{macrocode} -% -% -% \begin{macro}{\tocmattertocstyle} -% \subsubsection*{At document frontmatter} +% +% +% \begin{macro}{\tocmattertocstyle} +% \subsubsection*{At document frontmatter with right numbering} +% \begin{macrocode} +\if@proc@TocNumberingRight + \newcommand{\frontmattertocstyle}{ +% \end{macrocode} +% Parts are used for the preamble: +% \begin{macrocode} + \titlecontents{part}[0em]% + {\addvspace{3mm}}% + {\Large\bfseries}% + {\Large\bfseries}% + {}% + [\addvspace{0.5mm}] +% \end{macrocode} +% and chapters for each page for the preamble: +% \begin{macrocode} + \titlecontents{chapter}[0em]% + {\addvspace{2mm}}% + {\large\bfseries\itshape}% + {\large\bfseries\itshape}% + {}% + [\addvspace{0.5mm}] + } +% \end{macrocode} +% \subsubsection*{At document frontmatter with left numbering} % \begin{macrocode} -\newcommand{\tocmattertocstyle}{ +\else + \newcommand{\frontmattertocstyle}{ % \end{macrocode} % Parts are used for the preamble: % \begin{macrocode} - \titlecontents{part}[-1em]{\addvspace{1pc}}% - {\contentspage\hspace*{3.2em}\contentsmargin{0pt}% - \makebox[0pt][r]{\huge\thecontentslabel\enspace}\large}% - {\contentspage\hspace*{3.2em}\contentsmargin{0pt}\large}% - {}[\addvspace{.5pc}] + \titlecontents{part}[0em]% + {\addvspace{3mm}}% + {\Large\bfseries}% + {\Large\bfseries}% + {}% + [\addvspace{0.5mm}] % \end{macrocode} % and chapters for each page for the preamble: % \begin{macrocode} - \titlecontents{chapter}[-1em]{\addvspace{1pc}}% - {\contentspage\hspace*{3.2em}\contentsmargin{0pt}% - \makebox[0pt][r]{\huge\thecontentslabel\enspace}\large}% - {\contentspage\hspace*{3.2em}\contentsmargin{0pt}\large}% - {}[\addvspace{.5pc}] -} + \titlecontents{chapter}[0em]% + {\addvspace{2mm}}% + {\large\bfseries\itshape}% + {\large\bfseries\itshape}% + {}% + [\addvspace{0.5mm}] + } +\fi % \end{macrocode} -% \end{macro} -% -% \subsubsection*{At document mainmatter} +% \end{macro} +% +% \subsubsection*{At document mainmatte} % -% \begin{macro}{\mainmattertocstyle} -% Parts are used for days, or for sessions of no days are used; chapters are used for sessions (if days are used); sections are always used for papers. +% \begin{macro}{\mainmattertocstyle} +% Sections are always used for papers. Chapters are used as sessions when days are used. Parts are used as days, or when sessions of no days are used. The corresponding TOC style or the main matter is then defined for right page numbers in TOC: % \begin{macrocode} -\ifdefined\conf@TocNumberingRight +\if@proc@TocNumberingRight \newcommand{\mainmattertocstyle}{ + \titlecontents{part}[0pt]% + {\addvspace{3mm}}% + {\Large\bfseries}% + {\Large\bfseries}% + {}% + [\addvspace{0.5mm}] \titlecontents{chapter}[0pt]% - {\addvspace{1pc}\bfseries\itshape}% - {\contentsmargin{0pt}\bfseries% - \makebox[0pt][r]{\huge\thecontentslabel\enspace}\large}% - {\contentsmargin{0pt}\large}{}[\addvspace{.5pc}]% + {\addvspace{2mm}}% + {\large\bfseries\itshape}% + {\large\bfseries\itshape}% + {}% + [\addvspace{0.5mm}] + } +% \end{macrocode} +% and for left page numbers in TOC: +% \begin{macrocode} +\else % left TOC page numbers + \newcommand{\mainmattertocstyle}{ \titlecontents{part}[0pt]% - {\addvspace{1pc}\bfseries}% - {\contentsmargin{0pt}\bfseries% - \makebox[0pt][r]{\huge\thecontentslabel\enspace}\large}% - {\contentsmargin{0pt}\large}{}[\addvspace{.5pc}]% -\else - \ifdefined\conf@TocNumberingLeft% default - \newcommand{\mainmattertocstyle}{ - \titlecontents{section}[2.5em]% - {\vspace*{0.3em}}% - {\hspace*{-2.5em}\contentspage\hspace*{2.5em}}% - {\hspace*{-2.5em}\contentspage\hspace*{2.5em}}% - {}% - \titlecontents{chapter}[0pt]% - {\addvspace{1pc}\bfseries\itshape}% - {\contentsmargin{0pt}\bfseries % - \makebox[0pt][r]{\huge\thecontentslabel\enspace}\large}% - {\contentsmargin{0pt}\large}{}[\addvspace{.5pc}]% - \titlecontents{part}[0pt]% - {\addvspace{1pc}\bfseries}% - {\contentsmargin{0pt}\bfseries % - \makebox[0pt][r]{\huge\thecontentslabel\enspace}\large}% - {\contentsmargin{0pt}\large}{}[\addvspace{.5pc}]% - } - \else - \newcommand\mainmattertocstyle{} - \fi + {\addvspace{3mm}}% + {\Large\bfseries}% + {\Large\bfseries}% + {}% + [\addvspace{0.5mm}] + \titlecontents{chapter}[0pt]% + {\addvspace{2mm}}% + {\large\bfseries\itshape}% + {\large\bfseries\itshape}% + {}% + [\addvspace{0.5mm}] + } \fi % \end{macrocode} -% \end{macro} -% \begin{macro}{\mainmatter} -% Hence, we redefine the \cmd{\mainmatter} command to use this style: -% \changes{0.4a}{2007/10/01}{Redefined to use \cmd{\mainmattertocstyle}} +% \end{macro} +% +% \begin{macro}{npagespreamble} +% Before redefining the main matter, we define a counter that is used to count the number of pages in the preamble (especially for the \package{pdftk}\footnote{Get \package{pdftk} at: \url{http://www.accesspdf.com/pdftk/}} output data: +% \begin{macrocode} +\newcounter{npagespreamble} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\mainmatter} +% Hence, we redefine the \cmd{\mainmatter} command that \newvzdseven{}does not use anymore this style (it is left to the user to decide weither he wants to use it or not) but indicated the number of pages in the preamble: +% \changes{0.4a}{2007/10/01}{now includes \cmd{\mainmattertocstyle}} % \begin{macrocode} \renewcommand\mainmatter{% - \cleardoublepage + \PackageInfo{confproc}{counted \arabic{npagespreamble} pages in the preamble} + \cleardoublepage \@mainmattertrue - \pagenumbering{arabic} - \mainmattertocstyle} + \pagenumbering{arabic}} % \end{macrocode} -% \end{macro} -% -% \subsubsection*{At document backmatter} -% -% \begin{macro}{\backmattertocstyle} -% Sections are used to format/display the general bibliography and index of authors, but they appear as parts in the table of contents: +% \end{macro} +% +%^^A - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +% \subsubsection{At document backmatter} +% +% \begin{macro}{\backmattertocstyle} +% Sections are used to format/display the general bibliography and index of authors, but they appear as parts in the table of contents, for both right page numbers: % \begin{macrocode} -\ifdefined\conf@TocNumberingRight +\if@proc@TocNumberingRight \newcommand{\backmattertocstyle}{ - \titlecontents{section}[]{}{}{}{}[]% \titlecontents{part}% - [0pt]{\addvspace{1pc}}{}{}% - {\contentsmargin{0pt} \large \hfill\contentspage}% - [\addvspace{.5pc}]% + [0pt]% + {\addvspace{3mm}}% + {\Large\bfseries}% + {\Large\bfseries}% + {\hfill \hspace*{-2.5em}\contentspage\hspace*{2.5em}}% + [\addvspace{0.5mm}] + \titlecontents{chapter}% + [0pt]% + {\addvspace{2mm}}% + {\large\bfseries\itshape}% + {\large\bfseries\itshape}% + {\hfill \hspace*{-2.5em}\contentspage\hspace*{2.5em}}% + [\addvspace{0.5mm}] + }% +% \end{macrocode} +% and left page numbers: +% \begin{macrocode} +\else + \newcommand{\backmattertocstyle}{% + \titlecontents{part}% + [0pt]% + {\addvspace{3mm}}% + {\makebox[0pt][r]{\contentspage}\hspace*{2.5em}\Large\bfseries}% + {\makebox[0pt][r]{\contentspage}\hspace*{2.5em}\Large\bfseries}% + {}% + [\addvspace{0.5mm}] + \titlecontents{chapter}% + [0pt]% + {\addvspace{2mm}}% + {\makebox[0pt][r]{\contentspage}\hspace*{2.5em}\large\itshape\bfseries}% + {\makebox[0pt][r]{\contentspage}\hspace*{2.5em}\large\itshape\bfseries}% + {}% + [\addvspace{0.5mm}] }% -\else% - \ifdefined\conf@TocNumberingLeft% - \newcommand{\backmattertocstyle}{% - \titlecontents{section}[]{}{}{}{}[]% - \titlecontents{part}% - [0pt]% - {\addvspace{1pc}}% - {\contentspage\hspace*{2.5em}\contentsmargin{0pt}% - \bfseries% - \makebox[0pt][r]{\huge\thecontentslabel\enspace}% - \large\bfseries}% - {\contentspage\hspace*{2.5em}\contentsmargin{0pt} \large\bfseries}% - {}% - [\addvspace{.5pc}]% - }% - \else% - \newcommand\backmattertocstyle{}% - \fi% \fi % \end{macrocode} -% \end{macro} -% \begin{macro}{\backmatter} -% We then redefine the \cmd{\backmatter} command to use this style: -% \changes{0.4a}{2007/10/01}{Redefined to use \cmd{\backmattertocstyle}} +% \end{macro} +% +% \begin{macro}{\backmatter} +% We then redefine the \cmd{\backmatter} command and ensure the footer is properly modified: +% \changes{0.4a}{2007/10/01}{now includes \cmd{\backmattertocstyle}} +% \changes{0.6}{2009/09/08}{added footer redefinition} % \begin{macrocode} \renewcommand\backmatter{% - \if@openright - \cleardoublepage - \else - \clearpage - \fi + \if@openright \cleardoublepage + \else \clearpage \fi \@mainmatterfalse - \backmattertocstyle} + \cfoot{\color{\confproc@colorheaders}\vskip \procfootvskip % + \vskip \procoptfootvskip \proccfoot}} % \end{macrocode} -% \end{macro} +% \end{macro} % -%^^A ================================================================= +%^^A------------------------------------------------------------------------ % \subsubsection{Headers/footers} % +% \begin{macro}{\otherpagestyle} % The default page style (and corresponding headers and footers) is set for non PDF-inserted pages: % \begin{macrocode} -\ifdefined\conf@FancyHeadersExceptPapers - \newcommand{\otherpagestyle}{\pagestyle{fancy}} - \newcommand{\thisotherpagestyle}{\thispagestyle{fancy}} -\else - \newcommand{\otherpagestyle}{\pagestyle{empty}} - \newcommand{\thisotherpagestyle}{\thispagestyle{empty}} -\fi -% \end{macrocode} -% and for PDF-inserted pages: -% \begin{macrocode} -\ifdefined\conf@FancyHeadersOnPapers - \newcommand{\PDFpagestyle}{\thispagestyle{fancy}} -\else - \newcommand{\PDFpagestyle}{\thispagestyle{empty}} -\fi +\newcommand{\otherpagestyle}{ + \if@proc@FancyHeadersExceptPapers\pagestyle{fancy} + \else \pagestyle{empty} \fi} % \end{macrocode} -% Using the \package{sectsty} package, all chapters have the same font in the table of contents: +% \end{macro} +% +% \begin{macro}{\otherpagestyle} +% and for a particular page: % \begin{macrocode} -\chapterfont{\thisotherpagestyle} +\newcommand{\thisotherpagestyle}{ + \if@proc@FancyHeadersExceptPapers\thispagestyle{fancy} + \else \thispagestyle{empty} \fi} % \end{macrocode} -% We then define what the \cmd{\clearsingleordoublepage} \DescribeMacro{\clearsingleordoublepage} stands for, depending if the document is single-sided or double-sided: +% \end{macro} +% +% \begin{macro}{\PDFpagestyle} +% as well as for PDF-inserted pages: % \begin{macrocode} -\ifdefined\conf@WithCleardoublepage - \newcommand{\clearsingleordoublepage}{\cleardoublepage} -\else - \ifdefined\conf@WithClearsinglepage - \newcommand{\clearsingleordoublepage}{\clearpage} - \else - \newcommand{\clearsingleordoublepage}{\cleardoublepage} - \fi -\fi +\newcommand{\PDFpagestyle}{ + \if@proc@FancyHeadersOnPapers\thispagestyle{fancy} + \else\thispagestyle{empty} \fi} % \end{macrocode} +% \end{macro} % -%^^A ================================================================= -% \subsubsection{Creating back-references} -% -% We declare the commands related to bibliography insertion, depending on the compilation option, using the back-references previously generated: +% \begin{macro}{\chapterfont} +% Using the \package{sectsty} package, all chapters have the same font in the table of contents: % \begin{macrocode} -\ifdefined\conf@FinalVersion - \newcommand{\UseBackRef}{} +\chapterfont{\thisotherpagestyle} % \end{macrocode} -% and generating the back-references to be used in the last compilation: +% \end{macro} +% +% \begin{macro}{\clearsingleordoublepage} +% We define the \cmd{\clearsingleordoublepage} command depending if on the document +% format (one-side or two-side): % \begin{macrocode} -\else - \newcommand{\CreateBackRef}{} -\fi +\newcommand{\clearsingleordoublepage}{ + \iffalse\@twoside \clearpage + \else \cleardoublepage \fi} % \end{macrocode} +% \end{macro} % -%^^A ================================================================= +% +%^^A------------------------------------------------------------------------ % \subsubsection{$X$ and $Y$ shifts} % %^^A\changes{0.1g}{2007/08/08}{Cmds: changing \cmd{\LaTeXxShift} from a command to a length (idem for \cmd{\LaTeXyShift}, \cmd{\WordxShift} and \cmd{\WordyShift})} %^^A\changes{0.2a}{2007/08/12}{Cmds: adding \cmd{\paperbookmark} for correct use in the Perl scripts} -% We now define the $X$ and $Y$ shifts for \LaTeX{} (\DescribeMacro{\LaTeXxShift}\cmd{\LaTeXxShift} and \DescribeMacro{\LaTeXyShift}\cmd{\LaTeXyShift}) and Word (\DescribeMacro{\WordxShift}\cmd{\WordxShift}, \DescribeMacro{\WordyShift}\cmd{\WordyShift}) generated papers as lengths: +% We now define the $X$ and $Y$ shifts for \LaTeX{} (\cmdDescribe{\LaTeXxShift} and +% \cmdDescribe{\LaTeXyShift}) and Word (\cmdDescribe{\WordxShift}, \cmdDescribe{\WordyShift}) +% generated papers as lengths: % \begin{macrocode} -\newlength{\LaTeXxShift} -\newlength{\LaTeXyShift} -\newlength{\WordxShift} -\newlength{\WordyShift} -% \end{macrocode} -% Their default values are set to those used for the example, depending on the document formant (A4/letter): -% \begin{macrocode} -\ifdefined\shiftsafourpaper - \setlength{\LaTeXxShift}{0pt} - \setlength{\LaTeXyShift}{28pt} - \setlength{\WordxShift}{10pt} - \setlength{\WordyShift}{-40pt} -\else - \ifdefined\shiftsletterpaper - \setlength{\LaTeXxShift}{8.45pt} - \setlength{\LaTeXyShift}{-3pt} - \setlength{\WordxShift}{10pt} - \setlength{\WordyShift}{-40pt} - \fi -\fi +\newlength{\LaTeXxShift} \setlength{\LaTeXxShift}{0pt} +\newlength{\LaTeXyShift} \setlength{\LaTeXyShift}{0pt} +\newlength{\WordxShift} \setlength{\WordxShift}{0pt} +\newlength{\WordyShift} \setlength{\WordyShift}{0pt} % \end{macrocode} +% \changes{0.6}{2009/09/08}{Default values for Word or \LaTeX{} $x$ and $y$ shift values no more set +% depending on the document formant} % -%^^A ================================================================= +%^^A------------------------------------------------------------------------ % \subsubsection{Paper insertion commands} % -% \begin{macro}{\papertitle} -% We now pre-define (as empty) the commands used to insert the PDF papers (for including the first paper in the example), \ie{} the paper title: +% \begin{macro}{\conf@paper@title} +% We now define (as empty) the commands used to add TOC, bookmark and bib data to +% inserted PDF papers, \ie{} the paper title: % \begin{macrocode} -\newcommand{\papertitle}{} +\newcommand{\conf@paper@title}{} % \end{macrocode} -% \end{macro} -% \begin{macro}{\paperauthors} +% \end{macro} +% \begin{macro}{\conf@paper@authors} % the paper authors: % \begin{macrocode} -\newcommand{\paperauthors}{} +\newcommand{\conf@paper@authors}{} % \end{macrocode} -% \end{macro} -% \begin{macro}{\paperindex} +% \end{macro} +% \begin{macro}{\conf@paper@index} % the commands for insertion in the index: % \begin{macrocode} -\newcommand{\paperindex}{} +\newcommand{\conf@paper@index}{} % \end{macrocode} -% \end{macro} -% \begin{macro}{\paperref} +% \end{macro} +% \begin{macro}{\conf@paper@ref} % the paper reference, \ie{} a tag (\eg{} the file name, or the submission number): % \begin{macrocode} -\newcommand{\paperref}{} +\newcommand{\conf@paper@ref}{} % \end{macrocode} -% \end{macro} -% \begin{macro}{\paperpagenum} +% \end{macro} +% \begin{macro}{\conf@paper@pagenum} % the number of pages: % \begin{macrocode} -\newcommand{\paperpagenum}{} +\newcommand{\conf@paper@pagenum}{} % \end{macrocode} -% \end{macro} -% \begin{macro}{\papercite} +% \end{macro} +% \begin{macro}{\conf@paper@cite} % the bibliographic references (for the general bibliography): % \begin{macrocode} -\newcommand{\papercite}{} +\newcommand{\conf@paper@cite}{} % \end{macrocode} -% \end{macro} -% \begin{macro}{\papertitlestyle} +% \end{macro} +% \begin{macro}{\papertitlestyle} % the style for the title: % \begin{macrocode} \newcommand{\papertitlestyle}{} % \end{macrocode} -% \end{macro} -% \begin{macro}{\paperauthorstyle} +% \end{macro} +% \begin{macro}{\paperauthorstyle} % and finally the style for both the list of authors and the text between the title and the list of authors: % \changes{0.4b}{2007/10/12}{Format: changing \cmd{\it} to \cmd{\itshape}} % \begin{macrocode} \newcommand{\paperauthorstyle}{\texorpdfstring{\newline\itshape}{\break}} % \end{macrocode} -% \end{macro} -%^^A\changes{0.1f}{2007/08/03}{Bug: fixed wrong bookmark link to author (2nd page instead of 1st) by moving the \cmd{\pdfbookmark[]} cmd into the \cmd{\pagecommand} cmd.} +% \end{macro} +% +%^^A\changes{0.1f}{2007/08/03}{Bug: fixed wrong bookmark link to author (2nd page instead of 1st) by moving the \cmd{\pdfbookmark[]} cmd into the \cmd{\pagecommand} cmd} %^^A\changes{0.1i}{2007/08/10}{Cmd: changing \cmd{\includepaperthread} to hide the TOC layout.} %^^A\changes{0.1i}{2007/08/10}{Cmd: adding \cmd{\proctoctitleauthor} to define the TOC format of author and paper} %^^A\changes{0.1i}{2007/08/10}{Cmd: renaming \cmd{\includepaperthread} into \cmd{\procinsertpaper}} %^^A\changes{0.2b}{2007/08/16}{Cmd: adding a \cmd{\paperpagenum} counter to compute Nb pages -1} % -% \begin{macro}{paperpagenum} -% A new counter \Lopt{paperpagenum} is added, for the number of pages of a paper: +% \begin{macro}{npages} +% A new counter \Lopt{npages} is added, for the number of pages of a paper: % \begin{macrocode} -\newcounter{paperpagenum} +\newcounter{npages} % \end{macrocode} -% \end{macro} -% \begin{macro}{\proctoctitleauthor} -% The \cmd{\proctoctitleauthor} command defines the style for title/author entry in the table of contents using the style \cmd{\papertitlestyle} for the paper with title \cmd{\papertitle} and the style \cmd{\paperauthorstyle} for the paper with authors \cmd{\paperauthors} : +% \end{macro} +% +% \begin{macro}{\proctoctitleauthor} +% The \cmd{\proctoctitleauthor} command defines the style for title/author entry in the table of contents using the style \cmd{\papertitlestyle} for the paper with title \cmd{\papertitle} and the style \cmd{\paperauthorstyle} for the paper with authors \cmd{\paperauthors} : % \begin{macrocode} \newcommand{\proctoctitleauthor}[2]{% - \texorpdfstring{{\papertitlestyle#1}{\paperauthorstyle#2}}% - {{\papertitlestyle#1}}} % \end{macrocode} -% \end{macro} -% We chose to insert both the paper title and the list of authors in the table of contents, whereas only the title is inserted as a section in the bookmark. Then, the authors will be inserted, for each of them, as a subsection in the \cmd{\procinsertpaper} command. -% -% \begin{macro}{\procinsertpaper} -% We now come to the paper insertion \cmd{\procinsertpaper} command, one of the most important command of the whole class. -% \changes{0.4a}{2007/10/03}{Manage 1-page long papers (no ref printed yet)} -% \changes{0.4c}{2007/10/12}{Author back in bookmark (missing \#9 arg in `pagecommand', error in v0.4a)} -%% \begin{macrocode} -\newcommand{\procinsertpaper}[9]{ -% \end{macrocode} -% It has the following 9 arguments: i) X and Y shifts (with a space in between), ii) number of pages, iii) a reference, iv) the title, v) the list of authors, vi) the index entries, vii) the citations for the general bibliography, viii) the PDF file name and ix the bookmark entries for the authors. -% The insertion is made in two steps. First, the number of pages is set, and the index entries are given (for proper links from the index of authors to the paper's first page): -% \begin{macrocode} - \setcounter{paperpagenum}{#2} - #6% -% \end{macrocode} -% Then, if the paper has only 1 page, it is inserted (with bibliographic items only if \Lopt{compil=bibbackref} or \Lopt{compil=bibmerge}): -% \begin{macrocode} - \ifnum\thepaperpagenum=1 - \ifdefined\conf@procWithDebug\typeout{confproc: 1-page long paper}\fi - \ifdefined\UseBackRef - \includepdf[noautoscale,offset= #1,pages=1,% - linktodoc,linkname=\PAPERPATH #8.pdf,% - addtotoc={1, section, 1, \proctoctitleauthor{#4}{#5}, #3},% - pagecommand = {#9\PDFpagestyle}% - ]{\PAPERPATH #8.pdf}% - \else - \includepdf[noautoscale,offset= #1,pages=1,% - linktodoc,linkname=\PAPERPATH #8.pdf,% - addtotoc={1, section, 1, \proctoctitleauthor{#4}{#5}, #3},% - pagecommand = {#9\PDFpagestyle\vspace*{-1cm}\confcite{#7}}% - ]{\PAPERPATH #8.pdf}% - \fi +% We chose to insert both the paper title and the list of authors in the table of contents, +% \begin{macrocode} + \texorpdfstring{{\papertitlestyle #1}{\paperauthorstyle #2}}% +% \end{macrocode} +% whereas only the title is inserted as a section in the bookmark. +% \begin{macrocode} + {{\papertitlestyle #1}}} % \end{macrocode} -% Note where the bookmark entries are placed (argument \verb+#9+): it was the only place I found where the bookmark link would be valid\footnote{if you check in the electronic version of the DAFx-06 proceedings, you will see what happens with unproper links... You will be directed to the second page of the paper!}. +% \end{macro} +% Then, each author will be inserted as a subsection in the \cmd{\procinsertpaper} command. +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Table of contents insertion} % -% The second step consists in inserting the reminding pages (if any). In the case of bibliography merging, we do not care yet about proper page numbering, but we want to see each paper's first and last page: -%^^A\changes{0.2b}{2007/08/16}{Add last page (with bibliography) insertion for 'compil=bibmerge' option} +% \begin{macro}{\tableofcontents} +% We redefine the usual \cmd{\tableofcontents} command that switches to the corresponding section style for insertion in the table of contents: +% \changes{0.4a}{2007/10/01}{redefined} % \begin{macrocode} - \else - \includepdf[noautoscale,offset= #1,pages=1,% - linktodoc,linkname=\PAPERPATH #8.pdf,% - addtotoc={1, section, 1, \proctoctitleauthor{#4}{#5}, #3},% - pagecommand = {#9\PDFpagestyle}% - ]{\PAPERPATH #8.pdf}% +\renewcommand\tableofcontents{% % \end{macrocode} -% Then, depending on the \Lopt{compil} option, we may only insert the last page only (\Lopt{compil=bibmerge}): +% clears a single or double page according to the one/two-sided page format: % \begin{macrocode} - \ifdefined\conf@BibMerge% - \includepdf[noautoscale,offset= #1,pages=\thepaperpagenum,% - linktodoc,linkname=\PAPERPATH #8.pdf,% - pagecommand = {\PDFpagestyle\vspace*{-2cm}\confcite{#7}}% - ]{\PAPERPATH #8.pdf}% - \PDFpagestyle{}% - \ifdefined\conf@procWithDebug - \typeout{confproc: bibliography insertion only}\fi + \clearsingleordoublepage % \end{macrocode} -% or we decrement the page number in order to insert all but last page: +% adds the conference program name to the PDF bookmark: % \begin{macrocode} - \else - \addtocounter{paperpagenum}{-1} - \includepdf[noautoscale,offset= #1,pages=2-\thepaperpagenum,% - linktodoc,linkname=\PAPERPATH #8.pdf,% - pagecommand = {\PDFpagestyle}% - ]{\PAPERPATH #8.pdf}% - \PDFpagestyle{}% -% \end{macrocode} -% If running \LaTeX{} to create proper back-references (\Lopt{compil=bibmerge} or \Lopt{compil=bibbackref}), we add references to the paper's bibliographic items onto the last page: -%^^A\changes{0.2a}{2007/08/12}{Add output text for \Lopt{verbose} option} -%^^A\changes{0.2b}{2007/08/16}{Remove 1 to \Lopt{paperpagenum} counter} -% \begin{macrocode} - \addtocounter{paperpagenum}{1} - \ifdefined\CreateBackRef - \includepdf[noautoscale,offset= #1,pages=\thepaperpagenum,% - linktodoc,linkname=\PAPERPATH #8.pdf,% - pagecommand = {\PDFpagestyle\vspace*{-2cm}\confcite{#7}}% - ]{\PAPERPATH #8.pdf}% -% \end{macrocode} -% Otherwise, for the last run (assuming that proper back-references were created), we insert the last page normally, without the back-references ((\Lopt{compil=last}): + \pdfbookmark[0]{\contentsname}{contents} +% \end{macrocode} +% switches to one-column if needed: % \begin{macrocode} - \else - \ifdefined\UseBackRef - \includepdf[noautoscale,offset= #1,pages=\thepaperpagenum,% - linktodoc,linkname=\PAPERPATH #8.pdf,% - pagecommand = {\PDFpagestyle}% - ]{\PAPERPATH #8.pdf}% - \fi - \fi - \fi - \ifdefined\conf@procWithDebug - \typeout{confproc: partial paper insertion (last page=bib items)}\fi - \fi - \ifdefined\conf@procWithDebug - \typeout{---> file: #8.pdf (#2 pages)} - \typeout{---> title: #4} - \typeout{---> author(s): #5} - \typeout{---> index: #6} - \fi + \if@twocolumn \@restonecoltrue\onecolumn + \else \@restonecolfalse \fi % \end{macrocode} -% In any case, we go to next page, so that bookmarks go to the right spot: +% inserts the table of contents name as a starred section: % \begin{macrocode} - \newpage + \section*{\contentsname}% % \end{macrocode} -% Then, depending if we want all papers to start on the right page or not, we do a \cmd{\cleardoublepage}: +% inserts the table of contents itself: % \begin{macrocode} - \ifdefined\conf@WithClearsinglepagePapers - \clearpage - \else - \ifdefined\conf@WithCleardoublepagePapers - \cleardoublepage - \fi - \fi -} + \@starttoc{toc}% % \end{macrocode} -% \end{macro} -% -%^^A ================================================================= -% \subsubsection{Table of contents insertion} -% -% \begin{macro}{\tableofcontents} -% We redefine the usual \cmd{\tableofcontents} command that inserts the table of contents, adds it to the PDF bookmark, and switches to the corresponding section style for insertion in the table of contents: -% \changes{0.4a}{2007/10/01}{Redefined} +% restores the two-column mode if any: % \begin{macrocode} -\renewcommand\tableofcontents{% - \tocmattertocstyle - \clearsingleordoublepage - \pdfbookmark[0]{\contentsname}{contents} - \if@twocolumn - \@restonecoltrue\onecolumn - \else - \@restonecolfalse - \fi - \section*{\contentsname - \@mkboth{% - \MakeUppercase\contentsname}{\MakeUppercase\contentsname}}% - \@starttoc{toc}% - \if@restonecol\twocolumn\fi - \clearsingleordoublepage -} + \if@restonecol\twocolumn\fi +% \end{macrocode} +% and clears a single or double page according to the one/two-sided page format: +% \begin{macrocode} + \clearsingleordoublepage} % \end{macrocode} -% \end{macro} +% \end{macro} % -%^^A ================================================================= +%^^A------------------------------------------------------------------------ % \subsubsection{Organize the program by days or sessions} % % The \cmd{\procday} \DescribeMacro{\procday} command inserts the day given as argument in the table of contents: %^^A\changes{0.2d}{2007/08/18}{Cmds: adding the \cmd{\procday} command for inserting the day (upper level in the bookmark)} % \begin{macrocode} \newcommand{\procday}[1]{% - \phantomsection% - \addcontentsline{toc}{part}{#1}} + \phantomsection \addcontentsline{toc}{part}{#1}} % \end{macrocode} % The \cmd{\session} \DescribeMacro{\session} command adds a session to the table of contents: % \begin{macrocode} \newcommand{\session}[1]{% - \phantomsection% - \addcontentsline{toc}{chapter}{#1}} + \phantomsection \addcontentsline{toc}{chapter}{#1}} % \end{macrocode} % -%^^A ================================================================= +%^^A------------------------------------------------------------------------ % \subsubsection{Paper switch} % -% \begin{macro}{\paperswitch} +% \begin{macro}{\paperswitch} % The \cmd{\paperswitch} command will be redefined in the \file{expapersswitch.tex} file, containing information about all papers. It is therefore declared empty: % \begin{macrocode} \newcommand{\paperswitch}{} % \end{macrocode} -% \end{macro} +% \end{macro} % -%^^A ================================================================= +%^^A------------------------------------------------------------------------ % \subsubsection{Modifying the bibliography style} % -% \begin{macro}{\bibhang} +% \begin{macro}{\bibhang} % We first set the \cmd{\bibhang} length: % \begin{macrocode} \setlength{\bibhang}{0.5em} % % \end{macrocode} -% \end{macro} +% \end{macro} %\begin{macro}{\thebibliography} % We then redefine the \cmd{\thebibliography} environment, for proper use and insertion of the new section title in the table of contents: -% \changes{0.4a}{2007/10/01}{Redefined: inserts \cmd{\setbibitems}'s code} +% \changes{0.4a}{2007/10/01}{redefined to insert \cmd{\setbibitems}'s code} % \begin{macrocode} -\renewenvironment{thebibliography}[1] - {\ifdefined\conf@TwoColumnBib% - \twocolumn - \fi - \ifdefined\conf@BibMerge% - \nocite{*}% - \else% - \clearsingleordoublepage% - \fi% - \section*{\bibname}% - \addcontentsline{toc}{part}{\bibname} - \@mkboth{\MakeUppercase\bibname}{\MakeUppercase\bibname}% - \procbibintro - \list{\@biblabel{\@arabic\c@enumiv}}% - {\settowidth\labelwidth{\@biblabel{#1}}% - \leftmargin\labelwidth - \advance\leftmargin\labelsep - \@openbib@code - \usecounter{enumiv}% - \let\p@enumiv\@empty - \renewcommand\theenumiv{\@arabic\c@enumiv}}% - \sloppy - \clubpenalty4000 - \@clubpenalty \clubpenalty - \widowpenalty4000% - \sfcode`\.\@m} - {\def\@noitemerr - {\@latex@warning{Empty `thebibliography' environment}}% - \endlist - \setlength{\labelsep}{0em} - \setlength{\itemindent}{-\bibhang} - \setlength{\leftmargin}{\bibhang}} -% \end{macrocode} -% \end{macro} -% \begin{macro}{\newblock} +\if@proc@BibNone + \renewenvironment{thebibliography}[1]{% + \PackageInfo{confproc}{ignoring #1 biblio file (`bib=none' option)}} +\else + \renewenvironment{thebibliography}[1]{% + \ifconfproc@twocolbib \twocolumn \fi + \ifdefined\conf@BibMerge \nocite{*} + \else \clearsingleordoublepage \fi% + \section*{\bibname}% + \addcontentsline{toc}{part}{\bibname} + \@mkboth{\MakeUppercase\bibname}{\MakeUppercase\bibname}% + \procbibintro + \list{\@biblabel{\@arabic\c@enumiv}}% + {\settowidth\labelwidth{\@biblabel{#1}}% + \leftmargin\labelwidth + \advance\leftmargin\labelsep + \@openbib@code + \usecounter{enumiv}% + \let\p@enumiv\@empty + \renewcommand\theenumiv{\@arabic\c@enumiv}}% + \sloppy + \clubpenalty4000 + \@clubpenalty \clubpenalty + \widowpenalty4000% + \sfcode`\.\@m} + {\def\@noitemerr + {\@latex@warning{Empty `thebibliography' environment}}% + \endlist + \setlength{\labelsep}{0em} + \setlength{\itemindent}{-\bibhang} + \setlength{\leftmargin}{\bibhang}} +\fi +% \end{macrocode} +% \end{macro} +% \begin{macro}{\newblock} % We redefine the \cmd{\newblock} command to reduce the space between bib items: % \begin{macrocode} \renewcommand\newblock{\hskip 0em plus 0.0em minus .07em} % \end{macrocode} -% \end{macro} +% \end{macro} % %^^A% The \cmd{\setbibitems} \DescribeMacro{\setbibitems} command defines the bibliography items to be inserted, depending on the compilation option. %^^A% \begin{macrocode} @@ -6624,7 +10454,7 @@ $PDFLATEX $TEXFILE.tex %^^A \fi% %^^A% \end{macrocode} % -%^^A ================================================================= +%^^A------------------------------------------------------------------------ % \subsubsection{General bibliography introduction} % % The \cmd{\procbibintro} \DescribeMacro{\procbibintro} cmd defaults the introductory paragraph of the full bibliography: @@ -6636,7 +10466,7 @@ $PDFLATEX $TEXFILE.tex the linked item.}} % \end{macrocode} % -%^^A ================================================================= +%^^A------------------------------------------------------------------------ % \subsubsection{Index insertion} % % The \cmd{\insertindex} \DescribeMacro{\insertindex} cmd defines the index insertion (it may later be hidden in a proper redefinitin of the \cmd{\theindex} command): @@ -6644,7 +10474,7 @@ $PDFLATEX $TEXFILE.tex % \begin{macrocode} \newcommand{\insertindex}{ % \end{macrocode} -% We first clear the page, so that two-sided documents start on a right (odd) page: +% We first clear the page, so that two-side documents start on a right (odd) page: % \begin{macrocode} \clearsingleordoublepage % \end{macrocode} @@ -6658,9 +10488,9 @@ $PDFLATEX $TEXFILE.tex \section*{~~}% \addcontentsline{toc}{part}{\indexname}% % \end{macrocode} -% The index of authors has no header/footer, as it is the last page and may be printed inside the cover (as for the printed version of the DAFx-06 proceedings): +% The index of authors may have no header/footer, in the case it is a single (and last) page that is printed inside the cover (as we did for the paperback version of the DAFx-06 proceedings): % \begin{macrocode} - \renewcommand{\proclhead}{}% + \renewcommand{\procchead}{}% \renewcommand{\proccfoot}{}% % \end{macrocode} %^^A\changes{0.1g}{2007/08/05}{Cmds: using \cmd{\procindexname} in \package{threecolindex.sty} package} @@ -6672,10 +10502,529 @@ $PDFLATEX $TEXFILE.tex % \end{macrocode} % and we are done for the index of authors, as well as for the whole \file{\filename} class! % +% +%^^A------------------------------------------------------------------------ +% \subsubsection{Layout design: show the margin lines} +% +% \begin{macro}{\procmarginlines} +% We define a \cmd{\procmarginlines} command that defines the margin layout under the form of a tabular for \Lopt{showmarginlines=true}: +% \begin{macrocode} +\ifconfproc@showmarginlines + \PackageInfo{confproc}{drawing margin lines' command (with a table)}% + \pagestyle{fancyplain} + \renewcommand{\headrulewidth}{0.0pt} +% \renewcommand{\footrulewidth}{0.0pt} + \newcommand{\procmarginlines}{ + \renewcommand{\footrulewidth}{0.4pt} + \noindent +% \end{macrocode} +% First adjust the initial vertical space: +% \begin{macrocode} + \vspace*{7mm} % adjusting vertical initial space +% \end{macrocode} +% A table is the used to draw the vertical lines (blue color): +% \begin{macrocode} + \begin{table}[h!] % table for vertical lines + \centering + \color{blue} +% \end{macrocode} +% The spacing between columns corresponds to the spacing between vertical lines: +% \begin{macrocode} + \begin{tabular}{|@{}p{3.3in}@{}|@{}p{0.3in}@{}|@{}p{3.3in}@{}|} % spacing between columns & vertical lines +% \end{macrocode} +% The upper horizontal line is added: +% \begin{macrocode} + \hline % upper horizontal line +% \end{macrocode} +% Add empty lines and a vertical space to fill in the table; this space is less than a page height: +% \begin{macrocode} + ~~~~~~~~~~~ & ~ &~~~~~~~~~~~~~\\ + \vspace*{7.5in} % less than a page height + ~~~~~~~~~~~ & ~ &~~~~~~~~~~~~~\\ + \end{tabular} + \end{table} + } +% \end{macrocode} +% the same command is otherwise defined as an empty command if \Lopt{showmarginlines=false}: +% \begin{macrocode} +\else + \newcommand{\procmarginlines}{} + \PackageInfo{confproc}{no margin lines}% +\fi +% \end{macrocode} +% \end{macro} +% +%^^A------------------------------------------------------------------------ +% \subsubsection{paper insertion} +% +% We first define a path to the papers folder: +% \begin{macro}{\PAPERPATH} +% \begin{macrocode} +\newcommand{\PAPERPATH}{} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\confemptypapercite} +% We then define the \cmd{\confemptypapercite} command to insert fake papers' last page (used by the \Lopt{papers=empty} option) with their citations:\changes{0.7}{2010/08/05}{prints an empty paper with its own data including bib items (replacing \Lopt{draft} option)} + +% \begin{macrocode} +\newcommand{\confemptypapercite}[2]{% + \vspace*{0.3\textheight}% + \begin{flushleft} + \begin{tabular}{lp{0.7\textwidth}} + \Large [Title] & \Large \conf@papertitle\\ + & \vspace*{0.5cm}\\ + \Large [Author(s)] & \Large \conf@paperauthor\\ + & \vspace*{0.5cm}\\ + \Large [File name] & \Large \url{\PAPERPATH #2}\\ + & \vspace*{0.5cm}\\ + \if@proc@BibNone + \Large [Citation(s)] & \Large [disabled by ``bib=none'' option]\\ + & \vspace*{2cm}\\ + \else + \Large [Citation(s)] & \Large \confcite{\conf@cite}\\ + & \vspace*{2cm}\\ + \fi + & \textbf{\Huge Page #1}\\ + \end{tabular} + \end{flushleft} +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{conf@npages} +% We now define a counter that contains this paper's last page number: +% \begin{macrocode} +\newcounter{conf@npages} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\confemptypaper} +% We then define the \cmd{\confemptypaper} command to insert fake papers (used by the \Lopt{papers=empty} option) and that makes use of this counter to point to the citation page if any: +% \changes{0.7}{2010/08/05}{prints an empty paper with its own data (replacing \Lopt{draft} option)} +% \begin{macrocode} +\newcommand{\confemptypaper}[2]{% + \vspace*{0.3\textheight}% + \begin{flushleft} + \begin{tabular}{lp{0.7\textwidth}} + \Large [Title] & \Large \conf@papertitle\\ + & \vspace*{0.5cm}\\ + \Large [Author(s)] & \Large \conf@paperauthor\\ + & \vspace*{0.5cm}\\ + \Large [File name] & \Large \url{\PAPERPATH #2}\\ + & \vspace*{0.5cm}\\ + \if@proc@BibNone + \Large [Citation(s)] & \Large [disabled by ``bib=none'' option]\\ + & \vspace*{2cm}\\ + \else + \Large [Citation(s)] & \Large [see page \theconf@npages{} of this paper]\\ + & \vspace*{2cm}\\ + \fi + & \textbf{\Huge Page #1}\\ + \end{tabular} + \end{flushleft} +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\procpaper} +% \newvzdseven{}We now come to the paper insertion \cmd{\procpaper} command, one of the most important command of the whole class. It has been redefined from \cmd{\procinsertpaper} but with key-values options, as suggested by \person{Andreas Matthias}. We first define the command parameters: +% \begin{macrocode} +%%%%% begin key-value option management for \procpaper{} command %%%%% +\newlength{\conf@xshift} +\newlength{\conf@yshift} +\newcounter{conf@switch} +\newcounter{conf@firstpage} +\newcounter{conf@lastpage} +\newcommand{\conf@pagecmd}{} +\newcommand{\conf@tmpauthorlist}{} +\newcommand{\conf@tmptitle}{} +% \end{macrocode} +% +% \begin{macro}{\confstylecheckauthor} +% We also define the style of the author list when overlayed on the \nth{1} page: +% \begin{macrocode} +\newcommand{\confstylecheckauthor}{} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\confstylechecktitle} +% as well as the style of the title when overlayed on the 1 st page: +% \begin{macrocode} +\newcommand{\confstylechecktitle}{} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\confstylechecktitle} +% and a temporary number of pages: +% \begin{macrocode} +\newcounter{locnpages}% +% \end{macrocode} +% \end{macro} +% +% we can now define the \cmd{\procpaper} command with \package{keyval} syntax: +% \changes{0.7}{2010/08/05}{replaces \cmd{\procinsertpaper}} +% \changes{0.7}{2010/08/05}{now uses \package{keyval} package syntax} +% \changes{0.7}{2010/08/05}{now has only 1 mandatory argument (file name) + 8 optional arguments} +% \begin{macrocode} +\def\procpaper{\@ifnextchar[{\@procpaper}{\@procpaper[]}} +% \end{macrocode} +% +% Its default values are set only if the current paper has to be inserted: +% \begin{macrocode} +\def\@procpaper[#1]#2{{% +\ifthenelse{\equal{\confproc@paperselec}{all}\or\equal{\confproc@paperselec}{#2}} + {\setlength{\conf@xshift}{0cm} + \setlength{\conf@yshift}{0cm} + \setcounter{conf@npages}{1} + \setcounter{conf@switch}{1} + \def\conf@papertitle{Default paper title} + \def\conf@paperauthor{Default paper author list} + \def\conf@index{} + \def\conf@cite{} + \def\conf@bookmark{} %\pdfbookmark[2]{Default paper author 1}{p_XXX.author1}} +% \end{macrocode} +% +% and key-values are finally set: +% \begin{macrocode} + \setkeys{ppaper}{#1} +% \end{macrocode} +% +% The horizontal offset is set depending on the binding: +% \begin{macrocode} + \iffalse\@twoside \addtolength{\conf@xshift}{0cm} + \else \addtolength{\conf@xshift}{\proc@binding} \fi + +% \end{macrocode} +% +% We can now insert the PDF paper, depending on the \Lopt{paper} and \Lopt{bib} options, as well as depending on its number of pages. First in the case \Lopt{paper=empty}: +%^^A\changes{0.7}{2010/08/05}{debug the number of pages generated by \Lopt{papers=empty}}\changes{0.7}{2010/08/05}{added \Lopt{paper=empty} option} +% \begin{macrocode} + \if@proc@ReplacePDFs + \immediate\write\npagesfile {file #2.pdf has \theconf@npages \space pages} + \clearsingleordoublepage + \setcounter{conf@firstpage}{\thenpagespreamble+\thepage} + \setcounter{conf@lastpage}{\thenpagespreamble+\thepage+% + \theconf@npages-1} + + \phantomsection + \addcontentsline{toc}{section}{\proctoctitleauthor{\conf@papertitle}% + {\conf@paperauthor}} + \ifnum\theconf@npages=0 + \typeout{confproc: Error, you asked for an empty paper} + \typeout{confproc: #2.pdf} + \fi + \ifnum\theconf@npages=1 + \confemptypapercite{1}{#2.pdf} \conf@bookmark \conf@index{}% + \fi + \ifnum\theconf@npages=2 + \confemptypaper{1}{#2.pdf} \conf@bookmark \conf@index{}% + \newpage \confemptypapercite{2}{#2.pdf} + \fi + \ifnum\theconf@npages>2 + \confemptypaper{1}{#2.pdf} \conf@bookmark \conf@index{}% + \setcounter{locnpages}{2} + \ifthenelse{\thelocnpages<\theconf@npages}% + {\typeout{smaller}}% + {\typeout{bigger}} + \whiledo{\value{locnpages}<\value{conf@npages}}{% + \newpage \confemptypaper{\thelocnpages}{#2.pdf}% + \addtocounter{locnpages}{1}} + \newpage \confemptypapercite{\theconf@npages}{#2.pdf} + \fi +% \end{macrocode} +% we finaly set the counter for the last page number of the current empty paper: +% \begin{macrocode} + \setcounter{conf@lastpage}{\thenpagespreamble+\thepage} +% \end{macrocode} +% +% Second, in the case \Lopt{paper=draft} $\mid$ \Lopt{final} $\mid$ \Lopt{countpages}: +% \begin{macrocode} + \else + \setcounter{conf@firstpage}{\thenpagespreamble+\thepage} + \conf@index{}% + \ifconfproc@showpapernumber + \cfoot{\color{\confproc@colorheaders}\vskip \procfootvskip % + \vskip \procoptfootvskip \proccfoot\\ + \color{\confproc@colorheaders}[paper \theconf@switch{}]}{} +% \else +% % TODO: DO WE DO ANYTHING OTHERWISE? + \fi + \ifconfproc@checktitle + \renewcommand{\conf@tmptitle}{{\color{blue}% + \confstylechecktitle\conf@papertitle}} + \else + \renewcommand{\conf@tmptitle}{} + \fi + \ifconfproc@checkauthor + \renewcommand{\conf@tmpauthorlist}{{\color{blue}% + \confstylecheckauthor\conf@paperauthor}} + \else + \renewcommand{\conf@tmpauthorlist}{} + \fi + \renewcommand{\conf@pagecmd}{\conf@tmptitle\\ \conf@tmpauthorlist} + +% \end{macrocode} +% +% In the particular case where \Lopt{paper=countpages}, the user-indicated number of pages is ignored: +% \begin{macrocode} + \if@proc@IncludeFullPDFs % include all pages in order to count!!! + \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},pages=1,% + linktodoc,linkname=\PAPERPATH #2.pdf,% + addtotoc={1, section, 1, % + \proctoctitleauthor{\conf@papertitle}{\conf@paperauthor},% + \theconf@switch},% + pagecommand = {\conf@pagecmd\procmarginlines % + \conf@bookmark \PDFpagestyle}% + ]{\PAPERPATH #2.pdf}% + \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},pages=2-,% + linktodoc,linkname=\PAPERPATH #2.pdf,% + pagecommand = {\procmarginlines \PDFpagestyle}% + ]{\PAPERPATH #2.pdf}% +% \end{macrocode} +% +% Otherwise, we include either a 1-page paper:\changes{0.7}{2010/08/05}{manage 1-page long document} +% \begin{macrocode} + \else + \ifnum\theconf@npages=1 % 1-page paper + \if@proc@verbose + \typeout{confproc: 1-page long paper} + \fi + \if@proc@BibNone + \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},% + pages=1,linktodoc,linkname=\PAPERPATH #2.pdf,% + addtotoc={1, section, 1, % + \proctoctitleauthor{\conf@papertitle}{\conf@paperauthor},% + \theconf@switch},% + pagecommand = {\conf@pagecmd\procmarginlines % + \conf@bookmark \PDFpagestyle}% + ]{\PAPERPATH #2.pdf}% + \else + \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},% + pages=1,linktodoc,linkname=\PAPERPATH #2.pdf,% + addtotoc={1, section, 1,% + \proctoctitleauthor{\conf@papertitle}{\conf@paperauthor},% + \theconf@switch},% + pagecommand = {\conf@pagecmd\procmarginlines % + \conf@bookmark \PDFpagestyle\vspace*{-1cm}\confcite{\conf@cite}}% + ]{\PAPERPATH #2.pdf}% + \fi + \else +% \end{macrocode} +% +% a 2-pages paper: +% \begin{macrocode} + \ifnum\theconf@npages=2 % 2-pages paper + \if@proc@verbose\typeout{confproc: 2-page long paper}\fi + \if@proc@BibNone + \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},% + pages=1,linktodoc,linkname=\PAPERPATH #2.pdf,% + addtotoc={1, section, 1, % + \proctoctitleauthor{\conf@papertitle}{\conf@paperauthor},% + \theconf@switch},% + pagecommand = {\conf@pagecmd\procmarginlines \conf@bookmark % + \PDFpagestyle}% + ]{\PAPERPATH #2.pdf}% + \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},% + pages=2,linktodoc,linkname=\PAPERPATH #2.pdf,% + pagecommand = {\procmarginlines \PDFpagestyle}% + ]{\PAPERPATH #2.pdf}% + \else + \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},% + pages=1,linktodoc,linkname=\PAPERPATH #2.pdf,% + addtotoc={1, section, 1, % + \proctoctitleauthor{\conf@papertitle}{\conf@paperauthor},% + \theconf@switch},% + pagecommand = {\conf@pagecmd\procmarginlines \conf@bookmark % + \PDFpagestyle\vspace*{-1cm}\confcite{\conf@cite}}% + ]{\PAPERPATH #2.pdf}% + \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},% + pages=2,linktodoc,linkname=\PAPERPATH #2.pdf,% + pagecommand = {\procmarginlines % + \PDFpagestyle\vspace*{-2cm}\confcite{\conf@cite}}% + ]{\PAPERPATH #2.pdf}% + \fi +% \end{macrocode} +% +% or a 3 (and more)-pages paper:\changes{0.7}{2010/08/05}{manages $\ge$ 3-pages long documents (no more limited to 8)} +% \begin{macrocode} + \else % 3 pages and more + \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},% + pages=1,% + linktodoc,linkname=\PAPERPATH #2.pdf,% + addtotoc={1, section, 1, % + \proctoctitleauthor{\conf@papertitle}{\conf@paperauthor},% + \theconf@switch},% + pagecommand = {\conf@pagecmd\procmarginlines % + \conf@bookmark \PDFpagestyle}% + ]{\PAPERPATH #2.pdf}% + \ifdefined\conf@BibMerge% + \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},% + pages=\theconf@npages,linktodoc,linkname=\PAPERPATH #2.pdf,% + pagecommand = {\procmarginlines % + \PDFpagestyle\vspace*{-2cm}\confcite{\conf@cite}}% + ]{\PAPERPATH #2.pdf}% + \PDFpagestyle{}% + \if@proc@verbose\typeout{confproc: bibliography insertion only}\fi + \else + \addtocounter{conf@npages}{-1} + \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},% + pages=2-\theconf@npages,linktodoc,linkname=\PAPERPATH #2.pdf,% + pagecommand = {\procmarginlines \PDFpagestyle}% + ]{\PAPERPATH #2.pdf}% + \PDFpagestyle{}% + \addtocounter{conf@npages}{1} + \if@proc@BibNone + \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},% + pages=\theconf@npages,linktodoc,linkname=\PAPERPATH #2.pdf,% + pagecommand = {\procmarginlines \PDFpagestyle}% + ]{\PAPERPATH #2.pdf}% + \else + \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},% + pages=\theconf@npages,linktodoc,linkname=\PAPERPATH #2.pdf,% + pagecommand = {\procmarginlines % + \PDFpagestyle\vspace*{-2cm}\confcite{\conf@cite}}% + ]{\PAPERPATH #2.pdf}% + \fi + \fi + \fi + \fi + \if@proc@verbose + \typeout{confproc: partial paper insertion % + (last page=bib items)} + \fi + \fi +% \end{macrocode} +% +% we compute the number of pages and write it to the file that counts the number of pages: +% \changes{0.7}{2010/08/05}{counts each paper's number of pages and prints output into \file{.npc} file} +% \begin{macrocode} + \setcounter{conf@lastpage}{\thenpagespreamble+\thepage-1} + \setcounter{conf@npages}{\theconf@lastpage} + \addtocounter{conf@npages}{- \theconf@firstpage} + \immediate\write\npagesfile{file #2.pdf has \theconf@npages \space pages} +% \end{macrocode} +% +% and finally turn the page for next paper or section: +% \begin{macrocode} + \newpage + \ifconfproc@twosidepapers \cleardoublepage + \else \clearpage \fi + \fi +% \end{macrocode} +% +% Let us also give some feedback to the user when \Lopt{verbose=true}: +% \begin{macrocode} + \if@proc@verbose + \typeout{______ debug: insert paper ______} + \typeout{confproc/file: #2.pdf (\theconf@npages \space pages)} + \typeout{confproc/title: \conf@papertitle} + \typeout{confproc/authors: \conf@paperauthor} + \typeout{confproc/index: \conf@index} + \typeout{confproc/shift: (\the\conf@xshift, \the\conf@yshift)} + \typeout{confproc/citations: \conf@cite} + \typeout{confproc/bookmarks: \conf@bookmark} + \typeout{confproc/switch ID: \theconf@switch} + \typeout{_______________________} + \fi +% \end{macrocode} +% We then append the current paper's data to the \package{pdftk}\footnote{Get \package{pdftk} at: \url{http://www.accesspdf.com/pdftk/}} output file: +% \begin{macrocode} + \ifconfproc@pdftk +% \immediate\write\pdftkinfoall {________________} +%%-- pdftk version: !!! does not work with PDF v > 1.3 +%% \immediate\write\pdftkinfoall{pdftk A=${PDFFILE} cat A\arabic{conf@firstpage}-\arabic{conf@lastpage} output ${SPPATH}/#2.pdf} +%%-- Ghostscript version: ok with PDF v = 1.4 + \immediate\write\pdftkinfoall{gs -dBATCH -dNOPAUSE -q -sDEVICE=pdfwrite -dFirstPage=\arabic{conf@firstpage} -dLastPage=\arabic{conf@lastpage} -sOUTPUTFILE=${SPPATH}/#2.pdf ${PDFFILE}} + +% \end{macrocode} +% +% Such text is also written to individual files in the selected folder: +% \begin{macrocode} +%%-- pdftk version: !!! does not work with PDF v > 1.3 +%% \immediate\write\pdftkinfoall{pdftk A=${PDFFILE} cat A\arabic{conf@firstpage}-\arabic{conf@lastpage} output ${SPPATH}/#2.pdf} +%%-- Ghostscript version: ok with PDF v = 1.4 + \immediate\openout\pdftkinfofile=\confproc@pdftkfolder/#2.pdftk + \immediate\write\pdftkinfofile {InfoKey: Title} + \immediate\write\pdftkinfofile {InfoValue: \conf@papertitle} + \immediate\write\pdftkinfofile {InfoKey: Author} + \immediate\write\pdftkinfofile {InfoValue: \conf@paperauthor} + \immediate\write\pdftkinfofile {InfoKey: Subject} + \immediate\write\pdftkinfofile {InfoValue: \confproc@pdftksubject} + \immediate\write\pdftkinfofile {InfoKey: Producer} + \immediate\write\pdftkinfofile {InfoValue: \confproc@pdftkproducer} + \immediate\write\pdftkinfofile {InfoKey: Creator} + \immediate\write\pdftkinfofile {InfoValue: \confproc@pdftkcreator} + \immediate\closeout\pdftkinfofile +% \end{macrocode} +% +% Finally, this text is also written to the log when \Lopt{verbose=true}: +% \begin{macrocode} + \ifconfproc@verbose + \typeout{________________} + \typeout{pdftk A=${PDFFILE} cat A\arabic{conf@firstpage}-\arabic{conf@lastpage} output ${SPPATH}/#2.pdf} + \typeout{gs -dBATCH -dNOPAUSE -q -sDEVICE=pdfwrite -dFirstPage=\arabic{conf@firstpage} -dLastPage=\arabic{conf@lastpage} -sOUTPUTFILE=${SPPATH}/#2.pdf ${PDFFILE}} +% \typeout{pdftk ${SPPATH}/#2.pdf update_info ${INPATH}/#2.info output ${INPATH}/#2.pdf} + \typeout{InfoName: #2.info} + \typeout{InfoKey: Title} + \typeout{InfoValue: \conf@papertitle} + \typeout{InfoKey: Author} + \typeout{InfoValue: \conf@paperauthor} + \typeout{InfoKey: Subject} + \typeout{InfoValue: \confproc@pdftksubject} + \typeout{InfoKey: Producer} + \typeout{InfoValue: \confproc@pdftkproducer} + \typeout{InfoKey: Creator} + \typeout{InfoValue: \confproc@pdftkcreator} + \typeout{InfoEnd} + \fi + \fi + }{} +}} +% \end{macrocode} +% +% We finally set the key-values using the pre-defined internal commands: +% \begin{macrocode} +\define@key{ppaper}{xshift}{\setlength{\conf@xshift}{#1}} +\define@key{ppaper}{yshift}{\setlength{\conf@yshift}{#1}} +\define@key{ppaper}{npages}{\setcounter{conf@npages}{#1}} +\define@key{ppaper}{switch}{\setcounter{conf@switch}{#1}} +\define@key{ppaper}{title}{\def\conf@papertitle{#1}} +\define@key{ppaper}{author}{\def\conf@paperauthor{#1}} +\define@key{ppaper}{index}{\def\conf@index{#1}} +\define@key{ppaper}{cite}{\def\conf@cite{#1}} +\define@key{ppaper}{bookmark}{\def\conf@bookmark{#1}} +%%%%% end key-value option management for \procpaper{} command %%%%% +% \end{macrocode} +% \end{macro} +% +% +% \begin{macro}{\procinsertpaper} +% We also redefine its pre-version 0.6 using this latest function, for (partial) backward compatibility: +% \changes{0.4a}{2007/10/03}{manages 1-page long papers (no ref printed yet)} +% \changes{0.4c}{2007/10/12}{author is back in bookmark (missing \#9 arg in \cmd{\pagecommand}, bug in v0.4a)} +% \changes{0.6}{2009/09/08}{now uses \cmd{\procpaper}} +% +% \begin{macrocode} +\newcommand{\procinsertpaper}[9]{% +% \end{macrocode} +% It has the following 9 arguments: i) X (=horizontal) and Y (=vertical) shifts (with a space in between), ii) number of pages, iii) a reference, iv) the title, v) the list of authors, vi) the index entries, vii) the citations for the general bibliography, viii) the PDF file name and ix the bookmark entries for the authors. Note that the horizontal and vertical shifts are no more preserved, so please serioulsy consider using the lates \cmd{\procpaper} command. +% \begin{macrocode} + \PackageWarning{confproc}{!!! '\procinsertpaper' cmd is obsolete (v0.5) % + and does not preserve PDFs' horizontal and vertical shifts, nor general % + bib items. Please use the '\procpaper' command instead.} + \procpaper[title={#4},author={#5},npages=#2,index={#6},cite={#7},% + bookmark={#9}]{#8}} +% \end{macrocode} +% \end{macro} +% +% \color{black} +% +% %^^A ================================================================= %^^A Config file %^^A ================================================================= -% \subsection{Load Configuration} +% \subsection{Load configuration} % \label{subsec:loadconfig} % % Input a local configuration file (\file{confproc.cfg}), if it @@ -6698,8 +11047,3 @@ $PDFLATEX $TEXFILE.tex \endinput % % \fi -% end of file `confproc.dtx' -%%% Local Variables: -%%% mode: latex -%%% TeX-master: t -%%% End: \ No newline at end of file diff --git a/Master/texmf-dist/source/latex/confproc/confproc.ins b/Master/texmf-dist/source/latex/confproc/confproc.ins index 7da97e7a267..9b2fc8d1aee 100644 --- a/Master/texmf-dist/source/latex/confproc/confproc.ins +++ b/Master/texmf-dist/source/latex/confproc/confproc.ins @@ -1,10 +1,10 @@ %% LaTeX2e file `confproc.ins' %% generated by the `filecontents' environment -%% from source `confproc' on 2007/10/17. +%% from source `confproc' on 2010/08/05. %% %% confproc.ins, the batch file for the confproc package -%% Copyright (C) 2007 by Vincent Verfaille -%% +%% Copyright (c) 2010 by Vincent Verfaille +%% %% %% This file is part of the confproc package. %% ------------------------------------------- @@ -26,7 +26,7 @@ %% confproc.dtx. %% %% The list of all files belonging to the confproc package is given -%% in the file `readme.txt'. +%% in the `readme.txt' file. %% %% This file will generate fast loadable files and documentation %% driver files from the .dtx files in this package when run through @@ -56,8 +56,8 @@ % \def\nline{^^J\MetaPrefix\space}% \def\stdtext{% -Copyright (C) 2007 by Vincent Verfaille - \nline\nline% +Copyright (c) 2010 by Vincent Verfaille + \nline\nline% This file is part of the confproc package.\nline% -------------------------------------------\nline\nline% It may be distributed and/or modified under the conditions of the\nline% @@ -70,7 +70,7 @@ and version 1.2 or later is part of all distributions of LaTeX version\nline% This file may not be distributed without the original source file\nline% `\inFileName'.\nline\nline% The list of all files belonging to the confproc package is given in\nline% -the file `readme.txt'.} +the `readme.txt' file.} % %% Declare preambles (and use \stdtext): % @@ -93,6 +93,9 @@ This is `\outFileName', a LaTeX2e package to build conference proceedings. For more details, LaTeX the source `\inFileName'. +\endpreamble% +% +\declarepreamble\scripts \endpreamble% % \declarepreamble\example @@ -117,8 +120,9 @@ For more details, LaTeX the source `\inFileName'. % %% Greeting: % -\askforoverwritetrue% -\askonceonly% +\askforoverwritefalse +%%\askforoverwritetrue% uncomment if you wish to avoid over-writing a file +%%\askonceonly% better of commented as it asks SEVERAL times % \ifToplevel{% \Msg{}% @@ -134,23 +138,36 @@ For more details, LaTeX the source `\inFileName'. %% File generation: % \generate{% - \usepreamble\example\file{example.tex}{\from{confproc.dtx}{example}}% - \usepreamble\example\file{expapersswitch.tex}{\from{confproc.dtx}{expapersswitch}}% - \usepreamble\example\file{expages.tex}{\from{confproc.dtx}{expages}}% - \usepreamble\example\file{exclasspre.tex}{\from{confproc.dtx}{exclasspre}}% - \usepreamble\example\file{exclasslast.tex}{\from{confproc.dtx}{exclasslast}}% - \nopreamble\nopostamble\file{exbiblio.bib}{\from{confproc.dtx}{exbiblio}}% - \nopreamble\nopostamble\file{procswitchandtoc.pl}{\from{confproc.dtx}{procswitchandtoc}}% - \nopreamble\nopostamble\file{exprogram.csv}{\from{confproc.dtx}{exprogram}}% - \nopreamble\nopostamble\file{buildpapers}{\from{confproc.dtx}{buildpapers}}% - \nopreamble\nopostamble\file{buildproc}{\from{confproc.dtx}{buildproc}}% - \nopreamble\nopostamble\file{buildcppdfpapers}{\from{confproc.dtx}{buildcppdfpapers}}% + \nopreamble\nopostamble\file{prepareexample.sh}{\from{confproc.dtx}{prepareexample}}% + \usepreamble\example\file{example1empty.tex}{\from{confproc.dtx}{example1empty}}% + \file{example2custom.tex}{\from{confproc.dtx}{example2custom}}% + \file{example3optim.tex}{\from{confproc.dtx}{example3optim}}% + \file{expapersswitch.tex}{\from{confproc.dtx}{expapersswitch}}% + \file{expages.tex}{\from{confproc.dtx}{expages}}% + \nopreamble\nopostamble\file{exclasspre.tex}{\from{confproc.dtx}{exclasspre}}% + \file{exclasslastel.tex}{\from{confproc.dtx}{exclasslastel}}% + \file{exclasslastpb.tex}{\from{confproc.dtx}{exclasslastpb}}% + \file{exbiblio.bib}{\from{confproc.dtx}{exbiblio}}% + \file{generateswitch.pl}{\from{confproc.dtx}{generateswitch}}% + \file{exprogram.csv}{\from{confproc.dtx}{exprogram}}% + \file{buildpapers.sh}{\from{confproc.dtx}{buildpapers}}% + \file{buildproc.sh}{\from{confproc.dtx}{buildproc}}% + \file{buildprocelpb.sh}{\from{confproc.dtx}{buildprocelpb}}% + \file{buildcppdfpapers.sh}{\from{confproc.dtx}{buildcppdfpapers}}% + \file{countnbpages.sh}{\from{confproc.dtx}{countnbpages}}% + \file{removeLaTeXcmds.sh}{\from{confproc.dtx}{removeLaTeXcmds}}% + \file{exportIndividualPDFs.sh}{\from{confproc.dtx}{exportIndividualPDFs}}% + \file{papersinfo.sh}{\from{confproc.dtx}{papersinfo}}% + \file{paperssplitpreamble.sh}{\from{confproc.dtx}{paperssplitpreamble}}% +% \nopreamble\nopostamble\file{newapave.bst}{\from{confproc.dtx}{newapavebst}}% +% \nopreamble\nopostamble\file{newapave2.sty}{\from{confproc.dtx}{newapavesty}}% DO NOT UNCOMMENT OTHERWISE IT STRIPS A SECONDTIME THE COMMENTS... +% \usepreamble\example\file{example4optim.tex}{\from{confproc.ins}{example4optim}}% +% \usedir{tex/latex/misc}% \usepreamble\driver\file{confproc.drv}{\from{confproc.dtx}{driver}}% \usepreamble\config\file{confproc.cfg}{\from{confproc.dtx}{config}}% -% \usedir{tex/latex/misc}% \usepreamble\package\file{confproc.cls}{\from{confproc.dtx}{package}% - \nopreamble\nopostamble\file{buildcls}{\from{confproc.dtx}{buildcls}}% - \nopreamble\nopostamble\file{cleancls}{\from{confproc.dtx}{cleancls}}% + \nopreamble\nopostamble\file{buildcls.sh}{\from{confproc.dtx}{buildcls}}% + \nopreamble\nopostamble\file{cleancls.sh}{\from{confproc.dtx}{cleancls}}% }% }% % @@ -164,8 +181,8 @@ For more details, LaTeX the source `\inFileName'. \Msg{* To finish the installation you have to move the following}% \Msg{* file into a directory searched by LaTeX:}% }{% - \Msg{* The following file has been automatically created in a} - \Msg{* directory searched by LaTeX:} + \Msg{* The following file has been automatically created in a}% + \Msg{* directory searched by LaTeX:}% }\makeatother% \Msg{*}% \Msg{* \space\space confproc.cls}% @@ -184,7 +201,7 @@ For more details, LaTeX the source `\inFileName'. \Msg{* following files through LaTeX:}% \Msg{*}% \Msg{* \space\space confproc.drv (three times)}% - \Msg{* \space\space example.tex}% + \Msg{* \space\space exampleN.tex}% \Msg{*}% \Msg{* For the legal stuff please have a look at:}% \Msg{*}% @@ -196,5 +213,4 @@ For more details, LaTeX the source `\inFileName'. \Msg{********************}% \Msg{}% }% -% \endbatchfile -- cgit v1.2.3