Note: This document is a translation of the German koma script manual
Yüklə 2,49 Mb. Pdf görüntüsü
|
- Bu səhifədəki naviqasiya:
- The Guide KOMA-Script
- Preface to the English KOMA-Script Guide
- Contents Preface to the English KOMA-Script Guide 7 1. Introduction
- Part I: KOMA-Script for Authors
- 3. The Main Classes: scrbook, scrreprt, and scrartcl
- 4. The New Letter Class scrlttr2
- 5. Adapting Page Headers and Footers with scrlayer-scrpage
- 6. The Day of the Week Using scrdate
- 9. Creating Address Files from a Address Database
- 11. Support for the Law Office by scrjura
- Part II: KOMA-Script for Advanced Users and Experts
- 13. Control Package Dependencies with scrlfile
- 14. Economise and Replace Files Using scrwfile
- 15. Management of Tables and Lists of Contents Using tocbasic
- 16. Hacks for Third-Party Packages by Package scrhack
- 17. Defining Layers and Page Styles Using scrlayer
- 18. Additional Features of scrlayer-scrpage
- 19. Note Columns with scrlayer-notecolumn
- 20. Additional Information about package typearea
- 21. Additional Information about the Main Classes and scrextend
- 22. Additional Information about the Letter Class scrlttr2 and the Letter Package scrletter
- A. Japanese Letter Support for scrlttr2
- Change Log
- 1.2. Structure of the Guide
- 1.3. History of KOMA-Script
- 1.7. Bug Reports and Other Requests
- 1.8. Additional Information
|
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 2016-06-14 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! 7 Chapter 0. 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!
8 Contents
Contents Preface to the English KOMA-Script Guide 7
19 1.1.
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 1.2. Structure of the Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 1.3.
History of KOMA-Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 1.4. Special Thanks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 1.5.
Legal Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 1.6. Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 1.7.
Bug Reports and Other Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 1.8. Additional Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Part I: KOMA-Script for Authors 23
24 2.1.
Fundamentals of Page Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 2.2. Page Layout Construction by Dividing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 2.3.
Page Layout Construction by Drawing a Circle . . . . . . . . . . . . . . . . . . . . . . . 28 2.4. Early or late Selection of Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 2.5.
Compatibility with Earlier Versions of KOMA-Script . . . . . . . . . . . . . . . . . . . 29 2.6. Options and Macros to Influence the Page Layout . . . . . . . . . . . . . . . . . . . . . 30 2.7.
Paper Format Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 2.8. Tips
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 3. The Main Classes: scrbook, scrreprt, and scrartcl 49 3.1. Early or late Selection of Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 3.2. Compatibility with Earlier Versions of KOMA-Script . . . . . . . . . . . . . . . . . . . 49 3.3.
Draft Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 3.4. Page Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 3.5.
Selection of the Document Font Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 3.6. Text Markup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 3.7.
Document Titles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 3.8. Abstract
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 3.9.
Table of Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 3.10. Paragraph Markup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 9 Contents
3.11. Detection of Odd and Even Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 3.12. Head and Foot Using Predefined Page Styles . . . . . . . . . . . . . . . . . . . . . . . . . 72 3.13. Interleaf Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 3.14. Footnotes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 3.15. Demarcation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 3.16. Structuring of Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 3.17. Dicta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 3.18. Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 3.19. Math . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 3.20. Floating Environments of Tables and Figures . . . . . . . . . . . . . . . . . . . . . . . . . 114 3.21. Margin Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 3.22. Appendix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 3.23. Bibliography . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 3.24. Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 4. The New Letter Class scrlttr2 136
4.1. Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 4.2.
Pseudo-Lengths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 4.3. Early or late Selection of Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 4.4.
Compatibility with Earlier Versions of KOMA-Script . . . . . . . . . . . . . . . . . . . 142 4.5. Draft Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 4.6.
Page Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 4.7. General Structure of Letter Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 4.8.
Selection of Document or Letter Font Size . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 4.9. Text Markup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 4.10. Note Paper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157 4.11. Paragraph Markup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 4.12. Detection of Odd and Even Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 4.13. Head and Foot Using Predefined Page Style . . . . . . . . . . . . . . . . . . . . . . . . . . 187 4.14. Interleaf Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191 4.15. Footnotes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191 4.16. Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191 4.17. Math . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191 4.18. Floating Environments of Tables and Figures . . . . . . . . . . . . . . . . . . . . . . . . . 191 4.19. Margin Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 4.20. Closing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 4.21. Letter Class Option Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194 4.22. Address Files and Circular Letters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
10 Contents
5. Adapting Page Headers and Footers with scrlayer-scrpage 205
5.1. Early or late Selection of Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205 5.2.
Head and Foot Height . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206 5.3. Text Markup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206 5.4.
Usage of Predefined Page Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208 5.5. Manipulation of Defined Page Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218 6. The Day of the Week Using scrdate 229
7. Getting the Time with Package scrtime 234
8. Access to Address Files with scraddr 236
8.1. Overview
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236 8.2.
Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237 8.3. Package Warning Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238 9. Creating Address Files from a Address Database 239
10. Making Basic Feature of the KOMA-Script Classes Available with Package scrextend while Using Other Classes 240
10.1. Early or late Selection of Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240 10.2. Compatibility with Earlier Versions of KOMA-Script . . . . . . . . . . . . . . . . . . . 240 10.3. Optional, Extended Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241 10.4. Draft Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241 10.5. Selection of the Document Font Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241 10.6. Text Markup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241 10.7. Document Titles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241 10.8. Detection of Odd and Even Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242 10.9. Head and Foot Using Predefined Page Styles . . . . . . . . . . . . . . . . . . . . . . . . . 242 10.10. Interleaf Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242 10.11. Footnotes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242 10.12. Dicta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243 10.13. Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243 10.14. Margin Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243 11. Support for the Law Office by scrjura 244
11.1. Early or late Selection of Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244 11.2. Table of Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244 11.3. Environment for Contracts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245 11.3.1. Clauses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245 11.3.2. Paragraphs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248 11 Contents
11.3.3. Sentences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250 11.4. Cross References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250 11.5. Additional Environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253 11.6. Support for Different Languages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254 11.7. A Detailed Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255 11.8. State of Development . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260 Part II: KOMA-Script for Advanced Users and Experts 262
12. Basic Functions of Package scrbase 263
12.1. Loading the Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263 12.2. Keys as Attributes of Families and their Members . . . . . . . . . . . . . . . . . . . . . 264 12.3. Conditional Execution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276 12.4. Definition of Language-Dependent Terms . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279 12.5. Identification of KOMA-Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283 12.6. Extension of the L A TEX Kernel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283 12.7. Extension of the Mathematical Features of ε-TEX . . . . . . . . . . . . . . . . . . . . . 284
285
13.1. About Package Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285 13.2. Actions Prior to and After Loading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286 13.3. Replacing Files at Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290 13.4. Prevent File Loading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293 14. Economise and Replace Files Using scrwfile 296
14.1. General Modifications of the L A TEX Kernel . . . . . . . . . . . . . . . . . . . . . . . . . . . 296 14.2. The Single File Feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297 14.3. The Clone File Write Feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297 14.4. Note on State of Development . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298 14.5. Known Package Incompatibilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
300
15.1. Basic Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300 15.2. Creating a Table or List of Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303 15.3. Configuration of Entries to a Table or List of Contents . . . . . . . . . . . . . . . . . 310 15.4. Internal Commands for Class and Package Authors . . . . . . . . . . . . . . . . . . . . 321 15.5. A Complete Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323 15.6. Everything with One Command Only . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326 12 Contents
16. Hacks for Third-Party Packages by Package scrhack 332
16.1. State of Development Note . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332 16.2. Early or late Selection of Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332 16.3. Usage of tocbasic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332 16.4. Incorrect Expectations to \@ptsize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333 16.5. Special Case hyperref . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333 16.6. Inconsistent Handling of \textwidth and \textheight . . . . . . . . . . . . . . . . . 334 17. Defining Layers and Page Styles Using scrlayer 335
17.1. State of Development Note . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335 17.2. Early or late Selection of Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335 17.3. Some Generic Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335 17.4. Declaration of Layers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337 17.5. Declaration and Management of Page Styles . . . . . . . . . . . . . . . . . . . . . . . . . . 348 17.6. Head and Foot Height . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356 17.7. Manipulation of Defined Page Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356 17.8. End User Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358 18. Additional Features of scrlayer-scrpage 361
18.1. Manipulation of Defined Page Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361 18.2. Definition of new Pairs of Page Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364 18.3. Definition of Simple Page Styles with Three Parts in Head and Foot . . . . . . . 366 18.4. Definition of Complex Page Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368 19. Note Columns with scrlayer-notecolumn 372
19.1. Note about the State of Development . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372 19.2. Early or late Selection of Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373 19.3. Declaration of new Note Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373 19.4. Making a Note . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377 19.5. Force Output of Note Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380 20. Additional Information about package typearea 383
20.1. Expert Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383 20.2. Local Settings with File typearea.cfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385 20.3. More or Less Obsolete Options and Commands . . . . . . . . . . . . . . . . . . . . . . . 385 21. Additional Information about the Main Classes and scrextend 386
21.1. Additional Information to User Commands . . . . . . . . . . . . . . . . . . . . . . . . . . 386 21.2. Cooperation and Coexistence of KOMA-Script and Other Packages . . . . . . . 386 21.3. Expert Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386 21.4. More or Less Obsolete Options and Commands . . . . . . . . . . . . . . . . . . . . . . . 408 13 Contents
22. Additional Information about the Letter Class scrlttr2 and the Letter Package scrletter 409
22.1. Pseudo-Lengths for Experienced Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409 22.1.1. Folding Marks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415 22.1.2. Letterhead . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417 22.1.3. Addressee . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418 22.1.4. Sender’s Extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420 22.1.5. Business Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420 22.1.6. Subject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421 22.1.7. Closing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422 22.1.8. Letter Footer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422 22.2. Variables for Experienced Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423 22.3. Differences in the Page Styles of scrletter . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425 22.4. Differences in the Handling of lco-Files in scrletter . . . . . . . . . . . . . . . . . . . . 426 22.5. lco-Files for Experienced Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426 22.5.1. Survey of Paper Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426 22.5.2. Visualization of Positions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427 22.6. Language Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430 22.7. From Obsolete scrlettr to Current scrlttr2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433 A. Japanese Letter Support for scrlttr2 435
A.1. Japanese standard paper and envelope sizes . . . . . . . . . . . . . . . . . . . . . . . . . . 435 A.1.1. Japanese paper sizes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435 A.1.2. Japanese envelope sizes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436 A.2. Provided lco files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440 A.3. Examples of Japanese letter usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442 A.3.1. Example 1: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442 A.3.2. Example 2: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443 Change Log 444
Bibliography 453
Index 458
General Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458 Index of Commands, Environments, and Variables . . . . . . . . . . . . . . . . . . . . . . . . . . 462 Index of Lengths and Counters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473 Index of Elements with Capability of Font Adjustment . . . . . . . . . . . . . . . . . . . . . . . 474 Index of Files, Classes, and Packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475 Index of Class and Package Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476 14 List of Figures 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 3.1. Parameters that control the footnote layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 3.3. Example: Usage of \captionaboveof inside another floating environment . . . . 120 3.2. Example: A rectangle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 3.4. Example: Figure beside description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 3.5. Example: Description centered beside figure . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 3.6. Example: Figure title top beside . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 3.7. Example: Default figure caption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 3.8. Example: Figure caption with slightly hanging indention . . . . . . . . . . . . . . . . . 126 3.9. Example: Figure caption with hanging indention and line break . . . . . . . . . . . . 126 3.10. Example: Figure caption with hanging indention at the second line . . . . . . . . . 126 4.1. General structure of a letter document with several individual letters . . . . . . . . 143 4.2. General structure of a single letter within a letter document . . . . . . . . . . . . . . . 144 4.3. Example: letter with addressee and opening . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 4.4. Example: letter with addressee, opening, text, and closing . . . . . . . . . . . . . . . . 148 4.5. Example: letter with addressee, opening, text, closing, and postscript . . . . . . . 149 4.6. Example: letter with addressee, opening, text, closing, postscript, and distribution list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151 4.7. Example: letter with addressee, opening, text, closing, postscript, distribution list, and enclosure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 4.8. Example: letter with addressee, opening, text, closing, postscript, distribution list, enclosure, and insane large font size . . . . . . . . . . . . . . . . . . . . . 155 4.9. schematic display of the note paper with the most important commands and variables for the drafted elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158 4.10. Example: letter with addressee, opening, text, closing, postscript, distribution list, enclosure, and hole puncher mark . . . . . . . . . . . . . . . . . . . . . . 160 4.11. Example: letter with sender, addressee, opening, text, closing, postscript, distribution list, and enclosure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 4.12. Example: letter with sender, separation rule, addressee, opening, text, closing, signature, postscript, distribution list, enclosure, and puncher hole mark . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 15 List of Figures 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170 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 . . . . . . . . . . . . . . . 172 4.16. Example: letter with extended sender, logo, addressee, additional sender information, opening, text, closing, signature, postscript, distribution list, enclosure, and puncher hole mark . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178 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 . . . . . . . . . . . . . . . . . . . . . . 182 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 . . . . . . . . . . . . . . . . . . . . . . 185 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 . . . . . . . . . . . . . 194 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 . 197
5.1. Commands to define the page head . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210 5.2. Commands to define the page footer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212 11.1. Example: Three pages from the front of the example club statutes of section 11.7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 15.1. Illustrations of some attributes of a TOC-entry with style dottedtocline . . . . 311 15.2. Illustrations of some attributes of a TOC-entry with style largetocline . . . . . 312 15.3. Illustrations of some attributes of a TOC-entry with style tocline . . . . . . . . . 313 15.4. Illustration of some attributes of style undottedtocline by the example of a chapter title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313 18.1. Elements of a three parts page style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367 19.1. An example page to the example of chapter 19 . . . . . . . . . . . . . . . . . . . . . . . . . 382 22.1. Schematic of the pseudo-lengths for a letter . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414 16 List of Tables List of Tables 2.1. Type area dimensions dependent on DIV for A4 . . . . . . . . . . . . . . . . . . . . . . . . 32 2.2. Predefined settings of DIV for A4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 2.3. Symbolic values for the DIV option and the DIV argument to \typearea . . . . . 35 2.4. Symoblic BCOR arguments for \typearea . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 2.5. Standard values for simple switches in KOMA-Script . . . . . . . . . . . . . . . . . . . . 38 2.6. Output driver for option pagesize=output driver . . . . . . . . . . . . . . . . . . . . . 46 3.1. Class correspondence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 3.2. Elements whose type style can be changed with the KOMA-Script command \setkomafont or \addtokomafont . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 3.3. Font defaults for the elements of the title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 3.4. Main title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 3.5. Possible values of option toc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 3.6. Font style defaults of the elements of the table of contents . . . . . . . . . . . . . . . . 68 3.7. Possible values of option parskip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 3.8. Default values for the elements of a page style . . . . . . . . . . . . . . . . . . . . . . . . . . 74 3.9. Macros to set up page style of special pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 3.10. Available numbering styles of page numbers . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 3.11. Available values for option footnotes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 3.12. Available values for option open . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 3.13. Available values for option headings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 3.14. Available values of option numbers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 3.15. Default font sizes for different levels of document structuring . . . . . . . . . . . . . . 92 3.16. Default settings for the elements of a dictum . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 3.17. Available values for option captions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 3.18. Font defaults for the elements of figure or table captions . . . . . . . . . . . . . . . . . . 119 3.19. Example: Measure of the rectangle in figure 3.2 . . . . . . . . . . . . . . . . . . . . . . . . . 120 3.20. Available values for option listof . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 3.21. Available values of option bibliography . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 3.22. Available values of option index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 4.1. Alphabetical list of all supported variables in scrlttr2 . . . . . . . . . . . . . . . . . . . . . 136 4.2. Alphabetical list of elements whose font can be changed in scrlttr2 using the commands \setkomafont and \addtokomafont . . . . . . . . . . . . . . . . . . . . . . . . . 154 4.3. Combinable values for the configuration of folding marks with option foldmarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 4.4. Available values for option fromalign with scrlttr2 . . . . . . . . . . . . . . . . . . . . . . 162 4.5. Possible values of option fromrule with scrlttr2 . . . . . . . . . . . . . . . . . . . . . . . . . 162
17 List of Tables 4.6. Predefined descriptions of the variables of the letterhead . . . . . . . . . . . . . . . . . . 167 4.7. Predefined description and content of the separators at the letterhead without option symbolicnames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 4.8. available values for option addrfield using scrlttr2 . . . . . . . . . . . . . . . . . . . . . . 174 4.9. Predefined font style for the elements of the address field. . . . . . . . . . . . . . . . . . 175 4.10. available values for option priority in scrlttr2 . . . . . . . . . . . . . . . . . . . . . . . . . 175 4.11. Possible values of option locfield with scrlttr2 . . . . . . . . . . . . . . . . . . . . . . . . . 176 4.12. Possible value of option refline with scrlttr2 . . . . . . . . . . . . . . . . . . . . . . . . . . 179 4.13. predefined descriptions of variables of the reference line . . . . . . . . . . . . . . . . . . . 179 4.14. font style default of elements of the reference line . . . . . . . . . . . . . . . . . . . . . . . 180 4.15. predefined descriptions of subject-related variables . . . . . . . . . . . . . . . . . . . . . . 182 4.16. available values of option subject with scrlttr2 . . . . . . . . . . . . . . . . . . . . . . . . . 183 4.17. available values of option pagenumber with scrlttr2 . . . . . . . . . . . . . . . . . . . . . . 189 4.18. predefined lco-files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198 5.1. Elements of scrlayer-scrpage whose type style can be changed with KOMA-Script command \setkomafont or \addtokomafont . . . . . . . . . . . . . . . 207 5.2. Possible values for option markcase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222 5.3. Symbolic values for options headwidth and footwidth . . . . . . . . . . . . . . . . . . . 227 10.1. optional available extended features of scrextend . . . . . . . . . . . . . . . . . . . . . . . . 241 11.1. Possible properties for the optional argument of \Clause and \SubClause . . . . 246 11.2. Possible values for option clausemark for activation of running heads . . . . . . . 248 11.3. Possible values for option ref to configure the cross reference format . . . . . . . . 252 11.4. Example outputs of the ref-independent cross reference commands . . . . . . . . . 253 11.5. Meanings and English defaults of language dependent terms . . . . . . . . . . . . . . . 255 12.1. Overview of usual language dependent terms . . . . . . . . . . . . . . . . . . . . . . . . . . . 281 15.1. Attributes of the predefined TOC-entry styles of tocbasic . . . . . . . . . . . . . . . . . 314 15.2. Options for command \DeclareNewTOC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327 15.3. Comparison of example environment remarkbox and environment figure . . . . 330 17.1. Options for the definition of page layers with description of the corresponding layer attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339 17.2. The hook options for page styles (in order of execution) . . . . . . . . . . . . . . . . . . 350 18.1. The layers scrlayer-scrpage defines to a page style . . . . . . . . . . . . . . . . . . . . . . . . 369 19.1. Options for the declaration of note columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375
18 List of Tables 21.1. Style-independent attributes at the declaration of section-like commands . . . . . 392 21.2. Attributes of the style section declaring a section-like command . . . . . . . . . . . 393 21.3. Attributes of the style chapter declaring a section-like command . . . . . . . . . . . 394 21.4. Attributes of the style part declaring a section-like command . . . . . . . . . . . . . . 395 21.5. Defaults of the chapter headings of scrbook and scrreprt subject to option headings
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396 21.6. Default of the headings of scrbook and scrreprt . . . . . . . . . . . . . . . . . . . . . . . . . . 397 22.1. Pseudo-lengths provided by class scrlttr2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410 22.2. Language-dependent forms of the date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432 22.3. Default settings for language-dependent terms . . . . . . . . . . . . . . . . . . . . . . . . . 433 A.1. ISO and JIS standard paper sizes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436 A.2. Japanese B-series variants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436 A.3. Main Japanese contemporary stationary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437 A.4. Japanese ISO envelope sizes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438 A.5. Japanese envelope sizes 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439 A.6. Supported Japanese envelope types and the window sizes and locations . . . . . . 441 A.7. lco files provided by scrlttr2 for Japanese window envelopes . . . . . . . . . . . . . . . 442
19 Chapter 1. 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 20 Chapter 1. to L A
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 21 Chapter 1. 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. 22 Chapter 1. 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,49 Mb. Dostları ilə paylaş:
|