Note: This document is a translation of the German koma script manual



Yüklə 2,79 Mb.
Pdf görüntüsü
səhifə1/60
tarix03.02.2017
ölçüsü2,79 Mb.
#7439
  1   2   3   4   5   6   7   8   9   ...   60

KOMA-Script

a versatile L

A

TEX 2ε bundle



Note: This document is a translation of the German KOMA - Script manual.

Several


authors have been involved to this translation. Some of them are native English speakers,

others like me are not. Improvements of the translation by native speakers or experts are

welcome at all times!


The Guide

KOMA-Script

Markus Kohm

2017-01-02

Authors of the KOMA-Script Bundle: Frank Neukam, Markus Kohm, Axel Kielhorn



Legal Notes:

There is no warranty for any part of the documented software. The authors have taken

care in the preparation of this book, but make no expressed or implied warranty of any kind

and assume no responsibility for errors or omissions. No liability is assumed for incidental

or consequential damages in connection with or arising out of the use of the information or

programs contained here.

Many of the designations used by manufacturers and sellers to distinguish their products are

claimed as trademarks. Where those designations appear in this book, and the authors were

aware of a trademark claim, the designations have been printed with initial capital letters or

in all capitals.

English translation of this manual by:

Kevin Pfeiffer, Gernot Hassenpflug, Krickette

Murabayashi, Markus Kohm, Jens-Uwe Morawski, Jana Schubert, Jens Hühne, Harald Bon-

gartz, Georg Grandke, Raimund Kohl, Stephan Hennig, Alexander Willand, Melvin Hendrix,

and Arndt Schubert.

Free screen version without any optimization of paragraph and page breaks

This guide is part of KOMA - Script, which is free under the terms and conditions of L

A

TEX



Project Public License Version 1.3c. A version of this license, which is valid to KOMA -

Script, is part of KOMA - Script (see lppl.txt). Distribution of this manual — even if it is

printed — is allowed provided that all parts of KOMA - Script are distributed. Distribution

without the other parts of KOMA - Script needs an explicit, additional authorization by the

authors.


To All Friends of Typography!

Preface to the English KOMA-Script Guide

7

Preface to the English KOMA-Script Guide

The translation of the German KOMA-Script guide is still a work in progress and a never

ending story. I always try to have an English user guide with all descriptions of the German

one. But as long as I have to do the primary translation, these translations not only can but

should be improved.

In this release the translation of

chapter 15

has been completed. Nevertheless, a proficient

English speaker with basic TeX knowledge could improve the translation. A large part of

chap-


ter 11

has been translated by Alexander Willand. The remaining part may need improvement.

The example still has not been translated.

So this English guide is complete but nevertheless not as good as the German one. Currently

there are only a few editors for the English guide, who improve my translation for free. Many

thanks to them for their very good job! Nevertheless, additional editors or translators would

be welcome!


Contents

8

Contents

Preface to the English KOMA-Script Guide

7

1. Introduction

20

1.1.


Preface

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

1.2.

Structure of the Guide



. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

1.3.


History of KOMA-Script

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

1.4.

Special Thanks



. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

1.5.


Legal Notes

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

1.6.

Installation



. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

1.7.


Bug Reports and Other Requests

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

1.8.

Additional Information



. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Part I:

KOMA-Script for Authors

24

2. Construction of the Page Layout with typearea

25

2.1.


Fundamentals of Page Layout

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

2.2.

Page Layout Construction by Dividing



. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

2.3.


Page Layout Construction by Drawing a Circle

. . . . . . . . . . . . . . . . . . . . . . . 29

2.4.

Early or late Selection of Options



. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

2.5.


Compatibility with Earlier Versions of KOMA-Script

. . . . . . . . . . . . . . . . . . . 30

2.6.

Options and Macros to Influence the Page Layout



. . . . . . . . . . . . . . . . . . . . . 31

2.7.


Paper Format Selection

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

2.8.

Tips


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

3. The Main Classes: scrbook, scrreprt, and scrartcl

51

3.1.



Early or late Selection of Options

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

3.2.

Compatibility with Earlier Versions of KOMA-Script



. . . . . . . . . . . . . . . . . . . 53

3.3.


Draft Mode

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

3.4.

Page Layout



. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

3.5.


Selection of the Document Font Size

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

3.6.

Text Markup



. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

3.7.


Document Titles

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

3.8.

Abstract


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

3.9.


