11170735472

Committed 03 Oct 2024 10:32PM UTC coverage: 58.612% (-4.5%) from 63.103%

Build # 11170735472

Build Type

push

github

Committed by

web-flow

Commit Message

Merge bcab25790 into 783083345

Run Details

15 of 64 new or added lines in 5 files covered. (23.44%)

828 existing lines in 41 files now uncovered.

10478 of 17877 relevant lines covered (58.61%)

2029.7 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

87.88

/packages/footnotes/init.lua

local base = require("packages.base")

local package = pl.class(base)
package._name = "footnotes"

function package:_init (options)
   base._init(self)
   self:loadPackage("counters")
   self:loadPackage("raiselower")
   self:loadPackage("insertions")
   if not SILE.scratch.counters.footnotes then
      SILE.scratch.counters.footnote = { value = 1, display = "arabic" }
   end
   options = options or {}
   self.class:initInsertionClass("footnote", {
      insertInto = options.insertInto or "footnotes",
      stealFrom = options.stealFrom or { "content" },
      maxHeight = SILE.types.length("75%ph"),
      topBox = SILE.types.node.vglue("2ex"),
      interInsertionSkip = SILE.types.length("1ex"),
   })
end

function package:registerCommands ()
   self:registerCommand("footnotemark", function (_, _)
      SILE.call("raise", { height = "0.7ex" }, function ()
         SILE.call("font", { size = "1.5ex" }, function ()
            SILE.typesetter:typeset(self.class.packages.counters:formatCounter(SILE.scratch.counters.footnote))
         end)
      end)
   end)

   self:registerCommand("footnote:separator", function (_, content)
      SILE.settings:pushState()
      local material = SILE.call("vbox", {}, content)
      SILE.scratch.insertions.classes.footnote.topBox = material
      SILE.settings:popState()
   end)

   self:registerCommand("footnote:options", function (options, _)
      if options["maxHeight"] then
         SILE.scratch.insertions.classes.footnote.maxHeight = SILE.types.length(options["maxHeight"])
      end
      if options["interInsertionSkip"] then
         SILE.scratch.insertions.classes.footnote.interInsertionSkip = SILE.types.length(options["interInsertionSkip"])
      end
   end)

   self:registerCommand("footnote", function (options, content)
      SILE.call("footnotemark")
      local opts = SILE.scratch.insertions.classes.footnote or {}
      local frame = opts.insertInto and SILE.getFrame(opts.insertInto.frame)
      local oldGetTargetLength = SILE.typesetter.getTargetLength
      local oldFrame = SILE.typesetter.frame
      SILE.typesetter.getTargetLength = function ()
         return SILE.types.length(0xFFFFFF)
      end
      SILE.settings:pushState()
      -- Restore the settings to the top of the queue, which should be the document #986
      SILE.settings:toplevelState()
      SILE.typesetter:initFrame(frame)

      -- Reset settings the document may have but should not be applied to footnotes
      -- See also same resets in folio package
      for _, v in ipairs({
         "current.hangAfter",
         "current.hangIndent",
         "linebreak.hangAfter",
         "linebreak.hangIndent",
      }) do
         SILE.settings:set(v, SILE.settings.defaults[v])
      end

      -- Apply the font before boxing, so relative baselineskip applies #1027
      local material
      SILE.call("footnote:font", {}, function ()
         material = SILE.call("vbox", {}, function ()
            SILE.call("footnote:atstart", options)
            SILE.call("footnote:counter", options)
            SILE.process(content)
         end)
      end)
      SILE.settings:popState()
      SILE.typesetter.getTargetLength = oldGetTargetLength
      SILE.typesetter.frame = oldFrame
      self.class:insert("footnote", material)
      SILE.scratch.counters.footnote.value = SILE.scratch.counters.footnote.value + 1
   end)

   self:registerCommand("footnote:font", function (_, content)
      -- The footnote frame has is settings reset to the toplevel state, so if one does
      -- something relative (as below), it is expected to be the main value from the
      -- document.
      SILE.call("font", { size = SILE.settings:get("font.size") * 0.9 }, function ()
         SILE.process(content)
      end)
   end)

   self:registerCommand("footnote:atstart", function (_, _) end)

   self:registerCommand("footnote:counter", function (_, _)
      SILE.call("noindent")
      SILE.typesetter:typeset(self.class.packages.counters:formatCounter(SILE.scratch.counters.footnote) .. ".")
      SILE.call("qquad")
   end)
end

package.documentation = [[
\begin{document}
The \autodoc:package{footnotes} package allows you to add footnotes to text with the \autodoc:command{\footnote} command.
Other commands provided by the package, not described here, take care of formatting the footnotes.

Usually, a document class is responsible for automatically loading this package.
Minimally, upon initialization, it needs a frame identifier for the the footnotes, and one or more frame(s) which will be reduced as the footnotes take place.
By default, it uses, respectively, the \code{footnotes} and \code{content} frames, which are assumed to be present in the default standard layout.

For the record, it internally relies on the \autodoc:package{insertions} package and tells it which frame should receive the footnotes that are typeset.
\end{document}
]]

return package

