Lipics V2018 Manual

lipics-v2018-manual

User Manual:

Open the PDF directly: View PDF .
Page Count: 8

The lipics-v2018 Class

Dagstuhl Publishing

Schloss Dagstuhl – Leibniz-Zentrum für Informatik

Oktavie-Allee, 66687 Wadern, Germany

publishing@dagstuhl.de

Abstract

This document provides a manual of the lipics-v2018 class including a description of the most

relevant changes in the new version lipics-v2018 of the LIPIcs style compared to the previous

version lipics-v2016. Furthermore we provide a short guideline to switch an article from

lipics-v2016 to lipics-v2018.

2012 ACM Subject Classiﬁcation General and reference →Computing standards, RFCs and

guidelines

Keywords and phrases L

EX, style, changelog

Supplement Material The style ﬁle including a sample document can be found at

http://drops.dagstuhl.de/styles/lipics-v2018/lipics-v2018-authors.tgz

Contents

1 Introduction 2

2 How to use the package 2

3 Some important settings and commands 2

3.1 Paperformat .................................... 2

3.2 Language ...................................... 2

3.3 Inputencoding ................................... 3

3.4 Fonts......................................... 3

3.5 Titles ........................................ 3

3.6 Mathematicalformulas............................... 4

3.7 Theorem-like environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

3.8 Lists......................................... 4

3.9 Listings ....................................... 4

3.10Graphics....................................... 5

3.11Tables ........................................ 5

3.12Rotatingﬂoats ................................... 5

3.13Sub-captions .................................... 5

3.14Bibliography .................................... 5

3.15Linenumbers .................................... 6

3.16 Adding further packages and new macros . . . . . . . . . . . . . . . . . . . . 6

4 Changes in lipics-v2018 compared to lipics-v2016 6

5 How to switch from lipics-v2016 to lipics-v2018 7

6lipics-v2018 enumeration styles 8

©Dagstuhl Publishing; Version: 2018–02–26, 09:30 ;

licensed under Creative Commons License CC-BY

Leibniz International Proceedings in Informatics

Schloss Dagstuhl – Leibniz-Zentrum für Informatik, Dagstuhl Publishing, Germany

1:2 The lipics-v2018 Class

1 Introduction

The

lipics-v2018

class assists in preparing articles for Leibniz International Proceedings in

Informatics with L

X. It adapts L

X’s standard

article

class to meet some requirements

for LIPIcs and provides a speciﬁc layout.

The package consists of the following ﬁles:

lipics-v2018-manual.pdf this documentation

lipics-v2018-sample-article.tex the L

EX master ﬁle, to be used as a template

lipics-v2018.cls

the L

X class ﬁle

, providing adaptions for LIPIcs and producing the

layout

cc-by.pdf logo1for Creative Commons CC BY

lipics-logo-bw.pdf logo1for LIPIcs

orcid.pdf logo1for ORCID

This documentation is not intended to give an introduction to L

X. For questions

concerning T

X systems/installations or the L

X mark-up language in general please visit

www.tug.org

www.dante.de

uk.tug.org

or any other T

X user group worldwide. The

essential reference for L

X is Mittelbach F., Goossens M. (2004) The L

X Companion.

2nd edn., but there are many other good books delivering insight into L

EX.

lipics-v2018

tries to beneﬁt as far as possible from standard L

X packages. (Have a

look at

lipics-v2018.cls

to see which packages are used.) Therefore, it should also be easy

to compile an already written manuscript with the

lipics-v2018

layout. To learn more about

the underlying packages we refer to their documentations (try e.g.

texdoc [package name]

at your shell prompt or visit tug.ctan.org).

2 How to use the package

We suggest to employ a recent T

X installation: the most important distributions, T

X Live,

MiKT

X/proT

Xt and MacT

X, all provide at least 2017 versions. But older versions should

(in principle) work as well.

To use

lipics-v2018

, put “lipics-v2018-sample-article.tex”, “lipics-v2018.cls”, “cc-by.pdf”,

“lipics-logo-bw.pdf”, and “orcid.pdf” in your working directory, edit the ﬁle “lipics-v2018-

sample-article.tex” in your preferred text editor and run L

X as usual. (See the following

section for more detailed advises.)

3 Some important settings and commands

3.1 Paper format

You can choose between the A4 format and the US-letter format. The respective options

“

a4paper

” or “

letterpaper

” must be inserted in the optional argument of

\documentclass

For LIPIcs, A4 format is preferred and will be used to prepare the ﬁnal version.

3.2 Language

The document language is chosen in the optional argument of the

\documentclass

command

in the L

EX master ﬁle. Possible values are USenglish,UKenglish and many others.

1Available on http://drops.dagstuhl.de/styles/lipics-v2018/lipics-v2018-editors.tgz