Table of Contents

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

3.10. Paragraph Markup

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73



Contents

9

3.11. Detection of Odd and Even Pages

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

3.12. Head and Foot Using Predefined Page Styles

. . . . . . . . . . . . . . . . . . . . . . . . . 76

3.13. Interleaf Pages

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

3.14. Footnotes

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

3.15. Demarcation

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

3.16. Structuring of Documents

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

3.17. Dicta

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

3.18. Lists

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

3.19. Math

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

3.20. Floating Environments of Tables and Figures

. . . . . . . . . . . . . . . . . . . . . . . . . 119

3.21. Margin Notes

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

3.22. Appendix

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

3.23. Bibliography

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

3.24. Index

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

4. The New Letter Class scrlttr2

142


4.1.

Variables

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142

4.2.


Pseudo-Lengths

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147

4.3.

Early or late Selection of Options



. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

4.4.


Compatibility with Earlier Versions of KOMA-Script

. . . . . . . . . . . . . . . . . . . 149

4.5.

Draft Mode



. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

4.6.


Page Layout

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

4.7.

General Structure of Letter Documents



. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

4.8.


Selection of the Document Font Size

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

4.9.

Text Markup



. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163

4.10. Note Paper

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

4.11. Paragraph Markup

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

4.12. Detection of Odd and Even Pages

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198

4.13. Head and Foot Using Predefined Page Style

. . . . . . . . . . . . . . . . . . . . . . . . . . 199

4.14. Interleaf Pages

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203

4.15. Footnotes

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205

4.16. Lists

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208

4.17. Math

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211

4.18. Floating Environments of Tables and Figures

. . . . . . . . . . . . . . . . . . . . . . . . . 211

4.19. Margin Notes

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211

4.20. Closing

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212

4.21. Letter Class Option Files

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214

4.22. Address Files and Circular Letters

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220


Contents

10

5. Adapting Page Headers and Footers with scrlayer-scrpage

225


5.1.

Early or late Selection of Options

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225

5.2.


Head and Foot Height

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227

5.3.

Text Markup



. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227

5.4.


Usage of Predefined Page Styles

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230

5.5.

Manipulation of Defined Page Styles



. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240

6. The Day of the Week Using scrdate

252


7. Getting the Time with Package scrtime

257


8. Access to Address Files with scraddr

259


8.1.

Overview


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259

8.2.


Usage

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260

8.3.

Package Warning Options



. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261

9. Creating Address Files from an Address Database

263


10. KOMA-Script Features for other Classes with Package scrextend

264


10.1. Early or late Selection of Options

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264

10.2. Compatibility with Earlier Versions of KOMA-Script

. . . . . . . . . . . . . . . . . . . 266

10.3. Optional, Extended Features

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266

10.4. Draft Mode

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267

10.5. Selection of the Document Font Size

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267

10.6. Text Markup

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268

10.7. Document Titles

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270

10.8. Detection of Odd and Even Pages

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274

10.9. Head and Foot Using Predefined Page Styles

. . . . . . . . . . . . . . . . . . . . . . . . . 275

10.10. Interleaf Pages

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275

10.11. Footnotes

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278

10.12. Dicta

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282

10.13. Lists

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283

10.14. Margin Notes

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285



11. Support for the Law Office by scrjura

286


11.1. Early or late Selection of Options

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286

11.2. Text Markup

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287

11.3. Table of Contents

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288

11.4. Environment for Contracts

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289

11.4.1. Clauses

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289

11.4.2. Paragraphs

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292



Contents

11

11.4.3. Sentences

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294

11.5. Cross References

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295

11.6. Additional Environments

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297

11.7. Support for Different Languages

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299

11.8. A Detailed Example

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299

11.9. State of Development

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304

Part II:

KOMA-Script for Advanced Users and Experts

307


12. Basic Functions of Package scrbase

308


12.1. Loading the Package

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308

12.2. Keys as Attributes of Families and their Members

. . . . . . . . . . . . . . . . . . . . . 309

12.3. Conditional Execution

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321

12.4. Definition of Language-Dependent Terms

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 325

12.5. Identification of KOMA-Script

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328

12.6. Extension of the L

A

TEX Kernel



. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329

12.7. Extension of the Mathematical Features of ε-TEX

. . . . . . . . . . . . . . . . . . . . . 329

13. Control Package Dependencies with scrlfile

331


13.1. About Package Dependencies

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331

