Move Zakim and RRSAgent docs to the Guidebook and migrate them to Markdown

[vivienlacourba]

Previous location:

• https://www.w3.org/2001/12/zakim-irc-bot.html
• https://www.w3.org/2002/03/RRSAgent.html

[deniak]

To limit the TOC level on the zakim page, we would need to use a different _config.yml as this is the only place the jekyll-toc plugin can be configured.
The idea would be to introduced a copy of _config.yml, e.g. _config-zakim.yml, and just change the toc.max_level.
This way, we could run the generation a first time with a lower TOC level:

bundle exec jekyll build --config _config-zakim.yml

then, in _config.yml, we would need to skip the generation of the zakim document:

exclude: ["README.md", "**/README.md", "meetings/zakim.md"]
keep_files: ["meetings/zakim.html"]

Finally, when you regenerate the whole site, it'll keep the previous version of the zakim document.

bundle exec jekyll build

[vivienlacourba]

To limit the TOC level on the zakim page, we would need to use a different _config.yml as this is the only place the jekyll-toc plugin can be configured. The idea would be to introduced a copy of _config.yml, e.g. _config-zakim.yml, and just change the toc.max_level. This way, we could run the generation a first time with a lower TOC level:

bundle exec jekyll build --config _config-zakim.yml

then, in _config.yml, we would need to skip the generation of the zakim document:

exclude: ["README.md", "**/README.md", "meetings/zakim.md"]
keep_files: ["meetings/zakim.html"]

Finally, when you regenerate the whole site, it'll keep the previous version of the zakim document.

bundle exec jekyll build

Discussing with @deniak, this solution seems too complex.

As a workaround we used CSS to hide secondary headings, see commit 3a77a53.

A proper solution would be to add this option to the jekyll-toc plugin or switch to another plugin, as this feature which was requested by several people:

• How to adjust the size of toc toshimaru/jekyll-toc#155
• [Help] - TOC level change for a specific post toshimaru/jekyll-toc#149
• Customize automatically generated TOC on jekyll  toshimaru/jekyll-toc#120

[TallTed]

Prettification, punctuation fixes, etc.

[vivienlacourba]

@swickr I first thought that first-last was a typo instead of first|last (first or last), but testing the RRSAgent search command I could not get any of those combinations working.

See my tests in: https://www.w3.org/2025/01/24-vivtest-irc