做网站开发多少钱,网络建设合同,电影网站开发库表结构,松原网站推广文章目录 一、Raneto介绍1.1 Raneto简介1.2 知识库介绍 二、阿里云环境2.1 环境规划2.2 部署介绍 三、环境检查3.1 检查Docker服务状态3.2 检查Docker版本3.3 检查docker compose 版本 四、下载Raneto镜像五、部署Raneto知识库平台5.1 创建挂载目录5.2 编辑config.js文件5.3 编… 文章目录 一、Raneto介绍1.1 Raneto简介1.2 知识库介绍 二、阿里云环境2.1 环境规划2.2 部署介绍 三、环境检查3.1 检查Docker服务状态3.2 检查Docker版本3.3 检查docker compose 版本 四、下载Raneto镜像五、部署Raneto知识库平台5.1 创建挂载目录5.2 编辑config.js文件5.3 编辑docker-compose.yaml文件5.4 创建raneto容器5.5 检查raneto容器状态5.6 检查raneto容器日志 六、Raneto的基本使用6.1 访问Raneto首页6.2 登录Raneto6.3 上传文档6.4 新建页面目录 七、总结 一、Raneto介绍
1.1 Raneto简介 Raneto是一个免费、开放、简单的 Markdown 支持的 Node.js 知识库。 1.2 知识库介绍
知识库 知识库是指存储和组织知识的系统或库它包括了各种类型的信息和知识如文本、图像、音频、视频等。知识库可以用于存储和检索知识帮助人们获取特定领域的知识和解决问题。知识库通常由专业人员创建和维护他们通过收集和整理各种资源和信息来构建一个完整的知识库。知识库可以包含大量的知识和信息涵盖多个领域和主题。知识库可以用于多种用途例如教育、研究、咨询等。它可以为学生提供学习资料和参考文献为研究人员提供相关领域的最新研究成果为咨询师提供解决问题的指导。知识库的优势在于它能够集中存储和组织大量的知识和信息使其易于访问和使用。此外知识库还可以通过搜索和过滤功能来帮助用户快速找到所需的知识和信息。 知识库工具 知识库工具是一种用于收集、组织、存储和检索知识的软件工具。它们提供了一个集中的平台可以方便地创建、记录和共享知识以便团队成员或用户可以随时访问和使用。 二、阿里云环境
2.1 环境规划
hostnameIP地址操作系统版本Docker版本tigerhhzz0139.99.151.123Alibaba Cloud Linux release 324.0.7
2.2 部署介绍
本次部署环境为个人阿里云生产环境
服务器上配置好Docker环境确保Docker环境正常
在Docker环境下部署Raneto知识库平台。
三、环境检查
3.1 检查Docker服务状态
检查Docker服务是否正常运行确保Docker正常运行。
systemctl status docker 3.2 检查Docker版本
检查Docker版本
docker -v 3.3 检查docker compose 版本
检查Docker compose版本确保2.0以上版本。
docker compose version 四、下载Raneto镜像
从docker hub拉取Raneto镜像版本为latest镜像。如果镜像拉取缓慢则可以配置国内云厂商的容器镜像加速提高下载速度。
docker pull raneto/raneto:latest 五、部署Raneto知识库平台
5.1 创建挂载目录
创建挂载目录/data/raneto/
mkdir -p /data/raneto/{config,content} cd /data/raneto 设置目录权限
chmod -R 777 /data/raneto 5.2 编辑config.js文件
Raneto的配置文件为config.js在我们新建 /data/raneto/config目录下编辑config.js文件。
// Modules
var path require(path);// Which Theme to Use?
//
// Local Directory Example (for development or custom themes)
// var theme_dir path.join(__dirname, themes);
// var theme_name my-theme-directory;
//
// Themes from NPM
// use dist as the theme name for modules (for now)
var theme_dir path.join(__dirname,..,node_modules,raneto/theme-default
);
var theme_name dist;var config {// Your site title (format: page_title - site_title)site_title: 我的知识库-站点,// The base URL of your site (can use %base_url% in Markdown files)// This should be the full path to your Raneto installation:// example 1: https://raneto.mydomain.com// example 2: https://www.mydomain.com/raneto// Do not include a trailing /// Leave this as an empty string to use the defaultbase_url: ,nowrap: true,// Path Prefix// If you are running Raneto on a subpath of your domain, add it here// Leave it blank if you are not sure//// Example: if you are running Raneto at http://www.mydomain.com/raneto// then you would enter /raneto belowpath_prefix: ,// Used for the Get in touch page footer linksupport_email: ,// Footer Text / Copyrightcopyright: Copyright copy; ${new Date().getFullYear()} - a hrefhttps://raneto.comPowered by Raneto/a,// Excerpt length (used in search)excerpt_length: 400,// The meta value by which to sort pages (value should be an integer)// If this option is blank pages will be sorted alphabeticallypage_sort_meta: sort,// Should categories be sorted numerically (true) or alphabetically (false)// If true category folders need to contain a sort file with an integer valuecategory_sort: true,// Controls behavior of home page if meta ShowOnHome is not present. If set to true// all categories or files that do not specify ShowOnHome meta property will be shownshow_on_home_default: true,// Theme (see top of file)theme_dir,theme_name,// Specify the path of your content folder where all your .md files are located// Fix: Cannot be an absolute pathcontent_dir: path.join(__dirname, .., content, pages),// Where is the public directory or document root?public_dir: path.join(theme_dir, theme_name, public),// The base URL of your images folder,// Relative to config.public_dir// (can use %image_url% in Markdown files)image_url: /images,// Add your analytics tracking code (including script tags)analytics: ,// Set to true to enable the web editorallow_editing: true,// Set to true to enable HTTP Basic Authenticationauthentication: true,// If editing is enabled, set this to true to only authenticate for editing, not for viewingauthentication_for_edit: true,// If authentication is enabled, set this to true to enable authentication for reading tooauthentication_for_read: false,// Google OAuthgoogleoauth: false,google_group_restriction: {enabled: false,api_key: GOOGLE_API_KEY,group_name: GOOGLE_GROUP_NAME,},oauth2: {client_id: GOOGLE_CLIENT_ID,client_secret: GOOGLE_CLIENT_SECRET,callback: http://localhost:3000/auth/google/callback,hostedDomain: google.com,},secret: someCoolSecretRightHere,// ##### WARNING #####// You MUST change the username and password for security// Do NOT use admin as a username as its easily guessed.// You are encouraged to use tools to generate a password// Preferably, use a local password manager// If you absolutely must use an online tool, here are some suggestions// https://bitwarden.com/password-generator/// https://www.grc.com/passwords.htmcredentials: [{username: admin,password: xxxxxxx,},{username: tigerhhzz,password: xxxxxxx,},],locale: zh,// Support search with extra languagessearchExtraLanguages: [zh],// Sets the format for datetimesdatetime_format: Do MMM YYYY,// Set to true to render suitable layout for RTL languagesrtl_layout: false,// Edit Home Page title, description, etc.home_meta: {// title : Custom Home Title,// description : Custom Home Description},// variables: [// {// name: test_variable,// content: test variable// },// {// name: test_variable_2,// content: test variable 2// }// ]// Set to true to enable generation of table of contentstable_of_contents: false,// Configure generation of table of contents (see markdown-tocs docs for details on available options)table_of_contents_options: {// append: Table of contents appendix,// maxdepth: 6,// firsth1: true,},menu_on_pages: true,menu_on_page_collapsible: true,
};// Exports
module.exports config;在config.js文件中可以自行修改三个地方
站点名称
site_title: Raneto Docs, 用户名和密码 credentials: [ { username: admin, password: password, }, { username: admin2, password: password, }, ], 支持中文语言
locale: zh, // Support search with extra languages searchExtraLanguages: [zh], 5.3 编辑docker-compose.yaml文件
新建raneto容器的docker-compose.yaml部署文件内容如下
version: 3.6 services: raneto: image: raneto/raneto:latest container_name: raneto restart: always ports: - 7860:3000 volumes: - /data/raneto/config:/opt/raneto/config - /data/raneto/content:/opt/raneto/content 5.4 创建raneto容器
使用docker-compose.yaml文件创建raneto容器
docker compose up -d 5.5 检查raneto容器状态
检查raneto容器状态确保raneto容器正常启动。
docker compose ps 5.6 检查raneto容器日志
检查raneto容器日志确保raneto服务正常运行。
docker compose logs 六、Raneto的基本使用
6.1 访问Raneto首页
访问地址http://xxxxxxx:7860/将IP换为自己服务器IP地址进入到Raneto首页。
6.2 登录Raneto
使用默认的密码admin/password登录Raneto。
6.3 上传文档
将md格式文件上传到宿主机的/data/raneto/content/pages目录下刷新页面即可。
[rootjeven pages]# pwd
/data/raneto/content/pages
[rootjeven pages]# ls Linux系统之ls命令的基本使用.md
6.4 新建页面目录
在宿主机的/data/raneto/content/pages目录下新建技术目录。 七、总结
Raneto是一款简单高效的开源知识库工具帮助我们整理知识文档和构建知识体系。它具有简洁直观的界面可以轻松对文档进行分组管理。而且它还提供了友好的Markdown支持让我们能够以更加方便的编写和浏览技术文档。如果你正在寻找一个简单易用的知识库工具那么Raneto是值得一试的选择。 人生真的不在于起点而在于持续性。