13.2. Actions Prior to and After Loading

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332

13.3. Replacing Files at Input

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336

13.4. Prevent File Loading

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339



14. Economise and Replace Files Using scrwfile

342


14.1. General Modifications of the L

A

TEX Kernel



. . . . . . . . . . . . . . . . . . . . . . . . . . . 342

14.2. The Single File Feature

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343

14.3. The Clone File Write Feature

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343

14.4. Note on State of Development

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344

14.5. Known Package Incompatibilities

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345

15. Management of Tables and Lists of Contents Using tocbasic

346


15.1. Basic Commands

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346

15.2. Creating a Table or List of Contents

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349

15.3. Configuration of Entries to a Table or List of Contents

. . . . . . . . . . . . . . . . . 356

15.4. Internal Commands for Class and Package Authors

. . . . . . . . . . . . . . . . . . . . 367

15.5. A Complete Example

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370

15.6. Everything with One Command Only

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373



Contents

12

16. Hacks for Third-Party Packages by Package scrhack

378


16.1. State of Development Note

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378

16.2. Early or late Selection of Options

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378

16.3. Usage of tocbasic

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379

16.4. Incorrect Expectations to \@ptsize

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380

16.5. Special Case hyperref

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381

16.6. Inconsistent Handling of \textwidth and \textheight

. . . . . . . . . . . . . . . . . 381



17. Defining Layers and Page Styles Using scrlayer

382


17.1. State of Development Note

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382

17.2. Early or late Selection of Options

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382

17.3. Some Generic Information

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383

17.4. Declaration of Layers

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385

17.5. Declaration and Management of Page Styles

. . . . . . . . . . . . . . . . . . . . . . . . . . 396

17.6. Head and Foot Height

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404

17.7. Manipulation of Defined Page Styles

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405

17.8. End User Interfaces

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411



18. Additional Features of scrlayer-scrpage

413


18.1. Manipulation of Defined Page Styles

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413

18.2. Definition of new Pairs of Page Styles

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416

18.3. Definition of Simple Page Styles with Three Parts in Head and Foot

. . . . . . . 418

18.4. Definition of Complex Page Styles

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421



19. Note Columns with scrlayer-notecolumn

424


19.1. Note about the State of Development

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424

19.2. Early or late Selection of Options

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425

19.3. Text Markup

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426

19.4. Declaration of new Note Columns

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427

19.5. Making a Note

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431

19.6. Force Output of Note Columns

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435



20. Additional Information about package typearea

437


20.1. Experimental Features

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437

20.2. Expert Commands

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438

20.3. Local Settings with File typearea.cfg

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440

20.4. More or Less Obsolete Options and Commands

. . . . . . . . . . . . . . . . . . . . . . . 440



21. Additional Information about the Main Classes and scrextend

441


21.1. Additional Information to User Commands

. . . . . . . . . . . . . . . . . . . . . . . . . . 441

21.2. Cooperation and Coexistence of KOMA-Script and Other Packages

. . . . . . . 441



Contents

13

21.3. Expert Commands

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441

21.4. More or Less Obsolete Options and Commands

. . . . . . . . . . . . . . . . . . . . . . . 463

22. Additional Information about the Letter Class scrlttr2 and the Letter Package

scrletter

464


22.1. Pseudo-Lengths for Experienced Users

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464

22.1.1. Folding Marks

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470

22.1.2. Letterhead

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472

22.1.3. Addressee

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473

22.1.4. Sender’s Extensions

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475

22.1.5. Business Line

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476

22.1.6. Subject

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477

22.1.7. Closing

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478

22.1.8. Letter Footer

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478

22.2. Variables for Experienced Users

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479

22.3. Differences in the Page Styles of scrletter

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 481

22.4. Differences in the Handling of lco-Files in scrletter

. . . . . . . . . . . . . . . . . . . . 482

22.5. lco-Files for Experienced Users

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482

22.5.1. Survey of Paper Size

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483

22.5.2. Visualization of Positions

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483

22.6. Language Support

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486

22.7. From Obsolete scrlettr to Current scrlttr2

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 489



A. Japanese Letter Support for scrlttr2

491


A.1. Japanese standard paper and envelope sizes

. . . . . . . . . . . . . . . . . . . . . . . . . . 491

A.1.1. Japanese paper sizes

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491

A.1.2. Japanese envelope sizes

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492

A.2. Provided lco files

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496

A.3. Examples of Japanese letter usage

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498

