docsify serve

### 如何使用 `docsify serve` 命令启动本地服务器

为了启动 Docsify 的本地服务器，在命令行工具中输入如下命令可以实现这一目标：

docsify serve ./docs

这条命令会在默认情况下监听3000端口并提供位于当前路径下名为`./docs`文件夹中的内容作为静态资源[^1]。

如果希望更改默认的服务端口，可以在命令后面加上`--port`参数指定其他可用端口号。例如要将服务部署到8080端口，则应执行下面的指令：

docsify serve --port 8080 ./docs &

上述命令不仅指定了不同的端口还附加了一个&符号让该进程在后台持续运行而不阻塞终端[^4]。

对于想要自定义更多选项的情况，可以通过编辑项目的根目录下的`index.html`文件加入特定配置项来满足需求。比如启用侧边栏导航功能，可在HTML内添加JavaScript对象设置相应属性：

<script>
window.$docsify = {
    name: '',
    repo: '',
    loadSidebar: true // 开启左侧目录栏
}
</script>

这样当浏览器加载页面时就会按照给定规则解析显示文档结构。

相关问题

docsify linux

Docsify is a documentation generator that can be used on Linux operating systems. It allows you to easily create beautiful and customizable documentation websites from simple markdown files. To get started with Docsify on Linux, you can follow these steps:

1. Install Node.js: Docsify requires Node.js to be installed on your system. You can download and install Node.js from the official website or use a package manager like apt or yum.

2. Install Docsify: Once you have Node.js installed, open your terminal and run the following command to install Docsify globally:

   npm install -g docsify-cli

3. Create Documentation: Next, navigate to the directory where you want to create your documentation website. Create a new directory for your documentation and navigate into it.

4. Initialize Docsify: Run the following command to initialize Docsify in the current directory:

   docsify init ./docs

This will create a `docs` folder with some basic configuration files.

5. Start Docsify: To start the local development server and preview your documentation website, run the following command:

   docsify serve docs

This will start the server and provide you with a URL (e.g., http://localhost:3000) where you can access your documentation.

6. Customize and Write Your Documentation: Docsify uses markdown files for content. You can edit the markdown files in the `docs` folder to write your documentation. You can also customize the appearance and behavior of your documentation website by modifying the `index.html` and `README.md` files.

That's it! You now have a local Docsify server running on your Linux system, allowing you to create and preview your documentation website.

docsify使用搜索

Docsify 是一个基于 Markdown 的文档网站生成工具，它提供了一种简单的方式来创建漂亮的文档网站。在 Docsify 中，你可以使用内置的搜索功能来方便地查找你的文档。

要在 Docsify 中添加搜索功能，需要进行以下步骤：

1. 安装 Docsify：首先，你需要在你的项目目录中安装 Docsify。你可以使用 npm 进行安装，命令如下：

   npm i docsify-cli -g

2. 初始化项目：使用以下命令初始化 Docsify 项目：

   docsify init ./docs

3. 添加搜索插件：Docsify 允许使用第三方搜索插件来实现搜索功能。有几个常用的插件可供选择，例如 Docsify-plugin-search 和 Fuse.js 等。你可以在配置文件 `index.html` 中添加相应的插件。

4. 配置搜索插件：根据使用的搜索插件不同，你需要进行相应的配置。具体配置方式，请参考所选搜索插件的文档。

5. 构建并运行项目：完成上述步骤后，使用以下命令构建并运行项目：

   docsify serve docs

现在，你的 Docsify 网站应该具备搜索功能了。你可以尝试在网站中搜索关键词，看看是否能够找到相应的文档。