亚洲女同成aV人片在线观看|亚洲www啪成人一区二区麻豆|亚洲国产中日韩精品综合|亚洲国产成人精品一级片|亚洲无码在线视频免费

根據你的網(wǎng)站文件網(wǎng)站需求，以下是平臺使用(yong) Docsify和 MkDocs兩種工具搭建靜態(tài)文檔網(wǎng)站的步驟指南，供你參考：

一、搭建使用 Docsify 搭建文檔網(wǎng)站

Docsify是網(wǎng)站文件網(wǎng)站一個(gè)輕量級、可擴展的ヾ(′?｀)?平臺靜態(tài)網(wǎng)站生成器，專(zhuān)為文檔展示設計，搭建支持 Markdown 編寫(xiě)和多種主題。網(wǎng)站文件網(wǎng)站

1. 安裝與初始化

安裝(zhuang) Docsify CLI

在終端運行以下(′?｀*)命令安裝全局工具：

```bash

npm i docsify-cli -g

```

創(chuàng )建項目目錄

```bash

mkdir docsify-demo

cd docsify-demo

```

初始化 Doc(′▽?zhuān)?)sify

運行命令生成配置文件和示例結構：

```bash

docsify init

本地預覽

使用以下命ヽ(′ー｀)ノ令啟動(dòng)本地服務(wù)器：

```bash

docsify ser?ve

```

訪(fǎng)問(wèn) `http://localhost:3000/` 即可查看效果。平臺

2. 自定義配置與主題

修改配置文件

編輯 `docsify.yml`（或 `index.html`）設置站點(diǎn)名稱(chēng)、搭建URL、網(wǎng)站文件網(wǎng)站導航菜單等。平臺

主題定制

支持多種主題，搭建可通過(guò)修改配置文件切換主題，網(wǎng)站文件網(wǎng)站或克隆官方主題倉庫進(jìn)行二次開(kāi)發(fā)。平臺

二、搭ヽ(′▽?zhuān)?/建使用 MkDocs 搭建文檔網(wǎng)站

M??kDocs是另一個(gè)流行的靜態(tài)網(wǎng)站生成器，以 Markdown 為基礎，適合技術(shù)文檔和項目文(′ω｀*)檔。

1. 安裝與項目創(chuàng )建

安裝 MkDoc(′_ゝ`)s

通過(guò) pip 安裝：

```bash

pip install mkdocs

```

創(chuàng )建新項目

```bash

mkdocs new my_docs

```

生成 `mkdocs.yml` 配置文件和 `docs` 文檔(??ヮ?)?*:???目錄。

2. 配置與內容填充

編輯配置文件

在 `mkdocs.yml` 中設置站┐(′?｀)┌點(diǎn)名稱(chēng)、??URL、導航結構等。

編寫(xiě)文檔

使用 Markdown 編寫(xiě)文檔，存入 `docs` 目錄。??

啟動(dòng)本??地服務(wù)器

運行命令預覽網(wǎng)站：

```bash

mkd??ocs serve

```

訪(fǎng)問(wèn) `http://localhost:8000/` 查看效果。

三、注意事項

靜態(tài)文件服務(wù)器

Docsify 和 MkDocs 無(wú)需單獨安裝服務(wù)器軟件，直接通??過(guò) `s??e(╬?益?)rve` 命令啟動(dòng)即可。

部署選項

靜態(tài)網(wǎng)站托管：

將生成的 `site` 目錄部署到 GitHub Pages、Netlify 等平臺。

自建服務(wù)器：配置 Nginx/Apache 服務(wù)器，將靜態(tài)文件目錄指向(xiang) `site` 目錄。

擴展功能(??ヮ?)?*:???

插件支持：

Docsify 提供插件擴展功能，??MkDocs 可通過(guò) `mkdocs plugins` 管理插件。

動(dòng)態(tài)內容：若需動(dòng)態(tài)內容，可結合后端語(yǔ)言（如 Python、Node.js）使用。

Docsify 和 MkDocs 都是輕量化的文檔網(wǎng)站搭建工具，選擇時(shí)可根據需求：

Docsify：適合純文檔展示，易用性高，支持主題擴展。

MkDocs：適合技術(shù)文檔，集成 Markdown 編輯器，適合團隊協(xié)作。

通過(guò)以上步驟，你可(ke)以在本地快速搭建文(′▽?zhuān)?)檔網(wǎng)站，并根據需求進(jìn)行定制和部署。