本文目录一览：
用vitepress搭建文档网站踩坑记录
1、之前凭借vuepress2与vite成功构建了个人博客，鉴于vue3的文档采用vitepress的新设计，我决定尝试搭建一个工作文档网站，以体验其魅力。在开始时，我误将配置文件夹命名为.vitepress，而非放在docs目录下。这导致我在设置导航和侧边栏时，尽管复制了官方教程的代码，却始终无法生效。
2、利用 Markdown 语法编写文档内容，Markdown 文件将被解析为 Vue 组件。可以在项目根目录下创建一个 .vitepress 文件夹，用于存放 VitePress 的配置文件和页面内容。配置主题和插件：根据需要配置 VitePress 的主题，可以通过修改 .vitepress/config.js 文件来实现。
3、VitePress适用于各种技术文档、API文档、教程等需要清晰、易读的在线内容展示的场景。使用VitePress搭建文档型网站的步骤包括：新建项目、配置运行环境，以及根据实际需求进行进阶功能配置。在新建项目后，进入生产模式运行时，VitePress能显著提升加载速度，优化用户体验。
4、首先，在项目目录下创建文件夹并新建目录。 在package.json文件中添加用于运行命令的script。 运行命令以完成基础搭建。 在docs目录下创建.vuepress目录，并按需添加配置文件，例如项目介绍。 美化首页布局，可以参考默认主题提供的主页布局。 生成文档，文件默认保存在.vitepress/dist目录下。
5、VitePress 的工作原理包括：编写 Vue 组件、解析 Markdown 文件、利用 Vite 构建、使用 Vue Router 实现页面路由、自定义主题和插件。为 Vue 组件开发文档网站，首先需要创建 VitePress 项目，利用 Markdown 编写页面内容，然后根据需要配置主题、插件，实现个性化页面展示和功能扩展。
6、首先，展示集成后的效果。在线预览。使用 Vue2 或 Vue3 均可搭建 VitePress 文档。本文以 Vue3 CLI 命令创建的基础版进行演示，步骤包括安装和启动项目。通过命令选择 Vue3 并一路下一步完成创建。浏览器访问 localhost：8080，即可看到搭建完成的页面。进入项目根目录，利用命令安装 VitePress 依赖。
如何在本地搭建一个网站
搭建本地博客网站 安装Git和Go：确保系统上已安装Git和Go编程语言，这是运行HUGO的必要环境。下载并安装HUGO：从HUGO官方网站下载适用于Windows的安装包。将安装包解压到新建的C盘hugo文件夹内的bin文件夹中。配置环境变量：将C：hugobin路径添加到系统的环境变量Path中，以便在命令行中直接运行HUGO。
建立站点有两种方法：一种是使用向导，另一种是使用高级设置。首先，在自己的电脑硬盘上创建一个以英文或数字命名的空文件夹。然后，选择菜单栏中的“站点”-“管理站点”，点击“新建”按钮，选择弹出菜单中的“站点”选项。在弹出的窗口中，选择“基本”标签。
成功启动后，找到XAMPP的安装路径，其下的htdocs目录即为网站根目录。你可以将下载的网站模板解压至该目录，或者新建一个子目录作为根目录，访问时在10.1后添加该目录路径。总的来说，使用XAMPP进行本地网站搭建，流程简单易行，是入门级网站开发者的好帮手。
wps文档如何加入网站链接?
关于在在wps文档里面怎么加入网址链接的问题，我们推荐您可使用WPS2019来完成操作，输入网址自动变成超链接 点击左上角“左上角“文件”，进入选项对话框，在”编辑与显示“下，勾选“键入时将internet及网络路径转换为超链接”即可。最后请取消按下ALT键并单击以跟踪超链接，这样一点击就连接该网站。
方法一：如果您需要批量超链接，可以使用快捷键CTRL+A全选文档内容，然后在菜单栏找到并点击“开始”选项卡，在样式区域找到并点击“超链接”按钮，这样所有选中的网址将自动添加超链接。方法二：您也可以先选中所有包含网址的内容，然后复制这些内容。
打开要编辑的文档：在WPS界面，点击右上角的那个小小的“打开文件夹”按钮，就像打开宝藏箱一样，选中你要编辑的文档，打开它。找到插入链接的菜单：在打开的文档页面，瞅瞅窗口上方，有个“插入”菜单，它就像是个魔法工具箱，我们点它一下。
先进入手机桌面，我们点击WPS Office进入软件之中。在软件页面，我们点击右上方边缘的打开文件夹按钮，把文档打开。在文档页面，我们点击窗口上方的插入菜单，在下方工具栏内点击链接工具。在超链工具的弹窗内选择超链到网址，在下方分别输入网址与文字。再点击右上方确定按钮就可以。
在WPS文字文档的顶端菜单栏中，点击“插入”。选择超链接功能：在插入菜单中，找到并点击“超链接”功能选项。输入网址：在弹出的超链接设置窗口中，输入你想要链接到的网址。设置显示文字：在窗口的顶端部分，输入你想要显示为超链接的文字。这部分文字是用户在文档中看到的，点击后会跳转到指定的网址。
打开WPS表格，我们新建一个空白文档。点击插入菜单下面的超链接，进入到超链接的对话框里面。超链接有三种。1）原有文件或网页。可以插入文件或者网页。2）本文档中的位置 就是单元格了。3）电子邮件的地址 就是电子邮件地址了。首先来看第一种。
标签： 文档网站搭建