A.3.1. Example 1:

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498

A.3.2. Example 2:

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499



Change Log

500


Bibliography

509


Index

514


General Index

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514

Index of Commands, Environments, and Variables

. . . . . . . . . . . . . . . . . . . . . . . . . . 518

Index of Lengths and Counters

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529

Index of Elements with Capability of Font Adjustment

. . . . . . . . . . . . . . . . . . . . . . . 530



Contents

14

Index of Files, Classes, and Packages

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532

Index of Class and Package Options

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533


List of Figures

15

List of Figures

2.1. Double-sided layout with the box construction of the classical division factor

of 9, after subtraction of a binding correction

. . . . . . . . . . . . . . . . . . . . . . . . . . . 28

3.1. Parameters that control the footnote layout

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

3.3. Example: Usage of \captionaboveof inside another floating environment

. . . . 126

3.2. Example: A rectangle

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

3.4. Example: Figure beside description

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

3.5. Example: Description centered beside figure

. . . . . . . . . . . . . . . . . . . . . . . . . . . 128

3.6. Example: Figure title top beside

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

3.7. Example: Default figure caption

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

3.8. Example: Figure caption with slightly hanging indention

. . . . . . . . . . . . . . . . . 132

3.9. Example: Figure caption with hanging indention and line break

. . . . . . . . . . . . 132

3.10. Example: Figure caption with hanging indention at the second line

. . . . . . . . . 132

4.1. General structure of a letter document with several individual letters

. . . . . . . . 152

4.2. General structure of a single letter within a letter document

. . . . . . . . . . . . . . . 152

4.3. Example: letter with addressee and opening

. . . . . . . . . . . . . . . . . . . . . . . . . . . 156

4.4. Example: letter with addressee, opening, text, and closing

. . . . . . . . . . . . . . . . 157

4.5. Example: letter with addressee, opening, text, closing, and postscript

. . . . . . . 158

4.6. Example: letter with addressee, opening, text, closing, postscript, and

distribution list

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160

4.7. Example: letter with addressee, opening, text, closing, postscript,

distribution list, and enclosure

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

4.8. Example: letter with addressee, opening, text, closing, postscript,

distribution list, enclosure, and insane large font size

. . . . . . . . . . . . . . . . . . . . . 164

4.9. schematic display of the note paper with the most important commands and

variables for the drafted elements

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

4.10. Example: letter with addressee, opening, text, closing, postscript,

distribution list, enclosure, and hole puncher mark

. . . . . . . . . . . . . . . . . . . . . . 171

4.11. Example: letter with sender, addressee, opening, text, closing, postscript,

distribution list, and enclosure

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174

4.12. Example: letter with sender, separation rule, addressee, opening, text,

closing, signature, postscript, distribution list, enclosure, and puncher hole

mark

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176



4.13. Example: letter with extended sender, separation rule, addressee, opening,

text, closing, signature, postscript, distribution list, enclosure, and puncher

hole mark; standard vs. extended letterhead

. . . . . . . . . . . . . . . . . . . . . . . . . . . 179



List of Figures

16

4.14. Example: letter with extended sender, separation rule, addressee, opening,

text, closing, signature, postscript, distribution list, enclosure, and puncher

hole mark; left vs. right aligned letterhead

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181

4.15. Example: letter with extended sender, logo, separation rule, addressee,

opening, text, closing, signature, postscript, distribution list, enclosure, and

puncher hole mark; left vs. right aligned vs. centered sender

. . . . . . . . . . . . . . . 183

4.16. Example: letter with extended sender, logo, addressee, additional sender

information, opening, text, closing, signature, postscript, distribution list,

enclosure, and puncher hole mark

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188

4.17. Example: letter with extended sender, logo, addressee, additional sender

information, place, date, opening, text, closing, signature, postscript,

distribution list, enclosure, and puncher hole mark

. . . . . . . . . . . . . . . . . . . . . . 192

4.18. Example: letter with extended sender, logo, addressee, additional sender

information, place, date, subject, opening, text, closing, signature, postscript,

distribution list, enclosure, and puncher hole mark

. . . . . . . . . . . . . . . . . . . . . . 195

4.19. Example: letter with extended sender, logo, addressee, additional sender

information, place, date, subject, opening, text, closing, modified signature,

postscript, distribution list, enclosure, and puncher hole mark

. . . . . . . . . . . . . 214

