建设网站 莆田,珠海企业落户申请网站,医疗号网站开发,wordpress手机导航栏模板什么是 Raneto #xff1f; Raneto 是一个开源知识库平台#xff0c;它使用静态 Markdown 文件来支持您的知识库。 官方提供了 doc demo 网站#xff0c;即是帮助文档#xff0c;也是个 demo#xff0c;地址#xff1a;https://docs.raneto.com
准备
项目使用con…
什么是 Raneto Raneto 是一个开源知识库平台它使用静态 Markdown 文件来支持您的知识库。 官方提供了 doc demo 网站即是帮助文档也是个 demo地址https://docs.raneto.com
准备
项目使用config.js 做为设置文件该文件的源码地址https://raw.githubusercontent.com/ryanlelek/Raneto/master/config/config.js
记得用 UTF-8 编码格式保存因为你可能会用中文的标题等每次修改之后要重启容器才能生效 首先有几处需要修改的地方
修改站点标题
例如将site_title: Raneto Docs改成 site_title: 老苏的测试站点
修改用户名和密码
默认内置了 2 个用户建议修改 credentials: [{username: admin,password: password,},{username: admin2,password: password,},],修改语言使之支持中文
默认是英文 locale: en,// Support search with extra languagessearchExtraLanguages: [ru],老苏改为了 locale: zh,// Support search with extra languagessearchExtraLanguages: [zh],修改后的文件老苏放在了 https://github.com/wbsu2003/synology/blob/main/Raneto/config.js方便你需要的时候做对照
安装
在群晖上以 Docker 方式安装。
在注册表中搜索 raneto 下翻找到 raneto/raneto版本选择 latest。 卷
在 docker 文件夹中创建一个新文件夹 raneto并在其中建两个子文件夹 config 和 content将前面准备的 config.js 放入 config 目录 文件夹装载路径说明docker/raneto/config/opt/raneto/config存放设置文件docker/raneto/content/opt/raneto/content存放 markdown文件 端口
本地端口不冲突就行不确定的话可以用命令查一下
# 查看端口占用
netstat -tunlp | grep 端口号本地端口容器端口38443000 命令行安装
如果你熟悉命令行可能用 docker cli 更快捷
# 新建文件夹 raneto 和 子目录
mkdir -p /volume1/docker/raneto/{config,content/{pages,static}}# 进入 raneto 目录
cd /volume1/docker/raneto# 运行容器
docker run -d \--restart unless-stopped \--name raneto \-p 3844:3000 \-v $(pwd)/config:/opt/raneto/config \-v $(pwd)/content:/opt/raneto/content \raneto/raneto:latest也可以用 docker-compose 安装将下面的内容保存为 docker-compose.yml 文件
version: 2.1services:raneto:image: raneto/raneto:latestcontainer_name: ranetorestart: unless-stoppedports:- 3844:3000volumes:- ./config:/opt/raneto/config- ./content:/opt/raneto/content然后执行下面的命令
# 新建文件夹 raneto 和 子目录
mkdir -p /volume1/docker/raneto/{config,content/{pages,static}}# 进入 raneto 目录
cd /volume1/docker/raneto# 将 docker-compose.yml 放入当前目录# 一键启动
docker-compose up -d运行
在浏览器中输入 http://群晖IP:3844 就能看到主界面 点 login 用户密码正确的话会显示 登录成功后的主界面其实还是一样的只是在进入页面后会有编辑权限 接下来在 /content/pages 中放入 markdown 文件或者目录即可
页面排序
每个页面可以包含有关该页面的可选元数据。
Title - 此变量将覆盖基于文件名的标题Description - 此变量将提供要搜索的描述Sort - 此变量将影响类别内页面的排序ShowOnHome - 可选。如果为 false页面将不会在主页上列出。可以通过更改config.show_on_home_default调整默认行为Modified - 此变量将覆盖基于文件名的修改日期。
下面是一个示例的 markdown 文件文件名为 根目录2.md
---
Title: 根目录第二篇
Sort: 1
---根目录第二篇但显示为第一位所以显示效果是下面这样的 目录排序
目录显示出来实际上就是分类你可以在当前文件夹中增加一个名称为 meta 的文件
Title - 此变量将覆盖基于文件夹名称的标题Sort - 此变量将影响分类目录的排序ShowOnHome - 可选。如果为 false将不会显示在主页上。可以通过更改config.show_on_home_default 调整默认行为Description - 可选。该变量将提供在模板中使用的变量例如在主页中以增强和阐明类别的内容。
下面是一个示例的 meta 文件
Title: 安装使用
Sort: 1如果不需要变更分类名称可以更简单的提供一个 sort 文件文件中只要写排序就行
2展示效果
重启容器后的显示效果 点开进入 登录之后有编辑权限 注意事项
但凡文件中有中文的一定要用 UTF-8 编码格式保存否则页面上就会出现乱码切记切记~
参考文档 ryanlelek/Raneto: Markdown powered Knowledgebase Wiki for Node.js 地址https://github.com/ryanlelek/Raneto Raneto - Markdown Knowledgebase for Node.js 地址https://raneto.com/
