mirror of
https://github.com/neovim/neovim.git
synced 2025-11-04 01:34:25 +00:00
f7b175e049
Problem: - Docs HTML: "foo ~" headings (column_heading) are not aligned with their table columns/contents because the leading whitespace is not emitted. - taglinks starting with hyphen like |-x| were not recognized. - keycodes like `<foo>` and `CTRL-x` were not recognized. - ToC is not scrollable. Solution: - Add ws() to the column_heading case. - Update help parser to latest version - supports `keycode` - fixes for taglink, argument - Update .toc CSS. https://github.com/neovim/neovim.github.io/issues/297 fix https://github.com/neovim/neovim.github.io/issues/297
50 lines
2.0 KiB
Lua
50 lines
2.0 KiB
Lua
-- Tests for gen_help_html.lua. Validates :help tags/links and HTML doc generation.
|
|
--
|
|
-- TODO: extract parts of gen_help_html.lua into Nvim stdlib?
|
|
|
|
local helpers = require('test.functional.helpers')(after_each)
|
|
local clear = helpers.clear
|
|
local exec_lua = helpers.exec_lua
|
|
local eq = helpers.eq
|
|
local ok = helpers.ok
|
|
|
|
describe(':help docs', function()
|
|
before_each(clear)
|
|
it('validate', function()
|
|
-- If this test fails, try these steps (in order):
|
|
-- 1. Fix/cleanup the :help docs.
|
|
-- 2. Fix the parser: https://github.com/neovim/tree-sitter-vimdoc
|
|
-- 3. File a parser bug, and adjust the tolerance of this test in the meantime.
|
|
|
|
local rv = exec_lua([[return require('scripts.gen_help_html').validate('./build/runtime/doc')]])
|
|
-- Check that we actually found helpfiles.
|
|
ok(rv.helpfiles > 100, '>100 :help files', rv.helpfiles)
|
|
-- Check that parse errors did not increase wildly.
|
|
-- TODO: Fix all parse errors in :help files.
|
|
ok(rv.err_count < 150, '<150 parse errors', rv.err_count)
|
|
eq({}, rv.invalid_links, exec_lua([[return 'found invalid :help tag links:\n'..vim.inspect(...)]], rv.invalid_links))
|
|
end)
|
|
|
|
it('gen_help_html.lua generates HTML', function()
|
|
-- 1. Test that gen_help_html.lua actually works.
|
|
-- 2. Test that parse errors did not increase wildly. Because we explicitly test only a few
|
|
-- :help files, we can be precise about the tolerances here.
|
|
|
|
local tmpdir = exec_lua('return vim.fs.dirname(vim.fn.tempname())')
|
|
-- Because gen() is slow (~30s), this test is limited to a few files.
|
|
local rv = exec_lua([[
|
|
local to_dir = ...
|
|
return require('scripts.gen_help_html').gen(
|
|
'./build/runtime/doc',
|
|
to_dir,
|
|
{ 'pi_health.txt', 'help.txt', 'index.txt', 'nvim.txt', }
|
|
)
|
|
]],
|
|
tmpdir
|
|
)
|
|
eq(4, #rv.helpfiles)
|
|
ok(rv.err_count <= 1, '<=1 parse errors', rv.err_count)
|
|
eq({}, rv.invalid_links, exec_lua([[return 'found invalid :help tag links:\n'..vim.inspect(...)]], rv.invalid_links))
|
|
end)
|
|
end)
|