4.20. Example: letter with extended sender, logo, addressee, additional sender

information, place, date, subject, opening, text, closing, modified signature,

postscript, distribution list, enclosure, and puncher hole mark using a lco-file

. 217

5.1. Commands to define the page head



. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232

5.2. Commands to define the page footer

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235

11.1. Example: Three pages from the front of the example club statutes of

section 11.8

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305

15.1. Illustrations of some attributes of a TOC-entry with style dottedtocline

. . . . 358

15.2. Illustrations of some attributes of a TOC-entry with style largetocline

. . . . . 359

15.3. Illustrations of some attributes of a TOC-entry with style tocline

. . . . . . . . . 359

15.4. Illustration of some attributes of style undottedtocline by the example of a

chapter title

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360

18.1. Elements of a three parts page style

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420

19.1. An example page to the example of chapter 19

. . . . . . . . . . . . . . . . . . . . . . . . . 436

22.1. Schematic of the pseudo-lengths for a letter

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 469


List of Tables

17

List of Tables

2.1. Type area dimensions dependent on DIV for A4

. . . . . . . . . . . . . . . . . . . . . . . . 33

2.2. Predefined settings of DIV for A4

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

2.3. Symbolic values for the DIV option and the DIV argument to \typearea

. . . . . 36

2.4. Symoblic BCOR arguments for \typearea

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

2.5. Standard values for simple switches in KOMA-Script

. . . . . . . . . . . . . . . . . . . . 39

2.6. Output driver for option pagesize=output driver

. . . . . . . . . . . . . . . . . . . . . 48

3.1. Class correspondence

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

3.2. Elements whose type style can be changed with the KOMA-Script command

\setkomafont

or \addtokomafont

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

3.3. Font defaults for the elements of the title

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

3.4. Main title

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

3.5. Possible values of option toc

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

3.6. Font style defaults of the elements of the table of contents

. . . . . . . . . . . . . . . . 73

3.7. Possible values of option parskip

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

3.8. Default values for the elements of a page style

. . . . . . . . . . . . . . . . . . . . . . . . . . 78

3.9. Macros to set up page style of special pages

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

3.10. Available numbering styles of page numbers

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

3.11. Available values for option footnotes

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

3.12. Available values for option open

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

3.13. Available values for option headings

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

3.14. Available values of option numbers

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

3.15. Default font sizes for different levels of document structuring

. . . . . . . . . . . . . . 98

3.16. Default settings for the elements of a dictum

. . . . . . . . . . . . . . . . . . . . . . . . . . . 109

3.17. Available values for option captions

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

3.18. Font defaults for the elements of figure or table captions

. . . . . . . . . . . . . . . . . . 124

3.19. Example: Measure of the rectangle in figure 3.2

. . . . . . . . . . . . . . . . . . . . . . . . . 126

3.20. Available values for option listof

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

3.21. Available values of option bibliography

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

3.22. Available values of option index

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

4.1. Alphabetical list of all supported variables in scrlttr2

. . . . . . . . . . . . . . . . . . . . . 142

4.2. Alphabetical list of elements whose font can be changed in scrlttr2 using the

commands \setkomafont and \addtokomafont

. . . . . . . . . . . . . . . . . . . . . . . . . 165

4.3. Combinable values for the configuration of folding marks with option

foldmarks

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168

4.4. Available values for option fromalign with scrlttr2

. . . . . . . . . . . . . . . . . . . . . . 172

4.5. Possible values of option fromrule with scrlttr2

. . . . . . . . . . . . . . . . . . . . . . . . . 173


List of Tables

18

4.6. Predefined descriptions of the variables of the letterhead

. . . . . . . . . . . . . . . . . . 177

4.7. Predefined description and content of the separators at the letterhead

without option symbolicnames

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178

4.8. available values for option addrfield using scrlttr2

. . . . . . . . . . . . . . . . . . . . . . 184

4.9. Predefined font style for the elements of the address field.

. . . . . . . . . . . . . . . . . 185

4.10. available values for option priority in scrlttr2

. . . . . . . . . . . . . . . . . . . . . . . . . 186

4.11. Possible values of option locfield with scrlttr2

. . . . . . . . . . . . . . . . . . . . . . . . . 187

4.12. Possible value of option refline with scrlttr2

. . . . . . . . . . . . . . . . . . . . . . . . . . 190

4.13. predefined descriptions of variables of the reference line

. . . . . . . . . . . . . . . . . . . 190