1	local base = require("packages.base")	4✔
2
3	local package = pl.class(base)	4✔
4	package._name = "footnotes"	4✔
5
6	function package:_init (options)	4✔
7	base._init(self)	4✔
8	self:loadPackage("counters")	4✔
9	self:loadPackage("raiselower")	4✔
10	self:loadPackage("insertions")	4✔
11	if not SILE.scratch.counters.footnotes then	4✔
12	SILE.scratch.counters.footnote = { value = 1, display = "arabic" }	4✔
13	end
14	options = options or {}	4✔
15	self.class:initInsertionClass("footnote", {	8✔
16	insertInto = options.insertInto or "footnotes",	4✔
17	stealFrom = options.stealFrom or { "content" },	4✔
18	maxHeight = SILE.types.length("75%ph"),	8✔
19	topBox = SILE.types.node.vglue("2ex"),	8✔
20	interInsertionSkip = SILE.types.length("1ex"),	8✔
21	})
22	end
23
24	function package:registerCommands ()	4✔
25	self:registerCommand("footnotemark", function (_, _)	8✔
26	SILE.call("raise", { height = "0.7ex" }, function ()	2✔
27	SILE.call("font", { size = "1.5ex" }, function ()	2✔
28	SILE.typesetter:typeset(self.class.packages.counters:formatCounter(SILE.scratch.counters.footnote))	2✔
29	end)
30	end)
31	end)
32
33	self:registerCommand("footnote:separator", function (_, content)	8✔
UNCOV 34	SILE.settings:pushState()	×
UNCOV 35	local material = SILE.call("vbox", {}, content)	×
UNCOV 36	SILE.scratch.insertions.classes.footnote.topBox = material	×
UNCOV 37	SILE.settings:popState()	×
38	end)
39
40	self:registerCommand("footnote:options", function (options, _)	8✔
UNCOV 41	if options["maxHeight"] then	×
42	SILE.scratch.insertions.classes.footnote.maxHeight = SILE.types.length(options["maxHeight"])	×
43	end
UNCOV 44	if options["interInsertionSkip"] then	×
UNCOV 45	SILE.scratch.insertions.classes.footnote.interInsertionSkip = SILE.types.length(options["interInsertionSkip"])	×
46	end
47	end)
48
49	self:registerCommand("footnote", function (options, content)	8✔
50	SILE.call("footnotemark")	1✔
51	local opts = SILE.scratch.insertions.classes.footnote or {}	1✔
52	local frame = opts.insertInto and SILE.getFrame(opts.insertInto.frame)	1✔
53	local oldGetTargetLength = SILE.typesetter.getTargetLength	1✔
54	local oldFrame = SILE.typesetter.frame	1✔
55	SILE.typesetter.getTargetLength = function ()	1✔
56	return SILE.types.length(0xFFFFFF)	4✔
57	end
58	SILE.settings:pushState()	1✔
59	-- Restore the settings to the top of the queue, which should be the document #986
60	SILE.settings:toplevelState()	1✔
61	SILE.typesetter:initFrame(frame)	1✔
62
63	-- Reset settings the document may have but should not be applied to footnotes
64	-- See also same resets in folio package
65	for _, v in ipairs({	6✔
66	"current.hangAfter",
67	"current.hangIndent",
68	"linebreak.hangAfter",
69	"linebreak.hangIndent",
70	}) do	1✔
71	SILE.settings:set(v, SILE.settings.defaults[v])	4✔
72	end
73
74	-- Apply the font before boxing, so relative baselineskip applies #1027
75	local material
76	SILE.call("footnote:font", {}, function ()	2✔
77	material = SILE.call("vbox", {}, function ()	2✔
78	SILE.call("footnote:atstart", options)	1✔
79	SILE.call("footnote:counter", options)	1✔
80	SILE.process(content)	1✔
81	end)
82	end)
83	SILE.settings:popState()	1✔
84	SILE.typesetter.getTargetLength = oldGetTargetLength	1✔
85	SILE.typesetter.frame = oldFrame	1✔
86	self.class:insert("footnote", material)	1✔
87	SILE.scratch.counters.footnote.value = SILE.scratch.counters.footnote.value + 1	1✔
88	end)
89
90	self:registerCommand("footnote:font", function (_, content)	8✔
91	-- The footnote frame has is settings reset to the toplevel state, so if one does
92	-- something relative (as below), it is expected to be the main value from the
93	-- document.
94	SILE.call("font", { size = SILE.settings:get("font.size") * 0.9 }, function ()	3✔
95	SILE.process(content)	1✔
96	end)
97	end)
98
99	self:registerCommand("footnote:atstart", function (_, _) end)	5✔
100
101	self:registerCommand("footnote:counter", function (_, _)	8✔
102	SILE.call("noindent")	1✔
103	SILE.typesetter:typeset(self.class.packages.counters:formatCounter(SILE.scratch.counters.footnote) .. ".")	2✔
104	SILE.call("qquad")	1✔
105	end)
106	end
107
108	package.documentation = [[
109	\begin{document}
110	The \autodoc:package{footnotes} package allows you to add footnotes to text with the \autodoc:command{\footnote} command.
111	Other commands provided by the package, not described here, take care of formatting the footnotes.
112
113	Usually, a document class is responsible for automatically loading this package.
114	Minimally, upon initialization, it needs a frame identifier for the the footnotes, and one or more frame(s) which will be reduced as the footnotes take place.
115	By default, it uses, respectively, the \code{footnotes} and \code{content} frames, which are assumed to be present in the default standard layout.
116
117	For the record, it internally relies on the \autodoc:package{insertions} package and tells it which frame should receive the footnotes that are typeset.
118	\end{document}
119	]]	4✔
120
121	return package	4✔

sile-typesetter / sile / 11170735472

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous