用途:在 TutorialKit 中组织交互式 Ruby on Rails 教程内容,把教程拆分为 Part、Chapter、Lesson 层级。
主要能力:内容层级为 Tutorial > Parts > Chapters > Lessons,可跳过层级,支持 Parts > Chapters > Lessons、Parts > Lessons 或仅 Lessons。目录位于 src/content/tutorial/,用数字前缀控制顺序(如 1-basics/),数字后文本成为 URL slug,使用 kebab-case。也可在 meta.md 中用 parts、lessons 显式排序,此时文件夹无需数字前缀。
元数据:根 meta.md 设 type: tutorial 并定义继承默认值,如 prepareCommands、terminalBlockingPrepareCommandsCount、previews、filesystem.watch、terminal 面板。Part 和 Chapter 各有 meta.md(type: part / chapter),可覆盖教程默认配置。Lesson 目录含 content.md,frontmatter 设 type: lesson、title、editor、custom 等,正文用标准 Markdown。
Markdown 特性:支持 tip、info、warn、danger、success 标注框,可加 title、noBorder、hideTitle、hideIcon、class 属性;支持 file: 与 solution: 代码块导入;代码块支持 title、showLineNumbers、ins、del、行高亮、collapse、frame 等属性;Rails 路径(app/、db/、config/、test/)自动转为可点击链接;支持标准链接与 MDX(content.mdx)。
样式:rails-app 模板提供 BEM 组件与 CSS 自定义属性,ERB 视图可用 btn、card、badge、table、page-header、form__group、input、text-muted、inline-actions 等类,flash 消息由布局自动处理。
限制:资料未提供安装命令、收费、平台与效果信息;完整 CSS 变量与组件列表需参考 tutorial-quickstart 技能。