Note: This document is a translation of the German koma script manual
Yüklə 2,79 Mb. Pdf görüntüsü
|
|
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
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
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
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
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
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
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
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
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
(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.”
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.
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.
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.
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ş:
|