sile-typesetter / sile / 9507147410

local mirrorMaster = function (_, existing, new)

   -- Frames in one master can't "see" frames in another, so we have to get creative

   -- XXX This knows altogether too much about the implementation of masters

   end

   end

      end

      end

      end

   end

end

end

local function switchPage (class)

end

local _deprecate = [[

  Directly calling master switch handling functions is no longer necessary. All

  the SILE core classes and anything inheriting from them will take care of this

  automatically using hooks. Custom classes that override the class:newPage()

  function may need to handle this in other ways. By calling this hook directly

  you are likely causing it to run twice and duplicate entries.

local spreadHook = function ()

end

   end

   end)

      -- TODO: Refactor this to make mirroring a separate package / option

      end

   end)

end

   end)

   end)

   -- This is upstreamed from CaSILE. Similar to the original open-double-page,

   -- but can disable headers and folios on blank pages and allows opening the

   -- even side (with or without a leading blank).

      local optionsMet = function ()

      end

      -- Output a box, then remove it and see where we are. Without adding

      -- content we can't prove on which page we would land because the page

      -- breaker *might* be stuffed almost full but still sitting on the last

      -- line happy to *maybe* accept more letter (but not a line). If this check

      -- gets us to the desired page nuke the vertical space so we don't leak it

      -- into the final content, otherwise just leave it be since we want to be

      -- forced to the next page anyway.

      end

      repeat

            -- Note: before you think you can simplify this, make sure all the

            -- pages before chapter starts in the manual have headers if they have

            -- content and not if empty. Combined with the workaround for just

            -- barely full pages above it's tricky to get right.

            end

         end

   end)

end

package.documentation = [[

\begin{document}

A book-like class usually sets up left and right mirrored page masters.

The \autodoc:package{twoside} package is then responsible for swapping between the two left and right frames, running headers, and so on.

As it is normally loaded and initialized by a document class, its main function in mirroring master frames does not provide any user-serviceable parts.

It does supply a few user-facing commands for convenience.

The \autodoc:command{\open-double-page} ejects whatever page is currently being processed, then checks if it landed on an even page.

If so, it ejects another page to assure content starts on an odd page.

The \autodoc:command{\open-spread} is similar but a bit more tailored to use in book layouts.

By default, headers and folios will be suppressed automatically on any empty pages ejected, making them blank.

It can also accept three parameters.

The \autodoc:parameter{odd} parameter (default \code{true}) can be used to disable the opening page being odd, hence opening an even page spread.

The \autodoc:parameter{double} parameter (default \code{true}) can be used to always output at least one empty even page before the starting an odd page.

The \autodoc:parameter{blank} parameter (default \code{true}) can be used to not suppress headers and folios on otherwise empty pages.

Lastly the \autodoc:command{\open-spread-eject} command can be overridden to customize the output of blank pages.

By default it just runs \autodoc:command{\supereject}, but you could potentially add decorative content or other features in the otherwise empty space.

\end{document}