用gitbook搭建Wiki

最新推荐文章于 2024-12-13 12:25:44 发布
最新推荐文章于 2024-12-13 12:25:44 发布
阅读量1.2k 收藏 2
点赞数
CC 4.0 BY-SA版权
分类专栏： 学习笔记 文章标签： gitbook gitlab wiki
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/lucifly/article/details/107043639
本文档详细介绍了如何使用Gitbook搭建Wiki，包括环境准备、创建Git仓库、配置GitLab CI/CD，以及通过Nginx进行服务器部署，解决gitlab-runner权限问题。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

用gitbook搭建Wiki

本文参考这篇博客，同时记录一下安装过程遇到的问题。

环境

1、gitbook(1.安装node，2.安装gitbook)

2、nginx(安装教程)

3、gitlab(用gitlab的.gitlab-ci.yml配置CI/CD，配置教程)

过程

1. 创建 git 仓库

2. 进入仓库并使用gitbook init初始化目录。也可以手动初始化，在根目录创建文件 book.json,README.md,SUMMARY.md。

book.json如下，添加了一些常用插件

{
   
   
    "gitbook": "3.x.x",
    "title": "我的Wiki",
    "description": "我的Wiki",
    "author": "我的Wiki",
最低0.47元/天 解锁文章

200万优质内容无限畅学
Gitbook详解（八）-发布书籍
JiangMing-JIM的博客
04-11 2841
文章目录发布书籍发布到Github Pages申请 Github 账号创建一个项目仓库推送静态网站文件到Github仓库中创建 Pages 服务并部署自己的静态网站发布到Gitee Pages申请 Gitee 账号创建一个项目仓库推送静态网站文件到Github仓库中创建 Pages 服务并部署自己的静态网站发布电子书文件 发布书籍 在我们编写完成书籍后，可以将其编译的相关书籍的电子书文件发布给别人共享，目前主流的方式： 将编译的 HTML 网站文件部署到自己的互联网中的 web 服务器中，供大家访问浏览，
gitlab wiki导出html,你会用gitlab的wiki了吗
weixin_32520565的博客
07-02 1334
前言部门目前搭建了自己的gitlab服务器, 用于代码管理, 但是其实gitlab的功能不止于此, 这不, 近期研究了下关于部门技术文档管理的方法, 就发现了gitlab的wiki功能, 为我们的文档管理提供了完美的解决方案, 下面就对此进行一些说明, 并记录一下自己的踩坑与填坑经历.关于wiki网上有一个公式, git + markdown = wiki, 虽然不是很准确(因为wiki不只是支持...
gitbookwiki:知识管理的新尝试
03-29
执照 版权所有2020 Scott Simontis 特此免费授予获得该软件和相关文档文件（“软件”）副本的任何人无限制地处理软件的权利，包括但不限于使用，复制，修改，合并的权利，发布，分发，再许可和/或出售本软件的副本，并允许配备有本软件的人员这样做，但须满足以下条件： 以上版权声明和此许可声明应包含在本软件的所有副本或大部分内容中。 本软件按“原样”提供，不提供任何形式的明示或暗示担保，包括但不限于对适销性，特定目的的适用性和非侵权性的担保。 无论是由于软件，使用或其他方式产生的，与之有关或与之有关的合同，侵权或其他形式的任何索赔，损害或其他责任，作者或版权所有者概不负责。软件。
【测试开发】基于gitbook构建自己学习总结的wiki
2025 热爱与开始
03-05 384
基于gitbook构建wiki Date : 2021.02.03 Author: jwensh 关键词： gitbook webhook jenkins nginx wiki 文章目录基于gitbook构建wiki1.构建一个gitlab项目，并用初始化2.在jenkins上添加一个job3.使用nginx来挂在gitbook build后的html文件4.上面算是已经配置完毕5.book.json 备份内容 1.构建一个gitlab项目，并用初始化 在本地和服务器上安装cn
GitBook，GitLab实现5分钟搭建企业级Wiki
qq_15898739的博客
06-18 8208
GitBook是一款文档编辑工具，支持多人协作，同时支持Git。希望通过本文，帮忙更多人搭建属于自己的Wiki。
GitBook可以搭建知识库吗？有无其他更好更方便的？
LookLook同学的博客
01-26 1289
在一个现代化的企业中，知识是一项宝贵的资产。拥有一个完善的企业知识库，不仅可以加速员工的学习和成长，还能提高工作效率和团队协作能力。然而，随着企业不断发展和扩大规模，知识库的构建和管理变得更加复杂和耗时。
类似gitbook的wiki选择
weixin_34315485的博客
04-13 702
2019独角兽企业重金招聘Python工程师标准>>> ...
3分钟搭建属于自己的技术文档WIKI
04-04
docsify 是一个动态生成文档网站的工具，可以将.md 文件以 wiki 的形式展示给读者，可以用于制作技术文档、用户手册、wiki 等。可以部署于主机、VPS、Github、静态云存储（例如阿里云 OSS）。 官网：...
PeiQi-WIKI-RED:林深时见鹿，海蓝时见鲸:deer:
04-28
这个文库用于整合互联网上关于渗透测试的资料和技巧，与 相似，PeiQI WiKi-RED文库 同样也是开源面向所有人的，大家可以随时在线翻阅或者下载本地搭建:whale: 公众号和作者 [!NOTE] 更新的文章都会在第一时间推送在...
gitbook搭建
Alan的博客
01-04 812
nodejs,gitbook安装及使用最简化版流程
ultimate-gitlab-gitbook:接收Gitlab Web挂钩，使用Gitbook生成内容，使用ElasticSearch增强搜索功能
04-30
最终版gitlab-gitbook 接收Gitlab Web挂钩，使用Gitbook生成内容，使用ElasticSearch增强搜索功能。
使用docsify+Git搭建自己的WiKi网站
拾年之璐
05-31 3752
本文主要内容：0. 前言1. 要求2. 快速安装docsify3. 自定义配置项3.1 修改主页内容3.2 定制侧边栏3.3 定制导航栏3.4 增加标题与Git右上角标3.5 增加搜索框3.6 增加封面3.7 更多插件4. 部署到Git 0. 前言 身为技术人，一方面需要时刻更新自己的技术储备，学习最新的技术，另一方面在工作和项目开发时，面对遇到的各种各样的BUG，需要记住各式各样的对策。 生而为人，遗忘是最大的敌人。将学习到的知识点，解决BUG的对策，整理成文档，或许是对抗遗忘的最佳方案。 这诸多的技术文
windows 系统下GitBook环境搭建与使用教程
weixin_34060741的博客
02-25 266
1.搭建Nodejs环境 前往Node.js官网 下载最新版Nodejs windows系统安装包 安装成功后再cmd窗体中输入node -v 查看是否安装成功参考资料 2.安装 GitBook 可视化编写工具 下载GitBook Editor windows版 安装成功后桌面会有个gitbook图标 双击打...
gitbook教程
weixin_33769125的博客
06-06 308
gitbook的用途 配合使用 GitBook + Typora + Git 安装 npm install -g gitbook-cli 复制代码使用 gitbook init 复制代码生成文件 README.md —— 书籍的介绍写在这个文件里 SUMMARY.md —— 书籍的目录结构在这里配置 复制代码.md文件用Typora来编辑，可以打开当前文件夹 demo 编辑SUMMARY.md文件...
Gitbook安装使用教程
suym796的博客
04-28 1528
Gitbook安装使用教程 什么是Gitbook Gitbook是一个使用Git和Markdown生成在线书籍的工具。 安装Gitbook 首先，Gitbook是基于Node.js的命令行工具，先安装Node.js。 可以到Node.js官网下载。 然后在命令行执行node -v查看Node.js版本，以此来确认是否安装成功。 $ node -v v10.16.0 接下来就可以安装Gitbook...
Gitbook超详细使用教程,搭建属于你自己的博客！
xf555er的博客
08-21 6814
Gitbook 是一个平台，允许用户创建和分享内容丰富的在线书籍。它有一个用户友好的界面，可以快速地写作、编辑和发布你的电子书。这里是一个按照 Gitbook 的基本步骤点击你创建的组织的设置选项，例如此处我创建的组织为AptBoys，我就点击在General选项块处找到，点击自定义你博客的域名填写你的三级域名, 例如此处我的是，域名是我在godaddy上申请的(不用域名备案)
搭建自己的wiki知识库（重新整理）
janthinasnail的博客
12-13 3697
搭建wiki知识库，可以使用在线文档，如xx笔记、xx文档、xx博客、git仓库（如：GitHub）等等，也可以使用开源的项目搭建，如vuePress、Docusaurus、Hugo、mdBook、Zola、Jekyll、WordPress、Docsify、Hexo等等。
什么是 GitHub Wiki 以及如何使用它？
晓风晓浪
04-20 2960
Wiki 的侧边栏、首页和页脚的自定义选项有限。但是你可以使用 HTML、CSS 和 Markdown 来扩展这些选项。我们已经讨论了首页，现在我们将讨论页脚和侧边栏。页脚和侧边栏显示或包含诸如联系信息、导航链接、社交媒体链接等有用的链接。页脚显示在站点的每个页面底部，侧边栏通常是网页左侧或右侧的垂直列。两者都在 wiki 的所有页面上可见。有两种方法可以在 GitHub wiki 中创建侧边栏。使用 GitHub UI在你的 IDE 中本地创建。
【Gitbook】GitBook+GitLab撰写发布技术文档
南方有乔木的博客
09-28 786
【Gitbook】GitBook+GitLab撰写发布技术文档 【Gitbook】GitBook+GitLab撰写发布技术文档-Part1:GitBook篇 【Gitlab】GitBook+GitLab撰写发布技术文档-Part2:GitLab篇
wiki.js和confluence哪个更好用？
最新发布
03-21
<think>好的，我现在需要回答用户关于wiki.js和Confluence哪个更好用的问题。首先，我应该明确这两个工具的基本信息和适用场景，然后根据不同的需求进行比较。 首先，wiki.js是一个开源的Wiki平台，使用Node.js开发，支持多种数据库。它可能更适合技术团队或者需要高度定制化的用户，因为开源意味着可以自由修改代码，而且可能成本较低。另外，用户提到它支持Markdown和可视化编辑器，这可能对技术用户和非技术用户都有吸引力。 然后是Confluence，这是Atlassian公司的商业产品，通常与Jira等其他工具集成。Confluence可能更适合中大型企业，尤其是那些已经在使用Atlassian生态系统的团队。它的权限管理和企业级功能可能更完善，但需要付费订阅，这可能对预算有限的小团队来说是个考虑因素。 接下来，我需要比较它们的几个关键点：安装部署、功能特性、协作体验、扩展性、成本和适用场景。 安装部署方面，wiki.js作为开源软件可能需要自己搭建服务器，适合有技术能力的团队。而Confluence作为SaaS可能更方便，但企业也可以选择自托管，不过需要处理许可证问题。 功能特性方面，Confluence可能更全面，比如页面模板、任务管理、与Jira的深度集成，这对项目管理很重要。而wiki.js的轻量级可能更适合文档管理，但可能缺乏一些高级协作功能。 协作体验方面，Confluence的评论、@提及和版本控制可能更成熟，适合需要频繁协作的团队。而wiki.js虽然也有这些功能，但可能在用户体验上不如Confluence流畅。 扩展性方面，wiki.js的开源特性允许更多自定义，而Confluence的插件市场可能提供更多现成的解决方案，但需要付费插件可能会增加成本。 成本方面，wiki.js免费，适合预算有限的团队，而Confluence按用户收费，长期使用成本可能较高，但大企业可能更愿意为支持和服务付费。 适用场景的话，wiki.js适合中小团队、技术用户或需要定制的场景，而Confluence适合中大型企业、非技术团队或需要深度协作和集成的环境。 还需要考虑用户的技术能力，如果团队没有IT支持，Confluence的云服务可能更省心。另外，数据安全和合规性方面，Confluence可能提供更好的保障，特别是企业版。 最后，我应该总结这些点，给出选择建议，帮助用户根据自身情况做决定。同时要确保回答结构清晰，分点明确，符合用户的要求。</think>### Wiki.js 与 Confluence 对比分析 以下从**功能定位、适用场景、优缺点**等角度逐步分析，帮助您根据需求选择更合适的工具： --- #### 1. **基础定位** - **Wiki.js** - **开源免费**：基于 Node.js 的轻量级 Wiki 系统，支持自托管。 - **灵活性高**：可通过插件扩展功能，适合技术团队定制。 - **核心功能**：文档协作、Markdown 支持、多数据库兼容（如 PostgreSQL、MySQL）。 - **Confluence** - **商业付费**：Atlassian 公司的企业级知识管理工具，需订阅（按用户数收费）。 - **生态整合**：与 Jira、Trello 等 Atlassian 工具深度集成，适合项目管理场景。 - **核心功能**：结构化文档、权限管理、模板库、高级搜索。 --- #### 2. **关键对比维度** | **维度** | **Wiki.js** | **Confluence** | |------------------|----------------------------------------|-----------------------------------------| | **安装部署** | 需自建服务器，适合技术团队 | 提供 SaaS 云服务或企业自托管（需许可证） | | **协作体验** | 轻量化，Markdown 友好 | 富文本编辑更直观，评论/任务管理完善 | | **权限管理** | 基础权限控制 | 精细化权限分层（页面/空间级别） | | **扩展性** | 依赖社区插件，需自主开发 | 官方插件市场丰富（如图表、宏） | | **成本** | 免费（服务器成本自理） | 按用户数订阅（适合预算充足的企业） | --- #### 3. **适用场景建议** - **选择 Wiki.js 的情况**： - 团队有技术能力维护服务器，追求低成本。 - 需求简单，以文档存储和共享为主，无需复杂项目管理。 - 需要开源自由修改代码（例如定制化界面或功能）。 - **选择 Confluence 的情况**： - 企业已有 Atlassian 生态（如 Jira），需无缝协作。 - 需要严格权限管控和审计功能（如金融、医疗行业）。 - 非技术团队为主，依赖“开箱即用”的体验。 --- #### 4. **常见痛点** - **Wiki.js 的不足**： - 插件生态较弱，复杂功能需自行开发。 - 缺乏原生移动端支持。 - 多人协作时版本冲突处理较基础。 - **Confluence 的不足**： - 价格较高（小型团队可能负担重）。 - 界面复杂度高，学习曲线陡峭。 - 数据存储在第三方（云版），部分企业顾虑安全性。 --- #### 5. **替代方案补充** 若两者均不完全匹配需求，可考虑： - **Notion**：适合小型团队，兼顾文档与数据库。 - **GitBook**：开发者友好，Markdown 与 Git 集成。 - **飞书文档**：国内团队协作，集成 IM 与 OA。 --- ### 总结 - **Wiki.js**：优先考虑“技术可控性”和“成本”时选它。 - **Confluence**：优先考虑“企业级功能”和“生态整合”时选它。 建议根据团队规模、技术能力、预算及协作需求综合评估。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值