Comment Divider 0.4.0

Comment Divider：提升代码可读性的Visual Studio Code扩展

Comment Divider是一款专为Visual Studio Code设计的扩展工具，旨在通过生成注释包装的分隔符，帮助开发者提升代码的结构化和可读性。无论您使用何种编程语言，都能从中受益。

安装指南：

立即从Visual Studio Code Marketplace下载安装：

https://marketplace.visualstudio.com/items?itemName=stackbreak.comment-divider

功能演示：

命令列表：

创建主标题

• 默认快捷键：Shift Alt X
• 默认样式：

/* -------------------------------------------------------------------------- */
/*                                Example text                                */
/* -------------------------------------------------------------------------- */

创建子标题

• 默认快捷键：Alt X
• 默认样式：

/* ------------------------------ Example text ------------------------------ */

插入实线

• 默认快捷键：Alt Y
• 默认样式：

/* -------------------------------------------------------------------------- */

语言支持：

Comment Divider支持所有常见语言，并使用相应的注释字符。例如，在Python文件中，子标题样式如下：

# ------------------------------ python example ------------------------------ #

在HTML文件中：

<!-- ---------------------------- html example ----------------------------- -->

您也可以轻松添加对未支持语言的支持，或覆盖默认预设。

默认配置：

通用配置

  // 设置所有分隔符的行长度。
  "comment-divider.length": 80,

  // 设置分隔符是否应考虑缩进大小进行缩小，或者始终保持固定长度。
  "comment-divider.shouldLengthIncludeIndent": false,

• 如果shouldLengthIncludeIndent为false：

/* --------------------------------- indent0 -------------------------------- */
/* --------------------------------- indent1 -------------------------------- */

    /* --------------------------------- indent2 -------------------------------- */</code></pre><ul><li><strong>如果shouldLengthIncludeIndent为true：</strong></li></ul><pre><code>/* --------------------------------- indent0 -------------------------------- */

/* ------------------------------- indent1 ------------------------------ */

    /* ----------------------------- indent2 ---------------------------- */</code></pre><h3>主标题配置</h3><pre><code>  // 设置主标题线填充符号（仅一个）。
"comment-divider.mainHeaderFiller": "-",
// 设置主标题垂直样式。
"comment-divider.mainHeaderHeight": "block",
// 设置主标题文本对齐方式。
"comment-divider.mainHeaderAlign": "center",
// 设置主标题文本转换样式。
"comment-divider.mainHeaderTransform": "none",

子标题配置

  // 设置子标题线填充符号（仅一个）。
"comment-divider.subheaderFiller": "-",
// 设置子标题垂直样式。
"comment-divider.subheaderHeight": "line",
// 设置子标题文本对齐方式。
"comment-divider.subheaderAlign": "center",
// 设置子标题文本转换样式。
"comment-divider.subheaderTransform": "none",

实线配置

  // 设置实线填充符号。
"comment-divider.lineFiller": "-",

语言配置：

如果某些语言未被默认支持，或者您想更改已支持语言的默认注释字符，可以在设置中进行调整。

"comment-divider.languagesMap": {
"toml": ["#", "#"],
"scss": ["//"]
}

项目名称是语言模式名称，与一个包含1或2个元素的数组相关联。第一个元素是行的开始。第二个元素，如果定义了，是行的结束。

以上示例定义了适用于toml的正确字符，并覆盖了scss的默认设置。结果，这些语言的子标题如下所示：

# ------------------------------ toml subheader ------------------------------ #

// ----------------------------- scss subheader --------------------------------

问题反馈：

请使用GitHub请求新功能并报告错误。