11365342863

Committed 16 Oct 2024 12:10PM UTC coverage: 61.897% (-5.7%) from 67.573%

Build # 11365342863

Build Type

push

github

Committed by

web-flow

Commit Message

Merge pull request #2137 from alerque/cli-options

Run Details

11064 of 17875 relevant lines covered (61.9%)

4017.63 hits per line

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

0.0

/packages/verbatim/init.lua

local base = require("packages.base")

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

function package:registerCommands ()
   self:registerCommand("verbatim:font", function (options, content)
      options.family = options.family or "Hack"
      options.size = options.size or SILE.settings:get("font.size") - 3
      SILE.call("font", options, content)
   end, "The font chosen for the verbatim environment")

   self:registerCommand("verbatim", function (_, content)
      SILE.typesetter:pushVglue(6)
      SILE.typesetter:leaveHmode()
      SILE.settings:temporarily(function ()
         SILE.settings:set("typesetter.parseppattern", "\n")
         SILE.settings:set("typesetter.obeyspaces", true)
         SILE.settings:set("document.rskip", SILE.types.node.glue("0 plus 10000pt"))
         SILE.settings:set("document.parindent", SILE.types.node.glue("0"))
         SILE.settings:set("document.baselineskip", SILE.types.node.vglue("0"))
         SILE.settings:set("document.lineskip", SILE.types.node.vglue("2pt"))
         SILE.call("verbatim:font")
         SILE.settings:set("document.spaceskip", SILE.types.length("1spc"))
         SILE.settings:set("shaper.variablespaces", false)
         SILE.settings:set("document.language", "und")
         SILE.process(content)
      end)
      SILE.typesetter:leaveHmode()
   end, "Typesets its contents in a monospaced font.")

   self:registerCommand("obeylines", function (_, content)
      SILE.settings:temporarily(function ()
         SILE.settings:set("typesetter.parseppattern", "\n")
         SILE.process(content)
      end)
   end)
end

package.documentation = [[
\begin{document}
The \autodoc:package{verbatim} package is useful when quoting pieces of computer code and other text for which formatting is significant.
It changes SILE’s settings so that text is set ragged right, with no hyphenation, no indentation and regular spacing.
It tells SILE to honor multiple spaces, and sets a monospaced font.

\autodoc:note{Despite the name, \autodoc:environment{verbatim} does not alter the way that SILE sees special characters.
You still need to escape backslashes and braces: to produce a backslash, you need to write \code{\\\\}.}

Here is some text set in the \autodoc:environment{verbatim} environment:

\begin[type=autodoc:codeblock]{raw}
local function init (class, _)
  class:loadPackage("rebox")
  class:loadPackage("raiselower")
end
\end{raw}

If you want to specify what font the verbatim environment should use, you can redefine the \autodoc:command{\verbatim:font} command.
For example you could change it from XML like this:

\begin[type=autodoc:codeblock]{raw}
<define command="verbatim:font">
   <font family="DejaVu Sans Mono" size="9pt"/>
</define>
\end{raw}
\end{document}
]]

return package

1	local base = require("packages.base")	×
2
3	local package = pl.class(base)	×
4	package._name = "verbatim"	×
5
6	function package:registerCommands ()	×
7	self:registerCommand("verbatim:font", function (options, content)	×
8	options.family = options.family or "Hack"	×
9	options.size = options.size or SILE.settings:get("font.size") - 3	×
10	SILE.call("font", options, content)	×
11	end, "The font chosen for the verbatim environment")	×
12
13	self:registerCommand("verbatim", function (_, content)	×
14	SILE.typesetter:pushVglue(6)	×
15	SILE.typesetter:leaveHmode()	×
16	SILE.settings:temporarily(function ()	×
17	SILE.settings:set("typesetter.parseppattern", "\n")	×
18	SILE.settings:set("typesetter.obeyspaces", true)	×
19	SILE.settings:set("document.rskip", SILE.types.node.glue("0 plus 10000pt"))	×
20	SILE.settings:set("document.parindent", SILE.types.node.glue("0"))	×
21	SILE.settings:set("document.baselineskip", SILE.types.node.vglue("0"))	×
22	SILE.settings:set("document.lineskip", SILE.types.node.vglue("2pt"))	×
23	SILE.call("verbatim:font")	×
24	SILE.settings:set("document.spaceskip", SILE.types.length("1spc"))	×
25	SILE.settings:set("shaper.variablespaces", false)	×
26	SILE.settings:set("document.language", "und")	×
27	SILE.process(content)	×
28	end)
29	SILE.typesetter:leaveHmode()	×
30	end, "Typesets its contents in a monospaced font.")	×
31
32	self:registerCommand("obeylines", function (_, content)	×
33	SILE.settings:temporarily(function ()	×
34	SILE.settings:set("typesetter.parseppattern", "\n")	×
35	SILE.process(content)	×
36	end)
37	end)
38	end
39
40	package.documentation = [[
41	\begin{document}
42	The \autodoc:package{verbatim} package is useful when quoting pieces of computer code and other text for which formatting is significant.
43	It changes SILE’s settings so that text is set ragged right, with no hyphenation, no indentation and regular spacing.
44	It tells SILE to honor multiple spaces, and sets a monospaced font.
45
46	\autodoc:note{Despite the name, \autodoc:environment{verbatim} does not alter the way that SILE sees special characters.
47	You still need to escape backslashes and braces: to produce a backslash, you need to write \code{\\\\}.}
48
49	Here is some text set in the \autodoc:environment{verbatim} environment:
50
51	\begin[type=autodoc:codeblock]{raw}
52	local function init (class, _)
53	class:loadPackage("rebox")
54	class:loadPackage("raiselower")
55	end
56	\end{raw}
57
58	If you want to specify what font the verbatim environment should use, you can redefine the \autodoc:command{\verbatim:font} command.
59	For example you could change it from XML like this:
60
61	\begin[type=autodoc:codeblock]{raw}
62	<define command="verbatim:font">
63	<font family="DejaVu Sans Mono" size="9pt"/>
64	</define>
65	\end{raw}
66	\end{document}
67	]]	×
68
69	return package	×

sile-typesetter / sile / 11365342863

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