4.14. font style default of elements of the reference line

. . . . . . . . . . . . . . . . . . . . . . . 191

4.15. predefined descriptions of subject-related variables

. . . . . . . . . . . . . . . . . . . . . . 193

4.16. available values of option subject with scrlttr2

. . . . . . . . . . . . . . . . . . . . . . . . . 194

4.17. available values of option pagenumber with scrlttr2

. . . . . . . . . . . . . . . . . . . . . . 201

4.18. predefined lco-files

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218

5.1. Elements of scrlayer-scrpage whose type style can be changed with

KOMA-Script command \setkomafont or \addtokomafont

. . . . . . . . . . . . . . . 228

5.2. Possible values for option markcase

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245

5.3. Symbolic values for options headwidth and footwidth

. . . . . . . . . . . . . . . . . . . 250

10.1. optional available extended features of scrextend

. . . . . . . . . . . . . . . . . . . . . . . . 267

11.1. Possible properties for the optional argument of \Clause and \SubClause

. . . . 290

11.2. Possible values for option clausemark for activation of running heads

. . . . . . . 292

11.3. Possible values for option ref to configure the cross reference format

. . . . . . . . 296

11.4. Example outputs of the ref-independent cross reference commands

. . . . . . . . . 297

11.5. Meanings and English defaults of language dependent terms

. . . . . . . . . . . . . . . 299

12.1. Overview of usual language dependent terms

. . . . . . . . . . . . . . . . . . . . . . . . . . . 327

15.1. Attributes of the predefined TOC-entry styles of tocbasic

. . . . . . . . . . . . . . . . . 360

15.2. Options for command \DeclareNewTOC

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373

15.3. Comparison of example environment remarkbox and environment figure

. . . . 377

17.1. Options for the definition of page layers with description of the corresponding

layer attribute

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387

17.2. The hook options for page styles (in order of execution)

. . . . . . . . . . . . . . . . . . 398

18.1. The layers scrlayer-scrpage defines to a page style

. . . . . . . . . . . . . . . . . . . . . . . . 422

19.1. Options for the declaration of note columns

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 429



List of Tables

19

21.1. Style-independent attributes at the declaration of section-like commands

. . . . . 447

21.2. Attributes of the style section declaring a section-like command

. . . . . . . . . . . 448

21.3. Attributes of the style chapter declaring a section-like command

. . . . . . . . . . . 449

21.4. Attributes of the style part declaring a section-like command

. . . . . . . . . . . . . . 450

21.6. Default of the headings of scrbook and scrreprt

. . . . . . . . . . . . . . . . . . . . . . . . . . 451

21.5. Defaults of the chapter headings of scrbook and scrreprt subject to option

headings

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455

22.1. Pseudo-lengths provided by class scrlttr2

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465

22.2. Language-dependent forms of the date

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488

22.3. Default settings for language-dependent terms

. . . . . . . . . . . . . . . . . . . . . . . . . 490

A.1. ISO and JIS standard paper sizes

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492

A.2. Japanese B-series variants

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492

A.3. Main Japanese contemporary stationary

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493

A.4. Japanese ISO envelope sizes

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494

A.5. Japanese envelope sizes 3

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495

A.6. Supported Japanese envelope types and the window sizes and locations

. . . . . . 497

A.7. lco files provided by scrlttr2 for Japanese window envelopes

. . . . . . . . . . . . . . . 498



Chapter 1: Introduction

20

Introduction

This chapter includes important information about the structure of the manual and the history

of KOMA-Script, which begins years before the first version. You will also find information

for those who have not installed KOMA-Script or encounter errors.



1.1. Preface

KOMA-Script is very complex. This is evidenced by the fact that it consists of not only a single

class or a single package, but a bundle of many classes and packages. Although the classes are

designed as a counterpart to the standard classes, that does not necessarily mean that they

only have the commands, environments, and setting of the standard classes or imitate their

appearance. The capabilities of KOMA-Script surpass the capabilities of the standard classes

considerably. Some of them are to be regarded as a supplement to the basic skills of the L

A

TEX



kernel.

The foregoing means that the documentation of KOMA-Script has to be extensive. In

addition, KOMA-Script usually is not taught. That means there is no teacher who knows

his students and can therefore choose the teaching and learning materials and adapt them

accordingly. It would be easy to write the documentation for any specific audience. The

difficulty is, however, that the guide must service all potential audiences. We, the authors,