Dagtuhl Publishing 1:3

3.3 Input encoding

lipics-v2018

preselects UTF-8 as input encoding. Please do not change the input encoding

because otherwise the volume compilation might become diﬃcult.

3.4 Fonts

lipics-v2018

uses the Latin Modern font family. This is a recent redesign of the good old

Computer Modern fonts. Latin Modern provides a lot of characters and all neccessary math

fonts. If your T

X installation does not provide the Latin Modern family, Computer Modern

is used as a fallback.

lipics-v2018

preloads the package “

amssymb

” to make additional mathematical symbols

available. Other symbol packages, e.g.

stmaryrd

, may be added, of course. Moreover, the

script math alphabet is provided by loading the

eucal

package. – But please avoid loading

the

MnSymbol

package. (Note that the

lipics-v2018

removes all symbol re-deﬁnitions done

by MnSymbol anyhow, but would retain its newly introduced symbol deﬁnitions.)

3.5 Titles

The prelims of a LIPIcs article is the only part where some speciﬁc commands are required:

The title is tagged as usual with the

\title{...}

command. If you need a short form

for the running head, use the optional \titlerunning{...}.

Authors and their aﬃliations are rendered blockwise for LIPIcs

. The information for

each author is to be tagged with a re-deﬁend

\author

macro which has the structure:

\author{name}{affil}{email}{orcid}{funding}

. While the parameters

name

and

affil

are mandatory, the latter parameters

orcid

, and

funding

are optional and

can be empty.

The usage of an ORCID is currently optional but highly recommended. For more details

regarding ORCID, please visit

https://orcid.org

. If you don’t have yet an ORCID,

the registration is very quick and simple (see

https://orcid.org/register

). Please

enter full https URI, including hyphens between every fourth digit as recommended by

ORCID3

There is an additional

\authorrunning{...}

for the running header concatenating all

authors name (but with abbreviated ﬁrst names); it must be used.

\Copyright{...} has just one argument for the copyright holder.

\subjclass{...}

is for classiﬁcation information following the ACM 2012 Computing

Classiﬁcation System; it is required, too.

\keywords{...} must be used to capture keywords.

\category{...} may be used to provide category information.

\relatedversion{...} may be used to denote a related version.

\supplement{...} may be used to denote supplements.

\funding{...} may be used to capture a funding statement.

\acknowledgements{...} may be used to capture an acknowledgement.

This has changed in 2017; the formerly used “authblk” mechanism to output authors and aﬃlations in

footnote style is deprecated; the \affil command is now obsolete for the lipics-v2018class.

3https://support.orcid.org/knowledgebase/articles/116780

1:4 The lipics-v2018 Class

The commands mentioned so far should be used in the document preamble of the L

ﬁle. Providing a title, at least one author, copyright information, subject classiﬁcation, and

keywords is required.

To typeset an abstract use

\begin{abstract}...\end{abstract}

. The environment

must be placed after \begin{document} and \maketitle!

Note that subject classiﬁcations, keywords, . . . , and acknowledgements will be rendered

together with the abstract. So it is necessary to use the

abstract

environment in order to

get the output for \subjclass etc.

The

\hideLIPIcs

command is to mask all copyright information (and a possible DOI

speciﬁcation) on the ﬁrst page.

3.6 Mathematical formulas

The

amsmath

package is preloaded, and you are encouraged to use the mark-up it provides

instead of old-style standards like the eqnarray environment or the \over command.

3.7 Theorem-like environments

The

amsthm

package is preloaded, and the following environments are already introduced:

theorem,lemma,corollary,definition,example and remark.

Setting up additional environments works with the +echanism from the

amsthm

package.

For example, add to your document preamble

\theoremstyle{plain}

\newtheorem{conjecture}[theorem]{Conjecture}

See also the amsthm package documentation.

Available

\theoremstyle

s are:

plain

definition

, and

remark

(all from the

amsthm

package, but slightly modiﬁed for LIPIcs).

Note that for LIPIcs all numbered theorem-like environments should use one and the

same counter, i. e. the counter of the default environment "‘theorem"’.

By default, theorem-like environments are numbered consecutively throughout the doc-

ument. To number the environments subordinately within sections use the class option

"‘numberwithinsect"’:

\documentclass[numberwithinsect]{lipics-v2018}.

3.8 Lists

List labels are set ﬂush left. For enumerations with more than 9 items please insert

\addtolength\leftmargini{0.5em} before \begin{enumerate}.

The

enumerate

package is preloaded, so you can use

\begin{enumerate}[(a)]

or the

like.

3.9 Listings

The

listings

package is preloaded. It provides the

lstlisting

environment to typeset

displayed code. Here, the package is conﬁgured to get a grey background for listings.

