9324025270

Committed 31 May 2024 08:35PM UTC coverage: 66.168% (-8.0%) from 74.124%

Build # 9324025270

Build Type

push

github

Committed by

web-flow

Commit Message

Merge 235329972 into 70ff5c335

Run Details

1753 of 2583 new or added lines in 108 files covered. (67.87%)

1498 existing lines in 74 files now uncovered.

11404 of 17235 relevant lines covered (66.17%)

2956.13 hits per line

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

98.48

/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")	15✔
2
3	local package = pl.class(base)	15✔
4	package._name = "footnotes"	15✔
5
6	function package:_init (options)	15✔
7	base._init(self)	15✔
8	self:loadPackage("counters")	15✔
9	self:loadPackage("raiselower")	15✔
10	self:loadPackage("insertions")	15✔
11	if not SILE.scratch.counters.footnotes then	15✔
12	SILE.scratch.counters.footnote = { value = 1, display = "arabic" }	15✔
13	end
14	options = options or {}	15✔
15	self.class:initInsertionClass("footnote", {	30✔
16	insertInto = options.insertInto or "footnotes",	15✔
17	stealFrom = options.stealFrom or { "content" },	15✔
18	maxHeight = SILE.types.length("75%ph"),	30✔
19	topBox = SILE.types.node.vglue("2ex"),	30✔
20	interInsertionSkip = SILE.types.length("1ex"),	30✔
21	})
22	end
23
24	function package:registerCommands ()	15✔
25	self:registerCommand("footnotemark", function (_, _)	30✔
26	SILE.call("raise", { height = "0.7ex" }, function ()	24✔
27	SILE.call("font", { size = "1.5ex" }, function ()	24✔
28	SILE.typesetter:typeset(self.class.packages.counters:formatCounter(SILE.scratch.counters.footnote))	24✔
29	end)
30	end)
31	end)
32
33	self:registerCommand("footnote:separator", function (_, content)	30✔
34	SILE.settings:pushState()	1✔
35	local material = SILE.call("vbox", {}, content)	1✔
36	SILE.scratch.insertions.classes.footnote.topBox = material	1✔
37	SILE.settings:popState()	1✔
38	end)
39
40	self:registerCommand("footnote:options", function (options, _)	30✔
41	if options["maxHeight"] then	1✔
NEW 42	SILE.scratch.insertions.classes.footnote.maxHeight = SILE.types.length(options["maxHeight"])	×
43	end
44	if options["interInsertionSkip"] then	1✔
45	SILE.scratch.insertions.classes.footnote.interInsertionSkip = SILE.types.length(options["interInsertionSkip"])	2✔
46	end
47	end)
48
49	self:registerCommand("footnote", function (options, content)	30✔
50	SILE.call("footnotemark")	12✔
51	local opts = SILE.scratch.insertions.classes.footnote or {}	12✔
52	local frame = opts.insertInto and SILE.getFrame(opts.insertInto.frame)	12✔
53	local oldGetTargetLength = SILE.typesetter.getTargetLength	12✔
54	local oldFrame = SILE.typesetter.frame	12✔
55	SILE.typesetter.getTargetLength = function ()	12✔
56	return SILE.types.length(0xFFFFFF)	13✔
57	end
58	SILE.settings:pushState()	12✔
59	-- Restore the settings to the top of the queue, which should be the document #986
60	SILE.settings:toplevelState()	12✔
61	SILE.typesetter:initFrame(frame)	12✔
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({	72✔
66	"current.hangAfter",
67	"current.hangIndent",
68	"linebreak.hangAfter",
69	"linebreak.hangIndent",
70	}) do	12✔
71	SILE.settings:set(v, SILE.settings.defaults[v])	48✔
72	end
73
74	-- Apply the font before boxing, so relative baselineskip applies #1027
75	local material
76	SILE.call("footnote:font", {}, function ()	24✔
77	material = SILE.call("vbox", {}, function ()	24✔
78	SILE.call("footnote:atstart", options)	12✔
79	SILE.call("footnote:counter", options)	12✔
80	SILE.process(content)	12✔
81	end)
82	end)
83	SILE.settings:popState()	12✔
84	SILE.typesetter.getTargetLength = oldGetTargetLength	12✔
85	SILE.typesetter.frame = oldFrame	12✔
86	self.class:insert("footnote", material)	12✔
87	SILE.scratch.counters.footnote.value = SILE.scratch.counters.footnote.value + 1	12✔
88	end)
89
90	self:registerCommand("footnote:font", function (_, content)	30✔
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 ()	36✔
95	SILE.process(content)	12✔
96	end)
97	end)
98
99	self:registerCommand("footnote:atstart", function (_, _) end)	27✔
100
101	self:registerCommand("footnote:counter", function (_, _)	30✔
102	SILE.call("noindent")	12✔
103	SILE.typesetter:typeset(self.class.packages.counters:formatCounter(SILE.scratch.counters.footnote) .. ".")	24✔
104	SILE.call("qquad")	12✔
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	]]	15✔
120
121	return package	15✔

sile-typesetter / sile / 9324025270

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