have tried to create a guide that is suited for the computer scientist as well as the secretary

or the fishmonger. We have tried, although this is actually an impossible task. The result

consists of several compromises and we hope that you will keep this in mind when using it.

Your suggestions for improvement are, of course, always welcome.

Despite the volume of the manual, it is recommended to consult the documentation. Atten-

tion is drawn to the multi-part index at the end of this document. In addition to this guide,

documentation includes all the text documents that are part of the bundle. See manifest.tex

for a list of all of them.



1.2. Structure of the Guide

This manual consists of several parts. There’s a part for average users, another part for

advanced users and experts, and an appendix with additional examples and information for

those who always want to know more.

Part I

is recommended for all KOMA-Script users. This means that you may find here



even some information for newcomers to L

A

TEX. In particular, this part is enhanced by many



examples to the average user that are intended to illustrate the explanations. Do not be afraid

to try these examples yourself and in modifying them to find out how KOMA-Script works.

Nevertheless the KOMA-Script user guide is not intended to be a L

A

TEX primer. Those new



Chapter 1: Introduction

21

to L


A

TEX should look at The Not So Short Introduction to L



A

TEX 2ε [

OPHS11


] or L

A

TEX 2ε

for Authors

[

Tea05b



] or a L

A

TEX reference book. You will also find useful information in



the many L

A

TEX FAQs, including the TEX Frequently Asked Questions on the Web [



FAQ13

].

Although the length of the TEX Frequently Asked Questions on the Web is considerably long,



it is nevertheless quite useful not only to those having problems using L

A

TEX or KOMA-Script.



Part II

is recommended for advanced KOMA-Script users. These are all of you who already

know L

A

TEX, maybe worked with KOMA-Script for a while, and want to learn more about



KOMA-Script internals, interaction of KOMA-Script with other packages, and how to use

KOMA-Script as an answer to special demands. For this purpose we will have a closer look

at some aspects from

part I


again. In addition some instructions that have been implemented

for advanced users and experts, especially, will be documented. This is complemented by the

documentation of packages that are normally hidden to the user insofar as they do their work

under the surface of the classes and user packages. These packages are specifically designed

to be used by other authors of classes and packages.

The appendix, which may be found only in the German book version, contains information

which is beyond what is covered in

part I


and

part II


. Advanced users may find background in-

formation on issues of typography to give them a basis for their own decisions. In addition, the

appendix provides examples for aspiring authors of packages. These examples are less intended

to be simply transferred. Rather, they convey knowledge of planning and implementation of

projects as well as some basic L

A

TEX instructions for authors of packages.



If you are only interested in using a single KOMA-Script class or package you can probably

successfully avoid reading the entire guide. Each class and package typically has its own

chapter; however, the three main classes (scrbook, scrrprt, and scrartcl) are introduced together

in

chapter 3



. Where an example or note only applies to one or two of the three classes, e. g.,

scrartcl, it is called out in the margin, as shown here with scrartcl.

scrartcl

The primary documentation for KOMA-Script is in German and has been translated for your

convenience; like most of the L

A

TEX world, its commands, environments, options, etc., are in



English. In a few cases, the name of a command may sound a little strange, but even so, we hope

and believe that with the help of this guide, KOMA-Script will be usable and useful to you.



1.3. History of KOMA-Script

In the early 1990s, Frank Neukam needed a method to publish an instructor’s lecture notes. At

that time L

A

TEX was L



A

TEX2.09 and there was no distinction between classes and packages —

there were only styles. Frank felt that the standard document styles were not good enough

for his work; he wanted additional commands and environments. At the same time he was

interested in typography and, after reading Tschichold’s Ausgewählte Aufsätze über Fragen der

Gestalt des Buches und der Typographie

(Selected Articles on the Problems of Book Design and

Typography) [

Tsc87


], he decided to write his own document style — and not just a one-time

solution to his lecture notes, but an entire style family, one specifically designed for European



Chapter 1: Introduction

22

and German typography. Thus Script was born.

Markus Kohm, the developer of KOMA-Script, came across Script in December 1992 and

added an option to use the A5 paper format. At that time neither the standard style nor

Script provided support for A5 paper. Therefore it did not take long until Markus made the

first changes to Script. This and other changes were then incorporated into Script-2, released

by Frank in December 1993.

Beginning in mid-1994, L

A

TEX2ε became available and brought with it many changes. Users



