<feed xmlns='http://www.w3.org/2005/Atom'>
<title>rneovim.git/scripts/gen_help_html.lua, branch floattitle</title>
<subtitle>Neovim fork with Rahm's personal hacks.</subtitle>
<link rel='alternate' type='text/html' href='http://git.josher.dev/rneovim.git/'/>
<entry>
<title>feat(docs-html): try to use tags for ToC headings</title>
<updated>2022-10-09T23:05:18+00:00</updated>
<author>
<name>Justin M. Keyes</name>
<email>justinkz@gmail.com</email>
</author>
<published>2022-10-09T22:40:17+00:00</published>
<link rel='alternate' type='text/html' href='http://git.josher.dev/rneovim.git/commit/?id=6b01e9bf872cc91530b41fcd97c6bf984776ade6'/>
<id>6b01e9bf872cc91530b41fcd97c6bf984776ade6</id>
<content type='text'>
Problem:
The generated ToC (table of contents) uses anchors derived from the
heading title, e.g. the "Global Plugins" heading yields:
https://neovim.io/doc/user/usr_05.html#_global-plugins-
so if the heading title changes, then the old URL (anchor) is broken.

Solution:
:help tags change less often than heading titles, so if a heading
contains a *tag*, use that as its anchor name instead. Example:
https://neovim.io/doc/user/usr_05.html#standard-plugin
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Problem:
The generated ToC (table of contents) uses anchors derived from the
heading title, e.g. the "Global Plugins" heading yields:
https://neovim.io/doc/user/usr_05.html#_global-plugins-
so if the heading title changes, then the old URL (anchor) is broken.

Solution:
:help tags change less often than heading titles, so if a heading
contains a *tag*, use that as its anchor name instead. Example:
https://neovim.io/doc/user/usr_05.html#standard-plugin
</pre>
</div>
</content>
</entry>
<entry>
<title>fix(docs-html): update parser</title>
<updated>2022-10-09T23:05:18+00:00</updated>
<author>
<name>Justin M. Keyes</name>
<email>justinkz@gmail.com</email>
</author>
<published>2022-10-09T16:19:43+00:00</published>
<link rel='alternate' type='text/html' href='http://git.josher.dev/rneovim.git/commit/?id=a7a83bc4c25d63f3ae0a7a56e5211df1444699c4'/>
<id>a7a83bc4c25d63f3ae0a7a56e5211df1444699c4</id>
<content type='text'>
- Improve generated HTML by updating parser which includes fixes for
  single "'" and single "|":
  https://github.com/neovim/tree-sitter-vimdoc/pull/31
- Updated parser also fixes the conceal issue for "help" highlight
  queries https://github.com/neovim/tree-sitter-vimdoc/issues/23 by
  NOT including whitespace in nodes.
  - But this means we need to restore the getws() function which scrapes
    leading whitespace from the original input (buffer).
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
- Improve generated HTML by updating parser which includes fixes for
  single "'" and single "|":
  https://github.com/neovim/tree-sitter-vimdoc/pull/31
- Updated parser also fixes the conceal issue for "help" highlight
  queries https://github.com/neovim/tree-sitter-vimdoc/issues/23 by
  NOT including whitespace in nodes.
  - But this means we need to restore the getws() function which scrapes
    leading whitespace from the original input (buffer).
</pre>
</div>
</content>
</entry>
<entry>
<title>docs: various #12823</title>
<updated>2022-10-09T12:21:52+00:00</updated>
<author>
<name>Justin M. Keyes</name>
<email>justinkz@gmail.com</email>
</author>
<published>2022-10-09T12:21:52+00:00</published>
<link rel='alternate' type='text/html' href='http://git.josher.dev/rneovim.git/commit/?id=09dffb9db7d16496e55e86f78ab60241533d86f6'/>
<id>09dffb9db7d16496e55e86f78ab60241533d86f6</id>
<content type='text'>
- increase python line-length limit from 88 =&gt; 100.
- gen_help_html: fix bug in "tag" case (tbl_count =&gt; tbl_contains)

ref #15632
fix #18215
fix #18479
fix #20527
fix #20532

Co-authored-by: Ben Weedon &lt;ben@weedon.email&gt;</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
- increase python line-length limit from 88 =&gt; 100.
- gen_help_html: fix bug in "tag" case (tbl_count =&gt; tbl_contains)

ref #15632
fix #18215
fix #18479
fix #20527
fix #20532

Co-authored-by: Ben Weedon &lt;ben@weedon.email&gt;</pre>
</div>
</content>
</entry>
<entry>
<title>docs(news): add news.txt and link from README (#20426)</title>
<updated>2022-10-08T15:49:09+00:00</updated>
<author>
<name>Christian Clason</name>
<email>c.clason@uni-graz.at</email>
</author>
<published>2022-10-08T15:49:09+00:00</published>
<link rel='alternate' type='text/html' href='http://git.josher.dev/rneovim.git/commit/?id=93117b358778487d85665035b6a95976eee70d9c'/>
<id>93117b358778487d85665035b6a95976eee70d9c</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>fix(docs-html): keycodes, taglinks, column_heading #20498</title>
<updated>2022-10-06T13:16:00+00:00</updated>
<author>
<name>Justin M. Keyes</name>
<email>justinkz@gmail.com</email>
</author>
<published>2022-10-06T13:16:00+00:00</published>
<link rel='alternate' type='text/html' href='http://git.josher.dev/rneovim.git/commit/?id=f7b175e049db9262a45ee1c5eb41a38bd5b8ac38'/>
<id>f7b175e049db9262a45ee1c5eb41a38bd5b8ac38</id>
<content type='text'>
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 `&lt;foo&gt;` 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</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
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 `&lt;foo&gt;` 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</pre>
</div>
</content>
</entry>
<entry>
<title>fix(docs): missing "(" in :help HTML</title>
<updated>2022-10-04T19:15:06+00:00</updated>
<author>
<name>Justin M. Keyes</name>
<email>justinkz@gmail.com</email>
</author>
<published>2022-10-04T13:15:06+00:00</published>
<link rel='alternate' type='text/html' href='http://git.josher.dev/rneovim.git/commit/?id=6abb48105135ce3ae7eda22334f8104c5ddf20ce'/>
<id>6abb48105135ce3ae7eda22334f8104c5ddf20ce</id>
<content type='text'>
Problem:
Since https://github.com/neovim/tree-sitter-vimdoc/commit/eba7b5b646546d9fed9b40b2c72b9cc0048f1dfa
any opening paren and its leading whitespace " (" are missing in the
generated HTML. Example:

    Use ":qa!&lt;Enter&gt;" (careful, all changes are lost!).
                     ^^missing
    Position the cursor on a tag (e.g. bars) and hit CTRL-].
                                ^^missing