The following example shows how to use captions and labels with the

lstlisting

environment:

Dagtuhl Publishing 1:5

\begin{lstlisting}[caption={Useless code},label=list:8-6,float,

abovecaptionskip=-\medskipamount]

for i:=maxint to 0 do

begin

j:=square(root(i));

end;

\end{lstlisting}

Note also the

float

option to make the listing ﬂoating. Instead of the

caption

option

one might prefer the

title

option which outputs the argument without the “Listing” label.

To globally change the label name from “Listing”, add to your document preamble e.g.

\renewcommand*\lstlistingname{Algorithm}

Please read the package documentation for more information on the

lstlisting

envir-

onment and how to adapt it locally.

3.10 Graphics

The standard interface for graphic inclusion is the

\includegraphics

command provided

by the

graphicx

package. Note that the

\graphicspath

command allows to declare one or

more folders where the

graphicx

package looks for the image ﬁles; so providing the path

with each \includegraphics command is not necessary.

3.11 Tables

Preloaded packages are: the

array

package (for introducing new column types), the

multirow

package (row spanning cells) and the

tabularx

package (automatic column width calculation).

In order to allow easy use of table footnotes, the

threeparttable

package is preloaded.

Please read the short documentation in

threeparttables.sty

to see how the related

commands are applied.

3.12 Rotating ﬂoats

The preloaded

rotating

package provides the two environments “

sidewaysfigure

” and

“sidewaystable”. They allow the rotation of ﬂoating objects.

3.13 Sub-captions

The preloaded

subcaption

package provides the

\subcaption

command to add sub-captions.

Please do not load the aged subfig package.

3.14 Bibliography

It is highly recommended to use BibT

X as the standard bibliography mechanism. For

BibT

X, the standard bibliography style for LIPIcs is “plainurl”. Please do not not change the

bibliographic style. LIPIcs only allows numerical citation and forbids author-year citations.

(So the natbib package is not used by lipics-v2018.)

1:6 The lipics-v2018 Class

3.15 Line numbers

The

lineno

package is loaded, and line numbering is switched on by default. To switch line

numbering (globally) oﬀ, use \nolinenumbers (in the document preamble).

3.16 Adding further packages and new macros

Feel free to add further packages if you need extra structural mark-up. But keep in mind that

you should not change the general layout of the article. Changing text width or linespreads,

for example, are forbidden.

Happy T

EXing!

4 Changes in lipics-v2018 compared to lipics-v2016

lipics-v2018

, authors and their aﬃliations are rendered blockwise. The formerly

used “authblk” mechanism to output authors and aﬃlations in footnote style is de-

precated; the

\affil

command is now obsolete for

lipics-v2018

. The information

for each author is to be tagged with a re-deﬁned

\author

macro which has the struc-

ture:

\author{name}{affil}{email}{orcid}{funding}

. While the parameters

name

and

affil

are mandatory, the latter parameters

orcid

, and

funding

are optional

and can be empty.

The usage of an ORCID is currently optional but highly recommended. For more details

regarding ORCID, please visit

https://orcid.org

. If you don’t have yet an ORCID,

the registration is very quick and simple (see

https://orcid.org/register

). Please

enter full https URI, including hyphens between every fourth digit as recommended by

ORCID4

lipics-v2018

, the newest ACM Classiﬁcation System is used: the 2012 ACM Com-

puting Classiﬁcation System

. In the revised macro

\subjclass

, it is also possible to use

the LaTeX snippet generated in the ACM digital library

to enter the ACM classiﬁcation

(e.g., \ccsdesc[500]{Hardware~3D integrated circuits}).

Several new (but optional) commands has been added to the style to allow explicit

labeling of frequently provided and searched information characterizing the document:

\category{...} may be used to provide category information (e.g., “Invited Talk”).

\relatedversion{...}

may be used to denote a related version (e.g., an extended

version hosted on arXiv).

\supplement{...}

may be used to denote supplements (e.g., research artifacts, like

data or source code hosted on a public repository like zenodo

or GitHub

or published

in a venue like DARTS9).

\funding{...}

may be used to capture a funding statement, which applies to all

authors. Please enter author speciﬁc funding statements as ﬁfth argument of the

\author macro.

\acknowledgements{...} may be used to capture an acknowledgment.

4https://support.orcid.org/knowledgebase/articles/116780

5https://www.acm.org/publications/class-2012

6https://dl.acm.org/ccs/ccs_flat.cfm

7https://zenodo.org/

8https://github.com/

9http://www.dagstuhl.de/darts/

Dagtuhl Publishing 1:7

If mandatory data are missing (

\title

\author

\authorrunning

\copyright

\subjclass

and

\keywords

), the resulting PDF will contain a colored warning. For

