更改ToC项目的默认图标

问题描述

操作系统：Windows

使用的DocFX版本：2.56.1.0

使用的模板：default

我正在寻找一种方法来更改显示在toc项旁边的默认图标，该图标是“ +”号，并且在扩展列表项后变成了“-”号。我希望它是向右箭头，在扩展toc时旋转为向下箭头。我试图修改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站点中。我该怎么办？

解决方法

我能够使用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中）。