of Script-2 were faced with either limiting their usage to L

A

TEX2ε’s compatibility mode or



giving up Script altogether. This situation led Markus to put together a new L

A

TEX2ε package,



released on 7 July 1994 as KOMA-Script; a few months later Frank declared KOMA-Script to

be the official successor to Script. KOMA-Script originally provided no letter class, but this

deficiency was soon remedied by Axel Kielhorn, and the result became part of KOMA-Script

in December 1994. Axel also wrote the first true German-language user guide, which was

followed by an English-language guide by Werner Lemberg.

Since then much time has passed. L

A

TEX has changed in only minor ways, but the L



A

TEX


landscape has changed a great deal; many new packages and classes are now available and

KOMA-Script itself has grown far beyond what it was in 1994. The initial goal was to pro-

vide good L

A

TEX classes for German-language authors, but today its primary purpose is to



provide more-flexible alternatives to the standard classes. KOMA-Script’s success has led

to e-mail from users all over the world, and this has led to many new macros — all needing

documentation; hence this “small guide.”

1.4. Special Thanks

Acknowledgements in the introduction? No, the proper acknowledgements can be found in

the addendum. My comments here are not intended for the authors of this guide — and

those thanks should rightly come from you, the reader, anyhow. I, the author of KOMA-

Script, would like to extend my personal thanks to Frank Neukam. Without his Script family,

KOMA-Script would not have come about. I am indebted to the many persons who have

contributed to KOMA-Script, but with their indulgence, I would like to specifically mention

Jens-Uwe Morawski and Torsten Krüger. The English translation of the guide is, among many

other things, due to Jens’s untiring commitment. Torsten was the best beta-tester I ever had.

His work has particularly enhanced the usability of scrlttr2 and scrpage2. Many thanks to all

who encouraged me to go on, to make things better and less error-prone, or to implement

additional features.

Thanks go as well to DANTE, Deutschsprachige Anwendervereinigung TEX e.V, (the

German-Language TEX User Group). Without the DANTE server, KOMA-Script could not

have been released and distributed. Thanks as well to everybody in the TEX newsgroups and

mailing lists who answer questions and have helped me to provide support for KOMA-Script.



Chapter 1: Introduction

23

1.5. Legal Notes

KOMA-Script was released under the L

A

TEX Project Public License. You will find it in the file



lppl.txt

. An unofficial German-language translation is also available in lppl-de.txt and is

valid for all German-speaking countries.

This document and the KOMA-Script bundle are provided “as is” and without warranty of

any kind.

1.6. Installation

The three most important TEX distributions, MacTEX, MiKTEX, and TEX Live, make KOMA-

Script available by their package management software. It is recommended to make installa-

tions and updates of KOMA-Script using these tools. Nevertheless the manual installation

without using the package managers has been described in the file INSTALL.txt, that is part

of every legal KOMA-Script bundle. You should also read the documentation that comes with

the TEX distribution you are using.

1.7. Bug Reports and Other Requests

If you think you have found an error in the documentation or a bug in one of the KOMA-Script

classes, one of the KOMA-Script packages, or another part of KOMA-Script, please do the

following: first have a look on CTAN to see if a newer version of KOMA-Script is available; if

a newer version is available, install the applicable section and try again.

If you are using the most recent version of KOMA-Script and still have a bug, please provide

a short L

A

TEX document that demonstrates the problem. You should only use the packages



and definitions needed to demonstrate the problem; do not use any unusual packages.

By preparing such an example it often becomes clear whether the problem is truly a KOMA-

Script bug or something else. To find out the version numbers of all packages in use, simply

put \listfiles in the preamble of your example and read the end of the log-file.

Please report KOMA-Script (only) bugs to

komascript@gmx.info

. If you want to ask your

question in a Usenet group, mailing list, or Internet forum, you should also include such an

example as part of your question.

1.8. Additional Information

Once you become an experienced KOMA-Script user you may want to look at some more

advanced examples and information. These you will find on the KOMA-Script documentation

web site [

KDP

]. The main language of the site is German, but nevertheless English is welcome.




Yüklə 2,79 Mb.

Dostları ilə paylaş:
  1   2   3   4   5   6   7   8   9   ...   60




Verilənlər bazası müəlliflik hüququ ilə müdafiə olunur ©azkurs.org 2024
rəhbərliyinə müraciət

gir | qeydiyyatdan keç
    Ana səhifə


yükləyin