更改目录项的默认图标

Question

操作系统：Windows

使用的 DocFX 版本：2.56.1.0

使用的模板：default

我正在寻找一种方法来更改显示在目录项旁边的默认图标，该图标是一个“+”号，一旦展开列表项就会变成一个“-”号。我希望它是一个右箭头，在展开目录时旋转成向下箭头。我试图修改 docfx.css 文件，其中提到这个东西是这样的（使用 glyphicon-menu-right）：


.toc .nav > li.active > .expand-stub::before,
.toc .nav > li.in > .expand-stub::before,
.toc .nav > li.in.active > .expand-stub::before,
.toc .nav > li.filtered > .expand-stub::before  {
    content: "\e258";
    transition: transform .1s ease-in-out;
    transform: rotate(0deg);
}

.toc .nav > li > .expand-stub::before,
.toc .nav > li.active > .expand-stub::before  {
    content: "\e258";
}

但是图标没有出现在 docfx 站点中。我该怎么办？

Answer 1

我能够使用 default/styles/docfx.css 中的第 512-522 行成功更改它们：

.toc .nav > li.active > .expand-stub::before,
.toc .nav > li.in > .expand-stub::before,
.toc .nav > li.in.active > .expand-stub::before,
.toc .nav > li.filtered > .expand-stub::before {
    content: "x";
}

.toc .nav > li > .expand-stub::before,
.toc .nav > li.active > .expand-stub::before {
    content: "y";
}

理论上，您应该能够将此代码（经过您的调整）粘贴到 default/styles/main.css 中，它将覆盖 default/styles/docfx.css 中的默认值 CSS。

在我将 main.css 放入自定义模板之前，这对我不起作用，但这可能是我的特定配置，或者我缺乏理解：

从根目录，添加：template/styles/main.css

在docfx.json中添加template:

    "template": [
      "default",
      "template"
    ],

此外，确保在头部部分引用了所有字体（可能还需要添加到 template/partials/head.tmpl.partial）。

更改目录项的默认图标

Change the Default icon for the ToC Items

docfx