Solution:
The main recursive loop only processes named children, so check
named_child_count() instead of child_count().  Then anonymous nodes
won't get lost.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Problem:
Since https://github.com/neovim/tree-sitter-vimdoc/commit/eba7b5b646546d9fed9b40b2c72b9cc0048f1dfa
any opening paren and its leading whitespace " (" are missing in the
generated HTML. Example:

    Use ":qa!&lt;Enter&gt;" (careful, all changes are lost!).
                     ^^missing
    Position the cursor on a tag (e.g. bars) and hit CTRL-].
                                ^^missing

Solution:
The main recursive loop only processes named children, so check
named_child_count() instead of child_count().  Then anonymous nodes
won't get lost.
</pre>
</div>
</content>
</entry>
<entry>
<title>feat(docs): nested lists in HTML, update :help parser</title>
<updated>2022-10-04T14:49:17+00:00</updated>
<author>
<name>Justin M. Keyes</name>
<email>justinkz@gmail.com</email>
</author>
<published>2022-09-29T11:46:44+00:00</published>
<link rel='alternate' type='text/html' href='http://git.josher.dev/rneovim.git/commit/?id=088abbeb6e6aecfc34b42db9b8d1396f493a2466'/>
<id>088abbeb6e6aecfc34b42db9b8d1396f493a2466</id>
<content type='text'>
- Docs HTML: improvements in https://github.com/neovim/tree-sitter-vimdoc
  allow us to many hacks in `gen_help_html.lua`.
- Docs HTML: support nested lists.
- Docs HTML: avoid extra newlines (too much whitespace) in old
  (preformatted) layout.
- Docs HTML: disable golden-grid for narrow viewport.
- Workaround for https://github.com/neovim/neovim/issues/20404

closes https://github.com/neovim/neovim/issues/20404
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
- Docs HTML: improvements in https://github.com/neovim/tree-sitter-vimdoc
  allow us to many hacks in `gen_help_html.lua`.
- Docs HTML: support nested lists.
- Docs HTML: avoid extra newlines (too much whitespace) in old
  (preformatted) layout.
- Docs HTML: disable golden-grid for narrow viewport.
- Workaround for https://github.com/neovim/neovim/issues/20404

closes https://github.com/neovim/neovim/issues/20404
</pre>
</div>
</content>
</entry>
<entry>
<title>feat(docs): fixes for :help HTML generator</title>
<updated>2022-09-29T11:26:12+00:00</updated>
<author>
<name>Justin M. Keyes</name>
<email>justinkz@gmail.com</email>
</author>
<published>2022-09-29T10:08:49+00:00</published>
<link rel='alternate' type='text/html' href='http://git.josher.dev/rneovim.git/commit/?id=563bc39aac10185a03e74faa8f992ce2d10f68e8'/>
<id>563bc39aac10185a03e74faa8f992ce2d10f68e8</id>
<content type='text'>
Generate correct leading whitespace for argument, taglink, tag, etc.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Generate correct leading whitespace for argument, taglink, tag, etc.
</pre>
</div>
</content>
</entry>
<entry>
<title>feat(gen_help_html.lua): adapt to new parser</title>
<updated>2022-09-28T16:34:20+00:00</updated>
<author>
<name>Justin M. Keyes</name>
<email>justinkz@gmail.com</email>
</author>
<published>2022-09-25T00:20:47+00:00</published>
<link rel='alternate' type='text/html' href='http://git.josher.dev/rneovim.git/commit/?id=16336c486ecb5a60e85a870904316308c7d7fc3f'/>
<id>16336c486ecb5a60e85a870904316308c7d7fc3f</id>
<content type='text'>
- adapt to parser changes from https://github.com/vigoux/tree-sitter-vimdoc/pull/16
- numerous other generator improvements
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
- adapt to parser changes from https://github.com/vigoux/tree-sitter-vimdoc/pull/16
- numerous other generator improvements
</pre>
</div>
</content>
</entry>
<entry>
<title>feat(gen_help_html.lua): put commit-id in footer</title>
<updated>2022-09-28T15:31:59+00:00</updated>
<author>
<name>Justin M. Keyes</name>
<email>justinkz@gmail.com</email>
</author>
<published>2022-09-23T12:26:59+00:00</published>
<link rel='alternate' type='text/html' href='http://git.josher.dev/rneovim.git/commit/?id=7b4c49888a97c21f346b8337330fbc8e196b9cf8'/>
<id>7b4c49888a97c21f346b8337330fbc8e196b9cf8</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
</feed>