example, if the

\title

is missing or empty, the alternative title “Author: Please

provide a title” is shown.

The

enumerate

package is preloaded in

lipics-v2018

, so it is possible to ﬂex-

ibly deﬁne own enumeration styles besides the normal

\begin{enumerate}

, e.g.,

\begin{enumerate}[(a)]

. Furthermore,

lipics-v2018

contains some more pre-

deﬁned enumerate environments: \begin{romanenumerate},

\begin{alphaenumerate}

, and

\begin{bracketenumerate}

. See Section 6 for more

details.

The

\hideLIPIcs

command masks all information related to the series (e.g., copyright

information and a possible DOI speciﬁcation) on the ﬁrst page. This might be used

e.g. to prepare an extended version to be uploaded to arXiv.

To ease the communication during the review and typesetting phase, the

lineno

package is loaded and line numbering is switched on by default. To switch line

numbering (globally) oﬀ, use \nolinenumbers (in the document preamble).

Bugﬁxes:

∗

A bad line break of the

line has been ﬁxed (Only visible, if the paper

has many authors and so the \copyright macro is longer than one line.).

∗

The

subcaption

package is preloaded in

lipics-v2018

but also in

lipics-v2016

Due to incompatibilities to the (outdated)

subfig

package, an error is thrown in

lipics-v2018

to avoid undeﬁned behaviors when both packages

subcaption

and

subfig are loaded.

∗

In previous style versions, the usage of the

MnSymbol

package results in replacing

the default symbols (e.g., provided by the

amsmath

package). In

lipics-v2018

, the

usage of the

MnSymbol

should still be avoided but now, only undeﬁned/non-existing

symbol deﬁnitions are replaced by this package.

∗

To number the theorem-like environments subordinately within sections, it is possible

to use the class option “numberwithinsect”. In

lipics-v2016

, these environments

wasn’t numbered correctly, when they was part of the appendix. This is ﬁxed in

lipics-v2018.

∗

When compiling the L

Xsources, not only a PDF but also a vtc ﬁle is generated.

This ﬁle contains the data for the table of contents in the frontmatter for the

respective paper, namely the authors, the title and the page range. In previous

versions of the style, footnotes associated to authors was also exported in the

vtc ﬁle and must be manually removed when preparing the table of contents. In

lipics-v2018, no footnotes will be exported.

5 How to switch from lipics-v2016 to lipics-v2018

The following steps are mandatory to switch a document from the

lipics-v2016

to the

lipics-v2018 document class:

1. Copy the ﬁles lipics-v2018.cls and orcid.pdf to your document folder.

2. Open your main L

EXﬁle and

a. change the document class from \documentclass[...]{lipics-v2016} to

\documentclass[...]{lipics-v2018};

b. for every author, revise the existing \author macro by

1:8 The lipics-v2018 Class

removing the (optional) aﬃliation number (e.g. change

\author[1]{John Doe}

\author{John Doe}),

adding four (empty) ﬁelds to the

\author

macro (e.g. change

\author{John Doe}

to \author{John Doe}{}{}{}{}),

moving the aﬃliation (incl. the address) to the second ﬁeld of the

\author

macro (e.g.

\author{John Doe}{Dummy University, Address/City, Country}{}{}{}),

moving the email address to the third ﬁeld of the \author macro,

deleting \affil commands,

(optionally) adding the ORCID id as forth ﬁeld of the \author macro,

(optionally) moving a footnote associated to the author to the ﬁfth ﬁeld of the

\author macro;

remove current content of the

\subjclass

macro and add appropriate 2012 ACM

classiﬁcations to the macro (e.g. retrieved from

https://dl.acm.org/ccs/ccs_flat.

cfm);

The following steps are optional:

Add a reference to a related version of the document (e.g. a reference to an extended or

full version mentioned usually as a title footnote or at end of the introduction) to the

\relatedversion macro (e.g.

\relatedversion{A full version of the paper is available at \url{XXX}.})

Move funding acknowledgments (e.g. mentioned in an acknowledgments section or in a

footnote associated to the title) to the \funding macro.

Move acknowledgments from a separate section (e.g. provided at the end of the conclusions)

to the \acknowledgements macro.

6lipics-v2018 enumeration styles

List of diﬀerent pre-deﬁned enumeration styles:

\begin{itemize}...\end{itemize}

. . .

1. \begin{enumerate}...\end{enumerate}

2. . . .

3. . . .

(a) \begin{alphaenumerate}...\end{alphaenumerate}

(b) . . .

(i) \begin{romanenumerate}...\end{romanenumerate}

(ii) . . .

(iii) . . .

(1) \begin{bracketenumerate}...\end{bracketenumerate}

(2) . . .

(3) . . .

Lipics V2018 Manual