时间戳

首页 > 解决方案 > 更改 ToC 项的默认图标

docfx - 更改 ToC 项的默认图标

问题描述

操作系统：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 站点中。我应该怎么做？

标签： docfx

解决方案

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

.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，并且它将覆盖 中的默认 CSS default/styles/docfx.css。

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

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

在 docfx.json 中，添加template：

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

此外，请确保在 head partial 中引用了任何字体（可能还需要添加到template/partials/head.tmpl.partial）。

推荐阅读