unexpeced formatting #32

New issue

Closed

opened 2026-04-10 09:07:32 +00:00 by lukas · 0 comments

lukas commented

2026-04-10 09:07:32 +00:00

Owner

(note unexpeced as the user probably experiences it, not unexpected in terms I as author do not expect it)

Most of this came up in https://github.com/atticus-sullivan/kata/pull/11#discussion_r3047068505

How to handle the situation with

the \section at the beginning of kata
the \marginline at the beginning of kata
the \vfil before the first step

In many cases it probably makes sense to have all these, but the package should definitely not force them.

Ideas

Section

make it optional via pgfkey flag -> still lacks the option to use subsection etc, also how does this play with the step@cnt counter?
a. the issue with the counter probably is not really to be solved easily. Maybe then it makes sense to add another counter which counts the katas. This should avoid "collisions" with the automatically generated \labels (due to refstepcounter)

marginline

make it optional via pgfkey flag

vfil

this probably is very specific and should be removed almost entirely. Though it would be nice to allow the user to "inject" code before the first step to still retain this behavior -> use the new hook-management for this and offer a hook to the user?

(note unexpeced as the user probably experiences it, not unexpected in terms I as author do not expect it) Most of this came up in https://github.com/atticus-sullivan/kata/pull/11#discussion_r3047068505 How to handle the situation with - [x] the `\section` at the beginning of `kata` - [x] the `\marginline` at the beginning of `kata` - [x] the `\vfil` before the first `step` In many cases it probably makes sense to have all these, but the package should definitely not force them. # Ideas ## Section 1. make it optional via pgfkey flag -> still lacks the option to use subsection etc, also how does this play with the `step@cnt` counter? a. the issue with the counter probably is not really to be solved easily. Maybe then it makes sense to add another counter which counts the `kata`s. This should avoid "collisions" with the automatically generated `\label`s (due to *ref*stepcounter) ## marginline 1. make it optional via pgfkey flag ## vfil 1. this probably is very specific and should be removed almost entirely. Though it would be nice to allow the user to "inject" code before the first `step` to still retain this behavior -> use the new hook-management for this and offer a hook to the user?