Debian Codegraph @

texmf-dist/source/latex/confproc/confproc.dtx

raw
1 %^^A =================================================================
2 %^^A Some basic integrity-test stuff
3 %^^A =================================================================
4 % \CheckSum{1704}
5 %
6 % \iffalse
7 %<*ID>
8 % \CharacterTable
9 % {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
10 % Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
11 % Digits \0\1\2\3\4\5\6\7\8\9
12 % Exclamation \! Double quote \" Hash (number) \#
13 % Dollar \$ Percent \% Ampersand \&
14 % Acute accent \' Left paren \( Right paren \)
15 % Asterisk \* Plus \+ Comma \,
16 % Minus \- Point \. Solidus \/
17 % Colon \: Semicolon \; Less than \<
18 % Equals \= Greater than \> Question mark \?
19 % Commercial at \@ Left bracket \[ Backslash \\
20 % Right bracket \] Circumflex \^ Underscore \_
21 % Grave accent \` Left brace \{ Vertical bar \|
22 % Right brace \} Tilde \~}
23 %^^A =================================================================
24 %^^A Here is a `conference proceedings' class.
25 %^^A For a short installation guide, see below
26 %^^A =================================================================
27 %%% @LaTeX-package-file{
28 %%% author = "Vincent Verfaille",
29 %%% version = "v0.8",
30 %%% date = "$Date: 2011/08/01 00:00:01 $",
31 %%%^^A ^^A\changes{0.1d}{2007/07/31}{Renaming 'procconf' into 'confproc'}
32 %%% filename = "confproc.dtx,
33 %%% address = "Vincent Verfaille, Montreal, QC, Canada",
34 %%% URL = "http://vincent.verfaille.free.fr/confproc/",
35 %%% email = "[email protected]",
36 %%% codetable = "ISO/ASCII",
37 %%% keywords = "conference, proceedings, documentclass, build, tools",
38 %%% dependencies = "\LaTeXe",
39 %%% supported = "yes",
40 %%% abstract = " Confproc is a LaTeX2e package providing a new document-class together
41 %%% with various tools (Perl and Unix/bash scripts) for building conference
42 %%% proceedings, or concatenating any set of PDFs with a table of contents,
43 %%% index, bookmarks and general bibliography. The LaTeX2e class is mainly
44 %%% based on the 'pdfpages' package for PDF papers inclusion, and the
45 %%% 'hyperref' package for creating proper links, bookmarks and general
46 %%% bibliography back references. It also uses many other packages for fine
47 %%% tuning the table of contents, bibliography and index of authors.
48 %%% Current version 0.8 is the previous 0.7 major update with key-value option
49 %%% management, that has now been tested with TeXLive 2011.
50 %%% The added value of this class is in the time saved to quickly design
51 %%% conference proceedings or any collection of PDFs."
52 %%% docstring = "LaTeX2e package providing a new document-class together
53 %%% with various tools (Perl and Unix/bash scripts) for building conference
54 %%% proceedings, or concatenating any set of PDFs with a table of contents,
55 %%% index, bookmarks and general bibliography.",
56 %%% copyright = "confproc.dtx, the documented macro-file for the confproc package
57 %%% Copyright (c) 2011 by Vincent Verfaille
58 %%% <[email protected]>
59 %%%
60 %%% This program may be distributed and/or modified under the conditions
61 %%% of the LaTeX Project Public License, either version 1.2 of this license
62 %%% or (at your option) any later version.
63 %%%
64 %%% The latest version of this license is in
65 %%% http://www.latex-project.org/lppl.txt
66 %%% and version 1.2 or later is part of all distributions of LaTeX version
67 %%% 1999/12/01 or later.
68 %%%
69 %%% This program consists of the confproc.dtx file."
70 %%% }
71 %</ID>
72 %\changes{0.8}{2011/08/01}{Info: corrected author email!}
73 %
74 %<*install>
75 %^^A =================================================================
76 %^^A Purpose of this package
77 %^^A =================================================================
78 %
79 % Confproc is a LaTeX2e package providing a new document-class together
80 % with various tools (Perl and Unix/bash scripts) for building conference
81 % proceedings, or concatenating any set of PDFs with a table of contents,
82 % index, bookmarks and general bibliography. The LaTeX2e class is mainly
83 % based on the \package{pdfpages} package for PDF papers inclusion, and the
84 % \package{hyperref} package for creating proper links, bookmarks and general
85 % bibliography back references. It also uses many other packages for fine
86 % tuning the table of contents, bibliography and index of authors.
87 % Current version 0.8 is the previous 0.7 major update with key-value option
88 % management, that has now been tested with TeXLive 2011.
89 % The added value of this class is in the time saved to quickly design
90 % conference proceedings or any collection of PDFs.
91 %
92 %^^A =================================================================
93 %^^A Installation of this package
94 %^^A =================================================================
95 % Installation:
96 % LaTeX this file: creates docstrip installation file
97 % confproc.ins, readme.txt AND the (LaTeX2e)
98 % documentation
99 % (La)TeX confproc.ins: creates class file confproc.cls, example
100 % file exampleN.tex and documentation
101 % driver confproc.drv
102 %
103 % Docstrip options available:
104 % package - to produce a (LaTeX2e) class file (.cls)
105 % driver - to produce a driver file to print the documentation
106 % example - to produce example files, which demonstrate the
107 % possibilities of this package
108 %</install>
109 %
110 % \fi
111 % \iffalse
112 %\changes{0.1}{2007/08/01}{Readme updated}
113 %<*readme>
114 %^^A =================================================================
115 %^^A Here is the readme.txt file
116 %^^A It is written on first LaTeX run if it does not already exist
117 %^^A =================================================================
118 \begin{filecontents*}{readme.txt}
119 The confproc package
120
121 ($Date: 2010/08/01 00:00:01 $)
122
123 Copyright (c) 2011 by Vincent Verfaille
124 <[email protected]>
125
126 Purpose:
127 Confproc is a LaTeX2e package providing a new document-class together
128 with various tools (Perl and Unix/bash scripts) for building conference
129 proceedings, or concatenating any set of PDFs with a table of contents,
130 index, bookmarks and general bibliography. The LaTeX2e class is mainly
131 based on the 'pdfpages' package for PDF papers inclusion, and the
132 'hyperref' package for creating proper links, bookmarks and general
133 bibliography back references. It also uses many other packages for fine
134 tuning the table of contents, bibliography and index of authors.
135 Current version 0.8 is the previous 0.7 major update with key-value option
136 management, that has now been tested with TeXLive 2011.
137 The added value of this class is in the time saved to quickly design
138 conference proceedings or any collection of PDFs.
139
140 Files:
141 - main file:
142 confproc.dtx Docstrip archive
143 To generate the doc, run this through LaTeX.
144
145 - class files:
146 confproc.ins Batch file (do: pdflatex confproc.dtx)
147 confproc.drv Driver for documentation (do: pdflatex confproc.ins)
148 Edit to generate customized doc + pdflatex confproc.drv
149 confproc.cls LaTeX package (do: pdflatex confproc.ins)
150 confproc.cfg Configuration file (do: pdflatex confproc.ins)
151 confproc.dvi Package documentation (do: pdflatex confproc.drv)
152
153 - example files (do: pdflatex confproc.ins):
154 confproc1.ist Index style
155 confproc2.ist Index style
156 example1empty.tex Simplest example file
157 example2custom.tex Customized example file
158 example3optim.tex Idem with automatic program generation
159 example4optim.tex Idem with option management
160 expapersswitch.tex Paper switch for paper insertion
161 exsessions.tex Program sessions
162 exclasspre.tex Class options for 1st pdflatex runs on 'example4optim.tex'
163 exclasslastpb.tex Class options for last pdflatex run (paperback version)
164 exclasslastel.tex Class options for last pdflatex run (electronic version)
165 exbiblio.bib Bibliography for example*optim.tex
166 exprogram.csv Comma-separated conference program
167 newapave.bst Bibliography style from 'newapa.bst'
168 newapave.sty Bibliography style from 'newapa.sty'
169
170 - example scripts (do: pdflatex confproc.ins):
171 prepareexample.sh Unix/bash script to prepare example files and
172 folders (used it after running LaTeX on .dtx and .ins)
173 buildproc.sh Unix/bash script: build the 'example3optim.tex' example
174 buildprocelpb.sh Unix/bash script: build the 'example4optim.tex'
175 example with paperback and electronic PDF versions
176 & individual papers extracted
177 buildpapers.sh Unix/bash script: re-build all the papers
178 buildcppdfpapers.sh Unix/bash script: copy papers to the right spot
179 countnbpages.sh Unix/bash script: count PDFs nb of pages
180 Requires 'pdftk' to be installed. Get it from:
181 http://www.pdftk.com or http://www.accesspdf.com/pdftk/
182 exportIndividualPDFs.sh Unix/bash scrit using pdftk to extract
183 each individual paper from the proceedings,
184 for proper page numbering and headers.
185 Requires 'pdftk' and 'Ghostscript' to be installed.
186 generateswitch.pl Perl script generating 'expapersswitch.tex'
187 from 'exprogram.csv'.
188 Requires Perl to be installed.
189 papersinfo.sh Unix/bash script to generate individual PDFs
190 with proper metadata. Requires 'pdftk' to be installed.
191 paperssplitpreamble.sh preamble of a Unix/bash script (papersplit.sh)
192 generated by exportIndividualPDFs.sh
193 removeLaTeXcmds.sh Unix/bash script to remove LaTeX accents and
194 commands for titles in PDF metadata.
195 Requires Perl to be installed.
196
197
198 Read me:
199 readme.txt This file (do: pdflatex confproc.dtx)
200
201
202 Installation:
203 pdflatex confproc.dtx Creates docstrip installation file
204 confproc.ins and this file
205 pdflatex confproc.ins Creates 'confproc.cls' class file, example
206 files, scripts and documentation drive 'confproc.drv'
207
208 Docstrip options available:
209 package - to produce a (LaTeX2e) class file (.cls)
210 driver - to produce a driver file to print the documentation
211 example - to produce an example file, which demonstrates the
212 possibilities of the package
213
214 Move confproc.cls into a directory searched by LaTeX.
215 pdflatex confproc.dtx Creates the (LaTeX2e) documentation.
216
217 optionally:
218 Edit confproc.drv and customize the documentation to your wishes.
219 LaTeX confproc.drv Generates customized documentation.
220 Depending on your customization you will have to run
221 makeindex confproc.idx -s gind.ist -o confproc.ind
222 and/or
223 makeindex confproc.glo -s gglo.ist -o confproc.gls
224 pdfLaTeX example*.tex Demonstrate the possibilities of this package.
225
226
227 Contact:
228 E-Mail: [email protected]
229 Address: Vincent Verfaille, Montreal, QC, Canada
230
231 Legal stuff:
232 readme.txt, the ReadMe file for the confproc package
233 Copyright (c) 2011 by Vincent Verfaille
234 <[email protected]>
235
236 This file is part of the confproc package.
237 -------------------------------------------
238
239 There is no warranty for the confproc package. I provide the
240 program `as is', without warranty of any kind, either expressed or
241 implied, including, but not limited to, the implied warranties of
242 merchantability and fitness for a particular purpose. The entire
243 risk as to the quality and performance of the program is with you.
244 Should the program prove defective, you assume the cost of all
245 necessary servicing, repair, or correction.
246
247 This program may be distributed and/or modified under the
248 conditions of the LaTeX Project Public License, either version 1.2
249 of this license or (at your option) any later version.
250
251 The latest version of this license is in
252 http://www.latex-project.org/lppl.txt
253 and version 1.2 or later is part of all distributions of LaTeX
254 version 1999/12/01 or later.
255
256 This is a generated file. It may not be distributed without the
257 original source file confproc.dtx.
258
259 This program consists of the confproc.dtx file.
260
261 Files generated by means of unpacking this program using the
262 docstrip program may be distributed at the distributor's
263 discretion. However if they are distributed then a copy of
264 this program must be distributed together with them.
265 \end{filecontents*}
266 %</readme>
267 %
268 %\changes{0.1}{2007/08/01}{Class package finished. Switching to docstrip}
269 %\changes{0.1}{2007/08/01}{Adding creation of all Unix scripts and example files (using \cmd{\nopreamble} and \cmd{\nopostamble}}
270 %<*installer>
271 %^^A =================================================================
272 %^^A Here is the docstrip installation file
273 %^^A It is written on first LaTeX run if it does not already exist
274 %^^A =================================================================
275 \begin{filecontents}{confproc.ins}
276 %% confproc.ins, the batch file for the confproc package
277 %% Copyright (c) 2011 by Vincent Verfaille
278 %% <[email protected]>
279 %%
280 %% This file is part of the confproc package.
281 %% -------------------------------------------
282 %%
283 %% It may be distributed and/or modified under the conditions of the
284 %% LaTeX Project Public License, either version 1.2 of this license or
285 %% (at your option) any later version.
286 %%
287 %% The latest version of this license is in
288 %% http://www.latex-project.org/lppl.txt
289 %% and version 1.2 or later is part of all distributions of LaTeX
290 %% version 1999/12/01 or later.
291 %%
292 %% In particular, NO PERMISSION is granted to modify the contents of
293 %% this file since it contains the legal notices that are placed in
294 %% the files it generates.
295 %%
296 %% This file may not be distributed without the original source file
297 %% confproc.dtx.
298 %%
299 %% The list of all files belonging to the confproc package is given
300 %% in the `readme.txt' file.
301 %%
302 %% This file will generate fast loadable files and documentation
303 %% driver files from the .dtx files in this package when run through
304 %% LaTeX or TeX.
305 %%
306 %% ------------------- start of docstrip commands -------------------
307 \def\batchfile{confproc.ins}
308 \input docstrip.tex
309 %
310 \ifToplevel{\ifx\askonceonly\undefined%
311 \Msg{******************}%
312 \Msg{*}%
313 \Msg{* This installation requires docstrip}%
314 \Msg{* version 2.4e or later.}%
315 \Msg{*}%
316 \Msg{* An older version of docstrip has been input}%
317 \Msg{*}%
318 \Msg{******************}%
319 \errhelp{Move or rename old docstrip.tex.}%
320 \errmessage{Old docstrip in input path}%
321 \batchmode%
322 \csname @@end\endcsname%
323 \fi%
324 }%
325 %
326 %% Define standard text:
327 %
328 \def\nline{^^J\MetaPrefix\space}%
329 \def\stdtext{%
330 Copyright (c) 2011 by Vincent Verfaille
331 <[email protected]>\nline\nline%
332 This file is part of the confproc package.\nline%
333 -------------------------------------------\nline\nline%
334 It may be distributed and/or modified under the conditions of the\nline%
335 LaTeX Project Public License, either version 1.2 of this license or\nline%
336 (at your option) any later version.\nline\nline%
337 The latest version of this license is in\nline%
338 \space\space http://www.latex-project.org/lppl.txt\nline%
339 and version 1.2 or later is part of all distributions of LaTeX version\nline%
340 1999/12/01 or later.\nline\nline%
341 This file may not be distributed without the original source file\nline%
342 `\inFileName'.\nline\nline%
343 The list of all files belonging to the confproc package is given in\nline%
344 the `readme.txt' file.}
345 %
346 %% Declare preambles (and use \stdtext):
347 %
348 \declarepreamble\driver
349
350 This is `\outFileName', the documentation driver for the confproc package.
351 \stdtext
352
353 This is the driver file to produce the LaTeX documentation
354 from the original source file `\inFileName'.
355
356 Make changes to it as needed. (Never edit the file `\inFileName'!)
357
358 \endpreamble%
359 %
360 \declarepreamble\package
361
362 This is `\outFileName', a LaTeX2e package to build conference proceedings.
363 \stdtext
364
365 For more details, LaTeX the source `\inFileName'.
366
367 \endpreamble%
368 %
369 \declarepreamble\scripts
370 \endpreamble%
371 %
372 \declarepreamble\example
373
374 This is `\outFileName', an example file for the confproc package.
375 \stdtext
376
377 For more details, LaTeX the source `\inFileName'.
378
379 \endpreamble%
380 %
381 \declarepreamble\config
382
383 This is `\outFileName', a configuration file for the confproc package.
384 \stdtext
385
386 For more details, LaTeX the source `\inFileName'.
387
388 \endpreamble%
389 %
390 \keepsilent%
391 %
392 %% Greeting:
393 %
394 \askforoverwritefalse
395 %%\askforoverwritetrue% uncomment if you wish to avoid over-writing a file
396 %%\askonceonly% better of commented as it asks SEVERAL times
397 %
398 \ifToplevel{%
399 \Msg{}%
400 \Msg{**********************}%
401 \Msg{* Hello to the installation of the `confproc' package. *}%
402 \Msg{**********************}%
403 \Msg{}%
404 \Msg{*********}%
405 \Msg{* Generating files... *}%
406 \Msg{*********}%
407 }%
408 %
409 %% File generation:
410 %
411 \generate{%
412 \nopreamble\nopostamble\file{prepareexample.sh}{\from{confproc.dtx}{prepareexample}}%
413 \usepreamble\example\file{example1empty.tex}{\from{confproc.dtx}{example1empty}}%
414 \file{example2custom.tex}{\from{confproc.dtx}{example2custom}}%
415 \file{example3optim.tex}{\from{confproc.dtx}{example3optim}}%
416 \file{expapersswitch.tex}{\from{confproc.dtx}{expapersswitch}}%
417 \file{expages.tex}{\from{confproc.dtx}{expages}}%
418 \nopreamble\nopostamble\file{exclasspre.tex}{\from{confproc.dtx}{exclasspre}}%
419 \file{exclasslastel.tex}{\from{confproc.dtx}{exclasslastel}}%
420 \file{exclasslastpb.tex}{\from{confproc.dtx}{exclasslastpb}}%
421 \file{exbiblio.bib}{\from{confproc.dtx}{exbiblio}}%
422 \file{generateswitch.pl}{\from{confproc.dtx}{generateswitch}}%
423 \file{exprogram.csv}{\from{confproc.dtx}{exprogram}}%
424 \file{buildpapers.sh}{\from{confproc.dtx}{buildpapers}}%
425 \file{buildproc.sh}{\from{confproc.dtx}{buildproc}}%
426 \file{buildprocelpb.sh}{\from{confproc.dtx}{buildprocelpb}}%
427 \file{buildcppdfpapers.sh}{\from{confproc.dtx}{buildcppdfpapers}}%
428 \file{countnbpages.sh}{\from{confproc.dtx}{countnbpages}}%
429 \file{removeLaTeXcmds.sh}{\from{confproc.dtx}{removeLaTeXcmds}}%
430 \file{exportIndividualPDFs.sh}{\from{confproc.dtx}{exportIndividualPDFs}}%
431 \file{papersinfo.sh}{\from{confproc.dtx}{papersinfo}}%
432 \file{paperssplitpreamble.sh}{\from{confproc.dtx}{paperssplitpreamble}}%
433 % \nopreamble\nopostamble\file{newapave.bst}{\from{confproc.dtx}{newapavebst}}%
434 % \nopreamble\nopostamble\file{newapave2.sty}{\from{confproc.dtx}{newapavesty}}% DO NOT UNCOMMENT OTHERWISE IT STRIPS A SECONDTIME THE COMMENTS...
435 % \usepreamble\example\file{example4optim.tex}{\from{confproc.ins}{example4optim}}%
436 % \usedir{tex/latex/misc}%
437 \usepreamble\driver\file{confproc.drv}{\from{confproc.dtx}{driver}}%
438 \usepreamble\config\file{confproc.cfg}{\from{confproc.dtx}{config}}%
439 \usepreamble\package\file{confproc.cls}{\from{confproc.dtx}{package}%
440 \nopreamble\nopostamble\file{buildcls.sh}{\from{confproc.dtx}{buildcls}}%
441 \nopreamble\nopostamble\file{cleancls.sh}{\from{confproc.dtx}{cleancls}}%
442 }%
443 }%
444 %
445 %% Report:
446 %
447 \ifToplevel{%
448 \Msg{}%
449 \Msg{********************}%
450 \Msg{*}%
451 \makeatletter\@ifundefined{basedir}{%
452 \Msg{* To finish the installation you have to move the following}%
453 \Msg{* file into a directory searched by LaTeX:}%
454 }{%
455 \Msg{* The following file has been automatically created in a}%
456 \Msg{* directory searched by LaTeX:}%
457 }\makeatother%
458 \Msg{*}%
459 \Msg{* \space\space confproc.cls}%
460 \Msg{*}%
461 \makeatletter\@ifundefined{basedir}{%
462 \Msg{* Using a TDS compatible TeX distribution, this would be e.g.}%
463 \Msg{* tex/latex/misc of your main or your local or your private}%
464 \Msg{* texmf path. If you don't know these paths, have a look}%
465 \Msg{* at your `texmf.cnf' or try:}%
466 \Msg{* \space\space kpsexpand \string\$TEXMFMAIN}%
467 \Msg{* \space\space kpsexpand \string\$TEXMFLOCAL}%
468 \Msg{* \space\space kpsexpand \string\$HOMETEXMF}%
469 \Msg{* You may also use another folder at your TEXINPUTS path.}%
470 }{}\makeatother%
471 \Msg{* To produce the documentation and a example, run the}%
472 \Msg{* following files through LaTeX:}%
473 \Msg{*}%
474 \Msg{* \space\space confproc.drv (three times)}%
475 \Msg{* \space\space exampleN.tex}%
476 \Msg{*}%
477 \Msg{* For the legal stuff please have a look at:}%
478 \Msg{*}%
479 \Msg{* \space\space readme.txt}%
480 \Msg{*}%
481 \Msg{*}%
482 \Msg{* Happy TeXing!}%
483 \Msg{*}%
484 \Msg{********************}%
485 \Msg{}%
486 }%
487 \endbatchfile
488 \end{filecontents}
489 %</installer>
490 %
491 %^^A\changes{0.1c}{2007/07/30}{Head: new}
492 %^^A =================================================================
493 %^^A Here is the header that is written to driver-, example- and
494 %^^A class-file
495 %^^A =================================================================
496 %
497 % The docdate info. It specifies the date of the documentation, which
498 % may differ from the filedate. (Its ok if docdate is younger. If it
499 % is older, then I forgot documenting. In that case: kick me... ;-)
500 %<*dtx|driver>
501 \def\docdate{2010/08/01}
502 %</dtx|driver>
503 %
504 % The required LaTeX version:
505 %<*dtx|driver|package|example>
506 \NeedsTeXFormat{LaTeX2e}[1994/12/01]%
507 %</dtx|driver|package|example>
508 %
509 % Identification of the docstrip file:
510 %<*dtx>
511 \ProvidesFile
512 %=====================================================================
513 {confproc.dtx}
514 %=====================================================================
515 %</dtx>
516 %
517 % Identification of the driver file:
518 %<driver>\ProvidesFile{confproc.drv}
519 %
520 % Identification of the example files:
521 %<example>
522 % \ProvidesFile{example1empty.tex}
523 % \ProvidesFile{example2custom.tex}
524 % \ProvidesFile{example3optim.tex}
525 % \ProvidesFile{expapersswitch.tex}
526 % \ProvidesFile{expages.tex}
527 % \ProvidesFile{exclasspre.tex}
528 % \ProvidesFile{exclasslastel.tex}
529 % \ProvidesFile{exclasslastpb.tex}
530 % \ProvidesFile{exbiblio.bib}
531 % \ProvidesFile{generateswitch.pl}
532 % \ProvidesFile{exprogram.csv}
533 % \ProvidesFile{buildpapers.sh}
534 % \ProvidesFile{buildproc.sh}
535 % \ProvidesFile{buildprocelpb.sh}
536 % \ProvidesFile{buildcppdfpapers.sh}
537 % \ProvidesFile{countnbpages.sh}
538 % \ProvidesFile{removeLaTeXcmds.sh}
539 % \ProvidesFile{exportIndividualPDFs.sh}
540 % \ProvidesFile{papersinfo.sh}
541 % \ProvidesFile{paperssplitpreamble.sh}
542 %
543 % Identification of the configuration file:
544 %<config>\ProvidesFile{confproc.cfg}
545 %
546 % Identification of the package file:
547 %<package>\ProvidesClass{confproc}
548 %
549 % Provide command to identify example files:
550 %<example>\def\DescribesFile#1 [#2 #3 #4 (#5)]
551 %<example> {\def\filedate{#2}\def\fileversion{#3}}
552 %
553 % Identification of the example files:
554 %<example>\DescribesFile{confproc.cls}
555 %
556 % The next three lines:
557 % 1.: Identification of the included .dtx-file.
558 % 2.: The date and version for docstrip, driver, example, config, package and dtx file.
559 % 3.: A short description and author for the included .dtx-file.
560 % \fi
561 % \ProvidesFile{confproc}
562 % [2011/08/01 v0.8: Documentation for confproc (VV)]
563 % \iffalse
564 %
565 % A short description and author for driver, example, config
566 % and package file:
567 %<package> [2011/08/01 v0.8: Conference Proceedings class (VV)]
568 %<example> [2011/08/01 v0.8: Example for confproc (VV)]
569 %<config> [2011/08/01 v0.8: Configuration for confproc (VV)]
570 %<driver> [2011/08/01 v0.8: Driver for confproc (VV)]
571 %
572 % A short description and author for the docstrip file:
573 %<*dtx>
574 [2011/08/01 v0.8: Documented source for confproc (VV)]
575 %</dtx>
576 %
577 %
578 %
579 %
580 %
581 %<*indexstyle>
582 %\changes{0.1}{2007/08/01}{added the creation of \file{confproc.ist} file}
583 %\changes{0.6}{2009/08/18}{Modified \file{confproc.ist} with lines}
584 %^^A =================================================================
585 %^^A Here is the creation of the first index style file confproc1.ist
586 %^^A It is written on first LaTeX run if it does not already exist
587 %^^A =================================================================
588 \begin{filecontents*}{confproc1.ist}
589 %%
590 %% This is file `confproc1.ist', generated with the docstrip utility.
591 %% The original source files were:
592 %% confproc.dtx (with options: `doc')
593 %%
594 %% This is `confproc1.ist', an index formatting example, for the confproc package.
595 %% Copyright (c) 2011 by Vincent Verfaille
596 %% <[email protected]>
597 %%
598 %% This file is part of the confproc package.
599 %% -------------------------------------------
600 %%
601 %% It may be distributed and/or modified under the conditions of the
602 %% LaTeX Project Public License, either version 1.2 of this license or
603 %% (at your option) any later version.
604 %%
605 %% The latest version of this license is in
606 %% http://www.latex-project.org/lppl.txt
607 %% and version 1.2 or later is part of all distributions of LaTeX version
608 %% 1999/12/01 or later.
609 %%
610 %% This file may not be distributed without the original source file
611 %% `confproc.dtx'.
612 %%
613 %% The list of all files belonging to the confproc package is given in
614 %% the file `readme.txt'.
615 %%
616 %% For more details, LaTeX the source `confproc.dtx'.
617 %%
618
619 %%--add a letter between 2 lists
620 heading_prefix "{\\bfseries\\hfil "
621 heading_suffix "\\hfil}\\nopagebreak\n"
622 headings_flag 1
623
624 %%-- Add lines with points between name and page numbers
625 delim_0 "\\dotfill"
626 delim_1 "\\dotfill"
627 delim_2 "\\dotfill"
628 \end{filecontents*}
629 %
630 %^^A =================================================================
631 %^^A Here is the creation of the second index style file confproc2.ist
632 %^^A It is written on first LaTeX run if it does not already exist
633 %^^A =================================================================
634 \begin{filecontents*}{confproc2.ist}
635 %%
636 %% This is file `confproc2.ist', generated with the docstrip utility.
637 %% The original source files were:
638 %% confproc.dtx (with options: `doc')
639 %%
640 %% This is `confproc2.ist', an index formatting example, for the confproc package.
641 %% Copyright (c) 2011 by Vincent Verfaille
642 %% <[email protected]>
643 %%
644 %% This file is part of the confproc package.
645 %% -------------------------------------------
646 %%
647 %% It may be distributed and/or modified under the conditions of the
648 %% LaTeX Project Public License, either version 1.2 of this license or
649 %% (at your option) any later version.
650 %%
651 %% The latest version of this license is in
652 %% http://www.latex-project.org/lppl.txt
653 %% and version 1.2 or later is part of all distributions of LaTeX version
654 %% 1999/12/01 or later.
655 %%
656 %% This file may not be distributed without the original source file
657 %% `confproc.dtx'.
658 %%
659 %% The list of all files belonging to the confproc package is given in
660 %% the file `readme.txt'.
661 %%
662 %% For more details, LaTeX the source `confproc.dtx'.
663 %%
664
665 %%--add a letter between 2 lists, and horizontal lines + slashes around letters
666 heading_prefix "{\\bfseries\\hfil------/\\hfil "
667 heading_suffix "\\hfil/------\\hfil}\\nopagebreak\n"
668 headings_flag 1
669
670 %%-- Add lines with points between name and page numbers
671 delim_0 "\\dotfill"
672 delim_1 "\\dotfill"
673 delim_2 "\\dotfill"
674 \end{filecontents*}
675 %</indexstyle>
676 %
677 %
678 %\changes{0.1d}{2007/08/01}{added the \package{threecolindex.sty} creation}
679 %\changes{0.2a}{2007/08/12}{removed \package{threecolindex.sty} file: corresponding cmds moved into the class}
680 %
681 %
682 %\changes{0.1}{2007/08/01}{Installer: adding \file{newapave2.sty}}
683 %^^A =================================================================
684 %^^A Here is the creation of the bibliography style file newapave.bst
685 %^^A It is written on first LaTeX run if it does not already exist
686 %^^A =================================================================
687 %
688 %
689 %\changes{0.1}{2007/08/01}{Installer: added \file{newapave.bst}}
690 %<*newapavebst>
691 \begin{filecontents*}{newapave.bst}
692 %$$$ newapave.bst $$$
693 % BibTeX `newapave' style file for BibTeX version 0.99c, LaTeX version 2e
694 % Place it in a file called newapave.bst in the BibTeX search path.
695 %(Placing it in the same directory as the LaTeX document should also work.)
696 % Support for named citations is provided by named.sty
697 %
698 % This version was modified by V. Verfaille, from the already modified master file made by
699 % Oren Patashnik, and the 'named' BibTeX style of Peter F. Patel-Schneider.
700 %
701 % Copyright (c) 2006, all rights reserved.
702 % Copying of this file is authorized only if either
703 % (1) you make absolutely no changes to your copy, including name, or
704 % (2) if you do make changes, you name it something other than 'newapave.bst'.
705 % There are undoubtably bugs in this style. If you make bug fixes,
706 % improvements, etc. please let me know. My e-mail address is:
707 % [email protected]
708 %
709 % This style was made from 'plain.bst', 'named.bst', and 'apalike.bst',
710 % with lots of tweaking to make it look like APA style, along with tips
711 % from Young Ryu and Brian Reiser's modifications of 'apalike.bst'.
712 % Then, it was modified a bit for the DAFx-06 proceedings, for use
713 % with the general bibliography.
714 %
715 % Citation format: (author-last-name, year)
716 % (author-last-name and author-last-name, year)
717 % (author-last-name {\em et al.}, year)
718 % (author-last-name)
719 % (author-last-name and author-last-name)
720 % (author-last-name {\em et al.})
721 % (year)
722 %
723 % Reference list ordering: alphabetical by author or whatever passes
724 % for author in the absence of one.
725 %
726 % This BibTeX style has support for abbreviated author lists and for
727 % year-only citations. This is done by having the citations
728 % actually look like
729 %
730 % \citeauthoryear{full-author-info}{abbrev-author-info}{year}
731 %
732 % The LaTeX style has to have the following (or similar)
733 %
734 % \let\@internalcite\cite
735 % \def\fullcite{\def\citeauthoryear##1##2##3{##1, ##3}\@internalcite}
736 % \def\fullciteA{\def\citeauthoryear##1##2##3{##1}\@internalcite}
737 % \def\shortcite{\def\citeauthoryear##1##2##3{##2, ##3}\@internalcite}
738 % \def\shortciteA{\def\citeauthoryear##1##2##3{##2}\@internalcite}
739 % \def\citeyear{\def\citeauthoryear##1##2##3{##3}\@internalcite}
740 %
741
742 ENTRY
743 { address
744 author
745 booktitle
746 chapter
747 edition
748 editor
749 howpublished
750 institution
751 journal
752 key
753 % month
754 note
755 number
756 organization
757 pages
758 publisher
759 school
760 series
761 title
762 type
763 volume
764 year
765 }
766 {}
767 { label extra.label sort.label }
768
769 INTEGERS { output.state before.all mid.sentence after.sentence after.block }
770
771 FUNCTION {init.state.consts}
772 { #0 'before.all :=
773 #1 'mid.sentence :=
774 #2 'after.sentence :=
775 #3 'after.block :=
776 }
777
778 STRINGS { s t u }
779
780 FUNCTION {output.nonnull}
781 { 's :=
782 output.state mid.sentence =
783 { ", " * write$ }
784 { output.state after.block =
785 { add.period$ write$
786 newline$
787 "\newblock " write$
788 }
789 { output.state before.all =
790 'write$
791 { add.period$ " " * write$ }
792 if$
793 }
794 if$
795 mid.sentence 'output.state :=
796 }
797 if$
798 s
799 }
800
801 FUNCTION {special.output.nonnull}
802 { 's :=
803 output.state mid.sentence =
804 { " " * write$ }
805 { output.state after.block =
806 { ": " write$
807 newline$
808 "\newblock " write$
809 }
810 { output.state before.all =
811 'write$
812 { ": " * write$
813 }
814 if$
815 }
816 if$
817 mid.sentence 'output.state :=
818 }
819 if$
820 s
821 }
822
823 FUNCTION {output.nonnull.colon}
824 { 's :=
825 output.state mid.sentence =
826 { ": " * write$ }
827 { output.state after.block =
828 { add.period$ write$
829 newline$
830 "\newblock " write$
831 }
832 { output.state before.all =
833 'write$
834 { add.period$ " " * write$ }
835 if$
836 }
837 if$
838 mid.sentence 'output.state :=
839 }
840 if$
841 s
842 }
843
844 FUNCTION {output.nonnull.space}
845 { 's :=
846 output.state mid.sentence =
847 { "\ " * write$ }
848 { output.state after.block =
849 { add.period$ write$
850 newline$
851 "\newblock " write$
852 }
853 { output.state before.all =
854 'write$
855 { add.period$ " " * write$ }
856 if$
857 }
858 if$
859 mid.sentence 'output.state :=
860 }
861 if$
862 s
863 }
864
865 FUNCTION {special.output}
866 { duplicate$ empty$
867 'pop$
868 'special.output.nonnull
869 if$
870 }
871
872 FUNCTION {output}
873 { duplicate$ empty$
874 'pop$
875 'output.nonnull
876 if$
877 }
878
879 FUNCTION {output.check}
880 { 't :=
881 duplicate$ empty$
882 { pop$ "empty " t * " in " * cite$ * warning$ }
883 'output.nonnull
884 if$
885 }
886
887 FUNCTION {output.check.colon}
888 { 't :=
889 duplicate$ empty$
890 { pop$ "empty " t * " in " * cite$ * warning$ }
891 'output.nonnull.colon
892 if$
893 }
894
895 FUNCTION {output.check.space}
896 { 't :=
897 duplicate$ empty$
898 { pop$ "empty " t * " in " * cite$ * warning$ }
899 'output.nonnull.space
900 if$
901 }
902
903 FUNCTION {output.year.check}
904 { year empty$
905 { "empty year in " cite$ * warning$
906 }
907 { write$
908 ", " year * "." * "~\hfill " * % shorter and simpler without label (2002a, 2002b useless)
909 % ", " year * extra.label * "." * " \Pointinghand{} " * % shorter
910 mid.sentence 'output.state :=
911 % mid.sentence 'output.state := * "}"
912 }
913 if$
914 }
915
916 FUNCTION {output.bibitem}
917 { newline$
918
919 "\bibitem[" write$
920 label write$
921 "]{" write$
922
923 cite$ write$
924 "}" write$
925 newline$
926 ""
927 before.all 'output.state :=
928 }
929
930 FUNCTION {fin.entry}
931 {% add.period$
932 write$
933 newline$
934 }
935
936 FUNCTION {new.block}
937 { output.state before.all =
938 'skip$
939 { after.block 'output.state := }
940 if$
941 }
942
943 FUNCTION {new.sentence}
944 { output.state after.block =
945 'skip$
946 { output.state before.all =
947 'skip$
948 { after.sentence 'output.state := }
949 if$
950 }
951 if$
952 }
953
954 FUNCTION {not}
955 { { #0 }
956 { #1 }
957 if$
958 }
959
960 FUNCTION {and}
961 { 'skip$
962 { pop$ #0 }
963 if$
964 }
965
966 FUNCTION {or}
967 { { pop$ #1 }
968 'skip$
969 if$
970 }
971
972 FUNCTION {new.block.checka}
973 { empty$
974 'skip$
975 'new.block
976 if$
977 }
978
979 FUNCTION {new.block.checkb}
980 { empty$
981 swap$ empty$
982 and
983 'skip$
984 'new.block
985 if$
986 }
987
988 FUNCTION {new.sentence.checka}
989 { empty$
990 'skip$
991 'new.sentence
992 if$
993 }
994
995 FUNCTION {new.sentence.checkb}
996 { empty$
997 swap$ empty$
998 and
999 'skip$
1000 'new.sentence
1001 if$
1002 }
1003
1004 FUNCTION {field.or.null}
1005 { duplicate$ empty$
1006 { pop$ "" }
1007 'skip$
1008 if$
1009 }
1010
1011 FUNCTION {underline}
1012 { duplicate$ empty$
1013 { pop$ "" }
1014 { "\underline{" swap$ * "}" * }
1015 if$
1016 }
1017
1018 FUNCTION {emphasize}
1019 { duplicate$ empty$
1020 { pop$ "" }
1021 { "{\em " swap$ * "}" * }
1022 if$
1023 }
1024
1025 FUNCTION {emphasize.space}
1026 { duplicate$ empty$
1027 { pop$ "" }
1028 { "{\em " swap$ * "\/}" * }
1029 if$
1030 }
1031
1032 INTEGERS { nameptr namesleft numnames }
1033
1034 FUNCTION {format.names}
1035 { 's :=
1036 #1 'nameptr := % nameptr = 1;
1037 s num.names$ 'numnames := % numnames = num.name$(s);
1038 numnames 'namesleft :=
1039 { namesleft #0 > }
1040
1041 { s nameptr "{vv~}{ll}{, jj}{, f.}" format.name$ 't :=
1042
1043 nameptr #1 >
1044 { namesleft #1 >
1045 { ", " * t * }
1046 { numnames #2 >
1047 { "," * }
1048 'skip$
1049 if$
1050 t "others" =
1051 { " et~al." * }
1052 % { ", \& " * t * }
1053 % { " \& " * t * }
1054 { " and " * t * }
1055 if$
1056 }
1057 if$
1058 }
1059 't
1060 if$
1061 nameptr #1 + 'nameptr := % nameptr += 1;
1062 namesleft #1 - 'namesleft := % namesleft =- 1;
1063 }
1064 while$
1065 }
1066
1067 FUNCTION {format.names.fml}
1068 { 's :=
1069 #1 'nameptr := % nameptr = 1;
1070 s num.names$ 'numnames := % numnames = num.name$(s);
1071 numnames 'namesleft :=
1072 { namesleft #0 > }
1073
1074 { s nameptr "{f.~}{vv~}{ll}{, jj}" format.name$ 't :=
1075
1076 nameptr #1 >
1077 { namesleft #1 >
1078 { ", " * t * }
1079 { numnames #2 >
1080 { "," * }
1081 'skip$
1082 if$
1083 t "others" =
1084 { " et~al." * }
1085 % { " and " * t * }
1086 { " \& " * t * }
1087 if$
1088 }
1089 if$
1090 }
1091 't
1092 if$
1093 nameptr #1 + 'nameptr := % nameptr += 1;
1094 namesleft #1 - 'namesleft := % namesleft =- 1;
1095 }
1096 while$
1097 }
1098
1099 FUNCTION {format.authors}
1100 { author empty$
1101 { "" }
1102 { author format.names }
1103 if$
1104 }
1105
1106 FUNCTION {format.key}
1107 { empty$
1108 { key field.or.null }
1109 { "" }
1110 if$
1111 }
1112
1113 FUNCTION {format.editors.fml}
1114 { editor empty$
1115 { "" }
1116 { editor format.names.fml
1117 editor num.names$ #1 >
1118 { " (Eds.)" * }
1119 { " (Ed.)" * }
1120 if$
1121 }
1122 if$
1123 }
1124
1125 FUNCTION {format.editors}
1126 { editor empty$
1127 { "" }
1128 { editor format.names
1129 editor num.names$ #1 >
1130 { " (Eds.)" * }
1131 { " (Ed.)" * }
1132 if$
1133 }
1134 if$
1135 }
1136
1137 FUNCTION {format.editors.dot}
1138 { editor empty$
1139 { "" }
1140 { editor format.names
1141 editor num.names$ #1 >
1142 { " (Eds.)." * }
1143 { " (Ed.)." * }
1144 if$
1145 }
1146 if$
1147 }
1148
1149 FUNCTION {format.title}
1150 { title empty$
1151 { "" }
1152 { title "t" change.case$ }
1153 if$
1154 }
1155
1156 % Note that the APA style requires case changes
1157 % in article titles. The following does not
1158 % change cases. If you perfer it, uncomment the
1159 % following and comment out the above.
1160
1161 %FUNCTION {format.title}
1162 %{ title empty$
1163 % { "" }
1164 % { title }
1165 % if$
1166 %}
1167
1168 FUNCTION {n.dashify}
1169 { 't :=
1170 ""
1171 { t empty$ not }
1172 { t #1 #1 substring$ "-" =
1173 { t #1 #2 substring$ "--" = not
1174 { "--" *
1175 t #2 global.max$ substring$ 't :=
1176 }
1177 { { t #1 #1 substring$ "-" = }
1178 { "-" *
1179 t #2 global.max$ substring$ 't :=
1180 }
1181 while$
1182 }
1183 if$
1184 }
1185 { t #1 #1 substring$ *
1186 t #2 global.max$ substring$ 't :=
1187 }
1188 if$
1189 }
1190 while$
1191 }
1192
1193 FUNCTION {format.btitle}
1194 { edition empty$
1195 { title emphasize }
1196 { title empty$
1197 { title emphasize }
1198 { "{\em " title * "\/} (" * edition * " ed.)" * "." * }
1199 if$
1200 }
1201 if$
1202 }
1203
1204 FUNCTION {format.emphasize.booktitle}
1205 { edition empty$
1206 { booktitle emphasize }
1207 { booktitle empty$
1208 { booktitle emphasize }
1209 { "{\em " booktitle * "\/} (" * edition * " ed.)" * "." * }
1210 if$
1211 }
1212 if$
1213 }
1214
1215 FUNCTION {tie.or.space.connect}
1216 { duplicate$ text.length$ #3 <
1217 { "~" }
1218 { " " }
1219 if$
1220 swap$ * *
1221 }
1222
1223 FUNCTION {either.or.check}
1224 { empty$
1225 'pop$
1226 { "can't use both " swap$ * " fields in " * cite$ * warning$ }
1227 if$
1228 }
1229
1230 FUNCTION {format.bvolume}
1231 { volume empty$
1232 { "" }
1233 { "volume" volume tie.or.space.connect
1234 series empty$
1235 'skip$
1236 { " of " * series emphasize * }
1237 if$
1238 "volume and number" number either.or.check
1239 }
1240 if$
1241 }
1242
1243 FUNCTION {format.number.series}
1244 { volume empty$
1245 { number empty$
1246 { series field.or.null }
1247 { output.state mid.sentence =
1248 { "number" }
1249 { "Number" }
1250 if$
1251 number tie.or.space.connect
1252 series empty$
1253 { "there's a number but no series in " cite$ * warning$ }
1254 { " in " * series * }
1255 if$
1256 }
1257 if$
1258 }
1259 { "" }
1260 if$
1261 }
1262
1263 FUNCTION {format.edition}
1264 { edition empty$
1265 { "" }
1266 { output.state mid.sentence =
1267 { edition "l" change.case$ " edition" * }
1268 { edition "t" change.case$ " edition" * }
1269 if$
1270 }
1271 if$
1272 }
1273
1274 INTEGERS { multiresult }
1275
1276 FUNCTION {multi.page.check}
1277 { 't :=
1278 #0 'multiresult :=
1279 { multiresult not
1280 t empty$ not
1281 and
1282 }
1283 { t #1 #1 substring$
1284 duplicate$ "-" =
1285 swap$ duplicate$ "," =
1286 swap$ "+" =
1287 or or
1288 { #1 'multiresult := }
1289 { t #2 global.max$ substring$ 't := }
1290 if$
1291 }
1292 while$
1293 multiresult
1294 }
1295
1296 FUNCTION {format.pages}
1297 { pages empty$
1298 { "" }
1299 { pages multi.page.check
1300 { "pp.\" pages n.dashify tie.or.space.connect } % removed parenthesis
1301 { "pp.\" pages tie.or.space.connect } % removed parenthesis
1302 if$
1303 "" *
1304 }
1305 if$
1306 }
1307
1308 % By Young (and Spencer)
1309 FUNCTION {format.vol.num.pages}
1310 { number empty$
1311 { volume empty$
1312 'skip$
1313 { "" volume * "" *} % removed \em
1314 if$
1315 }
1316 { volume % removed \em
1317 number empty$
1318 {"there's a number but no volume in " cite$ * warning$ }
1319 { "(" number * ")" * * }
1320 if$
1321 }
1322 if$
1323 pages empty$
1324 'skip$
1325 { duplicate$ empty$
1326 { pop$ format.pages }
1327 { ", pp. " * pages n.dashify * }
1328 if$
1329 }
1330 if$
1331 }
1332
1333 FUNCTION {format.chapter.pages}
1334 { chapter empty$
1335 'format.pages
1336 { type empty$
1337 { "chapter" }
1338 { type "l" change.case$ }
1339 if$
1340 chapter tie.or.space.connect
1341 pages empty$
1342 'skip$
1343 { ", " * format.pages * }
1344 % { ", pp. " * format.pages * }
1345 if$
1346 }
1347 if$
1348 }
1349
1350 FUNCTION {format.chapter.pages.incoll}
1351 { chapter empty$
1352 'format.pages
1353 { type empty$
1354 { "chapter" }
1355 { type "l" change.case$ }
1356 if$
1357 chapter tie.or.space.connect
1358 pages empty$
1359 'skip$
1360 { " pp. " * format.pages * }
1361 if$
1362 }
1363 if$
1364 }
1365
1366 FUNCTION {format.in.ed.booktitle}
1367 { booktitle empty$
1368 { "" }
1369 { editor empty$
1370 { "In " format.emphasize.booktitle * }
1371 { "In " format.editors * ", " * format.emphasize.booktitle * }
1372 if$
1373 }
1374 if$
1375 }
1376
1377 FUNCTION {format.in.ed.booktitle.incoll}
1378 { booktitle empty$
1379 { "" }
1380 { editor empty$
1381 { "In " format.emphasize.booktitle * }
1382 { "In " format.editors.fml * ", " * format.emphasize.booktitle * }
1383 if$
1384 }
1385 if$
1386 }
1387
1388 FUNCTION {format.thesis.type}
1389 { type empty$
1390 'skip$
1391 { pop$
1392 type "t" change.case$
1393 }
1394 if$
1395 }
1396
1397 FUNCTION {format.tr.number}
1398 { type empty$
1399 { "Technical Report" }
1400 'type
1401 if$
1402 number empty$
1403 { "t" change.case$ }
1404 { number tie.or.space.connect }
1405 if$
1406 }
1407
1408 FUNCTION {format.article.crossref}
1409 { "In"
1410 "\cite{" * crossref * "}" *
1411 }
1412
1413 FUNCTION {format.crossref.editor}
1414 { editor #1 "{vv~}{ll}" format.name$
1415 editor num.names$ duplicate$
1416 #2 >
1417 { pop$ " et~al." * }
1418 { #2 <
1419 'skip$
1420 { editor #2 "{ff }{vv }{ll}{ jj}" format.name$ "others" =
1421 { " et~al." * }
1422 { " and " * editor #2 "{vv~}{ll}" format.name$ * }
1423 if$
1424 }
1425 if$
1426 }
1427 if$
1428 }
1429
1430 FUNCTION {format.book.crossref}
1431 { volume empty$
1432 { "empty volume in " cite$ * "'s crossref of " * crossref * warning$
1433 "In "
1434 }
1435 { "Volume" volume tie.or.space.connect
1436 " of " *
1437 }
1438 if$
1439 editor empty$
1440 editor field.or.null author field.or.null =
1441 or
1442 { key empty$
1443 { series empty$
1444 { "need editor, key, or series for " cite$ * " to crossref " *
1445 crossref * warning$
1446 "" *
1447 }
1448 { "{\em " * series * "\/}" * }
1449 if$
1450 }
1451 { key * }
1452 if$
1453 }
1454 { format.crossref.editor * }
1455 if$
1456 " \cite{" * crossref * "}" *
1457 }
1458
1459 FUNCTION {format.incoll.inproc.crossref}
1460 { "In"
1461 " \cite{" * crossref * "}" *
1462 }
1463
1464 FUNCTION {article}
1465 { output.bibitem
1466 format.authors
1467 "author" output.check
1468 author format.key output
1469 new.block
1470 format.title
1471 "title" output.check
1472 new.block
1473 crossref missing$
1474 { journal emphasize "journal" output.check
1475 format.vol.num.pages output
1476 }
1477 { format.article.crossref output.nonnull
1478 format.pages output
1479 }
1480 if$
1481 new.block
1482 note output
1483 output.year.check% moved
1484 fin.entry
1485 }
1486
1487 FUNCTION {book}
1488 { output.bibitem
1489 author empty$
1490 { format.editors.dot
1491 "author and editor" output.check }
1492 { format.authors
1493 output.nonnull
1494 crossref missing$
1495 { "author and editor" editor either.or.check }
1496 'skip$
1497 if$
1498 }
1499 if$
1500 new.block
1501 format.btitle
1502 "title" output.check
1503 crossref missing$
1504 { format.bvolume output
1505 new.block
1506 format.number.series output
1507 new.sentence
1508 address output
1509 publisher "publisher" output.check.colon
1510 }
1511 { new.block
1512 format.book.crossref output.nonnull
1513 }
1514 if$
1515 % format.edition output
1516 new.block
1517 note output
1518 output.year.check % moved
1519 fin.entry
1520 }
1521
1522 FUNCTION {booklet}
1523 { output.bibitem
1524 format.authors output
1525 author format.key output
1526 new.block
1527 format.title
1528 "title" output.check
1529 new.block
1530 howpublished output
1531 address output
1532 new.block
1533 note output
1534 output.year.check % moved
1535 fin.entry
1536 }
1537
1538 FUNCTION {inbook}
1539 { output.bibitem
1540 author empty$
1541 { format.editors.dot
1542 "author and editor" output.check
1543 }
1544 { format.authors output.nonnull
1545 crossref missing$
1546 { "author and editor" editor either.or.check }
1547 'skip$
1548 if$
1549 }
1550 if$
1551 new.block
1552 format.btitle
1553 "title" output.check
1554 crossref missing$
1555 { format.bvolume output
1556 format.chapter.pages
1557 "chapter and pages" output.check
1558 new.block
1559 format.number.series output
1560 new.sentence
1561 address output
1562 publisher
1563 "publisher" output.check.colon
1564 }
1565 { format.chapter.pages "chapter and pages" output.check
1566 new.block
1567 format.book.crossref output.nonnull
1568 }
1569 if$
1570 % format.edition output
1571 new.block
1572 note output
1573 output.year.check % moved
1574 fin.entry
1575 }
1576
1577 FUNCTION {incollection}
1578 { output.bibitem
1579 format.authors
1580 "author" output.check
1581 author format.key output
1582 new.block
1583 format.title
1584 "title" output.check
1585 new.block
1586 crossref missing$
1587 { format.in.ed.booktitle.incoll
1588 "booktitle" output.check.colon
1589 format.bvolume output
1590 format.number.series output
1591 format.chapter.pages special.output
1592 new.sentence
1593 address output
1594 publisher "publisher" output.check.colon
1595 }
1596 { format.incoll.inproc.crossref
1597 output.nonnull
1598 format.chapter.pages output
1599 }
1600 if$
1601 new.block
1602 note output
1603 output.year.check % moved
1604 fin.entry
1605 }
1606
1607 FUNCTION {inproceedings}
1608 { output.bibitem
1609 format.authors
1610 "author" output.check
1611 author format.key output
1612 new.block
1613 format.title
1614 "title" output.check
1615 new.block
1616 crossref missing$
1617 { format.in.ed.booktitle
1618 "booktitle" output.check
1619 format.bvolume output
1620 format.number.series output
1621 address output
1622 % new.sentence %removed, to avoid having a ".", but having a "," instead
1623 organization output
1624 publisher output
1625 format.pages output
1626 }
1627 { format.incoll.inproc.crossref output.nonnull
1628 format.pages output
1629 }
1630 if$
1631 new.block
1632 note output
1633 output.year.check % moved
1634 fin.entry
1635 }
1636
1637 FUNCTION {conference} { inproceedings }
1638
1639 FUNCTION {manual}
1640 { output.bibitem
1641 format.authors output
1642 author format.key output
1643 new.block
1644 format.btitle
1645 "title" output.check
1646 organization address new.block.checkb
1647 % Reversed the order of "address" and "organization", added the ":".
1648 address output
1649 organization "organization" output.check.colon
1650 % address output
1651 % ":" output
1652 % organization output
1653 % format.edition output
1654 new.block
1655 note output
1656 output.year.check % moved
1657 fin.entry
1658 }
1659
1660 FUNCTION {mastersthesis}
1661 { output.bibitem
1662 format.authors
1663 "author" output.check
1664 author format.key output
1665 new.block
1666 format.title
1667 "title" output.check
1668 new.block
1669 "Master's thesis" format.thesis.type output.nonnull
1670 school "school" output.check
1671 address output
1672 new.block
1673 note output
1674 output.year.check % moved
1675 fin.entry
1676 }
1677
1678 FUNCTION {misc}
1679 { output.bibitem
1680 format.authors output
1681 author format.key output
1682 title howpublished new.block.checkb
1683 format.title output
1684 new.block
1685 howpublished output
1686 new.block
1687 note output
1688 output.year.check % moved
1689 fin.entry
1690 }
1691
1692 FUNCTION {phdthesis}
1693 { output.bibitem
1694 format.authors
1695 "author" output.check
1696 author format.key output
1697 new.block
1698 format.btitle
1699 "title" output.check
1700 new.block
1701 "PhD thesis" format.thesis.type output.nonnull
1702 school "school" output.check
1703 address output
1704 new.block
1705 note output
1706 output.year.check % moved
1707 fin.entry
1708 }
1709
1710 FUNCTION {proceedings}
1711 { output.bibitem
1712 editor empty$
1713 { organization output }
1714 { format.editors.dot output.nonnull }
1715 if$
1716 author format.key output
1717 new.block
1718 format.btitle
1719 "title" output.check
1720 format.bvolume output
1721 format.number.series output
1722 address output
1723 new.sentence
1724 organization output
1725 publisher output
1726 new.block
1727 note output
1728 output.year.check % moved
1729 fin.entry
1730 }
1731
1732 FUNCTION {techreport}
1733 { output.bibitem
1734 format.authors
1735 "author" output.check
1736 author format.key output
1737 new.block
1738 format.title
1739 "title" output.check
1740 new.block
1741 format.tr.number output.nonnull
1742 institution
1743 "institution" output.check
1744 address output
1745 new.block
1746 note output
1747 output.year.check % moved
1748 fin.entry
1749 }
1750
1751 FUNCTION {unpublished}
1752 { output.bibitem
1753 format.authors
1754 "author" output.check
1755 author format.key output
1756 new.block
1757 format.title
1758 "title" output.check
1759 new.block
1760 note "note" output.check
1761 output.year.check % moved
1762 fin.entry
1763 }
1764
1765 FUNCTION {default.type} { misc }
1766
1767 MACRO {jan} {"January"}
1768
1769 MACRO {feb} {"February"}
1770
1771 MACRO {mar} {"March"}
1772
1773 MACRO {apr} {"April"}
1774
1775 MACRO {may} {"May"}
1776
1777 MACRO {jun} {"June"}
1778
1779 MACRO {jul} {"July"}
1780
1781 MACRO {aug} {"August"}
1782
1783 MACRO {sep} {"September"}
1784
1785 MACRO {oct} {"October"}
1786
1787 MACRO {nov} {"November"}
1788
1789 MACRO {dec} {"December"}
1790
1791 MACRO {acmcs} {"ACM Computing Surveys"}
1792
1793 MACRO {acta} {"Acta Informatica"}
1794
1795 MACRO {ai} {"Artificial Intelligence"}
1796
1797 MACRO {cacm} {"Communications of the ACM"}
1798
1799 MACRO {ibmjrd} {"IBM Journal of Research and Development"}
1800
1801 MACRO {ibmsj} {"IBM Systems Journal"}
1802
1803 MACRO {ieeese} {"IEEE Transactions on Software Engineering"}
1804
1805 MACRO {ieeetc} {"IEEE Transactions on Computers"}
1806
1807 MACRO {ieeetcad}
1808 {"IEEE Transactions on Computer-Aided Design of Integrated Circuits"}
1809
1810 MACRO {ipl} {"Information Processing Letters"}
1811
1812 MACRO {jacm} {"Journal of the ACM"}
1813
1814 MACRO {jcss} {"Journal of Computer and System Sciences"}
1815
1816 MACRO {scp} {"Science of Computer Programming"}
1817
1818 MACRO {sicomp} {"SIAM Journal on Computing"}
1819
1820 MACRO {tocs} {"ACM Transactions on Computer Systems"}
1821
1822 MACRO {tods} {"ACM Transactions on Database Systems"}
1823
1824 MACRO {tog} {"ACM Transactions on Graphics"}
1825
1826 MACRO {toms} {"ACM Transactions on Mathematical Software"}
1827
1828 MACRO {toois} {"ACM Transactions on Office Information Systems"}
1829
1830 MACRO {toplas} {"ACM Transactions on Programming Languages and Systems"}
1831
1832 MACRO {tcs} {"Theoretical Computer Science"}
1833
1834 READ
1835
1836 FUNCTION {sortify}
1837 { purify$
1838 "l" change.case$
1839 }
1840
1841 INTEGERS { len }
1842
1843 FUNCTION {chop.word}
1844 { 's :=
1845 'len :=
1846 s #1 len substring$ =
1847 { s len #1 + global.max$ substring$ }
1848 's
1849 if$
1850 }
1851
1852 INTEGERS { fullptr numfull fullsleft }
1853
1854 STRINGS { u1 u2 }
1855
1856 FUNCTION {my.full.label}
1857 {
1858 % Initialize 'u1','u2','s'.
1859 "" 'u1 :=
1860 "" 'u2 :=
1861 's :=
1862
1863 % Initialize 'fullptr','numfull','fullsleft'.
1864 #1 'fullptr :=
1865 s num.names$ 'numfull :=
1866 numfull 'fullsleft :=
1867
1868 % enter the while loop which generates the first-citation information.
1869 % while we have names left,
1870 % format the next name
1871 % if this is the next-to-last name, tack the ampersand on the end
1872 % else if this isn't the last name, tack the comma on the end.
1873 % concatenate the next name onto the first-citation string.
1874 % update the counters.
1875
1876 { fullsleft #0 > }
1877 { s fullptr "{vv~}{ll}" format.name$ 'u1 :=
1878 fullsleft #2 =
1879 { u1 " \& " * 'u1 := }
1880 { fullsleft #2 >
1881 { u1 ", " * 'u1 := }
1882 'skip$
1883 if$
1884 }
1885 if$
1886 u2 u1 * 'u2 :=
1887 fullptr #1 + 'fullptr :=
1888 fullsleft #1 - 'fullsleft :=
1889 }
1890 while$
1891
1892 % push 'u2' onto the stack -- our first-citation information.
1893 u2
1894 }
1895
1896 FUNCTION {format.lab.names}
1897 { 's :=
1898 s #1 "{vv~}{ll}" format.name$
1899 s num.names$ duplicate$
1900 #2 >
1901 { pop$ " et~al." * }
1902 { #2 <
1903 'skip$
1904 { s #2 "{ff }{vv }{ll}{ jj}" format.name$ "others" =
1905 { "et~al. " * }
1906 % { " and " * s #2 "{vv~}{ll}" format.name$ * }
1907 { " \& " * s #2 "{vv~}{ll}" format.name$ * }
1908 if$
1909 }
1910 if$
1911 }
1912 if$
1913 }
1914
1915 FUNCTION {author.key.label}
1916 { author empty$
1917 { key empty$
1918 { cite$ #1 #3 substring$ }
1919 'key
1920 if$
1921 }
1922 { author format.lab.names }
1923 if$
1924 }
1925
1926 FUNCTION {editor.key.label}
1927 { editor empty$
1928 { key empty$
1929 { cite$ #1 #3 substring$ }
1930 'key
1931 if$
1932 }
1933 { editor format.lab.names }
1934 if$
1935 }
1936
1937 FUNCTION {author.editor.key.label}
1938 { author empty$
1939 { editor empty$
1940 { key empty$
1941 { cite$ #1 #3 substring$ }
1942 'key
1943 if$
1944 }
1945 { editor format.lab.names }
1946 if$
1947 }
1948 { author format.lab.names }
1949 if$
1950 }
1951
1952 FUNCTION {calc.label}
1953 { type$ "book" =
1954 type$ "inbook" =
1955 or
1956 'author.editor.key.label
1957 { type$ "proceedings" =
1958 'editor.key.label
1959 'author.key.label
1960 if$
1961 }
1962 if$
1963 duplicate$
1964
1965 author my.full.label % generate the first-citation information.
1966
1967 "\protect\citeauthoryear{" swap$ * "}{" * swap$ * "}{" *
1968 year field.or.null purify$ #-1 #4 substring$ *
1969 'label :=
1970 year field.or.null purify$ #-1 #4 substring$ *
1971 sortify 'sort.label :=
1972 }
1973
1974 FUNCTION {sort.format.names}
1975 { 's :=
1976 #1 'nameptr :=
1977 ""
1978 s num.names$ 'numnames :=
1979 numnames 'namesleft :=
1980 { namesleft #0 > }
1981 { nameptr #1 >
1982 { " " * }
1983 'skip$
1984 if$
1985 s nameptr "{vv{ } }{ll{ }}{ f{ }}{ jj{ }}" format.name$ 't :=
1986 nameptr numnames = t "others" = and
1987 { "et al" * }
1988 { t sortify * }
1989 if$
1990 nameptr #1 + 'nameptr :=
1991 namesleft #1 - 'namesleft :=
1992 }
1993 while$
1994 }
1995
1996 FUNCTION {sort.format.title}
1997 { 't :=
1998 "A " #2
1999 "An " #3
2000 "The " #4 t chop.word
2001 chop.word
2002 chop.word
2003 sortify
2004 #1 global.max$ substring$
2005 }
2006
2007 FUNCTION {author.sort}
2008 { author empty$
2009 { key empty$
2010 { "to sort, need author or key in " cite$ * warning$
2011 ""
2012 }
2013 { key sortify }
2014 if$
2015 }
2016 { author sort.format.names }
2017 if$
2018 }
2019
2020 FUNCTION {editor.sort}
2021 { editor empty$
2022 { key empty$
2023 { "to sort, need editor or key in " cite$ * warning$
2024 ""
2025 }
2026 { key sortify }
2027 if$
2028 }
2029 { editor sort.format.names }
2030 if$
2031 }
2032
2033 FUNCTION {author.editor.sort}
2034 { author empty$
2035 { editor empty$
2036 { key empty$
2037 { "to sort, need author, editor, or key in " cite$ * warning$
2038 ""
2039 }
2040 { key sortify }
2041 if$
2042 }
2043 { editor sort.format.names }
2044 if$
2045 }
2046 { author sort.format.names }
2047 if$
2048 }
2049
2050 FUNCTION {presort}
2051 { calc.label
2052 label sortify
2053 " "
2054 *
2055 type$ "book" =
2056 type$ "inbook" =
2057 or
2058 'author.editor.sort
2059 { type$ "proceedings" =
2060 'editor.sort
2061 'author.sort
2062 if$
2063 }
2064 if$
2065 #1 entry.max$ substring$ % added for newapa
2066 'sort.label := % added for newapa
2067 sort.label % added for newapa
2068 *
2069 " "
2070 *
2071 title field.or.null
2072 sort.format.title
2073 *
2074 #1 entry.max$ substring$
2075 'sort.key$ :=
2076 }
2077
2078 ITERATE {presort}
2079
2080 SORT % by label, sort.label, title --- for final label calculation
2081
2082 STRINGS { last.label next.extra }
2083
2084 INTEGERS { last.extra.num }
2085
2086 FUNCTION {initialize.extra.label.stuff}
2087 { #0 int.to.chr$ 'last.label :=
2088 "" 'next.extra :=
2089 #0 'last.extra.num :=
2090 }
2091
2092 FUNCTION {forward.pass}
2093 { last.label label =
2094 { last.extra.num #1 + 'last.extra.num :=
2095 last.extra.num int.to.chr$ 'extra.label :=
2096 }
2097 { "a" chr.to.int$ 'last.extra.num :=
2098 "" 'extra.label :=
2099 label 'last.label :=
2100 }
2101 if$
2102 }
2103
2104 FUNCTION {reverse.pass}
2105 { next.extra "b" =
2106 { "a" 'extra.label := }
2107 'skip$
2108 if$
2109 label extra.label * "}" * 'label :=
2110 extra.label 'next.extra :=
2111 }
2112
2113 EXECUTE {initialize.extra.label.stuff}
2114
2115 ITERATE {forward.pass}
2116
2117 REVERSE {reverse.pass}
2118
2119 FUNCTION {bib.sort.order}
2120 { sort.label
2121 " "
2122 *
2123 year field.or.null sortify
2124 *
2125 " "
2126 *
2127 title field.or.null
2128 sort.format.title
2129 *
2130 #1 entry.max$ substring$
2131 'sort.key$ :=
2132 }
2133
2134 ITERATE {bib.sort.order}
2135
2136 SORT % by sort.label, year, title --- giving final bib. order.
2137
2138 FUNCTION {begin.bib}
2139
2140 { preamble$ empty$
2141 'skip$
2142 { preamble$ write$ newline$ }
2143 if$
2144 "\begin{thebibliography}{}" write$ newline$
2145 }
2146
2147
2148 EXECUTE {begin.bib}
2149
2150 EXECUTE {init.state.consts}
2151
2152 ITERATE {call.type$}
2153
2154 FUNCTION {end.bib}
2155 { newline$
2156 "\end{thebibliography}" write$ newline$
2157 }
2158
2159 EXECUTE {end.bib}
2160 \end{filecontents*}
2161 %</newapavebst>
2162 %
2163 %
2164 %\changes{0.1}{2007/08/01}{Installer: added \file{newapave2.sty}}
2165 %^^A =================================================================
2166 %^^A Here is the creation of the bibliography style file newapave2.sty
2167 %^^A It is written on first LaTeX run if it does not already exist
2168 %^^A =================================================================
2169 %<*newapavesty>
2170 \begin{filecontents*}{newapave2.sty}
2171 %$$$ newapave2.sty $$$ --- July 15, 2010 (Version 2.21)
2172 % - Version 2.1.
2173 %
2174 % This file implements citations for the ``newapave'' bibliography style.
2175 %
2176 % Stephen N. Spencer
2177 % modified the ``apalike'' LaTeX style
2178 % Young U. Ryu
2179 % further modified
2180 % Vincent Verfaille
2181 % modified as 'newapave' for DAFx-06: right-flushed back-references!
2182 %
2183 % SEE THE FOLLOWING COMMENTS. THEY CONSISTS OF 4 SECTIONS
2184 % 1 - newapave.bst and \bibitem entry
2185 % 2 - citation formats
2186 % 3 - changing citation functions (if you want)
2187 % 4 - enforcing APA style section heading (if you want)
2188 %
2189 %%%%%
2190 % [1] newapave.bst and \bibitem entry
2191 %
2192 % The ``newapave.bst'' BibTeX bibliography style creates citations with labels:
2193 % \citeauthoryear{author-info}{abbrev. author-info}{year}
2194 %
2195 %%%%%
2196 % [2] Citation Formats
2197 %
2198 % The citations are enclosed within parentheses. ``(,)''
2199 % as default. But one may change them.
2200 % Short author lists use the ``et al.'' construct.
2201 % These labels are processed by the following LaTeX commands:
2202 %
2203 % \cite[optional notes]{Key(s)}
2204 % -> (Authors1, Year1; Authors2, Year2; ..., optional notes)
2205 % \citeA[optional notes]{key}
2206 % -> Authors (Year, optional notes)
2207 % Note: ONE AND ONLY ONE KEY.
2208 % \citeA[pp.~3--5]{Apt88,Lloyd87} does not make sense at all.
2209 % In this case, the outcome will look aweful.
2210 % \citeB{keys}
2211 % -> Authors1 (Year1), Authors2 (Year2), ...
2212 % Note: \citeB[Notes]{keys} are given, notes will be ingored,
2213 % because it does not make sense at all.
2214 % \citeauthor[optional notes]{key}
2215 % -> Authors1, Authors2, ..., optional notes
2216 %
2217 % The difference between `\shortciteXXX' and `\citeXXX':
2218 % is that `\shortciteXXX' gives `First author et al.'
2219 % if no. authors >= 3.
2220 %
2221 % \shortcite[optional notes]{Key(s)}
2222 % -> (Short Authors1, Year1; Short Authors2, Year2; ..., optional notes)
2223 % \shortciteA[optional notes]{key}
2224 % -> Short Authors (Year, optional notes)
2225 % Note: ONE AND ONLY ONE KEY.
2226 % \shortciteA[pp.~3--5]{Apt88,Lloyd87} does not make sense at all.
2227 % In this case, the outcome will look aweful.
2228 % \shortciteB{keys}
2229 % -> Authors1 (Year1), Authors2 (Year2), ...
2230 % Note: \citeB[Notes]{keys} are given, notes will be ingored,
2231 % because it does not make sense at all.
2232 % \shortciteauthor[optional notes]{key}
2233 % -> Short Authors1, Short Authors2, ..., optional notes
2234 %
2235 % \citeyear[optional notes]{key}
2236 % -> (Year, optional notes)
2237 %
2238 %%%%%
2239 % [3] Changing Citation Punctuations
2240 %
2241 % However, you may change citation punctuations.
2242 % \citepunct{open paren}%
2243 % {between authors}%
2244 % {between author year}%
2245 % {between citations}%
2246 % {before notes}%
2247 % {closing paren}
2248 %
2249 % For example,
2250 % \citepunct{[}{and}{ }{, }{: }{]}
2251 % - use square brackets
2252 % `and' between authors
2253 % space between author and year
2254 % comma between citations
2255 % comma before notes
2256 % e.g. [Apt and van Emden 1986, Lloyd 1985: Notes]
2257 %
2258 % The default is:
2259 % \citepunct{(}{\&}{, }{; }{, }{)}
2260 %
2261 % Notice spaces around punctuations in \citepunct!!!
2262 %
2263 %%%%%
2264 % [4] Enforcing APA Style Section Heading
2265 %
2266 % \newapasectioning redefines section headings as described
2267 % by the APA Publication Manual
2268 % \section - level 1 (toc entry, paageheading)
2269 % \subsection - level 2 (toc entry)
2270 % \subsection - level 3 (toc entry)
2271 % \paragraph - level 4
2272 % \subparagraph - level 3
2273 %
2274 % if place * after \section, \subsection, \subsubsection
2275 % section headings are not listed in the table of contents
2276 %
2277 \def\citestarts{(}
2278 \def\betweenauthors{\&}
2279 \def\betweenauthoryear{, }
2280 \def\betweencites{; }
2281 \def\beforenote{, }
2282 \def\citeends{)}
2283 %
2284 \def\citepunct#1#2#3#4#5#6{%
2285 \def\citestarts{#1}
2286 \def\betweenauthors{#2}
2287 \def\betweenauthoryear{#3}
2288 \def\betweencites{#4}
2289 \def\beforenote{#5}
2290 \def\citeends{#6} }
2291 %
2292 \let\@internalcite\cite
2293 %
2294 %
2295 \def\cite{\def\@citeseppen{-1000}%
2296 \def\@cite##1##2{%
2297 \citestarts##1\if@tempswa \beforenote##2\fi\citeends}%
2298 \def\citeauthoryear##1##2##3{##1\betweenauthoryear##3}\@internalcite}
2299 \def\citeA{\def\@citeseppen{-1000}%
2300 \def\@cite##1##2{%
2301 ##1\if@tempswa \beforenote##2\fi\citeends}%
2302 \def\citeauthoryear##1##2##3{##1 \citestarts##3}\@citedata}
2303 \def\citeB{\def\@citeseppen{-1000}%
2304 \def\@cite##1##2{##1}%
2305 \def\citeauthoryear##1##2##3{##1 \citestarts##3\citeends}\@citedata}
2306 \def\citeauthor{\def\@citeseppen{-1000}%
2307 \def\@cite##1##2{%
2308 ##1\if@tempswa \beforenote##2\fi}%
2309 \def\citeauthoryear##1##2##3{##1}\@citedata}
2310 %
2311 %
2312 \def\shortcite{\def\@citeseppen{-1000}%
2313 \def\@cite##1##2{%
2314 \citestarts##1\if@tempswa \beforenote##2\fi\citeends}%
2315 \def\citeauthoryear##1##2##3{##2\betweenauthoryear##3}\@internalcite}
2316 \def\shortciteA{\def\@citeseppen{-1000}%
2317 \def\@cite##1##2{%
2318 ##1\if@tempswa \beforenote##2\fi\citeends}%
2319 \def\citeauthoryear##1##2##3{##2 \citestarts##3}\@citedata}
2320 \def\shortciteB{\def\@citeseppen{-1000}%
2321 \def\@cite##1##2{##1}%
2322 \def\citeauthoryear##1##2##3{##2 \citestarts##3\citeends}\@citedata}
2323 \def\shortciteauthor{\def\@citeseppen{-1000}%
2324 \def\@cite##1##2{%
2325 ##1\if@tempswa \beforenote##2\fi}%
2326 \def\citeauthoryear##1##2##3{##2}\@citedata}
2327 %
2328 \def\citeyear{\def\@citeseppen{-1000}%
2329 \def\@cite##1##2{%
2330 \citestarts##1\if@tempswa \beforenote##2\fi\citeends}%
2331 \def\citeauthoryear##1##2##3{##3}\@citedata}
2332 %
2333 \def\@citedata{\@ifnextchar[{\@tempswatrue\@citedatax}{\@tempswafalse\@citedatax[]}}
2334 %
2335 \def\@citedatax[#1]#2{%
2336 \if@filesw\immediate\write\@auxout{\string\citation{#2}}\fi
2337 \def\@citea{}\@cite{\@for\@citeb:=#2\do
2338 {\@citea\def\@citea{\betweencites}\@ifundefined
2339 {b@\@citeb}{{\bf ?}\@warning
2340 {Citation `\@citeb' on page \thepage \space undefined}}
2341 {\csname b@\@citeb\endcsname}}}{#1}}
2342 %
2343 \def\@citex[#1]#2{%
2344 \if@filesw\immediate\write\@auxout{\string\citation{#2}}\fi
2345 \def\@citea{}\@cite{\@for\@citeb:=#2\do
2346 {\@citea\def\@citea{\betweencites}\@ifundefined
2347 {b@\@citeb}{{\bf ?}\@warning
2348 {Citation `\@citeb' on page \thepage \space undefined}}%
2349 {\csname b@\@citeb\endcsname}}}{#1}}
2350 %
2351 % (from apalike.sty)
2352 % No labels in the bibliography.
2353 % Set length of hanging indentation for bibliography entries.
2354 \def\@biblabel#1{}
2355 \newlength{\bibhang}
2356 %\setlength{\bibhang}{1em} % ORIGINAL
2357 \setlength{\bibhang}{0.5em} % DAFx-06
2358 %
2359 \def\thebibliography#1{%
2360 \section*{\bibname}
2361 \addcontentsline{toc}{part}{\large \bfseries \bibname}
2362 \list
2363 {\relax}{\setlength{\labelsep}{0em}
2364 \setlength{\itemindent}{-\bibhang}
2365 \setlength{\leftmargin}{\bibhang}}
2366 % \def\newblock{\hskip .11em plus .33em minus .07em} % ORIGINAL
2367 \def\newblock{\hskip 0em plus 0.0em minus .07em} % DAFx-06
2368 \sloppy\clubpenalty4000\widowpenalty4000
2369 \sfcode`\.=1000\relax}
2370 %
2371 %
2372 %
2373 %%% Sectioning
2374
2375 \def\newapasectioning{
2376 \newlength{\sectionheadwidth}
2377 \setlength{\sectionheadwidth}{\textwidth}
2378 \addtolength{\sectionheadwidth}{-8em}
2379 \let\@internalsection\section
2380 \let\@internalsubsection\subsection
2381 \let\@internalsubsubsection\subsubsection
2382 \let\@internalparagraph\paragraph
2383 \let\@internalsubparagraph\subparagraph
2384 % Level 1
2385 \def\section{\@ifnextchar *{\a@sections}{\a@section}}
2386 \def\a@sections##1##2{%
2387 \@internalsection*{%
2388 \centering\parbox{%
2389 \sectionheadwidth}{%
2390 \centering\normalsize\bf\uppercase{##2}}\@mkboth{##2}{##2}}}
2391 \def\a@section##1{%
2392 \addcontentsline{toc}{section}{##1}
2393 \@internalsection*{%
2394 \centering\parbox{%
2395 \sectionheadwidth}{%
2396 \centering\normalsize\bf\uppercase{##1}}\@mkboth{##1}{##1}}}
2397 % Level 2
2398 \def\subsection{\@ifnextchar *{\a@subsections}{\a@subsection}}
2399 \def\a@subsections##1##2{%
2400 \@internalsubsection*{%
2401 \centering\parbox{\sectionheadwidth}{\centering\normalsize\bf##2}}}
2402 \def\a@subsection##1{%
2403 \addcontentsline{toc}{subsection}{##1}
2404 \@internalsubsection*{%
2405 \centering\parbox{\sectionheadwidth}{\centering\normalsize\bf##1}}}
2406 % Level 3
2407 \def\subsubsection{\@ifnextchar *{\a@subsubsections}{\a@subsubsection}}
2408 \def\a@subsubsections##1##2{%
2409 \@internalsubsubsection*{%
2410 \centering\parbox{%
2411 \sectionheadwidth}{\centering\normalsize\underbar{##2}}}}
2412 \def\a@subsubsection##1{%
2413 \addcontentsline{toc}{subsubsection}{##1}
2414 \@internalsubsubsection*{%
2415 \centering\parbox{%
2416 \sectionheadwidth}{\centering\normalsize\underbar{##1}}}}
2417 % Level 4
2418 \def\a@paragraph##1{%
2419 \@internalsubsubsection*{\normalsize\underbar{##1}}}
2420 % Level 5
2421 \def\a@subparagraph##1{%
2422 \@internalsubparagraph*{\normalsize\underbar{##1}.}}
2423 % table of contents
2424 \def\tableofcontents{%
2425 \section*{Contents}\@starttoc{toc}}
2426 % list of figures
2427 \def\listoffigures{%
2428 \section*{List of Figures}\@starttoc{lof}}
2429 % list of tables
2430 \def\listoftables{%
2431 \section*{List of Tables}\@starttoc{lot}}
2432 % Change : to . in Figure/Table Caption
2433 \long\def\@makecaption##1##2{
2434 \vskip 10pt
2435 \setbox\@tempboxa\hbox{##1. ##2}
2436 \ifdim \wd\@tempboxa >\hsize ##1. ##2\par \else \hbox
2437 to\hsize{\hfil\box\@tempboxa\hfil}
2438 \fi}
2439 }
2440 \end{filecontents*}
2441 %</newapavesty>
2442 %
2443 %
2444 %
2445 %^^A =================================================================
2446 % \changes{0.7}{2010/08/05}{Example: added \file{example4optim.tex}}
2447 %<*example4optim>
2448 \begin{filecontents*}{example4optim.tex}
2449 \usepackage{setspace}
2450 \usepackage{xkeyval}
2451 \usepackage{newapave}
2452 \usepackage[utf8]{inputenc}
2453 \usepackage[T1]{fontenc}
2454 \usepackage{mathptmx}
2455 \usepackage[super]{nth}
2456
2457 \setlength{\LaTeXxShift}{0pt}
2458 \setlength{\LaTeXyShift}{-3mm} %letter
2459 \setlength{\WordxShift}{10pt}
2460 \setlength{\WordyShift}{-40pt}
2461
2462 \definecolor{colorforlink}{rgb}{0,0,0.8}
2463 \definecolor{colorforcite}{rgb}{0,0.8,0}
2464 \definecolor{colorforurl}{rgb}{0,0,1}
2465
2466 \newcommand{\DAFxname}{Proc.~of the \nth{9} %
2467 Int.~Conference on Digital Audio Effects (DAFx-06)}
2468 \newcommand{\DAFxdate}{September 18-20, 2006}
2469 \newcommand{\DAFxaddress}{Montreal, Canada}
2470
2471 \renewcommand{\procpdfauthor}{Vincent Verfaille, McGill University}
2472 \renewcommand{\procpdftitle}{DAFx-06 Proceedings - \DAFxaddress}
2473 \renewcommand{\procpdfsubject}{Conference proceedings}
2474
2475 \renewcommand{\procchead}{} %
2476 \renewcommand{\proclhead}{{\em \small \DAFxname, \DAFxaddress, \DAFxdate}}
2477 \renewcommand{\proccfoot}{{\small DAFX-\thepage}}
2478 \setlength{\procfootvskip}{1.2mm}
2479 \setlength{\procoptfootvskip}{4mm}
2480
2481 \author{\procpdfauthor}
2482 \title{\DAFxname\\ \DAFxaddress}
2483 \date{\DAFxdate}
2484
2485 \renewcommand{\contentsname}{Day-by-Day Conference Program}
2486 \renewcommand{\bibname}{General Bibliography}
2487 \renewcommand{\indexname}{List of Authors}
2488 \renewcommand{\PAPERPATH}{papers/}
2489 \newcommand{\PICTPATH}{pictures/}
2490 \newcommand{\TEXTPATH}{}
2491 \newcommand{\BIBPATH}{}
2492 \newcommand{\procbibfile}{\BIBPATH exbiblio}
2493 \newcommand{\myaddhruletotoc}{\vspace*{0.1cm}%
2494 \noindent\protect\hrulefill\par\vspace*{-0.15cm}}
2495 \newcommand{\myaddthickhruletotoc}{\vspace*{0.5cm}%
2496 \noindent\protect\hrule height 0.6ex \hfill\par\vspace*{0.1cm}}
2497 \renewcommand{\procday}[1]{%
2498 \phantomsection%
2499 \addcontentsline{toc}{part}{#1}} % \centerline{#1}
2500 \renewcommand{\session}[1]{%
2501 \phantomsection%
2502 \addcontentsline{toc}{chapter}{#1}}
2503 \renewcommand{\mainmattertocstyle}{
2504 \titlecontents{section}[2.5em]%
2505 {\vspace*{0.25em}}%
2506 {\hspace*{-2.5em}\contentspage\hspace*{2.5em}}%
2507 {\hspace*{-2.5em}\contentspage\hspace*{2.5em}}%
2508 {}%
2509 \titlecontents{chapter}[0pt]%
2510 {\addvspace{0.5pc}\bfseries\itshape}%
2511 {\myaddhruletotoc\contentsmargin{0pt}\bfseries %
2512 \makebox[0pt][r]{\huge\contentspage\enspace}\large}%
2513 {\myaddhruletotoc\contentsmargin{0pt}\large}%
2514 {}[\addvspace{.3pc}]%
2515 \titlecontents{part}[0pt]%
2516 {\addvspace{0.5pc}\bfseries}%
2517 {\myaddthickhruletotoc\contentsmargin{0pt}\bfseries %
2518 \makebox[0pt][r]{\huge\contentspage\enspace}\large}%
2519 {\myaddthickhruletotoc\contentsmargin{0pt}\large}%
2520 {}[\addvspace{.3pc}]%
2521 }
2522 \renewcommand{\backmattertocstyle}{%
2523 \titlecontents{section}[]{}{}{}{}[]%
2524 \titlecontents{part}%
2525 [0pt]%
2526 {\addvspace{2pc}}%
2527 {\contentspage\hspace*{2.5em}\vspace*{-8mm}\contentsmargin{0pt}%
2528 \bfseries\makebox[0pt][r]{\huge\contentspage\enspace}\large\bfseries}%
2529 {\contentspage\hspace*{2.5em}\vspace*{-8mm}\contentsmargin{0pt}\large\bfseries}%
2530 {}%
2531 [\addvspace{.5pc}]%
2532 }%
2533 %%\renewcommand{\papertitlestyle}{}
2534 \renewcommand{\papertitlestyle}{\texorpdfstring{}{\scshape}}
2535 %%\renewcommand{\paperauthorstyle}{\texorpdfstring{\newline\itshape}{\break}}
2536 \renewcommand{\paperauthorstyle}{\texorpdfstring{, \hfill}{\break}}
2537 \renewcommand{\proctoctitleauthor}[2]{%
2538 \texorpdfstring{{\paperauthorstyle #2}{\papertitlestyle #1}}{{\papertitlestyle #1}}}
2539 \renewcommand{\paperauthorstyle}{\texorpdfstring{\itshape}{}}
2540 \renewcommand{\papertitlestyle}{\texorpdfstring{\newline}{\break}}
2541 \renewcommand{\confstylechecktitle}{\vspace*{0.3cm} %
2542 \bf \sc \Large \noindent \centerline}
2543 \renewcommand{\confstylecheckauthor}{\large \it \noindent \centerline}
2544 \makeindex
2545
2546 %%%=========== PROCEEDINGS ===========
2547 \begin{document}
2548
2549 \frontmatter
2550 \frontmattertocstyle
2551 %%\layout
2552 %%\begin{figure}
2553 %% \setlayoutscale{0.8} \tocdiagram
2554 %% \caption{Table of Contents entry parameters} \label{fig:tocp}
2555 %%\end{figure}
2556 %%\begin{figure}
2557 %% \setlayoutscale{0.8} \currenttoc \tocdesign
2558 %% \caption{Typical Table of Contents entry for this document}
2559 %% \label{fig:thistoc}
2560 %%\end{figure}
2561 %%\clearsingleordoublepage
2562 \setcounter{page}{1}
2563 \pdfbookmark[0]{Preamble}{preamble}
2564 \pdfbookmark[1]{Cover}{cover}
2565 \maketitle
2566 %%\includepdf[noautoscale,pages=1,link]{\PICTPATH ex_1stpage.pdf}
2567 \addtocontents{toc}{\vskip 1cm}
2568 \addtocontents{toc}{\centerline{\huge\textsc{Conference Program}}}
2569 \renewcommand{\contentsname}{\texorpdfstring{}{Conference Program}}
2570 \newpage
2571 \vspace*{1.7cm}
2572 \pdfbookmark[1]{Publishing informations}{publishing}
2573 \thispagestyle{empty}
2574 \noindent {\bf Published by:}\\ Laboratory Name\\ Department name\\
2575 School Name\\ University Name\\
2576 \url{http://www.conferencesite.com}\\
2577 \vspace*{0.15cm}\newline
2578 \noindent {\bf ISBN: X-XXXX-XXXXXX}\\
2579 \vspace*{0.35cm}\newline
2580 \noindent {\bf Credits:}\\
2581 Cover design: Firstname Lastname\\
2582 Logo photo: Firstname Lastname\\
2583 \LaTeX{} editor: Firstname Lastname\\
2584 using \LaTeX's `confproc' package, version 0.8 (optional: by V. Verfaille)\\
2585 \vspace*{0.35cm}\newline
2586 \noindent Printed in City by Print-Company --- Month Year
2587 \otherpagestyle
2588 %%%-- Welcome letters
2589 \clearsingleordoublepage
2590 \vspace*{0.6cm}
2591 \thisotherpagestyle
2592 \pdfbookmark[1]{Welcome from Firstname Lastname}{welcome}
2593 \section*{Welcome from Firstname Lastname, Conference Chair}
2594 \vspace*{1.1cm}
2595 \onehalfspace
2596 \begin{center}
2597 \begin{minipage}[h]{14cm}
2598 Text of the welcome letter, with 1.5 lines spacing, blah blah...
2599 Text of the welcome letter, with 1.5 lines spacing, blah blah...
2600 Text of the welcome letter, with 1.5 lines spacing, blah blah...
2601 Text of the welcome letter, with 1.5 lines spacing, blah blah...
2602 \end{minipage}
2603 \end{center}
2604 \doublespace
2605 \begin{center}
2606 \begin{minipage}[h]{14cm}
2607 Text of the welcome letter, with 2 lines spacing, blah blah...
2608 Text of the welcome letter, with 2 lines spacing, blah blah...
2609 Text of the welcome letter, with 2 lines spacing, blah blah...
2610 Text of the welcome letter, with 2 lines spacing, blah blah...
2611 \end{minipage}
2612 \end{center}
2613 \singlespace
2614 \tableofcontents
2615
2616 %%%==== BEGINNING OF PAPERS ====
2617 \setcounter{npagespreamble}{\arabic{page}-1} % only useful for the 'pdftk' option
2618 \mainmatter
2619 \mainmattertocstyle
2620 \input{\TEXTPATH expapersswitch}
2621 \procday{Day 1}
2622 \session{Oral Session 1}
2623 \paperid{45}{p_001}
2624 \paperid{21}{p_003}
2625 \session{Poster Session 1}
2626 \paperid{33}{p_005}
2627 \procday{Day 2}
2628 \session{Oral Session 2}
2629 \paperid{75}{p_007}
2630 \paperid{27}{p_009}
2631
2632 %%%==== END OF PAPERS ====
2633 \backmatter
2634 \backmattertocstyle
2635 \bibliographystyle{newapave}
2636 %%\bibliographystyle{newapa}
2637 {\footnotesize\bibliography{\procbibfile}}
2638 \insertindex
2639 \end{document}
2640 \end{filecontents*}
2641 %</example4optim>
2642 %
2643 %
2644 %
2645 %
2646 %^^A =================================================================
2647 %^^A Here is the driver for customized documentation
2648 %^^A =================================================================
2649 %<*driver>
2650 %
2651 % We do not specify any options by default and its recommended not to
2652 % change this. If you want to use a4paper the proper way is to add
2653 % a line
2654 % \PassOptionsToClass{a4paper}{article}
2655 % to your `ltxdoc.cfg'.
2656 \documentclass{ltxdoc}
2657 %
2658 %\changes{0.1}{2007/08/01}{Doc style: added \package{hyperref} package}
2659 % Only use fontenc if it is present
2660 \IfFileExists{fontenc.sty}{%
2661 \usepackage[T1]{fontenc}}{}
2662 % \changes{0.4b}{2007/10/12}{Pkg: \package{mathptmx} replaces \package{times}}
2663 \usepackage{mathptmx}
2664 % \changes{0.4b}{2007/10/12}{Pkg: \package{nth} for superscript ordinals}
2665 \usepackage[super]{nth}
2666 \usepackage{graphicx}
2667 \usepackage{url}
2668 \usepackage{amssymb,amsmath}
2669 % \changes{0.5}{\datevzfive}{Pkg: \package{manfnt} for `danger' sign}
2670 \usepackage{manfnt}
2671 \usepackage{xcolor}
2672 \usepackage[braces]{colordoc}
2673 \usepackage{layout}
2674 \RequirePackage[pdftex,colorlinks=true,linkcolor=blue!80!black,citecolor=blue!80!black,%
2675 urlcolor=blue!80!black,bookmarksopen=true,bookmarksopenlevel=1,raiselinks,%
2676 hyperindex,backref,pagebackref,plainpages=false,pdfpagelabels,%
2677 breaklinks,linktocpage=false,pdfstartview=XYZ]{hyperref}
2678 %\usepackage[color=orange!40]{todonotes} % [colorinlistoftodos] must be placed AFTER hyperref
2679 %
2680 \usepackage{supertabular}
2681 %\usepackage{tweaklist}
2682 %\renewcommand{\enumhook}{\setlength{\topsep}{0pt}%
2683 % \setlength{\itemsep}{0pt}}
2684
2685 % By default this file will build the `user' documentation. It
2686 % covers the basic information you need as an user and provides
2687 % (if you want to) a compact index with the most important
2688 % commands. To get the `programmer' documentation (with code
2689 % listing, extended command index and change history), comment out
2690 % the next line
2691 %\OnlyDescription
2692
2693 % To produce the compact command index:
2694 % run makeindex -s confproc.ist confproc
2695
2696 % If you commented out \OnlyDescription, you are able to control the
2697 % index and change history with the following commands:
2698
2699 % To produce the extended command index: add the following line
2700 % one run, then run makeindex -s gind.ist confproc
2701 % and re-process, with or without this line (much faster without)
2702 %
2703 % This will only have an effect if you commented out
2704 % \OnlyDescription above!
2705 \EnableCrossrefs
2706
2707 % Next you can control the index numbering by the two commands
2708 % \PageIndex and \CodelineIndex (I prefer the latter one..). If
2709 % you don't want any index, comment out both commands.
2710 %
2711 % Description index entries refer to page numbers, code listing
2712 % index entries refer to code lines
2713 \CodelineIndex
2714 % Make all index entries (description and code listing) refer to
2715 % page numbers (if you add the following line you should comment
2716 % out the \CodelineIndex)
2717 % \PageIndex
2718
2719 % Produce a 2 column index (if any)
2720 \setcounter{IndexColumns}{2}
2721
2722 \setlength{\textwidth}{14cm}
2723 \setlength{\headheight}{-1.5cm}
2724 \setlength{\textheight}{22cm}
2725 %\setlength{\voffset}{-28truept}
2726 %% Increase the marginpar width slightly, for long command names. And increase the left margin by a similar amount
2727 \let\oldmarginpar\marginpar
2728 \renewcommand\marginpar[1]{\-\oldmarginpar[\raggedleft\footnotesize #1]%
2729 {\raggedright\footnotesize #1}}
2730 % \addtolength\marginparwidth{30pt}
2731 % \addtolength\oddsidemargin{20pt}
2732 % \addtolength\evensidemargin{20pt}
2733 \setcounter{StandardModuleDepth}{1}
2734
2735 % To produce a change history: add the following line for one run,
2736 % then run makeindex -s gglo.ist -o confproc.gls confproc.glo
2737 % and re-process, with or without this line (faster without)
2738 \RecordChanges
2739
2740 \begin{document}
2741 \DocInput{confproc.dtx}
2742 \end{document}
2743 %</driver>
2744 % \fi
2745 %
2746 %
2747 %
2748 %
2749 %^^A =================================================================
2750 %^^A We continue with the `normal' .dtx-file
2751 %^^A =================================================================
2752 %
2753 %
2754 %^^A ======= LIST OF GENERAL CHANGES ======
2755 %^^A\changes{0.1c}{2007/07/30}{Doc: new}
2756 %^^A\changes{0.1c}{2007/07/30}{Introduction: new}
2757 %^^A\changes{0.2d}{2007/08/18}{Index: removing from index all commands not related to the 'confproc' package}
2758 %^^A\changes{0.2e}{2007/09/01}{Introduction: reorganized}
2759 %^^A\changes{0.2e}{2007/09/01}{Introduction: history shortened}
2760 %^^A \changes{0.3}{2007/09/28}{Doc: typo and spell checks}
2761 % \changes{0.3}{2007/09/24}{initial version}
2762 % \changes{0.4a}{2007/10/03}{move formatting issues in re-defined commands}
2763 % \changes{0.4b}{2007/10/12}{changes from Will Robertson's advices}
2764 % \changes{0.4d}{2007/10/12}{re-organize changes history (use `macro' environment)}
2765 % \changes{0.4e}{2007/10/12}{clean up the uses of \cmd{\DescribeMacro} and \cmd{\begin\{macro\}\{\}} commands}
2766 %
2767 %^^A =================================================================
2768 %^^A Even with enabled crossrefs do not index all macros.
2769 %^^A =================================================================
2770 % \DoNotIndex{\@empty}
2771 % \DoNotIndex{\@ifundefined}
2772 % \DoNotIndex{\@maketitle}
2773 % \DoNotIndex{\@ne}
2774 % \DoNotIndex{\@plus}
2775 % \DoNotIndex{\@tempboxa, \@tempcnta, \@tempdima}
2776 % \DoNotIndex{\\, \", \{, \}, \&, \ , \', \`, \^, \:, \~, \&, \(, \), \-, \,, \^}
2777 % \DoNotIndex{\{}
2778 % \DoNotIndex{\}}
2779 % \DoNotIndex{\$}
2780 % \DoNotIndex{\.}
2781 % \DoNotIndex{\~}
2782 % \DoNotIndex{\ }
2783 % \DoNotIndex{\1}
2784 % \DoNotIndex{\@arabic}
2785 % \DoNotIndex{\@authorlistbyfirstname}
2786 % \DoNotIndex{\@authorlistbysurname}
2787 % \DoNotIndex{\@authors}
2788 % \DoNotIndex{\@clubpenalty, \@biblabel, \@latex@warning, \@mainmatterfalse, \@mainmattertrue, \@mkboth, \@openbib@code, \@starttoc, \@twoside}
2789 % \DoNotIndex{\@idxitem}
2790 % \DoNotIndex{\@ifnextchar}
2791 % \DoNotIndex{\@m}
2792 % \DoNotIndex{\@mparswitchfalse}
2793 % \DoNotIndex{\@mparswitchtrue}
2794 % \DoNotIndex{\@noitemerr}
2795 % \DoNotIndex{\@ptsize}
2796 % \DoNotIndex{\@restonecolfalse}
2797 % \DoNotIndex{\@restonecoltrue}
2798 % \DoNotIndex{\@twosidefalse}
2799 % \DoNotIndex{\@twosidetrue}
2800 % \DoNotIndex{\addvspace, \arabic, \AtBeginDocument, \addcontentsline, \addtocontents, \addtocounter, \addtolength, \AtEndDocument, \advance}
2801 % \DoNotIndex{\afterassignment}
2802 % \DoNotIndex{\begin, \begingroup, \bf, \bfseries, \box}
2803 % \DoNotIndex{\baselineskip}
2804 % \DoNotIndex{\bigskip, \bibhang, \break}
2805 % \DoNotIndex{\caption, \centerline, \ClassError, \ClassWarning, \ClassWarningNoLine}
2806 % \DoNotIndex{\c@enumiv}
2807 % \DoNotIndex{\ClassInfo, \CurrentOption, \cdot, \count, \centering, \cleardoublepage, \clearpage, \CodelineIndex}
2808 % \DoNotIndex{\changes}
2809 % \DoNotIndex{\closeout, \clubpenalty}
2810 % \DoNotIndex{\columnsep}
2811 % \DoNotIndex{\columnseprule}
2812 % \DoNotIndex{\confproc, \conf@FinalVersion, \conf@BibMerge, \conf@BibBackRef}
2813 % \DoNotIndex{\conf@procWithColors, \conf@procWithoutColors}
2814 % \DoNotIndex{\conf@PrintNoLayout, \conf@PrintAllLayouts}
2815 % \DoNotIndex{\conf@NoFancyHeaders, \conf@FancyHeadersOnPapers, \conf@FancyHeadersExceptPapers}
2816 % \DoNotIndex{\conf@TwoColumnIndex, \conf@ThreeColumnIndex}
2817 % \DoNotIndex{\conf@TwoColumnBib, \conf@OneColumnBib}
2818 % \DoNotIndex{\conf@TwoColumnTOC, \conf@OneColumnTOC}
2819 % \DoNotIndex{\conf@TocNumberingLeft, \conf@TocNumberingRight}
2820 % \DoNotIndex{\conf@TestPageNumbering, \conf@WithCleardoublepage, \conf@WithClearsinglepage}
2821 % \DoNotIndex{\conf@procWithDebug}
2822 % \DoNotIndex{\conf@IncludePDFs, \conf@DoNotIncludePDFs}
2823 % \DoNotIndex{\DeclareRobustCommand, \def, \DeclareOption, \dimen, \divide, \documentclass}
2824 % \DoNotIndex{\em, \else, \end, \ExecuteOptions, \endgroup, \expandafter, \endlist, \enspace, \equal}
2825 % \DoNotIndex{\fontfamily, \fontseries, \fontsize, \footnoterule, \footnotesize, \frontmatter}
2826 % \DoNotIndex{\fboxrule, \fboxsep \framebox, \fi, \filedate, \fileversion}
2827 % \DoNotIndex{\gdef, \global, \GenericWarning}
2828 % \DoNotIndex{\hline, \hrule, \hrulefill, \Huge \huge, \href, \hfill, \hfil, \hskip, \hspace, \hbox, \hss, \hb@xt@, \headheight, \headsep, \hoffset, \hspace}
2829 % \DoNotIndex{\i, \it, \iffalse, \item, \IfFileExists, \InputIfFileExists, \ifx, \if, \itshape, \itemindent, \ifdefined, \ifnum, \ifthenelse, \immediate, \index, \index@prologue, \input, \itemindent}
2830 % \DoNotIndex{\jobname}
2831 % \DoNotIndex{\kern}
2832 % \DoNotIndex{\label, \LARGE, \Large, \large, \let, \lineskip, \LoadClass, \LaTeX, \layout, \leftmaergin, \list, \labelsep, \labelwidth}
2833 % \DoNotIndex{\line, \linethickness, \leftmargin}
2834 % \DoNotIndex{\mainmatter, \mbox, \MessageBreak, \makebox, \makeindex, \MakeUppercase}
2835 % \DoNotIndex{\multiput, \m@ne}
2836 % \DoNotIndex{\n, \newcommand, \newlength, \null, \noexpand, \newbox, \newif, \next@tpage, \noindent, \newcounter, \newline, \newpage, \newwrite, \nocite, \normalsize, \nth}
2837 % \DoNotIndex{\o, \oddsidemargin, \openout, \or, \opnecolumn, \onehalfspace, \otherpagestyle}
2838 % \DoNotIndex{\par, \PackageError, \PackageWarningNoLine, \put, \PageIndex, \p@enumiv, \parindent, \parskip, \PassOptionsToPackage, \phantomsection, \printindex}
2839 % \DoNotIndex{\PassOptionsToClass, \ProcessOptions, \providecommand, \protect, \parbox, \p@}
2840 % \DoNotIndex{\r, \relax, \renewcommand, \rule, \RequirePackage, \RecordChanges, \renewenvironment}
2841 % \DoNotIndex{\s, \sc, \scshape, \section, \setkeys, \setlayoutscale, \setpagenumber, \settowidth, \SetupKeyvalOptions, \sfcode, \singlespace, \sloppy, \selectfont, \setcounter, \setlength, \small, \setbox, \space, \stop, \scriptsize}
2842 % \DoNotIndex{\today, \texttt, \typeout, \thinlines, \the, \textwidth, \thispagestyle, \topmargin, \topskip, \textbf, \textheight, \textsc, \theenumiv, \thepage, \tocdesign, \tocdiagram}
2843 % \DoNotIndex{\u, \usepackage, \undefined, \underline, \unitlength, \unkern, \url, \usecounter}
2844 % \DoNotIndex{\vfil, \vskip, \vbox, \vss, \vspace, \vfill}
2845 % \DoNotIndex{\voffset, \value}
2846 % \DoNotIndex{\wd, \whiledo, \widowpenalty, \write}
2847 % \DoNotIndex{\x, \xbf}
2848 % \DoNotIndex{\z@}
2849 %
2850 %^^A =================================================================
2851 %^^A Some definitions to enhance the logical mark-up of this
2852 %^^A documentation
2853 %^^A =================================================================
2854 % ^^A for environments (`\cmd' for commands is already defined in
2855 % ^^A \package{ltxdoc.cls})
2856 % \DeclareRobustCommand*{\env}[1]{\texttt{#1}}
2857 % ^^A for packages, styles, classes
2858 % \DeclareRobustCommand*{\package}[1]{\texttt{#1}}
2859 % ^^A for eMails, urls
2860 % \DeclareRobustCommand*{\url}[1]{|#1|}
2861 % ^^A for files, paths and command-lines
2862 % \DeclareRobustCommand*{\file}[1]{\texttt{#1}}
2863 % ^^A for persons
2864 % \DeclareRobustCommand*{\person}[1]{\textsf{#1}}
2865 % ^^A for counters
2866 % \DeclareRobustCommand*{\Lcount}[1]{\textsl{\small#1}}
2867 % ^^A for length registers
2868 % \DeclareRobustCommand*{\Llength}[1]{\cmd{#1}}
2869 % ^^A for package options
2870 % \DeclareRobustCommand*{\Lopt}[1]{\textsf{\color{red!100!black}#1}}
2871 % \DeclareRobustCommand*{\LoptDescribe}[1]{\DescribeMacro{#1}\textsf{\color{red!100!black}#1}}
2872 % \DeclareRobustCommand*{\cmdDescribe}[1]{\DescribeMacro{#1}\cmd{#1}}
2873 % \DeclareRobustCommand*{\smiley}{|:-)|}
2874 % \DeclareRobustCommand*{\winkey}{|;-)|}
2875 % \DeclareRobustCommand*{\koma}{\textsf{K\kern.05em O\kern.05em%
2876 % M\kern.05em A\kern.1em-\kern.1em Script}}
2877 % \DeclareRobustCommand*{\tds}{TDS}
2878 % \DeclareRobustCommand*{\TeXLive}{\TeX{}Live}
2879 % \DeclareRobustCommand*{\ctan}{\textsc{ctan}}
2880 % \DeclareRobustCommand*{\mail}[2]{\person{#1}
2881 % \url{\textless #2\textgreater}}
2882 % \DeclareRobustCommand*{\ie}{{\em i.e.}}
2883 % \DeclareRobustCommand*{\eg}{{\em e.g.}}
2884 % \DeclareRobustCommand*{\marginBIB}{\marginpar{{\raggedleft\footnotesize \color{blue}\textsc{[bib]}}}}
2885 % \DeclareRobustCommand*{\datevzfive}{2009/08/19}
2886 % \DeclareRobustCommand*{\newvzdseven}{\marginpar{{\raggedleft\color{red!80!black} New [v0.7]}}}
2887 % \DeclareRobustCommand*{\newvzdeight}{\marginpar{{\raggedleft\color{red!80!black} New [v0.8]}}}
2888 % \DeclareRobustCommand*{\margindanger}{\marginpar{\raggedleft\footnotesize \color{red}\textdbend}}
2889 % \DeclareRobustCommand*{\danger}{{\footnotesize\textdbend~}}
2890 %
2891 %
2892 %^^A =================================================================
2893 %^^A If there is a multicol.sty present, we'll print the table of
2894 %^^A contents with 2 columns
2895 %^^A =================================================================
2896 % \newif\ifmulticols
2897 % \IfFileExists{multicol.sty}{\multicolstrue}{\multicolsfalse}
2898 %
2899 %^^A =================================================================
2900 %^^A After this the commands \filedate and \fileversion are defined
2901 %^^A =================================================================
2902 % \GetFileInfo{confproc}
2903 %
2904 %^^A Version depending scripts
2905 % \newcommand{\versionPerl}{}
2906 % \newcommand{\versionpdftk}{1.12} %^^A to update in the text too
2907 % \newcommand{\versionghostscript}{8.71} %^^A to update in the text too
2908 % \newcommand{\currentpkgversion}{0.7} %^^A to update in the text too
2909 %
2910 %
2911 %^^A\changes{0.1g}{2007/08/07}{Typo in my email}
2912 %^^A =================================================================
2913 %^^A Title definition
2914 %^^A =================================================================
2915 % \title{The \package{\filename}~package\thanks{This file version number is \fileversion~ last revision on \filedate; doc is dated \docdate.}}
2916 % \author{Vincent
2917 % Verfaille\thanks{\url{[email protected]}}}
2918 % \date{Printed on \today}
2919 % \maketitle
2920 %
2921 %^^A\changes{0.1c}{2007/07/30}{Document created}
2922 %^^A =================================================================
2923 %^^A A small abstract
2924 %^^A =================================================================
2925 % \begin{abstract}
2926 % The \package{\filename} package provided a \LaTeXe\ document-class
2927 % together with various tools (Perl and Unix/bash scripts) for
2928 % building conference proceedings, or concatenating any set of
2929 % PDFs with a table of contents, index and bookmarks. The LaTeX2e
2930 % class derives from \LaTeXe\ scripts written for the DAFx-06
2931 % conference proceedings. It is mainly
2932 % based on the 'pdfpages' package for PDF papers including, and
2933 % the 'hyperref' package for creating proper links, bookmarks and
2934 % general bibliography back references. It also uses many other
2935 % packages for fine tuning of table of contents, bibliography and
2936 % index of authors.
2937 % Current version 0.8 is the previous 0.7 major update with key-value option
2938 % management, that has now been tested with TeXLive 2011.
2939 % The added value of this class is in the time it
2940 % saves for you to quickly design conference proceedings.
2941 % See \file{readme.txt} for a short overview and additional (legal)
2942 % information, and \file{exampleN.tex} and corresponding files and
2943 % scripts for an example of use.
2944 % \end{abstract}
2945 %
2946 % {\parskip 0pt ^^A We have to reset \parskip (bug in \LaTeX,
2947 % ^^A see doc.dtx)
2948 % \setcounter{tocdepth}{2}
2949 % \tableofcontents
2950 % }
2951 %
2952 %
2953 % \newpage
2954 %
2955 %^^A \listoftodos %^^A TO COMMENT OUT FOR FINAL DOC VERSION
2956 %
2957 %^^A =================================================================
2958 % \subsection*{I do not want to read all this!!!\newvzdseven{}}
2959 %
2960 % Yes, that's a fairly long table of contents... Let me give you some shortcuts:
2961 % \begin{itemize}
2962 % \item \margindanger{}\textbf{very busy people can directly jump to
2963 % section~\ref{sec:twomin:guide} for a first documented
2964 % example, provided they have a full \TeX{}Live installation (at least 2008)};
2965 % \item smart people can jump to the other and condensed documentation:
2966 % \newvzdseven{}\file{confproc-short.tex},\changes{0.7}{2010/08/05}{Doc: added
2967 % a summary documentation (\file{confproc-short.tex/.pdf}}
2968 % should they come back to this one for more details;
2969 % \item curious people
2970 % should rather read the not so short introduction in section~\ref{sec:usage}---it provides
2971 % some more details, such as the options and commands description---and the full example
2972 % in section~\ref{sec:example3}---which illustrates other functionalities
2973 % such as the general bibliography).
2974 % \item compulsive readers are welcome to read everything, starting from
2975 % the introduction :-). Their comments about the contents, typos, etc.~are much appreciated.
2976 % \item \TeX{} Programmers are not encouraged to read the implementation in
2977 % section~\ref{sec:implement}, as my \LaTeX{} programming skills are, let's say, still improving!
2978 % Their comments are much appreciated too.
2979 % \end{itemize}
2980 %
2981 % \vspace*{2cm}
2982 %
2983 %^^A =================================================================
2984 % \subsection*{Color code and pictograms\newvzdseven{}}
2985 %
2986 %^^A\changes{0.7}{2010/08/05}{Doc: added color code}
2987 % This documentation uses the following color code:
2988 % \begin{itemize}
2989 % \item {\color{red}red: package options; new in this version (margin notes);}
2990 % \item {\color{blue}blue: reference, URLs, internal links to sections, chapters, etc;}
2991 % \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;}
2992 % \item important things to pay attention at are noticed with this `danger' margin sign\margindanger{};
2993 % \changes{0.7}{2010/08/05}{Doc: added `what's new in version 0.7' margin notes}
2994 % \item new elements in current version are acknowledged with this margin note\newvzdseven{}.
2995 % \changes{0.7}{2010/08/05}{Doc: added `danger' margin pictogram for important things}
2996 % \end{itemize}
2997 % 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}).
2998 % \changes{0.7}{2010/08/05}{Doc code: clarified with \package{colordoc}}
2999 % \changes{0.7}{2010/08/05}{Doc code: clarified with grey/black colors (incremental learning)}
3000 %
3001 % \cleardoublepage
3002 %
3003 %^^A =================================================================
3004 %^^A Short description of what is done by the package
3005 %^^A Miscellaneous comments
3006 %^^A =================================================================
3007 % \section{Introduction}
3008 % \label{sec:intro}
3009 %
3010 % The provided \package{\filename} class is based on several great packages, among
3011 % which \package{pdfpages} \cite{Matthias:2004:pdfpages} by \person{Andreas Matthias}
3012 % (IMHO, the most useful package to build proceedings) together with \package{hyperref}
3013 % \cite{Oberdiek:2006:hyperref} by \person{Sebastian Rahtz} and \person{Heiko Oberdiek}
3014 % (to manage all PDF and hyperlinks issues). So, you may consider \package{\filename}
3015 % as a time saving package to faster design conference proceedings or a compilation of
3016 % PDFs (such as an article collection).
3017 %
3018 %
3019 %
3020 %^^A =================================================================
3021 % \subsection{Short history}
3022 %
3023 % \changes{0.4b}{2007/10/12}{Pkg: \package{nth} for superscript ordinals}
3024 %
3025 % When editing the DAFx-06 proceedings, I developed a set of \LaTeXe\ commands to
3026 % produce the best quality proceedings we could achieve thanks to \LaTeXe\. This was
3027 % documented on the DAFx-06 website \cite{Verfaille:2006:howto:web} and in a technical
3028 % report \cite{Verfaille:2006:howto:confproc}.
3029 % Later on, I created a shorter example version, that has been used as a basis by other
3030 % proceedings editors for their own needs (LAC 2007, ICAD 2007, DAFx-07, JMUI).
3031 % For better sharing of this example with other \LaTeXe\ users, I converted the set of
3032 % \LaTeXe{} commands into a document class---thanks to the information provided
3033 % by the \LaTeX{}3 team \cite{LaTeX:class:writers}---and then into a package producing
3034 % all necessary files (\ie{}~the class, the documentation, the example, the scripts, etc---using
3035 % {\sf Docstrip} \cite{mittelbach:1999:docstrip} together with the documentation by
3036 % \person{Scott Pakin}~\cite{Pakin:2004:howto:package}. Then, after using this class with
3037 % new scripts for the ICMC'09 conference proceedings, I wrapped it up into a package
3038 % (\file{.dtx} file) that generates all needed files.
3039 %
3040 %
3041 %
3042 %^^A\changes{0.2e}{2007/09/01}{Finish to re-test and document the pros/cons of other packages}
3043 %^^A =================================================================
3044 %^^A =================================================================
3045 % \subsection{Other packages or softwares}
3046 % \label{subsec:other}
3047 %
3048 % 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!
3049 % So I before finally decided to create my own package.
3050 %
3051 % 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)!
3052 %
3053 %^^A------------------------------------------------------------------------
3054 % \subsubsection{Adobe Acrobat}
3055 %
3056 % 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.
3057 %
3058 %
3059 %^^A------------------------------------------------------------------------
3060 % \subsubsection{The \package{combine} package}
3061 %
3062 % 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.
3063 %
3064 %^^A------------------------------------------------------------------------
3065 % \subsubsection{The \package{pdfpages} package}
3066 %
3067 % 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.
3068 %
3069 % 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!
3070 %
3071 %^^A------------------------------------------------------------------------
3072 % \subsubsection{The \package{mini} style}
3073 %
3074 % 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).
3075 %
3076 %^^A------------------------------------------------------------------------
3077 % \subsubsection{The AMS \package{editor} package}
3078 %
3079 % 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.
3080 %
3081 %
3082 %^^A\changes{0.2a}{2007/08/12}{Doc: added the description from the report}
3083 % \changes{0.4f}{2007/10/7}{bug: \Lopt{draft} removes papers from bookmarks}
3084 % \changes{0.5}{\datevfive}{\Lopt{draft} does not remove papers from the bookmarks anymore}
3085 %^^A =================================================================
3086 %^^A Description
3087 %^^A =================================================================
3088 % \subsection{A solution: the \package{\filename} package}
3089 %
3090 %^^A------------------------------------------------------------------------
3091 % \subsubsection{Short description}
3092 %
3093 % 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:
3094 % \begin{enumerate}
3095 % \item automatically generates the whole proceedings, after changing any of its paper information (thanks to \LaTeX!);
3096 % \item concatenates papers by inserting several individual documents into one document (with the \package{pdfpages} package);
3097 % \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);
3098 % \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.
3099 % \item left-aligned page numbers in the table of contents (using the \package{titlesec}) package;
3100 % \item displays the index of authors with two or three columns (hack derived from \package{twocolindex}, and using the \package{multicolumn} package);
3101 % \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.
3102 % \item organizes the table of contents: only the index of authors appearing in the table of contents (using the \package{tocbibind} package);
3103 % \item provides full bibliography, or at least help and informations for you to build one, with right-flushed back-reference page numbers.
3104 % \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!
3105 % \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.
3106 % \item gives information about the merging process involved to generate a general bibliography, as well as about production issues.
3107 % \item offers various \package{bash/Unix} scripts to help automatize the making of conference proceedings.
3108 % \end{enumerate}
3109 %
3110 %
3111 %^^A\changes{0.2e}{2007/09/01}{Pros and cons reorganized}
3112 %^^A =================================================================
3113 %^^A Pros and cons
3114 %^^A------------------------------------------------------------------------
3115 % \subsubsection{Pros}
3116 % \label{subsec:prosandcons}
3117 %
3118 % There are numerous advantages with the \package{\filename} class:
3119 % \begin{itemize}
3120 % \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;
3121 % \item convenient: it provides an all-in-one package (with various useful scripts);
3122 % \item time saving: directly and elegantly re-use all the tricks previously collected or developed;
3123 % \item customization: it provides several commands and options to customize your document;
3124 % \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});
3125 % \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.
3126 % \end{itemize}
3127 %
3128 % \subsubsection{Cons}
3129 % \label{subsec:cons}
3130 %
3131 % There are also disadvantages, among which:
3132 % \begin{itemize}
3133 % \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.
3134 % \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!
3135 %^^A \item not everything is transparent to the user (or look into the class code);
3136 % \item customization is a bit limited to the class designer's defined commands (which are hopefully expanding in each version);
3137 % \item does not deal with parallel session programs.
3138 % \end{itemize}
3139 %
3140 %
3141 %
3142 %^^A =================================================================
3143 %^^A------------------------------------------------------------------------
3144 % \subsubsection{Hall of fame}
3145 %
3146 % Under one of its various forms, this package has been used for (at least) the following conferences:
3147 % \begin{itemize}
3148 % \item version 0.5 (class/package):
3149 % \begin{itemize}
3150 % \item August 2009: Proceedings of the International Computer Music Conference (ICMC 2009) --- Montreal, Qc, Canada;
3151 % used by \person{Gary Scavone} and myself;
3152 % \href{http://www.icmc2009.org/}{\sf www.icmc2009.org/}
3153 % \end{itemize}
3154 % \item version 0.4e (class/package):
3155 % \begin{itemize}
3156 % \item September 2010: Proceedings of the 5\textsuperscript{th} Robotour Workshop --- Bratislava, Slovakia; used by \person{Richard Balogh};
3157 % \href{http://www.robotika.sk/robotour/zbornik/Robotour2010.pdf}{http://www.robotika.sk/robotour/zbornik/Robotour2010.pdf}
3158 % \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;
3159 % 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};
3160 % \begin{itemize}
3161 % \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}
3162 % \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}
3163 % \end{itemize}
3164 % \item June 2010: Proceedings of the 11\textsuperscript{th} UC Systemwide 2010 Bioengineering Symposium University of California --- Davis; California, USA; used by \person{Angelique Louie};\\
3165 % \href{http://www.be.ucsd.edu/bicsymposium/program}{http://www.be.ucsd.edu/bicsymposium/program}
3166 % \item March 2010: Proceedings of the Workshop on Inverse Problems for Waves --- Palaiseau, France;
3167 % used by \person{Armin Lechleiter};\\
3168 % \href{http://www.cmap.polytechnique.fr/~defi/mmsn2010/MMSN-2010.pdf}{\sf www.cmap.polytechnique.fr/$\sim$defi/mmsn2010/MMSN-2010.pdf}
3169 % \item September 2009: Pre-Proceedings of the UC09 Hypercomputation Workshop --- Ponta Delgada, The Azores, Portugal;
3170 % used by \person{Mike Stannett};\\
3171 % \href{http://hypercomputation.net/uc09/preproc.pdf}{\sf hypercomputation.net/uc09/preproc.pdf}
3172 % \item August 2009: Book of abstracts of the 16th European Young Statisticians Meeting (EYSM 2009) --- Bucharest, Romania;
3173 % used by \person{Luiza B\u{a}din} and \person{Roxana Ciumara};\\
3174 % \href{http://www.eysm2009.ase.ro/}{\sf www.eysm2009.ase.ro/}
3175 % \item June 2009: Nanophotonics Down Under 2009: Devices and Applications (SMONP: Sir Mark Oliphant Conference on NanoPhotonics) --- Melbourne, Australia;
3176 % used by \person{Michael James Ventura};
3177 % \href{http://www.smonp2009.com/}{\sf www.smonp2009.com/}
3178 % \end{itemize}
3179 % \item version 0.4f (scripts):
3180 % \begin{itemize}
3181 % \item 2008 and 2009: Numediart's Quartely Progress Scientific Report (QPSR);
3182 % used by \person{Christian Frisson};
3183 % \begin{itemize}
3184 % \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}
3185 % \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}
3186 % \item Vol. 2(2), June 2009: \href{http://www.numediart.org/docs/numediart_2009_s06_qpsr.pdf}{\sf www.numediart.org/docs/numediart\_2009\_s06\_qpsr.pdf}
3187 % \item Vol. 2(1), March 2009: \href{http:www.numediart.org/docs/numediart_2009_s05_qpsr.pdf}{\sf www.numediart.org/docs/numediart\_2009\_s05\_qpsr.pdf}
3188 % \item Vol. 1(4), Dec. 2008: \href{http://www.numediart.org/docs/numediart_2008_s04_qpsr.pdf}{\sf www.numediart.org/docs/numediart\_2008\_s04\_qpsr.pdf}
3189 % \item Vol. 1(3), Sept. 2008: \href{http://www.numediart.org/docs/numediart_2008_s03_qpsr.pdf}{\sf www.numediart.org/docs/numediart\_2008\_s03\_qpsr.pdf}
3190 % \end{itemize}
3191 % \item July 16 - August 10, 2007: Proceedings of the eNTERFACE'07 Workshop on Multimodal Interfaces --- Istanbul, Turkey;
3192 % used by \person{Christian Frisson} and \person{R\'emy Lehembre};\\
3193 % \href{http://www.cmpe.boun.edu.tr/enterface07/results.php}{http://www.cmpe.boun.edu.tr/enterface07/results.php}
3194 % \end{itemize}
3195 % \item version 0.2e (scripts):
3196 % \begin{itemize}
3197 % \item 2008: Numediart's Quartely Progress Scientific Report (QPSR);
3198 % used by \person{Christian Frisson};
3199 % \begin{itemize}
3200 % \item Vol. 1(2), June 2008: \href{http://www.numediart.org/docs/numediart_2008_s02_qpsr.pdf}{\sf www.numediart.org/docs/numediart\_2008\_s02\_qpsr.pdf}
3201 % \item Vol. 1(1), March 2008: \href{http://www.numediart.org/docs/numediart_2008_s01_qpsr.pdf}{\sf www.numediart.org/docs/numediart\_2008\_s01\_qpsr.pdf}
3202 % \end{itemize}
3203 % \item September 2007: \nth{10} International Conference on Digital Audio Effects (DAFx-07) in Bordeaux, France;
3204 % used by \person{Sylvain Marchand};
3205 % \href{http://dafx.labri.fr/}{\sf dafx.labri.fr/}
3206 % \item 2007: Journal on Multimodal User Interfaces (JMUI) Vol. 1(1) and 1(2);
3207 % used by \person{Christian Frisson};
3208 % \href{http://www.jmui.org/index.php/JMUI/issue/view/1/showToc}{\sf www.jmui.org/index.php/JMUI/issue/view/1/showToc}
3209 % \item June 2007: \nth{13} International Conference on Auditory Display (ICAD-07) --- Montreal, Qc, Canada;
3210 % used by \person{Gary Scavone};
3211 % \href{http://www.music.mcgill.ca/icad2007/proceedings.php}{\sf www.music.mcgill.ca/icad2007/proceedings.php}
3212 % \end{itemize}
3213 % \item version 0.1 (scripts):
3214 % \begin{itemize}
3215 % \item March 2007: \nth{5} International Linux Audio Conference (LAC2007) --- Berlin, Germany;
3216 % used by \person{Marije Baalman};
3217 % \href{http://www.kgw.tu-berlin.de/~lac2007/proceedings.shtml}{\sf www.kgw.tu-berlin.de/$\sim$lac2007/proceedings.shtml}
3218 % \item September 2006: \nth{9} International Conference on Digital Audio Effects (DAFx-06) --- Montreal, Qc, Canada; used by myself;
3219 % \href{http://www.dafx.ca/dafx06_proceedings.html}{\sf www.dafx.ca/dafx06\_proceedings.html}
3220 % \end{itemize}
3221 % \end{itemize}
3222 %
3223 %
3224 %^^A =================================================================
3225 %^^A Version history
3226 %^^A =================================================================
3227 % \subsection{Version history}\label{subsec:version:history}\label{subsec:new}
3228 %
3229 % Here is a list of versions (red versions are public releases):
3230 % \begin{description}
3231 % \item[{v0.8}] last version\newvzdeight{} is a minor revision, that:
3232 % \begin{itemize}
3233 % \item version 0.8 has been tested for \TeX{}Live 2011\newvzdeight{} (as of August 1st, 2011);
3234 %\changes{0.8}{2011/08/01}{tested with TeXLive 2011 on August 1st, 2011}
3235 % \item corrects the author's email address;
3236 % \item adds other conference proceedings to the hall of fames.
3237 % \end{itemize}
3238 % \item[{\color{red} v0.7}] major revision\newvzdseven{}. 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):
3239 % \begin{itemize}
3240 % \item class design:
3241 % \begin{itemize}
3242 % \item class options: interface re-designed, now uses key-values style (with \package{kvoptions} package);
3243 % \item tested with \TeX{}Live 2008, 2009, and 2010 (as of July 2010);
3244 % \item code clarified, using key-values (with the \package{keyval} package) but also \cmd{\ifthenelse} (from the \package{xifthen} package);
3245 % \end{itemize}
3246 % \item PDF insertion:
3247 % \begin{itemize}
3248 % \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});
3249 % \item removed the limitation to a minimum of 2 pages and a maximum of 8 pages (now 1 to anything);
3250 % \end{itemize}
3251 % \item class options:
3252 % \begin{itemize}
3253 % \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;
3254 % \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);
3255 % \item added new options for layout fine tuning and debug:
3256 % \begin{itemize}
3257 % \item \DescribeMacro{binding}\Lopt{binding=Xmm} to indicate the binding of the paperback version;
3258 % \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;
3259 % \item \LoptDescribe{showmarginlines} to draw the margin lines (so that one can match each page fits the template);
3260 % \item \LoptDescribe{showpapernumber} to show the paper number below the page number;
3261 % \item \DescribeMacro{colorheaders}\Lopt{colorheaders=red} to color the header/footer;
3262 % \item \LoptDescribe{pdftk} to output commands for later setting PDF metadata of individual PDFs;
3263 % \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}.
3264 % \end{itemize}
3265 % \item options' default values: reset to simplify the most possible the first tests;
3266 % \end{itemize}
3267 % \item documentation:
3268 % \begin{itemize}
3269 % \item added a 2-minutes documentation (\file{confproc-short.tex}) that summarizes commands and options;
3270 % \item added a second (and simpler) example;
3271 % \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);
3272 % \end{itemize}
3273 % \item scripts: added some \file{bach/Unix} scripts for more functionalities, such as:
3274 % \begin{itemize}
3275 % \item \file{buildprocelpb.sh}: for optimized example (generates both paperback and electronic versions of proceedings).
3276 % \item \file{prepareexample.sh}: prepare example files and scripts.
3277 % \item \file{exportIndividualPDFs.sh}: extracts individual paper with new page numbers and proper metadata;
3278 % \item \file{countnbpages.sh}: counts number of pages in each individual PDF paper.
3279 % \end{itemize}
3280 % \end{itemize}
3281 % \item[v0.6] undistributed: integrated and enhanced changes made for ICMC 2009;
3282 % \item[v0.5] undistributed: hacked version with \package{kvoptions} plus many fixes for ICMC 2009;
3283 % \item[{\color{red} v0.4e}]
3284 % \begin{itemize}
3285 % \item enhance package by redefining book commands;
3286 % \item fixed several issues;
3287 % \item define page layout with the \package{geometry} package (thanks to \person{Will Robertson});
3288 % \end{itemize}
3289 % \item[v0.4d] changes history: re-organized using \file{macro} environment (shorter and clearer);
3290 % \item[v0.4c] bug correction: author is back in the bookmark (disappeared in v0.4a);
3291 % \item[v0.4b]
3292 % \begin{itemize}
3293 % \item debug: \cmd{\hypersetup} evaluated only at the document beginning (then taking into account the user changes in the PDF metadata);
3294 % \item remove formatting from footer and name-like commands: author, title, etc. (suggested by \person{Will Robertson});
3295 % \item use \package{mathptmx} package instead of \package{times} package (thanks to \person{Will Robertson});
3296 % \item use \package{nth} package instead of \cmd{\textsuperscript} command (thanks to \person{Will Robertson});
3297 % \item redefine \cmd{\thebibliography} to avoid inserting a phantom item to set the introductory paragraph (thanks to \person{Will Robertson});
3298 % \end{itemize}
3299 % \item[{\color{red} v0.4a}]
3300 % \begin{itemize}
3301 % \item allows to insert 1-page long papers (did not work in v0.3 and previous);
3302 % \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;
3303 % \item incorporate font style changes to the class: redefining the \cmd{\mainmatter}, \cmd{\backmatter}, \cmd{\thebibliography}, \cmd{\thecontents} commands (thanks to \person{Will Robertson});
3304 % \end{itemize}
3305 % \item[{\color{red} v0.3}] first released version of the package.
3306 % \item[v0.2e] first distributed version of the scripts.
3307 % \item[v0.1] first version of the scripts (DAFx-06).
3308 % \end{description}
3309 %
3310 %
3311 %^^A\changes{0.1c}{2007/07/30}{Todo: created}
3312 %^^A =================================================================
3313 %^^A What have to be done?
3314 %^^A =================================================================
3315 % \subsection{To do / bugs}
3316 % \label{subsec:todo}
3317 %
3318 % At this time this package offers many more features than the original
3319 % scripts did. It looks `complete' to me, and fully functional as is.
3320 % I however would like to debug/add the following functionalities:
3321 % \begin{itemize}
3322 % \item backward incompatibility: citation items lost if using old
3323 % command \verb+\procinsertpaper+ (up to version 0.5)
3324 % \item bibliography: fix the right-flush issue that sometimes happen
3325 % for a small number of back-references in the bibliography,
3326 % where 1 or 2 or a longer list of back-referrences are placed onto
3327 % a next line whereas there is enough space on the previous line.
3328 % \item index/bibliography: correct the pdf link. Clicking on that
3329 % link should go to the top of the page of the index/bibliography,
3330 % and not to a position just below the \cmd{\indexname} in the text.
3331 % \item bookmarks/TOC: find a mechanism to customize the table of
3332 % contents bookmark entry by setting the argument of
3333 % \verb+\pdfbookmark[0]{Program}{contents}+ (does not work yet
3334 % because \cmd{\pdfbookmark} does not accept commands as arguments).
3335 %^^A \item[$\surd$] (since v0.5) use the \package{keyval} package to properly manage options like \verb+<option>=<value>+;
3336 % \item packages: provide a mechanism for inserting packages
3337 % \emph{before/after} the \package{hyperref} package, directly from
3338 % the example file without having to hack the class (including the
3339 % \package{hyperref} package with \cmd{\AtBeginDocument} did not work).
3340 %^^A Try again with \cmd{\PassOptionToPackage[]{}} for packages that are already loaded....
3341 %^^A \item debug \cmd{\clearsinglepage} and \cmd{\cleardoublepage}
3342 % \item TOC: handle programs with parallel sessions (table of contents);
3343 % \item use a makefile instead of buildproc.sh, buildprocelpb.sh
3344 % (that would looks a bit more professionnal);
3345 % \item generate \file{confproc-short.tex} from \file{confproc.dtx};
3346 % \item write a shorter version of \file{confproc.dtx} that does not loose any information,
3347 % but rather looses useless redundancies and gains in ease of readinf or finding
3348 % specific information;
3349 % \item miscellaneous: fix bugs, misspellings, etc. (never ending task).
3350 % \end{itemize}
3351 % N.B.: none of those functionalities/improvements is written on my agenda...
3352 %
3353 %
3354 %^^A\changes{0.1d}{2007/07/31}{Thanks: to be changed}
3355 %^^A =================================================================
3356 %^^A Thanks
3357 %^^A =================================================================
3358 % \subsection{Thanks}
3359 % \label{subsec:thanks}
3360 %
3361 % Big thanks go to various people: \person{Gary Scavone} for offering me
3362 % to edit the ICMC 2009 proceedings; \person{Andreas Matthias} for suggesting
3363 % in 2008 to simplify the options using \package{keyval} (yes, I'm quite slow);
3364 % \person{Philippe Depalle} for offering me to edit the DAFx-06 proceedings;
3365 % \person{Julien Boissinot} for asking ``Why don't you make it a class?'' in 2006;
3366 % \person{Eoin Brazil} for being so enthusiastic about the package;
3367 % \person{Will Robertson} for suggesting many improvements (v0.4a--e) while writing
3368 % a Prac\TeX{} description of the package \cite{Verfaille:2007:PracTeX:confproc};
3369 % and the courageous guinea-pigs of the first versions (\person{Michael James Ventura},
3370 % \person{Gary Scavone}, \person{Sylvain Marchand}, \person{Marije Baalman},
3371 % \person{Christian Kl\"under} and \person{Christian Frisson}).
3372 % I also thank \person{Andre Dierker} for his example \file{fbithesis.dtx}\footnote{\file{fbithesis.dtx}:
3373 % \ctan \href{http://www.ctan.org/tex-archive/macros/latex/contrib/fbithesis/}{macros/latex/contrib/fbithesis/}}
3374 % that I used as a start to build this \file{\filename.dtx} package/documentation file;
3375 % his example helped me so much to learn all this dtx stuff.
3376 %
3377 %
3378 %^^A\changes{0.1c}{2007/07/30}{Installation: new}
3379 %^^A\changes{0.2e}{2007/09/01}{Installation: updated section, with subsubsections and Unix script for lazy people}
3380 %^^A =================================================================
3381 %^^A Installation guide
3382 %^^A =================================================================
3383 % \newpage
3384 % \section{Installation}
3385 % \label{subsec:install}
3386 %
3387 %
3388 %^^A =================================================================
3389 % \subsection{Steps summary}
3390 %
3391 % \begin{enumerate}
3392 % \item check that you have all required packages (see sec.~\ref{subsec:need}).
3393 % Using any \TeX{}Live distribution ensures nothing else has to be installed!
3394 % \item generate the documentation: `\file{latex \filename.dtx}';
3395 % \item generate the \file{\filename.cls} file: `\file{latex \filename.ins}';
3396 % \item finish the documentation: `\file{latex \filename.dtx}' (two times). \\
3397 % N.B.: the \file{buildcls.sh} script implements step 2--4 ($+$ generates
3398 % index and bibliography).
3399 % \item option: move \file{\filename.cls}, \file{\filename.pdf} and
3400 % \file{exampleN.tex} and all the other example-related generated files into
3401 % another folder (\ie{} \file{examples/}).\\ N.B.: the \file{prepareexample.sh}
3402 % bash/Unix script prepares example files for you
3403 % (see sec. \ref{sec:script:prepareexample}).
3404 % \end{enumerate}
3405 % Installation steps are explained with more details in sec.~\ref{sec:install:steps}.
3406 %
3407 %^^A\changes{0.1c}{2007/07/30}{Doc: changing installation steps}
3408 %^^A\changes{0.2e}{2007/09/01}{Layouts: moved to the example}
3409 %^^A\changes{0.2e}{2007/09/01}{Required packages documented}
3410 %^^A =================================================================
3411 %^^A What is required?
3412 %^^A What is recommended?
3413 %^^A What is supported?
3414 %^^A =================================================================
3415 % \subsection{Packages and compiler}
3416 % \label{subsec:need}
3417 %
3418 % Some packages are required for \package{\filename} to work.
3419 % If using a full \TeX\ distribution such as \TeX{}Live 2008--2010, all necessary
3420 % packages (including \package{\filename}, which installation process is described
3421 % in the next section) are already installed on your system. Otherwise, you'll find
3422 % the most recent versions at \ctan\footnote{Comprehensive \TeX{} Archive Network:
3423 % \href{http://www.ctan.org/}{\sf www.ctan.org/}}, at the address provided below for
3424 % each package with its version number that corresponds to the \TeXLive{} 2008
3425 % distribution. Note that \package{\filename} has also been successfully tested
3426 % with \TeXLive{} 2009 as of Sept 14, 2009, and pre\TeXLive{} 2010 in July 2010.
3427 %
3428 %^^A =================================================================
3429 % \subsubsection{Essential packages required by \package{\filename}}
3430 %
3431 % \begin{enumerate}
3432 % \item \LaTeXe\ (at least 1994/12/01) and pdfTeXk Version 3.1415926-1.40.9 (Web2C 7.5.7);\\
3433 % \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/base}{macros/latex/base}
3434 %^^A \package{\filename} is a \LaTeXe\ document-class.
3435 % \item \package{book}
3436 % (at least 2005/09/16 v1.4f): standard document class on which \package{\filename} is based;\\
3437 % \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/unpacked/}{macros/latex/unpacked/}
3438 % \item \package{kvoptions} and \package{kvoptions-patch}
3439 % (at least 2009/04/10 v3.1): key-value class options management;
3440 % \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/contrib/oberdiek/kvoptions.dtx}{macros/latex/contrib/oberdiek/kvoptions.dtx}
3441 % \item \package{xifthen}
3442 % (at least 2009/04/17 v1.3): clearer code for if/then tests;\\
3443 % \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/contrib/xifthen/}{macros/latex/contrib/xifthen/}
3444 % \item \package{pdfpages}
3445 % (at least 2009/02/07 v0.4g): to include the proceedings articles as PDF documents;\\
3446 % \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/contrib/pdfpages/pdfpages.dtx}{macros/latex/contrib/pdfpages/pdfpages.dtx}
3447 % \item \package{hyperref} \cite{Oberdiek:2006:hyperref}
3448 % (at least 2009/05/01 v6.78r): to add hypertext links in the PDF file;\\
3449 % \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/contrib/hyperref/hyperref.dtx}{macros/latex/contrib/hyperref/hyperref.dtx}
3450 % \item \package{geometry}
3451 % (at least 2008/12/21 v4.2): to simplify the page layout settings;\\
3452 % \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/contrib/geometry/geometry.dtx}{macros/latex/contrib/geometry/geometry.dtx}
3453 % \item \package{color}
3454 % (at least 2005/11/14 v1.0j): to provide color links with \package{hyperref};\\
3455 % \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/required/graphics/color.dtx}{macros/latex/required/graphics/color.dtx}
3456 % \item \package{fancyhdr}
3457 % (at least 2005/03/22 v3.2): to set the proceedings header/footer so as to match the paper template style, if any;
3458 % \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/contrib/fancyhdr/fancyhdr.sty}{macros/latex/contrib/fancyhdr/fancyhdr.sty}
3459 % \item \package{index}
3460 % (at least 2004/01/20 v4.2beta): to produce the index of authors;\\
3461 % \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/contrib/index/index.dtx}{macros/latex/contrib/index/index.dtx}
3462 % \item \package{tocbibind}
3463 % (at least 2003/03/13 v1.5g): to change the \cmd{\indexname} command and disable automatic insertion of index in the table of contents;\\
3464 % \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/contrib/tocbibind/tocbibind.dtx}{macros/latex/contrib/tocbibind/tocbibind.dtx}
3465 % \item \package{titletoc}
3466 % (at least 2007/08/12 v1.6): to change the table of contents layout\\
3467 % \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/contrib/titlesec/titletoc.sty}{macros/latex/contrib/titlesec/titletoc.sty}
3468 % \item \package{multitoc}
3469 % (at least 1999/06/08 v2.01): to provide a two column table of contents\\
3470 % \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/contrib/ms/multitoc.dtx}{macros/latex/contrib/ms/multitoc.dtx}
3471 % \item \package{multicol}
3472 % (at least 2006/05/18 v1.6g): to provide multi-column index of authors\\
3473 % \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/required/tools/multicol.dtx}{macros/latex/required/tools/multicol.dtx}
3474 % \item \package{sectsty}
3475 % (at least 2002/02/25 v2.0.2): \cmd{\chapterfont} used to give the same headers/footers to the table of contents;
3476 % \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/contrib/sectsty/sectsty.dtx}{macros/latex/contrib/sectsty/sectsty.dtx}
3477 % \end{enumerate}
3478 %
3479 %^^A =================================================================
3480 % \subsubsection{Other packages successfully used with \package{\filename} in the examples}
3481 %
3482 % \begin{enumerate}
3483 % \item \package{hypcap}
3484 % (at least 2006/02/20 v1.5):
3485 % for proper hyperref anchors to table and figure captions;\\
3486 % \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/contrib/oberdiek/hypcap.dtx}{macros/latex/contrib/oberdiek/hypcap.dtx}
3487 % \item \package{graphicx}
3488 % (at least 1996/08/05 v1.0a):
3489 % to include logos with \cmd{\includegraphics};\\
3490 % \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/required/graphics/graphicx.dtx}{macros/latex/required/graphics/graphicx.dtx}
3491 % \item \package{newapa}
3492 % (at least 1991/06/13 v2.0):
3493 % for the general bibliography\\
3494 % (N.B.: it is slightly modified after insertion);\\
3495 % \ctan: \href{http://www.ctan.org/tex-archive/biblio/bibtex/contrib/newapa/}{biblio/bibtex/contrib/newapa/}\
3496 % \item \package{newapave}
3497 % (at least 2006/07/31 v2.1),
3498 % included in the \package{\filename} package:
3499 % DAFx-06 style for the general bibliography (year at the end, before the right-flushed back-references);\\
3500 % \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/contrib/conferences/confproc/}{macros/latex/contrib/conferences/confproc/}
3501 % \item \package{setspace}
3502 % (at least 2000/12/01 v6.7):
3503 % to change the line spacing of welcome letters;\\
3504 % \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/contrib/setspace/setspace.sty}{macros/latex/contrib/setspace/setspace.sty}
3505 % \item \package{inputenc}
3506 % (at least 2006/05/05 v1.1b):
3507 % to change the input encoding, for instance to run \LaTeX{} on a document with accents (for the authors' names and the paper titles);\\
3508 % \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/base/inputenc.dtx}{macros/latex/base/inputenc.dtx}
3509 % \item \package{fontenc}
3510 % (at least 2005/09/27 v1.99g):
3511 % to change the font encoding;\\
3512 % \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/unpacked/fontenc.sty}{macros/latex/unpacked/fontenc.sty}
3513 % \changes{0.4b}{2007/10/12}{Pkg: \package{mathptmx} replaces \package{times}}
3514 % \item \package{mathptmx}
3515 % (at least 2005/04/12 PSNFSS-v9.2a):
3516 % to change the default \LaTeX{} font to `Times' for a better PDF display;
3517 % \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/required/psnfss/}{macros/latex/required/psnfss/}
3518 % \changes{0.4b}{2007/10/12}{Pkg: \package{nth} for superscript ordinals}
3519 % \item \package{nth}
3520 % (at least 2002/02/27):
3521 % to use superscript ordinals in the proceedings name (\nth{9});\\
3522 % \ctan: \href{http://www.ctan.org/tex-archive/macros/generic/misc/nth.sty}{macros/generic/misc/nth.sty}
3523 %^^A \item \package{amsmath}
3524 %^^A (at least 2000/07/18 v2.13);\\
3525 %^^A \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/required/amslatex/math/amsmath.dtx}{macros/latex/required/amslatex/math/amsmath.dtx}\\
3526 %^^A For AMS math, as you may have some math displayed even in the preamble or postamble of the proceedings.
3527 %^^A \item \package{amssymb}
3528 %^^A (at least 2002/01/22 v2.2d)\\
3529 %^^A \ctan: \href{http://www.ctan.org/tex-archive/fonts/amsfonts/doc/latex/amssymb.dtx}{fonts/amsfonts/doc/latex/amssymb.dtx}\\
3530 %^^A For AMS symbols (same reason).
3531 % \item \package{layout}
3532 % (at least 2000/09/25 v1.2c):
3533 % to finely tune you document header and footer so that they match
3534 % those of the paper templates;
3535 % \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/required/tools/layout.dtx}{macros/latex/required/tools/layout.dtx}
3536 % \item \package{layouts}
3537 % (at least 2004/10/25 v2.6c):
3538 % to check the fine tuning of the table of contents layout\\
3539 % (N.B.: if inserted too early, the table of contents layout
3540 % will not properly display);\\
3541 % \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/contrib/layouts/layouts.dtx}{macros/latex/contrib/layouts/layouts.dtx}
3542 % \end{enumerate}
3543 %
3544 %
3545 %
3546 %^^A =================================================================
3547 % \subsection{Installation steps}\label{sec:install:steps}
3548 %
3549 % Download this package at \ctan:
3550 % \href{http://www.ctan.org/tex-archive/macros/latex/contrib/conferences/confproc/}{macros/latex/contrib/conferences/confproc/}.
3551 % It should already contain the following files:
3552 % \begin{itemize}
3553 % \item package-related files:
3554 % \begin{itemize}
3555 % \item \file{\filename.dtx}: main package file (the first
3556 % \LaTeX{} run \texttt{pdflatex \filename.dtx} generates
3557 % various other files)
3558 % \item \file{readme.txt}: package introduction file;
3559 % \item \file{buildcls.sh}: bash/Unix script to generate the
3560 % class files and documentation (\LaTeX{} run:
3561 % \texttt{pdflatex \filename.dtx});
3562 % \item \file{\filename.ins}: package file generated from the
3563 % first \LaTeX{} run, used to generate example files, index
3564 % styles, etc (\LaTeX{} run: \texttt{pdflatex \filename.dtx});
3565 % \item \file{\filename.cls}: package class generated from
3566 % the first \LaTeX{} run, used by all example files;
3567 % \item \file{newapave.bst}: bibliography style for \filename;
3568 % \item \file{newapave.sty}: bibliography style for \filename;
3569 % generated under the \file{newapave2.sty} name and renamed
3570 % by the \file{buildcls.sh} script.
3571 % \item \file{\filename{}1.ist} and \file{\filename{}2.ist}:
3572 % examples of index style files;
3573 % \end{itemize}
3574 % \item package documentation:
3575 % \begin{itemize}
3576 % \item \file{\filename.pdf}: full documentation (this file);
3577 % use the \file{makedoc.sh} bash script to regenerate it with
3578 % proper index, version history, bibliography;
3579 % \item \file{\filename-short.pdf}: summary documentation;
3580 % \item \file{\filename-short.tex}: summary documentation
3581 % (original \LaTeX{} file);
3582 % \item \file{confproc\_diag.pdf}: figure used in the
3583 % documentations, which illustrates proceedings building
3584 % and compilation steps;
3585 % \item \file{makedoc.sh}: bash/Unix script to generate the
3586 % package full documentation;
3587 % \end{itemize}
3588 % \item package example:
3589 % \begin{itemize}
3590 % \item \file{papers/}: folder with example files (papers);
3591 % \item \file{pictures/}: folder with an example of proceedings cover.
3592 % \end{itemize}
3593 % \end{itemize}
3594 %
3595 % The provided \package{\filename.dtx} file is an `one-file-contains-it-all':
3596 % it contains the \file{.cls} class file, its \file{.pdf} documentation,
3597 % a customizable driver for the documentation,
3598 % the \file{.ins} batch file, a complete example, and a `read me' file.
3599 %
3600 % To install the package:
3601 % \begin{enumerate}
3602 % \item run \file{\filename.dtx} through \LaTeX. This will generate
3603 % the batch file \file{\filename.ins} (only if it does not already
3604 % exists: if willing to re-generate it, first delete the one that
3605 % pre-exists) and a \file{readme.txt}. Additionally the documentation
3606 % (\file{\filename.pdf}) is generated (to get the cross-references
3607 % right, you have to rerun this twice, however).
3608 % \item run the newly generated \file{\filename.ins} through \LaTeX{}
3609 % to do the actual installation. This will (re)generate the
3610 % \file{\filename.cls}~class file, the example files\footnote{Example
3611 % files: \file{example1empty.tex}, \file{example2custom.tex},
3612 % \file{example3optim.tex}, \file{example4optim.tex}} and example-related
3613 % files\footnote{Example-related files: \file{exclasspre.tex},
3614 % \file{exclasslastel.tex}, \file{exclasslastpb.tex}, \file{expages.tex},
3615 % \file{exsessions.tex}, \file{expapersswitch.tex}, \file{exbiblio.bib}
3616 % and \file{exprogram.csv}}, build scripts\footnote{Class and proceedings
3617 % build scripts in Perl: \file{generateswitch.pl}; Unix: \file{buildcls.sh},
3618 % \file{cleancls.sh}, \file{buildproc.sh}, \file{buildprocelpb.sh},
3619 % \file{buildpapers.sh}, \file{buildcppdfpapers.sh}, \file{countnbpages.sh},
3620 % \file{exportIndividualPDFs.sh}, \file{papersinfo.sh},
3621 % \file{paperssplitpreamble.sh}, \file{prepareexample.sh},
3622 % \file{removeLaTeXcmds.sh}}, the documentation driver (\file{\filename.drv})
3623 % and a sample configuration file (\file{\filename.cfg}).
3624 %^^A Normally, if you set \cmd{\BaseDirectory}\footnote{see the documentation of the \file{docstrip}~program: \cite{mittelbach:1999:docstrip}} in your \file{docstrip.cfg}, the document-class \file{\filename.cls} is immediately moved to an appropriate location (e.g.\ `\file{\$(TEXMF)/tex/latex/misc/}' with a \tds\footnote{\TeX\ Directory Structure, see \cite{twgtds:1999:tds}} compliant \LaTeX\ installation). Otherwise you have to move it yourself into a directory searched by \LaTeX.\\
3625 %^^A Normally (with a \tds\ installation) all configuration
3626 %^^A (\file{.cfg}) files are collected in
3627 %^^A `\file{\$(TEXMF)/tex/latex/config/}'. Since there may be already
3628 %^^A an older `\file{\filename.cfg}' that perhaps mustn't be
3629 %^^A overwritten, you have to move (and merge) the file yourself.
3630 %
3631 % \item to finish the installation it is recommended to move the
3632 % documentation (\file{\filename.pdf} and \file{\filename-short.pdf})
3633 % and the example-related files to where you collect the documentations.
3634 % With a \tds\ compliant \LaTeX\ installation this would for example
3635 % be:\\ \texttt{\file{\$(TEXMF)/doc/tex/latex/\filename}}
3636 %
3637 % \item to use the examples:
3638 % \begin{itemize}
3639 % \item move all \file{ex*.*} files together with the example
3640 % scripts\footnote{Perl: \file{generateswitch.pl}; Unix:
3641 % \file{buildproc.sh}, \file{buildprocelpb.sh}, \file{buildpapers.sh},
3642 % \file{buildcppdfpapers.sh}, \file{countnbpages.sh},
3643 % \file{exportIndividualPDFs.sh}, \file{papersinfo.sh},
3644 % \file{paperssplitpreamble.sh}, \file{prepareexample.sh},
3645 % \file{removeLaTeXcmds.sh}} and the \file{papers/} and
3646 % \file{picture/} folders to the \file{example/} folder
3647 % (thus hiding all the mess in the same place ;-));
3648 % \item place in \file{example/} a copy of the following class
3649 % files: \file{\filename.cls}, \file{\filename{}1.ist},
3650 % \file{\filename{}2.ist}, \file{newapave.bst}, \file{newapave.sty};
3651 % \item create a \file{pdftk\_info/} folder there, and move the
3652 % \file{expages.tex} file into \file{papers/};
3653 % \item change the permissions to `execute' (\texttt{chmod +x ...})
3654 % for example scripts\footnote{Example scripts: \file{buildproc.sh},
3655 % \file{buildprocelpb.sh}, \file{generateswitch.pl},
3656 % \file{exportIndividualPDFs.sh}, \file{papersinfo.sh},
3657 % \file{paperssplitpreamble.sh}}.
3658 % \end{itemize}
3659 % N.B.: the \file{prepareexample.sh} bash/Unix script (see sec.
3660 % \ref{sec:script:prepareexample}) does it all for you.
3661 % \item for a demonstration of the possibilities of \package{\filename}
3662 % see the \file{example*.tex} file and run them through \LaTeX.
3663 % For a more complete demonstration, use the \file{buildproc.sh}
3664 % (see sec.~\ref{sec:scripts:buildproc}) and \file{buildprocelpb.sh}
3665 % (see sec.~\ref{sec:scripts:buildprocelpb}) and bash/Unix scripts,
3666 % that will make for you all the necessary steps to provide the final
3667 % version of the example proceedings.
3668 % \end{enumerate}
3669 %
3670 % The `\file{latex \filename.dtx}'-run above will by default generate
3671 % the full documentation (with complete listing of the documented source
3672 % code, command index and change history). If you need the `user' documentation,
3673 % you may edit \file{\filename.drv} to meet your needs (never edit
3674 % \file{\filename.dtx} itself!). For more information on the enhanced
3675 % documentation see \file{\filename.drv} or \file{readme.txt}.
3676 %
3677 %
3678 %
3679 %
3680 %^^A =================================================================
3681 %^^A 2-min guide
3682 %^^A =================================================================
3683 % \newpage
3684 % \section[Example 1 (\file{example1empty.tex}): A short introduction to
3685 % \package{\filename}]{Example 1 (\file{example1empty.tex})\\ A short introduction to
3686 % \package{\filename} (2 minutes)}
3687 % \label{sec:twomin:guide}
3688 %
3689 % For people that are very excited about this package, here is a 2-minute guide, that gives
3690 % a quick feeling of \emph{what can be done with \package{confproc}}.
3691 % Next two sections provide a detailed description of
3692 % the package (sec.~\ref{sec:usage}) as well as a full working example with index,
3693 % general bibliography, etc. (sec.~\ref{sec:example3}).
3694 % A good advice that could be given is ``Do as you would do for a book'': table of contents,
3695 % headers and footers, index, etc.
3696 %
3697 %^^A =================================================================
3698 %^^A Loading
3699 %^^A =================================================================
3700 % \subsection{Preamble}
3701 %
3702 % Consider we are writing a book with several parts (days) and chapter (sessions).
3703 % Then, we want to set its title, author, a table of contents (or list of days/parts,
3704 % sessions/chapters and papers/sections), as well as an index. Then, using the same
3705 % usual commands, the proceedings will use the code provided below.
3706 %
3707 %^^A------------------------------------------------------------------------
3708 % \subsubsection{Document class and options}
3709 %
3710 % We first insert the document class with reasonable options (that we will not look at right now):
3711 %\changes{0.6}{\datevzdsix}{Example: renamed \file{example.tex} into \file{example1empty.tex}}
3712 %\changes{0.6}{\datevzdsix}{Example: red color is the default for customization of proceedings example (\file{example1empty.tex})}
3713 %
3714 % \begin{macrocode}
3715 %<*example1empty>
3716 \documentclass[letterpaper,10pt,twoside,%
3717 electronic,% [printed] | electronic
3718 papers=countpages,% empty | draft | [final] | countpages
3719 paperselec=all, %[all] | p_001 | p_fake
3720 hyperref={bookmarksdepth=1,bookmarksopen,bookmarksopenlevel=0,%
3721 linkcolor=blue,urlcolor=blue},%
3722 geometry={text={175truemm,226truemm},% A4 & letter
3723 inner=0.805in,top=29.15mm,bottom=24.5mm,footskip=9.68mm,voffset=-5mm},%letter
3724 ]{confproc}
3725 % \end{macrocode}
3726 %
3727 %^^A =================================================================
3728 %^^A Loading
3729 %^^A------------------------------------------------------------------------
3730 % \subsubsection{Packages}
3731 %
3732 % We then insert packages for input and output font encoding, Times font selection and miscellaneous:
3733 % \begin{macrocode}
3734 \usepackage[utf8]{inputenc}
3735 \usepackage[T1]{fontenc}
3736 \usepackage{mathptmx}
3737 \usepackage[super]{nth}
3738
3739 % \end{macrocode}
3740 %
3741 %^^A =================================================================
3742 %^^A Loading
3743 %^^A------------------------------------------------------------------------
3744 % \subsubsection{Customization}
3745 %
3746 % We redefine proceedings-specific commands to customize the document to our needs:
3747 % \begin{macrocode}
3748 \renewcommand{\procpdfauthor}{{\color{red}[Proceedings editor], [University]}}
3749 \renewcommand{\procpdftitle}{{\color{red}[Acronym] Proceedings}}
3750 \renewcommand{\procpdfsubject}{{\color{red}Proc. of the Xth International Conference %
3751 on [Nice Topic] ([Acronym]), [City], [Country], [Dates]}}
3752
3753 \renewcommand{\procchead}{} %
3754 \renewcommand{\proclhead}{{\em \small \procpdfsubject}}
3755
3756 \author{\procpdfauthor}
3757 \title{\procpdftitle}
3758 \date{\today}
3759 % \end{macrocode}
3760 %
3761 % We also define the paper path:
3762 %
3763 % \begin{macrocode}
3764 \renewcommand{\PAPERPATH}{papers/}
3765 % \end{macrocode}
3766 %
3767 %^^A =================================================================
3768 %^^A Loading
3769 %^^A =================================================================
3770 % \subsection{Front matter: cover page, index and table of contents}
3771 %
3772 % Ready to start? We generate the index and start the document front matter:
3773 % \begin{macrocode}
3774 \makeindex
3775
3776 %%%=========== PROCEEDINGS ===========
3777 \begin{document}
3778 \frontmatter
3779 \setcounter{page}{1}
3780 \pdfbookmark[0]{Preamble}{preamble}
3781 \pdfbookmark[1]{Cover}{cover}
3782 \maketitle
3783 \newpage
3784
3785 % \end{macrocode}
3786 % It is now time to insert the conference program:
3787 % \begin{macrocode}
3788 \otherpagestyle
3789 \tableofcontents
3790
3791 % \end{macrocode}
3792 %
3793 %^^A =================================================================
3794 %^^A Loading
3795 %^^A =================================================================
3796 % \subsection{Main matter: the papers}\label{sec:simple:ex:paper}
3797 %
3798 %^^A\changes{0.7}{2010/08/05}{Example: re-indented}
3799 % We then switch to the list of papers, organized by day and session:
3800 % \begin{macrocode}
3801 %%%==== BEGINNING OF PAPERS ====
3802 \mainmatter
3803
3804 \procday{Day 1}
3805 \session{Oral Session 1}
3806 \procpaper[switch=45,%
3807 title={Templates for One Author},%
3808 author={Alfred Alabama},%
3809 index={\index{Alabama, Alfred}},%
3810 ]{p_001}
3811 \procpaper[switch=21,%
3812 title={Templates for One Author with Two Affiliations},%
3813 author={Bob Boogie-Woogie},%
3814 index={\index{Boogie-Woogie, Bob}},%
3815 ]{p_003}
3816 \session{Poster Session 1}
3817 \procpaper[switch=33,%
3818 title = {Templates for Two Authors},%
3819 author={Alfred Alabama, Chris Christmas},%
3820 index={\index{Alabama, Alfred}\index{Christmas, Chris}},%
3821 ]{p_005}
3822
3823 \procday{Day 2}
3824 \session{Oral Session 2}
3825 \procpaper[switch=75,%
3826 title={Templates for Three Authors},%
3827 author={Bob Boogie-Woogie, Chris Christmas, Don Didon},%
3828 index={\index{Boogie-Woogie, Bob}\index{Christmas, Chris}%
3829 \index{Didon, Don}},%
3830 ]{p_007}
3831 \procpaper[switch=27,%
3832 title={Templates f\'or F\`o\"ur Àuthors},%
3833 author={J\o{}hn J\"oe, K\'e\~{n}t K\^{\i}ng, L\`ou L\'ou,%
3834 M\`anfr\'ed J. M\^ost\u{e}k\i},
3835 index={\index{J\"oe, J\o{}hn}\index{K\^{\i}ng, K\'e\~{n}t}%
3836 \index{L\'ou, L\`ou}\index{M\^ost\u{e}k\i, M\`anfr\'ed J.}},
3837 ]{p_009}
3838
3839 %%%==== END OF PAPERS ====
3840 % \end{macrocode}
3841 %
3842 %^^A =================================================================
3843 %^^A Loading
3844 %^^A =================================================================
3845 % \subsection{Back matter: index of authors}
3846 %
3847 % We are almost done: we finish by inserting the authors' index before closing the document!
3848 % \begin{macrocode}
3849 \backmatter
3850 \insertindex
3851 \end{document}
3852 %</example1empty>
3853 % \end{macrocode}
3854 %
3855 %^^A =================================================================
3856 % \subsection{\LaTeX{} runs}\label{sec:simple:ex:latex}
3857 %
3858 % To build this example, run the following \LaTeX{} steps:
3859 % \begin{enumerate}
3860 % \item generates the first \file{.aux} and \file{.idx} files (use option \Lopt{papers=countpages} as the paper's number of pages are not specified):\\
3861 % \texttt{pdflatex example1empty.tex}
3862 % \item generates the author index:\\
3863 % \texttt{makeindex -s confproc2.ist example1empty.idx}
3864 % \item inserts table of contents and index, and update their page numbers for next run (use option \Lopt{papers=countpages} again):\\
3865 % \texttt{pdflatex example1empty.tex}
3866 % \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=coutnpages}):\\
3867 % \texttt{pdflatex example1empty.tex}
3868 % \end{enumerate}
3869 %
3870 %
3871 %^^A =================================================================
3872 %^^A How to use confproc
3873 %^^A =================================================================
3874 % \newpage
3875 % \section[Example 2 (\file{example2custom.tex}): A not so short introduction to
3876 % \package{\filename}]{Example 2 (\file{example2custom.tex})\\ A not so short introduction
3877 % to \package{\filename} (2 hours or so)}
3878 % \label{sec:usage}\label{sec:example2}
3879 %
3880 % \changes{0.7}{2010/08/05}{Doc: added \file{example1empty.tex}, a simpler examples}
3881 % \changes{0.7}{2010/08/05}{Doc: re-organized examples for incremental learning}
3882 %
3883 % Here is provided exhaustive information about \emph{what can be done}
3884 % with \package{confproc}, but also \emph{how to do so}, as well as an example file (\file{example2custom.tex}) that makes use of this information. It requires an hour or so to go through. This file is based on
3885 % \file{example1empty.tex}, and adds all the necessary customization so that the
3886 % proceedings now look great.
3887 % We present its code: grey parts are identical to \file{example1empty.tex}, whereas black parts
3888 % are the modified lines.
3889 %
3890 %^^A =================================================================
3891 %^^A Loading
3892 %^^A =================================================================
3893 % \subsection{Document class loading}
3894 % \label{subsec:load}
3895 %
3896 % The class is loaded with:\begin{verbatim}
3897 %\documentclass{confproc}
3898 %\end{verbatim}
3899 % To modify the default behavior of \package{\filename}, use options:\begin{verbatim}
3900 %\documentclass[<options>]{confproc}
3901 %\end{verbatim}
3902 % All available options are described below in subsection
3903 % \ref{subsec:options}.
3904 %
3905 %^^A\changes{0.1c}{2007/07/30}{Options: new}
3906 %^^A\changes{0.2f}{2007/09/05}{Options: adding DescribeMacro for all}
3907 %^^A\changes{0.2g}{2007/09/07}{Cmds: adding DescribeMacro for all}
3908 %^^A\changes{0.2g}{2007/09/07}{Options: re-organizing section}
3909 % \changes{0.4f}{2007/10/7}{bug: \Lopt{draft} removes bookmarks}
3910 %^^A =================================================================
3911 %^^A Available Options
3912 %^^A =================================================================
3913 % \subsection{Options}
3914 % \label{subsec:options}
3915 %
3916 % There are two types of options:
3917 % \begin{itemize}
3918 % \item some are specific to the \package{\filename} class (sometimes also passed to other packages),
3919 % \item others are simply passed to the \package{book} class, the \package{hyperref} or
3920 % \package{pdfpages} packages.
3921 % \end{itemize}
3922 %^^A\changes{0.2b}{2007/08/16}{Options: adding default}
3923 %^^A\changes{0.2e}{2007/09/01}{Options: finished the alphabetical list of all options}
3924 %^^A\changes{0.3}{2007/09/26}{Options: moved the alphabetical list of all options}
3925 % A summary of all options is given in Tab.~\ref{tab:options:all:1} and \ref{tab:options:all:2}. \margindanger{} Note that \emph{for alternative options values (indicated as a list of items separated by vertical bars: $\mid$), the default value appears between squared brackets.}
3926 %^^A \color{red} {\sc find a way to get a 2-pages table, \eg{} using the \package{longtable.sty}} file \color{black}
3927 %
3928 %
3929 %^^A------------------------------------------------------------------------
3930 % \subsubsection{Log and options}
3931 %
3932 %^^A\changes{0.7}{2010/08/05}{Options: \Lopt{verbose} defaulted to \Lopt{false}}
3933 % \newvzdseven{}With the \Lopt{verbose=true} option, the \package{\filename} package prints the following
3934 % text, that shows the current option settings is always added to the log
3935 % window:\begin{verbatim}
3936 %________________
3937 %| | Document formatting:
3938 %| | ____ letterpaper
3939 %| | ____ twoside=true
3940 %| | ____ twosidepapers=true
3941 %| | Proceedings-specific formatting:
3942 %| | ____ electronic=true (file version)
3943 %| | ____ binding=(for printed version)
3944 %| | ____ papers=final(paper insertion)
3945 %| | ____ headers=allpages(header add to pages)
3946 %| | List of papers:
3947 %| | ____ paperselec=all
3948 %| | Lists (toc, bib, index):
3949 %| | ____ twocoltoc=false (=onecoltoc)
3950 %| | ____ tocnum=left
3951 %| | ____ twocolbib=true
3952 %| | ____ bib=none
3953 %| | ____ twocolindex=true
3954 %| | Help for layout design:
3955 %| | ____ checkauthor=false (do not add author list to 1st page)
3956 %| | ____ checktitle=false (do not add title to 1st page)
3957 %| | ____ showpapernumber=false (do not add paper number)
3958 %| | ____ movepagenumber=false (do not move paper number)
3959 %| | ____ showmarginlines=false (do not add template format)
3960 %| | ____ colorheaders=black(color for header/footer)
3961 %| | Verbose:
3962 %| | ____ debug=true (for hyperref)
3963 %| | ____ verbose=false (for confproc+hyperref)
3964 %| | ____ pdftk=false (for use with pdftk to add PDF metadata)
3965 %| | passed to hyperref: bookmarksdepth=1,bookmarksopen,bookmarksopenlevel=0,lin
3966 %kcolor=colorforlink,urlcolor=colorforurl
3967 %| | passed to geometry: text={175truemm,226truemm},inner=0.805in,top=29.15mm,bo
3968 %ttom=24.5mm,footskip=9.68mm,voffset=-5mm
3969 %________________
3970 %\end{verbatim}
3971 %
3972 %^^A------------------------------------------------------------------------
3973 % \subsubsection{Document formatting (book-specific)}
3974 %
3975 % The following options define some of the general document formatting via the \package{book} class:
3976 % \begin{itemize}
3977 % \item \DescribeMacro{a4paper}\Lopt{[a4paper]} $\mid$
3978 % \DescribeMacro{letterpaper}\Lopt{letterpaper} selects the paper format: A4 (European)
3979 % or letter (North American). The option is passed to the \package{book} and \package{hyperref} packages.
3980 % \item \DescribeMacro{10pt,11pt,12pt}\Lopt{[10pt]} $\mid$ \Lopt{11pt} $\mid$ \Lopt{12pt} selects the font size.
3981 % \item \DescribeMacro{twoside}\Lopt{[twoside]} $\mid$ \DescribeMacro{oneside}\Lopt{oneside}
3982 % selects two-side or one-side documents. By default, two-side documents have each new
3983 % chapter and paper starting on odd \& right pages. This means that papers with odd number
3984 % of pages will have an extra blank page at the end: they all start on a right page (easier to
3985 % find/navigate) but this does not save paper. To change this behavior for papers only, use
3986 % the \Lopt{onesidepapers} option.
3987 % \item \Lopt{[twosidepapers]} $\mid$ \Lopt{onesidepapers} forces individual papers to be in
3988 % two-side or one-side mode.
3989 % \begin{itemize}
3990 % \item With \LoptDescribe{twosidepapers}, a blank page is added to each individual paper
3991 % with an odd number of pages, so that all the papers start on a right page (with odd number)
3992 % even though the document is \Lopt{oneside}: this helps a lot to quickly browse through the
3993 % paperback proceedings, while increases the number of total pages (environmental cost).
3994 % \item Conversely, with \LoptDescribe{onesidepapers}, it allows to produce a two-side
3995 % document (\Lopt{twoside}) except for the papers, that are not separated by blank pages
3996 % when having an odd number of page.
3997 % \end{itemize}
3998 % N.B.1: When this option is not used, its default value will match the one of the whole document
3999 % (ie.~\Lopt{twosidepapers} is the default if \Lopt{twoside} is selected; and \Lopt{onesidepapers}
4000 % is the default when \Lopt{oneside} is selected). \\
4001 % N.B.2: before version 0.5, \Lopt{twosidepapers} was called \Lopt{cleardoublepage}, and
4002 % \Lopt{onesidepapers} was called \Lopt{clearsinglepage}.
4003 % \end{itemize}
4004 %
4005 %
4006 %^^A------------------------------------------------------------------------
4007 % \subsubsection{Proceedings-specific formatting}\label{sec:proc:specific:formatting}
4008 %\changes{0.6}{\datevzsix}{Options: changed \Lopt{papers} option values}
4009 %\changes{0.6}{\datevzsix}{Options: added \Lopt{paperselec}}
4010 %
4011 % Depending on wether the proceedings are generated in their printed (paperback) or
4012 % electronic (PDF) document, color links may be disabled\footnote{Color pages are much
4013 % more expensive to be printed, and the color text readibility is reduced when printed in a
4014 % grey scale.}, a binding, headers and footers on some specific pages. Also, we may decide
4015 % to insert the papers in different ways depending on what we work on. All the hyperlink
4016 % features work properly by default thanks to \package{hyperref}, so the only options to set are:
4017 % \begin{itemize}
4018 % \item \DescribeMacro{electronic}\Lopt{[electronic]} $\mid$ \DescribeMacro{printed}\Lopt{printed}:
4019 % the electronic version has user-defined colors for links (same as default \Lopt{colorlinks=true}
4020 % option of the \package{pdfpages} package), whereas the printed version have black links (same
4021 % as using \Lopt{colorlinks=false} for the \package{pdfpages} package) so that they do not appear;
4022 % \item \DescribeMacro{binding}\Lopt{binding=XXmm} (default: 0mm, positive value otherwise) may
4023 % only used for a paperback version\footnote{Indeed, when browsing throught the PDF, the x-shifts
4024 % of the binding distracts the reader}. The binding corresponds to the amount of horizontal ($x$) shift
4025 % towards the external side of the proceedings (left and right margins then differ for odd and even
4026 % pages in two-side mode). The binding value may depend on the thickness of the final document,
4027 % \eg{} 2mm for a 1cm thickness, 3mm for a 1.5cm thickness, 5mm for a 3cm thickness, etc.
4028 % \item \DescribeMacro{papers}\Lopt{papers=[final]} $\mid$ \Lopt{draft} $\mid$ \Lopt{empty} $\mid$
4029 % \Lopt{countpages} changes the way papers are inserted: {\it this option is very important to set, as
4030 % it changes the speed of the \LaTeX\ run}.
4031 % \begin{itemize}
4032 % \item \LoptDescribe{papers=final} inserts each PDF page (using \package{pdfpages}) from 1
4033 % to the number of pages indicated by the user, resulting in a slow \LaTeX{} run. Use this option
4034 % for instance when working on the layout and on the bibliography merging process
4035 % (sec.~\ref{sec:general:bib}).
4036 % \item \LoptDescribe{papers=draft} fakes paper insertion and checks page existence (by
4037 % \package{pdfpages}), resulting in a (slightly) faster \LaTeX{} run. It replaces each PDF
4038 % page by an almost blank page after checking that this particular page exists. This is slightly
4039 % faster that \Lopt{papers=final} or \Lopt{papers=countpages}, but not as fast as
4040 % \Lopt{papers=empty}. It basically is useful when editing the preamble (cover page, edition
4041 % information, welcome letters), working on generating the table of contents or the index of
4042 % authors, or generating proper page numbering \emph{and willing to ensure each inserted
4043 % page exist}.
4044 % \item \LoptDescribe{papers=empty} fakes paper insertion without checking page existence,
4045 % resulting in a much faster \LaTeX{} run (but not as safe as the previous two). Use it for the
4046 % same purposed as \Lopt{papers=draft}. It also is useful for debug purposes, as it indicates
4047 % on each page its number in the paper, the author list, the paper title, the paper number and
4048 % the list of bibliography item.
4049 % \item \LoptDescribe{papers=countpages} inserts the whole paper with \package{pdfpages},
4050 % \ie{} each page of the paper regardless of the argument \Lopt{npages=XX} of \cmd{\procpaper}.\\
4051 % N.B.: \margindanger{} The \Lopt{papers=countpages} breaks the bibliography management, so the \Lopt{bib=*} option may look unefficient. Unfortunately, there is no other solution that using \Lopt{papers=final} if doing a general bibliography.
4052 % \end{itemize}
4053 % \margindanger{}Important remarks:
4054 % \begin{enumerate}
4055 % \item \newvzdseven{} Since version 0.6, bookmark data are properly generated for all the four options.
4056 % \item \newvzdseven{} For all values except \Lopt{countpages}, if no number of pages is indicated at the paper insertion (using \Lopt{npages=5}, see sec.~\ref{sec:simple:ex:paper} and \ref{sec:ex:paper:switch}), \emph{only the first page is inserted} by default. Conversely, the number of pages indicated is ignored by the \Lopt{countpages} option.
4057 % \item Switching from \Lopt{papers=empty} to any of the other three results in broken hyper-links after a single \LaTeX\ run. This means that for a working electronic proceedings, 2 compilations are needed with the `final' option (\Lopt{papers=final} or \Lopt{papers=countpages}).
4058 % \item \newvzdseven{} The option pair \Lopt{draft} $\mid$ \Lopt{final} is no more passed to \package{pdfpages}, but rather used as \Lopt{papers=final$\mid$draft}.
4059 % The option pair \Lopt{papers=final} $\mid$ \Lopt{draft} is {\bf not} exclusive, so \Lopt{papers=final} (instead of the last inserted option) `win' if using the two. For instance, using:\begin{verbatim}
4060 %\documentclass[papers=final,papers=draft]{confproc}
4061 %\end{verbatim}
4062 % we expect the last option (\Lopt{papers=draft}) to be used. In fact, it is equivalent to:\begin{verbatim}
4063 %\documentclass[papers=final]{pdfpages}
4064 %\end{verbatim}
4065 % So, make sure to only use \Lopt{papers=draft} if that's what you need!
4066 % \end{enumerate}
4067 %
4068 % \changes{0.4f}{2007/10/7}{bug: \Lopt{draft} removes bookmarks}
4069 % \changes{0.6}{2009/09/08}{\Lopt{draft} does not remove the bookmarks anymore}
4070 %
4071 % \item \DescribeMacro{headers}\Lopt{headers=[allpages]} $\mid$ \Lopt{none} $\mid$ \Lopt{onlypdf} $\mid$ \Lopt{exceptpdf} defines the pages to which a header/footer is added. Both header and footer are treated in the same way. On user request, I may later add a second option to manage separately headers and footers.
4072 % \begin{itemize}
4073 % \item \DescribeMacro{headers=allpages}\Lopt{[headers=allpages]} adds header/footer to all pages. Use it for instance if the paper templates has no header nor footer. Advice to conference template designer: this is the simplest solution, as there is no need to renumber all papers. You may then design you templates with headers/footers to see the final result, and discard header/footer before distributing the templates, to save a lot of time at the end!
4074 % \item \DescribeMacro{headers=no}\Lopt{headers=no} does not ad any header/footer to any pages. This is used when willing to add the header/footer with another software (\eg{} Acrobat) and other fonts and layout.
4075 % \item \DescribeMacro{headers=pdfonly}\Lopt{headers=pdfonly}: headers only added to PDF-included files; for use if one wants to insert header/footer on the inserted papers only. \emph{But why would one do so?}
4076 % \item \DescribeMacro{headers=exceptpdf}\Lopt{headers=exceptpdf}: headers added to all pages except PDF-inserted papers.. This is used when the paper template defines a header/footer, that you then have to cope with. Note that this template should definitely have no page number, otherwise you need to edit pages numbers on each single paper.
4077 % \end{itemize}
4078 % \item \DescribeMacro{bib}\Lopt{bib=[none]} $\mid$ \Lopt{merge} $\mid$ \Lopt{backref} $\mid$ \Lopt{last}: defines how the general bibliography is generated.
4079 % \begin{itemize}
4080 % \item \DescribeMacro{bib=none}\Lopt{bib=none} when no general bibliography is generated. The three following values for the \Lopt{bib} option are used for generating a general bibliography.
4081 % \item \DescribeMacro{bib=merge}\Lopt{bib=merge} helps when merging bibliographic items. It only inserts the first and last page of each paper. All citations from the current paper then appear either in the header (together with \Lopt{papers=final $\mid$ draft}) or onto the page (with \Lopt{papers=empty}). It also creates back-references from the bibliography to the last page of the papers that use this citation (as for the \Lopt{bib=backref} option). It runs \LaTeX{} faster (only 2 pages), but \margindanger{} page numbers are incorrect since some pages are missing.
4082 % \item \DescribeMacro{bib=backref}\Lopt{bib=backref} generates proper bibliography with back-references. It inserts all the pages from 1 to N as indicated by the user. As for \Lopt{bib=merge}, all citations from the current paper then appear either in the header (together with \Lopt{papers=final $\mid$ draft}) or onto the page (with \Lopt{papers=empty}). Then, page numbers are ok for the table of contents and the authors' index. This requires several \LaTeX{} runs, as you can see in the corresponding Unix script in sec.~\ref{sec:scripts:buildproc}. A \emph{final} compilation with the \Lopt{bib=last} option is required.\\
4083 % N.B.: to check the page numbering relatively to the paper, use \Lopt{papers=final} option to force inserting the PDF instead of a blank page, together with \Lopt{movepagenumber} in the case papers have page numbers.
4084 % \item \DescribeMacro{bib=last}\Lopt{bib=last} inserts the bibliography that is no more added to the paper last page, which means back-references will disappear at the next \LaTeX{} run. This is why this should be the final run, as far as the bibliography is concerned. This means that the program (paper ordering) is definitively set, the general bibliography is generated (and common items merged), all papers have been re-compiled if necessary (in order to re-number them all, and have them using the new bibliography), and the document has been run through \LaTeXe\ enough times with the \Lopt{bib=backref} option to have proper page numbering and back-references in the table of contents, the authors' index and the general bibliography (see sec.~\ref{sec:confproc:compil} and \ref{sec:confproc:compil:script}).
4085 % \end{itemize}
4086 % N.B.: \margindanger{} A side effect of the \Lopt{papers=countpages} is that it breaks the
4087 % bibliography management: beware that the other current options may look temporarily unefficient.
4088 % \end{itemize}
4089 %
4090 %
4091 %^^A------------------------------------------------------------------------
4092 % \subsubsection{List of inserted papers}%
4093 %
4094 % \Lopt{paperselec=[all]} $\mid$ \Lopt{paperselec=p\_001} is used when working on each paper insertion to insert a single paper (paper `p\_001' in the example) of all papers. Selecting a single paper allows to check data in particular cases. For instance when the paper length, author list of title has changed, you want to make sure that no change was forgotten when updated them.
4095 %
4096 %
4097 %^^A------------------------------------------------------------------------
4098 % \subsubsection{Lists layout (table of contents, general bibliography, index)}
4099 %
4100 %^^A\changes{0.2e}{2007/09/01}{List layouts: moved to the example}
4101 %^^A\changes{0.6}{\datevzsix}{List layouts: tocnumleft$\sim$tocnumright replaced by tocnum=left$\sim$right}
4102 % The next options deal with the layout customization for the table of contents, the index of authors and the general bibliography:
4103 % \begin{itemize}
4104 % \item \DescribeMacro{onecoltoc}\Lopt{[onecoltoc]} $\mid$ \DescribeMacro{twocoltoc}\Lopt{twocoltoc}: prints the table of contents with one/two column(s).\\
4105 % \newvzdseven{}N.B.: this option pair is boolean, so \Lopt{twocoltoc}, \Lopt{twocoltoc=true} and \Lopt{onecoltoc=false} are equivalent. Also, \Lopt{onecoltoc}, \Lopt{onecoltoc=true} and \Lopt{twocoltoc=false} are equivalent.
4106 % \item \DescribeMacro{tocnum}\Lopt{tocnum=[left]} $\mid$ \Lopt{right} places page numbers on the left / right side of table of contents. IMHO the left side provides a faster click access to individual papers.\\
4107 % N.B.: this option was named \Lopt{tocnumleft} $\mid$ \Lopt{tocnumright} prior to \newvzdseven{}version 0.7.
4108 % \item \DescribeMacro{twocolbib}\Lopt{[twocolbib]} $\mid$ \DescribeMacro{onecolbib}\Lopt{onecolbib} prints the general bibliography in a two/one column(s) format.\\
4109 % \newvzdseven{}N.B.: this option pair is a boolean, so \Lopt{twocolbib}, \Lopt{twocolbib=true} and \Lopt{onecolbib=false} are equivalent. Also, \Lopt{onecolbib}, \Lopt{onecolbib=true} and \Lopt{twocolbib=false} are equivalent.
4110 % \item\DescribeMacro{threecolindex}\Lopt{[threecolindex]} $\mid$ \DescribeMacro{twocolindex}\Lopt{twocolindex} prints the index of authors with three or two columns.\\
4111 % N.B.: this option pair is boolean, so \Lopt{threecolindex}, \Lopt{threecolindex=true} and \Lopt{twocolindex=false} are equivalent. Also, \Lopt{twocolindex}, \Lopt{twocolindex=true} and \Lopt{threecolindex=false} are equivalent.
4112 % \end{itemize}
4113 %
4114 %
4115 %
4116 %^^A------------------------------------------------------------------------
4117 % \subsubsection{Help for checking data and layout}%
4118 %
4119 %\changes{0.6}{\datevzsix}{Layout options: added \Lopt{checktitle}, \Lopt{checkauthor}, \Lopt{showpapernum}, \Lopt{showmarginlines}, and \Lopt{colorheaders}}
4120 %
4121 % Two new options are helpful to check the validity of individual paper data.
4122 % They are especially useful when either the title or the author list may have changed at some point during the proceedings edition process. Such changes may happen for the preview proceedings (when generating the proceedings from the first submissions, before the reviewing process), and for the final proceedings (that makes use of the final paper submissions). Indeed, authors often make last minute changes to their paper, and forget to let you know that the title and/or has changed!
4123 % \begin{itemize}
4124 % \item \LoptDescribe{checktitle} is a boolean defaulted to \Lopt{false}. When set to \Lopt{true}, it overlays each paper's title (according to the table of contents data provided by the \cmd{\procpaper[title=\{...\}]\{\}} command) onto the first page of each paper (except for the \Lopt{paper=empty} since it is useless).
4125 % \item \LoptDescribe{checkauthor} is a boolean defaulted to \Lopt{false}. When set to \Lopt{true}, it overlays each paper's author list title (according to the TOC data provided by the \cmd{\procpaper[author=\{...\}]\{\}} command) onto the first page of each paper (except for the \Lopt{paper=empty} since it is useless), below the title in the case both \Lopt{checktitle} and \Lopt{checkauthor} are set to \Lopt{true}.
4126 % \end{itemize}
4127 %
4128 % \noindent A few more options (and related behaviors) are helpful to design the document layout:
4129 % \begin{itemize}
4130 % \item \LoptDescribe{showpapernumber} is a boolean defaulted to \Lopt{false} that, when set to \Lopt{showpapernumber=true}, adds the paper number below the page number. This is useful when editing the proceedings with \Lopt{papers=final $\mid$ countpages}, if one notices that a paper has a formatting problem and want to give some feedback to the author (or correct the problem by him/herself).
4131 % \item \LoptDescribe{movepagenumber} is another boolean defaulted to \Lopt{false} that moves the page number a few millimeters below its normal position (the result is only seen when combined with \Lopt{headers=allpages} $\mid$ \Lopt{pdfonly}). Two footers then appear: the one from the paper, and below it the one from the proceedings. This allows to check the accuracy of page numbers in the case papers already have a page number in their template (centered in the footer).
4132 % \item \LoptDescribe{showmarginlines} is another boolean defaulted to \Lopt{false} that overlays the user-defined template format (limited to the upper horizontal line and all vertical lines). Use it when setting the horizontal (\Lopt{xshift}) and vertical (\Lopt{yshift}) alignment of each paper. To adjust the margin lines to a given proceedings template, we need to redefine the \DescribeMacro{\procmarginlines}\cmd{\procmarginlines} command, which by default is set to:
4133 %\begin{verbatim}
4134 % \renewcommand{\procmarginlines}{
4135 % \noindent
4136 % \vspace*{7mm} % adjusting vertical initial space
4137 % \begin{table}[h!] % table for vertical lines
4138 % \centering
4139 % \color{blue}
4140 % \begin{tabular}{|@{}p{3.3in}@{}|@{}p{0.3in}@{}|@{}p{3.3in}@{}|} % spacing between columns & vertical lines
4141 % \hline % upper horizontal line
4142 % ~~~~~~~~~~~ & ~ &~~~~~~~~~~~~~\\
4143 % \vspace*{7.5in} % less than a page height
4144 % ~~~~~~~~~~~ & ~ &~~~~~~~~~~~~~\\
4145 % \end{tabular}
4146 % \end{table}
4147 % }
4148 %\end{verbatim}
4149 % \item \DescribeMacro{colorheaders}\Lopt{colorheaders=[black]} allows to change the header/footer color. this is a nice feature for setting the \package{geometry} package options in the case where PDF papers already have their headers (\Lopt{headers=exceptpdf}) and one wants to check if papers are properly aligned: then, temporarily use the \Lopt{headers=all} option together.
4150 % \end{itemize}
4151 %
4152 %^^A------------------------------------------------------------------------
4153 % \subsubsection{Verbose and \package{pdftk} options}%
4154 %
4155 % The following two options are adding some output text in the log file, for short-term help to the user:
4156 % \begin{itemize}
4157 % \item \LoptDescribe{debug} is a boolean option defaulted to \Lopt{false} that is passed to the \package{hyperref} package.
4158 % \item \newvzdseven{}\LoptDescribe{verbose} is a boolean option defaulted to \Lopt{false} that turns \Lopt{debug} on and adds \package{\filename}-specific messages to the console when inserting the papers:\begin{verbatim}
4159 %confproc: partial paper insertion (last page=bib items)
4160 %______ debug: insert paper ______
4161 %confproc/file: p_001.pdf (2 pages)
4162 %confproc/title: Templates for One Author
4163 %confproc/authors: Alfred Alabama
4164 %confproc/index: \p@index{Alabama, Alfred}
4165 %confproc/shift: (0.0pt, 0.0pt)
4166 %confproc/citations:
4167 %confproc/bookmarks:
4168 %confproc/switch ID: 45
4169 %_______________________
4170 %\end{verbatim}
4171 % \end{itemize}
4172 %
4173 % When generating PDF proceeding, you may want to (re)generate individual PDF papers with proper (and homogeneous) PDF metadata. For this purpose, the \package{pdftk}\footnote{Get \package{pdftk} at: \url{http://www.accesspdf.com/pdftk/}} Unix utility is of big help (see sec.~\ref{sec:pdftk:add:PDF:metadata}). To generate \package{pdftk} data, the \newvzdseven{}\LoptDescribe{pdftk} option has been added. It is a boolean option defaulted to \Lopt{false} that generates a \file{\filename.pdftk} file. When generated, this file contains data for use with \package{pdftk} via the \file{papers\_info.sh} bash script, and they look like:\begin{verbatim}
4174 %________________
4175 %pdftk A=${PDFFILE} cat A1-3 output ${SPPATH}/p_001.pdf
4176 %gs -dBATCH -dNOPAUSE -q -sDEVICE=pdfwrite -dFirstPage=1 -dLastPage=3 -sOUTPUTFILE=${SPPATH}/p_001.pdf ${PDFFILE}
4177 %InfoName: p_001.info
4178 %InfoKey: Title
4179 %InfoValue: Templates for One Author
4180 %InfoKey: Author
4181 %InfoValue: Alfred Alabama
4182 %InfoKey: Subject
4183 %InfoValue: DAFx-06 Conference
4184 %InfoKey: Producer
4185 %InfoValue: pdftk 1.12 + Ghostscript 8.71
4186 %InfoKey: Creator
4187 %InfoValue: LaTeX2e + confproc 0.7
4188 %InfoEnd
4189 %\end{verbatim}
4190 %
4191 % When \Lopt{pdftk} is combined with \Lopt{verbose}, this text also appears in the log window.\\
4192 % \DescribeMacro{pdftkfolder}\Lopt{pdftkfolder =\{path/to/pdftk/files/\}} sets the folder where \file{pdftk} files are written string (default: '.', ie. the current folder).\\
4193 % \DescribeMacro{pdftksubject}\Lopt{pdftksubject=\{DAFx-06 Conference\}} sets the subject string (default: Conference). \\
4194 % \DescribeMacro{pdftkproducer}\Lopt{pdftkproducer=\{producer\}} sets the producer string (default: `pdftk \versionpdftk + Ghostscript \versionghostscript'). \\
4195 % \DescribeMacro{pdftkcreator}\Lopt{pdftkcreator=\{creator\}} sets the creator string (default: LaTeX2e + `confproc \currentpkgversion').
4196 %
4197 %
4198 %^^A\changes{0.2b}{2007/08/16}{Options: added descriptions for \package{hyperref} options}
4199 %^^A------------------------------------------------------------------------
4200 % \subsubsection{Options for the \package{hyperref} package}\label{sec:options:hyperref}
4201 %
4202 % The \package{\filename} package being based on the \package{hyperref} package for all PDF and links, all the \package{hyperref} option values can be customized. This is a good thing for fine tuning your document, but at your own risks if you do not read the corresponding documentation \cite{Oberdiek:2006:hyperref}. To help the reader, next paragraphs indicate which options should be customized (sandbox), and the following paragraph the options that should not be modified (expert side).
4203 %
4204 % \paragraph{Mechanism to set options}
4205 %
4206 % \newvzdseven{} Up to version 0.5, unknown options used with
4207 % the \package{\filename} package were passed to the \package{hyperref} package.
4208 % While this is still possible, we strongly recommend to pass options
4209 % to \package{hyperref} using the \DescribeMacro{hyperref}\Lopt{hyperref=\{option list\}},
4210 % since only this mechanism will be allowed in future versions. For instance, default
4211 % values are:\begin{verbatim}
4212 %hyperref={colorlinks=true,linkcolor=red,citecolor=blue,urlcolor=blue,%
4213 % bookmarksopen=true,bookmarksopenlevel=1}%
4214 %\end{verbatim}
4215 %
4216 %
4217 % \paragraph{The sandox}
4218 %
4219 % Some of \package{hyperref} options should be customized to each one's needs, for instance:
4220 % \begin{itemize}
4221 % \item \DescribeMacro{colorlinks}\Lopt{colorlinks=true} or \Lopt{colorlinks} provides color links in the table of contents, index of authors and general bibliography to the corresponding pages in the proceedings. This option has the same effect as the \Lopt{electronic} option from the \package{\filename} package.
4222 % \item \Lopt{colorlinks=false} provides links without color, which is particularly helpful for printed proceedings (where using color increases the cost of printing, or reduces the quality if printed in black and white). This option has the same effect as the \Lopt{printed} option from the \package{\filename} package.
4223 % \item \DescribeMacro{citecolor}\Lopt{citecolor=colorforcite} uses the color \Lopt{colorforcite} (to be defined by the used) for links to bibliography items cited;
4224 % \item \DescribeMacro{linkcolor}\Lopt{linkcolor=colorforlink} uses the color \Lopt{colorforlink} for links, such as from the index of authors, table of contents and general bibliography back-references;
4225 % \item \DescribeMacro{urlcolor}\Lopt{urlcolor=colorforurl} uses the color \Lopt{colorforurl} for URL, mainly in the general bibliography but also in the publishing information, for example;
4226 % \item \DescribeMacro{debug}\Lopt{debug} prints more information from the \package{hyperref} package;
4227 % \item \DescribeMacro{a4paper,letterpaper}\Lopt{a4paper} $\mid$ \Lopt{letterpaper} are passed to \package{hyperref};
4228 % \item \DescribeMacro{bookmarksopen} \Lopt{bookmarksopen=[true]} $\mid$ \Lopt{false}: opens/closes the bookmarks of the PDF file.\\
4229 % \margindanger{}N.B.: a change of this option will only be reflected in the PDF after two pdf\LaTeX{} runs.
4230 % \item \DescribeMacro{bookmarksopenlevel} \Lopt{bookmarksopenlevel=0} $\mid$ \Lopt{[1]} $\mid$ \Lopt{2}: bookmarks are opened at level 0 (parts=days), 1 (chapters=sessions) or 2 (sections=papers). The `session' level is a good choice, as they are not too many sessions, so all lines should display at once when opening the PDF, whereas the `paper' level would require more lines than papers (100? 200?). \\
4231 % \margindanger{}N.B.: a change of this option will only be reflected in the PDF after two pdf\LaTeX{} runs.
4232 % \end{itemize}
4233 %
4234 % \paragraph{The expert side}
4235 %
4236 % Other \package{hyperref} options change hyperlink properties such as back-references. Their values are then given by default to the \package{hyperref} package to ensure the electronic version of the proceedings is ok. They should be changed with a lot of care\footnote{Please refer to the \package{hyperref} documentation \protect\cite{Oberdiek:2006:hyperref} for more complete, accurate and up-to-date descriptions.}:
4237 % \begin{itemize}
4238 % \item \DescribeMacro{pdftex}\Lopt{pdftex}: to set up \package{hyperref} for use with the pdftex program.
4239 % \item \DescribeMacro{raiselinks}\Lopt{raiselinks}: in the hypertex driver, the height of links is normally calculated by the driver as simply the base line of contained text; this options forces \cmd{\special} commands to reflect the real height of the link (which could contain a graphic).
4240 % \item \DescribeMacro{hyperindex}\Lopt{hyperindex}: makes the text of index entries into hyperlinks. It is used for the index of authors, to link back to their various papers.
4241 % \item \DescribeMacro{backref}\Lopt{backref}: allows for back-references in the general bibliography.
4242 % \item \DescribeMacro{pagebackref}\Lopt{pagebackref}: adds `backlink' text to the end of each item in the bibliography, as a list of page numbers (this can only work properly if there is a blank line after each \cmd{\bibitem}).
4243 % \item \DescribeMacro{plainpages}\Lopt{plainpages=false}: forces page anchors to be named by the arabic form of page number, rather than the formatted form. This is useful since \package{confproc} uses the \package{book} class, and uses a front matter (publishing information, welcome letters, table of contents, etc) before inserting papers.
4244 % \item \DescribeMacro{pdfpagelabels}\Lopt{pdfpagelabels}: sets PDF page labels, to be able to link to them.
4245 % \item \DescribeMacro{breaklinks}\Lopt{breaklinks}: allows links to break over lines by making links over multiple lines into PDF links to the same target. This is particularly useful for 2-columns table of contents with the option \Lopt{linktocpage=false} (not the default); and for long URLs in the general bibliography.
4246 % \item \DescribeMacro{linktocpage}\Lopt{linktocpage}: makes page number (instead of text) to be the link to table of contents (as well as list of figures and list of tables, but they are not often used for proceedings).
4247 % \item \DescribeMacro{pdfstartview=XYZ}\Lopt{pdfstartview=XYZ}: opens the PDF in Acrobat with zoom=100\% instead of full screen; especially useful if working with a big screen (\eg{} 30 inches).
4248 % \end{itemize}
4249 %
4250 %
4251 %^^A------------------------------------------------------------------------
4252 % \subsubsection{Passed to geometry}
4253 %
4254 % As for \package{hyperref}, an option passed options to the \package{geometry} package: \Lopt{geometry=\{option list\}}\DescribeMacro{geometry}. \newvzdseven{} This simplifies a lot the setting of the proceedings layout variables, that previously was poorly managed (part of it was hard-coded in the \file{\filename.cls} file, and the left-over neglected and left to the user's skills). Default values are:\begin{verbatim}
4255 % geometry={text={6.9in,9in},inner=0.8in,top=1in,bottom=1in,%
4256 % headsep=7.05mm,footskip=10mm,voffset=-5mm}
4257 %\end{verbatim}
4258 %
4259 %
4260 %
4261 %^^A\changes{0.2b}{2007/08/16}{Options: added descriptions for \package{book} options}
4262 %
4263 % \begin{table}[htbp]
4264 % \centering
4265 % \begin{tabular}{@{}lp{1.8cm}p{6.5cm}@{}}\hline
4266 % \textbf{Option / category} & \textbf{Package(s)} & \textbf{Function}\\ \hline\hline
4267 % \multicolumn{3}{@{}l}{\bf Document formatting} \\ \hline
4268 % \Lopt{[letterpaper]} $\mid$ \Lopt{a4paper} & \package{hyperref}, \package{confproc} & European A4 $\mid$ North American paper format\\\hline
4269 % \Lopt{[10pt]} $\mid$ \Lopt{11pt} $\mid$ \Lopt{12pt} & \package{book}, \package{confproc} & set normal font size\\\hline
4270 % \Lopt{[twoside]} $\mid$ \Lopt{oneside} & \package{book}, \package{confproc} & for two/one-side documents (2-side: new chapters start on odd \& right pages) \\ \hline
4271 % \Lopt{[twosidepapers]} $\mid$ \Lopt{onesidepapers} & \package{confproc} & for papers to be locally considered as two/one-side documents \\ \hline\hline
4272 % \multicolumn{3}{@{}l}{\bf Proceedings-specific formatting} \\ \hline
4273 % \Lopt{[electronic]} $\mid$ \Lopt{printed} & \package{\filename} & links with/without colors. Identical to \Lopt{colorlinks=true} $\mid$ \Lopt{false} from \package{pdfpages} \\\hline
4274 % \Lopt{binding=Xmm [0mm]} & \package{\filename} & amount of horizontal space added to printed version (independent from \Lopt{printed}) \\\hline
4275 % \Lopt{papers=[final]} & \package{\filename} & inserts PDF papers from page 1 to N (slow)\\
4276 % \Lopt{\phantom{papers=}draft} & \package{pdfpages}, \package{\filename} & fakes PDF papers inclusion from page 1 to N, but checks page existence (faster) \\
4277 % \Lopt{\phantom{papers=}empty} & \package{\filename} & fakes PDF papers inclusion from page 1 to N without checking page existence (fastest) \\
4278 % \Lopt{\phantom{papers=}countpages} & \package{\filename} & include full PDF papers (slowest; ignore N and breaks blibliography) \\ \hline
4279 % \Lopt{headers=[allpages]} & \package{\filename} & header/footer for all pages\\
4280 % \Lopt{\phantom{headers=}pdfonly} & \package{\filename} & header/footer only for PDF papers\\
4281 % \Lopt{\phantom{headers=}exceptpdf} & \package{\filename} & header/footer for all pages except PDF papers\\
4282 % \Lopt{\phantom{headers=}none} & \package{confproc} & no header/footer for any pages\\\hline
4283 % \Lopt{bib=[none]} & \package{confproc} & no general bibliography\\
4284 % \Lopt{\phantom{bib=}last} & \package{confproc} & for the final compilation with general bibliography (breaks back-references)\\
4285 % \Lopt{\phantom{bib=}merge} & \package{confproc} & only includes 1st and last page (faster run) for merging bib items in the general bibliography \\
4286 % \Lopt{\phantom{bib=}backref} & \package{confproc} & prepares back-references before final run \\\hline \hline
4287 % \multicolumn{3}{@{}l}{\bf List of inserted papers} \\ \hline
4288 % \Lopt{paperselec=[all]} $\mid$ \Lopt{p\_001}... & \package{confproc} & indicate the papers to be inserted (1 or all)\\ \hline\hline
4289 % \multicolumn{3}{@{}l}{\bf Lists formatting} \\ \hline
4290 % \Lopt{[onecoltoc]} $\mid$ \Lopt{twocoltoc} & \package{confproc} & one/two column(s) table of contents \\\hline
4291 % \Lopt{tocnum=[left]} $\mid$ \Lopt{right} & \package{confproc} & left/right page numbering table of contents \\\hline
4292 % \Lopt{[onecolbib]} $\mid$ \Lopt{twocolbib} & \package{confproc} & one/two column(s) general bibliography \\\hline
4293 % \Lopt{[threecolindex]} $\mid$ \Lopt{twocolindex} & \package{confproc} & three/two columns index of authors \\ \hline \hline
4294 % \multicolumn{3}{@{}l}{\bf Help for checking data and layout}\\ \hline
4295 % \Lopt{checktitle} ([false]) & \package{\filename} & overlays the title onto each paper's 1st page\\ \hline
4296 % \Lopt{checkauthor} ([false]) & \package{\filename} & overlays the author list onto each paper's 1st page\\ \hline
4297 % \Lopt{showpapernumber} ([false]) & \package{\filename} & adds paper number below page number\\ \hline
4298 % \Lopt{movepagenumber} ([false]) & \package{\filename} & moves page number down by a few millimeters\\ \hline
4299 % \Lopt{showmarginlines} ([false]) & \package{\filename} & shows margin lines of paper template\\ \hline
4300 % \Lopt{colorheaders=[black]} & \package{\filename} & changes color of header/footer\\ \hline
4301 % \end{tabular}
4302 % \caption{{\it List of options 1/2}}
4303 % \label{tab:options:all:1}
4304 % \end{table}
4305 %
4306 %
4307 % \begin{table}[htbp]
4308 % \centering
4309 % \begin{tabular}{lp{1.8cm}p{6cm}}\hline
4310 % Option / category & Package(s) & Function\\ \hline\hline
4311 % \multicolumn{3}{@{}l}{\bf Verbose and \package{pdftk} options}\\ \hline
4312 % \Lopt{debug} ([false]) & \package{hyperref} & sets \Lopt{debug=true} for \package{hyperref}\\\hline
4313 % \Lopt{verbose} ([false]) & \package{\filename} & sets \Lopt{debug=true} + adds \package{\filename} specific debug\\ \hline
4314 % \Lopt{pdftk} ([false]) & \package{\filename} & generates \filename.pdftk with \package{pdftk} commands for metadata of individual papers\\ \hline
4315 % \Lopt{pdftksubject} ([Conference]) &\package{\filename} & set PDF subject metadata for \package{pdftk} \\ \hline
4316 % \Lopt{pdftkproducer} & \package{\filename} & set PDF producer metadata for \package{pdftk} \\
4317 % ([pdftk 1.12 + Ghostscript 8.71]) & & \\ \hline
4318 % \Lopt{pdftkcreator} ([LaTeX2e + confproc 0.7]) & \package{\filename} & set PDF creator metadata for \package{pdftk}\\ \hline \hline
4319 % \multicolumn{3}{@{}l}{\bf Passed to \package{hyperref} using \Lopt{hyperref=\{option list\}}}\\ \hline
4320 % \Lopt{backref} &\package{hyperref} & add reference page number and link to each bibliographic item\\
4321 % \Lopt{breaklinks} & \package{hyperref} & allows links to break over lines by making links over multiple lines into PDF links to the same target (great for table of contents and bibliography in two columns)\\
4322 % \Lopt{citecolor=[blue]} & \package{hyperref} & use the user-defined \Lopt{colorforcite} color for links to bibliography items cited \\
4323 % \Lopt{colorlinks=[true]} $\mid$ \Lopt{false} & \package{hyperref} & links without/without colors. Equivalent to \Lopt{electronic} $\mid$ \Lopt{printed}\\
4324 % \Lopt{hyperindex} & \package{hyperref} & author index entries pages = hyperlinks to each paper\\
4325 % \Lopt{linkcolor=[red]} & \package{hyperref} & color to use for links (from index, TOC, and bibliography back-references)\\
4326 % \Lopt{linktocpage=[true]}& \package{hyperref} & TOC link is the page number, not the text\\
4327 % \Lopt{pdfpagelabels=[true]} & \package{hyperref} & set PDF page labels: compulsory for creating any link to page!\\
4328 % \Lopt{pdfstartview=[XYZ]} & \package{hyperref} & open the PDF file in Acrobat with zoom=100\% instead of full screen\\
4329 % \Lopt{pdftex=[true]} & \package{hyperref} & set up \package{hyperref} for use with pdf\TeX{} \\
4330 % \Lopt{plainpages=[false]} & \package{hyperref} & forces page anchors to be named by the arabic form of the page number, rather than the formatted form\\
4331 % \Lopt{raiselinks=[true]} & \package{hyperref} & forces \cmd{\special} commands to reflect the link real height (may contain a graphic)\\
4332 % \Lopt{urlcolor=blue} & \package{hyperref} & use the \Lopt{blue} color for URL (general bibliography, publishing information)\\ \hline \hline
4333 % \multicolumn{3}{@{}l}{\bf Passed to \package{geometry} using \Lopt{geometry=\{option list\}}}\\ \hline
4334 % \Lopt{text=\{height=21cm,width=15cm\}} &\package{geometry} & see \package{geometry} \\ \hline
4335 % \end{tabular}
4336 % \caption{{\it Alphabetical list of all options 2/2}}
4337 % \label{tab:options:all:2}
4338 % \end{table}
4339 %
4340 %
4341 %
4342 %^^A\changes{0.2b}{2007/08/16}{Options: adding default}
4343 %^^A\changes{0.2e}{2007/09/01}{Layouts: removed layout}
4344 %^^A------------------------------------------------------------------------
4345 % \subsubsection{Default option values}\label{sec:options:default}
4346 %
4347 % By default, the set of options used (if not defined by the user) produces a 2-side 10pt and letter size final electronic proceedings (ie. no debug) without binding and with blue links:
4348 % \begin{itemize}
4349 % \item document formatting, also passed to book: \Lopt{letterpaper}, \Lopt{10pt}, \Lopt{twoside};
4350 % \item proceedings-specific formatting: \Lopt{twosidepapers}, \Lopt{electronic}, \Lopt{binding=0mm},
4351 % \Lopt{papers=final}, \Lopt{headers=allpages}, \Lopt{bib=none};
4352 % \item list of inserted papers: \Lopt{paperselec=all};
4353 % \item lists formatting: \Lopt{onecoltoc}, \Lopt{tocnum=left}, \Lopt{threecolindex}, \Lopt{twocolbib};
4354 % \item checking layout and paper data: \Lopt{checktitle=false}, \Lopt{checkauthor=false}, \Lopt{showmarginlines=false}, \Lopt{showpapernumber=false}, \Lopt{movepagenumber=false}, \Lopt{colorheaders=black};
4355 % \item printing package debug: \Lopt{verbose=false}, \Lopt{debug=false};
4356 % \item generating the \package{pdftk} data file: \Lopt{pdftk=false};
4357 %^^A% \item \Lopt{beforehyperref=\{\}},
4358 %^^A% \item \Lopt{afterhyperref=\{\}},
4359 % \item passed to \package{hyperref}: \Lopt{colorlinks=true}, \Lopt{linkcolor=red}, \Lopt{citecolor=blue}, \Lopt{urlcolor=blue}, \Lopt{bookmarksopen=true}, \Lopt{bookmarksopenlevel=1};
4360 % \item passed to \package{geometry}: \Lopt{text={6.9in,9in}}, \Lopt{inner=0.8in}, \Lopt{top=1in}, \Lopt{bottom=1in}, \Lopt{headsep=7.05mm}, \Lopt{footskip=10mm}, \Lopt{voffset=-5mm}.
4361 % \end{itemize}
4362 %
4363 %
4364 %^^A\changes{0.1c}{2007/07/30}{Example: new}
4365 %^^A\changes{0.2i}{2007/09/21}{Example: move all extra info from the source code to the example, costumization}
4366 %^^A------------------------------------------------------------------------
4367 % \subsubsection{Back to the example: loading the cass with options}
4368 %
4369 % \color{black}
4370 %\changes{0.6}{\datevzdsix}{Example: added \file{example2custom.tex}}
4371 % \begin{macrocode}
4372 %<*example2custom>
4373 % \end{macrocode}
4374 % \color{black!50}
4375 % \begin{macrocode}
4376 \documentclass[letterpaper,10pt,twoside,%
4377 electronic,% [printed] | electronic
4378 % \end{macrocode}
4379 % \color{black}
4380 % \begin{macrocode}
4381 papers=final,% empty | draft | [final] | countpages
4382 headers=exceptpdf,% none | pdfonly | exceptpdf | [allpages]
4383 % \end{macrocode}
4384 % \color{black!50}
4385 % \begin{macrocode}
4386 paperselec=all, %[all] | p_001 | p_fake
4387 % \end{macrocode}
4388 % \color{black}
4389 % \begin{macrocode}
4390 colorheaders=red,%
4391 verbose,%
4392 pdftk,%
4393 pdftkfolder={pdftk_info/},%
4394 pdftksubject={DAFx-06 Conference},%
4395 % \end{macrocode}
4396 % \color{black!50}
4397 % \begin{macrocode}
4398 hyperref={bookmarksdepth=1,bookmarksopen,bookmarksopenlevel=0,%
4399 % \end{macrocode}
4400 % \color{black}
4401 % \begin{macrocode}
4402 citecolor=colorforcite,linkcolor=colorforlink,urlcolor=colorforurl},%
4403 % \end{macrocode}
4404 %
4405 % \changes{0.4b}{2007/10/12}{Layout: set \cmd{\footskip}}
4406 %^^A------------------------------------------------------------------------
4407 % \subsubsection{Document layout}\label{sec:custom:layout:doc}
4408 %
4409 % We used the following \package{geometry} options for tuning page attributes:
4410 % \color{black!50}
4411 % \begin{macrocode}
4412 geometry={text={175truemm,226truemm},% A4 & letter
4413 inner=0.805in,top=29.15mm,bottom=24.5mm,footskip=9.68mm,voffset=-5mm},%letter
4414 ]{confproc}
4415
4416 % \end{macrocode}
4417 %^^A\usepackage[width=175mm,height=229mm,voffset=-10.22mm,top=36.68mm,%
4418 %^^A headsep=7.05mm,footskip=11.29mm,twoside,left=20.44mm]{geometry}
4419 % \color{black}
4420 % so that the proceedings layout can perfectly match the one of individual papers.
4421 % This means that you have to check for those values in your template.
4422 %
4423 %
4424 %^^A =================================================================
4425 %^^A Loading
4426 %^^A------------------------------------------------------------------------
4427 % \subsubsection{Example: loading extra packages}
4428 %
4429 % Then, we define the other packages to be used.
4430 %
4431 % \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.
4432 %^^A \color{red} {\sc Should we use something like \verb+\AtBeginDocument+ to insert the hyperref package in the class definition?} \color{black}
4433 %^^A\changes{0.2e}{2007/09/01}{Layouts: moved to the example}
4434 %
4435 % We specify the input and font encodings, to allow for running \LaTeX{} on a document with accents (in the list of authors and paper titles):
4436 % \color{black!50}
4437 % \begin{macrocode}
4438 \usepackage[utf8]{inputenc}
4439 \usepackage[T1]{fontenc}
4440 % \end{macrocode}
4441 % \color{black}
4442 % We change the default \LaTeX{} font to `Times', as it displays better in PDF files:
4443 % \changes{0.4b}{2007/10/12}{Pkg: \package{mathptmx} replaces \package{times}}
4444 % \color{black!50}
4445 % \begin{macrocode}
4446 \usepackage{mathptmx}
4447 % \end{macrocode}
4448 % \color{black}
4449 % 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.}.
4450 %
4451 % The header of DAFx-06 proceedings had a `$9\textsuperscript{th}$', that requires:
4452 % \changes{0.4b}{2007/10/12}{Pkg: \package{nth} for superscript ordinals}
4453 % \color{black!50}
4454 % \begin{macrocode}
4455 \usepackage[super]{nth}
4456
4457 % \end{macrocode}
4458 % \color{black}
4459 %
4460 %
4461 %
4462 %^^A\changes{0.1c}{2007/07/30}{Commands: created}
4463 %^^A\changes{0.2g}{2007/09/07}{Cmds: re-organizing/merging sections about customization}
4464 %^^A =================================================================
4465 %^^A Description of the provided commands
4466 %^^A =================================================================
4467 % \subsection{Commands and customization}
4468 % \label{subsec:commands}\label{sec:custom}
4469 %
4470 % Here is a list of what proceedings element that can be customized:
4471 % the document layout (see sec.~\ref{sec:custom:layout:doc});
4472 % the PDF metadata (see sec.~\ref{sec:custom:metadata});
4473 % the titles for special section (see sec.~\ref{sec:custom:special:section:titles});
4474 % the front page (see sec.~\ref{sec:custom:front:page});
4475 % the document header/footer (see sec.~\ref{sec:custom:header:footer});
4476 % the publishing information;
4477 % the welcome letter(s);
4478 % the title/author style in the table of contents and bookmarks (see sec.~\ref{sec:custom:title:author});
4479 % the color for links (see sec.~\ref{sec:custom:colors});
4480 % and of course how many columns for the table of contents (1 or 2), bibliography (1 or 2) and index of authors (2 or 3) using options.
4481 %
4482 % \margindanger{} N.B.: All these customizations are also used in the provided example file \file{example3optim.tex}; the explanations in section~\ref{sec:example3} are then similar (for people skipping one of the two).
4483 %
4484 %
4485 %
4486 %
4487 % \changes{0.4e}{2007/10/12}{Layout: use the \package{geometry} package}
4488 %^^A =================================================================
4489 % \subsubsection{PDF vertical and horizontal shifts}
4490 % We set the default $x$ (left/right) and $y$ (up/down) shifts used to insert PDFs files:
4491 % \color{black!50}
4492 % \begin{macrocode}
4493 \setlength{\LaTeXxShift}{0pt}
4494 \setlength{\LaTeXyShift}{-3mm} %letter
4495 %\setlength{\LaTeXyShift}{1mm} %A4
4496 \setlength{\WordxShift}{10pt}
4497 \setlength{\WordyShift}{-40pt}
4498
4499 % \end{macrocode}
4500 % \color{black}
4501 % The commented line is used with the A4 format (see also sec.~\ref{sec:custom:layout:doc}).
4502 % The values may differ depending if the papers were generated using a \LaTeX\ template
4503 % and a Word template, in the case your templates are not perfectly identical (which is often
4504 % the case). The default values provided by the class are those used for the DAFx-06
4505 % proceedings, and were tested for both letter and A4 format.
4506 %
4507 % \margindanger{}Those global values are used by default for each paper, except if
4508 % \cmd{\procpaper} has other values specified for the option arguments: \Lopt{xshift=...} and \Lopt{yshift=...}.
4509 %
4510 % \changes{0.4b}{2007/10/12}{Layout: set \cmd{\footskip}}
4511 % \changes{0.4e}{2007/10/12}{Layout: use the \package{geometry} package}
4512 % \changes{0.4b}{2007/10/12}{Pkg: \package{nth} for superscript ordinals}
4513 %^^A------------------------------------------------------------------------
4514 % \subsubsection{Define colors for internal and external hyper-links}\label{sec:custom:colors}
4515 %
4516 % When inserting the document class, we have used home-made colors for the links
4517 % (\Lopt{citecolor}, \Lopt{linkcolor} and \Lopt{urlcolor}); those colors remain to be defined
4518 % in the document preamble before being used:
4519 % \begin{macrocode}
4520 \definecolor{colorforlink}{rgb}{0,0,0.8}
4521 \definecolor{colorforcite}{rgb}{0,0.8,0}
4522 \definecolor{colorforurl}{rgb}{0,0,1}
4523
4524 % \end{macrocode}
4525 %^^A \definecolor{colorforpage}{rgb}{0,0,0.7}
4526 % There are a few things you need to know about it:
4527 % \begin{itemize}
4528 % \item the way colors are declared is explained in the \package{color} package;
4529 % \item the \Lopt{colorforlink} color is used for all links in the table of contents and index of authors, as well as back-references;
4530 %^^A \item the \Lopt{colorforpage} color is not currently used in the example. It will only be used if you decide to point to a given page from the preamble, for instance;
4531 % \item the \Lopt{colorforurl} color is useful only if you include URL(s) in you preamble, or in the general bibliography (if any);
4532 % \item the \Lopt{colorforcite} color is useful only in two cases:
4533 % \begin{itemize}
4534 % \item without a general bibliography: if you cite any document form the preamble (not from a paper);
4535 % \item with a general bibliography: it is only used during the merging process. After this process and when generating the final document, all citations will disappear, as the last page of the paper is properly inserted.
4536 % \end{itemize}
4537 % \end{itemize}
4538 %
4539 %
4540 % \color{black}
4541 %
4542 %^^A------------------------------------------------------------------------
4543 % \subsubsection{PDF metadata}\label{sec:custom:metadata}
4544 %
4545 % As \package{\filename} is to be used with pdf\LaTeX{} and generates a PDF, it makes sense
4546 % to customize the PDF metadata, that correspond to the PDF file information that are provided from the
4547 % operating system. At least three metadata should be set, given here with their default values.
4548 % To do so, we start by defining generic strings that will be used:
4549 % \begin{macro}{\DAFxname}
4550 % \begin{itemize}
4551 % \item firstly, the conference name
4552 % \end{itemize}
4553 % \begin{macrocode}
4554 \newcommand{\DAFxname}{Proc.~of the \nth{9} %
4555 Int.~Conference on Digital Audio Effects (DAFx-06)}
4556 % \end{macrocode}
4557 % \end{macro}
4558 % \begin{macro}{\DAFxdate}
4559 % \begin{itemize}
4560 % \item secondly, the conference date(s):
4561 % \end{itemize}
4562 % \begin{macrocode}
4563 \newcommand{\DAFxdate}{September 18-20, 2006}
4564 % \end{macrocode}
4565 % \end{macro}
4566 % \begin{macro}{\DAFxaddress}
4567 % \begin{itemize}
4568 % \item thirdly, the conference address:
4569 % \end{itemize}
4570 % \begin{macrocode}
4571 \newcommand{\DAFxaddress}{Montreal, Canada}
4572
4573 % \end{macrocode}
4574 % \color{black}
4575 % \end{macro}
4576 % We can then define the 3 PDF metadata as follows:
4577 % \begin{itemize}
4578 % \item use \cmdDescribe{\procpdfauthor} to change the PDF author (default: `[Proceedings author/editor]'):
4579 % \end{itemize}
4580 % \begin{macrocode}
4581 \renewcommand{\procpdfauthor}{Vincent Verfaille, McGill University}
4582 % \end{macrocode}
4583 % \begin{itemize}
4584 % \item use \cmdDescribe{\procpdftitle} to change the PDF short title (default: `[Proceedings title]'):
4585 % \end{itemize}
4586 % \begin{macrocode}
4587 \renewcommand{\procpdftitle}{DAFx-06 Proceedings - \DAFxaddress}
4588 % \end{macrocode}
4589 % \begin{itemize}
4590 % \item use \cmdDescribe{\procpdfsubject} to change the PDF subject (default: `[Proceedings description]'):
4591 % \end{itemize}
4592 % \begin{macrocode}
4593 \renewcommand{\procpdfsubject}{Conference proceedings}
4594
4595 % \end{macrocode}
4596 % Those values are used to set 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.\\
4597 % \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.\\
4598 % N.B.: an alternative way to change the PDF metadata consist in using the \cmdDescribe{\hypersetup} command (see the \package{hyperref} package).
4599 %
4600 %
4601 %^^A \changes{0.4b}{2007/10/12}{Pkg: \package{nth} for superscript ordinals}
4602 %^^A \changes{0.4b}{2007/10/12}{Cmd: \cmd{\proccfoot} uses \cmd{\vspace} instead of \cmd{\vskip}}
4603 %^^A \changes{0.4b}{2007/10/12}{Layout: using proper value for \cmd{\footskip} and removing the \cmd{\vspace} from \cmd{\proccfoot}}
4604 %^^A------------------------------------------------------------------------
4605 % \subsubsection{Header and footer}\label{sec:custom:header:footer}
4606 %
4607 % 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:
4608 % \color{black!50}
4609 % \begin{macrocode}
4610 \renewcommand{\procchead}{}%
4611 % \end{macrocode}
4612 % \color{black}
4613 % \begin{macrocode}
4614 %%\renewcommand{\proclhead}{{\em \small \procpdfsubject}}
4615 \renewcommand{\proclhead}{{\em \small \DAFxname, \DAFxaddress, \DAFxdate}}
4616 % \end{macrocode}
4617 % as well as \cmdDescribe{\proccfoot} for the central footers (the page number being centered by default):
4618 % \begin{macrocode}
4619 \renewcommand{\proccfoot}{\small DAFX-\thepage}
4620 % \end{macrocode}
4621 % The \cmdDescribe{\procfootvskip} length adjusts the footer vertical position:
4622 % \begin{macrocode}
4623 \setlength{\procfootvskip}{1.2mm}
4624 % \end{macrocode}
4625 % \begin{macro}{\procoptfootvskip}
4626 % When checking the page numbering for papers which template already includes
4627 % the page number, we may change the amount of vertical shift applied to move down
4628 % by a few millimeters (default: 3mm) the footer when using the \Lopt{movepagenumber}
4629 % option. Then, use the \cmd{\procoptfootvskip} command:
4630 % \begin{macrocode}
4631 %%\setlength{\procoptfootvskip}{4mm}
4632
4633 % \end{macrocode}
4634 % As soon as you remove the \Lopt{movepagenumber} option, the footer comes back to its normal position.
4635 % \end{macro}
4636 %
4637 %
4638 %^^A------------------------------------------------------------------------
4639 % \subsubsection{Define front page and title commands}\label{sec:custom:front:page}
4640 %
4641 % \paragraph{\LaTeX\ commands}
4642 % To generate the front page with \cmd{\maketitle}, redefine usual \LaTeX\ commands:
4643 % \begin{macro}{\author}
4644 % \begin{itemize}
4645 % \item the proceedings' author/editor:
4646 % \end{itemize}
4647 % \begin{macrocode}
4648 %%\author{Vincent Verfaille, McGill University}
4649 % \end{macrocode}
4650 % \end{macro}
4651 % \begin{macro}{\title}
4652 % \begin{itemize}
4653 % \item the proceedings' title:
4654 % \end{itemize}
4655 % \begin{macrocode}
4656 %%\title{Proc. of the \nth{9} Int. Conf. on Digital Audio Effects\\
4657 %% Montreal, Quebec, Canada}
4658 % \end{macrocode}
4659 % \end{macro}
4660 % \begin{macro}{\date}
4661 % \begin{itemize}
4662 % \item the proceedings' date:
4663 % \end{itemize}
4664 % \begin{macrocode}
4665 %%\date{Sept.~18--20, 2006}
4666 % \end{macrocode}
4667 % \color{black}
4668 % \end{macro}
4669 % We can alternatively use the \cmd{\procpdfauthor} and \cmd{\procpdftitle} commands that we previously defined (if set to what is expected) to set:
4670 % \color{black!50}
4671 % \begin{macro}{\author}
4672 % \begin{itemize}
4673 % \item the proceedings' author/editor:
4674 % \end{itemize}
4675 % \begin{macrocode}
4676 \author{\procpdfauthor}
4677 % \end{macrocode}
4678 % \end{macro}
4679 % \color{black}
4680 % \begin{macro}{\title}
4681 % \begin{itemize}
4682 % \item the proceedings' title:
4683 % \end{itemize}
4684 % \begin{macrocode}
4685 %%\title{\procpdftitle}
4686 \title{\DAFxname\\ \DAFxaddress}
4687 % \end{macrocode}
4688 % \end{macro}
4689 % \begin{macro}{\date}
4690 % \begin{itemize}
4691 % \item the proceedings' date:
4692 % \end{itemize}
4693 % \color{black!50}
4694 % \begin{macrocode}
4695 %%\date{\today}
4696 % \end{macrocode}
4697 % \color{black}
4698 % \begin{macrocode}
4699 \date{\DAFxdate}
4700 % \end{macrocode}
4701 % \end{macro}
4702 % Then, some fine tuning of all the parameters of this page is needed so that it looks as you wish (potentialy with logos, images, etc).
4703 %
4704 % \paragraph{Import a PDF page from another editor}
4705 % As for the DAFx-06 proceedings, we may insert with \package{pdfpages} the cover, generated as another document (for instance with X{\sc e}\LaTeX):
4706 % \begin{macrocode}
4707 %%\includepdf[noautoscale,pages=1,link]{\PICTPATH ex_1stpage.pdf}
4708
4709 % \end{macrocode}
4710 % Indeed, we found it easier to design our very own cover using Xe\TeX, or any other tool.\\
4711 % N.B.: the PDF file named \file{ex\_1stpage.pdf} is provided in the \file{.zip} archive of the package but not generated by the package.
4712 %
4713 %
4714 %^^A------------------------------------------------------------------------
4715 % \subsubsection{Special section titles (toc, index, biblio)}\label{sec:custom:special:section:titles}
4716 %
4717 % To change special section titles, redefine the \LaTeX{} commands already modified by \package{confproc}:
4718 % \begin{macro}{\contentsname}
4719 % \begin{itemize}
4720 % \item title of the table of contents (default: `Conference Program'):
4721 % \end{itemize}
4722 % \begin{macrocode}
4723 %%\renewcommand{\contentsname}{List of Sessions}
4724 % \end{macrocode}
4725 % \end{macro}
4726 % \begin{macro}{\bibname}
4727 % \begin{itemize}
4728 % \item title of the general bibliography (default: `Full Bibliography'):
4729 % \end{itemize}
4730 %^^A\changes{0.1g}{2007/08/05}{add an example of \cmd{\bibnametoc} change}
4731 % \changes{0.4a}{2007/10/01}{remove formatting}
4732 % \changes{0.4a}{2007/10/01}{renamed from \cmd{\procbibname}}
4733 % \begin{macrocode}
4734 %%\renewcommand{\bibname}{General Bibliography}
4735 % \end{macrocode}
4736 % \end{macro}
4737 % \begin{macro}{\indexname}
4738 % \begin{itemize}
4739 % \item title of the index (default: `Index of Authors'):
4740 % \end{itemize}
4741 %^^A\changes{0.1g}{2007/08/05}{add an example of \cmd{\indexnametoc} change}
4742 % \changes{0.4a}{2007/10/01}{remove formatting}
4743 % \changes{0.4a}{2007/10/01}{renamed from \cmd{\procindexname}}
4744 % \begin{macrocode}
4745 %%\renewcommand{\indexname}{List of Authors}
4746 % \end{macrocode}
4747 % \end{macro}
4748 %
4749 %
4750 %^^A------------------------------------------------------------------------
4751 % \subsubsection{Declare paths to pictures, papers, texts...}
4752 %
4753 % \begin{macro}{\PAPERPATH}
4754 % We then define paths to papers (with both PDF papers and related folders to batch re-generate them all) that the \package{example2custom.tex} file uses, \ie{}:
4755 % \color{black!50}
4756 % \begin{macrocode}
4757 \renewcommand{\PAPERPATH}{papers/}
4758 % \end{macrocode}
4759 % \color{black}
4760 % \end{macro}
4761 %
4762 %
4763 %^^A------------------------------------------------------------------------
4764 % \subsubsection{Chapter and section styles}
4765 %
4766 % Chapter and section styles can also be modified (for instance with the \package{titlesec} package)
4767 % to adapt them to your needs. Remember that days appear as parts in the TOC and
4768 % bookmarks, sessions as chapters, and papers as sections.
4769 %
4770 %
4771 %
4772 %^^A \changes{0.4b}{2007/10/12}{changing \cmd{\sc} to \cmd{\scshape}}
4773 %^^A------------------------------------------------------------------------
4774 % \subsubsection{Title/author layout}
4775 %
4776 % 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. You can customize the title font style using the \cmdDescribe{\papertitlestyle} command as in:
4777 % \begin{macrocode}
4778 %%\renewcommand{\papertitlestyle}{\texorpdfstring{}{\scshape}}
4779 % \end{macrocode}
4780 % that defines the paper's title in small capitals. 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 (not in the PDF bookmark):
4781 % \begin{macrocode}
4782 %%\renewcommand{\paperauthorstyle}{\texorpdfstring{, }{\break}}
4783 % \end{macrocode}
4784 %
4785 % In case we want to check each title and author list, that can be useful to specify how the
4786 % overlayed text is formatted.
4787 % \begin{macro}{\confstylechecktitle}
4788 % To do so, we first define the format of the check title:
4789 % \begin{macrocode}
4790 \renewcommand{\confstylechecktitle}{\vspace*{0.3cm} %
4791 \bf \sc \Large \noindent \centerline}
4792 % \end{macrocode}
4793 % \end{macro}
4794 % \begin{macro}{\confstylecheckauthor}
4795 % and then the format of the check author list:
4796 % \begin{macrocode}
4797 \renewcommand{\confstylecheckauthor}{\large \it \noindent \centerline}
4798 % \end{macrocode}
4799 % \end{macro}
4800 %
4801 %^^A------------------------------------------------------------------------
4802 % \subsubsection{Make the index}
4803 %
4804 % The last step of the preamble is to make the index:
4805 % \begin{macrocode}
4806 \makeindex
4807
4808 % \end{macrocode}
4809 %
4810 %
4811 %^^A =================================================================
4812 %^^A Loading
4813 %^^A =================================================================
4814 % \subsection{Front matter: cover page, index and table of contents}
4815 %
4816 % We can now start the document and its front matter by using:
4817 % \color{black!50}
4818 % \begin{macrocode}
4819 %%%=========== PROCEEDINGS ===========
4820 \begin{document}
4821
4822 \frontmatter
4823 % \end{macrocode}
4824 % \color{black}
4825 % Since version 0.5\newvzdseven{}, switching to the front matter does not anymore automatically changes the style of table of contents entries.
4826 % \begin{macro}{\frontmattertocstyle}
4827 % We then explicitely use the optional style:
4828 % \color{black!50}
4829 % \begin{macrocode}
4830 \frontmattertocstyle
4831 % \end{macrocode}
4832 % \color{black}
4833 % \end{macro}
4834 %
4835 % We then force the cover (ie.~the first page of the proceedings) to be numbered `1':
4836 % \color{black!50}
4837 % \begin{macrocode}
4838 \setcounter{page}{1}
4839 % \end{macrocode}
4840 % \color{black}
4841 %
4842 %^^A------------------------------------------------------------------------
4843 % \subsubsection{Cover page}
4844 %
4845 % We now add a bookmark chapter in the front matter:
4846 % \color{black!50}
4847 % \begin{macrocode}
4848 \pdfbookmark[0]{Preamble}{preamble}
4849 % \end{macrocode}
4850 % \color{black}
4851 % 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.
4852 % 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.
4853 %
4854 % We then include the first page and generate its bookmark entry:
4855 % \color{black!50}
4856 % \begin{macrocode}
4857 \pdfbookmark[1]{Cover}{cover}
4858 % \end{macrocode}
4859 % \color{black}
4860 % and produce the first page:
4861 % \color{black!50}
4862 % \begin{macrocode}
4863 \maketitle
4864 \newpage
4865
4866 % \end{macrocode}
4867 % \color{black}
4868 %
4869 %^^A------------------------------------------------------------------------
4870 % \subsubsection{Table of contents}
4871 %
4872 % To ensure next page is numbered and has proper headers/footers, use:
4873 % \color{black!50}
4874 % \begin{macrocode}
4875 \otherpagestyle
4876 % \end{macrocode}
4877 % \color{black}
4878 % We now insert the conference program (table of contents):
4879 % \color{black!50}
4880 % \begin{macrocode}
4881 \tableofcontents
4882
4883 % \end{macrocode}
4884 % \color{black}
4885 % N.B.: the bookmark entries are automatically generated from the table of contents.
4886 %
4887 %^^A =================================================================
4888 %^^A Loading
4889 %^^A =================================================================
4890 % \subsection{Main matter: the papers}
4891 %
4892 % We can then beginning inserting the papers.
4893 % \color{black!50}
4894 % \begin{macrocode}
4895 %%%==== BEGINNING OF PAPERS ====
4896 % \end{macrocode}
4897 % \color{black}
4898 % Before doing so however, we use the following line to set a counter that is used by
4899 % the \Lopt{pdftk} option to properly count page numbers taking into account the preamble.
4900 % \begin{macrocode}
4901 \setcounter{npagespreamble}{\arabic{page}-1} % only useful for the 'pdftk' option
4902 % \end{macrocode}
4903 % \margindanger{}\textbf{Why do we need to do so?} Since page numbers change from roman to arabic,
4904 % page numbers in the document do restart at 1, whereas for the PDF document (when
4905 % opened into a viewer), page numbers are different and go on increasing! Therefore,
4906 % the export of individual papers with \package{pdftk}\footnote{Get \package{pdftk} at: \url{http://www.accesspdf.com/pdftk/}} could not work without this trick, that I still
4907 % did not figure out how to hide it from the user.
4908 %
4909 % \begin{macro}{\mainmatter}
4910 % We now (and only after last line) switch to the main matter and to arabic page numbering:
4911 % \color{black!50}
4912 % \begin{macrocode}
4913 \mainmatter
4914 % \end{macrocode}
4915 % \end{macro}
4916 % \color{black}
4917 % Since version 0.5\newvzdseven{}, switching to the main matter does not anymore automatically changes the style of table of contents entries.
4918 % \begin{macro}{\mainmattertocstyle}
4919 % We then explicitely use the optional style:
4920 % \color{black!50}
4921 % \begin{macrocode}
4922 \mainmattertocstyle
4923 % \end{macrocode}
4924 % \color{black}
4925 % \end{macro}
4926 %
4927 % We then insert the papers, day-by-day and session-by-session.
4928 % \begin{macro}{\procday}
4929 % \margindanger{} Remember that from the bookmark structure point of view, a day appears as a part:
4930 % \end{macro}
4931 % \color{black!50}
4932 % \begin{macrocode}
4933 \procday{Day 1}
4934 % \color{black}
4935 % \begin{macro}{\session}
4936 % a session appears as a chapter:
4937 % \end{macro}
4938 % \color{black!50}
4939 % \begin{macrocode}
4940 \session{Oral Session 1}
4941 % \end{macrocode}
4942 % \color{black}
4943 % \begin{macro}{\procpaper}
4944 % and a paper appears as a section:
4945 % \end{macro}
4946 % \begin{macrocode}
4947 \procpaper[xshift=\LaTeXxShift{}, yshift=\LaTeXyShift{}, switch=45, npages=6,%
4948 % \end{macrocode}
4949 % \color{black!50}
4950 % \begin{macrocode}
4951 title={Templates for One Author},%
4952 author={Alfred Alabama},%
4953 index={\index{Alabama, Alfred}},%
4954 ]{p_001}
4955 % \end{macrocode}
4956 % \color{black}
4957 % \begin{macrocode}
4958 \procpaper[xshift=\LaTeXxShift{}, yshift=\LaTeXyShift{}, switch=21, npages=5,%
4959 % \end{macrocode}
4960 % \color{black!50}
4961 % \begin{macrocode}
4962 title={Templates for One Author with Two Affiliations},%
4963 author={Bob Boogie-Woogie},%
4964 index={\index{Boogie-Woogie, Bob}},%
4965 ]{p_003}
4966
4967 % \end{macrocode}
4968 % \color{black}
4969 % We also give an example of how the older interface to load paper can still be used:
4970 % \begin{macrocode}
4971 %\procinsertpaper{\LaTeXxShift{} \LaTeXyShift}{5}{p_003}%
4972 % {Templates for One Author with Two Affiliations}% paper title
4973 % {Bob Boogie-Woogie}% list of authors
4974 % {\index{Boogie-Woogie, Bob}}% authors index entries
4975 % {Serra:1996:sms,Moorer:2000:AES:audio:millenium,%
4976 % Arfib:1998:DAFx,Haykin:1991:adaptive:filter}%
4977 % {21}{\pdfbookmark[2]{Bob Boogie-Woogie}{21.author1}}
4978 % \end{macrocode}
4979 % \color{black!50}
4980 % \begin{macrocode}
4981 \session{Poster Session 1}
4982 % \end{macrocode}
4983 % \color{black}
4984 % \begin{macrocode}
4985 \procpaper[xshift=\LaTeXxShift{}, yshift=\LaTeXyShift{}, switch=33, npages=4,%
4986 % \end{macrocode}
4987 % \color{black!50}
4988 % \begin{macrocode}
4989 title = {Templates for Two Authors},%
4990 author={Alfred Alabama, Chris Christmas},%
4991 index={\index{Alabama, Alfred}\index{Christmas, Chris}},%
4992 ]{p_005}
4993
4994 \procday{Day 2}
4995 \session{Oral Session 2}
4996 % \end{macrocode}
4997 % \color{black}
4998 % \begin{macrocode}
4999 \procpaper[xshift=\LaTeXxShift{}, yshift=\LaTeXyShift{}, switch=75, npages=6,%
5000 % \end{macrocode}
5001 % \color{black!50}
5002 % \begin{macrocode}
5003 title={Templates for Three Authors},%
5004 author={Bob Boogie-Woogie, Chris Christmas, Don Didon},%
5005 index={\index{Boogie-Woogie, Bob}\index{Christmas, Chris}%
5006 \index{Didon, Don}},%
5007 ]{p_007}
5008 % \end{macrocode}
5009 % \color{black}
5010 % \begin{macrocode}
5011 \procpaper[xshift=\LaTeXxShift{}, yshift=\LaTeXyShift{}, switch=27, npages=7,%
5012 % \end{macrocode}
5013 % \color{black!50}
5014 % \begin{macrocode}
5015 title={Templates f\'or F\`o\"ur Àuthors},%
5016 author={J\o{}hn J\"oe, K\'e\~{n}t K\^{\i}ng, L\`ou L\'ou,%
5017 M\`anfr\'ed J. M\^ost\u{e}k\i},
5018 index={\index{J\"oe, J\o{}hn}\index{K\^{\i}ng, K\'e\~{n}t}%
5019 \index{L\'ou, L\`ou}\index{M\^ost\u{e}k\i, M\`anfr\'ed J.}},
5020 ]{p_009}
5021
5022 %%%==== END OF PAPERS ====
5023 % \end{macrocode}
5024 % \color{black}
5025 %
5026 %^^A =================================================================
5027 %^^A Loading
5028 %^^A =================================================================
5029 % \subsection{Back matter: index of authors}
5030 %
5031 % \begin{macro}{\backmatter}
5032 % After all papers are inserted, we switch to the document back matter (bibliography \& index):
5033 % \color{black!50}
5034 % \begin{macrocode}
5035 \backmatter
5036 % \end{macrocode}
5037 % \color{black}
5038 % Once again, we use the optional style for table of contents entries:
5039 % \color{black!50}
5040 % \begin{macrocode}
5041 \backmattertocstyle
5042 % \end{macrocode}
5043 % \color{black}
5044 % that we may have redefined it in the preamble (it uses the \package{titletoc} package).
5045 % \end{macro}
5046 %
5047 % \begin{macro}{\insertindex}
5048 % We finally insert the index:
5049 % \color{black!50}
5050 % \begin{macrocode}
5051 \insertindex
5052 \end{document}
5053 % \end{macrocode}
5054 % \end{macro}
5055 % \color{black}
5056 % \begin{macrocode}
5057 %</example2custom>
5058 % \end{macrocode}
5059 %
5060 %^^A =================================================================
5061 % \subsection{\LaTeX{} runs}\label{sec:simple:ex2:latex}
5062 %
5063 % To build this example, run the following \LaTeX{} steps:
5064 % \begin{enumerate}
5065 % \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):\\
5066 % \texttt{pdflatex example2custom.tex}
5067 % \item generates the author index:\\
5068 % \texttt{makeindex -s confproc2.ist example2custom.idx}
5069 % \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):\\
5070 % \texttt{pdflatex example2custom.tex}
5071 % \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}):\\
5072 % \texttt{pdflatex example2custom.tex}
5073 % \end{enumerate}
5074 %
5075 %
5076 %
5077 % Next section provide another working example (\file{example3optim.tex}) with several
5078 % tricks to help optimizing the proceedings building process, and that was tested by
5079 % re-generating the DAFx-06 proceedings (several years after the conference). The
5080 % resulting PDFs were identical (appart from the improvements for bookmarks managements),
5081 % but the work line is much easier to use and read. To generate the example proceedings, run
5082 % \file{\filename.ins} through \LaTeX . Better, run the \verb+bash+ script called \file{buildproc} (see
5083 % sec.~\ref{sec:scripts:buildproc}): it will run all the steps for you.
5084 %
5085 %
5086 %^^A =================================================================
5087 %^^A A good example (used afterwards to check if still working for DAFx-06)
5088 %^^A =================================================================
5089 % \newpage
5090 % \section[Example 3 (\file{example3optim.tex} \& others): Full working example]{Example 3 (\file{example3optim.tex} \& others)\\ Full working example}
5091 % \label{sec:example3}
5092 %
5093 % Incremental learning...
5094 % Compared to the previous customization example in sec.~\ref{sec:example2}, this third
5095 % example illustrates a complete and working example with: %the use of some more tools:
5096 % various package option sets depending on the compilation step, the publishing informations,
5097 % a welcome letter, a paper switch to simplify the paper insertion and program changes, and a
5098 % general bibliography. Morevoer, the conference program is directly generated from a \file{.csv}
5099 % file by the \file{generateswitch.pl} Perl script. Tools to ensure that all pages of each PDF are
5100 % inserted without having to run \LaTeX\ on the whole document (quite slow) are provided.
5101 %
5102 %
5103 %
5104 %^^A =================================================================
5105 % \subsection{\file{example3optim.tex}: Main file}
5106 % \label{sec:ex:main}
5107 %
5108 % The main file is named \file{example3optim.tex}. Once again, lines of code that do no
5109 % differ from previous example (ie.~\file{example2custom.tex}) appear in grey color.
5110 % \begin{macrocode}
5111 %<*example3optim>
5112 % \end{macrocode}
5113 % %
5114 %^^A------------------------------------------------------------------------
5115 % \subsubsection{Using the \package{\filename} class}
5116 %
5117 % The class is to be called as would have been the \package{book.cls}.
5118 % For this example, the exhaustive list of option values is given (as well as a comment with
5119 % possible values and default values between squared brackets):
5120 % \begin{macrocode}
5121 \documentclass[letterpaper,% [letterpaper] | a4paper
5122 10pt,% [10pt] | 11pt | 12pt
5123 twoside,% [twoside] | oneside
5124 twosidepapers,% [twosidepapers] | onesidepapers
5125 electronic,% [electronic] | printed
5126 binding=0mm,% [0mm]
5127 papers=final,% empty | draft | [final]
5128 headers=exceptpdf,% none | pdfonly | exceptpdf | [allpages]
5129 bib=backref,% [none] | merge | backref | final
5130 paperselec=all,% [all] | p_001 | paper_2 | 3 ...
5131 onecoltoc,% [onecoltoc] | twocoltoc
5132 tocnum=left,% [left] | right
5133 twocolbib,% [twocolbib] | onecolbib
5134 threecolindex,% [threecolindex] | twocolindex
5135 checktitle=false,% true | [false]
5136 checkauthor=false,% true | [false]
5137 showpapernumber=false,% true | [false]
5138 movepagenumber=false,% true | [false]
5139 showmarginlines=false,% true | [false]
5140 colorheaders=black,% [black] | red | any color!
5141 debug=false,% true | [false]
5142 verbose=false,% true | [false]
5143 pdftk=true,% true | [false]
5144 hyperref={bookmarksdepth=1,bookmarksopen,bookmarksopenlevel=0,%
5145 linkcolor=colorforlink,urlcolor=colorforurl}, % [blue, blue, blue]
5146 geometry={text={175truemm,226truemm},% A4 & letter
5147 inner=0.805in,top=29.15mm,bottom=24.5mm,footskip=9.68mm,voffset=-5mm},%letter
5148 ]{confproc}
5149 %%% inner=0.69in,top=33.9mm,bottom=38mm,footskip=10.4mm,voffset=-4.8mm},%A4
5150 % \end{macrocode}
5151 % 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:
5152 %^^A\changes{0.1g}{2007/08/08}{Example: adding color options}
5153 % \begin{macrocode}
5154 %%\input{exclass}
5155 % \end{macrocode}
5156 %^^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).}
5157 % Inserting options that way allows to switch between class options for various
5158 % \LaTeX\ runs by using 2 files (\file{exclasspre.tex} and \file{exclasslast.tex}). In those
5159 % two files, the class is defined with different options set, and each one is temporary
5160 % renamed as \file{exclass.tex} before being inserted.
5161 %
5162 %
5163 %^^A------------------------------------------------------------------------
5164 % \subsubsection{Loading extra packages}
5165 %
5166 % We define the other packages to be used.
5167 %
5168 % \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.
5169 %^^A \color{red} {\sc Should we use something like \verb+\AtBeginDocument+ to insert the hyperref package in the class definition?} \color{black}
5170 %^^A\changes{0.2e}{2007/09/01}{Layouts: moved to the example}
5171 %
5172 % We use \package{setspace} to change the line spacing in the welcome letter (which text is not as dense as the papers themselves):
5173 % \begin{macrocode}
5174 \usepackage{setspace}
5175 % \end{macrocode}
5176 % The \package{xkeyval} package ensures further compatibility with other packages using it:
5177 % \begin{macrocode}
5178 \usepackage{xkeyval}
5179 % \end{macrocode}
5180 % We then use a bibliography style for the general bibliography\marginBIB:
5181 %^^A\changes{0.5}{\datevzfive}{Pkg: \package{newapave} is now insert only on user request.}
5182 % \begin{macrocode}
5183 \usepackage{newapave}
5184 % \end{macrocode}
5185 % 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):
5186 %^^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).}
5187 % \color{black!50}
5188 % \begin{macrocode}
5189 \usepackage[utf8]{inputenc}
5190 \usepackage[T1]{fontenc}
5191 % \end{macrocode}
5192 % \color{black}
5193 % We change the default \LaTeX{} font to `Times', as it displays better in PDF files:
5194 % \changes{0.4b}{2007/10/12}{Pkg: \package{mathptmx} replaces \package{times}}
5195 % \color{black!50}
5196 % \begin{macrocode}
5197 \usepackage{mathptmx}
5198 % \end{macrocode}
5199 % \color{black}
5200 %^^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.}.
5201 %
5202 % The header of DAFx-06 proceedings had a `$9\textsuperscript{th}$', that requires:
5203 % \changes{0.4b}{2007/10/12}{Pkg: \package{nth} for superscript ordinals}
5204 % \color{black!50}
5205 % \begin{macrocode}
5206 \usepackage[super]{nth}
5207
5208 % \end{macrocode}
5209 % \color{black}
5210 %
5211 %
5212 % \changes{0.4b}{2007/10/12}{Layout: set \cmd{\footskip}}
5213 %^^A------------------------------------------------------------------------
5214 % \subsubsection{Fine tuning the document layout}
5215 %
5216 % To refine the document layout, we may use the \package{layout} package:
5217 % \begin{macrocode}
5218 %\usepackage{layout}
5219 % \end{macrocode}
5220 % as well as \package{layouts} to refine the table of contents layout:
5221 % \begin{macrocode}
5222 %\usepackage{layouts}
5223 % \end{macrocode}
5224 % \margindanger{} \noindent N.B.: When the table of contents layout is inserted too early, it is not properly displayed!
5225 %
5226 %^^A------------------------------------------------------------------------
5227 % \subsubsection{PDF vertical and horizontal shifts}
5228 %
5229 % \changes{0.5}{\datevzfive}{Layout: options for \texttt{geometry} package not directly provided to the class}
5230 % \changes{0.4e}{2007/10/12}{Layout: use the \package{geometry} package}
5231 % We set the default $x$ (left/right) and $y$ (up/down) shifts used to insert PDFs files:
5232 % \color{black!50}
5233 % \begin{macrocode}
5234 \setlength{\LaTeXxShift}{0pt}
5235 \setlength{\LaTeXyShift}{-3mm} %letter
5236 %\setlength{\LaTeXyShift}{1mm} %A4
5237 \setlength{\WordxShift}{10pt}
5238 \setlength{\WordyShift}{-40pt}
5239
5240 % \end{macrocode}
5241 % \color{black}
5242 %^^A The commented line is used with the A4 format (see also sec.~\ref{sec:custom:layout:doc}).
5243 %^^A The values may differ depending if the papers were generated using a \LaTeX\ template
5244 %^^A and a Word template, in the case your templates are not perfectly identical (which is often
5245 %^^A the case). The default values provided by the class are those used for the DAFx-06
5246 %^^A proceedings, and were tested for both letter and A4 format.
5247 %
5248 % \margindanger{}Those global values are used by default for each paper, except if
5249 % \cmd{\procpaper} has other values specified for the option arguments: \Lopt{xshift=...} and \Lopt{yshift=...}.
5250 % \changes{0.5}{\datevzfive}{Layout: \LaTeX{} $x$ and $y$ shift values updated (\texttt{geometry} package)}
5251 %
5252 %^^A------------------------------------------------------------------------
5253 % \subsubsection{Define colors for internal and external hyper-links}
5254 %
5255 %^^A\changes{0.1g}{2007/08/08}{Example: adding example of color definition for links}
5256 %^^A\changes{0.1g}{2007/08/08}{Example: moving color definitions}
5257 % When inserting the document class, we have used home-made colors for the links
5258 % (\Lopt{citecolor}, \Lopt{linkcolor} and \Lopt{urlcolor}); those colors remain to be defined
5259 % in the document preamble before being used:
5260 % \color{black!50}
5261 % \begin{macrocode}
5262 \definecolor{colorforlink}{rgb}{0,0,0.8}
5263 \definecolor{colorforcite}{rgb}{0,0.8,0}
5264 \definecolor{colorforurl}{rgb}{0,0,1}
5265
5266 % \end{macrocode}
5267 % \color{black}
5268 % See section~\ref{sec:custom:colors} for complementary information.
5269 %
5270 %
5271 %^^A------------------------------------------------------------------------
5272 % \subsubsection{Customize PDF metadata}
5273 %
5274 %^^A As \package{\filename} is to be used with pdf\LaTeX{} and generates a PDF, it makes sense
5275 %^^A to customize the PDF metadata, that correspond to the PDF file information that are provided from the
5276 %^^A operating system.
5277 % At least three PDF metadata should be set, given here with their default values.
5278 % To do so, we start by defining generic strings that will be used:
5279 % \begin{macro}{\DAFxname}
5280 % \begin{itemize}
5281 % \item firstly, the conference name
5282 % \end{itemize}
5283 % \color{black!50}
5284 % \begin{macrocode}
5285 \newcommand{\DAFxname}{Proc.~of the \nth{9} %
5286 Int.~Conference on Digital Audio Effects (DAFx-06)}
5287 % \end{macrocode}\color{black}
5288 % \end{macro}
5289 % \begin{macro}{\DAFxdate}
5290 % \begin{itemize}
5291 % \item secondly, the conference date(s):
5292 % \end{itemize}
5293 % \color{black!50}
5294 % \begin{macrocode}
5295 \newcommand{\DAFxdate}{September 18-20, 2006}
5296 % \end{macrocode}\color{black}
5297 % \end{macro}
5298 % \begin{macro}{\DAFxaddress}
5299 % \begin{itemize}
5300 % \item thirdly, the conference address:
5301 % \end{itemize}
5302 % \color{black!50}
5303 % \begin{macrocode}
5304 \newcommand{\DAFxaddress}{Montreal, Canada}
5305
5306 % \end{macrocode}\color{black}
5307 % \end{macro}
5308 %
5309 % We can then define the 3 PDF metadata as follows:
5310 % \begin{macro}{\procpdfauthor}
5311 % \begin{itemize}
5312 % \item use \cmd{\procpdfauthor} to change the PDF author (default: `[Proceedings author/editor]'):
5313 %^^A\changes{0.1f}{2007/08/03}{\cmd{\locpdfauthor} renamed \cmd{\procpdfauthor}}
5314 % \color{black!50}
5315 % \begin{macrocode}
5316 \renewcommand{\procpdfauthor}{Vincent Verfaille, McGill University}
5317 % \end{macrocode}
5318 % \color{black}
5319 % \end{itemize}
5320 % \end{macro}
5321 % \begin{macro}{\procpdftitle}
5322 % \begin{itemize}
5323 % \item use \cmd{\procpdftitle} to change the PDF short title (default: `[Proceedings title]'):
5324 %^^A\changes{0.1f}{2007/08/03}{\cmd{\locpdftitle} renamed \cmd{\procpdftitle}}
5325 % \color{black!50}
5326 % \begin{macrocode}
5327 \renewcommand{\procpdftitle}{DAFx-06 Proceedings - \DAFxaddress}
5328 % \end{macrocode}
5329 % \color{black}
5330 % \end{itemize}
5331 % \end{macro}
5332 % \begin{macro}{\procpdfsubject}
5333 % \begin{itemize}
5334 % \item use \cmd{\procpdfsubject} to change the PDF subject (default: `[Proceedings description]'):
5335 %^^A\changes{0.1f}{2007/08/03}{\cmd{\locpdfsubject} renamed \cmd{\procpdfsubject}}
5336 % \color{black!50}
5337 % \begin{macrocode}
5338 \renewcommand{\procpdfsubject}{Conference proceedings}
5339
5340 % \end{macrocode}
5341 % \color{black}
5342 % \end{itemize}
5343 % \end{macro}
5344 % 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.\\
5345 % \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.\\
5346 % N.B.: an alternative way to change the PDF metadata consist in using the \cmdDescribe{\hypersetup} command (see the \package{hyperref} package).
5347 %
5348 %
5349 % \changes{0.4b}{2007/10/12}{Pkg: \package{nth} for superscript ordinals}
5350 %^^A------------------------------------------------------------------------
5351 % \subsubsection{Header and footer}
5352 %
5353 % 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:
5354 %^^A\changes{0.2e}{2007/09/01}{\cmd{\loclhead} renamed \cmd{\proclhead}}
5355 %\changes{0.5}{\datevzfive}{added \cmd{\procchead} command}
5356 % \color{black!50}
5357 % \begin{macrocode}
5358 \renewcommand{\procchead}{} %
5359 \renewcommand{\proclhead}{{\em \small \DAFxname, \DAFxaddress, \DAFxdate}}
5360 % \end{macrocode}
5361 % \color{black}
5362 % as well as \cmdDescribe{\proccfoot} for the central footers (the page number being centered by default):
5363 %\changes{0.4b}{2007/10/12}{uses \cmd{\vspace} instead of \cmd{\vskip}}
5364 %\changes{0.5}{\datevzfive}{added \cmd{\proccfoot} length}
5365 % \color{black!50}
5366 % \begin{macrocode}
5367 \renewcommand{\proccfoot}{{\small DAFX-\thepage}}
5368 % \end{macrocode}
5369 % \color{black}
5370 % The \cmdDescribe{\procfootvskip} length adjusts the footer vertical position:
5371 % \color{black!50}
5372 % \begin{macrocode}
5373 \setlength{\procfootvskip}{1.2mm}
5374 % \end{macrocode}
5375 % \color{black}
5376 % \begin{macro}{\procoptfootvskip}
5377 % When checking the page numbering for papers which template already includes
5378 % the page number, we may change the amount of vertical shift applied to move down
5379 % by a few millimeters (default: 3mm) the footer when using the \Lopt{movepagenumber}
5380 % option. Then, use the \cmd{\procoptfootvskip} command:
5381 % \begin{macrocode}
5382 \setlength{\procoptfootvskip}{4mm}
5383
5384 % \end{macrocode}
5385 % As soon as you remove the \Lopt{movepagenumber} option, the footer comes back to its normal position.
5386 % \end{macro}
5387 %
5388 %^^A------------------------------------------------------------------------
5389 % \subsubsection{Define front page and title commands}
5390 %
5391 % To generate the front page with \cmd{\maketitle}, we redefine usual \LaTeX\ commands:
5392 % \begin{macro}{\author}
5393 % \begin{itemize}
5394 % \item the proceedings' author/editor:
5395 % \end{itemize}
5396 % \color{black!50}
5397 % \begin{macrocode}
5398 \author{\procpdfauthor}
5399 % \end{macrocode}
5400 % \color{black}
5401 % \end{macro}
5402 % \begin{macro}{\title}
5403 % \begin{itemize}
5404 % \item the proceedings' title:
5405 % \end{itemize}
5406 % \changes{0.4b}{2007/10/12}{Pkg: \package{nth} for superscript ordinals}
5407 % \color{black!50}
5408 % \begin{macrocode}
5409 \title{\DAFxname\\ \DAFxaddress}
5410 % \end{macrocode}
5411 % \color{black}
5412 % \end{macro}
5413 % \begin{macro}{\date}
5414 % \begin{itemize}
5415 % \item the proceedings' date:
5416 % \end{itemize}
5417 % \color{black!50}
5418 % \begin{macrocode}
5419 \date{\DAFxdate}
5420
5421 % \end{macrocode}
5422 % \color{black}
5423 % \end{macro}
5424 % using the \cmd{\procpdfauthor} and \cmd{\procpdftitle} commands previously defined.
5425 %
5426 %
5427 %^^A------------------------------------------------------------------------
5428 % \subsubsection{Special section titles (toc, index, biblio)}
5429 %
5430 % To change special section titles, redefine the \LaTeX{} commands already modified by \package{confproc}:
5431 % \begin{macro}{\contentsname}
5432 % \begin{itemize}
5433 % \item title of the table of contents (default: `Conference Program'):
5434 % \end{itemize}
5435 % \color{black!50}
5436 % \begin{macrocode}
5437 \renewcommand{\contentsname}{Day-by-Day Conference Program}
5438 % \end{macrocode}
5439 % \color{black}
5440 % \end{macro}
5441 % \begin{macro}{\bibname}
5442 % \begin{itemize}
5443 % \item title of the general bibliography (default: `Full Bibliography'):
5444 % \end{itemize}
5445 %^^A\changes{0.1g}{2007/08/05}{add an example of \cmd{\bibnametoc} change}
5446 % \changes{0.4a}{2007/10/01}{remove formatting}
5447 % \changes{0.4a}{2007/10/01}{renamed from \cmd{\procbibname}}
5448 % \color{black!50}
5449 % \begin{macrocode}
5450 \renewcommand{\bibname}{General Bibliography}
5451 % \end{macrocode}
5452 % \color{black}
5453 % \end{macro}
5454 % \begin{macro}{\indexname}
5455 % \begin{itemize}
5456 % \item title of the index (default: `Index of Authors'):
5457 % \end{itemize}
5458 %^^A\changes{0.1g}{2007/08/05}{add an example of \cmd{\indexnametoc} change}
5459 % \changes{0.4a}{2007/10/01}{remove formatting}
5460 % \changes{0.4a}{2007/10/01}{renamed from \cmd{\procindexname}}
5461 % \color{black!50}
5462 % \begin{macrocode}
5463 \renewcommand{\indexname}{List of Authors}
5464 % \end{macrocode}
5465 % \color{black}
5466 % \end{macro}
5467 %
5468 %
5469 %^^A------------------------------------------------------------------------
5470 % \subsubsection{Declare paths to pictures, papers, texts...}
5471 %
5472 % We then define paths to different resources that the \package{example3optim.tex} file uses, \ie{}:
5473 % \begin{macro}{\PAPERPATH}
5474 % \begin{itemize}
5475 % \item papers (containing both PDF papers and related folders to re-generate them):
5476 % \end{itemize}
5477 % \color{black!50}
5478 % \begin{macrocode}
5479 \renewcommand{\PAPERPATH}{papers/}
5480 % \end{macrocode}
5481 % \color{black}
5482 % \end{macro}
5483 % \begin{macro}{\PICPATH}
5484 % \begin{itemize}
5485 % \item pictures (\eg{} logos used in your first page and welcome letters):
5486 % \end{itemize}
5487 % \begin{macrocode}
5488 \newcommand{\PICTPATH}{pictures/}
5489 % \end{macrocode}
5490 % \end{macro}
5491 % \begin{macro}{\TEXTPATH}
5492 % \begin{itemize}
5493 % \item texts (\eg{} publishing informations, welcome letters, the paper switch):
5494 % \end{itemize}
5495 % \begin{macrocode}
5496 \newcommand{\TEXTPATH}{}
5497 % \end{macrocode}
5498 % \end{macro}
5499 % \begin{macro}{\BIBPATH}
5500 % \begin{itemize}
5501 % \item bibliographies (\eg{} 3 files as explained in sec.~\ref{sec:general:bib}):
5502 % \end{itemize}
5503 % \begin{macrocode}
5504 \newcommand{\BIBPATH}{}
5505 % \end{macrocode}
5506 % \end{macro}
5507 %
5508 %
5509 %^^A------------------------------------------------------------------------
5510 % \subsubsection{Declare bibliographic files}
5511 %
5512 % \begin{macro}{\procbibfile}
5513 % We now define the file name of the main bibliography:
5514 %^^A at the beginning, providing all customization commands at the same place:
5515 % \begin{macrocode}
5516 \newcommand{\procbibfile}{\BIBPATH exbiblio}
5517 % \end{macrocode}
5518 % Several \texttt{.bib} files may be used to build the general bibliography (see sec.~\ref{sec:general:bib}).
5519 %^^A for instance one for common bibliography items, one with the other bibliography items and another one with common strings for journals, conferences, etc.
5520 % \end{macro}
5521 %
5522 %
5523 %^^A------------------------------------------------------------------------
5524 % \subsubsection{Chapter and section styles}
5525 %
5526 % Chapter and section styles can also be modified (for instance with the \package{titletoc} package)
5527 % to adapt them to your needs. Remember that days appear as parts in the TOC and
5528 % bookmarks, sessions as chapters, and papers as sections. Here is an
5529 % example taken from the ICMC 2009 proceedings, where a TOC with left-aligned numbers
5530 % is added with horizontal lines of different thickness before days and sessions.
5531 % To do so, we first define our horizontal rulers:
5532 % \begin{macrocode}
5533 \newcommand{\myaddhruletotoc}{\vspace*{0.1cm}%
5534 \noindent\protect\hrulefill\par\vspace*{-0.15cm}}
5535 \newcommand{\myaddthickhruletotoc}{\vspace*{0.5cm}%
5536 \noindent\protect\hrule height 0.6ex \hfill\par\vspace*{0.1cm}}
5537 % \end{macrocode}
5538 % We then redefine the \cmdDescribe{\procday} command to add an empty line in the TOC before each day:
5539 % \begin{macrocode}
5540 \renewcommand{\procday}[1]{%
5541 \phantomsection%
5542 \addcontentsline{toc}{part}{#1}} % \centerline{#1}
5543 % \end{macrocode}
5544 % as well as the \cmdDescribe{\session} command to add an empty line in the TOC before each session:
5545 % \begin{macrocode}
5546 \renewcommand{\session}[1]{%
5547 \phantomsection%
5548 \addcontentsline{toc}{chapter}{#1}}
5549 % \end{macrocode}
5550 % \margindanger{}We can finally use the \package{titletoc} package and syntax to modify the TOC layout by
5551 % adding the horizontal rulers. Note that given the way it is redefined, it will
5552 % work properly for both left-aligned and right-aligned TOC numbers. Here is the definition for the main matter (\cmdDescribe{\mainmattertocstyle}):
5553 % \begin{macrocode}
5554 %% idem for left/right numbering
5555 \renewcommand{\mainmattertocstyle}{
5556 \titlecontents{part}[0pt]%
5557 {\addvspace{3mm}}%
5558 {\myaddthickhruletotoc\Large\bfseries}%
5559 {\myaddthickhruletotoc\Large\bfseries}%
5560 {}%
5561 [\addvspace{0.5mm}]%
5562 \titlecontents{chapter}[0pt]%
5563 {\addvspace{2mm}}%
5564 {\myaddhruletotoc\large\bfseries\itshape}%
5565 {\myaddhruletotoc\large\bfseries\itshape}%
5566 {}%
5567 [\addvspace{0.5mm}]%
5568 }
5569 % \end{macrocode}
5570 %
5571 %
5572 %
5573 %^^A \changes{0.4b}{2007/10/12}{Format: changing \cmd{\sc} to \cmd{\scshape}}
5574 %^^A------------------------------------------------------------------------
5575 % \subsubsection{Title/author layout}\label{sec:custom:title:author}
5576 %
5577 % The \DescribeMacro{\texorpdfstring}\cmd{\texorpdfstring} command allows for a different
5578 % text in LaTeX and for the PDF (which is good for having different bookmark titles and table
5579 % of contents entries). It is then used by default to add a line break between the paper title
5580 % and the authors' names in the table of contents. We customize the title font style using
5581 % the \cmdDescribe{\papertitlestyle} command as in:
5582 % \color{black!50}
5583 % \begin{macrocode}
5584 %%\renewcommand{\papertitlestyle}{}
5585 % \end{macrocode}
5586 % \color{black}
5587 % \begin{macrocode}
5588 \renewcommand{\papertitlestyle}{\texorpdfstring{}{\scshape}}
5589 % \end{macrocode}
5590 % that defines the paper's title in small capitals (default with the comment). The
5591 % \cmdDescribe{\paperauthorstyle} command is used to customize the author font style. For
5592 % instance, to replace the line break (between paper title and list of authors, in the table of
5593 % contents) by a comma in the table of contents only (and not in the PDF bookmark) and have
5594 % names right-flushed\footnote{\noindent Such option usually works well for short titles and author list:\\
5595 % My short title, \hfill FirstName1 LastName1, FirstName2 LastName2\\
5596 % but longer titles/author list may unfortunately give a different result, for instance:\\
5597 % My very long title that I like and do not want to shorten, \hfill FirstName1 LastName1,
5598 % FirstName2 LastName2, FirstName3 LastName3, FirstName4 LastName4}:
5599 % \color{black!50}
5600 % \begin{macrocode}
5601 %%\renewcommand{\paperauthorstyle}{\texorpdfstring{\newline\itshape}{\break}}
5602 % \end{macrocode}
5603 % \color{black}
5604 % \begin{macrocode}
5605 \renewcommand{\paperauthorstyle}{\texorpdfstring{, \hfill}{\break}}
5606 % \end{macrocode}
5607 % Again, the default appears with the comment sign.
5608 %
5609 % Consider now that we prefer to invert the paper title and the author list positions.
5610 % We first redefine \cmdDescribe{\proctoctitleauthor}, that defines how the paper title
5611 % and author list are ordered and formatted in the TOC:
5612 % \begin{macrocode}
5613 \renewcommand{\proctoctitleauthor}[2]{%
5614 \texorpdfstring{{\paperauthorstyle #2}{\papertitlestyle #1}}%
5615 {{\papertitlestyle #1}}}
5616 % \end{macrocode}
5617 % We then redefine the formatting of the author list (italic) and paper title (boldface), and also which of the
5618 % two commands is responsible for the line break (before the paper title):
5619 % \begin{macrocode}
5620 \renewcommand{\paperauthorstyle}{\texorpdfstring{\itshape}{}}
5621 \renewcommand{\papertitlestyle}{\texorpdfstring{\newline}{\break}}
5622 % \end{macrocode}
5623 %
5624 % \begin{macro}{\confstylechecktitle}
5625 % In the case we want to check each title and author list, that can be useful to specify how the
5626 % overlayed text is formatted.
5627 % To do so, we define the format for the check title:
5628 % \color{black!50}
5629 % \begin{macrocode}
5630 \renewcommand{\confstylechecktitle}{\vspace*{0.3cm} %
5631 \bf \sc \Large \noindent \centerline}
5632 % \end{macrocode}
5633 % \end{macro}
5634 % \begin{macro}{\confstylecheckauthor}
5635 % \color{black}
5636 % and for the check author list:
5637 % \color{black!50}
5638 % \begin{macrocode}
5639 \renewcommand{\confstylecheckauthor}{\large \it \noindent \centerline}
5640 % \end{macrocode}
5641 % \color{black}
5642 % \end{macro}
5643 %
5644 %^^A------------------------------------------------------------------------
5645 % \subsubsection{Make the index}
5646 %
5647 % The last step of the preamble is to build the index:
5648 % \color{black!50}
5649 % \begin{macrocode}
5650 \makeindex
5651
5652 % \end{macrocode}
5653 % \color{black}
5654 %
5655 %
5656 %^^A------------------------------------------------------------------------
5657 % \subsubsection{Start the document: front matter (cover page and table of contents)}
5658 %
5659 % We can now start the document and its front matter by using:
5660 % \color{black!50}
5661 % \begin{macrocode}
5662 %%%=========== PROCEEDINGS ===========
5663 \begin{document}
5664
5665 \frontmatter
5666 % \end{macrocode}
5667 % \color{black}
5668 %
5669 %^^A------------------------------------------------------------------------
5670 % \subsubsection{Display the document layout}
5671 %
5672 % To check the document layout (thanks to the \package{layout} package), uncomment:
5673 % \begin{macrocode}
5674 %%\layout
5675 % \end{macrocode}
5676 %^^A\changes{0.2e}{2007/09/01}{Layouts: moved to the example}
5677 % To specifically check the table of contents layout (thanks to the \package{layouts} package), uncomment:
5678 % \begin{macrocode}
5679 %%\begin{figure}
5680 %% \setlayoutscale{0.8} \tocdiagram
5681 %% \caption{Table of Contents entry parameters} \label{fig:tocp}
5682 %%\end{figure}
5683 %%\begin{figure}
5684 %% \setlayoutscale{0.8} \currenttoc \tocdesign
5685 %% \caption{Typical Table of Contents entry for this document}
5686 %% \label{fig:thistoc}
5687 %%\end{figure}
5688 % \end{macrocode}
5689 % 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).
5690 % \begin{macro}{\clearsingleordoublepage}
5691 % To go to the next page (right-opening page in two-side mode), use:
5692 % \begin{macrocode}
5693 %%\clearsingleordoublepage
5694 % \end{macrocode}
5695 % \end{macro}
5696 % We then force the cover (ie.~the first page of the proceedings) to be numbered `1':
5697 % \color{black!50}
5698 % \begin{macrocode}
5699 \setcounter{page}{1}
5700 % \end{macrocode}
5701 % \color{black}
5702 %
5703 %
5704 %^^A------------------------------------------------------------------------
5705 % \subsubsection{Cover page}
5706 %
5707 % We now add a bookmark chapter in the front matter:
5708 % \color{black!50}
5709 % \begin{macrocode}
5710 \pdfbookmark[0]{Preamble}{preamble}
5711 % \end{macrocode}
5712 % \color{black}
5713 % 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.
5714 % 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.
5715 %
5716 % We then include the first page and generate its bookmark entry:
5717 % \color{black!50}
5718 % \begin{macrocode}
5719 \pdfbookmark[1]{Cover}{cover}
5720 % \end{macrocode}
5721 % \color{black}
5722 % and produce the first page:
5723 % \color{black!50}
5724 % \begin{macrocode}
5725 \maketitle
5726 % \end{macrocode}
5727 % \color{black}
5728 % An alternative to the \cmd{\maketitle} command consists in inserting the first page as a PDF 1-page document generated with another software:
5729 % \begin{macrocode}
5730 %%\includepdf[noautoscale,pages=1,link]{\PICTPATH ex_1stpage.pdf}
5731 % \end{macrocode}
5732 %
5733 %
5734 %^^A------------------------------------------------------------------------
5735 % \subsubsection{Customize TOC formatting}
5736 %
5737 % We can now change some of the TOC formatting (centered, lower and small capitals TOC name) with the following hack:
5738 % \begin{itemize}
5739 % \item[(i)] add a 1cm vertical space:
5740 % \end{itemize}
5741 % \begin{macrocode}
5742 \addtocontents{toc}{\vskip 1cm}
5743 % \end{macrocode}
5744 % \begin{itemize}
5745 % \item[(ii)] add the TOC name in the text of the TOC contents, with the formatting we want:
5746 % \end{itemize}
5747 % \begin{macrocode}
5748 \addtocontents{toc}{\centerline{\huge\textsc{Conference Program}}}
5749 % \end{macrocode}
5750 % \begin{itemize}
5751 % \item[(iii)] remove the TOC name in the TOC only (not in the PDF bookmarks):
5752 % \end{itemize}
5753 % \begin{macrocode}
5754 \renewcommand{\contentsname}{\texorpdfstring{}{Conference Program}}
5755 % \end{macrocode}
5756 %
5757 %^^A------------------------------------------------------------------------
5758 % \subsubsection{Publishing informations}
5759 %
5760 % Publishing informations are then given on page 2, inside the cover:
5761 % \begin{macrocode}
5762 \newpage
5763 \vspace*{1.7cm}
5764 \pdfbookmark[1]{Publishing informations}{publishing}
5765 % \end{macrocode}
5766 % with no header nor footer on this page:
5767 % \begin{macrocode}
5768 \thispagestyle{empty}
5769 % \end{macrocode}
5770 % We then provide the publishing information itself:
5771 % \begin{macrocode}
5772 \noindent {\bf Published by:}\\ Laboratory Name\\ Department name\\
5773 School Name\\ University Name\\
5774 \url{http://www.conferencesite.com}\\
5775 % \end{macrocode}
5776 % We also indicate the ISBN number:
5777 % \begin{macrocode}
5778 \vspace*{0.15cm}\newline
5779 \noindent {\bf ISBN: X-XXXX-XXXXXX}\\
5780 % \end{macrocode}
5781 % and the credits:
5782 % \begin{macrocode}
5783 \vspace*{0.35cm}\newline
5784 \noindent {\bf Credits:}\\
5785 Cover design: Firstname Lastname\\
5786 Logo photo: Firstname Lastname\\
5787 \LaTeX{} editor: Firstname Lastname\\
5788 % \end{macrocode}
5789 % 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 :-).}.
5790 % \begin{macrocode}
5791 using \LaTeX's `confproc' package, version 0.8 (optional: by V. Verfaille)\\
5792 % \end{macrocode}
5793 % We then indicate where and when the proceedings were printed:
5794 % \begin{macrocode}
5795 \vspace*{0.35cm}\newline
5796 \noindent Printed in City by Print-Company --- Month Year
5797 % \end{macrocode}
5798 %
5799 %
5800 %^^A------------------------------------------------------------------------
5801 % \subsubsection{Welcome letters}
5802 %
5803 % To ensure next page is numbered and has proper headers/footers, use:
5804 % \color{black!50}
5805 % \begin{macrocode}
5806 \otherpagestyle
5807 % \end{macrocode}
5808 % \color{black}
5809 % 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.}:
5810 % \begin{macrocode}
5811 %%%-- Welcome letters
5812 \clearsingleordoublepage
5813 \vspace*{0.6cm}
5814 \thisotherpagestyle
5815 % \end{macrocode}
5816 % We create the bookmark entry by hand (so that you can remove it):
5817 % \begin{macrocode}
5818 \pdfbookmark[1]{Welcome from Firstname Lastname}{welcome}
5819 % \end{macrocode}
5820 % and the corresponding section (and table of contents entry):
5821 % \begin{macrocode}
5822 \section*{Welcome from Firstname Lastname, Conference Chair}
5823 % \end{macrocode}
5824 % Depending on the text length, you may use either 1.5 line spacing:
5825 % \begin{macrocode}
5826 \vspace*{1.1cm}
5827 \onehalfspace
5828 \begin{center}
5829 \begin{minipage}[h]{14cm}
5830 Text of the welcome letter, with 1.5 lines spacing, blah blah...
5831 Text of the welcome letter, with 1.5 lines spacing, blah blah...
5832 Text of the welcome letter, with 1.5 lines spacing, blah blah...
5833 Text of the welcome letter, with 1.5 lines spacing, blah blah...
5834 \end{minipage}
5835 \end{center}
5836 % \end{macrocode}
5837 % or double line spacing (both are using the \package{setspace} style):
5838 % \begin{macrocode}
5839 \doublespace
5840 \begin{center}
5841 \begin{minipage}[h]{14cm}
5842 Text of the welcome letter, with 2 lines spacing, blah blah...
5843 Text of the welcome letter, with 2 lines spacing, blah blah...
5844 Text of the welcome letter, with 2 lines spacing, blah blah...
5845 Text of the welcome letter, with 2 lines spacing, blah blah...
5846 \end{minipage}
5847 \end{center}
5848 \singlespace
5849 % \end{macrocode}
5850 %
5851 %^^A------------------------------------------------------------------------
5852 % \subsubsection{Table of contents}
5853 %
5854 % We now insert the conference program (table of contents):
5855 % \color{black!50}
5856 % \begin{macrocode}
5857 \tableofcontents
5858
5859 % \end{macrocode}
5860 % \color{black}
5861 % N.B.: the bookmark entries are automatically generated from the table of contents.
5862 %
5863 %^^A------------------------------------------------------------------------
5864 % \subsubsection{Main matter: the papers}
5865 %
5866 % We can then beginning inserting the papers.
5867 % \color{black!50}
5868 % \begin{macrocode}
5869 %%%==== BEGINNING OF PAPERS ====
5870 % \end{macrocode}
5871 % \color{black}
5872 % Before doing so however, we use the following line to set a counter that is used by
5873 % the \Lopt{pdftk} option to properly count page numbers taking into account the preamble.
5874 % \begin{macrocode}
5875 \setcounter{npagespreamble}{\arabic{page}-1} % only useful for the 'pdftk' option
5876 % \end{macrocode}
5877 % \margindanger{}\textbf{Why do we need to do so?} Since page numbers change from roman to arabic,
5878 % page numbers in the document do restart at 1, whereas for the PDF document (when
5879 % opened into a viewer), page numbers are different and go on increasing! Therefore,
5880 % 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
5881 % did not figure out how to hide from the user.
5882 %
5883 % \begin{macro}{\mainmatter}
5884 % We now (and only after last line) switch to the main matter and to arabic page numbering:
5885 % \color{black!50}
5886 % \begin{macrocode}
5887 \mainmatter
5888 % \end{macrocode}
5889 % \color{black}
5890 % \end{macro}
5891 % Since version 0.5\newvzdseven{}, switching to the main matter does not anymore automatically changes the style of table of contents entries.
5892 % \begin{macro}{\mainmattertocstyle}
5893 % We then explicitely use the optional style:
5894 % \color{black!50}
5895 % \begin{macrocode}
5896 \mainmattertocstyle
5897 % \end{macrocode}
5898 % \color{black}
5899 % \end{macro}
5900 % and can even redefine it in the preamble (it uses the \package{titletoc} package).
5901 % Then, we include the file with all papers' information organized with a switch:
5902 % \begin{macrocode}
5903 \input{\TEXTPATH expapersswitch}
5904 % \end{macrocode}
5905 %
5906 % We then insert the papers, day-by-day and session-by-session.
5907 % \begin{macro}{\procday}
5908 % \margindanger{} Remember that from the bookmark structure point of view, a day appears as a part:
5909 % \end{macro}
5910 % \color{black!50}
5911 % \begin{macrocode}
5912 \procday{Day 1}
5913 % \end{macrocode}
5914 % \color{black}
5915 % \begin{macro}{\session}
5916 % a session appears as a chapter:
5917 % \end{macro}
5918 % \color{black!50}
5919 % \begin{macrocode}
5920 \session{Oral Session 1}
5921 % \end{macrocode}
5922 % \color{black}
5923 % \begin{macro}{\paperid}
5924 % and a paper appears as a section.
5925 % 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:
5926 % \end{macro}
5927 % \begin{macrocode}
5928 \paperid{45}{p_001}
5929 \paperid{21}{p_003}
5930 % \end{macrocode}
5931 % We also insert a poster session with one paper:
5932 % \color{black!50}
5933 % \begin{macrocode}
5934 \session{Poster Session 1}
5935 % \end{macrocode}
5936 % \color{black}
5937 % \begin{macrocode}
5938 \paperid{33}{p_005}
5939 % \end{macrocode}
5940 % and a second oral presentation session with two more papers:
5941 % \color{black!50}
5942 % \begin{macrocode}
5943 \procday{Day 2}
5944 \session{Oral Session 2}
5945 % \end{macrocode}
5946 % \color{black}
5947 % \begin{macrocode}
5948 \paperid{75}{p_007}
5949 \paperid{27}{p_009}
5950 % \end{macrocode}
5951 % \color{black!50}
5952 % \begin{macrocode}
5953
5954 %%%==== END OF PAPERS ====
5955 % \end{macrocode}
5956 % \color{black}
5957 %
5958 %
5959 %^^A =================================================================
5960 %^^A Loading
5961 %^^A =================================================================
5962 % \subsubsection{Back matter}
5963 %
5964 % \begin{macro}{\backmatter}
5965 % After all papers are inserted, we switch to the document back matter (bibliography \& index):
5966 % \color{black!50}
5967 % \begin{macrocode}
5968 \backmatter
5969 % \end{macrocode}
5970 % \color{black}
5971 % Once again, we use the optional style for table of contents entries:
5972 % \color{black!50}
5973 % \begin{macrocode}
5974 \backmattertocstyle
5975 % \end{macrocode}
5976 % \color{black}
5977 % that we may have redefine it in the preamble (it uses the \package{titletoc} package).
5978 % \end{macro}
5979 %
5980 %^^A------------------------------------------------------------------------
5981 % \subsubsection{General bibliography}
5982 %
5983 % The general bibliography is inserted with the following style:
5984 % \begin{macrocode}
5985 \bibliographystyle{newapave}
5986 % \end{macrocode}
5987 % 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.
5988 % If you prefer the \package{newapa} style (or any other style), simply replace this last line by:
5989 % \begin{macrocode}
5990 %%\bibliographystyle{newapa}
5991 % \end{macrocode}
5992 % and comment the line that inserts the \file{newapave} style.
5993 %
5994 % The bibliography is then inserted:
5995 % \begin{macrocode}
5996 {\footnotesize\bibliography{\procbibfile}}
5997 % \end{macrocode}
5998 % 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.
5999 %
6000 %^^A------------------------------------------------------------------------
6001 % \subsubsection{Index of authors}
6002 %
6003 % \begin{macro}{\insertindex}
6004 % We finally insert the index:
6005 % \end{macro}
6006 % \color{black!50}
6007 % \begin{macrocode}
6008 \insertindex
6009 \end{document}
6010 % \end{macrocode}
6011 % \color{black}
6012 % \begin{macrocode}
6013 %</example3optim>
6014 % \end{macrocode}
6015 %
6016 %^^A\changes{0.1f}{2007/08/02}{merging welcome and publishing in the example}
6017 %
6018 %
6019 %
6020 %^^A =================================================================
6021 % \subsection{\file{expapersswitch.tex}: Paper switch!}
6022 % \label{sec:ex:paper:switch}
6023 %
6024 % Let us now take a look at the paper switch, which is central to this version of the proceedings.
6025 % It contains a switch to proceedings papers, allowing to work on the document without needing
6026 % to know yet the final order of papers (which is useful when working in parallel on the document
6027 % and on the conference program).
6028 %
6029 %
6030 %^^A\changes{0.1}{2007/08/01}{File: create \file{expapersswitch.tex}}
6031 %^^A\changes{0.1f}{2007/08/03}{Cmds: renaming loc<Title|Author|...> as paper<title|author|...>}
6032 %^^A =================================================================
6033 %^^A Here is the creation of the expapersswitch.tex file, part of the example.
6034 %^^A It is written on first LaTeX run if it does not already exist
6035 %^^A =================================================================
6036 %
6037 % \newvzdseven{}Version 0.7 of \package{\filename} redefines the paper insertion interface
6038 % with \cmdDescribe{\procpaper}, that uses key-values options and thus clarifies the \LaTeX{} code.
6039 % We define the \cmd{\paperid} command:
6040 % \begin{macro}{\paperid}
6041 % \begin{macrocode}
6042 %<*expapersswitch>
6043 \newcommand{\paperid}[2]{
6044 % \end{macrocode}
6045 % \end{macro}
6046 % \begin{macro}{\paperswitch}
6047 % Inside the switch, the \cmd{\paperswitch} command is set to the paper reference:
6048 % \end{macro}
6049 % \begin{macrocode}
6050 \renewcommand{\paperswitch}{#1}
6051 % \end{macrocode}
6052 %
6053 % Papers can still be inserted using the pre-version 0.5 \cmd{\procinsertpaper} command
6054 % (see next section), but it is strongly recommanded to forget it and use the new interface
6055 % of the \cmd{\procpaper} command (version 0.5 and above).
6056 %
6057 %^^A------------------------------------------------------------------------
6058 % \subsubsection{First and old way: pre-version 0.5 interface}
6059 %
6060 % To insert the first paper (ID=45) with the pre-version 0.5 command (compatibility check),
6061 % we first define commands to help making this old code readible:
6062 % \begin{macrocode}
6063 %=========== PAPER ID = 45 ===========
6064 \ifnum\paperswitch=45 {
6065 \newcommand{\papertitle}{Templates for One Author}
6066 \newcommand{\paperauthors}{Alfred Alabama}
6067 \newcommand{\paperindex}{\index{Alabama, Alfred}}
6068 \newcommand{\paperref}{\paperswitch}
6069 \newcommand{\paperpagenum}{6}
6070 \newcommand{\papercite}{Serra:1996:sms,%
6071 Moorer:2000:AES:audio:millenium,Arfib:1998:DAFx,%
6072 Mitra:Kaiser:1993:DSP:handbook}
6073 % \end{macrocode}
6074 % We then use the old \cmdDescribe{\procinsertpaper} command to insert papers\footnote{This
6075 % command has 9 arguments that must be used in this exact order:
6076 % (i) X and Y shifts (with a space in between, as in `{10 12}');
6077 % (ii) the number of pages;
6078 % (iii) the paper reference;
6079 % (iv) the title;
6080 % (v) the list of authors;
6081 % (vi) the index entries;
6082 % (vii) the citations for the general bibliography;
6083 % (viii) the name of the PDF file to insert;
6084 % (ix) the bookmark entries for the authors. Hopefully, \person{Andreas Matthias}
6085 % suggested me to use key-values options, and it is no more useful to do it this old way!}:
6086 % \begin{macrocode}
6087 \procinsertpaper{\LaTeXxShift{} \LaTeXyShift}{\paperpagenum}%
6088 {\paperref}{\papertitle}{\paperauthors}{\paperindex}{\papercite}%
6089 {#2}{\pdfbookmark[2]{Alfred Alabama}{#2.author1}}}
6090 \fi
6091 % \end{macrocode}
6092 % As we can see, it still works; this is however too ugly. Why would you still want to use
6093 % such an bad interface to set arguments?
6094 %
6095 %^^A------------------------------------------------------------------------
6096 % \subsubsection{Second and preferred way: shorter and more readible}
6097 %
6098 % Thanks to the new \cmdDescribe{\procpaper} command, it is much simpler and more
6099 % \newvzdseven{}readible to insert papers: except the paper file name, the other arguments are
6100 % optional, and their name is clear enough! The lines of next code correspond to what is
6101 % generated by the \file{generateswitch.pl} Perl script (see sec.~\ref{sec:scripts:perl}), which
6102 % converts the \file{.csv} data into \LaTeX{} code to insert in this current file:
6103 %
6104 % \begin{macrocode}
6105 \ifnum\paperswitch=21
6106 \procpaper[xshift=\LaTeXxShift{}, yshift=\LaTeXyShift{}, npages=5, switch=21,%
6107 title={Templates for One Author with Two Affiliations},%
6108 author={Bob Boogie-Woogie},%
6109 index={\index{Boogie-Woogie, Bob}},%
6110 cite={Serra:1996:sms,Moorer:2000:AES:audio:millenium,Arfib:1998:DAFx,%
6111 Haykin:1991:adaptive:filter},%
6112 bookmark={\pdfbookmark[2]{Bob Boogie-Woogie}{#2.author1}}%
6113 ]{#2}
6114 \fi
6115
6116 \ifnum\paperswitch=27
6117 \procpaper[xshift=\LaTeXxShift{}, yshift=\LaTeXyShift{}, npages=7, switch=27,%
6118 title={Templates f\'or F\`o\"ur Àuthors},%
6119 author={J\o{}hn J\"oe, K\'e\~{n}t K\^{\i}ng, L\`ou L\'ou,%
6120 M\`anfr\'ed J. M\^ost\u{e}k\i},%
6121 index={\index{J\"oe, J\o{}hn}\index{K\^{\i}ng, K\'e\~{n}t}%
6122 \index{L\'ou, L\`ou}\index{M\^ost\u{e}k\i, M\`anfr\'ed J.}},%
6123 cite={Serra:1996:sms,Moorer:2000:AES:audio:millenium,Dutilleux:1991,%
6124 Fitz:Haken:2003:Web:morphing:loris},
6125 bookmark={\pdfbookmark[2]{J\o{}hn J\"oe}{#2.author1}%
6126 \pdfbookmark[2]{K\'e\~{n}t K\^{\i}ng}{#2.author2}%
6127 \pdfbookmark[2]{L\`ou L\'ou}{#2.author3}%
6128 \pdfbookmark[2]{M\`anfr\'ed J. M\^ost\u{e}k\i}{#2.author4}}%
6129 ]{#2}
6130 \fi
6131
6132 \ifnum\paperswitch=33
6133 \procpaper[xshift=\LaTeXxShift{}, yshift=\LaTeXyShift{}, npages=4, switch=33,%
6134 title = {Templates for Two Authors},%
6135 author={Alfred Alabama, Chris Christmas},%
6136 index={\index{Alabama, Alfred}\index{Christmas, Chris}},%
6137 cite={Serra:1996:sms,Moorer:2000:AES:audio:millenium,%
6138 Arfib:1998:DAFx,Askenfelt:1976:automatic:transcription},
6139 bookmark={\pdfbookmark[2]{Alfred Alabama}{#2.author1}%
6140 \pdfbookmark[2]{Chris Christmas}{#2.author2}}%
6141 ]{#2}
6142 \fi
6143
6144 \ifnum\paperswitch=75
6145 \procpaper[xshift=\LaTeXxShift{}, yshift=\LaTeXyShift{}, npages=6, switch=75,%
6146 title={Templates for Three Authors},%
6147 author={Bob Boogie-Woogie, Chris Christmas, Don Didon},%
6148 index={\index{Boogie-Woogie, Bob}\index{Christmas, Chris}%
6149 \index{Didon, Don}},%
6150 cite={Serra:1996:sms,Moorer:2000:AES:audio:millenium,%
6151 Arfib:1998:DAFx,Egozy:1995:MIT:features:gesture},%
6152 bookmark={\pdfbookmark[2]{Bob Boogie-Woogie}{#2.author1}%
6153 \pdfbookmark[2]{Chris Christmas}{#2.author2}%
6154 \pdfbookmark[2]{Don Didon}{#2.author3}}%
6155 ]{#2}
6156 \fi
6157 % \end{macrocode}
6158 % We're done with the papers data, but \textbf{we must not forget to close the
6159 % curly brace!}
6160 % \begin{macrocode}
6161 }
6162 %</expapersswitch>
6163 % \end{macrocode}
6164 %
6165 %^^A\changes{0.2d}{2007/08/18}{Adding the description and examples for day and session organized conferences}
6166 %^^A\changes{0.2d}{2007/08/18}{Adding examples of table of contents and bookmarks layouts}
6167 %
6168 %
6169 %
6170 %
6171 %^^A------------------------------------------------------------------------
6172 % \subsection{\file{expages.tex}: Get page numbers and recompile all papers}
6173 %
6174 % In the case where inserted papers have headers/footers, we may have to recompile them all
6175 % with the proper page numbers. Before doing so, compile the proceedings enough times so
6176 % that the table of contents is generated and inserted. Then, use the page number indicated for
6177 % each paper to edit accordingly the \file{expages.tex} file. An example is provided here:
6178 %^^A\changes{0.7}{2010/08/05}{Example: corrected switch numbers on \file{expages.tex}}
6179 % \begin{macrocode}
6180 %<*expages>
6181 \newcommand{\setpagenumber}[1]{
6182 \newcommand{\paperswitch}{#1}
6183 \ifnum\paperswitch=45 {\setcounter{page}{1}}\fi
6184 \ifnum\paperswitch=21 {\setcounter{page}{7}}\fi
6185 \ifnum\paperswitch=27 {\setcounter{page}{13}}\fi
6186 \ifnum\paperswitch=33 {\setcounter{page}{17}}\fi
6187 \ifnum\paperswitch=75 {\setcounter{page}{23}}\fi
6188 }
6189 %</expages>
6190 % \end{macrocode}
6191 %
6192 % 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:\\
6193 % \verb+\input{../../expages.tex}\setpagenumber{01}+\\
6194 % where \verb+01+ is the paper reference (to be changed for each paper). Using the following:\\
6195 % \verb+\setcounter{page}{1}+\\
6196 % would of course have the equivalent effect, except that you would have to re-edit each paper after changing your program order.
6197 %
6198 %^^A =================================================================
6199 % \subsection{\file{exsessions.tex}: Organize the conference program by sessions/day}
6200 %^^A \subsection{Generate the conference program}
6201 % \label{sec:ex:program}
6202 %
6203 %
6204 % 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:
6205 % \begin{itemize}
6206 % \item by sessions and then by related papers (short conferences): see sec. \ref{sec:sec:sessions};
6207 % \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}.
6208 % \end{itemize}
6209 %
6210 % The mechanism used in \package{\filename} to build the table fo contents and bookmarks
6211 % is based on section levels: days are inserted in the table of contents and bookmarks as parts,
6212 % whereas sessions are inserted as chapters and papers as sections.
6213 %
6214 % Note that the {\bf \package{\filename} does not handle programs with parallel sessions}.
6215 % It is then up to you to decide in which order they may appear in the table of contents.
6216 %
6217 %^^A\changes{0.2e}{2007/09/01}{Doc: all sessions/days tables redone with tabular instead of minipage (smaller and easier to read)}
6218 %^^A =================================================================
6219 % \subsubsection{\file{exsessions.tex}: Program organized by sessions}\label{sec:sec:sessions}
6220 %
6221 % For a small size conference, if not using days (comment the \cmd{\procday{}} lines in the example),
6222 % you will obtain the table of contents corresponding to Tab~\ref{tab:program:session}.
6223 % The corresponding bookmark is depicted closed in Tab.~\ref{tab:program:session:bkmrk0},
6224 % opened at its first level in Tab.~\ref{tab:program:session:bkmrk1}, and opened at its second level
6225 % in Tab.~\ref{tab:program:session:bkmrk2}.
6226 %
6227 % \begin{table}[htb!]
6228 % \centering
6229 % \framebox{
6230 % \begin{tabular}{ll}
6231 % \multicolumn{2}{l}{\bf Conference Program}\\
6232 % & \vspace*{-0.1cm}\\
6233 % \multicolumn{2}{l}{\textbf{\textit{Oral Session 1}}}\\
6234 % 1 & Templates for One Author\\
6235 % & {\it Alfred Alabama}\\
6236 % & \vspace*{-0.3cm}\\
6237 % 7 & Templates for One Author with Two Affiliations\\
6238 % & {\it Bob Boogie-Woogie}\\
6239 % & \vspace*{-0.1cm}\\
6240 % \multicolumn{2}{l}{\textbf{\textit{Poster Session 1}}}\\
6241 % 11 & Templates for Two Authors\\
6242 % & {\it Alfred Alabama, Chris Christmas}\\
6243 % & \vspace*{-0.1cm}\\
6244 % \multicolumn{2}{l}{\textbf{\textit{Oral Session 2}}}\\
6245 % 15 & Templates for Three Authors\\
6246 % & {\it Bob Boogie-Woogie, Chris Christmas, Don Didon}\\
6247 % & \vspace*{-0.3cm}\\
6248 % 21 & Templates f\'or F\`o\"ur \`Authors\\
6249 % & {\it John J\"oe, K\'e\~{n}t K\^{\i }ng, L\`ou L\'ou, M\`anfr\'ed J. M\^ost\u{e}ki} \\
6250 % & \vspace*{-0.1cm}\\
6251 % 27 & {\bf Full Bibliography}\\
6252 % & \vspace*{-0.1cm}\\
6253 % 28 & {\bf Index of Authors}\\
6254 % \end{tabular}}
6255 % \caption{{\it Example of table of contents for a conference organized by sessions.}}
6256 % \label{tab:program:session}
6257 % \end{table}
6258 %
6259 % \begin{table}[htb!]
6260 % \centering
6261 % \textsf{%
6262 % \begin{tabular}{l@{\,}l} \hline
6263 % $\blacktriangleright$ & Preamble\\
6264 % & Program\\
6265 % $\blacktriangleright$ & Oral Session 1\\
6266 % $\blacktriangleright$ & Poster Session 1\\
6267 % $\blacktriangleright$ & Oral Session 2\\
6268 % & Full Bibliography\\
6269 % & Index of Authors\\ \hline
6270 % \end{tabular}}
6271 % \caption{{\it Closed bookmarks for a conference organized by sessions.}}
6272 % \label{tab:program:session:bkmrk0}
6273 % \end{table}
6274 %
6275 % \begin{table}[htb!]
6276 % \centering
6277 % \textsf{%
6278 % \begin{tabular}{l@{\,}l@{\,}l} \hline
6279 % $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Preamble} \\
6280 % & & Cover\\
6281 % & & Publishing informations\\
6282 % & & Welcome from Firstname Lastname\\
6283 % & \multicolumn{2}{@{\,}l}{Program} \\
6284 % $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Oral Session 1} \\
6285 % & $\blacktriangleright$ & Template for One Author\\
6286 % & $\blacktriangleright$ & Template for One Author with Two Affiliations\\
6287 % $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Poster Session 1} \\
6288 % & $\blacktriangleright$ & Template for Two Authors\\
6289 % $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Oral Session 2} \\
6290 % & $\blacktriangleright$ & Template for Three Authors\\
6291 % & $\blacktriangleright$ & Template f\'or F\`o\"ur \`Authors\\
6292 % & \multicolumn{2}{@{\,}l}{Full Bibliography} \\
6293 % & \multicolumn{2}{@{\,}l}{Index of Authors} \\ \hline
6294 % \end{tabular}}
6295 % \caption{{\it First-level opened bookmarks for a conference organized by sessions.}}
6296 % \label{tab:program:session:bkmrk1}
6297 % \end{table}
6298 %
6299 % \begin{table}[htb!]
6300 % \centering
6301 % \textsf{%
6302 % \begin{tabular}{l@{\,}l@{\,}ll} \hline
6303 % $\blacktriangledown$ & \multicolumn{3}{@{\,}l}{Preamble} \\
6304 % & & \multicolumn{2}{@{\,}l}{Cover}\\
6305 % & & \multicolumn{2}{@{\,}l}{Publishing informations}\\
6306 % & & \multicolumn{2}{@{\,}l}{Welcome from Firstname Lastname}\\
6307 % & \multicolumn{3}{@{\,}l}{Program} \\
6308 % $\blacktriangledown$ & \multicolumn{3}{@{\,}l}{Oral Session 1} \\
6309 % & $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Template for One Author}\\
6310 % & & & Alfred Alabama\\
6311 % & $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Template for One Author with Two Affiliations}\\
6312 % & & & Bob Boogie-Woogie\\
6313 % $\blacktriangledown$ & \multicolumn{3}{@{\,}l}{Poster Session 1} \\
6314 % & $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Template for Two Authors}\\
6315 % & & & Alfred Alabama\\
6316 % & & & Chris Christmas\\
6317 % $\blacktriangledown$ & \multicolumn{3}{@{\,}l}{Oral Session 2} \\
6318 % & $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Template for Three Authors}\\
6319 % & & & Bob Boogie-Woogie\\
6320 % & & & Chris Christmas\\
6321 % & & & Don Didon\\
6322 % & $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Template f\'or F\`o\"ur \`Authors}\\
6323 % & & & John J\"oe\\
6324 % & & & K\'e\~{n}t K\^{\i}ng\\
6325 % & & & L\`ou L\'ou\\
6326 % & & & M\`anfred J. M\^ost\u{e}k\i\\
6327 % & \multicolumn{3}{@{\,}l}{Full Bibliography} \\
6328 % & \multicolumn{3}{@{\,}l}{Index of Authors} \\ \hline
6329 % \end{tabular}}
6330 % \caption{{\it Second-level opened bookmarks for a conference organized by sessions.}}
6331 % \label{tab:program:session:bkmrk2}
6332 % \end{table}
6333 %
6334 % \clearpage
6335 %
6336 %^^A =================================================================
6337 % \subsubsection{Program organized by days}\label{sec:sec:days}
6338 %
6339 % In the case of bigger conferences with a program organized by day, you will get the
6340 % table of contents corresponding to Tab~\ref{tab:program:day}. The corresponding bookmark
6341 % is depicted closed in Tab.~\ref{tab:program:day:bkmrk0}, opened at its first level in
6342 % Tab.~\ref{tab:program:day:bkmrk1}, and opened at its second level Tab.~\ref{tab:program:day:bkmrk2}.
6343 %
6344 % \begin{table}[htb!]
6345 % \centering
6346 % \framebox{
6347 % \begin{tabular}{ll}
6348 % \multicolumn{2}{l}{\bf Conference Program}\\
6349 % & \vspace*{-0.1cm}\\
6350 % \multicolumn{2}{l}{\bf Day 1}\\
6351 % & \vspace*{-0.1cm}\\
6352 % \multicolumn{2}{l}{\textbf{\textit{Oral Session 1}}}\\
6353 % 1 & Templates for One Author\\
6354 % & {\it Alfred Alabama}\\
6355 % & \vspace*{-0.3cm}\\
6356 % 7 & Templates for One Author with Two Affiliations\\
6357 % & {\it Bob Boogie-Woogie}\\
6358 % & \vspace*{-0.1cm}\\
6359 % \multicolumn{2}{l}{\textbf{\textit{Poster Session 1}}}\\
6360 % 11 & Templates for Two Authors\\
6361 % & {\it Alfred Alabama, Chris Christmas}\\
6362 % & \vspace*{-0.1cm}\\
6363 % \multicolumn{2}{l}{\bf Day 2}\\
6364 % & \vspace*{-0.1cm}\\
6365 % \multicolumn{2}{l}{\textbf{\textit{Oral Session 2}}}\\
6366 % 15 & Templates for Three Authors\\
6367 % & {\it Bob Boogie-Woogie, Chris Christmas, Don Didon}\\
6368 % & \vspace*{-0.3cm}\\
6369 % 21 & Templates f\'or F\`o\"ur \`Authors\\
6370 % & {\it John J\"oe, K\'e\~{n}t K\^{\i }ng, L\`ou L\'ou, M\`anfr\'ed J. M\^ost\u{e}ki} \\
6371 % & \vspace*{-0.1cm}\\
6372 % 27 & {\bf Full Bibliography}\\
6373 % & \vspace*{-0.1cm}\\
6374 % 28 & {\bf Index of Authors}\\
6375 % \end{tabular}}
6376 % \caption{{\it Example of table of contents for a conference organized by day.}}
6377 % \label{tab:program:day}
6378 % \end{table}
6379 %
6380 % \begin{table}[htb!]
6381 % \centering
6382 % \textsf{%
6383 % \begin{tabular}{@{\,}l@{\,}l} \hline
6384 % $\blacktriangleright$ & Preamble\\
6385 % & Program\\
6386 % $\blacktriangleright$ & Day 1\\
6387 % $\blacktriangleright$ & Day 2\\
6388 % & Full Bibliography\\
6389 % & Index of Authors\\ \hline
6390 % \end{tabular}}
6391 % \caption{{\it Closed bookmarks for a conference organized by days.}}
6392 % \label{tab:program:day:bkmrk0}
6393 % \end{table}
6394 %
6395 %
6396 % \begin{table}[htb!]
6397 % \centering
6398 % \textsf{%
6399 % \begin{tabular}{@{\,}l@{\,}l@{\,}l} \hline
6400 % $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Preamble}\\
6401 % & & Cover\\
6402 % & & Publishing informations\\
6403 % & & Welcome from Firstname Lastname\\
6404 % & \multicolumn{2}{@{\,}l}{Program}\\
6405 % $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Day 1}\\
6406 % & $\blacktriangleright$ & Oral Session 1\\
6407 % & $\blacktriangleright$ & Poster Session 1\\
6408 % $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Day 2}\\
6409 % & $\blacktriangleright$ & Oral Session 2\\
6410 % & \multicolumn{2}{@{\,}l}{Full Bibliography}\\
6411 % & \multicolumn{2}{@{\,}l}{Index of Authors}\\ \hline
6412 % \end{tabular}}
6413 % \caption{{\it First-level opened bookmarks for a conference organized by days.}}
6414 % \label{tab:program:day:bkmrk1}
6415 % \end{table}
6416 %
6417 % \begin{table}[htb!]
6418 % \centering
6419 % \textsf{%
6420 % \begin{tabular}{@{\,}l@{\,}l@{\,}l@{\,}l} \hline
6421 % $\blacktriangledown$ & \multicolumn{3}{@{\,}l}{Preamble}\\
6422 % & & \multicolumn{2}{@{\,}l}{Cover}\\
6423 % & & \multicolumn{2}{@{\,}l}{Publishing informations}\\
6424 % & & \multicolumn{2}{@{\,}l}{Welcome from Firstname Lastname}\\
6425 % & \multicolumn{3}{@{\,}l}{Program}\\
6426 % $\blacktriangledown$ & \multicolumn{3}{@{\,}l}{Day 1}\\
6427 % & $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Oral Session 1}\\
6428 % & & $\blacktriangleright$ & Template for One Author\\
6429 % & & $\blacktriangleright$ & Template for One Author with Two Affiliations\\
6430 % & $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Poster Session 1}\\
6431 % & & $\blacktriangleright$ & Template for Two Authors\\
6432 % $\blacktriangledown$ & \multicolumn{3}{@{\,}l}{Day 2}\\
6433 % & $\blacktriangledown$ & \multicolumn{2}{@{\,}l}{Oral Session 2}\\
6434 % & & $\blacktriangleright$ & Template for Three Authors\\
6435 % & & $\blacktriangleright$ & Template f\'or F\`o\"ur \`Authors\\
6436 % & \multicolumn{3}{@{\,}l}{Full Bibliography}\\
6437 % & \multicolumn{3}{@{\,}l}{Index of Authors}\\ \hline
6438 % \end{tabular}}
6439 % \caption{{\it Second-level opened bookmarks for a conference organized by days.}}
6440 % \label{tab:program:day:bkmrk2}
6441 % \end{table}
6442 %
6443 % \clearpage
6444 %
6445 %
6446 %^^A =================================================================
6447 % \subsection{\file{exprogram.csv}: Generate the conference program from a CSV file}
6448 % \label{sec:scripts:program}
6449 %
6450 % It may be easier to collect data about the papers from a server, manipulate them
6451 % in a spreadsheet software (for example M\$ Excel), and then generate the program from a
6452 % \file{.csv} file. The provided \file{generateswitch.pl} Perl script (see sec.~\ref{sec:scripts:perl})
6453 % generates the corresponding \file{expaperswitch.tex} and \file{exsessions.tex} files
6454 % for the example.
6455 % First, let's take a look at the following CSV file, that contains the example's conference
6456 % program\footnote{This is normal that this text goes on after the margin.
6457 % Please check the generated file if you wish to read each line.}:
6458 %
6459 %^^A =================================================================
6460 %^^A Here is the creation of the procwitchandtoc.pl file, part of the example.
6461 %^^A It is written on first LaTeX run if it does not already exist
6462 %^^A =================================================================
6463 % {\scriptsize
6464 % \begin{macrocode}
6465 %<*exprogram>
6466 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,,
6467 Type,-2,O,,,,,,First Name,Last Name,First Name,Last Name,First Name,Last Name, F.Name, L.Name,,
6468 Day,0,,,"Day 1: September 18, 2007",,,,,,,,,,,,,
6469 Session,0,,,Oral Session 1,,,,,,,,,,,,,
6470 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,,,,,,,,
6471 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,,,,,,,,
6472 Poster Session,0,,,Poster Session 1,,,,,,,,,,,,,
6473 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,,,,,,
6474 Day,0,,,"Day 2: September 19, 2007",,,,,,,,,,,,,
6475 Session,0,,,Oral Session 2,,,,,,,,,,,,,
6476 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,,,,
6477 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,,
6478 %</exprogram>
6479 % \end{macrocode}
6480 % }
6481 %
6482 % As expected fromt its first line, it contains the following columns:
6483 % \begin{enumerate}
6484 % \item {\bf Type:} the script will accept the following values:
6485 % \begin{itemize}
6486 % \item use \verb+Type+ for the items/lines to be ignored;
6487 % \item Day: use \verb+Day+;
6488 % \item Session: for oral session, use \verb+Session+, \verb+Paper Session+ or
6489 % \verb+Oral Session+; for poster sessions, use \verb+poster session+;
6490 % for demonstration sessions, use \verb+Demo Session+;
6491 % \item Paper: use \verb+paper+ or \verb+oral+ for oral presentation; \verb+poster+
6492 % for poster presentation; \verb+demo+ for demo. The 3 output identical code anyway:
6493 % the different values only help to organize the program!.
6494 % \end{itemize}
6495 % N.B.: theses values are not case sensitively processed by the \file{generateswitch.pl} Perl script.
6496 % \item {\bf Number:} paper number or reference, often generated by the submission system.
6497 % It will be used for paper insertion, for ordering the program, etc.
6498 % \item {\bf PC Decision:} \verb+oral+ or \verb+poster+.
6499 % It does not change the \LaTeX\ generated code, so you may not use it;
6500 % \item {\bf Pages:} number of pages;
6501 % \item {\bf Title:} paper/session title;
6502 % \item {\bf File Name:} name of the corresponding \file{.pdf} file;
6503 % \item {\bf Generated:} software used to generate the \file{.pdf} files (e.g.: \verb+LaTeX+, \verb+Word+):
6504 % this allows to use different $X$ and $Y$ offset values
6505 % (we however used the same value for all papers of one kind);
6506 % \item {\bf Citations:} list of bibliography items for the general bibliography \\(ex: \verb+\cite{bibitem1,bibitem2,bibitem3}+); blank if no general bibliography;
6507 % \item {\bf Auth1 First Name:} first name of author 1;
6508 % \item {\bf Auth1 Last Name:} last name of author 1;
6509 % \item {\bf Auth2 First Name:} first name of author 2, blank if none;
6510 % \item {\bf Auth2 Last Name:} last name of author 2, blank if none;
6511 % \item {\bf Auth3 First Name:} first name of author 3, blank if none;
6512 % \item {\bf Auth3 Last Name:} last name of author 3, blank if none;
6513 % \item {\bf Auth4 First Name:} first name of author 4, blank if none;
6514 % \item {\bf Auth4 Last Name:} last name of author 4, blank if none;
6515 % \item {\bf comments:} there is an extra column, that is not used by the script.
6516 % \end{enumerate}
6517 %
6518 %
6519 %^^A =================================================================
6520 % \subsection{\file{exbiblio.bib}: Common bibliography items}
6521 % \label{sec:ex:bib:common}
6522 %
6523 %^^A\changes{0.1d}{2007/08/01}{Biblio: adding the \file{exbiblio.tex} file creation}
6524 %^^A\changes{0.1i}{2007/08/10}{Biblio: code cleanup}
6525 %^^A\changes{0.1i}{2007/08/10}{Biblio: adding the \cmd{\procbibintro} command to customize the biblio introduction}
6526 %^^A =================================================================
6527 %^^A Here is the creation of the exbibcommon.tex file, part of the example.
6528 %^^A It is written on first LaTeX run if it does not already exist
6529 %^^A =================================================================
6530 %
6531 % Let us now take a look at the common bibliographic items of this example:
6532 % \changes{0.4b}{2007/10/12}{bibliography: removed item containing introductory paragraph}
6533 % \begin{macrocode}
6534 %<*exbiblio>
6535 %-- references to a book
6536 @book{Mitra:Kaiser:1993:DSP:handbook,
6537 Author = {S.~K. Mitra and J.~F. Kaiser},
6538 Title = {Handbook for Digital Signal Processing},
6539 Publisher = {J. Wiley {\&} Sons},
6540 Year = {1993}}
6541
6542 @book{Haykin:1991:adaptive:filter,
6543 Author = {Simon Haykin},
6544 Title = {Adaptive Filter Theory},
6545 Publisher = {Prentice Hall},
6546 Address = {Englewood Cliffs},
6547 Edition = {Second},
6548 Year = {1991}}
6549
6550 %-- reference to a book chapter
6551 @inbook{Serra:1996:sms,
6552 Author = {X. Serra},
6553 Chapter = {Musical Sound Modeling with Sinusoids plus Noise},
6554 Publisher = {G. D. Poli, A. Picialli, S. T. Pope and C. Roads,%
6555 Eds.~Swets~\&~Zeitlinger},
6556 Title = {Musical Signal Processing},
6557 Pages = {91--122},
6558 Year = {1996}}
6559
6560 %-- reference to a journal paper
6561 @article{Moorer:2000:AES:audio:millenium,
6562 Author = {James A. Moorer},
6563 Title = {Audio in the New Millennium},
6564 Journal = {Journal of the {AES}},
6565 Volume = 48,
6566 Number = 5,
6567 Year = 2000,
6568 Month = may,
6569 Pages = {490--498}}
6570
6571 %-- reference to a proceeding paper
6572 @inproceedings{Arfib:1998:DAFx,
6573 Author = {D. Arfib},
6574 Booktitle = {Proc. of the COST-G6 Workshop on Digital Audio Effects %
6575 (DAFx-98)},
6576 Title = {Different Ways to Write Digital Audio Effects Programs},
6577 Address = {Barcelona, Spain},
6578 Pages = {188--91},
6579 Year = {1998}}
6580
6581 %-- reference to a technical report
6582 @techreport{Askenfelt:1976:automatic:transcription,
6583 Author = {A. Askenfelt},
6584 Title = {Automatic notation of played music (status report)},
6585 Institution = {{STL-QPSR, Vol. 1, pp. 1--11}},
6586 Year = {1976}}
6587
6588 %-- reference to a master thesis
6589 @mastersthesis{Egozy:1995:MIT:features:gesture,
6590 Author = {E.~B. Egozy},
6591 title = {Deriving musical control features from a real-time timbre %
6592 analysis of the clarinet},
6593 School = {Massachusetts Institute of Technology},
6594 Year = {1995}}
6595
6596 %-- reference to a PhD thesis
6597 @phdthesis{Dutilleux:1991,
6598 Author = {P. Dutilleux},
6599 School = {University of Aix-Marseille II},
6600 Title = {Vers la machine \`a sculpter le son, modification en %
6601 temps-r\'eel des caract\'eristiques fr\'equentielles et temporelles%
6602 des sons},
6603 Year = {1991}}
6604
6605 %-- reference to a web page
6606 @unpublished{Fitz:Haken:2003:Web:morphing:loris,
6607 Author = {K. Fitz and L. Haken},
6608 Title = {{Current Research in Real-time Sound Morphing}},
6609 Note = {Available at \href{http://www.cerlsoundgroup.org/RealTimeMorph/}%
6610 {http://www.cerlsoundgroup.org/RealTimeMorph/}},
6611 Year = {Accessed March 08, 2006}}
6612 %</exbiblio>
6613 % \end{macrocode}
6614 %
6615 % Please refer to sec.~\ref{sec:general:bib} for details about the bibliography merging process.
6616 %
6617 %^^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...}
6618 %
6619 %
6620 %
6621 %
6622 %
6623 %^^A\changes{0.2i}{2007/09/21}{Doc: finishing biblio merging and other biblio-related stuff}
6624 %^^A =================================================================
6625 % \subsection{General bibliography}\label{sec:general:bib}
6626 %
6627 %^^A------------------------------------------------------------------------
6628 % \subsubsection{Making the general bibliography}
6629 %
6630 % 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:
6631 % \begin{itemize}
6632 % \item \texttt{exbibconcat.bib} containing all citations for all papers;
6633 % \item \texttt{exbibcommon.bib} containing common bibliography items, added one by one during the merging process;
6634 % \item \texttt{exbibstrings.bib} containing all common strings (conference names, journal names, etc), to ensure coherence among citations from same sources (journal, conference).
6635 % \end{itemize}
6636 % Here is how those files were created and used:
6637 % \begin{enumerate}
6638 % \item create the complete bibliography:
6639 % \begin{enumerate}
6640 % \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.};
6641 % \item ensure that each paper has a proper list of bibliography items using those new tags;
6642 % \item add individual paper bibliography items into the file named \file{exbibconcat.bib};
6643 % \item set the proceedings bibliography file to:\begin{verbatim}
6644 %\renewcommand{\procbibfile}{\BIBPATH exbibconcat.bib}
6645 %\end{verbatim}
6646 % \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.
6647 % \end{enumerate}
6648 % \item merge the bibliographic items (long step):
6649 % \begin{enumerate}
6650 % \item first, add the \file{exbibcommon.bib} file to the list of bibliography files by setting the proceedings bibliography files to: \begin{verbatim}
6651 %\renewcommand{\procbibfile}{\BIBPATH exbibcommon.bib,%
6652 % \BIBPATH exbibconcat.bib}
6653 %\end{verbatim}
6654 % \item for each item appearing multiple times:
6655 % \begin{enumerate}
6656 % \item create a corresponding entry in the \file{exbibcommon.bib} file;
6657 % \item remove all of its appearances in \file{exbibconcat.bib};
6658 % \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.
6659 % \end{enumerate}
6660 % \end{enumerate}
6661 % \item merge the bibliography strings:
6662 % \begin{enumerate}
6663 % \item add \file{exbibstrings.bib} to the list of bibliography files: \begin{verbatim}
6664 %\renewcommand{\procbibfile}{\BIBPATH exbibstrings.bib,%
6665 % \BIBPATH exbibcommon.bib,\BIBPATH exbibconcat.bib}
6666 %\end{verbatim}
6667 % \item merge the common strings. For each string shared by several items:
6668 % \begin{enumerate}
6669 % \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}
6670 %@string{IEEE-TASSP = "{IEEE Trans. Acoust., Speech,
6671 % and Signal Proc.}"}
6672 %\end{verbatim}
6673 % \item use such definitions (\eg{} \file{IEEE-TASSP}) to replace any of its appearance in \file{exbibconcat.bib}. For instance, use:\begin{verbatim}
6674 %@article{paper027:Mcaulay86,
6675 % Author = {Robert J. McAulay and Thomas F. Quatieri},
6676 % Title = {Speech Analysis/Synthesis Based on a%
6677 % Sinusoidal Representation},
6678 % Journal = IEEE-TASSP,
6679 % Volume = {34},
6680 % Number = {4},
6681 % Pages = {744-754},
6682 % Year = {1986}}
6683 %\end{verbatim}
6684 % \end{enumerate}
6685 % \end{enumerate}
6686 % \item optimal: update each paper once the general bibliography is ok:
6687 % \begin{enumerate}
6688 % \item for each paper:
6689 % \begin{enumerate}
6690 % \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};
6691 % \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}
6692 %\bibliography{../../exbibstrings.bib,%
6693 % ../../exbibcommon.bib,p_027.bib}
6694 %\end{verbatim}
6695 % \end{enumerate}
6696 % \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.
6697 % \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.
6698 % \end{enumerate}
6699 % \end{enumerate}
6700 % 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.
6701 %
6702 %
6703 %
6704 %
6705 %
6706 %^^A everything else in the proceedings is done (table of contents. index, etc), create the back references with one of those two solutions:
6707 %^^A \begin{itemize}
6708 %^^A \item Good trick: {\sc check this as it seems that it has changed} labels/refs
6709 %^^A \begin{itemize}
6710 %^^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
6711 %^^A \item save the \file{DAFx06\_Proceedings.brf} file under another name
6712 %^^A \item recompile the Proceedings without replacing last page by bibliography
6713 %^^A \item rename properly the file \file{DAFx06\_Proceedings.brf}
6714 %^^A \item one last compile, and the backref are ok!
6715 %^^A \item Rk: one should NOT recompile the bibliography without doing this manipulation again
6716 %^^A \end{itemize}
6717 %^^A \item generate the \file{DAFx06\_Proceedings.brf} file by hand!
6718 %^^A \begin{itemize}
6719 %^^A \item create the general backref file \file{DAFx06\_Proceedings.brf} using lines such as:\\
6720 %^^A \begin{verbatim}
6721 %^^A\backcite{Ref1,Ref2,Ref3}{{12}%
6722 %^^A {(document)}{Doc-Start}}
6723 %^^A \end{verbatim}
6724 %^^A \item update all pages numbers in the \file{DAFx06\_Proceedings.brf} back references file
6725 %^^A \item have a back reference for each page where the reference is appearing (maybe several for each paper).
6726 %^^A \item save your \file{DAFx06\_Proceedings.brf} file under another name, since it will be erase by the next bib compilation
6727 %^^A \end{itemize}
6728 %
6729 %
6730 %
6731 %^^A------------------------------------------------------------------------
6732 %^^A \subsubsection{Some considerations on bibliographies}
6733 %
6734 %
6735 %^^A------------------------------------------------------------------------
6736 % \subsubsection{Which bib styles for the templates?}
6737 %
6738 % 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.
6739 %
6740 %
6741 %^^A------------------------------------------------------------------------
6742 % \subsubsection{Which bib styles for the general bibliography?}
6743 %
6744 % 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!
6745 %
6746 % 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).
6747 %
6748 %^^A------------------------------------------------------------------------
6749 % \subsubsection{Right-flushing the biblio back-references}
6750 %
6751 % 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:\\
6752 %
6753 %^^A\changes{0.7}{2010/08/05}{Example: corrected layout example for the general bibliography}
6754 % \begin{center}
6755 % \begin{minipage}[c]{9.2cm}
6756 % \vspace*{-0.2cm}Arfib, D. (1998). Different ways to write digital audio effects programs.
6757 % In {\em Proc. of the COST-G6 Workshop on Digital Audio Effects (DAFx-98)},
6758 % Barcelona, Spain, (pp. 188--91). \color{red}6, 11, 16, 22, 29 \color{black}
6759 % \end{minipage}
6760 % \end{center}
6761 %
6762 % 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:\\
6763 %
6764 % \begin{center}
6765 % \begin{minipage}[c]{9.2cm}
6766 % \vspace*{-0.2cm}Arfib, D. Different ways to write digital audio effects programs.
6767 % In {\em Proc. of the COST-G6 Workshop on Digital Audio Effects (DAFx-98)},
6768 % Barcelona, Spain, pp. 188--91. 1998. ~~~ \color{red}6, 11, 16, 22, 29\color{black}
6769 % \end{minipage}
6770 % \end{center}
6771 %
6772 % Together with the color links, back-references are easier to see when they are right-flushed that when they are left-flushed.
6773 %
6774 % \margindanger{}To apply the right-flushed back-references to another style, here is the only trick to keep from the hack.
6775 % 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}
6776 %FUNCTION {output.year.check}
6777 %{ year empty$
6778 % { ``empty year in `` cite$ * warning$ }
6779 % { write$
6780 % `` (" year * extra.label * ``)" *
6781 % mid.sentence 'output.state :=
6782 % }
6783 % if$
6784 %}
6785 %\end{verbatim}
6786 %
6787 % {\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+.
6788 % For instance:\begin{verbatim}
6789 %FUNCTION {misc}
6790 %{ output.bibitem
6791 % format.authors output
6792 % author format.key output % added
6793 % output.year.check % added
6794 % title howpublished new.block.checkb
6795 % format.title output
6796 % new.block
6797 % howpublished output
6798 % new.block
6799 % note output
6800 % fin.entry
6801 %\end{verbatim} was replaced with:\begin{verbatim}
6802 %FUNCTION {misc}
6803 %{ output.bibitem
6804 % format.authors output
6805 % author format.key output
6806 % title howpublished new.block.checkb
6807 % format.title output
6808 % new.block
6809 % howpublished output
6810 % new.block
6811 % note output
6812 % output.year.check % !!! MOVED !!!
6813 % fin.entry
6814 %\end{verbatim}
6815 % 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.
6816 %
6817 %^^A------------------------------------------------------------------------
6818 % \subsubsection{Ensuring that the biblio back-references are right-flushed}
6819 %
6820 % 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:
6821 % \begin{itemize}
6822 % \item moving from optional to compulsory a bib item field; %^^A (such as the proceedings volume number for a proceedings paper);
6823 % \item replacing a \verb+---+ by a \verb+--+ (arg! so ugly...);
6824 % \item adding a missing space (\eg{} between the thesis number and the URL);
6825 % \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).
6826 % \end{itemize}
6827 %
6828 % \color{black}
6829 %
6830 %^^A =================================================================
6831 % \subsection{\LaTeX{} runs}\label{sec:custom:ex:latex}
6832 %
6833 % 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}):
6834 % \begin{enumerate}
6835 % \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):\\
6836 % \texttt{pdflatex example3optim.tex}
6837 % \item generates the general bibliography and \file{.brf}, \file{.bbl} files:\\
6838 % \texttt{bibtex example3optim}
6839 % \item generates the author index:\\
6840 % \texttt{makeindex -s confproc2.ist example3optim.idx}
6841 % \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):\\
6842 % \texttt{pdflatex example3optim.tex}
6843 % \item insert table of contents and index with proper page numbers, and remove links to bibliography for next run (\Lopt{papers=final,bib=final}):\\
6844 % \texttt{pdflatex example3optim.tex}
6845 % \end{enumerate}
6846 %
6847 %
6848 %^^A\changes{0.2g}{2007/09/07}{Doc: starting a more organized `proceedings making'}
6849 %^^A =================================================================
6850 %^^A More about building conference proceedings
6851 %^^A =================================================================
6852 % \section{More about building conference proceedings (for warriors)}
6853 % \label{sec:conference:proc:making}
6854 %
6855 %^^A\changes{0.2h}{2007/09/12}{Example: adding class switch and generation of corresponding files}
6856 %^^A =================================================================
6857 % \subsection{Compilation steps: class option switch}
6858 % \label{sec:ex:input:class}
6859 %
6860 % 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.
6861 %
6862 % 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.
6863 %
6864 %
6865 % \changes{0.4f}{2007/10/7}{bug: \Lopt{draft} removes bookmarks}
6866 %^^A------------------------------------------------------------------------
6867 % \subsubsection{Options set for non-final \LaTeX\ runs: \file{exclasspre.tex}}
6868 %
6869 % 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.
6870 % \begin{macrocode}
6871 %<*exclasspre>
6872 \documentclass[letterpaper,10pt,twoside,twosidepapers,%
6873 electronic,% [printed] | electronic
6874 papers=countpages,% empty | draft | [final] | countpages
6875 headers=allpages,% none | pdfonly | exceptpdf | [allpages]
6876 paperselec=all, %[all] | p_001 | p_fake
6877 bib=backref,%
6878 colorheaders=red,%
6879 verbose,%
6880 pdftk,%
6881 pdftkfolder={pdftk_info/},%
6882 pdftksubject={DAFx-06 Conference},%
6883 movepagenumber,%
6884 hyperref={bookmarksdepth=1,bookmarksopen,bookmarksopenlevel=0,%
6885 citecolor=colorforcite,linkcolor=colorforlink,urlcolor=colorforurl},%
6886 geometry={text={175truemm,226truemm},% A4 & letter
6887 inner=0.805in,top=29.15mm,bottom=24.5mm,footskip=9.68mm,voffset=-5mm},%letter
6888 ]{confproc}
6889 %</exclasspre>
6890 % \end{macrocode}
6891 % 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.
6892 %
6893 %^^A------------------------------------------------------------------------
6894 % \subsubsection{Options set for final \LaTeX\ run on the paperback version: \file{exclasslastpb.tex}}
6895 %
6896 % 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:
6897 % \begin{macrocode}
6898 %<*exclasslastpb>
6899 \documentclass[letterpaper,10pt,twoside,twosidepapers,%
6900 printed,% [printed] | electronic
6901 papers=final,% empty | draft | [final] | countpages
6902 headers=exceptpdf,% none | pdfonly | exceptpdf | [allpages]
6903 paperselec=all, %[all] | p_001 | p_fake
6904 bib=last,%
6905 pdftk,%
6906 pdftkfolder={pdftk_info/},%
6907 pdftksubject={DAFx-06 Conference},%
6908 binding=5mm,% [0mm] -> adjust the binding depending on the proceedings thickness
6909 hyperref={bookmarksdepth=1,bookmarksopen,bookmarksopenlevel=0,%
6910 citecolor=colorforcite,linkcolor=colorforlink,urlcolor=colorforurl},%
6911 geometry={text={175truemm,226truemm},% A4 & letter
6912 inner=0.805in,top=29.15mm,bottom=24.5mm,footskip=9.68mm,voffset=-5mm},%letter
6913 ]{confproc}
6914 %</exclasslastpb>
6915 % \end{macrocode}
6916 %
6917 %
6918 %^^A------------------------------------------------------------------------
6919 % \subsubsection{Options set for final \LaTeX\ run on the electronic version: \file{exclasslastel.tex}}
6920 %
6921 % This third file differs from the second by its \Lopt{electronic} option, and the geometry settings (the document has no inner margin):
6922 % \begin{macrocode}
6923 %<*exclasslastel>
6924 \documentclass[letterpaper,10pt,twoside,twosidepapers,%
6925 electronic,% [printed] | electronic
6926 papers=final,% empty | draft | [final] | countpages
6927 headers=exceptpdf,% none | pdfonly | exceptpdf | [allpages]
6928 paperselec=all, %[all] | p_001 | p_fake
6929 bib=last,%
6930 pdftk,%
6931 pdftkfolder={pdftk_info/},%
6932 pdftksubject={DAFx-06 Conference},%
6933 binding=0mm,% [0mm] -> no binding for electronic version
6934 hyperref={bookmarksdepth=1,bookmarksopen,bookmarksopenlevel=0,%
6935 citecolor=colorforcite,linkcolor=colorforlink,urlcolor=colorforurl},%
6936 geometry={text={175truemm,226truemm},% A4 & letter
6937 inner=0.0in,top=29.15mm,bottom=24.5mm,footskip=9.68mm,voffset=-5mm},%letter
6938 ]{confproc}
6939 %</exclasslastel>
6940 % \end{macrocode}
6941 %
6942 %
6943 % \color{black}
6944 %
6945 %
6946 %
6947 %^^A =================================================================
6948 % \subsection{Option management: examples of option combinations}
6949 %
6950 %^^A\changes{0.2b}{2007/08/16}{Options: description added for \package{\filename} options}
6951 %^^A------------------------------------------------------------------------
6952 % \subsubsection{Fasten compilation steps}
6953 %
6954 % 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.
6955 % 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}.
6956 %
6957 % 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.
6958 %
6959 %^^A------------------------------------------------------------------------
6960 % \subsubsection{Verbose/debug}
6961 %
6962 % 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!
6963 %
6964 %^^A------------------------------------------------------------------------
6965 % \subsubsection{Clear single/double page}
6966 %
6967 % Depending on wether your document is \Lopt{oneside} or \Lopt{twoside}, you may want to force it to always:
6968 % \begin{itemize}
6969 % \item clear double page after each paper in 1-side mode using \DescribeMacro{cleardoublepage} \Lopt{cleardoublepage} (used with \Lopt{oneside});
6970 % \item not clear double page after each paper in 2-side mode using \DescribeMacro{clearsinglepage} \Lopt{clearsinglepage} (used with \Lopt{twoside}).
6971 % \end{itemize}
6972 %
6973 %
6974 %^^A\changes{0.2g}{2007/09/07}{Doc: e-organizing steps' section}
6975 %^^A =================================================================
6976 %^^A Compilations
6977 %^^A =================================================================
6978 % \subsection{Steps to generate the final version of the proceedings}\label{sec:confproc:compil}
6979 %
6980 %\changes{0.6}{\datevzdsix}{Doc: added diagram with suggested building steps}
6981 % \begin{figure}[htbp]
6982 % \includegraphics[width=1.1\textwidth]{confproc_diag.pdf}
6983 % \caption{Suggested stages to build proceedings}
6984 % \label{fig:confproc_diag}
6985 % \end{figure}
6986 %
6987 % Now that all options and commands to build proceedings are know, we need more insight
6988 % about what to do with which option/command and when. This is the purpose of this section,
6989 % that proposed some building stages (as depicted in the diagram in Fig.~\ref{fig:confproc_diag})
6990 % to produce both the electronic and paperback final versions of the provided example
6991 % proceedings with the following constraints:
6992 % \begin{itemize}
6993 % \item the template for papers has a header and footer, so the proceedings must have the same header/footer;
6994 % \item a general bibliography is used;
6995 % \item the final PDF papers must be named after their first page number.
6996 % \end{itemize}
6997 %
6998 %^^A------------------------------------------------------------------------
6999 % \subsubsection{Generate the program and the paper switch}
7000 %
7001 % Once the general proceedings structure is there (see the \file{example3optim.tex} file),
7002 % the first step is to generate the conference program and its corresponding paper switch:
7003 % \begin{itemize}
7004 % \item by hand (read sec.~\ref{sec:ex:paper:switch} for an example);
7005 % \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.
7006 % \end{itemize}
7007 %
7008 %
7009 %^^A------------------------------------------------------------------------
7010 % \subsubsection{Make sure each PDF is fully inserted}\label{sec:compare:page:numbers}
7011 % At some point, we want to make sure all pages of each paper are inserted. The simplest way
7012 % is to always use the \Lopt{papers=countpages}, but this is unfortunately very time consuming
7013 % when working on setting various layout aspects, the program, and also when adding contents
7014 % to the preamble. Therefore, if using \Lopt{papers=empty} for instance, we want to make sure
7015 % no paper has been truncated by error. Checking this by hand is a long and fastidious task, so
7016 % two solutions are offered: the \file{countnbpages.sh} script (see sec.~\ref{sec:scripts:countnbpages})
7017 % and the \file{*.np*} files generated when running \LaTeX\ with either \Lopt{papers=countpages}
7018 % or \Lopt{papers=empty}.
7019 %
7020 % \paragraph{For Unix users:}
7021 % \begin{enumerate}
7022 % \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;
7023 % \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;
7024 % \item compare the content of both files, using
7025 %\begin{verbatim}
7026 %diff example.nps example.npc
7027 %\end{verbatim}
7028 % \item each paper appearing in the \file{diff} command output has a page number discrepancy, that has to be corrected.
7029 % \end{enumerate}
7030 % Once all discrepancies have been corrected, re-do this procedure once for a last check, just in case!
7031 % \paragraph{For non-Unix users (sorry, it's much slower!):}
7032 % \begin{enumerate}
7033 % \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);
7034 % \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);
7035 % \item compare both files (with your favorite text editor's `compare file' function).
7036 % \end{enumerate}
7037 % 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.
7038 %
7039 %^^A------------------------------------------------------------------------
7040 % \subsubsection{Changing papers' first page number}
7041 %
7042 % 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:
7043 % \begin{enumerate}
7044 % \item make at least two runs with the following options:\begin{verbatim}
7045 %\documentclass[a4paper,10pt,twoside,twosidepapers,%
7046 % compil=last,headers=allpages,movepagenumber,electronic]{confproc}
7047 %\end{verbatim}
7048 % to include all papers and build a table of contents with proper page numbers.
7049 % \item prepare each paper for insertion. There are two ways to do this:
7050 % \begin{enumerate}
7051 % \item lazy way: use the \verb+\setcounter{page}{XXX}+ command in each paper, with \verb+XXX+ replaced by the real number;
7052 % \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:
7053 % \begin{itemize}
7054 % \item add the following in the preamble of each paper:\begin{verbatim}
7055 %\input{../../expages.tex}\setpagenumber{04}
7056 %\end{verbatim}
7057 % Here, the ID paper is \verb+04+, and has to be updated for each paper.
7058 % \item update the \file{expages.tex} file for each paper: set its first page number as it appears in the table of contents.
7059 % \end{itemize}
7060 % 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.
7061 % \end{enumerate}
7062 % \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});
7063 % \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.
7064 % \end{enumerate}
7065 %
7066 %^^A------------------------------------------------------------------------
7067 % \subsubsection{Renaming papers}
7068 %
7069 % 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.
7070 %
7071 %
7072 %
7073 %^^A =================================================================
7074 % \subsection{Quality and production}
7075 %
7076 % 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}).
7077 %
7078 %^^A------------------------------------------------------------------------
7079 % \subsubsection{Editing the papers}\label{sec:misc:editing}
7080 %
7081 % To provide the best possible quality proceedings for DAFx-06, each individual paper was edited by checking the following items (non-exhaustive list):
7082 % \begin{itemize}
7083 % \item proper page format used (US letter instead of A4 format), as the authors were from various continents around the worlds;
7084 % \item break the title line at the right place using \verb+\break+;
7085 % \item affiliation type is properly indicated;
7086 % \item affiliation is properly layed out;
7087 % \item author's email exists and works;
7088 % \item captions are italic, with a ``.'' at the end;
7089 % \item all figures are referenced in the text;
7090 % \item bibliographic items have a volume and number, as well as page number or preprint number (AES convention);
7091 % \item bibliographic items use generally defined strings, and are identical each time they are cited;
7092 % \item math units: Physics convention is roman, not italic (\ie{} not LaTeX's math style). Ex: $5$ Hz, and not $5Hz$.
7093 % \end{itemize}
7094 %
7095 % \noindent So as to ensure papers look uniform as possible, we changed for each:
7096 % \begin{itemize}
7097 % \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:\\
7098 % \verb+\usepackage{url}\urlstyle{sf}+
7099 % \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).
7100 % \end{itemize}
7101 %
7102 % \noindent Some not-so-minor comments:
7103 % \begin{itemize}
7104 % \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.
7105 % \item using the \package{balance.sty} package allows to well balance the last page, which is especially useful for the bibliography.
7106 % \end{itemize}
7107 %
7108 %^^A------------------------------------------------------------------------
7109 % \subsubsection{Sending editing notes to authors to improve the layout quality}\label{sec:misc:notes}
7110 %
7111 % 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:
7112 % \begin{enumerate}
7113 % \item examine all papers and list the common errors and electronic paper info (PDF version, PDF generator, valid hyperref, etc.) (10h);
7114 % \item in an \file{.csv} file, indicate all problems, paper's title, index and author's email (0.5h);
7115 % \item column by column, fill in the data (30h) with errors detected in each paper;
7116 % \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).
7117 % \end{enumerate}
7118 % N.B.: Those scripts are not provided in the package, but can be obtained on demand.
7119 %
7120 %
7121 %^^A------------------------------------------------------------------------
7122 % \subsubsection{Manual Word to \LaTeX\ conversion}\label{sec:misc:word2latex}
7123 %
7124 % 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:
7125 % \begin{enumerate}
7126 % \item copy and paste the whole text;
7127 % \item update the header (author, title, affiliation);
7128 % \item add sections, subsections, etc. according to the original text;\\
7129 % update labels and references for sections, subsections, etc.;
7130 % \item insert figures and tables with the proceedings template style;\\
7131 % update labels and references for figures and tables;
7132 % \item update captions with the proceedings template style;
7133 % \item edit equations (inside the text and as separated formulae);\\
7134 % update labels and references for equations ;
7135 % \item replace all Word quotes ^^A(double “”‟ and single ‛' quotes)
7136 % by \LaTeX\ quotes (double ``'', and single `' quotes) to avoid they disappear (Unicode-related issue);
7137 % \item correct any specific formatting such as italic, capitals, bold, etc;
7138 % \item remove useless hyphenations ``-'' produced as line breaks by Word;
7139 % \item replace remaining hyphens by the proper corresponding one: dash `-' (hyphen), semi-quadratin `--' (ex: number range) and quadratin `---'.
7140 % \end{enumerate}
7141 %
7142 %^^A------------------------------------------------------------------------
7143 % \subsubsection{How to ensure the graphical quality?}\label{sec:misc:graph:quality}
7144 %
7145 % 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}).
7146 %
7147 %
7148 %
7149 %^^A------------------------------------------------------------------------
7150 % \subsubsection{How to ensure your fonts are embedded in the PDF?}\label{sec:misc:images:fonts}
7151 %
7152 % 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).
7153 % One of these important things is the font embedding.
7154 % 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!}.
7155 % 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}
7156 % **** Warning: Fonts with Subtype = /TrueType should be embedded.
7157 % The following fonts were not embedded:
7158 % Arial-ItalicMT
7159 % ArialMT
7160 %
7161 % **** This file had errors that were repaired or ignored.
7162 % **** The file was produced by:
7163 % **** >>>> pdfTeX-0.14h <<<<
7164 % **** Please notify the author of the software that produced this
7165 % **** file that it does not conform to Adobe's published PDF
7166 % **** specification.
7167 %\end{verbatim}
7168 % This can also be checked by processing a PDF files produced by Matlab using Acrobat Distiller (\$), and you will get the same errors...
7169 %
7170 % 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.
7171 %
7172 % If you cannot have it fixed by the author, then you need to use Acrobat Professional to do the job for you.
7173 % Utilities like \file{pdfinfo} and \file{pdffonts} are helpful to detect such problems as well as missing bounding boxes, with commands like:\\
7174 % \texttt{pdffonts [filename.pdf]}\\
7175 % \texttt{pdfinfo -box [filename.pdf]}
7176 %
7177 %
7178 %
7179 %^^A\changes{0.1c}{2007/07/30}{Customization: \file{confproc.cfg}}
7180 %
7181 % \color{black}
7182 %
7183 %
7184 %\changes{0.6}{\datevzdsix}{Doc: moved scripts after the full example and before implementation}
7185 %^^A\changes{0.2f}{2007/09/05}{Scripts: Unix `buildcls' script added}
7186 %^^A\changes{0.2g}{2007/09/07}{Scripts: Unix `buildcls' script shorten}
7187 %^^A\changes{0.2g}{2007/09/07}{Scripts: Unix `buildcls' script with chmod on the Perl script, + example of use of the script}
7188 %^^A\changes{0.2h}{2007/09/12}{Scripts: Unix `buildcls' script moves example files in `example/'}
7189 %^^A\changes{0.2i}{2007/09/24}{Scripts: Unix `buildcls' script moves the index style `confproc.ist' in `example/'}
7190 %
7191 %
7192 %^^A =================================================================
7193 % \section{Various scripts and utilities to save time} \label{sec:scripts}
7194 %
7195 %^^A =================================================================
7196 % \subsection{\file{buildcls.sh}: Build the class documentation and files}
7197 %
7198 % \begin{description}
7199 % \item[Name] \file{buildcls.sh}
7200 % \item[Type] Unix/bash script
7201 % \item [Purpose] generates the class files and documentation, and prepares the example-related files.
7202 % \item [Note] first set the path to \LaTeXe\ binaries before using it!
7203 % \end{description}
7204 % \begin{macrocode}
7205 %<*buildcls>
7206 #!/bin/sh
7207
7208 wd=`pwd`
7209
7210 % \end{macrocode}
7211 % First, you may set the path to \LaTeXe\ binaries:
7212 % \begin{macrocode}
7213 #-- set path to LaTeX binaries
7214 LaPath="/usr/texbin/" # TeXLive
7215
7216 % \end{macrocode}
7217 % and then, only if necessary, change the names to the \LaTeX{} compilers:
7218 % \begin{macrocode}
7219 #-- set names of LaTeX and related compilers
7220 Latex=$LaPath"pdflatex"
7221 Index=$LaPath"makeindex"
7222 % \end{macrocode}
7223 % as well as the document and example target names:
7224 % \begin{macrocode}
7225 Target="confproc" #- set document's name
7226 extarget="example/" #- set the example folder name
7227
7228 % \end{macrocode}
7229 % We can start building the documentation and the \file{.ins} file:
7230 % \begin{macrocode}
7231 #-- build doc, class and example files
7232 $Latex $Target.dtx #- build doc. and .ins file
7233 $Latex $Target.ins #- build class and example files
7234
7235 % \end{macrocode}
7236 % 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):
7237 % \begin{macrocode}
7238 #-- HACK: rename newapave2.sty
7239 mv newapave2.sty newapave.sty
7240
7241 % \end{macrocode}
7242 % Once it is done, we can finish the documentation. this full sequence is only necessary if you generate the implementation, index and changes history:
7243 % \begin{macrocode}
7244 cd $wd/
7245 #-- finish to build the documentation
7246 $Latex $Target.dtx #- re-run doc for toc update
7247 $Latex $Target.dtx #- re-run doc for proper back-references
7248 $Index -s gind.ist $Target #- with \CodelineIndex of \PageIndex
7249 $Index -s gglo.ist -o $Target.gls $Target.glo #- with \RecordChanges
7250 $Latex $Target.dtx #- insert index & list of changes, re-number
7251 $Latex $Target.dtx #- last run with proper page numbers
7252
7253 % \end{macrocode}
7254 % 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:
7255 % \begin{macrocode}
7256 #-- prepare scripts for cleaning package
7257 cd $wd
7258 chmod +x cleancls.sh
7259
7260 % \end{macrocode}
7261 % We then create the example folder and move all related files thanks to the \file{prepareexample.sh} script (sec. \ref{sec:script:prepareexample}):
7262 % \begin{macrocode}
7263 #-- prepare scripts for building example
7264 chmod +x prepareexample.sh
7265 ./prepareexample.sh
7266
7267 % \end{macrocode}
7268 % By uncommenting the last line, you will also build the example!
7269 % \begin{macrocode}
7270 #-- build example
7271 cd $extarget
7272 #./buildproc.sh
7273 %</buildcls>
7274 % \end{macrocode}
7275 % 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}
7276 %chmod +x buildcls
7277 %\end{verbatim}
7278 % Then, you can run it from the \verb+bash+ shell:\begin{verbatim}
7279 %./buildcls
7280 %\end{verbatim}
7281 %
7282 %
7283 %
7284 %
7285 %^^A\changes{0.2f}{2007/09/05}{Scripts: Unix `cleancls' script added}
7286 %^^A\changes{0.2g}{2007/09/07}{Scripts: Unix `cleancls' script shorten}
7287 %^^A =================================================================
7288 % \subsection{\file{cleancls.sh}: Clean up the class folder}
7289 %
7290 % \begin{description}
7291 % \item[Name] \file{cleancls.sh}
7292 % \item[Type] Unix/bash script
7293 % \item [Purpose] cleans up the folder where the class was generated.
7294 % \end{description}
7295 % \begin{macrocode}
7296 %<*cleancls>
7297 #!/bin/sh
7298
7299 % \end{macrocode}
7300 % Create a back up folder:
7301 % \begin{macrocode}
7302 mkdir backup #--- move the files to be kept
7303 % \end{macrocode}
7304 % Move original class documentation materials:
7305 % \begin{macrocode}
7306 mv confproc.dtx backup/
7307 mv confproc_diag.pdf backup/
7308 mv confproc-short.tex backup/
7309 mv confproc-short.pdf backup/
7310 % \end{macrocode}
7311 % Move building and cleaning scripts:
7312 % \begin{macrocode}
7313 mv buildcls.sh backup/
7314 cp cleancls.sh backup/
7315 % \end{macrocode}
7316 % Cleanup and place back the original minimal file set:
7317 % \begin{macrocode}
7318 rm *.* #--- clean up!
7319 mv backup/* . #--- move the backed up files
7320 rm -r backup #--- remove the temporary backup folder
7321 %</cleancls>
7322 % \end{macrocode}
7323 % You may want to use it to re-generate the whole package from the \file{.dtx} file.
7324 % Note that this script too is generated by the first \LaTeX\ run on the \package{confproc.dtx} file.
7325 %
7326 %
7327 %
7328 %^^A =================================================================
7329 % \subsection{\file{prepareexample.sh}: Prepare the example files, scripts and folders}\label{sec:script:prepareexample}
7330 %
7331 % \begin{description}
7332 % \item[Name] \file{prepareexample.sh}
7333 % \item[Type] Unix/bash script
7334 % \item [Purpose] prepares the example-related files, scripts and folders
7335 % \item [Note] first set the path to \LaTeXe\ binaries before using it!
7336 % \end{description}
7337 % \begin{macrocode}
7338 % \changes{0.7}{2010/08/05}{added \file{prepareexample.sh}}
7339 %<*prepareexample>
7340 #!/bin/sh
7341
7342 wd=`pwd`
7343
7344 % \end{macrocode}
7345 % Set the example folder name:
7346 % \begin{macrocode}
7347 extarget="example" #- set the example folder name
7348
7349 % \end{macrocode}
7350 % Then create the example folder:
7351 % \begin{macrocode}
7352 #-- prepare scripts for building example
7353 mkdir $extarget #- create the folder
7354
7355 #-- generate the program session files
7356 perl generateswitch.pl<exprogram.csv
7357
7358 % \end{macrocode}
7359 % and move the example-related files and scripts:
7360 % \begin{macrocode}
7361 mv ex*.* $extarget/ #- move all other example files into proper folder
7362 mv buildproc* $extarget/ #- move scripts into it
7363 mv buildcppdfpapers* $extarget/
7364 mv buildpapers* $extarget/
7365 mv countnbpages.sh $extarget/
7366 mv generateswitch.pl $extarget/
7367 mv papersinfo.sh $extarget/
7368 mv paperssplitpreamble.sh $extarget/
7369 mv removeLaTeXcmds.sh $extarget/
7370
7371 % \end{macrocode}
7372 % Also, copy folder and files that are common to the class documentation and the example:
7373 % \begin{macrocode}
7374 cp -r pictures $extarget/ #- copy pictures into it
7375 cp -r papers $extarget/ #- copy papers into it
7376 cp confproc.cls $extarget/ #- copy the class into it
7377 cp confproc*.ist $extarget/ #- copy the index style into it
7378 cp newapave* $extarget/ #- copy the newapave bib style files
7379
7380 % \end{macrocode}
7381 % Move the \file{expages.tex} generated file to the right place, and prepare the \package{pdftk} information folder:
7382 % \begin{macrocode}
7383 #-- prepare building scripts and generate needed directories
7384 cd $wd/$extarget
7385 mkdir pdftk_info/
7386 mv expages.tex papers/
7387
7388 % \end{macrocode}
7389 % Change the permission of the example-related scripts:
7390 % \begin{macrocode}
7391 cd $wd/$extarget
7392 chmod +x buildproc*
7393 chmod +x generateswitch.pl
7394 chmod +x exportIndividualPDFs.sh
7395 chmod +x papersinfo.sh
7396 chmod +x paperssplitpreamble.sh
7397 cd ..
7398
7399 % \end{macrocode}
7400 % By uncommenting the last line, we also build the example!
7401 % \begin{macrocode}
7402 #-- build example
7403 cd $wd/$extarget
7404 #./buildproc.sh
7405 %</prepareexample>
7406 % \end{macrocode}
7407 % \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}
7408 % chmod +x prepareexample.sh # change its permissions
7409 %\end{verbatim}
7410 % Then, you can run it from the \verb+bash+ shell:\begin{verbatim}
7411 %./prepareexample.sh
7412 %\end{verbatim}
7413 %
7414 %
7415 %
7416 %^^A =================================================================
7417 % \subsection{\file{generateswitch.pl}: Generate the paper switch and program [Perl]}
7418 % \label{sec:scripts:perl}
7419 %
7420 %^^A\changes{0.2c}{2007/08/17}{Scripts: Perl script 'generateswitch.pl' to generate 'paperswitch.tex' and 'sessions.tex' added}
7421 %^^A\changes{0.2d}{2007/08/18}{Scripts: Perl script to generate 'generateswitch.pl' added}
7422 %^^A\changes{0.2d}{2007/08/18}{Scripts: Perl script 'generateswitch.pl' modified to insert bookmarks, and text shorten}
7423 %^^A\changes{0.2d}{2007/08/20}{Scripts: Perl script modified and authors pdfboomarks added}
7424 %^^A\changes{0.2g}{2007/09/07}{Scripts: changing input file line break style (Unix instead of Max)}
7425 %^^A\changes{0.2h}{2007/09/12}{Scripts: Perl script is case insensitive for session names 9and has more options)}
7426 %^^A =================================================================
7427 %^^A Here is the creation of the procwitchandtoc.pl file, part of the example.
7428 %^^A It is written on first LaTeX run if it does not already exist
7429 %^^A =================================================================
7430 %
7431 % \begin{description}
7432 % \item[Name] \file{generateswitch.pl}
7433 % \item[Type] Perl script
7434 % \item [Purpose] generates TOC-related example files: paper switch in \file{expapersswitch.tex} and papers order by sessions and days in \file{exsessions.tex}.
7435 % \item to use it, type in a bash terminal: \verb+perl generateswitch.pl<exprogram.csv+ (or any other program file).
7436 % \end{description}
7437 %
7438 % \begin{macrocode}
7439 %<*generateswitch>
7440 #!/usr/bin/perl -w
7441
7442 # generateswitch.pl
7443 # created as dafxproctoc.pl by Marc Zadel, 2006-04-28
7444 # modified for confproc.cls by Vincent Verfaille, 2007-08-08 (v0.4) & 2009-10-30 (v0.7)
7445 # Execute as
7446 # ./generateswitch.pl < intputfile.txt >
7447
7448 use strict;
7449 use Text::ParseWords;
7450 open(SWI, ">expapersswitch.tex"); #open for write, overwrite
7451 open(SESSIONS, ">exsessions.tex"); #open for write, overwrite
7452
7453 # ----- Configuration
7454 # field separator for the input file
7455 my $fieldseparator=',';
7456
7457 # mac line endings: "\r" / Unix line endings: :\n"
7458 $/ = "\n"; # line endings for the input file
7459 $\ = "\n"; # line endings for the output file
7460
7461 # ----- Subroutines
7462 # -- split one line of input into a hash with named fields
7463 sub parseinputline {
7464 my ($inputline) = @_;
7465
7466 # escape single quotes on the input line: they interfere with quotewords()'s
7467 # quote handling (ie, they start to quote stuff)
7468 $inputline =~ s/'/\\'/g;
7469
7470 # parse the input line
7471 my @wordlist = &quotewords($fieldseparator, 0, $inputline);
7472
7473 # replace accented characters with latex escaped equivalents. Use it after
7474 # quotewords() so the '\' don't get interpreted by quotewords() as escapes
7475 foreach my $word ( @wordlist ) {
7476 if ( $word ) { $word = &latexifyaccentedcharacters($word); }
7477 }
7478
7479 # extract the fields into local variables. Author names stored as a list
7480 my ($type, $number, $pcdecision, $nbpages, $title, $filename,
7481 $generatedfrom, $cite) = @wordlist;
7482
7483 # remove the first 8 elements (just parsed out), leaving only author names.
7484 # reminder: list of 8 scalars, though some may be "" if less than 4 authors
7485 splice( @wordlist, 0, 8 );
7486
7487 # store the author names as a list of lists. We end up with a list that looks
7488 # like ((Udo,Zoelzer),(Daniel,Arfib))
7489 my @authors = ();
7490 while ( $wordlist[0] ) {
7491 push( @authors, [splice( @wordlist, 0, 2 )] );
7492 # "splice( @wordlist, 0, 2 )": cuts the first 2 scalars off of @wordlist
7493 # and returns them; calling [splice(@wordlist,0,2)] returns a *reference*
7494 # to a list containing the first two scalars. (see perldoc perldsc.)
7495 }
7496
7497 # create a hash reference containing the named fields and return it
7498 my $fields = {
7499 type => $type,
7500 number => $number,
7501 pcdecision => $pcdecision,
7502 nbpages => $nbpages,
7503 title => $title,
7504 generatedfrom => $generatedfrom,
7505 filename => $filename,
7506 cite => $cite,
7507 authors => \@authors,
7508 };
7509 return $fields;
7510 }
7511
7512 # -- takes a string in Mac OS Roman encoding and encode the accented
7513 # characters with latex escapes (only for a subset of available characters).
7514 sub latexifyaccentedcharacters {
7515 # for mapping between unicode and mac os western encoding, see:
7516 # http://www.unicode.org/Public/MAPPINGS/VENDORS/APPLE/ROMAN.TXT
7517 my ($inputstring) = @_;
7518 $inputstring =~ s/\x8a/\\"a/g; # \"a: unicode 0xe4, mac os western 0x8a
7519 $inputstring =~ s/\x87/\\'a/g; # \'a: unicode 0xe9, mac os western 0x87
7520 $inputstring =~ s/\x88/\\`a/g; # \`a: unicode 0xe8, mac os western 0x88
7521 $inputstring =~ s/\x8e/\\'e/g; # \'e: unicode 0xe9, mac os western 0x8e
7522 $inputstring =~ s/\x8f/\\`e/g; # \`e: unicode 0xe8, mac os western 0x8f
7523 $inputstring =~ s/\x91/\\"e/g; # \"e: unicode 0xeb, mac os western 0x91
7524 $inputstring =~ s/\x97/\\'o/g; # \'o: unicode 0xf3, mac os western 0x97
7525 $inputstring =~ s/\x98/\\`o/g; # \`o: unicode 0xf2, mac os western 0x98
7526 $inputstring =~ s/\x9a/\\"o/g; # \"o: unicode 0xf6, mac os western 0x9a
7527 $inputstring =~ s/\x99/\\^o/g; # \^o: unicode 0xf4, mac os western 0x99
7528 $inputstring =~ s/\xbf/\\o /g; # \o: unicode 0xf8, mac os western 0xbf
7529 $inputstring =~ s/\x96/\\~n /g; # \~n: unicode 0xF1, mac os western 0x96
7530 $inputstring =~ s/\x94/\\^{\\i}/g; # \^{\i}: unicode 0xee, mac os western 0x94
7531 $inputstring =~ s/\x/\\i/g; # \i: unicode , mac os western
7532 $inputstring =~ s/\x9f/\\"u/g; # \"u: unicode 0xfc, mac os western 0x9f
7533 $inputstring =~ s/\x5c/\\/g; # \: unicode 0x5C, mac os western 0x5C
7534
7535 return $inputstring;
7536 }
7537
7538 # -- output the information for a day
7539 sub outputdaylatex {
7540 my ($fields) = @_;
7541 my $sessiontitle = $fields->{'title'};
7542 open(SESSIONS, ">>exsessions.tex"); #open for append
7543 print SESSIONS ' ';
7544 print SESSIONS '%%%== Day';
7545 print SESSIONS '\procday{', $sessiontitle, '}'
7546 }
7547
7548 # -- output the information for a session line
7549 sub outputsessionlatex {
7550 my ($fields) = @_;
7551 my $sessiontitle = $fields->{'title'};
7552 open(SESSIONS, ">>exsessions.tex"); #open for append
7553 print SESSIONS ' ';
7554 print SESSIONS '%%%-- session';
7555 print SESSIONS '\session{', $sessiontitle, '}'
7556 }
7557
7558 # -- in: ref. to a list of lists of author names ((Udo,Zoelzer),(Daniel,Arfib))
7559 # out: ref. to a Perl list w/ entries "Udo Zoelzer" and "Daniel Arfib" (no quotes)
7560 sub authorsbyfirstname {
7561 my ($authors) = @_;
7562 # generate a list of full "first last" author names
7563 my @authorlistbyfirstname = map { "$_->[0] $_->[1]" } @$authors;
7564 return \@authorlistbyfirstname; # return a ref. to the new list of authors
7565 }
7566
7567 # -- in: ref. to a list of lists of author names ((Udo,Zoelzer),(Daniel,Arfib))
7568 # out: ref. to a Perl list w/ entries "Zoelzer, Udo" and "Arfib, Daniel"
7569 sub authorsbysurname {
7570 my ($authors) = @_;
7571 # generate a list of authors with surnames written first
7572 my @authorlistbysurname = map { "$_->[1], $_->[0]" } @$authors;
7573 return \@authorlistbysurname; # return a ref. to the new list of authors
7574 }
7575
7576 # -- in: ref. to a list of author names: "Zoelzer, Udo" and "Arfib, Daniel"
7577 # out: LaTeX index entries: "\index{Zoelzer, Udo}\index{Arfib, Daniel}"
7578 sub genindex {
7579 my ($authorsbysurname) = @_;
7580 my @indexentries = map { "\\index{$_}" } @$authorsbysurname;
7581 return join('', @indexentries);
7582 }
7583
7584 # -- in: ref. to a list of author names: "Zoelzer, Udo" and "Arfib, Daniel"
7585 # out: bookmarks cmds: "\pdfbookmark[2]{Udo Zoelzer}{#2.Udo Zoelzer}
7586 # \pdfbookmark[2]{Daniel Arfib}{#2.Daniel Arfib}"
7587 sub genbookmark {
7588 my ($authorsbyfirstname) = @_;
7589 my @indexentries = map { "\\pdfbookmark[2]{$_}{#2.$_}" }
7590 @$authorsbyfirstname;
7591 return join('', @indexentries);
7592 }
7593
7594 # -- output the information for a paper line
7595 sub outputpaperlatex {
7596 my ($fields) = @_;
7597 open(SWI, ">>expapersswitch.tex"); #open for append
7598 print SWI '%======= PAPER ID = ', $fields->{'number'}, ' =======';
7599 print SWI '\ifnum\paperswitch=', $fields->{'number'};
7600 print SWI ' \procpaper[xshift=\LaTeXxShift{}, yshift=\LaTeXyShift{}, npages=',
7601 $fields->{'nbpages'}, ', switch=\paperswitch,%';
7602 print SWI ' title={', $fields->{'title'}, '},% paper title';
7603 print SWI ' author={', join( ', ', @{&authorsbyfirstname($fields->{'authors'})}),
7604 '},% list of authors';
7605 print SWI ' index={', &genindex(&authorsbysurname($fields->{'authors'})),
7606 '},% authors index entries';
7607 print SWI ' cite={', $fields->{'cite'}, '},% cited bib items';
7608 # print SWI ' {#2}{\paperbookmark}';
7609 print SWI ' bookmark={', &genbookmark(&authorsbyfirstname($fields->{'authors'})),'}% for PDF bookmark structure';
7610 print SWI ' ]{#2}';
7611 print SWI '\fi';
7612 print SWI ' ';
7613 open(SESSIONS, ">>exsessions.tex"); #open for write, overwrite
7614 print SESSIONS '\paperid{', $fields->{'number'}, '}{', $fields->{'filename'}, '}';
7615 }
7616
7617 # ----- Main
7618 # FIXME: parse a line, and confirm that all of the fields are set up properly
7619 # --> correct number of fields, and the fields have the correct values
7620 open(SWI, ">>expapersswitch.tex"); #open for write, overwrite
7621 print SWI '\newcommand{\paperid}[2]{';
7622 print SWI ' ';
7623 print SWI '\renewcommand{\paperswitch}{#1}';
7624 print SWI ' ';
7625
7626 while ( <> ) {
7627 chomp; # clear the newline character from the end of the line
7628 my $fields = &parseinputline($_); # parse the line into fields
7629 # take some action depending on what type of line it is; case insensitive
7630 if ( lc($fields->{'type'}) eq lc('day') ) {
7631 &outputdaylatex($fields);
7632 } elsif ( lc($fields->{'type'}) eq lc('session')
7633 || lc($fields->{'type'}) eq lc('paper session')
7634 || lc($fields->{'type'}) eq lc('demo session')
7635 || lc($fields->{'type'}) eq lc('poster session') ) {
7636 &outputsessionlatex($fields);
7637 } elsif ( lc($fields->{'type'}) eq lc('oral')
7638 || lc($fields->{'type'}) eq lc('paper')
7639 || lc($fields->{'type'}) eq lc('demo')
7640 || lc($fields->{'type'}) eq lc('poster') ) {
7641 &outputpaperlatex($fields);
7642 } elsif ( lc($fields->{'type'}) eq lc('Type')) {
7643 } else { print '!!! a day, session or paper (',
7644 $fields->{'type'},') is lost by the script...';
7645 }
7646 open(SWI, ">>expapersswitch.tex"); #open for append
7647 }
7648 print SWI '}';
7649 close(SWI);
7650 close(SESSIONS);
7651 %</generateswitch>
7652 % \end{macrocode}
7653 %
7654 %
7655 %
7656 %^^A =================================================================
7657 % \subsection{\file{buildproc.sh}: Build the proceedings}\label{sec:confproc:compil:script}\label{sec:scripts:buildproc}
7658 %
7659 % \begin{description}
7660 % \item[Name] \file{buildproc.sh}
7661 % \item[Type] Unix/bash script
7662 % \item[Purpose] describes all compilation steps to produce the final version of the proceedings
7663 % \item[Note] This script is the most important!
7664 % \end{description}
7665 % 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).
7666 %
7667 %
7668 %^^A\changes{0.1d}{2007/08/01}{Adding the buildproc script creation.}
7669 %^^A =================================================================
7670 %^^A Here is the creation of the buildproc script file, part of the example.
7671 %^^A It is written on first LaTeX run if it does not already exist
7672 %^^A =================================================================
7673 %
7674 % \begin{macrocode}
7675 %<*buildproc>
7676 #!/bin/sh
7677
7678 % \end{macrocode}
7679 % We set the user-dependent the original file name (no extension):
7680 % \begin{macrocode}
7681 #--- set user dependent file name
7682 TEXFILE="example3optim"
7683 % \end{macrocode}
7684 % Let us now set system-dependent variables: the path the the \LaTeX{} distribution as well as the binaries:
7685 % \begin{macrocode}
7686 #--- set system-dependent variables
7687 LATEXPATH="/usr/texbin/" # for TexLive
7688 #--- set compilers' paths
7689 PDFLATEX=$LATEXPATH"pdflatex"
7690 BIBTEX=$LATEXPATH"bibtex"
7691 MAKEINDEX=$LATEXPATH"makeindex"
7692 mkdir pdftk_info/
7693
7694 % \end{macrocode}
7695 % \begin{itemize}
7696 % \item we copy the class options (including \Lopt{bib=backref}) to the file called by the core file:
7697 % \end{itemize}
7698 % \begin{macrocode}
7699 #--- class settings: "empty" option and binding
7700 cp exclasspre.tex exclass.tex
7701 % \end{macrocode}
7702
7703 % \begin{itemize}
7704 % \item we run \LaTeX{} once to generate the table of contents:
7705 % \end{itemize}
7706 % \begin{macrocode}
7707 #--- Compile
7708 separator='___________________________________________________'
7709 echo; echo; echo; echo; echo; echo; echo $separator; echo $separator;
7710 echo '*** PdfLaTeX: create toc (1/6) ***'
7711 $PDFLATEX $TEXFILE.tex
7712
7713 % \end{macrocode}
7714 % \begin{itemize}
7715 % \item we run bib\TeX{} once to generate the bibliography:
7716 % \end{itemize}
7717 % \begin{macrocode}
7718 echo; echo; echo; echo; echo; echo; echo $separator; echo $separator;
7719 echo '*** Bibtex: generate the general biblio. (2/6) ***'
7720 $BIBTEX $TEXFILE
7721
7722 % \end{macrocode}
7723 % \begin{itemize}
7724 % \item we run \package{makeindex} once to generate the author index:
7725 % \end{itemize}
7726 % \begin{macrocode}
7727 echo; echo; echo; echo; echo; echo; echo $separator; echo $separator;
7728 echo '*** Makeindex: create index of authors (3/6) ***'
7729 $MAKEINDEX -s confproc2.ist $TEXFILE.idx
7730
7731 % \end{macrocode}
7732 % \begin{itemize}
7733 % \item we run \LaTeX{} once to insert the table of contents, index and bibliography, and update their page numbers for next run:
7734 % \end{itemize}
7735 % \begin{macrocode}
7736 echo; echo; echo; echo; echo; echo; echo $separator; echo $separator;
7737 echo '*** PdfLaTeX: add toc + insert index and bibliography (4/6) ***'
7738 $PDFLATEX $TEXFILE.tex
7739
7740 % \end{macrocode}
7741 % \begin{itemize}
7742 % \item we run \LaTeX{} once again to insert update page numbers in the table of contents, index and bibliography:
7743 % \end{itemize}
7744 % \begin{macrocode}
7745 echo; echo; echo; echo; echo; echo; echo $separator; echo $separator;
7746 echo '*** PdfLaTeX: createupdate toc, index and bib page numbers (5/6) ***'
7747 $PDFLATEX $TEXFILE.tex
7748
7749 % \end{macrocode}
7750 % \begin{itemize}
7751 % \item we do the final \LaTeX{} run:
7752 % \end{itemize}
7753 % \begin{macrocode}
7754 echo; echo; echo; echo; echo; echo; echo $separator; echo $separator;
7755 echo '*** PdfLaTeX: mod. class insertion, for proper PDF links for full papers (6/6) ***'
7756 $PDFLATEX $TEXFILE.tex
7757 %</buildproc>
7758 % \end{macrocode}
7759 %
7760 %
7761 %
7762 %^^A =================================================================
7763 % \subsection{\file{buildprocelpb.sh}: Generate both paperback and electronic final versions}\label{sec:scripts:buildprocelpb}
7764 %
7765 % \begin{description}
7766 % \item[Name] \file{buildprocelpb.sh}
7767 % \item[Type] Unix/bash script
7768 % \item[Purpose] describes all compilation steps to produce the final version of both paperback and electronic proceedings
7769 % \item[Note] This script helps to automatize the whole production process; its is described/commented as an incrementation from \file{buildproc.sh}.
7770 % \end{description}
7771 %
7772 %
7773 %^^A =================================================================
7774 %^^A Here is the creation of the buildprocelpb.sh script file, part of the example.
7775 %^^A It is written on first LaTeX run if it does not already exist
7776 %^^A =================================================================
7777 %\changes{0.6}{\datevzdsix}{added \file{buildproc2.sh}}
7778 %\changes{0.7}{2010/08/05}{renamed \file{buildproc2.sh} into \file{buildprocelpb.sh}}
7779 %
7780 % We first set the user-dependent file names and folders, namely:
7781 % \begin{macrocode}
7782 % \changes{0.7}{2010/08/05}{added \file{buildprocelpb.sh}}
7783 % \color{black!50}
7784 %<*buildprocelpb>
7785 #!/bin/bash
7786
7787 #--- set user dependent file name
7788 % \end{macrocode}
7789 % \color{black}
7790 % \begin{itemize}
7791 % \item the original file name (no extension):
7792 % \end{itemize}
7793 % \begin{macrocode}
7794 INTEXFILE="example4optim"
7795 % \end{macrocode}
7796 % \begin{itemize}
7797 % \item the target file name (no extension):
7798 % \end{itemize}
7799 % \begin{macrocode}
7800 TEXFILE="proceedings"
7801 % \end{macrocode}
7802 % \begin{itemize}
7803 % \item the working directory:
7804 % \end{itemize}
7805 % \begin{macrocode}
7806 TEXFILEPATH="example"
7807 % \end{macrocode}
7808 % \begin{itemize}
7809 % \item the target directories for paperback and electronic versions:
7810 % \end{itemize}
7811 % \begin{macrocode}
7812 PAPERBACKFOLDER="PDF_printed/"
7813 ELECTRONICFOLDER="PDF_electronic/"
7814
7815 % \end{macrocode}
7816 % We then define the names of \LaTeX{} files containing the class options before the last run (ie. with bibliography back-references):
7817 % \begin{macrocode}
7818 #--- different class options for electronic vs paperback version
7819 class_paperback_pre=exclasspre
7820 % \end{macrocode}
7821 % and the names of \LaTeX{} files containing the class options for the last run for both paperback and electronic versions:
7822 % \begin{macrocode}
7823 class_paperback_final=exclasslastpb
7824 class_electronic_final=exclasslastel
7825
7826 % \end{macrocode}
7827 % Let us now set system-dependent variables: the path the the \LaTeX{} distribution as well as the binaries:
7828 % \color{black!50}
7829 % \begin{macrocode}
7830 #--- set system-dependent variables
7831 LATEXPATH="/usr/texbin/" # TexLive
7832
7833 #--- set compilers' paths
7834 PDFLATEX=$LATEXPATH"pdflatex"
7835 BIBTEX=$LATEXPATH"bibtex"
7836 MAKEINDEX=$LATEXPATH"makeindex"
7837
7838 % \end{macrocode}
7839 % \color{black}
7840 % We then define temporary folders for splitting the proceedings back into separate files with proper PDF metadata:
7841 % \begin{macrocode}
7842 #--- set script-specific paths
7843 GPATH=`pwd` # general proc path
7844 PAPERBACKFOLDER=${GPATH}/${PAPERBACKFOLDER}
7845 ELECTRONICFOLDER=${GPATH}/${ELECTRONICFOLDER}
7846 PDFPATH="${ELECTRONICFOLDER}/papers"
7847 PDFTKPATH="pdftk_info/"
7848 INPATH="tmp/papersinfo/"
7849 SPPATH="tmp/papers_split/"
7850
7851 % \end{macrocode}
7852 % Let us now create the needed folders:
7853 % \begin{macrocode}
7854 #=== prepare output folders
7855 mkdir -p ${PAPERBACKFOLDER}
7856 mkdir -p ${ELECTRONICFOLDER}
7857 rm -r ${ELECTRONICFOLDER}/papers/
7858 mkdir -p ${ELECTRONICFOLDER}/papers/
7859 mkdir -p $INPATH
7860 mkdir -p $SPPATH
7861 mkdir -p $PDFTKPATH
7862
7863 % \end{macrocode}
7864 % We can now move to the working directory and start building the paperback version:
7865 % \begin{macrocode}
7866 #=== GO TO LaTeX FOLDER !!!
7867 cd ${GPATH}
7868
7869 % \end{macrocode}
7870 % \begin{itemize}
7871 % \item we generate the \LaTeX{} file by concatenating the class options (including \Lopt{bib=backref}) with the file core:
7872 % \end{itemize}
7873 % \begin{macrocode}
7874 #=== MAKE PAPERBACK VERSION
7875 #--- class settings: "empty" option and binding
7876 cat ${class_paperback_pre}.tex ${INTEXFILE}.tex >${TEXFILE}.tex
7877
7878 % \end{macrocode}
7879 % \begin{itemize}
7880 % \item we run \LaTeX{} once to generate the table of contents:
7881 % \end{itemize}
7882 % \color{black!50}
7883 % \begin{macrocode}
7884 #--- Compile
7885 separator='___________________________________________________'
7886 echo; echo; echo; echo; echo; echo; echo $separator; echo $separator;
7887 echo '*** PdfLaTeX: create toc (1/6) ***'
7888 $PDFLATEX $TEXFILE.tex
7889
7890 % \end{macrocode}
7891 % \color{black}
7892 % \begin{itemize}
7893 % \item we run bib\TeX{} once to generate the bibliography:
7894 % \end{itemize}
7895 % \color{black!50}
7896 % \begin{macrocode}
7897 echo; echo; echo; echo; echo; echo; echo $separator; echo $separator;
7898 echo '*** Bibtex: generate the general biblio. (2/6) ***'
7899 $BIBTEX $TEXFILE
7900
7901 % \end{macrocode}
7902 % \color{black}
7903 % \begin{itemize}
7904 % \item we run \package{makeindex} once to generate the author index:
7905 % \end{itemize}
7906 % \color{black!50}
7907 % \begin{macrocode}
7908 echo; echo; echo; echo; echo; echo; echo $separator; echo $separator;
7909 echo '*** Makeindex: create index of authors (3/6) ***'
7910 $MAKEINDEX -s confproc2.ist $TEXFILE.idx
7911
7912 % \end{macrocode}
7913 % \color{black}
7914 % \begin{itemize}
7915 % \item we run \LaTeX{} once to insert the table of contents, index and bibliography, and update their page numbers for next run:
7916 % \end{itemize}
7917 % \color{black!50}
7918 % \begin{macrocode}
7919 echo; echo; echo; echo; echo; echo; echo $separator; echo $separator;
7920 echo '*** PdfLaTeX: add toc + insert index and bibliography (4/6) ***'
7921 $PDFLATEX $TEXFILE.tex
7922
7923 % \end{macrocode}
7924 % \color{black}
7925 % \begin{itemize}
7926 % \item we run \LaTeX{} once again to insert update page numbers in the table of contents, index and bibliography:
7927 % \end{itemize}
7928 % \color{black!50}
7929 % \begin{macrocode}
7930 echo; echo; echo; echo; echo; echo; echo $separator; echo $separator;
7931 echo '*** PdfLaTeX: createupdate toc, index and bib page numbers (5/6) ***'
7932 $PDFLATEX $TEXFILE.tex
7933
7934 % \end{macrocode}
7935 % \color{black}
7936 % \begin{itemize}
7937 % \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:
7938 % \end{itemize}
7939 % \begin{macrocode}
7940 #--- class settings: "final" option and binding
7941 cat ${class_paperback_final}.tex ${INTEXFILE}.tex >${TEXFILE}.tex
7942
7943 % \end{macrocode}
7944 % \begin{itemize}
7945 % \item we do the final \LaTeX{} run:
7946 % \end{itemize}
7947 % \color{black!50}
7948 % \begin{macrocode}
7949 echo; echo; echo; echo; echo; echo; echo $separator; echo $separator;
7950 echo '*** PdfLaTeX: mod. class insertion, for proper PDF links for full papers (6/6) ***'
7951 $PDFLATEX $TEXFILE.tex
7952
7953 % \end{macrocode}
7954 % \color{black}
7955 % \begin{itemize}
7956 % \item and save the file in the appropriate folder:
7957 % \end{itemize}
7958 % \begin{macrocode}
7959 #--- save PDF
7960 cp ${TEXFILE}.pdf $PAPERBACKFOLDER/${TEXFILE}.pdf
7961
7962 % \end{macrocode}
7963 % The process is the exact same for the electronic version:
7964 % \begin{macrocode}
7965 #=== MAKE ELECTRONIC VERSION FOR CD, FROM PAPERBACK VERSION
7966 #--- class settings: "final" option and no binding
7967 cd ${GPATH}/${TEXFILEPATH}
7968 cat ${class_electronic_final}.tex ${INTEXFILE}.tex >${TEXFILE}.tex
7969
7970 % \end{macrocode}
7971 % \color{black!50}
7972 % \begin{macrocode}
7973 #--- Compile
7974 echo; echo; echo; echo; echo; echo; echo $separator; echo $separator;
7975 echo '*** PdfLaTeX: create toc (1/6) ***'
7976 $PDFLATEX $TEXFILE.tex
7977
7978 echo; echo; echo; echo; echo; echo; echo $separator; echo $separator;
7979 echo '*** Bibtex: generate the general biblio. (2/6) ***'
7980 $BIBTEX $TEXFILE
7981
7982 echo; echo; echo; echo; echo; echo; echo $separator; echo $separator;
7983 echo '*** Makeindex: create index of authors (3/6) ***'
7984 $MAKEINDEX -s confproc2.ist $TEXFILE.idx
7985
7986 echo; echo; echo; echo; echo; echo; echo $separator; echo $separator;
7987 echo '*** PdfLaTeX: add toc (4/6) ***'
7988 $PDFLATEX $TEXFILE.tex
7989
7990 echo; echo; echo; echo; echo; echo; echo $separator; echo $separator;
7991 echo '*** PdfLaTeX: create toc + include index (5/6) ***'
7992 $PDFLATEX $TEXFILE.tex
7993
7994 % \end{macrocode}
7995 % \color{black}
7996 % \begin{macrocode}
7997 #--- class settings: "final" option and binding
7998 cat ${class_paperback_final}.tex ${INTEXFILE}.tex >${TEXFILE}.tex
7999
8000 % \end{macrocode}
8001 % \color{black!50}
8002 % \begin{macrocode}
8003 echo; echo; echo; echo; echo; echo; echo $separator; echo $separator;
8004 echo '*** PdfLaTeX: mod. class insertion, for proper PDF links for full papers (6/6) ***'
8005 $PDFLATEX $TEXFILE.tex
8006
8007 % \end{macrocode}
8008 % \color{black}
8009 % Once the PDF file is generated, is ts saved: and
8010 % \begin{macrocode}
8011 mkdir ${ELECTRONICFOLDER}/papers/
8012 #--- save PDF
8013 echo "cmd: cp ${TEXFILE}.pdf ${GPATH}/${ELECTRONICFOLDER}/${TEXFILE}.pdf"
8014 cp ${TEXFILE}.pdf $ELECTRONICFOLDER/${TEXFILE}.pdf
8015
8016 % \end{macrocode}
8017 % We can then generate individual PDFs with proper PDF metadata:
8018 % \begin{macrocode}
8019 #=== EXPORT individual pdf papers back from the proceedings + hdr/footers/metadata
8020 cd ${GPATH}
8021 echo; echo; echo; echo; echo; echo; echo $separator; echo $separator;
8022 echo '*** Export individual PDFs ***'
8023 echo "cmd: ./exportIndividualPDFs.sh ${GPATH} ${TEXFILEPATH}/${TEXFILE} ${INPATH} ${SPPATH} ${PDFPATH} ${PDFTKPATH}"
8024 ./exportIndividualPDFs.sh ${GPATH} ${TEXFILE} ${INPATH} ${SPPATH} ${PDFPATH} ${PDFTKPATH}
8025
8026 % \end{macrocode}
8027 % and clean up the temporary folder if uncommented:
8028 % \begin{macrocode}
8029 # rm -r ${GPATH}/tmp/
8030 %</buildprocelpb>
8031 % \end{macrocode}
8032 %
8033 % \color{black}
8034 %
8035 %
8036 %
8037 %
8038 %^^A =================================================================
8039 % \subsection{\file{countnbpages.sh}: Count the number of pages of individual PDFs}\label{sec:scripts:countnbpages}
8040 %
8041 % \begin{description}
8042 % \item[Name] \file{countnbpages.sh}
8043 % \item[Type] Unix/bash script
8044 % \item [Purpose] counts each \file{.pdf}'s number of pages, and stores them in a \file{proceedings.npc} file.
8045 % \end{description}
8046 % 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.
8047 %
8048 %^^A\changes{0.5}{\datevzfive}{Add the `countnbpages' script creation.}
8049 %^^A =================================================================
8050 %^^A Here is the creation of the countnbpages.sh script file, part of the example.
8051 %^^A It is written on first LaTeX run if it does not already exist
8052 %^^A =================================================================
8053 %
8054 % \begin{macrocode}
8055 % \changes{0.7}{2010/08/05}{added \file{countnbpages.sh}}
8056 %<*countnbpages>
8057 #!/bin/sh
8058
8059 % \end{macrocode}
8060 % We first set the path to \LaTeX{} binaries and names of \LaTeX{} compiler:
8061 % \begin{macrocode}
8062 #-- set path to LaTeX binaries
8063 LATEXPATH="/usr/texbin/" # TeXLive
8064 #-- set names of LaTeX and related compilers
8065 PDFLATEX=$LATEXPATH"pdflatex"
8066
8067 % \end{macrocode}
8068 % We then set the document name and papers' folder name:
8069 % \begin{macrocode}
8070 TEXFILE="simple_proceedings" #- set document's name
8071 PDFSPATH="papers" #- set the papers' folder name
8072
8073 % \end{macrocode}
8074 % We remove previous \file{.npt} file:
8075 % \begin{macrocode}
8076 rm -f ${TEXFILE}.npt # count pages from terminal
8077 cd ${PDFSPATH}
8078 % \end{macrocode}
8079 % For each \file{.pdf} file, we count its number of pages using the \file{pdfinfo}\footnote{\file{pdfinfo} can be downloaded from \url{}} script:
8080 % \begin{macrocode}
8081 for file in *.pdf
8082 do
8083 pdfinfo -meta $file | grep "Pages:" > tmp0
8084 echo "file $file has `sed 's/.*\([0-9]\).*/\1/' < tmp0` pages" >> ../${TEXFILE}.npt
8085 done
8086 rm -f tmp0
8087 cd ..
8088 more ${TEXFILE}.npt
8089 %</countnbpages>
8090 % \end{macrocode}
8091 %
8092 % \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.
8093 %
8094 %
8095 %^^A =================================================================
8096 % \subsection{\file{exportIndividualPDFs.sh}: Export individual PDF papers from the proceedings}\label{sec:scripts:exportIndividualPDFs}
8097 %
8098 % \begin{description}
8099 % \item[Name] \file{exportIndividualPDFs.sh}
8100 % \item[Type] Unix/bash script
8101 % \item[Purpose] exports each individual paper from the whole proceedings, provided that a \file{proceedings.pdftk} file exists
8102 % \item[Dependencies] \file{paperssplitpreamble.sh} and \file{papersinfo.sh}
8103 % \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.
8104 % \end{description}
8105 %
8106 % \color{black}
8107 %
8108 %^^A =================================================================
8109 %^^A Here is the creation of the exportIndividualPDFs.sh script file, part of the example.
8110 %^^A It is written on first LaTeX run if it does not already exist
8111 %^^A =================================================================
8112 %
8113 % We first set macros from the script arguments (path, \TeX\ file name without extension,
8114 % paper info folder, split PDFs folder, PDF proceedings folder):
8115 %\changes{0.6}{\datevzdsix}{added \file{exportIndividualPDFs.sh}}
8116 % \begin{macrocode}
8117 % \changes{0.7}{2010/08/05}{added \file{exportIndividualPDFs.sh}}
8118 %<*exportIndividualPDFs>
8119 #!/bin/bash
8120
8121 args=("$@")
8122 GPATH=${args[0]} #= ~/e-proceedings
8123 TEXFILE=${args[1]} #= proceedings
8124 INPATH=${args[2]} #= papers_info
8125 #mkdir -p $INPATH
8126 SPPATH=${args[3]} #= papers_split
8127 #mkdir -p $SPPATH
8128 PDFPATH=${args[4]}
8129 PDFTKPATH=${args[5]}
8130
8131 PDFFILE=${TEXFILE}.pdf # for use in the paper_split.sh and paper_info.sh scripts
8132
8133 echo "-PATH (working path): $GPATH"
8134 echo "-TeX file (orig. TeX proc): $TEXFILE"
8135 echo "-PDF: $PDFFILE (original PDF proc)"
8136 echo "-PDFPATH (indiv. PDFs): $PDFPATH "
8137 echo "-PDFTKPATH (pdftk info): $PDFTKPATH"
8138 echo "-INPATH (papers info): $INPATH"
8139 echo "-SPPATH (split papers): $SPPATH"
8140
8141 % \end{macrocode}
8142 % we move to the PDFtk folder:
8143 % \begin{macrocode}
8144 cd $PDFTKPATH
8145 list=`ls *.pdftk`
8146 % \end{macrocode}
8147 % Then for each file:
8148 % \begin{macrocode}
8149 for tmpfile in $list
8150 do
8151 % \end{macrocode}
8152 % we concatenate all lines by removing carriage returns:
8153 % \begin{macrocode}
8154 cp ${tmpfile} test.txt
8155 #-- 2-concat all lines, removing carriage returns
8156 sed -e :a -e '$!N;s/\n/LineBreak/;ta' -e 'P;D' test.txt >test2.txt
8157 perl -ne ' s/LineBreakInfoKey/\nInfoKey/g; print ' test2.txt >test3.txt
8158 perl -ne ' s/LineBreakInfoValue/\nInfoValue/g; print ' test3.txt >test4.txt
8159 perl -ne ' s/LineBreak//g; print ' test4.txt >test5.txt
8160 mv test5.txt $tmpfile
8161 done
8162
8163 % \end{macrocode}
8164 % After a quick clean up:
8165 % \begin{macrocode}
8166 rm -f tmp*
8167 rm -f test*.txt
8168
8169 % \end{macrocode}
8170 % we generate the \file{paper\_split.sh} bash script that will soon be used:
8171 % \begin{macrocode}
8172 cd $GPATH
8173 echo "__________"
8174 echo "__ split PDFs: generate bash script file"
8175 pwd
8176 echo "cmd: cat paperssplitpreamble.sh $TEXFILE.pdftk >tmp.sh"
8177 cat paperssplitpreamble.sh $TEXFILE.pdftk >tmp.sh
8178 mv tmp.sh ${GPATH}/papers_split.sh
8179
8180 % \end{macrocode}
8181 % to which we add the Perl command that helps to adds echo command to
8182 % each \package{pdftk}\footnote{Get \package{pdftk} at: \url{http://www.accesspdf.com/pdftk/}} command in \file{paper\_split.sh}:
8183 % \begin{macrocode}
8184 echo "__________"
8185 echo "__ split PDFs: Perl to add echo lines to 'papers_split.sh' script"
8186
8187 #echo "cmd: Perl to copy/add 'echo' cmd to each pdftk command, in 'papers_split.sh'"
8188 perl -p -e 's/^pdftk(.*[\n\r])/echo \"pdftk $1\"\npdftk $1/gm' ${GPATH}/papers_split.sh >tmp.txt
8189 mv tmp.txt ${GPATH}/papers_split_all.sh
8190
8191 % \end{macrocode}
8192 % We can now launch the \file{papers\_split\_all.sh} bash script:
8193 % \begin{macrocode}
8194 echo; echo "__________"
8195 echo "__ split PDFs: launch bash script file"
8196 #echo "cmd: chmod +x papers_split_all.sh"
8197 chmod +x papers_split_all.sh
8198
8199 echo "cmd: ./papers_split_all.sh"
8200 #echo " ./papers_split_all.sh ${GPATH} ${TEXFILE} ${INPATH} ${SPPATH} ${PDFPATH}"
8201 ./papers_split_all.sh ${GPATH} ${TEXFILE} ${INPATH} ${SPPATH} ${PDFPATH}
8202 # rm ${SPPATH}/*.ps #useful only if 'pdf2ps -> ps2pdf', not useful with 'gs'
8203
8204
8205 % \end{macrocode}
8206 % and once all individual PDFs have been split, we generate new individual PDFs
8207 % with corrected and homogeneous metadata:
8208 % \begin{macrocode}
8209 #--- generate PDF with corrected metadata
8210 echo "__________"
8211 echo "__ Correct PDF metadata with papersinfo.sh"
8212 ./papersinfo.sh ${GPATH} ${TEXFILE} ${INPATH} ${SPPATH} ${PDFPATH} ${PDFTKPATH}
8213
8214 % \end{macrocode}
8215 % we're now good for a real spring cleaning:
8216 % \begin{macrocode}
8217 ##--- clean
8218 #rm -r ${INPATH}
8219 #rm -r ${SPPATH}
8220 #rm papers_split.sh
8221 #rm -r tmp
8222 %</exportIndividualPDFs>
8223 % \end{macrocode}
8224 %
8225 %
8226 %^^A =================================================================
8227 % \subsection{\file{removeLaTeXcmds.sh}: Convert \LaTeX\ strings for PDF metadata}\label{sec:scripts:removeLaTeXcmds}
8228 %
8229 % \begin{description}
8230 % \item[Name] \file{removeLaTeXcmds.sh}
8231 % \item[Type] Unix/bash script that makes use of Perl commands
8232 % \item[Purpose] converts \LaTeX\ strings for PDF metadata
8233 % \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.
8234 % \end{description}
8235 %
8236 %
8237 %^^A =================================================================
8238 %^^A Here is the creation of the removeLaTeXcmds.sh script file, part of the example.
8239 %^^A It is written on first LaTeX run if it does not already exist
8240 %^^A =================================================================
8241 %
8242 % We first get the script arguments (path, input file name, output file name):
8243 %\changes{0.6}{\datevzdsix}{added \file{removeLaTeXcmds.sh}}
8244 % \begin{macrocode}
8245 %<*removeLaTeXcmds>
8246 #!/bin/bash
8247
8248 # arg 0: path, arg 1: input file; arg 2: output file
8249
8250 #-- save arguments for use
8251 args=("$@")
8252 path=${args[0]}
8253 file=${args[1]}
8254 outputfile=${args[2]}
8255 % \end{macrocode}
8256 % We go to the folder where we want to work, and copy the input file in order to work on a copy:
8257 % \begin{macrocode}
8258 cd ${path}
8259 cp ${file} tmp.txt
8260 #echo "__ ORIGINAL: $file ___"
8261 #cat tmp.txt
8262
8263 % \end{macrocode}
8264 % We then remove accents with Perl commands::
8265 % \begin{macrocode}
8266 #echo " "
8267 #echo "__ removed accents: __"
8268 perl -p -i -e " s/\\\'e/e/g " tmp.txt
8269 perl -p -i -e " s/\\'{e}/e/g " tmp.txt
8270 perl -p -i -e " s/\\\`e/e/g " tmp.txt
8271 perl -p -i -e ' s/\\"e/e/g ' tmp.txt
8272 perl -p -i -e " s/\\\`{e}/e/g " tmp.txt
8273 perl -p -i -e " s/\\\'a/a/g " tmp.txt
8274 perl -p -i -e " s/\\\`a/a/g " tmp.txt
8275 perl -p -i -e " s/\\\`{a}/a/g " tmp.txt
8276 perl -p -i -e ' s/\\"{o}/oe/g ' tmp.txt
8277 perl -p -i -e ' s/\\"o/o/g ' tmp.txt
8278 perl -p -i -e ' s/\\o{}/o/g ' tmp.txt
8279 perl -p -i -e ' s/\\\^o/o/g ' tmp.txt
8280 perl -p -i -e " s/\\\'o/o/g " tmp.txt
8281 perl -p -i -e " s/\\\`o/o/g " tmp.txt
8282 perl -p -i -e " s/\\\'u/u/g " tmp.txt
8283 perl -p -i -e ' s/\\u //g ' tmp.txt
8284 perl -p -i -e ' s/\\"u/u/g ' tmp.txt
8285 perl -p -i -e ' s/\\i /i/g ' tmp.txt
8286 perl -p -i -e ' s/\\i/i/g ' tmp.txt
8287 perl -p -i -e " s/\\\'{i}/i/g " tmp.txt
8288 perl -p -i -e ' s/\\"{i}/i/g ' tmp.txt
8289 perl -p -i -e ' s/\\c {c}/c/g ' tmp.txt
8290
8291 % \end{macrocode}
8292 % 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+\+):
8293 % \begin{macrocode}
8294 #echo " "
8295 #echo "__ removed textit, texbf, {, }: __"
8296 perl -p -i -e ' s/\--/-/g ' tmp.txt
8297 perl -p -i -e " s/\\ss/ss/g " tmp.txt
8298 perl -p -i -e ' s/\\textsuperscript //g ' tmp.txt
8299 perl -p -i -e " s/\\&/&/g " tmp.txt
8300 perl -p -i -e ' s/\\mu/mu\:/g ' tmp.txt
8301 perl -p -i -e ' s/\\sim\s//g ' tmp.txt
8302 perl -p -i -e ' s/\\sim//g ' tmp.txt
8303 perl -p -i -e ' s/\s:/:/g ' tmp.txt
8304
8305 perl -p -i -e ' s/\$//g ' tmp.txt
8306 perl -p -i -e " s/textit //g " tmp.txt
8307 perl -p -i -e " s/textbf //g " tmp.txt
8308 % \end{macrocode}
8309 % 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):
8310 % \begin{macrocode}
8311 perl -p -i -e " s/\{//g " tmp.txt
8312 perl -p -i -e " s/\}//g " tmp.txt
8313 perl -p -i -e ' s/\`\`/"/g ' tmp.txt
8314 perl -p -i -e " s/\'\'/\"/g " tmp.txt
8315
8316 #echo " "
8317 #echo "__ removed \: ___"
8318 perl -pi -e 's/\\//g' tmp.txt
8319 perl -pi -e 's/\s{2,10}\{\}/ /g' tmp.txt
8320 perl -pi -e 's/\s{2,10}/ /g' tmp.txt
8321
8322 cp tmp.txt $outputfile
8323 %</removeLaTeXcmds>
8324 % \end{macrocode}
8325 %
8326 %
8327 %
8328 %
8329 %^^A =================================================================
8330 % \subsection{\file{paperssplitpreamble.sh}: Preamble of \file{papersplit.sh}}\label{sec:scripts:paperssplitpreamble}
8331 %
8332 % \begin{description}
8333 % \item[Name] \file{paperssplitpreamble.sh}
8334 % \item[Type] Unix/bash script preamble
8335 % \item[Purpose] preamble for the \file{paperssplit.sh} script, that is generated by running \file{exportIndividualPDFs.sh}
8336 % \item[Note] it is not meant to be directly used by the user.
8337 % \end{description}
8338 %
8339 % \color{black}
8340 %
8341 %^^A =================================================================
8342 %^^A Here is the creation of the paperssplitpreamble.sh script file, part of the example.
8343 %^^A It is written on first LaTeX run if it does not already exist
8344 %^^A =================================================================
8345 %
8346 % We set macros from the script arguments (path, \TeX\ file name without extension,
8347 % paper info folder, split PDFs folder, PDF proceedings folder):
8348 %\changes{0.6}{\datevzdsix}{added \file{paperssplitpreamble.sh}}
8349 % \begin{macrocode}
8350 %<*paperssplitpreamble>
8351 #!/bin/bash
8352
8353 args=("$@")
8354 GPATH=${args[0]}
8355 TEXFILE=${args[1]} # example1
8356 INPATH=${args[2]} # papers_info
8357 SPPATH=${args[3]} #papers_split
8358 PDFPATH=${args[4]}
8359
8360 cd ${GPATH}
8361 SPPATH=${GPATH}/${SPPATH}
8362 PDFFILE=${GPATH}/${TEXFILE}.pdf # PDF proceedings
8363 echo "PDF proc used for individual PDFs extraction:\n --> $PDFFILE"
8364 echo "saving tmp .ps and .pdf files into\n --> $SPPATH"
8365 %</paperssplitpreamble>
8366 % \end{macrocode}
8367 %
8368 % \color{black}
8369 %
8370 %
8371 %
8372 %
8373 %
8374 %\changes{0.6}{\datevzsix}{Scripts: Unix \file{papersinfo.sh} script added}
8375 %\changes{0.6}{\datevzsix}{Scripts: Unix \file{papers\_split\_preamble.sh} script added}
8376 %^^A =================================================================
8377 % \subsection{\file{papersinfo.sh}: Generate individual PDFs with proper metadata}\label{sec:pdftk:add:PDF:metadata}
8378 %
8379 % \begin{description}
8380 % \item[Name] \file{papersinfo.sh}
8381 % \item[Type] Unix/bash script
8382 % \item[Purpose] adds proper metadata to each paper
8383 % \item[Dependencies] \file{removeLaTeXcmds.sh} and working \file{pdftk}
8384 % \item[Note] to be used once individual papers have been exported from the whole PDF proceedings.
8385 % \end{description}
8386 %
8387 % \color{black}
8388 %
8389 %^^A =================================================================
8390 %^^A Here is the creation of the papersinfo.sh script file, part of the example.
8391 %^^A It is written on first LaTeX run if it does not already exist
8392 %^^A =================================================================
8393 % \begin{macrocode}
8394 %<*papersinfo>
8395 #!/bin/bash
8396
8397 % \end{macrocode}
8398 % We first get the script arguments, which are in the order:
8399 % \begin{macrocode}
8400 args=("$@")
8401 % \end{macrocode}
8402 % \begin{itemize}
8403 % \item[1.] the folder where individual PDFs are stored:
8404 % \end{itemize}
8405 % \begin{macrocode}
8406 GPATH=${args[0]} #= ~/proceedings/e-proceedings
8407 % \end{macrocode}
8408 % \begin{itemize}
8409 % \item[2.] the finished proceedings (PDF file, without extension):
8410 % \end{itemize}
8411 % \begin{macrocode}
8412 TEXFILE=${args[1]} #= ICMC2009_proceedings
8413 % \end{macrocode}
8414 % \begin{itemize}
8415 % \item[3.] the folder where \file{pdftk} information files are stored (same as in \file{buildprocelpb.sh}):
8416 % \end{itemize}
8417 % \begin{macrocode}
8418 INPATH=${args[2]} #= papers_info
8419 % \end{macrocode}
8420 % \begin{itemize}
8421 % \item[4.] the folder (same as in \file{buildprocelpb.sh}) where are stored individual \file{pdf} files (obtained from splitting the proceedings):
8422 % \end{itemize}
8423 % \begin{macrocode}
8424 SPPATH=${args[3]} #= papers_split
8425 % \end{macrocode}
8426 % \begin{itemize}
8427 % \item[5.] the folder where final individual \file{pdf} files with proper PDF metadata will be stored:
8428 % \end{itemize}
8429 % \begin{macrocode}
8430 PDFPATH=${args[4]} #= ~/proceedings/e-proceedings
8431 % \end{macrocode}
8432 % \begin{itemize}
8433 % \item[6.] the folder where individual \file{.pdftk} files were generated by \LaTeX{} (ex: \file{pdtk\_info/}):
8434 % \end{itemize}
8435 % \begin{macrocode}
8436 PDFTKPATH=${args[5]} #= ~/pdftk_info
8437
8438 % \end{macrocode}
8439 % Let's go! We build the proceedings file name, and list individual PDF files:
8440 % \begin{macrocode}
8441 PDFFILE=${TEXFILE}.pdf # for use in the paper_split.sh and paper_info.sh scripts
8442
8443 cd ${GPATH}/${SPPATH}
8444 filelist=`ls *.pdf`
8445 mkdir ${PDFPATH}
8446
8447 % \end{macrocode}
8448 % Then, for each PDF file:
8449 % \begin{macrocode}
8450 cd ${GPATH}
8451 chmod +x removeLaTeXcmds.sh
8452
8453 for file in $filelist
8454 do
8455 base=${file%%.*}
8456 % \end{macrocode}
8457 % \begin{itemize}
8458 % \item remove \LaTeX{} commands (and accents) from the \file{pdftk} information files generated by the \LaTeX{} run with the \Lopt{pdftk=true} option:
8459 % \end{itemize}
8460 % \begin{macrocode}
8461 echo "removing LaTeX accents: ${base}.pdftk -> ${base}_clean.info"
8462 # echo "cmd: removeLaTeXcmds.sh ${GPATH} ${PDFTKPATH}/${base}.pdftk ${INPATH}/${base}_clean.info"
8463 ${GPATH}/removeLaTeXcmds.sh ${GPATH} ${PDFTKPATH}/${base}.pdftk ${INPATH}/${base}_clean.info
8464 % \end{macrocode}
8465 % \begin{itemize}
8466 % \item use \package{pdftk}\footnote{Get \package{pdftk} at: \url{http://www.accesspdf.com/pdftk/}}to update each \file{.pdf} file's info:
8467 % \end{itemize}
8468 % \begin{macrocode}
8469 echo "adding PDF metadata: ${base}_clean.info -> ${base}.pdf"
8470 # echo "cmd: pdftk ${SPPATH}/${base}.pdf update_info ${INPATH}/${base}_clean.info output ${PDFPATH}/${base}.pdf"
8471 echo "pdftk ${GPATH}/${SPPATH}/${base}.pdf update_info ${GPATH}/${INPATH}/${base}_clean.info output ${PDFPATH}/${base}.pdf"
8472 pdftk ${GPATH}/${SPPATH}/${base}.pdf update_info ${GPATH}/${INPATH}/${base}_clean.info output ${PDFPATH}/${base}.pdf
8473 done
8474 %</papersinfo>
8475 % \end{macrocode}
8476 %
8477 %
8478 %^^A =================================================================
8479 % \subsection{\file{buildpapers.sh}: Re-compile all papers}\label{sec:scripts:buildpapers}
8480 %
8481 % \begin{description}
8482 % \item[Name] \file{buildpapers.sh}
8483 % \item[Type] Unix/bash script
8484 % \item[Purpose] run \LaTeX{} on each paper
8485 % \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).
8486 % \end{description}
8487 %
8488 %^^A\changes{0.1d}{2007/08/01}{Adding the exbiblio.tex creation}
8489 %^^A =================================================================
8490 %^^A Here is the creation of the buildpapers script file, part of the example.
8491 %^^A It is written on first LaTeX run if it does not already exist
8492 %^^A =================================================================
8493 % \begin{macrocode}
8494 %<*buildpapers>
8495 #!/bin/sh
8496
8497 # Compile all papers with 'pdflatex' of 'latex'
8498 # (depending if they are in 'sources_pdftex' or 'sources_tex')
8499 # and copy resulting pdf files in the 'papers' folder.
8500 # Expected tree structure:
8501 # proceedings/papers/sources_pdftex/
8502 # proceedings/papers/sources_tex/
8503 # with this script in 'proceedings/'
8504
8505 #--- choose if you compile from scratch or only once
8506 #BUILD_TYPE=final #recompile and re-do biblio
8507 BUILD_TYPE=renumber #recompile only once for re-numbering
8508
8509 #--- set system dependent variables
8510 LATEXPATH="/usr/texbin/" # TeXLive
8511
8512 #--- paths
8513 LATEX=$LATEXPATH"latex"
8514 DVIPDF=/usr/local/bin/dvipdf
8515 PDFLATEX=$LATEXPATH"pdflatex"
8516 BIBTEX=$LATEXPATH"bibtex"
8517 MAKEINDEX=$LATEXPATH"makeindex"
8518 PROCSTY='dafx_06.sty'
8519
8520 #--- Compiling .tex files with pdfLaTeX
8521 cd papers/sources_pdftex
8522 for i in *; do
8523 echo; echo; echo '=====> Compiling' $i '.tex with pdfLaTeX <====='
8524 cd $i
8525 # copy the paper style (in case you changed it)
8526 cp ../../$PROCSTY .
8527 echo; echo ' ---> 1st compilation of ' $i '.tex'
8528 $PDFLATEX $i
8529 if [ $BUILD_TYPE = final ]; then
8530 echo; echo ' ---> Compiling the bibliography ' $i '.tex'
8531 $BIBTEX $i
8532 echo; echo ' --- 2nd compilation of ' $i '.tex'
8533 $PDFLATEX $i
8534 echo; echo ' ---> 3rd compilation of ' $i '.tex'
8535 $PDFLATEX $i
8536 fi
8537 #--- copy the pdf where the proceedings will be assembled
8538 cp $i.pdf ../..
8539 cd ..
8540 done
8541 #--- Compiling .tex files with LaTeX (problems related with hyperref)
8542 cd ../sources_tex
8543 for i in *; do
8544 echo; echo; echo '=====> Compiling' $i '.tex with LaTeX <====='
8545 cd $i
8546 #--- copy the paper proceedings style (if you changed the tree)
8547 cp ../../$PROCSTY .
8548 echo; echo ' ---> 1st compilation of ' $i '.tex '
8549 $LATEX $i.tex
8550 if [ $BUILD_TYPE = final ]; then
8551 echo; echo ' ---> Compiling the bibliography ' $i '.tex '
8552 $BIBTEX $i
8553 echo; echo ' ---> 2nd compilation of ' $i '.tex '
8554 $LATEX $i
8555 echo; echo ' ---> 3rd compilation of ' $i '.tex '
8556 $LATEX $i
8557 fi
8558 #--- produce the pdf from dvi
8559 $DVIPDF $i.dvi $i.pdf
8560 #--- copy the pdf where the proceedings will be assembled
8561 cp $i.pdf ../..
8562 cd ..
8563 done
8564 %</buildpapers>
8565 % \end{macrocode}
8566 %
8567 %
8568 %^^A =================================================================
8569 % \subsection{\file{buildcppdfpapers.sh}: Copy all PDFs papers at the right place}\label{sec:scripts:buildcppdfpapers}
8570 %
8571 % \begin{description}
8572 % \item[Name] \file{buildcppdfpapers.sh}
8573 % \item[Type] Unix/bash script
8574 % \item[Purpose] copies all PDF files at the right place (\ie{} in 'papers/')
8575 % \item[Note] the previous Unix script already does it, but you may want to only copy the files, not re-run \LaTeX{} them.
8576 % \end{description}
8577 %
8578 %^^A\changes{0.1d}{2007/08/01}{Unix scripts: creating buildcppdfpapers.}
8579 %^^A\changes{0.1f}{2007/08/03}{Unix scripts: cleanup for buildcppdfpapers.}
8580 %^^A =================================================================
8581 %^^A Here is the creation of the buildcppdfpapers script file, part of the example.
8582 %^^A It is written on first LaTeX run if it does not already exist
8583 %^^A =================================================================
8584 % \begin{macrocode}
8585 %<*buildcppdfpapers>
8586 #!/bin/sh
8587
8588 cd papers/sources_tex
8589 for i in *; do
8590 echo '*********' $i '*********'
8591 cp $i/$i.pdf ..
8592 done
8593 cd ../sources_pdftex
8594 for i in *; do
8595 echo '*********' $i '*********'
8596 cp $i/$i.pdf ..
8597 done
8598 %</buildcppdfpapers>
8599 % \end{macrocode}
8600 %
8601 %
8602 %
8603 %
8604 %
8605 %
8606 % \newpage
8607 % \section*{Conclusion and copyright}
8608 % 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!
8609 % Have fun using \package{\filename}!!!
8610 %
8611 %^^A\changes{0.1d}{2007/07/31}{Example: removing old code from previous example}
8612 %
8613 %^^A =================================================================
8614 %^^A We insert the `small print' here.
8615 %^^A =================================================================
8616 % {\vfill\hfill\scriptsize\package{\filename} is Copyright \copyright\ 2011 by Vincent Verfaille
8617 % <[email protected]>
8618 % \vspace{1cm}
8619 %
8620 % There is no warranty for the \package{\filename}~package. I
8621 % provide \package{\filename} `as is', without warranty of any
8622 % kind, either expressed or implied, including, but not limited to,
8623 % the implied warranties of merchantability and fitness for a
8624 % particular purpose. The entire risk as to the quality and
8625 % performance of \package{\filename} is with you. Should
8626 % \package{\filename} prove defective, you assume the cost of all
8627 % necessary servicing, repair, or correction.
8628 %
8629 % The \package{\filename}~package may be distributed and/or
8630 % modified under the conditions of the \LaTeX\ Project Public
8631 % License (see \cite{latex3-project:1999:lppl}), either version 1.2
8632 % of this license or (at your option) any later version.
8633 %
8634 % The latest version of this license is in
8635 % \href{http://www.latex-project.org/lppl.txt}{www.latex-project.org/lppl.txt} and version 1.2 or
8636 % later is part of all distributions of \LaTeX\ version 1999/12/01
8637 % or later.}\par\newpage
8638 %
8639 %^^A =================================================================
8640 %^^A The `user' documentation ends here, or strictly speaking: it
8641 %^^A ends after the following stuff (the argument of
8642 %^^A \StopEventually). In case of the `user' docu it will be
8643 %^^A appended here, in case of the `programmer' docu it will be
8644 %^^A delayed and inserted below at \Finale
8645 %^^A =================================================================
8646 %
8647 % \StopEventually{
8648 %
8649 %^^A\changes{0.2a}{2007/08/12}{Biblio: adding items for the report}
8650 %^^A\changes{0.2g}{2007/09/07}{Biblio: adding missing URLs}
8651 %^^A =================================================================
8652 %^^A We can't get enough! Of course we also want a bibliography ;-)
8653 %^^A =================================================================
8654 % \addcontentsline{toc}{section}{References}
8655 % {\small
8656 % \begin{thebibliography}{1}
8657 %
8658 % \bibitem{Pakin:2004:howto:package}
8659 % Scott Pakin.
8660 % \newblock How to Package Your \LaTeX{} Package.
8661 % \newblock \ctan: \href{http://www.ctan.org/tex-archive/info/dtxtut/}{\sf info/dtxtut/}.
8662 % \newblock November 2004. Cited page
8663 %
8664 % \bibitem{LaTeX:class:writers}
8665 % The \LaTeX{}3 Project.
8666 % \newblock \LaTeX2e for class and package writers.
8667 % \newblock \ctan: \href{http://tug.ctan.org/tex-archive/macros/latex/base/cls.dtx}{\sf macros/latex/base/cls.dtx}.
8668 % \newblock March 1999. Cited page
8669 %
8670 % \bibitem{mittelbach:1999:docstrip}
8671 % Frank Mittelbach, Denys Duchier, Johannes Braams, Marcin
8672 % Woli{\'{n}}ski, and Mark Wooding.
8673 % \newblock The {DocStrip} program.
8674 % \newblock \ctan: \href{http://tug.ctan.org/tex-archive/macros/latex/base/docstrip.dtx}{\sf macros/latex/base/docstrip.dtx}.
8675 % \newblock March 1999. Cited page
8676 %
8677 % \bibitem{latex3-project:1999:lppl}
8678 % The~{\LaTeX}3 Project.
8679 % \newblock The {\LaTeX} {P}roject {P}ublic {L}icense.
8680 % \newblock {\sc Url:} \href{http://www.latex-project.org/lppl.txt}{\sf www.latex-project.org/lppl.txt}.
8681 % \newblock September 1999. Cited page
8682 %
8683 % \bibitem{Brazil:2002}
8684 % Eoin Brazil.
8685 % \newblock Creating Conference Proceedings: Tips And Tricks From The Trenches. UL-IDC-02-03.
8686 % \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}.
8687 % \newblock Interactive Design Centre, University of Limerick, 2002. Cited page
8688 %
8689 % \bibitem{mini:eConf}
8690 % SLAC.
8691 % \newblock eConf: Full-Text Proceeding Instructions and Templates.
8692 % \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}.
8693 % \newblock Retrieved on Sept. 2007. Cited page
8694 %
8695 % \bibitem{AMS:editor}
8696 % American Mathematical Society.
8697 % \newblock Guide to AMS Editor's package.
8698 % \newblock {\sc Url:} \href{http://www.ams.org/authors/editpkg.html}{\sf www.ams.org/authors/editpkg.html}.
8699 % \newblock Retrieved on Sept. 2007. Cited page
8700 %
8701 % \bibitem{Adobe:2007:Acrobat}
8702 % Adobe systems Inc.
8703 % \newblock Acrobat Professional.
8704 % \newblock {\sc Url:} \href{http://www.adobe.com/products/acrobatpro/}{\sf www.adobe.com/products/acrobatpro/}
8705 % \newblock Retrieved on Sept. 2007. Cited page
8706 %
8707 % \bibitem{Wilson:2004:combine}
8708 % Peter Wilson.
8709 % \newblock The \package{combine} class and the \package{combinet}, \package{combnat} and \package{combcite} packages
8710 % \newblock \ctan: \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/combine/}{\sf macros/latex/contrib/combine/}.
8711 % \newblock March 2004. Cited page
8712 %
8713 % \bibitem{Oberdiek:2006:hyperref}
8714 % Sebastian Rahtz and Heiko Oberdiek.
8715 % \newblock The \package{hyperref} package.
8716 % \newblock \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/contrib/hyperref/}{\sf macros/latex/contrib/hyperref/}.
8717 % \newblock September 2006. Cited page
8718 %
8719 % \bibitem{Matthias:2004:pdfpages}
8720 % Andreas Matthias.
8721 % \newblock The \package{pdfpages} package.
8722 % \newblock \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/contrib/pdfpages/}{\sf macros/latex/contrib/pdfpages/}.
8723 % \newblock 2004. Cited page
8724 %
8725 % \bibitem{Oberdiek:2009:kvoptions}
8726 % Heiko Oberdiek.
8727 % \newblock The \package{kvoptions} package.
8728 % \newblock \ctan: \href{http://www.ctan.org/tex-archive/macros/latex/contrib/oberdiek/kvoptions.pdf}{\sf macros/latex/contrib/oberdiek/kvoptions.pdf}.
8729 % \newblock July 2009. Cited page
8730 %
8731 % \bibitem{Wright:2009:TUGboat:keyval}
8732 % Joseph Wright and Christian Feuers\"anger.
8733 % \newblock Implementing key--value input: An introduction.
8734 % \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}.
8735 % \newblock Vol.~30, Number~1, pp.110--122, 2009. Cited page
8736 %
8737 % \bibitem{Verfaille:2006:howto:web}
8738 % Vincent Verfaille.
8739 % \newblock How to make your own proceedings for another conference?
8740 % \newblock {\sc Url:} \href{http://www.dafx.ca/dafx06_proceedings_diy.html}{\sf www.dafx.ca/dafx06\_proceedings\_diy.html}.
8741 % \newblock October 2006. Cited page
8742 %
8743 % \bibitem{Verfaille:2006:howto:confproc}
8744 % Vincent Verfaille.
8745 % \newblock Report on the making of the DAFx-06 proceedings.
8746 % \newblock {\sc Url:} \href{http://www.dafx.ca/proceedings/report.pdf}{\sf www.dafx.ca/proceedings/report.pdf}.
8747 % \newblock MUMT-SPCL-07-01 report, McGill University, March 2007. Cited page
8748 %
8749 % \bibitem{Verfaille:2007:PracTeX:confproc}
8750 % Vincent Verfaille
8751 % \newblock A new package for conference proceedings.
8752 % \newblock The PracTeX Journal, Volume 4.
8753 % \newblock {\sc Url}: \href{http://www.tug.org/pracjourn/2007-4/verfaille/verfaille.pdf}{\sf www.tug.org/pracjourn/2007-4/verfaille/verfaille.pdf}.
8754 % \newblock November 2007. Cited page
8755 %
8756 % \end{thebibliography}}
8757 %
8758 %^^A\bibliography{confproc}
8759 %^^A\bibliographystyle{plain}
8760 %
8761 %^^A =================================================================
8762 %^^A By default we'll build the `user' docu, that is: without an
8763 %^^A index. But if the user made an index we should include it.
8764 %^^A =================================================================
8765 % \addcontentsline{toc}{section}{Index}
8766 % \PrintIndex
8767 %
8768 %^^A =================================================================
8769 %^^A Same as with the index above: if the user has specified
8770 %^^A `RecordChanges' in her `ltxdoc.cfg', we should print the
8771 %^^A changes here.
8772 %^^A =================================================================
8773 % \addcontentsline{toc}{section}{Change history}
8774 % \PrintChanges
8775 %
8776 %^^A =================================================================
8777 %^^A Make sure that the index and the changes are not printed twice
8778 %^^A since ltxdoc.cfg might have a second \PrintIndex or
8779 %^^A \PrintChanges command. (See everysel.dtx by Martin Schr\"oder)
8780 %^^A =================================================================
8781 % \let\PrintChanges=\relax
8782 % \let\PrintIndex=\relax
8783 % } ^^A end of \StopEventually
8784 %
8785 %
8786 %
8787 % \color{black}
8788 %
8789 %
8790 %^^A\changes{0.1d}{2007/07/31}{Implementation: bug for creating class corrected}
8791 %^^A\changes{0.1d}{2007/07/31}{Implementation: moved into the document itself}
8792 %^^A =================================================================
8793 %^^A The following will only be included into the `programmer' docu
8794 %^^A We follow the structure suggested in [Kopka: `LateX', Vol. 3,
8795 %^^A section 2.5]
8796 %^^A =================================================================
8797 % \section{Implementation}
8798 % \label{sec:implement}
8799 %
8800 % \emph{Please note:} The macros containing a `@' are internal
8801 % commands. They do \emph{not} belong to the user interface and
8802 % should not be called directly by the end user! You may get
8803 % unpredictable results if you don't know what you are doing.
8804 % Internal macros may be changed by me without announcement or
8805 % warning, so be careful. Use them at your own risk if you cannot
8806 % resist\ldots
8807 %
8808 %^^A =================================================================
8809 %^^A Key=value options
8810 %^^A =================================================================
8811 % \subsection{Key-value option management}\newvzdseven{}
8812 %
8813 % 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}
8814 % \begin{macrocode}
8815 %<*package>
8816 \RequirePackage{kvoptions}
8817 \RequirePackage{kvoptions-patch}
8818 % \end{macrocode}
8819 % 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}
8820 % \begin{macrocode}
8821 \RequirePackage{xifthen}
8822 % \end{macrocode}
8823 % 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:
8824 % \begin{macrocode}
8825 \SetupKeyvalOptions{family=confproc,prefix=confproc@}
8826 % \end{macrocode}
8827 % and the \cmd{\confproc} command for managing key values:
8828 % \begin{macrocode}
8829 \newcommand*{\confproc}[1]{\setkeys{confproc}{#1}}
8830 % \end{macrocode}
8831 %
8832 %
8833 %^^A\changes{0.2g}{2007/09/07}{Options: adding DescribeMacro for all}
8834 %^^A =================================================================
8835 %^^A Declaration and management of the options we want to provide
8836 %^^A =================================================================
8837 % \subsection{Options declaration}\label{subsec:optiondeclare}\label{sec:def:options:confproc}
8838 %
8839 %
8840 %^^A------------------------------------------------------------------------
8841 % \subsubsection{Obsolete options}
8842 %
8843 % We then define pre-version 0.5 options that became obsolete (their name has changed or their functionality has disappeared):
8844 % \begin{macrocode}
8845 \DeclareStringOption{compil}{\PackageWarning{confproc}{Option %
8846 "compil=bib*" ignored since v0.5; use "bib=*" instead of "compil=bib*"}}
8847 \DeclareVoidOption{draft}{\PackageWarning{confproc}{Option "draft" %
8848 ignored since v0.5; use "papers=draft" instead}}
8849 \DeclareVoidOption{final}{\PackageWarning{confproc}{Option "final" %
8850 ignored since v0.5; use "papers=final" instead}}
8851 \DeclareVoidOption{tocnumleft}{\PackageWarning{confproc}{Option %
8852 "tocnumleft" ignored since v0.5; use "tocnum=left" instead}}
8853 \DeclareVoidOption{tocnumright}{\PackageWarning{confproc}{Option %
8854 "tocnumright" ignored since v0.5; use "tocnum=right" instead}}
8855 \DeclareVoidOption{cleardoublepage}{\PackageWarning{confproc}{Option %
8856 "cleardoublepage" ignored since v0.5; use "twosidepapers" instead}}
8857 \DeclareVoidOption{clearsinglepage}{\PackageWarning{confproc}{Option %
8858 "clearsinglepage" ignored since v0.5; use "onesidepapers" instead}}
8859 % \end{macrocode}
8860 %
8861 %
8862 %^^A------------------------------------------------------------------------
8863 % \subsubsection{Options of the \package{book} package}
8864 %
8865 % The usual font sizes and paper size options are used to set the document parameters.
8866 % 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}):
8867 % \begin{macrocode}
8868 \DeclareVoidOption{10pt}{%
8869 \expandafter\PassOptionsToPackage
8870 \expandafter{\CurrentOption}{book}}
8871 \DeclareVoidOption{11pt}{%
8872 \expandafter\PassOptionsToPackage
8873 \expandafter{\CurrentOption}{book}}
8874 \DeclareVoidOption{12pt}{%
8875 \expandafter\PassOptionsToPackage
8876 \expandafter{\CurrentOption}{book}}
8877 % \end{macrocode}
8878 % For paper size, we define only the two usual ones for proceedings, namely \DescribeMacro{letterpaper}\Lopt{letterpaper}:
8879 % \begin{macrocode}
8880 \newif\if@proc@letterpaper
8881 \DeclareVoidOption{letterpaper}{%
8882 \@proc@letterpapertrue
8883 \setlength\paperheight {11in}%
8884 \setlength\paperwidth {8.5in}%
8885 \setlength\oddsidemargin {-4.95truemm}%
8886 \setlength\evensidemargin {-4.95truemm}%
8887 \def\shiftsletterpaper{}%
8888 \PassOptionsToClass{\CurrentOption}{book}%
8889 \PassOptionsToPackage{\CurrentOption}{hyperref}}
8890 % \end{macrocode}
8891 % and \DescribeMacro{a4paper}\Lopt{a4paper}:
8892 % \begin{macrocode}
8893 \DeclareVoidOption{a4paper}{%
8894 \@proc@letterpaperfalse
8895 \setlength\paperheight {297mm}%
8896 \setlength\paperwidth {210mm}%
8897 \setlength\oddsidemargin {-4.95truemm}%
8898 \setlength\evensidemargin {-10.95truemm}%
8899 \def\shiftsafourpaper{}%
8900 \PassOptionsToClass{\CurrentOption}{book}%
8901 \PassOptionsToPackage{\CurrentOption}{hyperref}}
8902 % \end{macrocode}
8903 % They are used to set the document, and then passed to the \package{book} and \package{hyperref} packages.
8904 % 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:
8905 % \begin{macrocode}
8906 \DeclareVoidOption{oneside}{\@twosidefalse \@mparswitchfalse%
8907 \PassOptionsToPackage{\CurrentOption}{book}}
8908 \DeclareVoidOption{twoside}{\@twosidetrue \@mparswitchtrue%
8909 \PassOptionsToPackage{\CurrentOption}{book}}
8910 % \end{macrocode}
8911 %
8912 %^^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'}
8913 %^^A\changes{0.2d}{2007/08/18}{Cmds: renaming all internal commands by adding the `conf\@' prefix}
8914 %^^A\changes{0.2e}{2007/09/01}{Options: finishing the description of the class options}
8915 %^^A------------------------------------------------------------------------
8916 %^^A \subsubsection{Declaration of \package{\filename}-specific options}
8917 %
8918 %^^A ------------------------------------------------------------------------------------------------------------------
8919 % \subsubsection{Proceedings-specific formatting options}
8920 %
8921 % We define a pair of complementary options (\LoptDescribe{twosidepapers} $\mid$ \LoptDescribe{onesidepapers}) that allow for a double/single page clear after each paper:
8922 % \begin{macrocode}
8923 \DeclareBoolOption[true]{twosidepapers}
8924 \DeclareComplementaryOption{onesidepapers}{twosidepapers}
8925 % \end{macrocode}
8926 %
8927 % \begin{macro}{papers}
8928 % \changes{0.4f}{2007/10/7}{bug: \Lopt{draft} removes bookmarks}
8929 % \changes{0.6}{2009/09/08}{\Lopt{draft} option replaced by \Lopt{draft} value for option \Lopt{papers}}
8930 % The \Lopt{papers} option is a string defaulted to \Lopt{final}:
8931 % \begin{macrocode}
8932 \DeclareStringOption[final]{papers}
8933 % \end{macrocode}
8934 % 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}).
8935 % \end{macro}
8936 %
8937 % \begin{macro}{electronic}
8938 % The \Lopt{electronic} is a boolean defaulted to \Lopt{true}:
8939 % \begin{macrocode}
8940 \DeclareBoolOption[true]{electronic}
8941 % \end{macrocode}
8942 % (that generates an electronic document with color hyperlinks)
8943 % \end{macro}
8944 % \begin{macro}{printed}
8945 % and \Lopt{printed} is declared as its complementary:
8946 % \begin{macrocode}
8947 \DeclareComplementaryOption{printed}{electronic}
8948 % \end{macrocode}
8949 % (and generates black color links).
8950 % \end{macro}
8951 %
8952 % \begin{macro}{binding}
8953 % \newvzdseven{}The \Lopt{binding} is a string defaulted to \Lopt{0mm}:\changes{0.7}{2010/08/05}{Pkg: added `binding=<length>' option}
8954 % \begin{macrocode}
8955 \DeclareStringOption[0mm]{binding}
8956 % \end{macrocode}
8957 % it in facts defines a length used for the inner binding.
8958 % \end{macro}
8959 %
8960 % \begin{macro}{headers}
8961 % The \Lopt{headers} is a string defaulted to \Lopt{allpages}:
8962 % \begin{macrocode}
8963 \DeclareStringOption[allpages]{headers}
8964 % \end{macrocode}
8965 % 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.
8966 % \end{macro}
8967 %
8968 % \begin{macro}{bib}
8969 % \newvzdseven{}The \Lopt{bib} is a string defaulted to \Lopt{none}:
8970 % \begin{macrocode}
8971 \DeclareStringOption[none]{bib}
8972 % \end{macrocode}
8973 % 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).
8974 % \end{macro}
8975 %
8976 %^^A ------------------------------------------------------------------------------------------------------------------
8977 % \subsubsection{List of inserted papers}
8978 %
8979 % \begin{macro}{paperselec}
8980 % \newvzdseven{}The \Lopt{paperselec} is a string defaulted to \Lopt{all}:
8981 % \begin{macrocode}
8982 \DeclareStringOption[all]{paperselec}
8983 % \end{macrocode}
8984 % \end{macro}
8985 %
8986 %^^A ------------------------------------------------------------------------------------------------------------------
8987 % \subsubsection{Lists formatting}
8988 %
8989 % \begin{macro}{twocoltoc}
8990 %^^A\changes{0.1i}{2007/08/10}{Options: adding \Lopt{onecoltoc} and \Lopt{twocoltoc} options}
8991 % The \Lopt{twocoltoc} is a boolean defaulted to \Lopt{false}:
8992 % \begin{macrocode}
8993 \DeclareBoolOption[false]{twocoltoc}
8994 % \end{macrocode}
8995 % that allows to produce a 2-columns table of contents.
8996 % \end{macro}
8997 %
8998 % \begin{macro}{onecoltoc}
8999 % The \Lopt{onecoltoc} is its complementary:
9000 % \begin{macrocode}
9001 \DeclareComplementaryOption{onecoltoc}{twocoltoc}
9002 % \end{macrocode}
9003 % used to produce a usual 1-column table of contents.
9004 % \end{macro}
9005 %
9006 % \begin{macro}{tocnum}
9007 % The \Lopt{tocnum} is a string defaulted to \Lopt{left}:
9008 % \begin{macrocode}
9009 \DeclareStringOption[left]{tocnum}
9010 % \end{macrocode}
9011 % that allows to place TOC numbers either on the left or the right side.
9012 % \end{macro}
9013 %
9014 % \begin{macro}{twocolbib}
9015 %^^A\changes{0.2c}{2007/08/17}{Options: adding \Lopt{onecolbib} and \Lopt{twocolbib} options}
9016 % The \Lopt{twocolbib} is a boolean defaulted to \Lopt{true}:
9017 % \begin{macrocode}
9018 \DeclareBoolOption[true]{twocolbib}
9019 % \end{macrocode}
9020 % that produces either a tow- or a one-column(s) general bibliography.
9021 % \end{macro}
9022 %
9023 % \begin{macro}{onecolbib}
9024 % The \Lopt{onecolbib} is its complementary:
9025 % \begin{macrocode}
9026 \DeclareComplementaryOption{onecolbib}{twocolbib}
9027 % \end{macrocode}
9028 % \end{macro}
9029 %
9030 % \begin{macro}{twocolindex}
9031 % The \Lopt{twocolindex} is a boolean defaulted to \Lopt{true}:
9032 % \begin{macrocode}
9033 \DeclareBoolOption[true]{twocolindex}
9034 % \end{macrocode}
9035 % that provides a 2-columns index of authors.
9036 % \end{macro}
9037 %
9038 % \begin{macro}{threecolindex}
9039 % The \Lopt{threecolindex} is its complementary:
9040 % \begin{macrocode}
9041 \DeclareComplementaryOption{threecolindex}{twocolindex}
9042 % \end{macrocode}
9043 % and therefore provides a 3-columns index of authors.
9044 % \end{macro}
9045 %
9046 %^^A ------------------------------------------------------------------------------------------------------------------
9047 % \subsubsection{Help for checking data and layout}
9048 %
9049 % \begin{macro}{checktitle}
9050 % 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)}
9051 % \begin{macrocode}
9052 \DeclareBoolOption[false]{checktitle}
9053 % \end{macrocode}
9054 % \end{macro}
9055 %
9056 % \begin{macro}{checkauthor}
9057 % 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)}
9058 % \begin{macrocode}
9059 \DeclareBoolOption[false]{checkauthor}
9060 % \end{macrocode}
9061 % \end{macro}
9062 %
9063 % \begin{macro}{colorheaders}
9064 % 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)}
9065 % \begin{macrocode}
9066 \DeclareStringOption[black]{colorheaders}
9067 % \end{macrocode}
9068 % \end{macro}
9069 %
9070 % \begin{macro}{showmarginlines}
9071 % 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)}
9072 % \begin{macrocode}
9073 \DeclareBoolOption[false]{showmarginlines}
9074 % \end{macrocode}
9075 % \end{macro}
9076 %
9077 % \begin{macro}{showpapernumber}
9078 % 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)}
9079 % \begin{macrocode}
9080 \DeclareBoolOption[false]{showpapernumber}
9081 % \end{macrocode}
9082 % \end{macro}
9083 %
9084 % \begin{macro}{movepagenumber}
9085 % 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)}
9086 % \begin{macrocode}
9087 \DeclareBoolOption[false]{movepagenumber}
9088 % \end{macrocode}
9089 % that is used to move the footer in order to check page numbers, when the PDF papers already have a page number before insertion.
9090 % \end{macro}
9091 %
9092 %^^A ------------------------------------------------------------------------------------------------------------------
9093 % \subsubsection{Verbose and \package{pdftk} options}
9094 %
9095 % \begin{macro}{debug}
9096 %^^A\changes{0.2b}{2007/08/16}{Options: adding the \Lopt{debug} option}
9097 % The \Lopt{debug} is a boolean defaulted to \Lopt{false}:
9098 % \changes{0.7}{2010/08/05}{now for the developer (differents from and complements \Lopt{verbose})}
9099 % \begin{macrocode}
9100 \DeclareBoolOption[false]{debug}
9101 % \end{macrocode}
9102 % \end{macro}
9103 %
9104 % \begin{macro}{verbose}
9105 %^^A\changes{0.2a}{2007/08/12}{Options: adding the \Lopt{verbose} option}
9106 % The \Lopt{verbose} is a boolean defaulted to \Lopt{false}:
9107 % \changes{0.7}{2010/08/05}{now for the user; all purpose (differs from and complements \Lopt{debug})}
9108 % \begin{macrocode}
9109 \DeclareBoolOption[false]{verbose}
9110 % \end{macrocode}
9111 % \end{macro}
9112 %
9113 % \begin{macro}{pdftk}
9114 % 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}
9115 % \begin{macrocode}
9116 \DeclareBoolOption[false]{pdftk}
9117 % \end{macrocode}
9118 % \end{macro}
9119 % 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
9120 % \begin{macro}{pdftksubject}
9121 % 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:
9122 % \begin{macrocode}
9123 \DeclareStringOption[.]{pdftkfolder}
9124 % \end{macrocode}
9125 % \end{macro}
9126 % \begin{macro}{pdftksubject}
9127 % The \Lopt{pdftksubject} is a string that indicates the PDF subject to \package{pdftk}:
9128 % \begin{macrocode}
9129 \DeclareStringOption[Conference]{pdftksubject}
9130 % \end{macrocode}
9131 % \end{macro}
9132 % \begin{macro}{pdftkproducer}
9133 % The \Lopt{pdftkproducer} is a string that indicates the PDF creator (ie.~the program generating the new PDF) to \package{pdftk}:
9134 % \begin{macrocode}
9135 \DeclareStringOption[pdftk 1.12 + Ghostscript 8.71]{pdftkproducer}
9136 % \end{macrocode}
9137 % \end{macro}
9138 % \begin{macro}{pdftkcreator}
9139 % The \Lopt{pdftkcreator} is a string that indicates the PDF creator (ie.~the program that initially created the PDF) to \package{pdftk}:
9140 % \begin{macrocode}
9141 \DeclareStringOption[LaTeX2e + confproc 0.7]{pdftkcreator}
9142 % \end{macrocode}
9143 % \end{macro}
9144 %
9145 %
9146 %^^A ------------------------------------------------------------------------------------------------------------------
9147 % \subsubsection{Options passed to \package{hyperref} and \package{geometry}}
9148 %
9149 % \begin{macro}{hyperref}
9150 % The \Lopt{hyperref} is a string:
9151 % \begin{macrocode}
9152 \DeclareStringOption{hyperref}[]
9153 \DeclareStringOption{geometry}[]
9154 \DeclareStringOption{afterhyperref}[]
9155 \DeclareStringOption{beforehyperref}[]
9156 % \end{macrocode}
9157 % \end{macro}
9158 %
9159 %
9160 %^^A------------------------------------------------------------------------
9161 % \subsubsection{Unknown options: passed to the \package{hyperref} package}
9162 %
9163 %^^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}.}
9164 % 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.
9165 % \margindanger{}\newvzdseven{} While this behavior is still true, \emph{it will be discontinued in the next versions, so please refrain to using it.}
9166 %
9167 % We print a warning message for unknown options, and pass them to \package{hyperref}:
9168 %^^A\changes{0.1i}{2007/08/10}{Options: passing all unknown options to \package{hyperref}, to avoid redefining all link colors, etc.}
9169 % \begin{macrocode}
9170 \DeclareDefaultOption{\PackageWarning{confproc}{Unknown %
9171 option `\CurrentOption'; passed to 'hyperref'}%
9172 \PassOptionsToClass{\CurrentOption}{hyperref}}
9173 % \end{macrocode}
9174 %
9175 %
9176 %
9177 %^^A =================================================================
9178 % \subsection{Options processing}
9179 %
9180 %^^A------------------------------------------------------------------------
9181 % \subsubsection{Default values for options}
9182 %
9183 % When not set by the user, options have the following default settings:
9184 %^^A\changes{0.1i}{2007/08/10}{Option: changing default link colors for \package{hyperref}}
9185 % \changes{0.7}{2010/08/05}{changed the package default option set (simpler examples)}
9186 % \begin{macrocode}
9187 \ExecuteOptions{letterpaper,10pt,twoside,twosidepapers,%
9188 electronic,binding=0mm,papers=final,paperselec=all,headers=allpages,%
9189 onecoltoc,tocnum=left,threecolindex,twocolbib,bib=none,%
9190 checktitle=false,checkauthor=false,showmarginlines=false,%
9191 showpapernumber=false,movepagenumber=false,colorheaders=black,%
9192 verbose=false,debug=false,pdftk=false,%
9193 % beforehyperref={},afterhyperref={},%
9194 hyperref={colorlinks=true,linkcolor=red,citecolor=blue,urlcolor=blue,%
9195 bookmarksopen=true,bookmarksopenlevel=1}%
9196 geometry={text={6.9in,9in},%
9197 inner=0.8in,top=1in,bottom=1in,%
9198 headsep=7.05mm,footskip=10mm,voffset=-5mm}}
9199 % \end{macrocode}
9200 %
9201 %^^A------------------------------------------------------------------------
9202 % \subsubsection{Options processing}
9203 %
9204 % Options can now be processed thatnks to \package{kvoptions}:
9205 % \begin{macrocode}
9206 \ProcessKeyvalOptions*
9207 % \end{macrocode}
9208 %
9209 %
9210 %
9211 %^^A =================================================================
9212 % \subsection{Application of option values}\label{sec:option:apply}
9213 %
9214 %^^A------------------------------------------------------------------------
9215 % \subsubsection{Package information messages and option settings}
9216 %
9217 % The \Lopt{electronic} version only makes use of visible hyper-references (clickable links):
9218 % \begin{macrocode}
9219 \ifconfproc@electronic%
9220 \PassOptionsToPackage{colorlinks=true}{hyperref}%
9221 \PackageInfo{confproc}{use color links with hyperref}%
9222 \else
9223 \PassOptionsToPackage{colorlinks=false}{hyperref}%
9224 \PackageInfo{confproc}{does not use color links with hyperref}%
9225 \fi
9226
9227 % \end{macrocode}
9228 % The \Lopt{binding} option manages the binding length for both the \package{geometry} package and paper insertion with \package{pdfpages}:
9229 % \begin{macrocode}
9230 \newlength{\proc@binding}
9231 \ifthenelse%
9232 {\equal{\confproc@binding}{}}
9233 {\setlength{\proc@binding}{0mm}
9234 \PackageInfo{confproc}{setting binding to default (0mm)}}
9235 {\setlength{\proc@binding}{\confproc@binding}
9236 \PackageInfo{confproc}{setting binding to \confproc@binding}}
9237
9238 % \end{macrocode}
9239 % With \Lopt{papers=}, papers are inserted either normally from page 1 to a user-defined value:
9240 % \begin{macrocode}
9241 \newif\if@proc@IncludePDFs
9242 % \end{macrocode}
9243 % replaced from page 1 to a user-defined value:
9244 % \begin{macrocode}
9245 \newif\if@proc@ReplacePDFs
9246 % \end{macrocode}
9247 % or fully inserted (discarding the user-defined paper number of pages):
9248 % \begin{macrocode}
9249 \newif\if@proc@IncludeFullPDFs
9250 % \end{macrocode}
9251 % We define a new file into which the number of pages will be counted:
9252 % \begin{macrocode}
9253 \newwrite\npagesfile
9254 % \end{macrocode}
9255 % 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})}
9256 % \begin{macrocode}
9257 \ifthenelse%
9258 {\equal{\confproc@papers}{empty}}%
9259 {\PackageInfo{confproc}{replacing PDF files by information pages}%
9260 \@proc@ReplacePDFstrue
9261 \@proc@IncludeFullPDFsfalse
9262 \@proc@IncludePDFsfalse
9263 \immediate\openout\npagesfile=\jobname.nps}
9264 {\ifthenelse%
9265 % \end{macrocode}
9266 % For \Lopt{papers=draft}, papers are replaced by a \package{pdfpages}-specific layout (also called \Lopt{draft}):
9267 % \begin{macrocode}
9268 {\equal{\confproc@papers}{draft}}%
9269 {\PackageInfo{confproc}{not including PDF files with 'pdfpages'}%
9270 \PassOptionsToPackage{draft}{pdfpages}%
9271 \@proc@ReplacePDFsfalse
9272 \@proc@IncludeFullPDFsfalse
9273 \@proc@IncludePDFsfalse
9274 \immediate\openout\npagesfile=\jobname.nps}
9275 % \end{macrocode}
9276 % For \Lopt{papers=final}, papers are normally inserted from page 1 to the user-defined number of pages:
9277 % \begin{macrocode}
9278 {\ifthenelse%
9279 {\equal{\confproc@papers}{final}}
9280 {\PackageInfo{confproc}{including PDF files with 'pdfpages'}%
9281 \PassOptionsToPackage{final}{pdfpages}%
9282 \@proc@ReplacePDFsfalse
9283 \@proc@IncludeFullPDFsfalse
9284 \@proc@IncludePDFstrue
9285 \immediate\openout\npagesfile=\jobname.nps}
9286 % \end{macrocode}
9287 % For \Lopt{papers=countpages}, papers are fully inserted, discarding the user-defined number of pages:
9288 % \begin{macrocode}
9289 {\ifthenelse%
9290 {\equal{\confproc@papers}{countpages}}
9291 {\PackageInfo{confproc}{counting each paper's number of %
9292 pages by including all its pages}
9293 % \PassOptionsToPackage{draft}{pdfpages}
9294 \@proc@ReplacePDFsfalse
9295 \@proc@IncludeFullPDFstrue
9296 \@proc@IncludePDFsfalse
9297 \immediate\openout\npagesfile=\jobname.npc}
9298 % \end{macrocode}
9299 % In case of unknown value for \Lopt{papers=}, the default is to insert papers using \Lopt{papers=final}:
9300 % \begin{macrocode}
9301 {\PackageWarning{confproc}{unknown option %
9302 `papers=\confproc@papers' ; using `papers=final'}%
9303 \@proc@ReplacePDFsfalse{}
9304 \@proc@IncludeFullPDFsfalse
9305 \@proc@IncludePDFstrue
9306 \immediate\openout\npagesfile=\jobname.nps}
9307 }
9308 }
9309 }
9310
9311 % \end{macrocode}
9312 % To manage fancy headers, we need two new ifs so as to process differently pages with papers and pages without papers.
9313 % \begin{macrocode}
9314 \newif\if@proc@FancyHeadersOnPapers
9315 \newif\if@proc@FancyHeadersExceptPapers
9316 % \end{macrocode}
9317 % For \Lopt{headers=none}, no headers/footers are added:
9318 % \begin{macrocode}
9319 \ifthenelse%
9320 {\equal{\confproc@headers}{none}}
9321 {\PackageInfo{confproc}{no headers}%
9322 \@proc@FancyHeadersOnPapersfalse
9323 \@proc@FancyHeadersExceptPapersfalse}
9324 % \end{macrocode}
9325 % For \Lopt{headers=pdfonly}, headers/footers are only added to inserted PDFs:
9326 % \begin{macrocode}
9327 {\ifthenelse%
9328 {\equal{\confproc@headers}{pdfonly}}
9329 {\PackageInfo{confproc}{headers on inserted PDFs only}%
9330 \@proc@FancyHeadersOnPaperstrue
9331 \@proc@FancyHeadersExceptPapersfalse}
9332 % \end{macrocode}
9333 % For \Lopt{headers=exceptpd}, headers/footers are added to all pages but inserted PDFs:
9334 % \begin{macrocode}
9335 {\ifthenelse%
9336 {\equal{\confproc@headers}{exceptpdf}}
9337 {\PackageInfo{confproc}{headers for all pages except PDFs}%
9338 \@proc@FancyHeadersOnPapersfalse
9339 \@proc@FancyHeadersExceptPaperstrue}
9340 % \end{macrocode}
9341 % For \Lopt{headers=allpages}, headers/footers are added to all pages including inserted PDF:
9342 % \begin{macrocode}
9343 {\ifthenelse%
9344 {\equal{\confproc@headers}{allpages}}
9345 {\PackageInfo{confproc}{headers on all pages, PDFs included}%
9346 \@proc@FancyHeadersOnPaperstrue
9347 \@proc@FancyHeadersExceptPaperstrue}
9348 {\PackageWarning{confproc}{unknown %
9349 'headers=\confproc@headers' option (using 'headers=allpages')}}
9350 }
9351 }
9352 }
9353
9354 % \end{macrocode}
9355 % 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.
9356 % \begin{macrocode}
9357 \newif\if@proc@BibNone
9358 \newif\if@proc@BibRemoveCiteHdr
9359 % \end{macrocode}
9360 % For \Lopt{bib=merge}, each paper is replaced by its first and last page only, where the bibliography is displayed:
9361 % \begin{macrocode}
9362 \ifthenelse%
9363 {\equal{\confproc@bib}{merge}}%
9364 {\PackageInfo{confproc}{bib: display 1st+last page of each paper}%
9365 \@proc@BibNonefalse%
9366 \def\conf@BibMerge{}%
9367 \@proc@BibRemoveCiteHdrfalse}%
9368 % \end{macrocode}
9369 % 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):
9370 % \begin{macrocode}
9371 {\ifthenelse%
9372 {\equal{\confproc@bib}{backref}}%
9373 {\PackageInfo{confproc}{bib: displays back references}%
9374 \@proc@BibNonefalse%
9375 \def\conf@BibBackRef{}%
9376 \@proc@BibRemoveCiteHdrfalse}%
9377 % \end{macrocode}
9378 % 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):
9379 % \begin{macrocode}
9380 {\ifthenelse%
9381 {\equal{\confproc@bib}{final}}%
9382 {\PackageInfo{confproc}{bib: hide bib items using `nocite'}%
9383 \@proc@BibNonefalse%
9384 \@proc@BibRemoveCiteHdrtrue}%
9385 % \end{macrocode}
9386 % For \Lopt{bib=none}, no bibliography is displayed at the end of the proceedings:
9387 % \begin{macrocode}
9388 {\PackageInfo{confproc}{bibliography: none}%
9389 \@proc@BibNonetrue}%
9390 }%
9391 }
9392 %\confproc@bib\@empty
9393 % \typeout{confproc/bibliography: no setting for "bib="! 5
9394 % Please use one of: none, backref, merge of final.}%
9395 % \end{macrocode}\changes{0.7}{2010/08/05}{Pkg: now uses \cmd{\PackageInfo} and \cmd{\PackageWarning} for proper package info and warnings}
9396 % \begin{macro}{\proccite}
9397 % \newvzdseven{}We define the \cmd{\confcite} citation function that can be changed depending on the citation function used by the chosen bibliography style:
9398 % \begin{macrocode}
9399 \if@proc@BibRemoveCiteHdr
9400 \newcommand{\confcite}[1]{\nocite{#1}}
9401 \PackageInfo{confproc}{removing citations (with nocite{*}): %
9402 next run should be the last (will loose hyperlinks)}
9403 \else \newcommand{\confcite}[1]{\cite{#1}}
9404 \fi
9405 % \end{macrocode}
9406 % \end{macro}
9407 % To manage the left or right numbergin of the table of contents, we need a new if:
9408 % \begin{macrocode}
9409 \newif\if@proc@TocNumberingRight
9410 \ifthenelse%
9411 {\equal{\confproc@tocnum}{left}}%
9412 {\PackageInfo{confproc}{TOC numbering on left}%
9413 \@proc@TocNumberingRightfalse}
9414 {\ifthenelse%
9415 {\equal{\confproc@tocnum}{right}}%
9416 {\PackageInfo{confproc}{TOC numbering on right}%
9417 \@proc@TocNumberingRighttrue}
9418 {\PackageWarning{confproc}{unknown tocnum=\confproc@tocnum %
9419 (using 'right' instead)}%
9420 \@proc@TocNumberingRighttrue}
9421 }
9422
9423 % \end{macrocode}
9424 % Then come various options for checking the document layout and content. When willing to check spelling errors in the papers' author list:
9425 % \begin{macrocode}
9426 \ifconfproc@checkauthor
9427 \PackageInfo{confproc}{add 'author list' field on the paper's 1st page}%
9428 \else \PackageInfo{confproc}{do not add author list}%
9429 \fi
9430 % \end{macrocode}
9431 % and in the paper titles:
9432 % \begin{macrocode}
9433 \ifconfproc@checktitle
9434 \PackageInfo{confproc}{add title field on the paper's 1st page}%
9435 \else \PackageInfo{confproc}{do not add title}%
9436 \fi
9437 % \end{macrocode}
9438 % We also show margin lines:
9439 % \begin{macrocode}
9440 \ifconfproc@showmarginlines
9441 \PackageInfo{confproc}{show margin lines to check template-complience}%
9442 \else \PackageInfo{confproc}{do not show margin lines}%
9443 \fi
9444 % \end{macrocode}
9445 % add the paper number (useful when not using the \Lopt{papers=empty} option):
9446 % \begin{macrocode}
9447 \ifconfproc@showpapernumber
9448 \PackageInfo{confproc}{add paper number below page number}%
9449 \else \PackageInfo{confproc}{do not add paper number below page number}%
9450 \fi
9451
9452 % \end{macrocode}
9453 % With the \Lopt{twosidepapers} option, papers always start on the right side (like book chapters):
9454 % \begin{macrocode}
9455 \ifconfproc@twosidepapers
9456 \PackageInfo{confproc}{papers opening on right (odd) side}
9457 \else
9458 \PackageInfo{confproc}{papers opening on any side}
9459 \fi
9460
9461 % \end{macrocode}
9462 % With the \Lopt{verbose} option, more information about paper insertion is provided to the user:
9463 % \begin{macrocode}
9464 \newif\if@proc@verbose
9465 \@proc@verbosefalse
9466 \ifconfproc@verbose
9467 \@proc@verbosetrue
9468 \PackageInfo{confproc}{verbose mode turned on}
9469 \else \PackageInfo{confproc}{verbose mode turned off}
9470 \fi
9471 % \end{macrocode}
9472 % With the \Lopt{debug} option, even more information is provided to the class developer:
9473 % \begin{macrocode}
9474 \ifconfproc@debug
9475 \@proc@verbosefalse
9476 \PackageInfo{confproc}{verbose mode turned off and debug turned on}
9477 \PassOptionsToPackage{debug}{hyperref}
9478 \else \PackageInfo{confproc}{debug mode turned on}
9479 \fi
9480 % \end{macrocode}
9481 %
9482 %^^A------------------------------------------------------------------------
9483 % \subsubsection{Package information messages and option settings}
9484 %
9485 % We pass options to specific packages, possibly overwriting previous settings:
9486 % \changes{0.7}{2010/08/05}{Pkg: (New) \package{hyperref} option to directly pass options to \package{hyperref} package}
9487 % \changes{0.7}{2010/08/05}{Pkg: (New) \package{geometry} option to directly pass options to \package{geometry} package}
9488 % \begin{macrocode}
9489 \PassOptionsToPackage{\confproc@hyperref}{hyperref}
9490 \PassOptionsToPackage{\confproc@geometry}{geometry}
9491 % \end{macrocode}
9492 %
9493 %^^A------------------------------------------------------------------------
9494 % \subsubsection{Print option values (hard debug mode)}
9495 %
9496 %^^A\changes{0.7}{2010/08/05}{Options: \Lopt{verbose} defaulted to \Lopt{false}}
9497 % \newvzdseven{}With the \Lopt{verbose=true} option, all option values and defaults are printed in the \file{.log} file and window:
9498 % \begin{macrocode}
9499 \ifconfproc@verbose
9500 \typeout{________________}
9501 \if@proc@letterpaper
9502 \typeout{| | Document formatting:}
9503 \typeout{| | ____ letterpaper}
9504 \else
9505 \typeout{| | Document formatting:}
9506 \typeout{| | ____ a4paper}
9507 \fi
9508 \iffalse\@twoside \typeout{| | ____ twoside=false (=oneside)}
9509 \else \typeout{| | ____ twoside=true}
9510 \fi
9511 \ifconfproc@twosidepapers \typeout{| | ____ twosidepapers=true}
9512 \else \typeout{| | twosidepapers=false (=onesidepaper)}
9513 \fi
9514 \typeout{| | Proceedings-specific formatting:}
9515 \ifconfproc@electronic \typeout{| | ____ electronic=true (file version)}
9516 \else \typeout{| | ____ electronic=false (printed)}
9517 \fi
9518 \typeout{| | ____ binding=\confproc@binding (for printed version)}
9519 \typeout{| | ____ papers=\confproc@papers (paper insertion)}
9520 \typeout{| | ____ headers=\confproc@headers (header add to pages)}
9521
9522 \typeout{| | List of papers:}
9523 \typeout{| | ____ paperselec=\confproc@paperselec}
9524
9525 \typeout{| | Lists (toc, bib, index):}
9526 \ifconfproc@twocoltoc \typeout{| | ____ twocoltoc=true}
9527 \else \typeout{| | ____ twocoltoc=false (=onecoltoc)}
9528 \fi
9529 \ifthenelse{\equal{\confproc@tocnum}{left}}%
9530 {\typeout{| | ____ tocnum=left}}
9531 {\typeout{| | ____ tocnum=right}}
9532 \ifconfproc@twocolbib \typeout{| | ____ twocolbib=true}
9533 \else \typeout{| | ____ twocolbib=false (=onecolbib)}
9534 \fi
9535 \typeout{| | ____ bib=\confproc@bib}
9536 \ifconfproc@twocolindex \typeout{| | ____ twocolindex=true}
9537 \else \typeout{| | ____ twocolindex=false (=threecolindex)}
9538 \fi
9539
9540 \typeout{| | Help for layout design:}
9541 \ifconfproc@checkauthor
9542 \typeout{| | ____ checkauthor=true (add author list to 1st page)}
9543 \else
9544 \typeout{| | ____ checkauthor=false (do not add author list to 1st page)}
9545 \fi
9546 \ifconfproc@checktitle
9547 \typeout{| | ____ checktitle=true (add title to 1st page)}
9548 \else
9549 \typeout{| | ____ checktitle=false (do not add title to 1st page)}
9550 \fi
9551
9552 \ifconfproc@showpapernumber
9553 \typeout{| | ____ showpapernumber=true (add paper number)}
9554 \else
9555 \typeout{| | ____ showpapernumber=false (do not add paper number)}
9556 \fi
9557 \ifconfproc@movepagenumber
9558 \typeout{| | ____ movepagenumber=true (move paper number for checking)}
9559 \else
9560 \typeout{| | ____ movepagenumber=false (do not move paper number)}
9561 \fi
9562 \ifconfproc@showmarginlines
9563 \typeout{| | ____ showmarginlines=true (add template format)}
9564 \else
9565 \typeout{| | ____ showmarginlines=false (do not add template format)}
9566 \fi
9567 \typeout{| | ____ colorheaders=\confproc@colorheaders (color for header/footer)}
9568
9569 \typeout{| | Verbose:}
9570 \ifconfproc@debug \typeout{| | ____ debug=true (for hyperref)}
9571 \else \typeout{| | ____ debug=false (for hyperref)}
9572 \fi
9573 \ifconfproc@verbose \typeout{| | ____ verbose=true (for confproc+hyperref)}
9574 \else \typeout{| | ____ verbose=false (for confproc+hyperref)}
9575 \fi
9576 \ifconfproc@pdftk
9577 \typeout{| | ____ pdftk=true (for use with pdftk to add PDF metadata)}
9578 \typeout{| | ____ pdftkfolder=\confproc@pdftkfolder (folder where .pdftk files are saved)}
9579 \typeout{| | ____ pdftksubject=\confproc@pdftksubject (subject for individual PDF metadata)}
9580 \typeout{| | ____ pdftkproducer=\confproc@pdftkproducer (producer for individual PDF metadata)}
9581 \typeout{| | ____ pdftkcreator=\confproc@pdftkcreator (creator for individual PDF metadata)}
9582 \else \typeout{| | ____ pdftk=false (for use with pdftk to add PDF metadata)}
9583 \fi
9584 \typeout{| | passed to hyperref: \confproc@hyperref}
9585 \typeout{| | passed to geometry: \confproc@geometry}
9586 \typeout{________________}
9587 \typeout{ }
9588 \fi
9589 % \end{macrocode}
9590 % With the \Lopt{pdftk=true} option, we also generate a general \file{.pdftk} file containing ann \file{pdftk} commands:
9591 % \begin{macrocode}
9592 \ifconfproc@pdftk
9593 \newwrite\pdftkinfoall
9594 \immediate\openout\pdftkinfoall=\jobname.pdftk
9595 \newwrite\pdftkinfofile
9596 \fi
9597 % \end{macrocode}
9598 %
9599 %
9600 %
9601 %^^A =================================================================
9602 %^^A Initial initialization
9603 %^^A =================================================================
9604 % \subsection{Initialization}
9605 % \label{subsec:init}
9606 %
9607 % As you can see, this package is based on the \package{book} package for all its layout aspects.
9608 %^^A\changes{0.1g}{2007/08/06}{Doc: adding comments to the class code}
9609 % \begin{macrocode}
9610 \LoadClass[10pt,letterpaper]{book}
9611 % \end{macrocode}
9612 %
9613 %
9614 %
9615 %^^A =================================================================
9616 % \subsection{Required packages}
9617 %
9618 % Several packages are included, among which many are required. \\
9619 % Use \package{graphicx} to insert logos (first page, welcome letters):
9620 % \begin{macrocode}
9621 \RequirePackage{graphicx}
9622 % \end{macrocode}
9623 % Use \package{pdfpages} (core of this class) to insert individual papers as PDF documents, page-by-page:
9624 % \begin{macrocode}
9625 \RequirePackage{pdfpages}
9626 % \end{macrocode}
9627 % Use \package{fancyhdr} to customize the headers and footers (for instance so that they match those of the paper templates):
9628 % \begin{macrocode}
9629 \RequirePackage{fancyhdr}
9630 % \end{macrocode}
9631 % Use \package{tocbibind} to change the \cmd{\indexname} command; its options disable the automatic insertion in the table of contents (hand made insertion instead):
9632 % \begin{macrocode}
9633 \RequirePackage[nottoc,notbib,notindex]{tocbibind}
9634 % \end{macrocode}
9635 % Use \package{titletoc} (part of the \package{titelsec} package) to change the table of contents layout (order of text, numbers, fonts, etc.):
9636 % \begin{macrocode}
9637 \RequirePackage[rightlabels]{titletoc}
9638 % \end{macrocode}
9639 % Use \package{multitoc} with the \Lopt{toc} option for a two columns table of contents:
9640 %^^A\changes{0.1i}{2007/08/10}{Options: adding \Lopt{onecoltoc} and \Lopt{twocoltoc} options}
9641 % \begin{macrocode}
9642 \ifconfproc@twocoltoc
9643 \RequirePackage[toc]{multitoc}
9644 \fi
9645 % \end{macrocode}
9646 %^^A\changes{0.2a}{2007/08/12}{Cmds: get rid of \package{threecolindex.sty} package and related \cmd{\gtindexname} command}
9647 % Use the \package{index} package to enable the creation of the index of authors:
9648 % \begin{macrocode}
9649 \RequirePackage{index}
9650 % \end{macrocode}
9651 % Use the \package{multitoc} package for a multi-columns table of contents or index:
9652 %^^A\changes{0.1i}{2007/08/10}{Options: adding \Lopt{onecoltoc} and \Lopt{twocoltoc} options}
9653 % \begin{macrocode}
9654 \RequirePackage{multicol}
9655 % \end{macrocode}
9656 % \begin{macro}{\theindex}
9657 % 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:
9658 % \begin{macrocode}
9659 \ifconfproc@twocolindex
9660 \renewenvironment{theindex}{%
9661 \if@twocolumn \@restonecolfalse
9662 \else \@restonecoltrue \fi
9663 \vspace*{-0.8cm}
9664 \section*{{\indexname}}
9665 \let\item\@idxitem
9666 \columnseprule \z@
9667 \columnsep 35\p@
9668 \begin{multicols}{2}[%
9669 \ifx\index@prologue\@empty\else
9670 \index@prologue
9671 \bigskip
9672 \fi]%
9673 \parindent\z@
9674 \parskip\z@ \@plus .3\p@\relax
9675 }{\end{multicols}%
9676 \if@restonecol \onecolumn
9677 \else \clearpage \fi}
9678 \else
9679 \renewenvironment{theindex}{%
9680 \if@twocolumn \@restonecolfalse
9681 \else \@restonecoltrue \fi
9682 \vspace*{-0.8cm}
9683 \section*{{\indexname}}
9684 \let\item\@idxitem
9685 \columnseprule \z@
9686 \columnsep 35\p@
9687 \begin{multicols}{3}[%
9688 \ifx\index@prologue\@empty\else
9689 \index@prologue
9690 \bigskip
9691 \fi]%
9692 \parindent\z@
9693 \parskip\z@ \@plus .3\p@\relax
9694 }{\end{multicols}%
9695 \if@restonecol \onecolumn
9696 \else \clearpage \fi }
9697 \fi
9698 % \end{macrocode}
9699 % \end{macro}
9700 % Use the \package{sectsy} package to change the sections font in the table of contents:
9701 % \begin{macrocode}
9702 \RequirePackage{sectsty}
9703 % \end{macrocode}
9704 % Use the \package{newapave} style for the general bibliography:
9705 % \begin{macrocode}
9706 \RequirePackage{newapave}
9707 % \end{macrocode}
9708 % If you do not wish to use the one developed for DAFx-06 but prefer to use the original \package{newapa} style, replace this last line in \file{\filename.cls} by:\begin{verbatim}
9709 % \RequirePackage{newapa}
9710 %\end{verbatim}
9711 % Links in the PDF files require to use the \package{color} package:
9712 % \begin{macrocode}
9713 \RequirePackage{color}
9714 % \end{macrocode}
9715 % We predefine here the names and values for the color links, so that they can be used:
9716 % \begin{macrocode}
9717 \definecolor{colorforlink}{rgb}{0,0,0.5}
9718 \definecolor{colorforpage}{rgb}{0,0,0.5}
9719 \definecolor{colorforcite}{rgb}{0,0.5,0}
9720 \definecolor{colorforurl}{cmyk}{0,1,0,0}
9721 % \end{macrocode}
9722 % together with the \package{hyperref} package with the following default options:
9723 % \begin{macrocode}
9724 %\confproc@beforehyperref{} %^^A TODO: not functioning yet
9725 \RequirePackage[pdftex,raiselinks,hyperindex,backref,pagebackref,%
9726 plainpages=false,pdfpagelabels,breaklinks,linktocpage,%
9727 pdfstartview=XYZ]{hyperref}
9728 %\confproc@afterhyperref{} %^^A TODO: not functioning yet
9729 % \end{macrocode}
9730 % and with the \package{bookmark} package:
9731 % \begin{macrocode}
9732 %%\RequirePackage[figure,table]{hypcap}
9733 \RequirePackage{bookmark}
9734 % \end{macrocode}
9735 %
9736 %
9737 %^^A =================================================================
9738 % \subsection{Proceedings specific commands}
9739 %
9740 % We now define the default values of some proceedings-specific commands.
9741 %
9742 %^^A------------------------------------------------------------------------
9743 % \subsubsection{PDF metadata}
9744 %
9745 % \begin{macro}{\procpdfauthor}
9746 % Define commands to set the PDF metadata: \cmd{\procpdfauthor} for the author:
9747 % \begin{macrocode}
9748 \newcommand{\procpdfauthor}{[Proceedings author/editor]}
9749 % \end{macrocode}
9750 % \end{macro}
9751 % \begin{macro}{\procpdftitle}
9752 % \cmd{\procpdftitle} for the title:
9753 % \begin{macrocode}
9754 \newcommand{\procpdftitle}{[Proceedings title]}
9755 % \end{macrocode}
9756 % \end{macro}
9757 % \begin{macro}{\procpdfsubject}
9758 % and \cmd{\procpdfsubject} for the subject:
9759 % \begin{macrocode}
9760 \newcommand{\procpdfsubject}{[Proceedings short title] %
9761 ([Proceedings Acronym]), [City], [Country], [Dates]}
9762 % \end{macrocode}
9763 % \end{macro}
9764 % \begin{macro}{\hypersetup}
9765 % 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):
9766 % \changes{0.4b}{2007/10/12}{Only evaluated At Begin Document}
9767 % \begin{macrocode}
9768 \AtBeginDocument{
9769 \hypersetup{
9770 pdfauthor = \procpdfauthor,
9771 pdftitle = \procpdftitle,
9772 pdfsubject = \procpdfsubject,
9773 pdfkeywords = {},
9774 pdfcreator = {LaTeX + confproc v0.7},
9775 pdfproducer = {pdfLaTeX}}}
9776 % \end{macrocode}
9777 % \end{macro}
9778 %
9779 % \changes{0.4b}{2007/10/12}{Layout: set \cmd{\footskip}}
9780 % \changes{0.6}{2009/09/08}{Layout: all commands replaced by use of \texttt{geometry} package}
9781 %^^A------------------------------------------------------------------------
9782 % \subsubsection{Page layout with \package{geometry}}
9783 %
9784 % The proceedings default page layout is defined thanks to \package{geometry}:
9785 % \begin{macrocode}
9786 \iffalse\@twoside
9787 \usepackage[bindingoffset=\proc@binding]{geometry}
9788 \else%
9789 \usepackage[twoside,bindingoffset=\proc@binding]{geometry}
9790 \fi
9791 % \end{macrocode}
9792 % Those values may be changed in the preamble, depending on your paper template.
9793 %
9794 %^^A------------------------------------------------------------------------
9795 % \subsubsection{Special section names}
9796 %
9797 % \begin{macro}{\contentsname}
9798 % We redefine the names of the table of contents (as it should appear in itself):
9799 % \begin{macrocode}
9800 \renewcommand{\contentsname}{Conference Program}
9801 % \end{macrocode}
9802 % \end{macro}
9803 % \begin{macro}{\bibname}
9804 % the general bibliography as it appears in the document and in the table of contents:
9805 %^^A\changes{0.1g}{2007/08/05}{\cmd{\bibnametoc} renamed \cmd{\procbibname}}
9806 % \changes{0.4a}{2007/10/01}{remove formatting}
9807 % \changes{0.4a}{2007/10/01}{renamed from \cmd{\procbibname}}
9808 % \begin{macrocode}
9809 \renewcommand{\bibname}{Full Bibliography}
9810 % \end{macrocode}
9811 % \end{macro}
9812 % \begin{macro}{\indexname}
9813 % and the index of authors as it appears in the document and in the table of contents:
9814 %^^A\changes{0.1g}{2007/08/05}{\cmd{\indexnametoc} renamed \cmd{\procindexname}}
9815 % \changes{0.4a}{2007/10/01}{remove formatting}
9816 % \changes{0.4a}{2007/10/01}{renamed from \cmd{\procindexname}}
9817 % \begin{macrocode}
9818 \renewcommand{\indexname}{Index of Authors}
9819 % \end{macrocode}
9820 % \end{macro}
9821 %^^A------------------------------------------------------------------------
9822 % \subsubsection{Header and footer}
9823 %
9824 % \begin{macro}{\proclhead}
9825 % We first define the default left header:
9826 %^^A\changes{0.2e}{2007/09/01}{renamed\cmd{\loclhead} into \cmd{\proclhead}}
9827 % \changes{0.6}{2009/09/08}{replaced \cmd{\proclhead} by \cmd{\procchead}}
9828 % \changes{0.6}{2009/09/08}{added empty \cmd{\proclhead} and \cmd{\procrhead}}
9829 % \begin{macrocode}
9830 \newcommand{\proclhead}{}
9831 % \end{macrocode}
9832 % \end{macro}
9833 %
9834 % \begin{macro}{\procchead}
9835 % the default central header:
9836 % \begin{macrocode}
9837 \newcommand{\procchead}{{\color{red}Proceedings of the... \hfill %
9838 01--29 February, 2001}}
9839 % \end{macrocode}
9840 % \end{macro}
9841 %
9842 % \begin{macro}{\procrhead}
9843 % and the default right header:
9844 % \begin{macrocode}
9845 \newcommand{\procrhead}{}
9846 % \end{macrocode}
9847 % \end{macro}
9848 %
9849 % \begin{macro}{\proclfoot}
9850 % Similarly, we define the default left footer (empty):
9851 % \begin{macrocode}
9852 \newcommand{\proclfoot}{}
9853 % \end{macrocode}
9854 % \end{macro}
9855 %
9856 % \begin{macro}{\proccfoot}
9857 % the default central footer:
9858 % \changes{0.4b}{2007/10/12}{use \cmd{\vspace} instead of \cmd{\vskip}}
9859 % \changes{0.4b}{2007/10/12}{remove \cmd{\vspace}}
9860 % \changes{0.6}{2009/09/08}{empty \cmd{\proclfoot} and \cmd{\procrfoot} added}
9861 % \begin{macrocode}
9862 \newcommand{\proccfoot}{{\small \color{red} Proc-\thepage}}
9863 % \end{macrocode}
9864 % \end{macro}
9865 %
9866 % \begin{macro}{\procrfoot}
9867 % and the default right footer (empty):
9868 % \begin{macrocode}
9869 \newcommand{\procrfoot}{}
9870 % \end{macrocode}
9871 % \end{macro}
9872 %
9873 % We now define the default page styles for use with headers:
9874 % \begin{macrocode}
9875 \pagestyle{fancyplain}
9876 % \end{macrocode}
9877 %
9878 % \begin{macro}{\headrulewidth}
9879 % together with the corresponding rule width for the headers:
9880 % \begin{macrocode}
9881 \renewcommand{\headrulewidth}{0pt}
9882 % \end{macrocode}
9883 % \end{macro}
9884 %
9885 % \begin{macro}{\footrulewidth}
9886 % and for the footers:
9887 % \begin{macrocode}
9888 \renewcommand{\footrulewidth}{-5mm}
9889 % \end{macrocode}
9890 % \end{macro}
9891 %
9892 % \begin{macro}{\procfootvskip}
9893 % We also define the vertical skip length to be applied to the footer:
9894 % \begin{macrocode}
9895 \newlength{\procfootvskip}
9896 \setlength{\procfootvskip}{0cm}
9897 % \end{macrocode}
9898 % \end{macro}
9899 %
9900 % \begin{macro}{\procoptfootvskip}
9901 %^^A \changes{0.1h}{2007/08/09}{removing \cmd{\testloccfoot} for a length \cmd{\procoptfootvskip}}
9902 % and the option vertical skip length added to the footer with the \Lopt{movepagenumber} option:
9903 % \begin{macrocode}
9904 \newlength{\procoptfootvskip}
9905 \ifconfproc@movepagenumber \setlength{\procoptfootvskip}{3mm}%
9906 \else \setlength{\procoptfootvskip}{0mm} \fi
9907 % \end{macrocode}
9908 % \end{macro}
9909 %
9910 % \begin{macro}{\lhead}
9911 % The left header is given as:
9912 % \begin{macrocode}
9913 \lhead{\color{\confproc@colorheaders}\proclhead}
9914 % \end{macrocode}
9915 % \end{macro}
9916 %
9917 % \begin{macro}{\chead}
9918 % the central header is:
9919 % \begin{macrocode}
9920 \chead{\color{\confproc@colorheaders}\procchead}
9921 % \end{macrocode}
9922 % \end{macro}
9923 %
9924 % \begin{macro}{\rhead}
9925 % and the right header is:
9926 % \begin{macrocode}
9927 \rhead{\color{\confproc@colorheaders}\procrhead}
9928 % \end{macrocode}
9929 % \end{macro}
9930 %
9931 % \begin{macro}{\lfoot}
9932 % The left footer is also set empty:
9933 % \begin{macrocode}
9934 \lfoot{}
9935 % \end{macrocode}
9936 % \end{macro}
9937 %
9938 % \begin{macro}{\rfoot}
9939 % as well as the right footer:
9940 % \begin{macrocode}
9941 \rfoot{}
9942 % \end{macrocode}
9943 % \end{macro}
9944 %
9945 % \begin{macro}{\proccfoot}
9946 % The center footer is the page number with option and mandatory vertical spaces:
9947 %^^A\changes{0.1h}{2007/08/09}\cmd{\loccfoot} renamed \cmd{\proccfoot}}
9948 % \begin{macrocode}
9949 \cfoot{\color{\confproc@colorheaders}\vskip\procfootvskip%
9950 \vskip\procoptfootvskip\proccfoot}%
9951 % \end{macrocode}
9952 % \end{macro}
9953 %
9954 % Depending on the value of the \Lopt{headers} option, \DescribeMacro{\pagestyle} we change the default page style:
9955 % \begin{macrocode}
9956 \ifdefined \conf@FancyHeadersExceptPapers
9957 \pagestyle{fancy}
9958 \else
9959 \pagestyle{empty}
9960 \fi
9961 % \end{macrocode}
9962 %
9963 %
9964 %^^A------------------------------------------------------------------------
9965 % \subsubsection{Table of contents layouts}
9966 %
9967 % Using the \package{titletoc} commands, we define the various table of contents layout.
9968 %^^A - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
9969 % \subsubsection{Default}
9970 %
9971 % For right numbering:
9972 % \begin{macrocode}
9973 \if@proc@TocNumberingRight
9974 % \end{macrocode}
9975 % we first set the left margin of papers inserted as sections:
9976 % \begin{macrocode}
9977 \titlecontents{section}[0em]% left margin
9978 % \end{macrocode}
9979 % we then set the table of contents spacing between 2 papers:
9980 % \begin{macrocode}
9981 {\vspace*{0.5mm}}% space between two papers in the TOC
9982 % \end{macrocode}
9983 % and the filler and page number:
9984 % \begin{macrocode}
9985 {}%
9986 {}%
9987 {\hfill \hspace*{-2.5em}\makebox[0pt][r]{\contentspage}\hspace*{2.5em}}% filler and page
9988 [\addvspace{0.5mm}]% space after
9989 % \end{macrocode}
9990 % For left numbering:
9991 % \begin{macrocode}
9992 \else%
9993 % \dottedcontents{section}[]{\fillright}{}{1pc}
9994 \titlecontents{section}[2.5em]%
9995 {\vspace*{0.5mm}}%
9996 % \end{macrocode}
9997 % we set the left shift of page numbers:
9998 % \begin{macrocode}
9999 {\hspace*{-2.5em}\makebox[0pt][r]{\contentspage}\hspace*{2.5em}}% left shifting page num.
10000 {\hspace*{-2.5em}\makebox[0pt][r]{\contentspage}\hspace*{2.5em}}% idem
10001 {}% filler and page
10002 [\addvspace{0.5mm}]% space after
10003 % \titlecontents{subsection}[2.5em]%
10004 % {\vspace*{0.3em}}%
10005 % {}% left shifting page num.
10006 % {}% idem
10007 % {}% filler and page
10008 % \titlecontents{subsection*}[2.5em]%
10009 % {\vspace*{0.3em}}%
10010 % {}% left shifting page num.
10011 % {}% idem
10012 % {}% filler and page
10013 \fi
10014 % \end{macrocode}
10015 %
10016 %
10017 % \begin{macro}{\tocmattertocstyle}
10018 % \subsubsection*{At document frontmatter with right numbering}
10019 % \begin{macrocode}
10020 \if@proc@TocNumberingRight
10021 \newcommand{\frontmattertocstyle}{
10022 % \end{macrocode}
10023 % Parts are used for the preamble:
10024 % \begin{macrocode}
10025 \titlecontents{part}[0em]%
10026 {\addvspace{3mm}}%
10027 {\Large\bfseries}%
10028 {\Large\bfseries}%
10029 {}%
10030 [\addvspace{0.5mm}]
10031 % \end{macrocode}
10032 % and chapters for each page for the preamble:
10033 % \begin{macrocode}
10034 \titlecontents{chapter}[0em]%
10035 {\addvspace{2mm}}%
10036 {\large\bfseries\itshape}%
10037 {\large\bfseries\itshape}%
10038 {}%
10039 [\addvspace{0.5mm}]
10040 }
10041 % \end{macrocode}
10042 % \subsubsection*{At document frontmatter with left numbering}
10043 % \begin{macrocode}
10044 \else
10045 \newcommand{\frontmattertocstyle}{
10046 % \end{macrocode}
10047 % Parts are used for the preamble:
10048 % \begin{macrocode}
10049 \titlecontents{part}[0em]%
10050 {\addvspace{3mm}}%
10051 {\Large\bfseries}%
10052 {\Large\bfseries}%
10053 {}%
10054 [\addvspace{0.5mm}]
10055 % \end{macrocode}
10056 % and chapters for each page for the preamble:
10057 % \begin{macrocode}
10058 \titlecontents{chapter}[0em]%
10059 {\addvspace{2mm}}%
10060 {\large\bfseries\itshape}%
10061 {\large\bfseries\itshape}%
10062 {}%
10063 [\addvspace{0.5mm}]
10064 }
10065 \fi
10066 % \end{macrocode}
10067 % \end{macro}
10068 %
10069 % \subsubsection*{At document mainmatte}
10070 %
10071 % \begin{macro}{\mainmattertocstyle}
10072 % 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:
10073 % \begin{macrocode}
10074 \if@proc@TocNumberingRight
10075 \newcommand{\mainmattertocstyle}{
10076 \titlecontents{part}[0pt]%
10077 {\addvspace{3mm}}%
10078 {\Large\bfseries}%
10079 {\Large\bfseries}%
10080 {}%
10081 [\addvspace{0.5mm}]
10082 \titlecontents{chapter}[0pt]%
10083 {\addvspace{2mm}}%
10084 {\large\bfseries\itshape}%
10085 {\large\bfseries\itshape}%
10086 {}%
10087 [\addvspace{0.5mm}]
10088 }
10089 % \end{macrocode}
10090 % and for left page numbers in TOC:
10091 % \begin{macrocode}
10092 \else % left TOC page numbers
10093 \newcommand{\mainmattertocstyle}{
10094 \titlecontents{part}[0pt]%
10095 {\addvspace{3mm}}%
10096 {\Large\bfseries}%
10097 {\Large\bfseries}%
10098 {}%
10099 [\addvspace{0.5mm}]
10100 \titlecontents{chapter}[0pt]%
10101 {\addvspace{2mm}}%
10102 {\large\bfseries\itshape}%
10103 {\large\bfseries\itshape}%
10104 {}%
10105 [\addvspace{0.5mm}]
10106 }
10107 \fi
10108 % \end{macrocode}
10109 % \end{macro}
10110 %
10111 % \begin{macro}{npagespreamble}
10112 % 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:
10113 % \begin{macrocode}
10114 \newcounter{npagespreamble}
10115 % \end{macrocode}
10116 % \end{macro}
10117 %
10118 % \begin{macro}{\mainmatter}
10119 % 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:
10120 % \changes{0.4a}{2007/10/01}{now includes \cmd{\mainmattertocstyle}}
10121 % \begin{macrocode}
10122 \renewcommand\mainmatter{%
10123 \PackageInfo{confproc}{counted \arabic{npagespreamble} pages in the preamble}
10124 \cleardoublepage
10125 \@mainmattertrue
10126 \pagenumbering{arabic}}
10127 % \end{macrocode}
10128 % \end{macro}
10129 %
10130 %^^A - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
10131 % \subsubsection{At document backmatter}
10132 %
10133 % \begin{macro}{\backmattertocstyle}
10134 % 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:
10135 % \begin{macrocode}
10136 \if@proc@TocNumberingRight
10137 \newcommand{\backmattertocstyle}{
10138 \titlecontents{part}%
10139 [0pt]%
10140 {\addvspace{3mm}}%
10141 {\Large\bfseries}%
10142 {\Large\bfseries}%
10143 {\hfill \hspace*{-2.5em}\contentspage\hspace*{2.5em}}%
10144 [\addvspace{0.5mm}]
10145 \titlecontents{chapter}%
10146 [0pt]%
10147 {\addvspace{2mm}}%
10148 {\large\bfseries\itshape}%
10149 {\large\bfseries\itshape}%
10150 {\hfill \hspace*{-2.5em}\contentspage\hspace*{2.5em}}%
10151 [\addvspace{0.5mm}]
10152 }%
10153 % \end{macrocode}
10154 % and left page numbers:
10155 % \begin{macrocode}
10156 \else
10157 \newcommand{\backmattertocstyle}{%
10158 \titlecontents{part}%
10159 [0pt]%
10160 {\addvspace{3mm}}%
10161 {\makebox[0pt][r]{\contentspage}\hspace*{2.5em}\Large\bfseries}%
10162 {\makebox[0pt][r]{\contentspage}\hspace*{2.5em}\Large\bfseries}%
10163 {}%
10164 [\addvspace{0.5mm}]
10165 \titlecontents{chapter}%
10166 [0pt]%
10167 {\addvspace{2mm}}%
10168 {\makebox[0pt][r]{\contentspage}\hspace*{2.5em}\large\itshape\bfseries}%
10169 {\makebox[0pt][r]{\contentspage}\hspace*{2.5em}\large\itshape\bfseries}%
10170 {}%
10171 [\addvspace{0.5mm}]
10172 }%
10173 \fi
10174 % \end{macrocode}
10175 % \end{macro}
10176 %
10177 % \begin{macro}{\backmatter}
10178 % We then redefine the \cmd{\backmatter} command and ensure the footer is properly modified:
10179 % \changes{0.4a}{2007/10/01}{now includes \cmd{\backmattertocstyle}}
10180 % \changes{0.6}{2009/09/08}{added footer redefinition}
10181 % \begin{macrocode}
10182 \renewcommand\backmatter{%
10183 \if@openright \cleardoublepage
10184 \else \clearpage \fi
10185 \@mainmatterfalse
10186 \cfoot{\color{\confproc@colorheaders}\vskip \procfootvskip %
10187 \vskip \procoptfootvskip \proccfoot}}
10188 % \end{macrocode}
10189 % \end{macro}
10190 %
10191 %^^A------------------------------------------------------------------------
10192 % \subsubsection{Headers/footers}
10193 %
10194 % \begin{macro}{\otherpagestyle}
10195 % The default page style (and corresponding headers and footers) is set for non PDF-inserted pages:
10196 % \begin{macrocode}
10197 \newcommand{\otherpagestyle}{
10198 \if@proc@FancyHeadersExceptPapers\pagestyle{fancy}
10199 \else \pagestyle{empty} \fi}
10200 % \end{macrocode}
10201 % \end{macro}
10202 %
10203 % \begin{macro}{\otherpagestyle}
10204 % and for a particular page:
10205 % \begin{macrocode}
10206 \newcommand{\thisotherpagestyle}{
10207 \if@proc@FancyHeadersExceptPapers\thispagestyle{fancy}
10208 \else \thispagestyle{empty} \fi}
10209 % \end{macrocode}
10210 % \end{macro}
10211 %
10212 % \begin{macro}{\PDFpagestyle}
10213 % as well as for PDF-inserted pages:
10214 % \begin{macrocode}
10215 \newcommand{\PDFpagestyle}{
10216 \if@proc@FancyHeadersOnPapers\thispagestyle{fancy}
10217 \else\thispagestyle{empty} \fi}
10218 % \end{macrocode}
10219 % \end{macro}
10220 %
10221 % \begin{macro}{\chapterfont}
10222 % Using the \package{sectsty} package, all chapters have the same font in the table of contents:
10223 % \begin{macrocode}
10224 \chapterfont{\thisotherpagestyle}
10225 % \end{macrocode}
10226 % \end{macro}
10227 %
10228 % \begin{macro}{\clearsingleordoublepage}
10229 % We define the \cmd{\clearsingleordoublepage} command depending if on the document
10230 % format (one-side or two-side):
10231 % \begin{macrocode}
10232 \newcommand{\clearsingleordoublepage}{
10233 \iffalse\@twoside \clearpage
10234 \else \cleardoublepage \fi}
10235 % \end{macrocode}
10236 % \end{macro}
10237 %
10238 %
10239 %^^A------------------------------------------------------------------------
10240 % \subsubsection{$X$ and $Y$ shifts}
10241 %
10242 %^^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})}
10243 %^^A\changes{0.2a}{2007/08/12}{Cmds: adding \cmd{\paperbookmark} for correct use in the Perl scripts}
10244 % We now define the $X$ and $Y$ shifts for \LaTeX{} (\cmdDescribe{\LaTeXxShift} and
10245 % \cmdDescribe{\LaTeXyShift}) and Word (\cmdDescribe{\WordxShift}, \cmdDescribe{\WordyShift})
10246 % generated papers as lengths:
10247 % \begin{macrocode}
10248 \newlength{\LaTeXxShift} \setlength{\LaTeXxShift}{0pt}
10249 \newlength{\LaTeXyShift} \setlength{\LaTeXyShift}{0pt}
10250 \newlength{\WordxShift} \setlength{\WordxShift}{0pt}
10251 \newlength{\WordyShift} \setlength{\WordyShift}{0pt}
10252 % \end{macrocode}
10253 % \changes{0.6}{2009/09/08}{Default values for Word or \LaTeX{} $x$ and $y$ shift values no more set
10254 % depending on the document formant}
10255 %
10256 %^^A------------------------------------------------------------------------
10257 % \subsubsection{Paper insertion commands}
10258 %
10259 % \begin{macro}{\conf@paper@title}
10260 % We now define (as empty) the commands used to add TOC, bookmark and bib data to
10261 % inserted PDF papers, \ie{} the paper title:
10262 % \begin{macrocode}
10263 \newcommand{\conf@paper@title}{}
10264 % \end{macrocode}
10265 % \end{macro}
10266 % \begin{macro}{\conf@paper@authors}
10267 % the paper authors:
10268 % \begin{macrocode}
10269 \newcommand{\conf@paper@authors}{}
10270 % \end{macrocode}
10271 % \end{macro}
10272 % \begin{macro}{\conf@paper@index}
10273 % the commands for insertion in the index:
10274 % \begin{macrocode}
10275 \newcommand{\conf@paper@index}{}
10276 % \end{macrocode}
10277 % \end{macro}
10278 % \begin{macro}{\conf@paper@ref}
10279 % the paper reference, \ie{} a tag (\eg{} the file name, or the submission number):
10280 % \begin{macrocode}
10281 \newcommand{\conf@paper@ref}{}
10282 % \end{macrocode}
10283 % \end{macro}
10284 % \begin{macro}{\conf@paper@pagenum}
10285 % the number of pages:
10286 % \begin{macrocode}
10287 \newcommand{\conf@paper@pagenum}{}
10288 % \end{macrocode}
10289 % \end{macro}
10290 % \begin{macro}{\conf@paper@cite}
10291 % the bibliographic references (for the general bibliography):
10292 % \begin{macrocode}
10293 \newcommand{\conf@paper@cite}{}
10294 % \end{macrocode}
10295 % \end{macro}
10296 % \begin{macro}{\papertitlestyle}
10297 % the style for the title:
10298 % \begin{macrocode}
10299 \newcommand{\papertitlestyle}{}
10300 % \end{macrocode}
10301 % \end{macro}
10302 % \begin{macro}{\paperauthorstyle}
10303 % and finally the style for both the list of authors and the text between the title and the list of authors:
10304 % \changes{0.4b}{2007/10/12}{Format: changing \cmd{\it} to \cmd{\itshape}}
10305 % \begin{macrocode}
10306 \newcommand{\paperauthorstyle}{\texorpdfstring{\newline\itshape}{\break}}
10307 % \end{macrocode}
10308 % \end{macro}
10309 %
10310 %^^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}
10311 %^^A\changes{0.1i}{2007/08/10}{Cmd: changing \cmd{\includepaperthread} to hide the TOC layout.}
10312 %^^A\changes{0.1i}{2007/08/10}{Cmd: adding \cmd{\proctoctitleauthor} to define the TOC format of author and paper}
10313 %^^A\changes{0.1i}{2007/08/10}{Cmd: renaming \cmd{\includepaperthread} into \cmd{\procinsertpaper}}
10314 %^^A\changes{0.2b}{2007/08/16}{Cmd: adding a \cmd{\paperpagenum} counter to compute Nb pages -1}
10315 %
10316 % \begin{macro}{npages}
10317 % A new counter \Lopt{npages} is added, for the number of pages of a paper:
10318 % \begin{macrocode}
10319 \newcounter{npages}
10320 % \end{macrocode}
10321 % \end{macro}
10322 %
10323 % \begin{macro}{\proctoctitleauthor}
10324 % 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} :
10325 % \begin{macrocode}
10326 \newcommand{\proctoctitleauthor}[2]{%
10327 % \end{macrocode}
10328 % We chose to insert both the paper title and the list of authors in the table of contents,
10329 % \begin{macrocode}
10330 \texorpdfstring{{\papertitlestyle #1}{\paperauthorstyle #2}}%
10331 % \end{macrocode}
10332 % whereas only the title is inserted as a section in the bookmark.
10333 % \begin{macrocode}
10334 {{\papertitlestyle #1}}}
10335 % \end{macrocode}
10336 % \end{macro}
10337 % Then, each author will be inserted as a subsection in the \cmd{\procinsertpaper} command.
10338 %
10339 %^^A------------------------------------------------------------------------
10340 % \subsubsection{Table of contents insertion}
10341 %
10342 % \begin{macro}{\tableofcontents}
10343 % We redefine the usual \cmd{\tableofcontents} command that switches to the corresponding section style for insertion in the table of contents:
10344 % \changes{0.4a}{2007/10/01}{redefined}
10345 % \begin{macrocode}
10346 \renewcommand\tableofcontents{%
10347 % \end{macrocode}
10348 % clears a single or double page according to the one/two-sided page format:
10349 % \begin{macrocode}
10350 \clearsingleordoublepage
10351 % \end{macrocode}
10352 % adds the conference program name to the PDF bookmark:
10353 % \begin{macrocode}
10354 \pdfbookmark[0]{\contentsname}{contents}
10355 % \end{macrocode}
10356 % switches to one-column if needed:
10357 % \begin{macrocode}
10358 \if@twocolumn \@restonecoltrue\onecolumn
10359 \else \@restonecolfalse \fi
10360 % \end{macrocode}
10361 % inserts the table of contents name as a starred section:
10362 % \begin{macrocode}
10363 \section*{\contentsname}%
10364 % \end{macrocode}
10365 % inserts the table of contents itself:
10366 % \begin{macrocode}
10367 \@starttoc{toc}%
10368 % \end{macrocode}
10369 % restores the two-column mode if any:
10370 % \begin{macrocode}
10371 \if@restonecol\twocolumn\fi
10372 % \end{macrocode}
10373 % and clears a single or double page according to the one/two-sided page format:
10374 % \begin{macrocode}
10375 \clearsingleordoublepage}
10376 % \end{macrocode}
10377 % \end{macro}
10378 %
10379 %^^A------------------------------------------------------------------------
10380 % \subsubsection{Organize the program by days or sessions}
10381 %
10382 % The \cmd{\procday} \DescribeMacro{\procday} command inserts the day given as argument in the table of contents:
10383 %^^A\changes{0.2d}{2007/08/18}{Cmds: adding the \cmd{\procday} command for inserting the day (upper level in the bookmark)}
10384 % \begin{macrocode}
10385 \newcommand{\procday}[1]{%
10386 \phantomsection \addcontentsline{toc}{part}{#1}}
10387 % \end{macrocode}
10388 % The \cmd{\session} \DescribeMacro{\session} command adds a session to the table of contents:
10389 % \begin{macrocode}
10390 \newcommand{\session}[1]{%
10391 \phantomsection \addcontentsline{toc}{chapter}{#1}}
10392 % \end{macrocode}
10393 %
10394 %^^A------------------------------------------------------------------------
10395 % \subsubsection{Paper switch}
10396 %
10397 % \begin{macro}{\paperswitch}
10398 % The \cmd{\paperswitch} command will be redefined in the \file{expapersswitch.tex} file, containing information about all papers. It is therefore declared empty:
10399 % \begin{macrocode}
10400 \newcommand{\paperswitch}{}
10401 % \end{macrocode}
10402 % \end{macro}
10403 %
10404 %^^A------------------------------------------------------------------------
10405 % \subsubsection{Modifying the bibliography style}
10406 %
10407 % \begin{macro}{\bibhang}
10408 % We first set the \cmd{\bibhang} length:
10409 % \begin{macrocode}
10410 \setlength{\bibhang}{0.5em} %
10411 % \end{macrocode}
10412 % \end{macro}
10413 %\begin{macro}{\thebibliography}
10414 % We then redefine the \cmd{\thebibliography} environment, for proper use and insertion of the new section title in the table of contents:
10415 % \changes{0.4a}{2007/10/01}{redefined to insert \cmd{\setbibitems}'s code}
10416 % \begin{macrocode}
10417 \if@proc@BibNone
10418 \renewenvironment{thebibliography}[1]{%
10419 \PackageInfo{confproc}{ignoring #1 biblio file (`bib=none' option)}}
10420 \else
10421 \renewenvironment{thebibliography}[1]{%
10422 \ifconfproc@twocolbib \twocolumn \fi
10423 \ifdefined\conf@BibMerge \nocite{*}
10424 \else \clearsingleordoublepage \fi%
10425 \section*{\bibname}%
10426 \addcontentsline{toc}{part}{\bibname}
10427 \@mkboth{\MakeUppercase\bibname}{\MakeUppercase\bibname}%
10428 \procbibintro
10429 \list{\@biblabel{\@arabic\c@enumiv}}%
10430 {\settowidth\labelwidth{\@biblabel{#1}}%
10431 \leftmargin\labelwidth
10432 \advance\leftmargin\labelsep
10433 \@openbib@code
10434 \usecounter{enumiv}%
10435 \let\p@enumiv\@empty
10436 \renewcommand\theenumiv{\@arabic\c@enumiv}}%
10437 \sloppy
10438 \clubpenalty4000
10439 \@clubpenalty \clubpenalty
10440 \widowpenalty4000%
10441 \sfcode`\.\@m}
10442 {\def\@noitemerr
10443 {\@latex@warning{Empty `thebibliography' environment}}%
10444 \endlist
10445 \setlength{\labelsep}{0em}
10446 \setlength{\itemindent}{-\bibhang}
10447 \setlength{\leftmargin}{\bibhang}}
10448 \fi
10449 % \end{macrocode}
10450 % \end{macro}
10451 % \begin{macro}{\newblock}
10452 % We redefine the \cmd{\newblock} command to reduce the space between bib items:
10453 % \begin{macrocode}
10454 \renewcommand\newblock{\hskip 0em plus 0.0em minus .07em}
10455 % \end{macrocode}
10456 % \end{macro}
10457 %
10458 %^^A% The \cmd{\setbibitems} \DescribeMacro{\setbibitems} command defines the bibliography items to be inserted, depending on the compilation option.
10459 %^^A% \begin{macrocode}
10460 %^^A\newcommand{\setbibitems}{%
10461 %^^A% \end{macrocode}
10462 %^^A% We first set in a 2 columns format if needed:
10463 %^^A% \begin{macrocode}
10464 %^^A \ifdefined\conf@TwoColumnBib%
10465 %^^A \twocolumn
10466 %^^A \fi
10467 %^^A% \end{macrocode}
10468 %^^A%^^A As a general bibliography is very long, the font size is set to \verb+\footnotesize+:
10469 %^^A%^^A \begin{macrocode}
10470 %^^A%^^A {\footnotesize%
10471 %^^A%^^A \end{macrocode}
10472 %^^A% If working on the merging process, all bibliographic items are inserted (so that one can see duplicates):
10473 %^^A% \begin{macrocode}
10474 %^^A \ifdefined\conf@BibMerge%
10475 %^^A \nocite{*}%
10476 %^^A% \end{macrocode}
10477 %^^A% Otherwise, there no need to insert the citations (they already are inserted as the last page):
10478 %^^A% \begin{macrocode}
10479 %^^A \else%
10480 %^^A \clearsingleordoublepage%
10481 %^^A \fi%
10482 %^^A% \end{macrocode}
10483 %
10484 %^^A------------------------------------------------------------------------
10485 % \subsubsection{General bibliography introduction}
10486 %
10487 % The \cmd{\procbibintro} \DescribeMacro{\procbibintro} cmd defaults the introductory paragraph of the full bibliography:
10488 % \begin{macrocode}
10489 \newcommand{\procbibintro}{{\it ~~~This bibliography is a compilation
10490 of all bibliographic references from each paper. Page numbers that
10491 appear at the end of each entry link to the bibliography sections that
10492 include it. Please click on the URL or on the page number to access
10493 the linked item.}}
10494 % \end{macrocode}
10495 %
10496 %^^A------------------------------------------------------------------------
10497 % \subsubsection{Index insertion}
10498 %
10499 % The \cmd{\insertindex} \DescribeMacro{\insertindex} cmd defines the index insertion (it may later be hidden in a proper redefinitin of the \cmd{\theindex} command):
10500 %^^A\changes{0.2e}{2007/09/01}{Cmds: renaming \cmd{\loclhead} into \cmd{\proclhead}}
10501 % \begin{macrocode}
10502 \newcommand{\insertindex}{
10503 % \end{macrocode}
10504 % We first clear the page, so that two-side documents start on a right (odd) page:
10505 % \begin{macrocode}
10506 \clearsingleordoublepage
10507 % \end{macrocode}
10508 % We then back to the 1-column format, in case one adds text before the index:
10509 % \begin{macrocode}
10510 \onecolumn
10511 % \end{macrocode}
10512 % We then include a phantom section and a link to bookmark (do not remove, as this dirty hack provides a valid pointer to the index):
10513 % \begin{macrocode}
10514 % \section*{\addcontentsline{toc}{part}{\bibname} \bibname}%
10515 \section*{~~}%
10516 \addcontentsline{toc}{part}{\indexname}%
10517 % \end{macrocode}
10518 % 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):
10519 % \begin{macrocode}
10520 \renewcommand{\procchead}{}%
10521 \renewcommand{\proccfoot}{}%
10522 % \end{macrocode}
10523 %^^A\changes{0.1g}{2007/08/05}{Cmds: using \cmd{\procindexname} in \package{threecolindex.sty} package}
10524 %^^A\changes{0.2a}{2007/08/12}{Cmds: get rid of \package{threecolindex.sty} package and related \cmd{\gtindexname} command}
10525 %^^A\changes{0.2d}{2007/08/18}{Cmds: the index is now inserted as a part instead of a chapter}
10526 % We then print the index:
10527 % \begin{macrocode}
10528 \printindex}
10529 % \end{macrocode}
10530 % and we are done for the index of authors, as well as for the whole \file{\filename} class!
10531 %
10532 %
10533 %^^A------------------------------------------------------------------------
10534 % \subsubsection{Layout design: show the margin lines}
10535 %
10536 % \begin{macro}{\procmarginlines}
10537 % We define a \cmd{\procmarginlines} command that defines the margin layout under the form of a tabular for \Lopt{showmarginlines=true}:
10538 % \begin{macrocode}
10539 \ifconfproc@showmarginlines
10540 \PackageInfo{confproc}{drawing margin lines' command (with a table)}%
10541 \pagestyle{fancyplain}
10542 \renewcommand{\headrulewidth}{0.0pt}
10543 % \renewcommand{\footrulewidth}{0.0pt}
10544 \newcommand{\procmarginlines}{
10545 \renewcommand{\footrulewidth}{0.4pt}
10546 \noindent
10547 % \end{macrocode}
10548 % First adjust the initial vertical space:
10549 % \begin{macrocode}
10550 \vspace*{7mm} % adjusting vertical initial space
10551 % \end{macrocode}
10552 % A table is the used to draw the vertical lines (blue color):
10553 % \begin{macrocode}
10554 \begin{table}[h!] % table for vertical lines
10555 \centering
10556 \color{blue}
10557 % \end{macrocode}
10558 % The spacing between columns corresponds to the spacing between vertical lines:
10559 % \begin{macrocode}
10560 \begin{tabular}{|@{}p{3.3in}@{}|@{}p{0.3in}@{}|@{}p{3.3in}@{}|} % spacing between columns & vertical lines
10561 % \end{macrocode}
10562 % The upper horizontal line is added:
10563 % \begin{macrocode}
10564 \hline % upper horizontal line
10565 % \end{macrocode}
10566 % Add empty lines and a vertical space to fill in the table; this space is less than a page height:
10567 % \begin{macrocode}
10568 ~~~~~~~~~~~ & ~ &~~~~~~~~~~~~~\\
10569 \vspace*{7.5in} % less than a page height
10570 ~~~~~~~~~~~ & ~ &~~~~~~~~~~~~~\\
10571 \end{tabular}
10572 \end{table}
10573 }
10574 % \end{macrocode}
10575 % the same command is otherwise defined as an empty command if \Lopt{showmarginlines=false}:
10576 % \begin{macrocode}
10577 \else
10578 \newcommand{\procmarginlines}{}
10579 \PackageInfo{confproc}{no margin lines}%
10580 \fi
10581 % \end{macrocode}
10582 % \end{macro}
10583 %
10584 %^^A------------------------------------------------------------------------
10585 % \subsubsection{paper insertion}
10586 %
10587 % We first define a path to the papers folder:
10588 % \begin{macro}{\PAPERPATH}
10589 % \begin{macrocode}
10590 \newcommand{\PAPERPATH}{}
10591 % \end{macrocode}
10592 % \end{macro}
10593 %
10594 % \begin{macro}{\confemptypapercite}
10595 % 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)}
10596
10597 % \begin{macrocode}
10598 \newcommand{\confemptypapercite}[2]{%
10599 \vspace*{0.3\textheight}%
10600 \begin{flushleft}
10601 \begin{tabular}{lp{0.7\textwidth}}
10602 \Large [Title] & \Large \conf@papertitle\\
10603 & \vspace*{0.5cm}\\
10604 \Large [Author(s)] & \Large \conf@paperauthor\\
10605 & \vspace*{0.5cm}\\
10606 \Large [File name] & \Large \url{\PAPERPATH #2}\\
10607 & \vspace*{0.5cm}\\
10608 \if@proc@BibNone
10609 \Large [Citation(s)] & \Large [disabled by ``bib=none'' option]\\
10610 & \vspace*{2cm}\\
10611 \else
10612 \Large [Citation(s)] & \Large \confcite{\conf@cite}\\
10613 & \vspace*{2cm}\\
10614 \fi
10615 & \textbf{\Huge Page #1}\\
10616 \end{tabular}
10617 \end{flushleft}
10618 }
10619 % \end{macrocode}
10620 % \end{macro}
10621 %
10622 % \begin{macro}{conf@npages}
10623 % We now define a counter that contains this paper's last page number:
10624 % \begin{macrocode}
10625 \newcounter{conf@npages}
10626 % \end{macrocode}
10627 % \end{macro}
10628 %
10629 % \begin{macro}{\confemptypaper}
10630 % 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:
10631 % \changes{0.7}{2010/08/05}{prints an empty paper with its own data (replacing \Lopt{draft} option)}
10632 % \begin{macrocode}
10633 \newcommand{\confemptypaper}[2]{%
10634 \vspace*{0.3\textheight}%
10635 \begin{flushleft}
10636 \begin{tabular}{lp{0.7\textwidth}}
10637 \Large [Title] & \Large \conf@papertitle\\
10638 & \vspace*{0.5cm}\\
10639 \Large [Author(s)] & \Large \conf@paperauthor\\
10640 & \vspace*{0.5cm}\\
10641 \Large [File name] & \Large \url{\PAPERPATH #2}\\
10642 & \vspace*{0.5cm}\\
10643 \if@proc@BibNone
10644 \Large [Citation(s)] & \Large [disabled by ``bib=none'' option]\\
10645 & \vspace*{2cm}\\
10646 \else
10647 \Large [Citation(s)] & \Large [see page \theconf@npages{} of this paper]\\
10648 & \vspace*{2cm}\\
10649 \fi
10650 & \textbf{\Huge Page #1}\\
10651 \end{tabular}
10652 \end{flushleft}
10653 }
10654 % \end{macrocode}
10655 % \end{macro}
10656 %
10657 % \begin{macro}{\procpaper}
10658 % \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:
10659 % \begin{macrocode}
10660 %%%%% begin key-value option management for \procpaper{} command %%%%%
10661 \newlength{\conf@xshift}
10662 \newlength{\conf@yshift}
10663 \newcounter{conf@switch}
10664 \newcounter{conf@firstpage}
10665 \newcounter{conf@lastpage}
10666 \newcommand{\conf@pagecmd}{}
10667 \newcommand{\conf@tmpauthorlist}{}
10668 \newcommand{\conf@tmptitle}{}
10669 % \end{macrocode}
10670 %
10671 % \begin{macro}{\confstylecheckauthor}
10672 % We also define the style of the author list when overlayed on the \nth{1} page:
10673 % \begin{macrocode}
10674 \newcommand{\confstylecheckauthor}{}
10675 % \end{macrocode}
10676 % \end{macro}
10677 %
10678 % \begin{macro}{\confstylechecktitle}
10679 % as well as the style of the title when overlayed on the 1 st page:
10680 % \begin{macrocode}
10681 \newcommand{\confstylechecktitle}{}
10682 % \end{macrocode}
10683 % \end{macro}
10684 %
10685 % \begin{macro}{\confstylechecktitle}
10686 % and a temporary number of pages:
10687 % \begin{macrocode}
10688 \newcounter{locnpages}%
10689 % \end{macrocode}
10690 % \end{macro}
10691 %
10692 % we can now define the \cmd{\procpaper} command with \package{keyval} syntax:
10693 % \changes{0.7}{2010/08/05}{replaces \cmd{\procinsertpaper}}
10694 % \changes{0.7}{2010/08/05}{now uses \package{keyval} package syntax}
10695 % \changes{0.7}{2010/08/05}{now has only 1 mandatory argument (file name) + 8 optional arguments}
10696 % \begin{macrocode}
10697 \def\procpaper{\@ifnextchar[{\@procpaper}{\@procpaper[]}}
10698 % \end{macrocode}
10699 %
10700 % Its default values are set only if the current paper has to be inserted:
10701 % \begin{macrocode}
10702 \def\@procpaper[#1]#2{{%
10703 \ifthenelse{\equal{\confproc@paperselec}{all}\or\equal{\confproc@paperselec}{#2}}
10704 {\setlength{\conf@xshift}{0cm}
10705 \setlength{\conf@yshift}{0cm}
10706 \setcounter{conf@npages}{1}
10707 \setcounter{conf@switch}{1}
10708 \def\conf@papertitle{Default paper title}
10709 \def\conf@paperauthor{Default paper author list}
10710 \def\conf@index{}
10711 \def\conf@cite{}
10712 \def\conf@bookmark{} %\pdfbookmark[2]{Default paper author 1}{p_XXX.author1}}
10713 % \end{macrocode}
10714 %
10715 % and key-values are finally set:
10716 % \begin{macrocode}
10717 \setkeys{ppaper}{#1}
10718 % \end{macrocode}
10719 %
10720 % The horizontal offset is set depending on the binding:
10721 % \begin{macrocode}
10722 \iffalse\@twoside \addtolength{\conf@xshift}{0cm}
10723 \else \addtolength{\conf@xshift}{\proc@binding} \fi
10724
10725 % \end{macrocode}
10726 %
10727 % 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}:
10728 %^^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}
10729 % \begin{macrocode}
10730 \if@proc@ReplacePDFs
10731 \immediate\write\npagesfile {file #2.pdf has \theconf@npages \space pages}
10732 \clearsingleordoublepage
10733 \setcounter{conf@firstpage}{\thenpagespreamble+\thepage}
10734 \setcounter{conf@lastpage}{\thenpagespreamble+\thepage+%
10735 \theconf@npages-1}
10736
10737 \phantomsection
10738 \addcontentsline{toc}{section}{\proctoctitleauthor{\conf@papertitle}%
10739 {\conf@paperauthor}}
10740 \ifnum\theconf@npages=0
10741 \typeout{confproc: Error, you asked for an empty paper}
10742 \typeout{confproc: #2.pdf}
10743 \fi
10744 \ifnum\theconf@npages=1
10745 \confemptypapercite{1}{#2.pdf} \conf@bookmark \conf@index{}%
10746 \fi
10747 \ifnum\theconf@npages=2
10748 \confemptypaper{1}{#2.pdf} \conf@bookmark \conf@index{}%
10749 \newpage \confemptypapercite{2}{#2.pdf}
10750 \fi
10751 \ifnum\theconf@npages>2
10752 \confemptypaper{1}{#2.pdf} \conf@bookmark \conf@index{}%
10753 \setcounter{locnpages}{2}
10754 \ifthenelse{\thelocnpages<\theconf@npages}%
10755 {\typeout{smaller}}%
10756 {\typeout{bigger}}
10757 \whiledo{\value{locnpages}<\value{conf@npages}}{%
10758 \newpage \confemptypaper{\thelocnpages}{#2.pdf}%
10759 \addtocounter{locnpages}{1}}
10760 \newpage \confemptypapercite{\theconf@npages}{#2.pdf}
10761 \fi
10762 % \end{macrocode}
10763 % we finaly set the counter for the last page number of the current empty paper:
10764 % \begin{macrocode}
10765 \setcounter{conf@lastpage}{\thenpagespreamble+\thepage}
10766 % \end{macrocode}
10767 %
10768 % Second, in the case \Lopt{paper=draft} $\mid$ \Lopt{final} $\mid$ \Lopt{countpages}:
10769 % \begin{macrocode}
10770 \else
10771 \setcounter{conf@firstpage}{\thenpagespreamble+\thepage}
10772 \conf@index{}%
10773 \ifconfproc@showpapernumber
10774 \cfoot{\color{\confproc@colorheaders}\vskip \procfootvskip %
10775 \vskip \procoptfootvskip \proccfoot\\
10776 \color{\confproc@colorheaders}[paper \theconf@switch{}]}{}
10777 % \else
10778 % % TODO: DO WE DO ANYTHING OTHERWISE?
10779 \fi
10780 \ifconfproc@checktitle
10781 \renewcommand{\conf@tmptitle}{{\color{blue}%
10782 \confstylechecktitle\conf@papertitle}}
10783 \else
10784 \renewcommand{\conf@tmptitle}{}
10785 \fi
10786 \ifconfproc@checkauthor
10787 \renewcommand{\conf@tmpauthorlist}{{\color{blue}%
10788 \confstylecheckauthor\conf@paperauthor}}
10789 \else
10790 \renewcommand{\conf@tmpauthorlist}{}
10791 \fi
10792 \renewcommand{\conf@pagecmd}{\conf@tmptitle\\ \conf@tmpauthorlist}
10793
10794 % \end{macrocode}
10795 %
10796 % In the particular case where \Lopt{paper=countpages}, the user-indicated number of pages is ignored:
10797 % \begin{macrocode}
10798 \if@proc@IncludeFullPDFs % include all pages in order to count!!!
10799 \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},pages=1,%
10800 linktodoc,linkname=\PAPERPATH #2.pdf,%
10801 addtotoc={1, section, 1, %
10802 \proctoctitleauthor{\conf@papertitle}{\conf@paperauthor},%
10803 \theconf@switch},%
10804 pagecommand = {\conf@pagecmd\procmarginlines %
10805 \conf@bookmark \PDFpagestyle}%
10806 ]{\PAPERPATH #2.pdf}%
10807 \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},pages=2-,%
10808 linktodoc,linkname=\PAPERPATH #2.pdf,%
10809 pagecommand = {\procmarginlines \PDFpagestyle}%
10810 ]{\PAPERPATH #2.pdf}%
10811 % \end{macrocode}
10812 %
10813 % Otherwise, we include either a 1-page paper:\changes{0.7}{2010/08/05}{manage 1-page long document}
10814 % \begin{macrocode}
10815 \else
10816 \ifnum\theconf@npages=1 % 1-page paper
10817 \if@proc@verbose
10818 \typeout{confproc: 1-page long paper}
10819 \fi
10820 \if@proc@BibNone
10821 \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},%
10822 pages=1,linktodoc,linkname=\PAPERPATH #2.pdf,%
10823 addtotoc={1, section, 1, %
10824 \proctoctitleauthor{\conf@papertitle}{\conf@paperauthor},%
10825 \theconf@switch},%
10826 pagecommand = {\conf@pagecmd\procmarginlines %
10827 \conf@bookmark \PDFpagestyle}%
10828 ]{\PAPERPATH #2.pdf}%
10829 \else
10830 \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},%
10831 pages=1,linktodoc,linkname=\PAPERPATH #2.pdf,%
10832 addtotoc={1, section, 1,%
10833 \proctoctitleauthor{\conf@papertitle}{\conf@paperauthor},%
10834 \theconf@switch},%
10835 pagecommand = {\conf@pagecmd\procmarginlines %
10836 \conf@bookmark \PDFpagestyle\vspace*{-1cm}\confcite{\conf@cite}}%
10837 ]{\PAPERPATH #2.pdf}%
10838 \fi
10839 \else
10840 % \end{macrocode}
10841 %
10842 % a 2-pages paper:
10843 % \begin{macrocode}
10844 \ifnum\theconf@npages=2 % 2-pages paper
10845 \if@proc@verbose\typeout{confproc: 2-page long paper}\fi
10846 \if@proc@BibNone
10847 \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},%
10848 pages=1,linktodoc,linkname=\PAPERPATH #2.pdf,%
10849 addtotoc={1, section, 1, %
10850 \proctoctitleauthor{\conf@papertitle}{\conf@paperauthor},%
10851 \theconf@switch},%
10852 pagecommand = {\conf@pagecmd\procmarginlines \conf@bookmark %
10853 \PDFpagestyle}%
10854 ]{\PAPERPATH #2.pdf}%
10855 \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},%
10856 pages=2,linktodoc,linkname=\PAPERPATH #2.pdf,%
10857 pagecommand = {\procmarginlines \PDFpagestyle}%
10858 ]{\PAPERPATH #2.pdf}%
10859 \else
10860 \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},%
10861 pages=1,linktodoc,linkname=\PAPERPATH #2.pdf,%
10862 addtotoc={1, section, 1, %
10863 \proctoctitleauthor{\conf@papertitle}{\conf@paperauthor},%
10864 \theconf@switch},%
10865 pagecommand = {\conf@pagecmd\procmarginlines \conf@bookmark %
10866 \PDFpagestyle\vspace*{-1cm}\confcite{\conf@cite}}%
10867 ]{\PAPERPATH #2.pdf}%
10868 \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},%
10869 pages=2,linktodoc,linkname=\PAPERPATH #2.pdf,%
10870 pagecommand = {\procmarginlines %
10871 \PDFpagestyle\vspace*{-2cm}\confcite{\conf@cite}}%
10872 ]{\PAPERPATH #2.pdf}%
10873 \fi
10874 % \end{macrocode}
10875 %
10876 % or a 3 (and more)-pages paper:\changes{0.7}{2010/08/05}{manages $\ge$ 3-pages long documents (no more limited to 8)}
10877 % \begin{macrocode}
10878 \else % 3 pages and more
10879 \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},%
10880 pages=1,%
10881 linktodoc,linkname=\PAPERPATH #2.pdf,%
10882 addtotoc={1, section, 1, %
10883 \proctoctitleauthor{\conf@papertitle}{\conf@paperauthor},%
10884 \theconf@switch},%
10885 pagecommand = {\conf@pagecmd\procmarginlines %
10886 \conf@bookmark \PDFpagestyle}%
10887 ]{\PAPERPATH #2.pdf}%
10888 \ifdefined\conf@BibMerge%
10889 \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},%
10890 pages=\theconf@npages,linktodoc,linkname=\PAPERPATH #2.pdf,%
10891 pagecommand = {\procmarginlines %
10892 \PDFpagestyle\vspace*{-2cm}\confcite{\conf@cite}}%
10893 ]{\PAPERPATH #2.pdf}%
10894 \PDFpagestyle{}%
10895 \if@proc@verbose\typeout{confproc: bibliography insertion only}\fi
10896 \else
10897 \addtocounter{conf@npages}{-1}
10898 \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},%
10899 pages=2-\theconf@npages,linktodoc,linkname=\PAPERPATH #2.pdf,%
10900 pagecommand = {\procmarginlines \PDFpagestyle}%
10901 ]{\PAPERPATH #2.pdf}%
10902 \PDFpagestyle{}%
10903 \addtocounter{conf@npages}{1}
10904 \if@proc@BibNone
10905 \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},%
10906 pages=\theconf@npages,linktodoc,linkname=\PAPERPATH #2.pdf,%
10907 pagecommand = {\procmarginlines \PDFpagestyle}%
10908 ]{\PAPERPATH #2.pdf}%
10909 \else
10910 \includepdf[noautoscale,offset=\conf@xshift{} \conf@yshift{},%
10911 pages=\theconf@npages,linktodoc,linkname=\PAPERPATH #2.pdf,%
10912 pagecommand = {\procmarginlines %
10913 \PDFpagestyle\vspace*{-2cm}\confcite{\conf@cite}}%
10914 ]{\PAPERPATH #2.pdf}%
10915 \fi
10916 \fi
10917 \fi
10918 \fi
10919 \if@proc@verbose
10920 \typeout{confproc: partial paper insertion %
10921 (last page=bib items)}
10922 \fi
10923 \fi
10924 % \end{macrocode}
10925 %
10926 % we compute the number of pages and write it to the file that counts the number of pages:
10927 % \changes{0.7}{2010/08/05}{counts each paper's number of pages and prints output into \file{.npc} file}
10928 % \begin{macrocode}
10929 \setcounter{conf@lastpage}{\thenpagespreamble+\thepage-1}
10930 \setcounter{conf@npages}{\theconf@lastpage}
10931 \addtocounter{conf@npages}{- \theconf@firstpage}
10932 \immediate\write\npagesfile{file #2.pdf has \theconf@npages \space pages}
10933 % \end{macrocode}
10934 %
10935 % and finally turn the page for next paper or section:
10936 % \begin{macrocode}
10937 \newpage
10938 \ifconfproc@twosidepapers \cleardoublepage
10939 \else \clearpage \fi
10940 \fi
10941 % \end{macrocode}
10942 %
10943 % Let us also give some feedback to the user when \Lopt{verbose=true}:
10944 % \begin{macrocode}
10945 \if@proc@verbose
10946 \typeout{______ debug: insert paper ______}
10947 \typeout{confproc/file: #2.pdf (\theconf@npages \space pages)}
10948 \typeout{confproc/title: \conf@papertitle}
10949 \typeout{confproc/authors: \conf@paperauthor}
10950 \typeout{confproc/index: \conf@index}
10951 \typeout{confproc/shift: (\the\conf@xshift, \the\conf@yshift)}
10952 \typeout{confproc/citations: \conf@cite}
10953 \typeout{confproc/bookmarks: \conf@bookmark}
10954 \typeout{confproc/switch ID: \theconf@switch}
10955 \typeout{_______________________}
10956 \fi
10957 % \end{macrocode}
10958 % 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:
10959 % \begin{macrocode}
10960 \ifconfproc@pdftk
10961 % \immediate\write\pdftkinfoall {________________}
10962 %%-- pdftk version: !!! does not work with PDF v > 1.3
10963 %% \immediate\write\pdftkinfoall{pdftk A=${PDFFILE} cat A\arabic{conf@firstpage}-\arabic{conf@lastpage} output ${SPPATH}/#2.pdf}
10964 %%-- Ghostscript version: ok with PDF v = 1.4
10965 \immediate\write\pdftkinfoall{gs -dBATCH -dNOPAUSE -q -sDEVICE=pdfwrite -dFirstPage=\arabic{conf@firstpage} -dLastPage=\arabic{conf@lastpage} -sOUTPUTFILE=${SPPATH}/#2.pdf ${PDFFILE}}
10966
10967 % \end{macrocode}
10968 %
10969 % Such text is also written to individual files in the selected folder:
10970 % \begin{macrocode}
10971 %%-- pdftk version: !!! does not work with PDF v > 1.3
10972 %% \immediate\write\pdftkinfoall{pdftk A=${PDFFILE} cat A\arabic{conf@firstpage}-\arabic{conf@lastpage} output ${SPPATH}/#2.pdf}
10973 %%-- Ghostscript version: ok with PDF v = 1.4
10974 \immediate\openout\pdftkinfofile=\confproc@pdftkfolder/#2.pdftk
10975 \immediate\write\pdftkinfofile {InfoKey: Title}
10976 \immediate\write\pdftkinfofile {InfoValue: \conf@papertitle}
10977 \immediate\write\pdftkinfofile {InfoKey: Author}
10978 \immediate\write\pdftkinfofile {InfoValue: \conf@paperauthor}
10979 \immediate\write\pdftkinfofile {InfoKey: Subject}
10980 \immediate\write\pdftkinfofile {InfoValue: \confproc@pdftksubject}
10981 \immediate\write\pdftkinfofile {InfoKey: Producer}
10982 \immediate\write\pdftkinfofile {InfoValue: \confproc@pdftkproducer}
10983 \immediate\write\pdftkinfofile {InfoKey: Creator}
10984 \immediate\write\pdftkinfofile {InfoValue: \confproc@pdftkcreator}
10985 \immediate\closeout\pdftkinfofile
10986 % \end{macrocode}
10987 %
10988 % Finally, this text is also written to the log when \Lopt{verbose=true}:
10989 % \begin{macrocode}
10990 \ifconfproc@verbose
10991 \typeout{________________}
10992 \typeout{pdftk A=${PDFFILE} cat A\arabic{conf@firstpage}-\arabic{conf@lastpage} output ${SPPATH}/#2.pdf}
10993 \typeout{gs -dBATCH -dNOPAUSE -q -sDEVICE=pdfwrite -dFirstPage=\arabic{conf@firstpage} -dLastPage=\arabic{conf@lastpage} -sOUTPUTFILE=${SPPATH}/#2.pdf ${PDFFILE}}
10994 % \typeout{pdftk ${SPPATH}/#2.pdf update_info ${INPATH}/#2.info output ${INPATH}/#2.pdf}
10995 \typeout{InfoName: #2.info}
10996 \typeout{InfoKey: Title}
10997 \typeout{InfoValue: \conf@papertitle}
10998 \typeout{InfoKey: Author}
10999 \typeout{InfoValue: \conf@paperauthor}
11000 \typeout{InfoKey: Subject}
11001 \typeout{InfoValue: \confproc@pdftksubject}
11002 \typeout{InfoKey: Producer}
11003 \typeout{InfoValue: \confproc@pdftkproducer}
11004 \typeout{InfoKey: Creator}
11005 \typeout{InfoValue: \confproc@pdftkcreator}
11006 \typeout{InfoEnd}
11007 \fi
11008 \fi
11009 }{}
11010 }}
11011 % \end{macrocode}
11012 %
11013 % We finally set the key-values using the pre-defined internal commands:
11014 % \begin{macrocode}
11015 \define@key{ppaper}{xshift}{\setlength{\conf@xshift}{#1}}
11016 \define@key{ppaper}{yshift}{\setlength{\conf@yshift}{#1}}
11017 \define@key{ppaper}{npages}{\setcounter{conf@npages}{#1}}
11018 \define@key{ppaper}{switch}{\setcounter{conf@switch}{#1}}
11019 \define@key{ppaper}{title}{\def\conf@papertitle{#1}}
11020 \define@key{ppaper}{author}{\def\conf@paperauthor{#1}}
11021 \define@key{ppaper}{index}{\def\conf@index{#1}}
11022 \define@key{ppaper}{cite}{\def\conf@cite{#1}}
11023 \define@key{ppaper}{bookmark}{\def\conf@bookmark{#1}}
11024 %%%%% end key-value option management for \procpaper{} command %%%%%
11025 % \end{macrocode}
11026 % \end{macro}
11027 %
11028 %
11029 % \begin{macro}{\procinsertpaper}
11030 % We also redefine its pre-version 0.6 using this latest function, for (partial) backward compatibility:
11031 % \changes{0.4a}{2007/10/03}{manages 1-page long papers (no ref printed yet)}
11032 % \changes{0.4c}{2007/10/12}{author is back in bookmark (missing \#9 arg in \cmd{\pagecommand}, bug in v0.4a)}
11033 % \changes{0.6}{2009/09/08}{now uses \cmd{\procpaper}}
11034 %
11035 % \begin{macrocode}
11036 \newcommand{\procinsertpaper}[9]{%
11037 % \end{macrocode}
11038 % 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.
11039 % \begin{macrocode}
11040 \PackageWarning{confproc}{!!! '\procinsertpaper' cmd is obsolete (v0.5) %
11041 and does not preserve PDFs' horizontal and vertical shifts, nor general %
11042 bib items. Please use the '\procpaper' command instead.}
11043 \procpaper[title={#4},author={#5},npages=#2,index={#6},cite={#7},%
11044 bookmark={#9}]{#8}}
11045 % \end{macrocode}
11046 % \end{macro}
11047 %
11048 % \color{black}
11049 %
11050 %
11051 %^^A =================================================================
11052 %^^A Config file
11053 %^^A =================================================================
11054 % \subsection{Load configuration}
11055 % \label{subsec:loadconfig}
11056 %
11057 % Input a local configuration file (\file{confproc.cfg}), if it
11058 % exists.
11059 % \begin{macrocode}
11060 \InputIfFileExists{confproc.cfg}
11061 {\typeout{************^^J%
11062 * Local config file confproc.cfg used *^^J%
11063 ************}
11064 }{}%
11065 %</package>
11066 % \end{macrocode}
11067 %
11068 %^^A =================================================================
11069 %^^A Here the \StopEventually stuff will be appended (if we build
11070 %^^A the `programmer' docu)
11071 %^^A =================================================================
11072 % \Finale
11073 %
11074 \endinput
11075 %
11076 % \fi