styledown 包 - src.elv.sh/ pkg/ui/styledown - Go 包

主要观点:Styledown 是用于表示样式文本的简单标记语言,基本形式为交替的文本行和样式行,每个样式行的字符指定上方字符的样式,可通过配置 stanza 改变两方面,可作为 Go 库或通过 Elvish 的命令使用;双宽度字符需样式字符加倍;配置 stanza 可定义额外样式字符及选项,如 no-eol 抑制最后一行换行;Styledown 适合创作大量样式文本,能保留文本对齐,适用于终端模拟和 Elvish 测试;介绍了相关函数如 Derender 和 Render 及它们的作用和错误情况。
关键信息:

  • 基本形式:文本行和样式行交替,样式行字符指定上方字符样式。
  • 双宽度字符:需样式字符加倍,两样式字符需相同。
  • 配置 stanza:可定义额外样式字符和选项,如 no-eol。
  • 用途:适合创作样式文本,用于终端模拟和 Elvish 测试。
  • 函数:Derender 转换 Text 为 Styledown 标记,Render 渲染 Styledown 标记,有错误情况说明。
    重要细节:
  • 样式字符定义在BuiltinStyleChars
  • 配置 stanza 每行由样式字符和样式组成,字符为单个 Unicode 码点且视觉宽度为 1。
  • Render 若标记有解析错误,错误以“line x”开头,x 为行号。
阅读 54
0 条评论