dita-task-contents

To add missing Procedure titles for DITA conversion, use a script that identifies procedure modules via the `_mod-docs-content-type: PROCEDURE` attribute and inserts the `.Procedure` block title before the first ordered list. It handles prerequisites and avoids code blocks.

DITA conversion fails when AsciiDoc procedure modules lack the `.Procedure` block title because the DITA task elements require this specific marker to map steps correctly. Adding the `.Procedure` title before the ordered list ensures seamless DITA compatibility.

Yes, you need a Ruby interpreter installed in your environment to execute the `task_contents.rb` script that automatically adds missing `.Procedure` block titles to your AsciiDoc files for DITA compatibility.

Yes, you can automatically fix AsciiDoc procedure modules by running a script that detects the `:_mod-docs-content-type: PROCEDURE` attribute and inserts the `.Procedure` title before the first ordered list, preparing the files for DITA conversion.

The best way to prepare AsciiDoc procedure content for DITA task elements is to ensure every procedure module contains a `.Procedure` block title before the ordered list, which can be automatically inserted by scanning for the `PROCEDURE` content type attribute.