开源知识库平台Raneto

这篇具有很好参考价值的文章主要介绍了开源知识库平台Raneto。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

开源知识库平台Raneto,群晖,docker,笔记,markdown

什么是 Raneto ?

Raneto 是一个开源知识库平台,它使用静态 Markdown 文件来支持您的知识库。

官方提供了 doc & demo 网站,即是帮助文档,也是个 demo,地址:https://docs.raneto.com

准备

项目使用config.js 做为设置文件,该文件的源码地址:https://raw.githubusercontent.com/ryanlelek/Raneto/master/config/config.js

  • 记得用 UTF-8 编码格式保存,因为你可能会用中文的标题等;
  • 每次修改之后,要重启容器才能生效;

开源知识库平台Raneto,群晖,docker,笔记,markdown

首先有几处需要修改的地方:

  1. 修改站点标题

例如:将site_title: 'Raneto Docs'改成 site_title: '老苏的测试站点'

  1. 修改用户名和密码

默认内置了 2 个用户,建议修改

  credentials: [
    {
      username: 'admin',
      password: 'password',
    },
    {
      username: 'admin2',
      password: 'password',
    },
  ],
  1. 修改语言,使之支持中文

默认是英文

  locale: 'en',

  // Support search with extra languages
  searchExtraLanguages: ['ru'],

老苏改为了

  locale: 'zh',

  // Support search with extra languages
  searchExtraLanguages: ['zh'],

修改后的文件,老苏放在了 https://github.com/wbsu2003/synology/blob/main/Raneto/config.js,方便你需要的时候做对照

安装

在群晖上以 Docker 方式安装。

在注册表中搜索 raneto ,下翻找到 raneto/raneto,版本选择 latest

开源知识库平台Raneto,群晖,docker,笔记,markdown

docker 文件夹中,创建一个新文件夹 raneto,并在其中建两个子文件夹 configcontent,将前面准备的 config.js 放入 config 目录

开源知识库平台Raneto,群晖,docker,笔记,markdown

文件夹 装载路径 说明
docker/raneto/config /opt/raneto/config 存放设置文件
docker/raneto/content /opt/raneto/content 存放 markdown文件

开源知识库平台Raneto,群晖,docker,笔记,markdown

端口

本地端口不冲突就行,不确定的话可以用命令查一下

# 查看端口占用
netstat -tunlp | grep 端口号
本地端口 容器端口
3844 3000

开源知识库平台Raneto,群晖,docker,笔记,markdown

命令行安装

如果你熟悉命令行,可能用 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.1"

services:
  raneto:
    image: raneto/raneto:latest
    container_name: raneto
    restart: unless-stopped
    ports:
      - 3844:3000
    volumes:
      - ./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 就能看到主界面

开源知识库平台Raneto,群晖,docker,笔记,markdown

login

开源知识库平台Raneto,群晖,docker,笔记,markdown

用户密码正确的话,会显示

开源知识库平台Raneto,群晖,docker,笔记,markdown

登录成功后的主界面其实还是一样的,只是在进入页面后,会有编辑权限

开源知识库平台Raneto,群晖,docker,笔记,markdown

接下来在 /content/pages 中放入 markdown 文件或者目录即可

页面排序

每个页面可以包含有关该页面的可选元数据。

  • Title - 此变量将覆盖基于文件名的标题;
  • Description - 此变量将提供要搜索的描述;
  • Sort - 此变量将影响类别内页面的排序;
  • ShowOnHome - 可选。如果为 false,页面将不会在主页上列出。可以通过更改config.show_on_home_default调整默认行为;
  • Modified - 此变量将覆盖基于文件名的修改日期。

下面是一个示例的 markdown 文件,文件名为 根目录2.md

---
Title: 根目录第二篇
Sort: 1
---

根目录第二篇,但显示为第一位;

所以显示效果是下面👇这样的

开源知识库平台Raneto,群晖,docker,笔记,markdown

目录排序

目录显示出来实际上就是分类,你可以在当前文件夹中增加一个名称为 meta 的文件

  • Title - 此变量将覆盖基于文件夹名称的标题;
  • Sort - 此变量将影响分类(目录)的排序;
  • ShowOnHome - 可选。如果为 false,将不会显示在主页上。可以通过更改config.show_on_home_default 调整默认行为;
  • Description - 可选。该变量将提供在模板中使用的变量,例如在主页中,以增强和阐明类别的内容。

下面是一个示例的 meta 文件

Title: 安装使用
Sort: 1

开源知识库平台Raneto,群晖,docker,笔记,markdown

如果不需要变更分类名称,可以更简单的提供一个 sort 文件,文件中只要写排序就行

2

开源知识库平台Raneto,群晖,docker,笔记,markdown

展示效果

重启容器后的显示效果

开源知识库平台Raneto,群晖,docker,笔记,markdown

点开进入

开源知识库平台Raneto,群晖,docker,笔记,markdown

登录之后有编辑权限

开源知识库平台Raneto,群晖,docker,笔记,markdown

