u
This commit is contained in:
oneao committed
1 parent
3ef263f5cc
commit
b19241d695
10 files changed
+543
-124
No files matched your search
@@ -0,0 +1,3 @@
|
|||||||
|
PostgreSQL（常简称“Postgres”）是一款强调可扩展性和标准兼容性的对象关系型数据库管理系统（ORDBMS）。作为数据库服务器，其核心功能是安全存储数据并支持最佳实践，同时支持本地或网络（含互联网）中的应用程序按需检索数据。它可处理从小型单机应用到高并发互联网应用的各类负载，最新版本还支持数据库复制以提升安全性和可扩展性。
|
||||||
|
|
||||||
|
PostgreSQL 实现了 SQL:2011 标准的大部分功能，支持 ACID 事务（含多数 DDL 语句），通过多版本并发控制（MVCC）避免锁竞争，提供防脏读和完全可序列化能力。它支持复杂 SQL 查询、多种索引类型、可更新视图、物化视图、触发器、外键，以及函数和存储过程，并拥有丰富的第三方扩展。此外，PostgreSQL 支持从其他数据库迁移，通过标准 SQL 兼容和迁移工具，甚至可通过内置或第三方扩展模拟专有数据库的特性（如 Oracle）。
|
||||||
@@ -0,0 +1,15 @@
|
|||||||
|
## Docker安装
|
||||||
|
dockerhub网站：https://hub.docker.com/_/postgres
|
||||||
|
|
||||||
|
1. 拉取
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker pull postgres@18
|
||||||
|
```
|
||||||
|
2. 运行
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker run --name postgres18 -e POSTGRES_PASSWORD=xxx -p 5432:5432 -d postgres:18
|
||||||
|
```
|
||||||
|
|
||||||
|
> 初始化数据库：postgres 默认用户名：postgres
|
||||||
@@ -0,0 +1,15 @@
|
|||||||
|
Docker 是一个 容器化平台，可以让你把应用程序和它运行所需的环境打包在一起，形成一个独立的“容器”。
|
||||||
|
简单来说，它就像一个轻量级的虚拟机，但比虚拟机更快、更省资源。
|
||||||
|
|
||||||
|
## 概念
|
||||||
|
1. 镜像（Image）
|
||||||
|
- 镜像是一个 只读模板，包含应用程序和依赖环境。
|
||||||
|
- 可以理解为应用的快照，像“配方”。
|
||||||
|
2. 容器（Container）
|
||||||
|
- 容器是镜像的 运行实例，可以启动、停止、删除。
|
||||||
|
- 可以理解为根据配方做出来的“饭菜”。
|
||||||
|
3. Dockerfile
|
||||||
|
- 用来定义镜像内容的文件，相当于“配方清单”。
|
||||||
|
- 里面写明了基础镜像、依赖、环境变量、运行命令等。
|
||||||
|
4. Docker Hub
|
||||||
|
- 官方提供的镜像仓库，可以下载别人已经打包好的镜像，也可以上传自己的镜像。
|
||||||
@@ -0,0 +1,291 @@
|
|||||||
|
## 快速安装
|
||||||
|
|
||||||
|
轩辕提供的安装脚本：
|
||||||
|
|
||||||
|
```bash
|
||||||
|
bash <(wget -qO- https://xuanyuan.cloud/docker.sh)
|
||||||
|
```
|
||||||
|
|
||||||
|
> 参考网站：https://zhuanlan.zhihu.com/p/24461370776
|
||||||
|
|
||||||
|
## 脚本安装
|
||||||
|
|
||||||
|
### 对于基于Debian的系统（如Ubuntu、Debian）
|
||||||
|
|
||||||
|
```bash
|
||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
# -------------------------
|
||||||
|
# 1️⃣ 卸载旧版本 Docker
|
||||||
|
# -------------------------
|
||||||
|
sudo apt-get remove -y \
|
||||||
|
docker \
|
||||||
|
docker-engine \
|
||||||
|
docker.io \
|
||||||
|
containerd \
|
||||||
|
runc \
|
||||||
|
docker-ce \
|
||||||
|
docker-ce-cli \
|
||||||
|
containerd.io \
|
||||||
|
docker-compose-plugin
|
||||||
|
|
||||||
|
# 可选：清理残留数据（慎用，会删除容器和镜像）
|
||||||
|
# sudo rm -rf /var/lib/docker /var/lib/containerd
|
||||||
|
|
||||||
|
echo "旧版本 Docker 已卸载（如果存在）"
|
||||||
|
|
||||||
|
# -------------------------
|
||||||
|
# 2️⃣ 更新软件包列表并安装必要依赖
|
||||||
|
# -------------------------
|
||||||
|
sudo apt-get update
|
||||||
|
sudo apt-get install -y ca-certificates curl software-properties-common lsb-release
|
||||||
|
|
||||||
|
# -------------------------
|
||||||
|
# 3️⃣ 创建密钥存储目录
|
||||||
|
# -------------------------
|
||||||
|
sudo install -m 0755 -d /etc/apt/keyrings
|
||||||
|
|
||||||
|
# -------------------------
|
||||||
|
# 4️⃣ 下载Docker官方GPG密钥
|
||||||
|
# -------------------------
|
||||||
|
sudo curl -fsSL https://download.docker.com/linux/$(. /etc/os-release; echo "$ID")/gpg -o /etc/apt/keyrings/docker.asc
|
||||||
|
sudo chmod a+r /etc/apt/keyrings/docker.asc
|
||||||
|
|
||||||
|
# -------------------------
|
||||||
|
# 5️⃣ 添加 Docker 仓库
|
||||||
|
# -------------------------
|
||||||
|
if [ "$(lsb_release -is)" = "Ubuntu" ]; then
|
||||||
|
echo \
|
||||||
|
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
|
||||||
|
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
|
||||||
|
elif [ "$(lsb_release -is)" = "Debian" ]; then
|
||||||
|
echo \
|
||||||
|
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
|
||||||
|
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
|
||||||
|
fi
|
||||||
|
|
||||||
|
sudo apt-get update
|
||||||
|
echo "Docker 仓库已添加。"
|
||||||
|
|
||||||
|
# -------------------------
|
||||||
|
# 6️⃣ 安装 Docker 及相关组件
|
||||||
|
# -------------------------
|
||||||
|
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
|
||||||
|
|
||||||
|
echo "Docker 安装完成 ✅"
|
||||||
|
```
|
||||||
|
|
||||||
|
### 对于基于RHEL的系统（如CentOS、RHEL）
|
||||||
|
|
||||||
|
```bash
|
||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
# -------------------------
|
||||||
|
# 1️⃣ 卸载旧版本 Docker
|
||||||
|
# -------------------------
|
||||||
|
sudo yum remove -y docker \
|
||||||
|
docker-client \
|
||||||
|
docker-client-latest \
|
||||||
|
docker-common \
|
||||||
|
docker-latest \
|
||||||
|
docker-latest-logrotate \
|
||||||
|
docker-logrotate \
|
||||||
|
docker-engine \
|
||||||
|
docker-ce \
|
||||||
|
docker-ce-cli \
|
||||||
|
containerd.io \
|
||||||
|
docker-compose-plugin
|
||||||
|
|
||||||
|
echo "旧版本 Docker 已卸载（如果存在）"
|
||||||
|
|
||||||
|
# -------------------------
|
||||||
|
# 2️⃣ 安装 yum 配置管理工具
|
||||||
|
# -------------------------
|
||||||
|
sudo yum install -y yum-utils
|
||||||
|
|
||||||
|
# -------------------------
|
||||||
|
# 3️⃣ 检测系统发行版并添加 Docker 仓库
|
||||||
|
# -------------------------
|
||||||
|
if [ -f /etc/centos-release ]; then
|
||||||
|
# CentOS 系统
|
||||||
|
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
|
||||||
|
elif [ -f /etc/redhat-release ]; then
|
||||||
|
# RHEL 系统
|
||||||
|
# 注意：RHEL 用户需要启用订阅管理仓库
|
||||||
|
sudo yum-config-manager --add-repo https://download.docker.com/linux/rhel/docker-ce.repo
|
||||||
|
else
|
||||||
|
echo "未识别的发行版，脚本退出。"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# -------------------------
|
||||||
|
# 4️⃣ 更新 yum 缓存
|
||||||
|
# -------------------------
|
||||||
|
sudo yum makecache fast
|
||||||
|
echo "Docker 仓库已添加。"
|
||||||
|
|
||||||
|
# -------------------------
|
||||||
|
# 5️⃣ 安装 Docker 及相关组件
|
||||||
|
# -------------------------
|
||||||
|
sudo yum install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
|
||||||
|
|
||||||
|
echo "Docker 安装完成 ✅"
|
||||||
|
```
|
||||||
|
|
||||||
|
### 通用脚本
|
||||||
|
|
||||||
|
```bash
|
||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
set -e
|
||||||
|
|
||||||
|
# -------------------------
|
||||||
|
# 1️⃣ 卸载旧版本 Docker
|
||||||
|
# -------------------------
|
||||||
|
remove_old_docker() {
|
||||||
|
if command -v apt-get >/dev/null 2>&1; then
|
||||||
|
sudo apt-get remove -y docker docker-engine docker.io containerd runc docker-ce docker-ce-cli containerd.io docker-compose-plugin || true
|
||||||
|
elif command -v yum >/dev/null 2>&1; then
|
||||||
|
sudo yum remove -y docker \
|
||||||
|
docker-client \
|
||||||
|
docker-client-latest \
|
||||||
|
docker-common \
|
||||||
|
docker-latest \
|
||||||
|
docker-latest-logrotate \
|
||||||
|
docker-logrotate \
|
||||||
|
docker-engine \
|
||||||
|
docker-ce \
|
||||||
|
docker-ce-cli \
|
||||||
|
containerd.io \
|
||||||
|
docker-compose-plugin || true
|
||||||
|
fi
|
||||||
|
echo "旧版本 Docker 已卸载（如果存在）"
|
||||||
|
}
|
||||||
|
|
||||||
|
# -------------------------
|
||||||
|
# 2️⃣ 安装 Docker（DEB 系统）
|
||||||
|
# -------------------------
|
||||||
|
install_docker_deb() {
|
||||||
|
local distro=$1
|
||||||
|
local codename=$2
|
||||||
|
sudo apt-get update
|
||||||
|
sudo apt-get install -y apt-transport-https ca-certificates curl software-properties-common lsb-release
|
||||||
|
sudo install -m 0755 -d /etc/apt/keyrings
|
||||||
|
sudo curl -fsSL "https://download.docker.com/linux/$distro/gpg" -o /etc/apt/keyrings/docker.asc
|
||||||
|
sudo chmod a+r /etc/apt/keyrings/docker.asc
|
||||||
|
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/$distro $codename stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
|
||||||
|
sudo apt-get update
|
||||||
|
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
|
||||||
|
sudo systemctl enable --now docker
|
||||||
|
}
|
||||||
|
|
||||||
|
# -------------------------
|
||||||
|
# 3️⃣ 安装 Docker（RPM 系统）
|
||||||
|
# -------------------------
|
||||||
|
install_docker_rpm() {
|
||||||
|
local distro=$1
|
||||||
|
if [ "$distro" = "fedora" ]; then
|
||||||
|
sudo dnf -y install dnf-plugins-core
|
||||||
|
else
|
||||||
|
sudo yum install -y yum-utils
|
||||||
|
fi
|
||||||
|
sudo yum-config-manager --add-repo "https://download.docker.com/linux/$distro/docker-ce.repo"
|
||||||
|
sudo yum makecache fast
|
||||||
|
sudo yum install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
|
||||||
|
sudo systemctl enable --now docker
|
||||||
|
}
|
||||||
|
|
||||||
|
# -------------------------
|
||||||
|
# 4️⃣ 主流程
|
||||||
|
# -------------------------
|
||||||
|
remove_old_docker
|
||||||
|
|
||||||
|
# 检测 Linux 发行版
|
||||||
|
if [ -f /etc/os-release ]; then
|
||||||
|
. /etc/os-release
|
||||||
|
else
|
||||||
|
echo "无法确定您的 Linux 发行版。"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
case $ID in
|
||||||
|
ubuntu|debian|raspbian)
|
||||||
|
echo "检测到 $ID $VERSION_CODENAME，开始安装 Docker..."
|
||||||
|
install_docker_deb $ID $VERSION_CODENAME
|
||||||
|
;;
|
||||||
|
centos|rhel|fedora|sles)
|
||||||
|
echo "检测到 $ID，开始安装 Docker..."
|
||||||
|
install_docker_rpm $ID
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
echo "不支持的 Linux 发行版：$ID"
|
||||||
|
exit 1
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
echo "Docker 及 Docker Compose 安装完成 ✅"
|
||||||
|
```
|
||||||
|
|
||||||
|
### 运行脚本
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 1.创建脚本
|
||||||
|
vim docker-script.sh
|
||||||
|
|
||||||
|
# 2.输入内容 i 进行编辑模式， :wq 保存
|
||||||
|
|
||||||
|
# 3.赋予权限
|
||||||
|
chmod +x docker-script.sh
|
||||||
|
|
||||||
|
# 4.运行脚本
|
||||||
|
./docker-script.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
## 镜像设置
|
||||||
|
|
||||||
|
不设置镜像会导致拉取速度非常慢
|
||||||
|
访问 https://api.suoyinmulu.com/open/v1/docker-hub/seeded-up/lists 获取最新的docker镜像，将 list 中的内容拷贝到 docker 中的 registry-mirrors 中。
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo vim /etc/docker/daemon.json
|
||||||
|
```
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"registry-mirrors": [
|
||||||
|
// list
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
刷新：
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo systemctl daemon-reload && sudo systemctl restart docker
|
||||||
|
```
|
||||||
|
|
||||||
|
## 问题
|
||||||
|
### 权限不足
|
||||||
|
1. 添加docker用户组（默认有）
|
||||||
|
|
||||||
|
```
|
||||||
|
sudo groupadd docker
|
||||||
|
```
|
||||||
|
|
||||||
|
2. 添加当前用户到docker组中
|
||||||
|
|
||||||
|
```
|
||||||
|
sudo gpasswd -a $USER docker
|
||||||
|
```
|
||||||
|
|
||||||
|
3. 更新用户组
|
||||||
|
|
||||||
|
```
|
||||||
|
newgrp docker
|
||||||
|
```
|
||||||
|
|
||||||
|
4. 重启生效 或 提前执行（建议重启）
|
||||||
|
|
||||||
|
```
|
||||||
|
sudo chown root:docker /var/run/docker.sock
|
||||||
|
```
|
||||||
File renamed without changes.
@@ -1,123 +0,0 @@
|
|||||||
关于文档的创建和配置
|
|
||||||
|
|
||||||
## 1. navbar 配置
|
|
||||||
|
|
||||||
在 `docusaurus.config.ts` 文件中进行配置， `config` - `themeConfig` - `navbar` - `items`
|
|
||||||
|
|
||||||
### 1.1 单级导航
|
|
||||||
|
|
||||||
在 `docs` 文件夹下创建 `test.md` 文件，并在 `items` 配置项中添加：
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
// ...
|
|
||||||
"items": [
|
|
||||||
{
|
|
||||||
"to": "/docs/test",
|
|
||||||
"label": "test"
|
|
||||||
}
|
|
||||||
]
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
刷新页面，即可进行预览
|
|
||||||
|
|
||||||
### 1.2 多级导航
|
|
||||||
|
|
||||||
docusaurus 的 navbar 最多支持两级导航，比如：
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
// ...
|
|
||||||
"items": [
|
|
||||||
{
|
|
||||||
"type": "dropdown",
|
|
||||||
"label": "编程语言",
|
|
||||||
"position": "left",
|
|
||||||
"items": [
|
|
||||||
{
|
|
||||||
"label": "Stack Overflow",
|
|
||||||
"href": "https://stackoverflow.com/questions/tagged/docusaurus"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"label": "Discord",
|
|
||||||
"href": "https://discordapp.com/invite/docusaurus"
|
|
||||||
}
|
|
||||||
]
|
|
||||||
}
|
|
||||||
]
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
## 2. 侧边栏配置
|
|
||||||
|
|
||||||
docs 的侧边栏配置主要在 `sidebars.ts` 文件中
|
|
||||||
|
|
||||||
### 2.1 自动生成
|
|
||||||
|
|
||||||
在 docs 目录中创建 `coding/java` 目录，在 `sidebar.ts` 文件中添加配置：
|
|
||||||
|
|
||||||
```ts
|
|
||||||
import type { SidebarsConfig } from '@docusaurus/plugin-content-docs'
|
|
||||||
|
|
||||||
const sidebars: SidebarsConfig = {
|
|
||||||
// coding 目录下的自动生成的 Java 相关文档
|
|
||||||
javaSidebar: [{ type: 'autogenerated', dirName: 'coding/java' }]
|
|
||||||
}
|
|
||||||
|
|
||||||
export default sidebars
|
|
||||||
```
|
|
||||||
|
|
||||||
修改 `docusaurus.config.ts` 文件：
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
// ...
|
|
||||||
"items": [
|
|
||||||
{
|
|
||||||
"type": "dropdown",
|
|
||||||
"label": "编程语言",
|
|
||||||
"position": "left",
|
|
||||||
"items": [
|
|
||||||
{
|
|
||||||
"type": "docSidebar",
|
|
||||||
"label": "Java",
|
|
||||||
"sidebarId": "javaSidebar"
|
|
||||||
}
|
|
||||||
]
|
|
||||||
}
|
|
||||||
]
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
提示：
|
|
||||||
|
|
||||||
- `sidebarId` 需要和 `SidebarsConfig` 中的 key 保持一致
|
|
||||||
- `type: 'autogenerated'` 表示自动生成
|
|
||||||
- **自动生成模式下 将自动根据目录和目录下的文件自动构建侧边栏**
|
|
||||||
|
|
||||||
### 2.2 手动配置
|
|
||||||
|
|
||||||
```ts
|
|
||||||
import type { SidebarsConfig } from '@docusaurus/plugin-content-docs'
|
|
||||||
|
|
||||||
const sidebars: SidebarsConfig = {
|
|
||||||
// 手动配置的侧边栏
|
|
||||||
javaSidebar: [
|
|
||||||
{
|
|
||||||
type: 'category',
|
|
||||||
label: 'Java 基础',
|
|
||||||
items: ['coding/java/intro', 'coding/java/advanced'],
|
|
||||||
},
|
|
||||||
{
|
|
||||||
type: 'category',
|
|
||||||
label: 'Java 框架',
|
|
||||||
items: ['coding/java/spring-boot', 'coding/java/hibernate'],
|
|
||||||
},
|
|
||||||
]
|
|
||||||
}
|
|
||||||
|
|
||||||
export default sidebars
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
@@ -0,0 +1,196 @@
|
|||||||
|
关于文档的创建和配置
|
||||||
|
|
||||||
|
## navbar 配置
|
||||||
|
|
||||||
|
在 `docusaurus.config.ts` 文件中进行配置， `config` - `themeConfig` - `navbar` - `items`
|
||||||
|
|
||||||
|
### 单级导航
|
||||||
|
|
||||||
|
在 `docs` 文件夹下创建 `test.md` 文件，并在 `items` 配置项中添加：
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
// ...
|
||||||
|
"items": [
|
||||||
|
{
|
||||||
|
"to": "/docs/test",
|
||||||
|
"label": "test"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
刷新页面，即可进行预览
|
||||||
|
|
||||||
|
### 多级导航
|
||||||
|
|
||||||
|
docusaurus 的 navbar 最多支持两级导航，比如：
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
// ...
|
||||||
|
"items": [
|
||||||
|
{
|
||||||
|
"type": "dropdown",
|
||||||
|
"label": "编程语言",
|
||||||
|
"position": "left",
|
||||||
|
"items": [
|
||||||
|
{
|
||||||
|
"label": "Stack Overflow",
|
||||||
|
"href": "https://stackoverflow.com/questions/tagged/docusaurus"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"label": "Discord",
|
||||||
|
"href": "https://discordapp.com/invite/docusaurus"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 图标配置
|
||||||
|
|
||||||
|
以 Github 图标为例
|
||||||
|
修改 `docusaurus.config.ts` 文件：
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
// ...
|
||||||
|
"items": [
|
||||||
|
{
|
||||||
|
"aria-label": "GitHub Repository",
|
||||||
|
"className": "navbar--github-link",
|
||||||
|
"href": "https://github.com/oneao",
|
||||||
|
"position": "right",
|
||||||
|
"title": "Github"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
在 `src/css/custom.css` 中添加以下内容：
|
||||||
|
|
||||||
|
```css
|
||||||
|
.navbar--github-link {
|
||||||
|
width: 2rem;
|
||||||
|
height: 2rem;
|
||||||
|
padding: 0.25rem;
|
||||||
|
margin: 0rem 0.2rem;
|
||||||
|
border-radius: 50%;
|
||||||
|
transition: background var(--ifm-transition-fast);
|
||||||
|
}
|
||||||
|
|
||||||
|
.navbar--github-link:hover {
|
||||||
|
background: var(--ifm-color-emphasis-200);
|
||||||
|
}
|
||||||
|
|
||||||
|
.navbar--github-link:before {
|
||||||
|
content: '';
|
||||||
|
height: 100%;
|
||||||
|
display: block;
|
||||||
|
background: url("data:image/svg+xml,%3Csvg viewBox='0 0 24 24' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath d='M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12'/%3E%3C/svg%3E")
|
||||||
|
no-repeat;
|
||||||
|
}
|
||||||
|
|
||||||
|
html[data-theme='dark'] .navbar--github-link:before {
|
||||||
|
background: url("data:image/svg+xml,%3Csvg viewBox='0 0 24 24' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath fill='white' d='M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12'/%3E%3C/svg%3E")
|
||||||
|
no-repeat;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* 兼容屏幕过小情况，转为文字 */
|
||||||
|
@media screen and (max-width: 996px) {
|
||||||
|
.navbar--github-link {
|
||||||
|
margin: 0rem;
|
||||||
|
padding: var(--ifm-menu-link-padding-vertical) var(--ifm-menu-link-padding-horizontal);
|
||||||
|
line-height: 1.25;
|
||||||
|
width: 100%;
|
||||||
|
color: var(--ifm-menu-color);
|
||||||
|
font-size: 1rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
.navbar--github-link::before {
|
||||||
|
content: 'GitHub';
|
||||||
|
background-image: none;
|
||||||
|
}
|
||||||
|
|
||||||
|
[data-theme='dark'] .navbar--github-link::before {
|
||||||
|
content: 'GitHub';
|
||||||
|
background-image: none;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
提供两个工具网站仅供参考：
|
||||||
|
- svg 图标库：https://www.svgrepo.com/
|
||||||
|
- svg 转 url 编码：https://yoksel.github.io/url-encoder/zh-cn/
|
||||||
|
|
||||||
|
## 侧边栏配置
|
||||||
|
|
||||||
|
docs 的侧边栏配置主要在 `sidebars.ts` 文件中
|
||||||
|
|
||||||
|
### 自动生成
|
||||||
|
|
||||||
|
在 docs 目录中创建 `coding/java` 目录，在 `sidebar.ts` 文件中添加配置：
|
||||||
|
|
||||||
|
```ts
|
||||||
|
import type { SidebarsConfig } from '@docusaurus/plugin-content-docs'
|
||||||
|
|
||||||
|
const sidebars: SidebarsConfig = {
|
||||||
|
// coding 目录下的自动生成的 Java 相关文档
|
||||||
|
javaSidebar: [{ type: 'autogenerated', dirName: 'coding/java' }]
|
||||||
|
}
|
||||||
|
|
||||||
|
export default sidebars
|
||||||
|
```
|
||||||
|
|
||||||
|
修改 `docusaurus.config.ts` 文件：
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
// ...
|
||||||
|
"items": [
|
||||||
|
{
|
||||||
|
"type": "dropdown",
|
||||||
|
"label": "编程语言",
|
||||||
|
"position": "left",
|
||||||
|
"items": [
|
||||||
|
{
|
||||||
|
"type": "docSidebar",
|
||||||
|
"label": "Java",
|
||||||
|
"sidebarId": "javaSidebar"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
提示：
|
||||||
|
|
||||||
|
- `sidebarId` 需要和 `SidebarsConfig` 中的 key 保持一致
|
||||||
|
- `type: 'autogenerated'` 表示自动生成
|
||||||
|
- **自动生成模式下 将自动根据目录和目录下的文件自动构建侧边栏**
|
||||||
|
|
||||||
|
### 手动配置
|
||||||
|
|
||||||
|
```ts
|
||||||
|
import type { SidebarsConfig } from '@docusaurus/plugin-content-docs'
|
||||||
|
|
||||||
|
const sidebars: SidebarsConfig = {
|
||||||
|
// 手动配置的侧边栏
|
||||||
|
javaSidebar: [
|
||||||
|
{
|
||||||
|
type: 'category',
|
||||||
|
label: 'Java 基础',
|
||||||
|
items: ['coding/java/intro', 'coding/java/advanced'],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
type: 'category',
|
||||||
|
label: 'Java 框架',
|
||||||
|
items: ['coding/java/spring-boot', 'coding/java/hibernate'],
|
||||||
|
},
|
||||||
|
]
|
||||||
|
}
|
||||||
|
|
||||||
|
export default sidebars
|
||||||
|
```
|
||||||
@@ -113,6 +113,23 @@ const config: Config = {
|
|||||||
label: 'Git',
|
label: 'Git',
|
||||||
sidebarId: 'GitSidebar',
|
sidebarId: 'GitSidebar',
|
||||||
},
|
},
|
||||||
|
{
|
||||||
|
type: 'docSidebar',
|
||||||
|
label: 'Docker',
|
||||||
|
sidebarId: 'DockerSidebar',
|
||||||
|
},
|
||||||
|
],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
type: 'dropdown',
|
||||||
|
label: '数据库',
|
||||||
|
position: 'left',
|
||||||
|
items: [
|
||||||
|
{
|
||||||
|
type: 'docSidebar',
|
||||||
|
label: 'PostgreSQL',
|
||||||
|
sidebarId: 'PostgreSQLSidebar',
|
||||||
|
},
|
||||||
],
|
],
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
|
|||||||
@@ -8,6 +8,11 @@ const sidebars: SidebarsConfig = {
|
|||||||
// dev-tools
|
// dev-tools
|
||||||
DocusaurusSidebar: [{ type: "autogenerated", dirName: "dev-tools/docusaurus" }],
|
DocusaurusSidebar: [{ type: "autogenerated", dirName: "dev-tools/docusaurus" }],
|
||||||
GitSidebar: [{ type: "autogenerated", dirName: "dev-tools/git" }],
|
GitSidebar: [{ type: "autogenerated", dirName: "dev-tools/git" }],
|
||||||
|
DockerSidebar: [{ type: "autogenerated", dirName: "dev-tools/docker" }],
|
||||||
|
|
||||||
|
// database
|
||||||
|
PostgreSQLSidebar: [{ type: "autogenerated", dirName: "database/postgresql" }],
|
||||||
|
|
||||||
};
|
};
|
||||||
|
|
||||||
export default sidebars;
|
export default sidebars;
|
||||||
@@ -113,7 +113,7 @@ html[data-theme="dark"] .navbar--email-link:before {
|
|||||||
background-image: none;
|
background-image: none;
|
||||||
}
|
}
|
||||||
|
|
||||||
[data-theme="dark"] .navbar--github-link::before {
|
[data-theme="dark"] .navbar--gitee-link::before {
|
||||||
content: "Gitee";
|
content: "Gitee";
|
||||||
background-image: none;
|
background-image: none;
|
||||||
}
|
}
|
||||||
|
|||||||
Reference in new issue
Block a user