• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

sile-typesetter / sile / 11135083927

01 Oct 2024 11:26PM UTC coverage: 62.071% (-7.3%) from 69.333%
11135083927

push

github

alerque
style: Reformat Lua with stylua

0 of 9 new or added lines in 2 files covered. (0.0%)

1678 existing lines in 57 files now uncovered.

11071 of 17836 relevant lines covered (62.07%)

5220.48 hits per line

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

87.88
/packages/footnotes/init.lua
1
local base = require("packages.base")
9✔
2

3
local package = pl.class(base)
9✔
4
package._name = "footnotes"
9✔
5

6
function package:_init (options)
9✔
7
   base._init(self)
9✔
8
   self:loadPackage("counters")
9✔
9
   self:loadPackage("raiselower")
9✔
10
   self:loadPackage("insertions")
9✔
11
   if not SILE.scratch.counters.footnotes then
9✔
12
      SILE.scratch.counters.footnote = { value = 1, display = "arabic" }
9✔
13
   end
14
   options = options or {}
9✔
15
   self.class:initInsertionClass("footnote", {
18✔
16
      insertInto = options.insertInto or "footnotes",
9✔
17
      stealFrom = options.stealFrom or { "content" },
9✔
18
      maxHeight = SILE.types.length("75%ph"),
18✔
19
      topBox = SILE.types.node.vglue("2ex"),
18✔
20
      interInsertionSkip = SILE.types.length("1ex"),
18✔
21
   })
22
end
23

24
function package:registerCommands ()
9✔
25
   self:registerCommand("footnotemark", function (_, _)
18✔
26
      SILE.call("raise", { height = "0.7ex" }, function ()
6✔
27
         SILE.call("font", { size = "1.5ex" }, function ()
6✔
28
            SILE.typesetter:typeset(self.class.packages.counters:formatCounter(SILE.scratch.counters.footnote))
6✔
29
         end)
30
      end)
31
   end)
32

33
   self:registerCommand("footnote:separator", function (_, content)
18✔
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, _)
18✔
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)
18✔
50
      SILE.call("footnotemark")
3✔
51
      local opts = SILE.scratch.insertions.classes.footnote or {}
3✔
52
      local frame = opts.insertInto and SILE.getFrame(opts.insertInto.frame)
3✔
53
      local oldGetTargetLength = SILE.typesetter.getTargetLength
3✔
54
      local oldFrame = SILE.typesetter.frame
3✔
55
      SILE.typesetter.getTargetLength = function ()
3✔
56
         return SILE.types.length(0xFFFFFF)
4✔
57
      end
58
      SILE.settings:pushState()
3✔
59
      -- Restore the settings to the top of the queue, which should be the document #986
60
      SILE.settings:toplevelState()
3✔
61
      SILE.typesetter:initFrame(frame)
3✔
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({
18✔
66
         "current.hangAfter",
67
         "current.hangIndent",
68
         "linebreak.hangAfter",
69
         "linebreak.hangIndent",
70
      }) do
3✔
71
         SILE.settings:set(v, SILE.settings.defaults[v])
12✔
72
      end
73

74
      -- Apply the font before boxing, so relative baselineskip applies #1027
75
      local material
76
      SILE.call("footnote:font", {}, function ()
6✔
77
         material = SILE.call("vbox", {}, function ()
6✔
78
            SILE.call("footnote:atstart", options)
3✔
79
            SILE.call("footnote:counter", options)
3✔
80
            SILE.process(content)
3✔
81
         end)
82
      end)
83
      SILE.settings:popState()
3✔
84
      SILE.typesetter.getTargetLength = oldGetTargetLength
3✔
85
      SILE.typesetter.frame = oldFrame
3✔
86
      self.class:insert("footnote", material)
3✔
87
      SILE.scratch.counters.footnote.value = SILE.scratch.counters.footnote.value + 1
3✔
88
   end)
89

90
   self:registerCommand("footnote:font", function (_, content)
18✔
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 ()
9✔
95
         SILE.process(content)
3✔
96
      end)
97
   end)
98

99
   self:registerCommand("footnote:atstart", function (_, _) end)
12✔
100

101
   self:registerCommand("footnote:counter", function (_, _)
18✔
102
      SILE.call("noindent")
3✔
103
      SILE.typesetter:typeset(self.class.packages.counters:formatCounter(SILE.scratch.counters.footnote) .. ".")
6✔
104
      SILE.call("qquad")
3✔
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
]]
9✔
120

121
return package
9✔
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2026 Coveralls, Inc