# 文档交付

**URL:** https://www.isharkfly.com/c/software-development/docs/22.md

[Latest](https://www.isharkfly.com/latest.md) · [Categories](https://www.isharkfly.com/categories.md) · [Tags](https://www.isharkfly.com/tags.md)

---

## [About the 文档交付 category](https://www.isharkfly.com/t/about-the-category/474)

<div class="topic-metadata">

**Author:** [@honeymoose](https://www.isharkfly.com/u/honeymoose)\
**Replies:** 0

</div>

(Replace this first paragraph with a brief description of your new category. This guidance will appear in the category selection area, so try to keep it below 200 characters.) Use the following paragraphs for a longer d…

---

## [Confluence 6 通过重置密码来获得管理员权限](https://www.isharkfly.com/t/confluence-6/1479)

<div class="topic-metadata">

**Author:** [@honeymoose](https://www.isharkfly.com/u/honeymoose)\
**Replies:** 0\
**Last updated:** [January 14, 2021, 7:33pm UTC](https://www.isharkfly.com/t/confluence-6/1479 "2021-01-14T19:33:55Z")

</div>

如果你不能作为管理员登录 Confluence （例如，你弄丢了你的管理员密码），你可以以恢复模式启动 Confluence 来恢复你的管理员用户权限。 如果你知道你的管理员的用户名和电子邮件地址，你可以使用登录界面的忘记密码链接。系统将会发送一个重置邮件链接到你的管理员邮箱中，你可以用这个重置链接来恢复你的管理员密码。 作为 Confluence 的管理员，你可能会发现你被 Confluence 禁止登录了，其中可能有下面的一些原…

---

## [VitePress 需要使用 GitHub 的 Action 来进行部署](https://www.isharkfly.com/t/vitepress-github-action/18372)

<div class="topic-metadata">

**Author:** [@hex](https://www.isharkfly.com/u/hex)\
**Replies:** 0\
**Last updated:** [October 25, 2025, 10:12am UTC](https://www.isharkfly.com/t/vitepress-github-action/18372 "2025-10-25T10:12:09Z")

</div>

在这里需要选择的是 Actions，同时还需要提供 Action 的脚本。

---

## [Vitepress code-group 配置](https://www.isharkfly.com/t/vitepress-code-group/17186)

<div class="topic-metadata">

**Author:** [@hex](https://www.isharkfly.com/u/hex)\
**Replies:** 0\
**Last updated:** [April 14, 2025, 2:06pm UTC](https://www.isharkfly.com/t/vitepress-code-group/17186 "2025-04-14T14:06:10Z")

</div>

可以在 MD 文件中输入下面的内容： Install ::: code-group npm i -D vitepress-plugin-compression yarn add -D vitepress-plugin-compression pnpm add -D vitepress-plugin-compression ::: 上面的代码，最终显示的情况为： 主要还是针对代码的显示。

---

## [Vitepress 如何把一个 MD 文件嵌入到另外一个文件中](https://www.isharkfly.com/t/vitepress-md/17190)

<div class="topic-metadata">

**Author:** [@hex](https://www.isharkfly.com/u/hex)\
**Replies:** 0\
**Last updated:** [April 14, 2025, 4:43pm UTC](https://www.isharkfly.com/t/vitepress-md/17190 "2025-04-14T16:43:53Z")

</div>

不同的解释器使用不同的方式。 Vitepress 的方法是使用代码 \<!--@include: chapter-02.md --\> 对比上面的 2 段代码。 在界面中的显示是完全不同的。 上面的方式会将内容完全导入到 1 个文件中。 下面的方式只是提供一个链接而已。

---

## [Vitepress 示例网站](https://www.isharkfly.com/t/vitepress/17187)

<div class="topic-metadata">

**Author:** [@hex](https://www.isharkfly.com/u/hex)\
**Replies:** 7\
**Last updated:** [April 14, 2025, 2:38pm UTC](https://www.isharkfly.com/t/vitepress/17187 "2025-04-14T14:38:59Z")

</div>

vitepress 使用文档的越来越多，但示例网站却不多。 因此我们收集了些供参考。 stackblitz 访问地址：https://developer.stackblitz.com/

---

## [Vitepress 文档交付工具还挺好](https://www.isharkfly.com/t/vitepress/17179)

<div class="topic-metadata">

**Author:** [@hex](https://www.isharkfly.com/u/hex)\
**Replies:** 0\
**Last updated:** [April 13, 2025, 4:26pm UTC](https://www.isharkfly.com/t/vitepress/17179 "2025-04-13T16:26:51Z")

</div>

Vitepress 文档交付工具使用的是 VUE，可以使用 NodeJS 的方式进行部署。 现在唯一感觉稍微有点不非常理想的地方就是正文的宽度。 参考下我们使用这个工具部署的文档和 KB：Java 核心编程 | iSharkFly 文档和手册 感觉这个正文的宽度看起来还是有点偏小。 如果能再扩大点就更好了。

---

## [Docsify 文档库部署后的更换](https://www.isharkfly.com/t/docsify/17169)

<div class="topic-metadata">

**Author:** [@hex](https://www.isharkfly.com/u/hex)\
**Replies:** 0\
**Last updated:** [April 13, 2025, 12:28pm UTC](https://www.isharkfly.com/t/docsify/17169 "2025-04-13T12:28:25Z")

</div>

因 Docsify 部署的局限性，我们的文档库尝试使用不同的框架。 现在准备使用 vitepress，在这之前最后看看曾经部署过好几年的文档库吧。 好处感觉就是 Docsify 默认设计内容能够全屏显示。

---

## [Vitepress .gitignore 文件缓存的问题](https://www.isharkfly.com/t/vitepress-gitignore/17174)

<div class="topic-metadata">

**Author:** [@hex](https://www.isharkfly.com/u/hex)\
**Replies:** 0\
**Last updated:** [April 13, 2025, 2:45pm UTC](https://www.isharkfly.com/t/vitepress-gitignore/17174 "2025-04-13T14:45:18Z")

</div>

文件缓存文件夹将会被提交到 Git。 我们认为这个文件夹不应该被提交。 所以应该修改 git 的忽略文件，添加下面的内容： # vitepress build output .vitepress/cache 同时部署文件夹中来看，忽略这个文件夹不会影响构建部署。

---

## [有点纠结是用 vitepress 还是 docusaurus](https://www.isharkfly.com/t/vitepress-docusaurus/1535)

<div class="topic-metadata">

**Author:** [@honeymoose](https://www.isharkfly.com/u/honeymoose)\
**Replies:** 0\
**Last updated:** [January 14, 2021, 8:00pm UTC](https://www.isharkfly.com/t/vitepress-docusaurus/1535 "2021-01-14T20:00:52Z")

</div>

有点纠结是用 vitepress 还是 docusaurus。 主要是 vitepress 和 docusaurus 的生态不一样，一个是基于 VUE 的一个是基于 React 的。 GitHub Page 部署 简单来说是能够支持 GitHub 部署的。 docsify 对我们来说也能用，但就是感觉功能太少了。 但是 docsify 的优点是：不需要安装任何依赖，不需要编译，完全运行时驱动，功能虽然少，但是对于一个简单…

---

## [Vitepress 的映射目录如何指定](https://www.isharkfly.com/t/vitepress/17171)

<div class="topic-metadata">

**Author:** [@hex](https://www.isharkfly.com/u/hex)\
**Replies:** 0\
**Last updated:** [April 13, 2025, 1:04pm UTC](https://www.isharkfly.com/t/vitepress/17171 "2025-04-13T13:04:52Z")

</div>

Vitepress 在默认情况下，将会搜索与 .vitepress 同级目录下的所有 md 文件然后进行转换。 如果想使用不同的目录的话，那么就需要参数： .srcDir: './src', 这样就可以把所有文件移动到 src 目录下了。 当完成上面的配置后，Vitepress 将会扫描 src 目录下的内容了。

---

## [Vitepress 页面中如何添加 GTM](https://www.isharkfly.com/t/vitepress-gtm/17170)

<div class="topic-metadata">

**Author:** [@hex](https://www.isharkfly.com/u/hex)\
**Replies:** 0\
**Last updated:** [April 13, 2025, 12:31pm UTC](https://www.isharkfly.com/t/vitepress-gtm/17170 "2025-04-13T12:31:27Z")

</div>

可以把下面的代码添加到 vitepress 的 head 上来让 vitepress 网站使用 GTM。 例如，我们的内容是： head: \[ \[ 'script', {}, \`(function(w,d,s,l,i){w\[l\]=w\[l\]||\[\];w\[l\].push({'gtm.start': new Date().getTime(),e…

---

## [Markdown 对勾符号](https://www.isharkfly.com/t/markdown/15670)

<div class="topic-metadata">

**Author:** [@hex](https://www.isharkfly.com/u/hex)\
**Replies:** 0\
**Last updated:** [April 25, 2024, 6:26pm UTC](https://www.isharkfly.com/t/markdown/15670 "2024-04-25T18:26:35Z")

</div>

Markdown中根号符号不完美，少了上面一横，更像对勾：√ 输入：&#10004; 即可显示为：:check\_mark: 在 youtrack 上面的 KB 页面，也适用。

---

## [Confluence 订阅网络 RSS 源](https://www.isharkfly.com/t/confluence-rss/1697)

<div class="topic-metadata">

**Author:** [@honeymoose](https://www.isharkfly.com/u/honeymoose)\
**Replies:** 0\
**Last updated:** [January 15, 2021, 3:57pm UTC](https://www.isharkfly.com/t/confluence-rss/1697 "2021-01-15T15:57:33Z")

</div>

你可以从其他任何用户网络视图中创一个 RSS 源。 通过这个源你可以收到这个用户关注其他用户的概述。RSS 源可以跟踪的内容包括如下： 添加或者编辑的页面或者博客页面 页面或者博客页面中添加的评论或者编辑的评论。 用户的状态更新。 用户的属性更新

---

## [Confluence 如何查看自己的权限](https://www.isharkfly.com/t/confluence/14240)

<div class="topic-metadata">

**Author:** [@honeymoose](https://www.isharkfly.com/u/honeymoose)\
**Replies:** 1\
**Last updated:** [December 7, 2022, 12:47pm UTC](https://www.isharkfly.com/t/confluence/14240 "2022-12-07T12:47:39Z")

</div>

如何查看到自己的 confluence 权限都有哪些，都可以进行哪些工作？

---

## [Docsify 脚本执行权限问题](https://www.isharkfly.com/t/docsify/13805)

<div class="topic-metadata">

**Author:** [@honeymoose](https://www.isharkfly.com/u/honeymoose)\
**Replies:** 0\
**Last updated:** [November 11, 2021, 4:13pm UTC](https://www.isharkfly.com/t/docsify/13805 "2021-11-11T16:13:03Z")

</div>

有时候你在运行文档的时候，可能会遇到下面的问题： AppData\\Roaming\\npm\\docsify.ps1 is not digitally signed. You cannot run this script on the current system. 解决 这个问题是原因是脚本执行权限的问题。 可以通过运行下面的命令： Set-ExecutionPolicy -Scope Process -ExecutionP…

---

## [Docsify 官方文档部署](https://www.isharkfly.com/t/docsify/15555)

<div class="topic-metadata">

**Author:** [@honeymoose](https://www.isharkfly.com/u/honeymoose)\
**Replies:** 0\
**Last updated:** [March 26, 2024, 7:58pm UTC](https://www.isharkfly.com/t/docsify/15555 "2024-03-26T19:58:33Z")

</div>

我们从官方的网站把 Docsify 的文档下载到本地进行修改后进行中文化处理。 处理好的网站我们部署在：docsify 网站上。 部署后的界面是下面这个样子： 部署上面网站的源代码在GitHub：

---

## [阿里的语雀，何以交付](https://www.isharkfly.com/t/topic/15343)

<div class="topic-metadata">

**Author:** [@honeymoose](https://www.isharkfly.com/u/honeymoose)\
**Replies:** 2\
**Last updated:** [January 18, 2024, 1:28pm UTC](https://www.isharkfly.com/t/topic/15343 "2024-01-18T13:28:12Z")

</div>

正在准备把一些比较重要的参考文档放到可以随时准备访问的地方，但今天闲来无事居然看到了这样的一篇文章。 文档笔记类的代表产品语雀，昨天突然访问502了。而归属于阿里大厂的产品，下线了超过7个小时，这是非常罕见的。 比如曾经微信就出现过，但几分钟就解决了。 ▲微信的官方修复 而在信息安全标准化的今天，服务用户超过百万的产品，\*\*通过特定的时间范围来确定事件等级，\*\*恢复时间都是按照分钟计算，大厂里有的核心产品可能按照秒计算。 …

---

## [SharePoint 页面中插入自定义代码](https://www.isharkfly.com/t/sharepoint/15129)

<div class="topic-metadata">

**Author:** [@honeymoose](https://www.isharkfly.com/u/honeymoose)\
**Replies:** 0\
**Last updated:** [November 10, 2023, 3:58am UTC](https://www.isharkfly.com/t/sharepoint/15129 "2023-11-10T03:58:13Z")

</div>

我们都知道 SharePoint 是对页面进行编辑的。 对于一些有编程基础的人来说，可能需要对页面中插入代码，这样才能更好的对页面进行配置。 但是在新版本的 SharePoint modern 页面来说，虽然我们可以插入 Embed 组件。 但是 Embed 组件中是不允许提供 Script 和 Html 脚本的。只能插入 iFrame 框架或者 URL 地址。 这个就非常郁闷了。 管理员配置 在 SharePoint …

---

## [SharePoint 的 Web Parts 是什么](https://www.isharkfly.com/t/sharepoint-web-parts/15128)

<div class="topic-metadata">

**Author:** [@honeymoose](https://www.isharkfly.com/u/honeymoose)\
**Replies:** 0\
**Last updated:** [November 10, 2023, 3:48am UTC](https://www.isharkfly.com/t/sharepoint-web-parts/15128 "2023-11-10T03:48:17Z")

</div>

Web Parts 可以说是微软 SharePoint 的基础组件。 根据微软自己的描述，Web Parts 是 SharePoint 对内容进行构建的基础，可以想想成一块一块的砖块。 我们需要使用这些砖块来完成一个页面的构建。 我们可以利用 Web Parts 在 SharePoint 中添加文本，图片，文件，视频，甚至是动态内容。 添加 Web Parts 在完成页面布局的 Section 后，单击页面布局上面的 Secti…

---

## [SharePoint 是什么](https://www.isharkfly.com/t/sharepoint/15127)

<div class="topic-metadata">

**Author:** [@honeymoose](https://www.isharkfly.com/u/honeymoose)\
**Replies:** 0\
**Last updated:** [November 10, 2023, 3:35am UTC](https://www.isharkfly.com/t/sharepoint/15127 "2023-11-10T03:35:27Z")

</div>

SharePoint 平台使您能够以在线方式和本地方式轻松地管理和协调业务数据。因为其灵活性和易使用性，公司可以快速采用SharePoint来管理其业务数据。 SharePoint Microsoft 365 一种基于云的服务，由 Microsoft 托管，适用于各种规模的企业。 任何 SharePoint Server 企业都可以订阅Microsoft 365 计划或独立的 SharePoint Online 服务，而不是在…

---

## [Docsify 顶部的导航是如何配置](https://www.isharkfly.com/t/docsify/15126)

<div class="topic-metadata">

**Author:** [@honeymoose](https://www.isharkfly.com/u/honeymoose)\
**Replies:** 0\
**Last updated:** [November 10, 2023, 3:04am UTC](https://www.isharkfly.com/t/docsify/15126 "2023-11-10T03:04:46Z")

</div>

如下图，我们在 Docsify 的文档中配置了一个顶部导航。 下面的步骤对顶部导航的配置进行简要介绍。 配置 有 2 个地方需要这个地方进行配置。 首先需要在 index.html 文件中的 loadNavbar: true, 配置上。 然后再在项目中添加一个 \_navbar.md 文件。 在这个文件中对导航进行配置。 配置的格式如下图。 当完成上面的配置后，有关顶部的导航就会自动显示了。 Docsif…

---

## [Docsify 和 Hugo 之间的选型](https://www.isharkfly.com/t/docsify-hugo/15115)

<div class="topic-metadata">

**Author:** [@honeymoose](https://www.isharkfly.com/u/honeymoose)\
**Replies:** 0\
**Last updated:** [November 8, 2023, 3:58pm UTC](https://www.isharkfly.com/t/docsify-hugo/15115 "2023-11-08T15:58:17Z")

</div>

对文档的编译，目前的发布方案是越来越注重 MD 的编辑和发布。 针对其他 Wiki 的选择，MD 文件的编辑通常会保留修改记录，同时不依赖中央数据库和其他类型的 Web 应用服务。 随着各大云平台的支持，包括 GitHub Page 和 Google 的 Firebase，通常在免费的情况下就可以获得基于自己域名的文档服务。 对文档内容的修改，也只需要修改 Md 文件就可以了。 Confluence 长期以来，我们都使用 Con…

---

## [Docsify 如何在一个 MD 文件中嵌入另外一个文件](https://www.isharkfly.com/t/docsify-md/13312)

<div class="topic-metadata">

**Author:** [@honeymoose](https://www.isharkfly.com/u/honeymoose)\
**Replies:** 0\
**Last updated:** [February 17, 2021, 4:52pm UTC](https://www.isharkfly.com/t/docsify-md/13312 "2021-02-17T16:52:36Z")

</div>

在使用 MD 进行文档开发的时候，用的最多就是页面共用。 docsify 已经提供了这个功能，你不仅仅可以嵌入 md 文件，你还可以嵌入一些不同的文件类型。 嵌入方式 可以使用下面的方式进行嵌入。 \[filename\](\_media/example.md ':include') 在链接到 md 文件后，在文件的后端添加参数：‘:include’ 就可以了。 需要注意的是 :include 需要单引号来进行包裹。 可以嵌入的文…

---

## [Confluence 恢复的时候数据版本问题](https://www.isharkfly.com/t/confluence/15111)

<div class="topic-metadata">

**Author:** [@honeymoose](https://www.isharkfly.com/u/honeymoose)\
**Replies:** 0\
**Last updated:** [November 7, 2023, 7:21pm UTC](https://www.isharkfly.com/t/confluence/15111 "2023-11-07T19:21:17Z")

</div>

如果 Confluence 恢复的时候提示数据库的版本不正确或者有问题。 如下图所示： 只要版本差不太多，你可以通过数据库来自动调整版本信息。 有关 Confluence 安装的数据库表位置在：CONFVERSION 这个表。 把这个表中的数据更新下就可以了。 当然，因为升级的问题，这个表只是让程序启动的时候跳过这个校验。 从这个表中也可以看到我们安装的 Confluence 实例被升级了多少次，最早的安装是在什…

---

## [查看了下 Confluence 的最早使用时间](https://www.isharkfly.com/t/confluence/15110)

<div class="topic-metadata">

**Author:** [@honeymoose](https://www.isharkfly.com/u/honeymoose)\
**Replies:** 0\
**Last updated:** [November 7, 2023, 7:17pm UTC](https://www.isharkfly.com/t/confluence/15110 "2023-11-07T19:17:47Z")

</div>

我们查看了下我们最早使用 Confluence 的时间。 有点遗憾需要和 Confluence 说再见了。 最早开始使用 Confluence 在 2014 年。 感谢这一路陪我们一起走过来的朋友们。

---

## [Confluence 6 发送 Confluence 通知到其他 Confluence 服务器](https://www.isharkfly.com/t/confluence-6-confluence-confluence/1321)

<div class="topic-metadata">

**Author:** [@honeymoose](https://www.isharkfly.com/u/honeymoose)\
**Replies:** 0\
**Last updated:** [January 14, 2021, 5:05am UTC](https://www.isharkfly.com/t/confluence-6-confluence-confluence/1321 "2021-01-14T05:05:04Z")

</div>

你可以配置 Confluence 服务器向其他的 Confluence 服务器发送消息。在这种情况下，Confluence 服务器将不会显示 workbox。 希望发送消息到其他 Confluence 服务器： 请参照 ConfluenceQuiet 我们的配置示例 屏幕截图：这个 Confluence 服务器发送应用内消息到其他 Confluence 服务器

---

## [Confluence 5.7.1 在 Confluence 查看所有的空间](https://www.isharkfly.com/t/confluence-5-7-1-confluence/6306)

<div class="topic-metadata">

**Author:** [@honeymoose](https://www.isharkfly.com/u/honeymoose)\
**Replies:** 0\
**Last updated:** [March 13, 2015, 2:24am UTC](https://www.isharkfly.com/t/confluence-5-7-1-confluence/6306 "2015-03-13T02:24:39Z")

</div>

有下面 2 种方面查看 Confluence 空间： 面板 – 左侧 内容显示面板 将会显示一些空间和你编好的空间和在空间目录中查看所有空间的链接。 空间目录 – 在 Confluence 头中选择 Spaces \> Space directory （空间 \> 空间目录）。空间目录中显示所有站点和个人空间列表，当然你首先的具有访问空间的权限，如果你不具有访问空间的权限的话，空间是不会对你显示的。通过在左侧的空间目录分类中过滤空间的列…

---

## [Confluence 内容显示面板](https://www.isharkfly.com/t/confluence/1583)

<div class="topic-metadata">

**Author:** [@honeymoose](https://www.isharkfly.com/u/honeymoose)\
**Replies:** 0\
**Last updated:** [January 15, 2021, 3:55pm UTC](https://www.isharkfly.com/t/confluence/1583 "2021-01-15T15:55:32Z")

</div>

中文标题【内容显示面板】 Confluence 的内容显示面板是你的主要访问界面，能够提供给你有关站点更新的主要信息。同时这个也是你的站点用户访问网站首先看到的内容。你应该对这个界面进行一些调整，让你新招募的小组成员有好的印象。 你可以通过单击 Confluence 左侧顶部的 \*\*站点标记（site logo）\*\*来访问你 Confluence 的内容显示面板。 这个内容显示面板有一个可以收起来的边栏能够让你更加容易进行导航： …

---

## [Confluence 恢复站点失败](https://www.isharkfly.com/t/confluence/14521)

<div class="topic-metadata">

**Author:** [@honeymoose](https://www.isharkfly.com/u/honeymoose)\
**Replies:** 1\
**Last updated:** [June 20, 2023, 11:48pm UTC](https://www.isharkfly.com/t/confluence/14521 "2023-06-20T23:48:22Z")

</div>

1、confluence版本7.4.6 ，有每日备份的文件，用备份文件在恢复时就报这个错误， 在数据库中 修改了username 允许为空，恢复还是报错，这个怎么可以解决呢？ 2、在confluence8.x版本中也尝试恢复过 同样失败。

[Next page](https://www.isharkfly.com/c/software-development/docs/22.md?page=1)