Project

General

Profile

Actions

Bug #21201

closed

Documentation build fails on Debian 12 after Ruby 3 migration

Added by Brett Smith 8 months ago. Updated 3 months ago.

Status:
Resolved
Priority:
Normal
Assigned To:
Category:
Documentation
Story points:
0.5
Release:
Release relationship:
Auto

Description

I am running on Debian 12 and have run arvados-server install -type test as of main at 7bc4217495b405c98ea4cad8178b8136383486cf. When I try to build the documentation, I get the following error:

Rendering .site/sdk/R/index.html
rake aborted!
Kramdown::Error: Unknown parser: codeblock
/home/brett/.local/lib/rubygems/gems/kramdown-1.17.0/lib/kramdown/parser/kramdown.rb:126:in `block in configure_parser'
/home/brett/.local/lib/rubygems/gems/kramdown-1.17.0/lib/kramdown/parser/kramdown.rb:122:in `each'
/home/brett/.local/lib/rubygems/gems/kramdown-1.17.0/lib/kramdown/parser/kramdown.rb:122:in `configure_parser'
/home/brett/.local/lib/rubygems/gems/kramdown-1.17.0/lib/kramdown/parser/kramdown.rb:88:in `parse'
/home/brett/.local/lib/rubygems/gems/kramdown-1.17.0/lib/kramdown/parser/base.rb:69:in `parse'
/home/brett/.local/lib/rubygems/gems/kramdown-1.17.0/lib/kramdown/document.rb:104:in `initialize'
/home/brett/.local/lib/rubygems/gems/zenweb-3.10.6/lib/zenweb/plugins/markdown.rb:42:in `new'
/home/brett/.local/lib/rubygems/gems/zenweb-3.10.6/lib/zenweb/plugins/markdown.rb:42:in `markdown'
/home/brett/.local/lib/rubygems/gems/zenweb-3.10.6/lib/zenweb/plugins/markdown.rb:18:in `render_md'
/home/brett/.local/lib/rubygems/gems/zenweb-3.10.6/lib/zenweb/page.rb:387:in `block in subrender'
/home/brett/.local/lib/rubygems/gems/zenweb-3.10.6/lib/zenweb/page.rb:386:in `each'
/home/brett/.local/lib/rubygems/gems/zenweb-3.10.6/lib/zenweb/page.rb:386:in `inject'
/home/brett/.local/lib/rubygems/gems/zenweb-3.10.6/lib/zenweb/page.rb:386:in `subrender'
/home/brett/.local/lib/rubygems/gems/zenweb-3.10.6/lib/zenweb/page.rb:360:in `render'
/home/brett/.local/lib/rubygems/gems/zenweb-3.10.6/lib/zenweb/page.rb:271:in `generate'
/home/brett/.local/lib/rubygems/gems/zenweb-3.10.6/lib/zenweb/page.rb:482:in `block in wire'
/home/brett/.local/lib/rubygems/gems/zenweb-3.10.6/lib/zenweb/site.rb:103:in `generate'
/home/brett/.local/lib/rubygems/gems/zenweb-3.10.6/lib/zenweb/tasks.rake:21:in `block in <top (required)>'
/home/brett/.gem/ruby/3.2.0/gems/rake-13.0.6/exe/rake:27:in `<top (required)>'
/home/brett/.local/lib/rubygems/gems/bundler-2.1.4/lib/bundler/cli/exec.rb:63:in `load'
/home/brett/.local/lib/rubygems/gems/bundler-2.1.4/lib/bundler/cli/exec.rb:63:in `kernel_load'
/home/brett/.local/lib/rubygems/gems/bundler-2.1.4/lib/bundler/cli/exec.rb:28:in `run'
/home/brett/.local/lib/rubygems/gems/bundler-2.1.4/lib/bundler/cli.rb:476:in `exec'
/home/brett/.local/lib/rubygems/gems/bundler-2.1.4/lib/bundler/vendor/thor/lib/thor/command.rb:27:in `run'
/home/brett/.local/lib/rubygems/gems/bundler-2.1.4/lib/bundler/vendor/thor/lib/thor/invocation.rb:127:in `invoke_command'
/home/brett/.local/lib/rubygems/gems/bundler-2.1.4/lib/bundler/vendor/thor/lib/thor.rb:399:in `dispatch'
/home/brett/.local/lib/rubygems/gems/bundler-2.1.4/lib/bundler/cli.rb:30:in `dispatch'
/home/brett/.local/lib/rubygems/gems/bundler-2.1.4/lib/bundler/vendor/thor/lib/thor/base.rb:476:in `start'
/home/brett/.local/lib/rubygems/gems/bundler-2.1.4/lib/bundler/cli.rb:24:in `start'
/home/brett/.local/lib/rubygems/gems/bundler-2.1.4/exe/bundle:46:in `block in <top (required)>'
/home/brett/.local/lib/rubygems/gems/bundler-2.1.4/lib/bundler/friendly_errors.rb:123:in `with_friendly_errors'
/home/brett/.local/lib/rubygems/gems/bundler-2.1.4/exe/bundle:34:in `<top (required)>'
/opt/arvados/bin/bundle:25:in `load'
/opt/arvados/bin/bundle:25:in `<main>'
Tasks: TOP => site => .site/index.html => .site/sdk/index.html => .site/sdk/R/index.html
(See full trace by running task with --trace)

Since this error is in the R SDK docs, I tried with NO_SDK=1, but that just moves the problem:

Rendering .site/user/cwl/arvados-vscode-training.html          
rake aborted!                                                                                                                                                                
Kramdown::Error: Unknown parser: codeblock                  
[same stack trace omitted]
Tasks: TOP => site => .site/index.html => .site/user/index.html => .site/user/cwl/arvados-vscode-training.html
(See full trace by running task with --trace)

For what it's worth, I also get these warnings at the start of the run:

Calling `DidYouMean::SPELL_CHECKERS.merge!(error_name => spell_checker)' has been deprecated. Please call `DidYouMean.correct_error(error_name, spell_checker)' instead.     
zenweb-fix-body.rb:4: warning: already initialized constant ZenwebTextile::VERSION                                                                                           
zenweb-textile.rb:8: warning: previous definition of VERSION was here                                                                                                        

Files

Gemfile.lock (780 Bytes) Gemfile.lock for Ruby 3.2.2 on 2023-11-19 Brett Smith, 11/20/2023 03:24 AM

Subtasks 1 (0 open1 closed)

Task #21203: Review 21201-doc-bundle-updateResolvedBrett Smith11/20/2023Actions
Actions

Also available in: Atom PDF