Docsify文档的基本flask实现
我偶然发现了Docsify (https://docsify.js.org/#/)，并对它进行了有趣的实验。我对使用我自己的flask服务器提供一些文档很感兴趣，而不是使用Github页面或节点，但是我不知道如何实现它。
正如Docsify (https://docsify.js.org/#/quickstart?id=manual-initialization)所描述的，在本地提供一个简单的index.html来呈现并将README.md作为标记内容工作得很好。
index.html
<!-- index.html -->
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta charset="UTF-8">
<link rel="stylesheet" href="//unpkg.com/docsify/themes/vue.css">
</head>
<body>
<div id="app"></div>
<script>
window.$docsify = {
//...
}
</script>
<script src="//unpkg.com/docsify/lib/docsify.min.js"></script>
</body>
</html>README.md
# Hi, I'm markdown content运行静态服务器的命令行(works)：
python -m SimpleHTTPServer 3000现在，在Flask中，我使用了应用程序工厂+蓝图模式，就flask而言，一切都像预期的那样工作。我可以添加一个新的端点，它呈现得很好。我的文件结构：
├── instance
│ └── flask.cfg
├── main.py
├── project
│ ├── __init__.py
│ ├── front
│ │ ├── __init__.py
│ │ ├── routes.py
│ │ └── templates
│ │ └── front
│ │ └── index.html
│ ├── documentation
│ │ ├── __init__.py
│ │ ├── routes.py
│ │ └── templates
│ │ └── documentation
│ │ ├── README.md
│ │ └── index.html
│ ├── static
│ │ ├── favicon.ico
│ │ └── style.css
│ └── templates
│ └── base.html
└── requirements.txt在project -> documentation -> documentation文件夹中，我在与上面的Docsify示例相同的级别添加了一个README.md，它在本地得到了很好的服务。
index.html通过flask加载(仔细查看，你会看到侧边栏和汉堡包菜单按钮)，但标记内容没有，我得到'404 -找不到‘的消息。
我根本不知道如何实现它，更不用说如何优雅地实现它了。
回答 2
Stack Overflow用户
发布于 2019-10-14 19:07:51
下面是我要做的：
location /doc/ {
index index.html;
root /www/api/templates;
}然后你可以像我一样在/doc上访问你的文档：enter image description here
这是我的网站展望(用纯超文本标记语言写的)：enter image description here
Stack Overflow用户
发布于 2019-11-17 22:00:53
如果你在站点的根目录(即本地开发3000：localhost:3000/)提供index.html，docsify将尝试从同一级别开始获取所有其他文件。在您的例子中，它期望在这个端点localhost:3000/README.md上找到README.md。
您可以执行以下操作：
- 在您的flask服务器(如
/documentation)中创建一个路由，为documentation文件夹中的所有文件提供服务。这样，您将在docsify配置文件中的/documentation/README.md - add中获得
README.md文件basePath属性(https://docsify.js.org/#/configuration?id=basepath)：basePath: '/documentation/'
通过这种方式，您应该能够从路由/documentation/*访问所有.md文件，并且docsify将成功地呈现它们。
https://stackoverflow.com/questions/56406960
复制相似问题
腾讯云开发者
Copyright © 2013 - 2026 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有
深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 
粤公网安备44030502008569号
腾讯云计算（北京）有限责任公司 京ICP证150476号 | 京ICP备11018762号