注意事项

但凡文件中有中文的,一定要用 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/文章来源地址https://www.toymoban.com/news/detail-702278.html

到了这里,关于开源知识库平台Raneto的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • 智能AI知识库,增强AI知识的开源项目

    FastWiki是一个高性能、基于最新技术栈的知识库系统,旨在为大规模信息检索和智能搜索提供解决方案。它采用微软Semantic Kernel进行深度学习和自然语言处理,在后端使用 MasaFramework ,前端采用 MasaBlazor 框架,实现了一个高效、易用、可扩展的智能向量搜索平台。其目标是帮

    2024年03月09日
    浏览(57)
  • wiki.js一个开源知识库系统

    wiki.js是一个开源Wiki应用程序,官网介绍为: A modern, lightweight and powerful wiki app built on NodeJS 访问Github:github 访问Wike:js.wiki 开源知识库平台,和语雀有一样的功能,独立部署; wiki支持权限管理、用户管理,可使用markdown格式编辑; wiki的部署推荐使用postgres9.5以上版本作为存

    2024年02月04日
    浏览(51)
  • LangChain-Chatchat 开源知识库来了

    LangChain-Chatchat 是基于 ChatGLM 等大语言模型与 LangChain 等应用框架实现,开源、可离线部署的 RAG 检索增强生成大模型知识库项目。最新版本为 v0.2.10,目前已收获 26.7k Stars,非常不错的一个开源知识库项目。 项目地址:https://github.com/chatchat-space/Langchain-Chatchat 顾名思义,LangC

    2024年04月17日
    浏览(47)
  • Baklib知识库搭建平台产品操作手册

    Baklib是一款专业的知识库搭建平台,它帮助客户搭建内部知识库和对外帮助中心。在今天的信息时代,知识已经成为组织的核心竞争力,而Baklib正是为了帮助组织构建完整的知识体系,提高组织的核心竞争力而生。 Baklib具有以下特点: 快速建站:使用Baklib可以快速搭建一个

    2024年02月03日
    浏览(41)
  • 开源知识库软件xwiki在Windows下的安装

    xwiki是java语言开发的开源知识库 开源知识库软件-xwiki在windows下的安装:基本参考这个安装即可。 XWiKi 部分汉化 1.1、Windows版本及系统配置 Windows10专业版,32GB内存 1.2、JDK11安装 1、xwiki15版本要求至少JDK11。 2、到oracle官网系在JDK11安装。 3、Java11安装以后在Windows的环境变量里配

    2024年02月04日
    浏览(40)
  • AnythingLLM:基于RAG方案构专属私有知识库(开源|高效|可定制)

    继OpenAI和Google的产品发布会之后,大模型的能力进化速度之快令人惊叹,然而,对于很多个人和企业而言,为了数据安全不得不考虑私有化部署方案,从GPT-4发布以来,国内外的大模型就拉开了很明显的差距,能够实现的此路径无非就只剩下国内的开源大模型可以选择了。而

    2024年02月04日
    浏览(59)
  • Quivr 基于GPT和开源LLMs构建本地知识库 (更新篇)

    自从大模型被炒的越来越火之后,似乎国内涌现出很多希望基于大模型构建本地知识库的需求,大概在5月底的时候,当时Quivr发布了第一个0.0.1版本,第一个版本仅仅只是使用LangChain技术结合OpenAI的GPT模型实现了一个最基本的架子,功能并不够完善,但可以研究研究思路,当

    2024年02月12日
    浏览(49)
  • 渗透工具及其知识库(个人笔记)

    查看kali网段:      ip addr 、 ifconfig namp: nmap -sP xxx.xxx.xxx.0/24 netdiscover: netdiscover  xxx.xxx.xxx.0/24 arp: arp-scan -l 粗略扫描: nmap IP 深度扫描: nmap -A -p- IP nmap -T4 -A -v IP whatweb url cmseek -u url gobuster dir -u url -w /usr/share/wordlists/dirbuster/directory-list-2.3-medium.txt -x .php,.html,.sh,.txt -b \\\'40

    2024年04月15日
    浏览(35)
  • 使用Docker部署wikitten个人知识库

    Wikitten是一款开源Wiki知识管理系统,使用PHP开发,支持Markdown语法,无需数据库,自动生成树形目录,适合用来做个人Wiki知识库。 Wikitten 是一个小巧、快速的 PHP wiki。 Wikitten是存储您的笔记、代码片段、想法等的完美场所。 Wikitten是一款开源Wiki知识管理系统。 支持Markdown语

    2024年02月14日
    浏览(37)
  • Wiki知识库项目-全流程笔记

    2.2.1修改springboot的版本号为           2.4.0 2.2.3将代码交给git进行管理 2-5修改日志样式 2.5.1将springboot项目打印日志样式进行修改。创建logback-spring.xml文件夹,文件与application.xml文件位置并列。 2.5.2修改启动项 错误请求 请求码,405-请求方法不对,get、post方式不对  将启动类

    2024年02月14日
    浏览(36)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包