Files
John MacFarlane 03bb426a4a Shared: makeSections behavior changes.
+ When the optional base level parameter is provided, we no
  longer ensure that the sequence of heading levels is gapless
  [behavior change]. Instead, we set the lowest heading level to
  the specified base level, and adjust the others accordingly. If
  an author wants to skip a level, e.g. from level 1 to level 3,
  they can do that. In general, the heading levels specified
  in the source document are preserved; `makeSections` only
  puts them into a hierarchical structure. Closes #9398.

+ Section numbers are now assigned so that the top level
  gets `1`, no matter what heading level is used. So, even
  if the top heading level is 2, numbers will be `1`, `2`, etc.
  rather than `0.1`, `0.2`, as in the past. Closes #5071.

+ We revert to the old behavior when the `--number-offset` option
  is used. So, for example, if a document begins with a level-3
  heading, and `--number-offset=1,2` is used, the top-level section
  numbers will be `1.2.1`, `1.2.2`, etc. This is mainly for
  backwards-compatibility.
2024-02-03 22:19:29 -08:00

140 lines
5.0 KiB
Lua

local tasty = require 'tasty'
local structure = require 'pandoc.structure'
local path = require 'pandoc.path'
local system = require 'pandoc.system'
local assert = tasty.assert
local test = tasty.test_case
local group = tasty.test_group
return {
test('is table', function ()
assert.are_equal(type(structure), 'table')
end),
group 'make_sections' {
test('sanity check', function ()
local blks = {
pandoc.Header(1, {pandoc.Str 'First'}),
pandoc.Header(2, {pandoc.Str 'Second'}),
pandoc.Header(2, {pandoc.Str 'Third'}),
}
local opts = PANDOC_WRITER_OPTIONS
local hblks = structure.make_sections(blks, opts)
assert.are_equal('Div', hblks[1].t)
assert.are_equal('Header', hblks[1].content[1].t)
end),
test('respects number_sections', function ()
local blks = {
pandoc.Header(1, {pandoc.Str 'First'}),
pandoc.Para 'Vestibulum convallis, lorem a tempus semper.'
}
local hblks = structure.make_sections(blks, {number_sections = true})
assert.are_equal('Div', hblks[1].t)
assert.are_equal('Header', hblks[1].content[1].t)
assert.are_equal('1', hblks[1].content[1].attributes['number'])
end),
test('respects base_level', function ()
local blks = {
pandoc.Header(1, {pandoc.Str 'First'}),
pandoc.Para 'Curabitur lacinia pulvinar nibh.',
pandoc.Header(3, {pandoc.Str 'First'}), -- Skipping level 2
}
local opts = {
number_sections = true,
base_level = 1
}
local hblks = structure.make_sections(blks, opts)
assert.are_equal('Div', hblks[1].t)
assert.are_equal('Header', hblks[1].content[1].t)
assert.are_equal('1', hblks[1].content[1].attributes['number'])
assert.are_equal('1.0.1', hblks[1].content[3].attributes['number'])
end)
},
group 'split_into_chunks' {
test('is function', function ()
assert.are_equal(type(structure.split_into_chunks), 'function')
end),
test('returns a chunked doc', function ()
assert.are_equal(
pandoc.utils.type(structure.split_into_chunks(pandoc.Pandoc{})),
'pandoc.ChunkedDoc'
)
end),
},
group 'table_of_contents' {
test('is function', function ()
assert.are_equal(type(structure.table_of_contents), 'function')
end),
test('returns a bullet list', function ()
assert.are_equal(
pandoc.utils.type(structure.table_of_contents{}),
'Block'
)
assert.are_equal(
structure.table_of_contents{}.t,
'BulletList'
)
end),
test('returns a toc for a list of blocks', function ()
local body = pandoc.Blocks{
pandoc.Header(1, 'First'),
pandoc.Para('A sentence placed below the first structure.'),
pandoc.Header(2, 'Subsection'),
pandoc.Para('Mauris ac felis vel velit tristique imperdiet.'),
pandoc.Header(1, 'Second'),
pandoc.Para('Integer placerat tristique nisl.')
}
assert.are_equal(
structure.table_of_contents(body),
pandoc.BulletList{
{pandoc.Plain('First'),
pandoc.BulletList{{pandoc.Plain 'Subsection'}}
},
{pandoc.Plain('Second')}
}
)
end),
test('returns a toc for a chunked doc', function ()
local doc = pandoc.Pandoc {
pandoc.Header(1, 'First', {id='first'}),
pandoc.Para('A sentence placed below the first structure.'),
pandoc.Header(2, 'Subsection', {id='subsection'}),
pandoc.Para('Mauris ac felis vel velit tristique imperdiet.'),
pandoc.Header(1, 'Second', {id='second'}),
pandoc.Para('Integer placerat tristique nisl.')
}
local chunked = structure.split_into_chunks(doc, {chunk_level = 2})
assert.are_equal(
structure.table_of_contents(chunked),
pandoc.BulletList{
{pandoc.Plain({pandoc.Link('First', 'chunk-001#first', '', {id='toc-first'})}),
pandoc.BulletList{{pandoc.Plain({pandoc.Link('Subsection', 'chunk-002#subsection', '', {id='toc-subsection'})})}}
},
{pandoc.Plain({pandoc.Link('Second', 'chunk-003#second', '', {id='toc-second'})})}
}
)
end),
test('respects toc-depth option', function ()
local doc = pandoc.Pandoc {
pandoc.Header(1, 'First', {id='first'}),
pandoc.Para('A sentence placed below the first structure.'),
pandoc.Header(2, 'Subsection', {id='subsection'}),
pandoc.Para('Mauris ac felis vel velit tristique imperdiet.'),
pandoc.Header(1, 'Second', {id='second'}),
pandoc.Para('Integer placerat tristique nisl.')
}
local chunked = structure.split_into_chunks(doc)
assert.are_equal(
structure.table_of_contents(chunked, {toc_depth = 1}),
pandoc.BulletList{
{pandoc.Plain({pandoc.Link('First', 'chunk-001#first', '', {id='toc-first'})})},
{pandoc.Plain({pandoc.Link('Second', 'chunk-002#second', '', {id='toc-second'})})}
}
)
end),
},
}