[Tex/LaTex] scrlayer-scrpage package option list

koma-scriptscrlayer-scrpage

I have been using scrpage2 for more than 10 years. Since it is obsolete, I want to switch to the newer scrlayer-scrpage package.

The documentation however does not seem to list the package options, it only contains several examples.

\usepackage[%
%%% Lines
   % headtopline,
   % plainheadtopline,
   % headsepline,
   % plainheadsepline,
   % footsepline,
   % plainfootsepline,
   % footbotline,
   % plainfootbotline,
   % ilines,
   % clines,
   % olines,
% column titles (content, style)
   automark,
   % autooneside,% ignore optional argument in automark at oneside
   komastyle,
   % standardstyle,
   % markuppercase,
   % markusedcase,
   nouppercase,
]{scrpage2}

Only from the log messages

Package scrlayer-scrpage Warning: You've used obsolete option `komastyle'.
(scrlayer-scrpage)                Usage of this option is deprecated.
(scrlayer-scrpage)                You should simply replace `komastyle'
(scrlayer-scrpage)                by `pagestyleset=KOMA-Script'.

I could figure out these changes

komastyle -> pagestyleset=KOMA-Script
nouppercase -> markcase=ignoreuppercase

How can I gather the complete list?
If it is in the manual, which section or page?

EDIT:
I have further problems to set up the options. I could not find an example in the documentation for this:

\setheadsepline{.4pt}[\color{black}] % configures the line below the header

Is according to the log not valid anymore

(scrlayer-scrpage)                You should use KOMA-Script options
(scrlayer-scrpage)                `headsepline', `headtopline', `footsepline',
(scrlayer-scrpage)                or `footbotline' with values
(scrlayer-scrpage)                `<line thickness>:<line length>' to setup
(scrlayer-scrpage)                the line length and thickness, and
(scrlayer-scrpage)                `\setkomafont' or `\addtokomafont' to
(scrlayer-scrpage)                setup the colour on input line 74.

An example for this would help.

Best Answer

In chapter 5 »Headers and Footers with scrlayer-scrpage« all the macros and options are explained.

The headsepline can be configured by option headsepline=<thickness>:<lenghth>. You can omit the values. Default thickness is 0.4pt, default length is the symbolic value head.

\KOMAoptions{headsepline} -> head sepline with thickness 0.4pt and width of the head as length

\KOMAoptions{headsepline=1pt} -> head sepline with thickness 1pt and width of the head as length

\KOMAoptions{headsepline=:10cm} -> head sepline with default thickness and length 10cm

\KOMAoptions{headsepline=1pt:10cm} -> head sepline with thickness 1pt and length 10cm

headsepline can be used as package option. But if the values of the key are macros, lengths or counters it is recommended to use \KOMAoption or \KOMAoptions.

To change the alignment of the headsepline with the head you can use one of the options ilines, clines or olines (this is the same as with scrpage2). Default is ilines, ie aligned to the inner margin of head.

To set the color of headsepline change the font element headsepline using \addtokomafont or setkomafont.

So you can replace the outdated scrpage2 code \setheadsepline{.4pt}[\color{black}] by

\KOMAoptions{headsepline=.4pt:head}% .4pt and head are the defaults
\addtokomafont{headsepline}{\color{black}}

Example:

\documentclass[twoside]{scrartcl}
\usepackage{blindtext}% only for dummy text
\usepackage{xcolor}
\usepackage{scrlayer-scrpage}% sets page style scrheadings automatically
\KOMAoptions{headsepline=4pt:5cm,olines}
\addtokomafont{headsepline}{\color{orange}}
\begin{document}
\blinddocument
\end{document}

Related Solutions

[Tex/LaTex] Problems with scrlayer-scrpage

This translates your page layout into KOMA's terms. It may not make the requested changes because I don't know what they are meant to be. Your example does not include any chapters, let alone chapter titles, and it is impossible to guess which distance you are talking about or what is meant to align with what.

Note that, as originally configured, your layout will be inconsistent because both fancyhdr and scrlayer-scrpage will adjust headheight as required, changing the page dimensions in unpredictable ways. To avoid this, you need to make the height at least 33pt and to tell geometry about it.

Note also that scrlayer-scrpage is designed to cooperate with typearea. By using geometry, you lose the advantages of this. Consider whether you could use KOMA's typearea instead.

Here's the initial translation:

\documentclass[12pt,headsepline,footsepline]{scrreprt}
\renewcommand{\familydefault}{\sfdefault}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{geometry}% do you really need this? Better to use KOMA's setup if possible
\geometry{verbose,tmargin=2cm,bmargin=3.5cm,lmargin=3cm,rmargin=2.5cm,headheight=33pt}% the value 33pt is obtained from console warnings output by scrlayer-scrpage - this is the minimum required value, given the inclusion of the graphic - again, it would be better if you could use typearea for this
\usepackage[demo]{graphicx}
\usepackage{xcolor}
\definecolor{mygreen}{RGB}{23,156,125}
\usepackage{scrlayer-scrpage}
\setkomafont{pageheadfoot}{\upshape}
\setkomafont{pagehead}{\slshape}
\setkomafont{headsepline}{\color{mygreen}}
\setkomafont{footsepline}{\color{mygreen}}
\pagestyle{scrheadings}
\automark{chapter}
\ihead{\leftmark}
\ohead{\includegraphics[height=1cm]{IMG/Logo.JPG}}
\ofoot{\thepage}
\cfoot{}
\chead{}

