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

根據你的網(wǎng)站文件網(wǎng)站需求，以(yi)下是平臺使用 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. 安裝與初始化

安裝 Docsify CLI

在終端運行以下命令安裝全局工具：

```bash

npm i docsify-cli -g

```

創(chuàng )建(jian)項目目錄

```bash

mkdir docsify-demo

cd docsify-demo

```

初始化 Docsify

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

```bash

docsify init

```

本地預覽

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

```bash

docsif??y serve

```

訪(fǎng)問(wèn) `httpヽ(′▽?zhuān)?ノ://localhost:30ヾ(?■_■)ノ00/` 即可查看效果(guo)。平臺

修改配置文件

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

主題定制

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

二、搭建使用 MkDocs 搭建文檔網(wǎng)站

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

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

安裝 MkDocs

通過(guò) pip 安裝：

``??`bash

pip install mkdocs

創(chuàng )建新項目

```bash

mkdocs new my_d??ocs

```

生成 `mkdocs( ?ヮ?).yml(′ω｀)` 配置文件和 `docs` 文檔目(′▽?zhuān)?錄。

2. 配置與內容填充

編輯配置文件

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

編寫(xiě)文檔

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

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

```bash

mkdocs serve

```

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

三、注意事項

靜ヽ(′▽?zhuān)?/態(tài)文件服務(wù)器

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

部署選項

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

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

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

擴展功能

插件支持：

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

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

四、總(zong)結

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

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

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

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