标签: docsify

我正在使用docsifyjs创建文档。但我想添加身份验证来访问文档。

基本上我们使用以下命令提供文档

初始化文档化

docsify init ./docs

init 完成后，可以在 ./docs 子目录中看到文件列表。

index.htmlas the entry file README.mdas the home page .nojekyll防止GitHub Pages忽略以下划线开头的文件

我们现在可以使用以下命令将降价文件作为 HTML 提供。

docsify serve docs

或者

cd docs && python -m SimpleHTTPServer 3000

或者

npx http-server docs

这里 docsify 通过给出初始化目录的路径来提供服务。

但我无法弄清楚如何使用expressJS提供此服务。这样我就可以添加身份验证。我尝试将app.js添加到./docs并添加以下代码，但未呈现降价文件。

var express = require('express');
var path = require('path');
var serveStatic = require('serve-static');

var app = express();

app.use(serveStatic('/', { 'index': ['index.html', 'index.htm'] }));
app.get('/', (req, res) => { …

我正在使用 Docsify 来提供有关我的项目的文档。对于语法突出显示，我想使用 prism.js。遗憾的是，突出显示部分不起作用。我也尝试了这里提到的所有建议。

在我的 index.html 中，我已经<script src="//unpkg.com/prismjs/components/prism-ruby.js"></script>包含了，如 docsify 提到的here。在我的file.md地方，我想展示一些 Ruby 代码：

<pre><code class="language-ruby">
  def hello(name)
    p "Hello #{name}"
  end
</code></pre>

但 Ruby 代码并未突出显示。

正在渲染的 HTML：

<pre><code class="language-ruby">
  def hello(name)
    p "Hello #{name}"
  end
</code></pre>

我在这里缺少什么？

这是我的 md 文件的示例

%%{init: {\'securityLevel\': \'loose\', \'theme\': \'base\', \'themeVariables\': { \'darkMode\': false, \'primaryColor\': \'#ffaacc\', \'fontSize\': \'14px\', \'lineColoe\': \'#0404ff\', \'edgeLabelBackground\':\'#ffffaa\'}}}%%\ngraph LR\n    id0[\xe7\x9a\x87\xe9\xa9\xac]o==>id2[\xe5\xaf\xb9]o-->id3[\xe5\xa5\xa5\xe5\xb0\xbc\xe5\xb0\x94]-->id4[\xe4\xb8\x8d]-->id5[\xe6\x84\x9f]-->id6[\xe5\x85\xb4\xe8\xb6\xa3]\n

上述文件应用于docsify服务器。而index.html中对应的js配置是这样的：

  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.min.css">\n  <script src="https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.min.js"></script>\n\n

和

var num = 0;\n    mermaid.initialize({ startOnLoad: false });\n\n    window.$docsify = {\n      name: \'\',\n      repo: \'\',\n      el: \'#app\',\n      maxLevel: 6,\n      loadNavbar: true,\n      loadSidebar: \'summary.md\',\n      themeable: {\n        readyTransition: true, // default\n        responsiveTables: true  // default\n      },\n      markdown: {\n        renderer: {\n          code: function (code, lang) {\n            if (lang === "mermaid") …