\begin{document}
    Hello
\end{document}

I am guessing that you want the same footer on plain pages as on other pages. This can be achieved using the starred versions of \cfoot and \ofoot, and adding plainfootsepline to the class options:

\documentclass[12pt,headsepline,footsepline,plainfootsepline]{scrreprt}
\renewcommand{\familydefault}{\sfdefault}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{geometry}% do you really need this? Better to use KOMA's setup if possible
\geometry{verbose,tmargin=2cm,bmargin=3.5cm,lmargin=3cm,rmargin=2.5cm,headheight=33pt}% the value 33pt is obtained from console warnings output by scrlayer-scrpage - this is the minimum required value, given the inclusion of the graphic - again, it would be better if you could use typearea for this
\usepackage[demo]{graphicx}
\usepackage{xcolor}
\definecolor{mygreen}{RGB}{23,156,125}
\usepackage{scrlayer-scrpage,kantlipsum}
\setkomafont{pageheadfoot}{\upshape}
\setkomafont{pagehead}{\slshape}
\setkomafont{headsepline}{\color{mygreen}}
\setkomafont{footsepline}{\color{mygreen}}
\pagestyle{scrheadings}
\automark{chapter}
\ihead{\leftmark}
\ohead{\includegraphics[height=1cm]{IMG/Logo.JPG}}
\ofoot*{\thepage}
\cfoot*{}
\chead{}
\begin{document}
    Hello
    \chapter{Some chapter}
    \kant[1-10]
\end{document}

I'm guessing that the further change you want concerns the alignment of the \leftmark in the header. I'm not sure how this constitutes 2 changes, mind, since aligning with the bottom of the image will also reduce the distance....

So, I'm guessing you want something like this:

In which case, it is easiest, I think, to simply define the header in one go, setting the other parts of the header empty:

\documentclass[12pt,headsepline,footsepline,plainfootsepline]{scrreprt}
\renewcommand{\familydefault}{\sfdefault}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{geometry}% do you really need this? Better to use KOMA's setup if possible
\geometry{verbose,tmargin=2cm,bmargin=3.5cm,lmargin=3cm,rmargin=2.5cm,headheight=33pt}% the value 33pt is obtained from console warnings output by scrlayer-scrpage - this is the minimum required value, given the inclusion of the graphic - again, it would be better if you could use typearea for this
\usepackage{graphicx}
\usepackage{xcolor,calc}
\definecolor{mygreen}{RGB}{23,156,125}
\usepackage[markcase=upper]{scrlayer-scrpage}
\usepackage{kantlipsum}
\setkomafont{pageheadfoot}{\upshape}
\setkomafont{pagehead}{\slshape}
\setkomafont{headsepline}{\color{mygreen}}
\setkomafont{footsepline}{\color{mygreen}}
\pagestyle{scrheadings}
\automark{chapter}
\ihead{\leftmark\hfill \includegraphics[height=1cm]{example-image-a}}
\ohead{}
\chead{}
\ofoot*{\thepage}
\cfoot*{}
\chead{}
\begin{document}
    Hello
    \chapter{Some chapter}
    \kant[1-10]
\end{document}

EDIT

In response to the question concerning changing the headers, you can simply redefine \ihead (or \ihead*) as you wish. Do note, however, that doing so is likely to be confusing to readers. The point of running heads is that they contain information which is consistent throughout the document (except on special pages such as the first pages of chapters etc.). Also, the headers should not distract from the body of the document.

\ihead{\includegraphics[height=1cm]{example-image-b}\hfill\includegraphics[height=1cm]{example-image-a}}
\kant[11-14]
\ihead{\leftmark\hfill \includegraphics[height=1cm]{example-image-a}}
\kant[15-20]

EDIT EDIT

You can produce roughly the same page layout using typearea by commenting out the calls to geometry and adding

\areaset[5mm]{155mm}{272mm}

However, if you are stuck with a requirement to use precisely the dimensions given, then you may need to stick to geometry even though it does not cooperate with KOMA. You need to be a bit more careful to make sure you specify adequate headheight etc. in that case.

[Tex/LaTex] Configuration of scrlayer-scrpage Package

Remove the line \renewcommand*{\chapterpagestyle}{empty} from your code. Then the page style on chapter pages will be plain. To get no header entries on plain pages remove the optional argument of \ohead.

I guess that option chapterprefix is used in your document. To remove "chapter" from the header redefine \chaptermarkformat

\renewcommand*\chaptermarkformat{\thechapter\autodot\enskip}

Regarding your third question: Maybe you have to use \addchap{Acronyms}. If that does not help please ask a separat question with a MWE (minimal working example) that shows the issue.