新增頁面格式規則（STE100、繁體中文與圖表）、全書上下頁導覽
jsc-wiki
@@ -15,3 +15,8 @@ sudo timedatectl set-timezone Asia/Taipei
|
||||
```
|
||||
|
||||
設定後可用 `timedatectl` 確認時區是否已套用。
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 第1章 系統維護](%E7%AC%AC1%E7%AB%A0-%E7%B3%BB%E7%B5%B1%E7%B6%AD%E8%AD%B7) · [本章目錄](%E7%AC%AC1%E7%AB%A0-%E7%B3%BB%E7%B5%B1%E7%B6%AD%E8%AD%B7) · [全書目錄](Home) · [1.2 延展系統硬碟 →](1.2-%E5%BB%B6%E5%B1%95%E7%B3%BB%E7%B5%B1%E7%A1%AC%E7%A2%9F)
|
||||
|
||||
@@ -89,3 +89,8 @@ sudo lvextend -l +100%FREE /dev/ubuntu-vg/ubuntu-lv
|
||||
```bash
|
||||
sudo resize2fs /dev/ubuntu-vg/ubuntu-lv
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 1.1 修改成台北時區](1.1-%E4%BF%AE%E6%94%B9%E6%88%90%E5%8F%B0%E5%8C%97%E6%99%82%E5%8D%80) · [本章目錄](%E7%AC%AC1%E7%AB%A0-%E7%B3%BB%E7%B5%B1%E7%B6%AD%E8%AD%B7) · [全書目錄](Home) · [1.3 憑證 x509 問題 →](1.3-%E6%86%91%E8%AD%89-x509-%E5%95%8F%E9%A1%8C)
|
||||
|
||||
@@ -59,3 +59,8 @@ Ubuntu 24.04 存放於以下位置：
|
||||
```
|
||||
|
||||
將剛剛查詢到的憑證金鑰，貼到 `ca-certificates.crt` 檔案的最後即可。
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 1.2 延展系統硬碟](1.2-%E5%BB%B6%E5%B1%95%E7%B3%BB%E7%B5%B1%E7%A1%AC%E7%A2%9F) · [本章目錄](%E7%AC%AC1%E7%AB%A0-%E7%B3%BB%E7%B5%B1%E7%B6%AD%E8%AD%B7) · [全書目錄](Home) · [1.4 進入 busybox 問題 →](1.4-%E9%80%B2%E5%85%A5-busybox-%E5%95%8F%E9%A1%8C)
|
||||
|
||||
@@ -31,3 +31,8 @@ fsck -y /dev/mapper/ubuntu--vg-ubuntu--lv
|
||||
```bash
|
||||
exit
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 1.3 憑證 x509 問題](1.3-%E6%86%91%E8%AD%89-x509-%E5%95%8F%E9%A1%8C) · [本章目錄](%E7%AC%AC1%E7%AB%A0-%E7%B3%BB%E7%B5%B1%E7%B6%AD%E8%AD%B7) · [全書目錄](Home) · [1.5 Kernel Panic：VFS 無法掛載 root fs →](1.5-Kernel-Panic%EF%BC%9AVFS-%E7%84%A1%E6%B3%95%E6%8E%9B%E8%BC%89-root-fs)
|
||||
|
||||
@@ -55,3 +55,8 @@ sudo apt update && sudo apt upgrade -y
|
||||
```bash
|
||||
sudo reboot
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 1.4 進入 busybox 問題](1.4-%E9%80%B2%E5%85%A5-busybox-%E5%95%8F%E9%A1%8C) · [本章目錄](%E7%AC%AC1%E7%AB%A0-%E7%B3%BB%E7%B5%B1%E7%B6%AD%E8%AD%B7) · [全書目錄](Home) · [1.6 常用工具 →](1.6-%E5%B8%B8%E7%94%A8%E5%B7%A5%E5%85%B7)
|
||||
|
||||
+5
@@ -41,3 +41,8 @@ curl -fsSL https://herdr.dev/install.sh | sh
|
||||
```bash
|
||||
herdr integration install claude && herdr integration install codex
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 1.5 Kernel Panic：VFS 無法掛載 root fs](1.5-Kernel-Panic%EF%BC%9AVFS-%E7%84%A1%E6%B3%95%E6%8E%9B%E8%BC%89-root-fs) · [本章目錄](%E7%AC%AC1%E7%AB%A0-%E7%B3%BB%E7%B5%B1%E7%B6%AD%E8%AD%B7) · [全書目錄](Home) · [1.7 使用舊的右鍵選項 →](1.7-%E4%BD%BF%E7%94%A8%E8%88%8A%E7%9A%84%E5%8F%B3%E9%8D%B5%E9%81%B8%E9%A0%85)
|
||||
|
||||
@@ -11,3 +11,8 @@
|
||||
```powershell
|
||||
reg add “HKCU\Software\Classes\CLSID\{86ca1aa0-34aa-4e8b-a509-50c905bae2a2}\InprocServer32” /f /ve
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 1.6 常用工具](1.6-%E5%B8%B8%E7%94%A8%E5%B7%A5%E5%85%B7) · [本章目錄](%E7%AC%AC1%E7%AB%A0-%E7%B3%BB%E7%B5%B1%E7%B6%AD%E8%AD%B7) · [全書目錄](Home) · [第2章 網路與儲存 →](%E7%AC%AC2%E7%AB%A0-%E7%B6%B2%E8%B7%AF%E8%88%87%E5%84%B2%E5%AD%98)
|
||||
|
||||
@@ -56,3 +56,8 @@ network:
|
||||
- to: "0.0.0.0/0"
|
||||
metric: 100
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 第2章 網路與儲存](%E7%AC%AC2%E7%AB%A0-%E7%B6%B2%E8%B7%AF%E8%88%87%E5%84%B2%E5%AD%98) · [本章目錄](%E7%AC%AC2%E7%AB%A0-%E7%B6%B2%E8%B7%AF%E8%88%87%E5%84%B2%E5%AD%98) · [全書目錄](Home) · [2.2 53 埠被占用 →](2.2-53-%E5%9F%A0%E8%A2%AB%E5%8D%A0%E7%94%A8)
|
||||
|
||||
@@ -47,3 +47,8 @@ sudo ln -sf /run/systemd/resolve/resolv.conf /etc/resolv.conf
|
||||
```bash
|
||||
sudo systemctl restart systemd-resolved
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 2.1 netplan](2.1-netplan) · [本章目錄](%E7%AC%AC2%E7%AB%A0-%E7%B6%B2%E8%B7%AF%E8%88%87%E5%84%B2%E5%AD%98) · [全書目錄](Home) · [2.3 掛載 SMB →](2.3-%E6%8E%9B%E8%BC%89-SMB)
|
||||
|
||||
@@ -75,3 +75,8 @@ systemctl daemon-reload
|
||||
```bash
|
||||
mount -a
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 2.2 53 埠被占用](2.2-53-%E5%9F%A0%E8%A2%AB%E5%8D%A0%E7%94%A8) · [本章目錄](%E7%AC%AC2%E7%AB%A0-%E7%B6%B2%E8%B7%AF%E8%88%87%E5%84%B2%E5%AD%98) · [全書目錄](Home) · [2.4 停用 SMB 服務 →](2.4-%E5%81%9C%E7%94%A8-SMB-%E6%9C%8D%E5%8B%99)
|
||||
|
||||
@@ -25,3 +25,8 @@ Set-Service -Name LanmanServer -StartupType Disabled
|
||||
```powershell
|
||||
Stop-Service -Name LanmanServer -Force
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 2.3 掛載 SMB](2.3-%E6%8E%9B%E8%BC%89-SMB) · [本章目錄](%E7%AC%AC2%E7%AB%A0-%E7%B6%B2%E8%B7%AF%E8%88%87%E5%84%B2%E5%AD%98) · [全書目錄](Home) · [2.5 TGT →](2.5-TGT)
|
||||
|
||||
+5
@@ -52,3 +52,8 @@ nano /etc/tgt/conf.d/target.conf
|
||||
```bash
|
||||
systemctl restart tgt && tgt-admin --show
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 2.4 停用 SMB 服務](2.4-%E5%81%9C%E7%94%A8-SMB-%E6%9C%8D%E5%8B%99) · [本章目錄](%E7%AC%AC2%E7%AB%A0-%E7%B6%B2%E8%B7%AF%E8%88%87%E5%84%B2%E5%AD%98) · [全書目錄](Home) · [2.6 OpenSSH →](2.6-OpenSSH)
|
||||
|
||||
@@ -13,3 +13,8 @@
|
||||
```powershell
|
||||
New-ItemProperty -Path "HKLM:\SOFTWARE\OpenSSH" -Name DefaultShell -Value "C:\Program Files\Git\bin\bash.exe" -PropertyType String -Force
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 2.5 TGT](2.5-TGT) · [本章目錄](%E7%AC%AC2%E7%AB%A0-%E7%B6%B2%E8%B7%AF%E8%88%87%E5%84%B2%E5%AD%98) · [全書目錄](Home) · [2.7 OpenWrt →](2.7-OpenWrt)
|
||||
|
||||
@@ -51,3 +51,8 @@ service network restart
|
||||
Username: root
|
||||
|
||||
Password:
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 2.6 OpenSSH](2.6-OpenSSH) · [本章目錄](%E7%AC%AC2%E7%AB%A0-%E7%B6%B2%E8%B7%AF%E8%88%87%E5%84%B2%E5%AD%98) · [全書目錄](Home) · [2.8 DiskStation Manager →](2.8-DiskStation-Manager)
|
||||
|
||||
@@ -101,3 +101,8 @@ qm importdisk 100 /var/lib/vz/template/iso/rr-25.6.5.img local-lvm
|
||||
啟動引導，待核心載入完成，即可透過連結進入 DSM 設定介面(http://192.168.30.100:5000)
|
||||
|
||||
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 2.7 OpenWrt](2.7-OpenWrt) · [本章目錄](%E7%AC%AC2%E7%AB%A0-%E7%B6%B2%E8%B7%AF%E8%88%87%E5%84%B2%E5%AD%98) · [全書目錄](Home) · [第3章 虛擬化 →](%E7%AC%AC3%E7%AB%A0-%E8%99%9B%E6%93%AC%E5%8C%96)
|
||||
|
||||
@@ -39,3 +39,8 @@ deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription
|
||||
```bash
|
||||
apt clean && apt update
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 第3章 虛擬化](%E7%AC%AC3%E7%AB%A0-%E8%99%9B%E6%93%AC%E5%8C%96) · [本章目錄](%E7%AC%AC3%E7%AB%A0-%E8%99%9B%E6%93%AC%E5%8C%96) · [全書目錄](Home) · [3.2 硬碟直通 →](3.2-%E7%A1%AC%E7%A2%9F%E7%9B%B4%E9%80%9A)
|
||||
|
||||
+5
@@ -26,3 +26,8 @@ lrwxrwxrwx 1 root root 9 Sep 12 23:04 ata-CT2000BX500SSD1_2221E63542A2 -> ../..
|
||||
```bash
|
||||
qm set 253 --sata2 /dev/disk/by-id/ata-CT2000BX500SSD1_2221E63542A2
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 3.1 套件更新設定](3.1-%E5%A5%97%E4%BB%B6%E6%9B%B4%E6%96%B0%E8%A8%AD%E5%AE%9A) · [本章目錄](%E7%AC%AC3%E7%AB%A0-%E8%99%9B%E6%93%AC%E5%8C%96) · [全書目錄](Home) · [3.3 將PCIe直通給PVE的虛擬機 →](3.3-%E5%B0%87PCIe%E7%9B%B4%E9%80%9A%E7%B5%A6PVE%E7%9A%84%E8%99%9B%E6%93%AC%E6%A9%9F)
|
||||
|
||||
@@ -124,3 +124,8 @@ intel_iommu=on iommu=pt
|
||||
```bash
|
||||
proxmox-boot-tool refresh
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 3.2 硬碟直通](3.2-%E7%A1%AC%E7%A2%9F%E7%9B%B4%E9%80%9A) · [本章目錄](%E7%AC%AC3%E7%AB%A0-%E8%99%9B%E6%93%AC%E5%8C%96) · [全書目錄](Home) · [3.4 相關參考紀錄 →](3.4-%E7%9B%B8%E9%97%9C%E5%8F%83%E8%80%83%E7%B4%80%E9%8C%84)
|
||||
|
||||
@@ -16,3 +16,8 @@
|
||||
- [Deploy a DSM VM and Manage Disks Dynamically Using a Script in Proxmox VE](https://kingtam.win/archives/rr-dsm.html)
|
||||
- [2024年PVE8最新安装使用指南](https://post.smzdm.com/p/al82z7ee/)
|
||||
- [Proxmox VE 如何設定直通硬碟【虛擬機Server2016示範教學】](https://eheima.com/5722/pve-qmset-sata#:~:text=%E7%A4%BA%E7%AF%84%E5%A6%82%E4%B8%8B%E5%9C%96%EF%BC%8C%20%E8%80%81%E9%BB%91%20%E5%B0%87%E9%80%99%E6%AC%A1%E6%BA%96%E5%82%99%E7%9A%841TB%E7%A1%AC%E7%A2%9F%E7%9B%B4%E9%80%9A%E7%B5%A6Server2016%E8%99%9B%E6%93%AC%E6%A9%9FVM%20ID%E7%82%BA100%EF%BC%8C%E4%B8%A6%E6%8E%9B%E5%9C%A8%E8%99%9B%E6%93%AC%E6%A9%9Fsata2%E7%9A%84%E4%BD%8D%E7%BD%AE%EF%BC%8C%20%E4%B8%A6%E5%B0%87%E7%AC%AC%E4%BA%8C%E6%AD%A5%E9%A9%9F%E6%9F%A5%E8%A9%A2%E5%87%BA%E4%BE%86%E7%9A%84%E7%A1%AC%E7%A2%9FID%E8%B2%BC%E5%9C%A8%E6%8C%87%E4%BB%A4%E7%AF%84%E6%9C%AC%E7%9A%84%E6%9C%80%E5%BE%8C%EF%BC%8C,%E7%B5%84%E5%90%88%E5%BE%8C%E6%88%91%E8%A6%81%E7%9B%B4%E9%80%9A%E7%9A%84%E6%8C%87%E4%BB%A4%E5%B0%B1%E6%98%AF%EF%BC%9A%E3%80%8Cqm%20set%20100%20--sata1%20%2Fdev%2Fdisk%2Fby-id%2Fata-ST1000DM003-1CH162_S1D8F613%E3%80%8D)
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 3.3 將PCIe直通給PVE的虛擬機](3.3-%E5%B0%87PCIe%E7%9B%B4%E9%80%9A%E7%B5%A6PVE%E7%9A%84%E8%99%9B%E6%93%AC%E6%A9%9F) · [本章目錄](%E7%AC%AC3%E7%AB%A0-%E8%99%9B%E6%93%AC%E5%8C%96) · [全書目錄](Home) · [3.5 解決Windows安裝WSL後死機的問題 →](3.5-%E8%A7%A3%E6%B1%BAWindows%E5%AE%89%E8%A3%9DWSL%E5%BE%8C%E6%AD%BB%E6%A9%9F%E7%9A%84%E5%95%8F%E9%A1%8C)
|
||||
|
||||
@@ -13,3 +13,8 @@
|
||||
```
|
||||
args: -cpu host,kvm=on
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 3.4 相關參考紀錄](3.4-%E7%9B%B8%E9%97%9C%E5%8F%83%E8%80%83%E7%B4%80%E9%8C%84) · [本章目錄](%E7%AC%AC3%E7%AB%A0-%E8%99%9B%E6%93%AC%E5%8C%96) · [全書目錄](Home) · [3.6 Hyper-V →](3.6-Hyper-V)
|
||||
|
||||
@@ -45,3 +45,8 @@ New-NetIPAddress -IPAddress 192.168.30.1 -PrefixLength 24 -InterfaceAlias "vEthe
|
||||
```powershell
|
||||
New-NetNat -Name "NAT Network" -InternalIPInterfaceAddressPrefix 192.168.30.0/24
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 3.5 解決Windows安裝WSL後死機的問題](3.5-%E8%A7%A3%E6%B1%BAWindows%E5%AE%89%E8%A3%9DWSL%E5%BE%8C%E6%AD%BB%E6%A9%9F%E7%9A%84%E5%95%8F%E9%A1%8C) · [本章目錄](%E7%AC%AC3%E7%AB%A0-%E8%99%9B%E6%93%AC%E5%8C%96) · [全書目錄](Home) · [3.7 WSL：從零開始 →](3.7-WSL%EF%BC%9A%E5%BE%9E%E9%9B%B6%E9%96%8B%E5%A7%8B)
|
||||
|
||||
@@ -19,3 +19,8 @@ wsl --install
|
||||
```powershell
|
||||
wsl --update
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 3.6 Hyper-V](3.6-Hyper-V) · [本章目錄](%E7%AC%AC3%E7%AB%A0-%E8%99%9B%E6%93%AC%E5%8C%96) · [全書目錄](Home) · [3.8 WSL：安裝 Ubuntu 26.04 →](3.8-WSL%EF%BC%9A%E5%AE%89%E8%A3%9D-Ubuntu-26.04)
|
||||
|
||||
@@ -19,3 +19,8 @@ wsl --shutdown
|
||||
```powershell
|
||||
wsl --install Ubuntu-26.04
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 3.7 WSL：從零開始](3.7-WSL%EF%BC%9A%E5%BE%9E%E9%9B%B6%E9%96%8B%E5%A7%8B) · [本章目錄](%E7%AC%AC3%E7%AB%A0-%E8%99%9B%E6%93%AC%E5%8C%96) · [全書目錄](Home) · [3.9 避免虛擬化啟動失敗 →](3.9-%E9%81%BF%E5%85%8D%E8%99%9B%E6%93%AC%E5%8C%96%E5%95%9F%E5%8B%95%E5%A4%B1%E6%95%97)
|
||||
|
||||
@@ -22,3 +22,8 @@ cgroup_enable=memory
|
||||
```bash
|
||||
sudo reboot
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 3.8 WSL：安裝 Ubuntu 26.04](3.8-WSL%EF%BC%9A%E5%AE%89%E8%A3%9D-Ubuntu-26.04) · [本章目錄](%E7%AC%AC3%E7%AB%A0-%E8%99%9B%E6%93%AC%E5%8C%96) · [全書目錄](Home) · [第4章 容器與編排 →](%E7%AC%AC4%E7%AB%A0-%E5%AE%B9%E5%99%A8%E8%88%87%E7%B7%A8%E6%8E%92)
|
||||
|
||||
@@ -55,3 +55,8 @@ lxc.apparmor.profile: unconfined
|
||||
lxc.mount.entry: /dev/null sys/module/apparmor/parameters/enabled none bind 0 0
|
||||
lxc.mount.entry: /proc/sys/net/ipv4/ip_unprivileged_port_start proc/sys/net/ipv4/ip_unprivileged_port_start none bind 0 0
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 第4章 容器與編排](%E7%AC%AC4%E7%AB%A0-%E5%AE%B9%E5%99%A8%E8%88%87%E7%B7%A8%E6%8E%92) · [本章目錄](%E7%AC%AC4%E7%AB%A0-%E5%AE%B9%E5%99%A8%E8%88%87%E7%B7%A8%E6%8E%92) · [全書目錄](Home) · [4.2 Docker（Raspberry Pi） →](4.2-Docker%EF%BC%88Raspberry-Pi%EF%BC%89)
|
||||
|
||||
@@ -27,3 +27,8 @@ sudo usermod -aG docker $USER
|
||||
```bash
|
||||
newgrp docker
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 4.1 Docker（Ubuntu）](4.1-Docker%EF%BC%88Ubuntu%EF%BC%89) · [本章目錄](%E7%AC%AC4%E7%AB%A0-%E5%AE%B9%E5%99%A8%E8%88%87%E7%B7%A8%E6%8E%92) · [全書目錄](Home) · [4.3 K3s →](4.3-K3s)
|
||||
|
||||
+5
@@ -15,3 +15,8 @@ sudo curl -sfL https://get.k3s.io | sh -
|
||||
```bash
|
||||
sudo systemctl status k3s
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 4.2 Docker（Raspberry Pi）](4.2-Docker%EF%BC%88Raspberry-Pi%EF%BC%89) · [本章目錄](%E7%AC%AC4%E7%AB%A0-%E5%AE%B9%E5%99%A8%E8%88%87%E7%B7%A8%E6%8E%92) · [全書目錄](Home) · [4.4 k3d →](4.4-k3d)
|
||||
|
||||
+5
@@ -43,3 +43,8 @@ k3d cluster create ct \
|
||||
```bash
|
||||
kubectl get nodes
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 4.3 K3s](4.3-K3s) · [本章目錄](%E7%AC%AC4%E7%AB%A0-%E5%AE%B9%E5%99%A8%E8%88%87%E7%B7%A8%E6%8E%92) · [全書目錄](Home) · [4.5 Traefik →](4.5-Traefik)
|
||||
|
||||
@@ -232,3 +232,8 @@ nano /root/traefik.toml
|
||||
#
|
||||
# exposedByDefault = false
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 4.4 k3d](4.4-k3d) · [本章目錄](%E7%AC%AC4%E7%AB%A0-%E5%AE%B9%E5%99%A8%E8%88%87%E7%B7%A8%E6%8E%92) · [全書目錄](Home) · [第5章 資料庫與搜尋 →](%E7%AC%AC5%E7%AB%A0-%E8%B3%87%E6%96%99%E5%BA%AB%E8%88%87%E6%90%9C%E5%B0%8B)
|
||||
|
||||
@@ -38,3 +38,8 @@ host gitea gitea 192.168.230.221/24 md5
|
||||
```bash
|
||||
systemctl restart postgresql && systemctl status postgresql
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 第5章 資料庫與搜尋](%E7%AC%AC5%E7%AB%A0-%E8%B3%87%E6%96%99%E5%BA%AB%E8%88%87%E6%90%9C%E5%B0%8B) · [本章目錄](%E7%AC%AC5%E7%AB%A0-%E8%B3%87%E6%96%99%E5%BA%AB%E8%88%87%E6%90%9C%E5%B0%8B) · [全書目錄](Home) · [5.2 SQLServer →](5.2-SQLServer)
|
||||
|
||||
@@ -117,3 +117,8 @@ apt update && apt install -y mssql-tools18 unixodbc-dev
|
||||
```bash
|
||||
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc && source ~/.bashrc
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 5.1 PostgreSQL](5.1-PostgreSQL) · [本章目錄](%E7%AC%AC5%E7%AB%A0-%E8%B3%87%E6%96%99%E5%BA%AB%E8%88%87%E6%90%9C%E5%B0%8B) · [全書目錄](Home) · [5.3 Redis →](5.3-Redis)
|
||||
|
||||
+5
@@ -51,3 +51,8 @@ apt install -y redis
|
||||
```bash
|
||||
systemctl enable redis-server && systemctl start redis-server && systemctl status redis-server
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 5.2 SQLServer](5.2-SQLServer) · [本章目錄](%E7%AC%AC5%E7%AB%A0-%E8%B3%87%E6%96%99%E5%BA%AB%E8%88%87%E6%90%9C%E5%B0%8B) · [全書目錄](Home) · [5.4 ElasticSearch →](5.4-ElasticSearch)
|
||||
|
||||
@@ -259,3 +259,8 @@ sudo systemctl enable kibana
|
||||
```bash
|
||||
sudo systemctl start kibana
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 5.3 Redis](5.3-Redis) · [本章目錄](%E7%AC%AC5%E7%AB%A0-%E8%B3%87%E6%96%99%E5%BA%AB%E8%88%87%E6%90%9C%E5%B0%8B) · [全書目錄](Home) · [第6章 開發與持續整合 →](%E7%AC%AC6%E7%AB%A0-%E9%96%8B%E7%99%BC%E8%88%87%E6%8C%81%E7%BA%8C%E6%95%B4%E5%90%88)
|
||||
|
||||
+5
@@ -182,3 +182,8 @@ WantedBy=multi-user.target
|
||||
```bash
|
||||
systemctl daemon-reload && systemctl enable gitea && systemctl start gitea && systemctl status gitea
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 第6章 開發與持續整合](%E7%AC%AC6%E7%AB%A0-%E9%96%8B%E7%99%BC%E8%88%87%E6%8C%81%E7%BA%8C%E6%95%B4%E5%90%88) · [本章目錄](%E7%AC%AC6%E7%AB%A0-%E9%96%8B%E7%99%BC%E8%88%87%E6%8C%81%E7%BA%8C%E6%95%B4%E5%90%88) · [全書目錄](Home) · [6.2 GiteaRunner（Ubuntu） →](6.2-GiteaRunner%EF%BC%88Ubuntu%EF%BC%89)
|
||||
|
||||
@@ -39,3 +39,8 @@ systemctl daemon-reload && systemctl enable --now code-server@$USER && systemctl
|
||||
```bash
|
||||
cat ~/.config/code-server/config.yaml
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 6.9 C# SDK](6.9-C-SDK) · [本章目錄](%E7%AC%AC6%E7%AB%A0-%E9%96%8B%E7%99%BC%E8%88%87%E6%8C%81%E7%BA%8C%E6%95%B4%E5%90%88) · [全書目錄](Home) · [6.11 Coder →](6.11-Coder)
|
||||
|
||||
@@ -90,3 +90,8 @@ GRANT USAGE, CREATE ON SCHEMA public TO coder;
|
||||
```bash
|
||||
usermod -aG docker coder
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 6.10 VS Code](6.10-VS-Code) · [本章目錄](%E7%AC%AC6%E7%AB%A0-%E9%96%8B%E7%99%BC%E8%88%87%E6%8C%81%E7%BA%8C%E6%95%B4%E5%90%88) · [全書目錄](Home) · [6.12 Oh My Posh →](6.12-Oh-My-Posh)
|
||||
|
||||
@@ -19,3 +19,8 @@ curl -s https://ohmyposh.dev/install.sh | bash -s
|
||||
```bash
|
||||
echo 'eval "$(oh-my-posh init bash)"' >> ~/.bashrc
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 6.11 Coder](6.11-Coder) · [本章目錄](%E7%AC%AC6%E7%AB%A0-%E9%96%8B%E7%99%BC%E8%88%87%E6%8C%81%E7%BA%8C%E6%95%B4%E5%90%88) · [全書目錄](Home) · [第7章 AI 工具 →](%E7%AC%AC7%E7%AB%A0-AI-%E5%B7%A5%E5%85%B7)
|
||||
|
||||
@@ -83,3 +83,8 @@ systemctl daemon-reload && systemctl enable runner.service && systemctl start ru
|
||||
```bash
|
||||
systemctl stop act_runner.service && systemctl disable act_runner.service && rm /etc/systemd/system/act_runner.service
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 6.1 Gitea](6.1-Gitea) · [本章目錄](%E7%AC%AC6%E7%AB%A0-%E9%96%8B%E7%99%BC%E8%88%87%E6%8C%81%E7%BA%8C%E6%95%B4%E5%90%88) · [全書目錄](Home) · [6.3 Gitea Runner（Windows） →](6.3-Gitea-Runner)
|
||||
|
||||
@@ -71,3 +71,8 @@ Invoke-WebRequest https://github.com/winsw/winsw/releases/download/v2.12.0/WinSW
|
||||
```powershell
|
||||
.\winsw.exe start
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 6.2 GiteaRunner（Ubuntu）](6.2-GiteaRunner%EF%BC%88Ubuntu%EF%BC%89) · [本章目錄](%E7%AC%AC6%E7%AB%A0-%E9%96%8B%E7%99%BC%E8%88%87%E6%8C%81%E7%BA%8C%E6%95%B4%E5%90%88) · [全書目錄](Home) · [6.4 GiteaRunner（Alpine） →](6.4-GiteaRunner%EF%BC%88Alpine%EF%BC%89)
|
||||
|
||||
@@ -80,3 +80,8 @@ chmod +x /etc/init.d/act_runner
|
||||
```bash
|
||||
rc-service act_runner start && rc-service act_runner status && rc-update add act_runner
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 6.3 Gitea Runner（Windows）](6.3-Gitea-Runner) · [本章目錄](%E7%AC%AC6%E7%AB%A0-%E9%96%8B%E7%99%BC%E8%88%87%E6%8C%81%E7%BA%8C%E6%95%B4%E5%90%88) · [全書目錄](Home) · [6.5 Gitlab →](6.5-Gitlab)
|
||||
|
||||
@@ -37,3 +37,8 @@ EXTERNAL_URL="https://gitlab.jsc.idv.tw" apt install gitlab-ce
|
||||
```bash
|
||||
cat /etc/gitlab/initial_root_password
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 6.4 GiteaRunner（Alpine）](6.4-GiteaRunner%EF%BC%88Alpine%EF%BC%89) · [本章目錄](%E7%AC%AC6%E7%AB%A0-%E9%96%8B%E7%99%BC%E8%88%87%E6%8C%81%E7%BA%8C%E6%95%B4%E5%90%88) · [全書目錄](Home) · [6.6 ASP.NET →](6.6-ASP.NET)
|
||||
|
||||
@@ -31,3 +31,8 @@ Restart=always
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 6.5 Gitlab](6.5-Gitlab) · [本章目錄](%E7%AC%AC6%E7%AB%A0-%E9%96%8B%E7%99%BC%E8%88%87%E6%8C%81%E7%BA%8C%E6%95%B4%E5%90%88) · [全書目錄](Home) · [6.7 Django →](6.7-Django)
|
||||
|
||||
@@ -47,3 +47,8 @@ pip3 install gunicorn
|
||||
```bash
|
||||
gunicorn --bind 0.0.0.0:8000 mysite.wsgi:application
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 6.6 ASP.NET](6.6-ASP.NET) · [本章目錄](%E7%AC%AC6%E7%AB%A0-%E9%96%8B%E7%99%BC%E8%88%87%E6%8C%81%E7%BA%8C%E6%95%B4%E5%90%88) · [全書目錄](Home) · [6.8 Node JS →](6.8-Node-JS)
|
||||
|
||||
@@ -25,3 +25,8 @@ curl -o- https://fnm.vercel.app/install | bash
|
||||
```bash
|
||||
fnm install 26
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 6.7 Django](6.7-Django) · [本章目錄](%E7%AC%AC6%E7%AB%A0-%E9%96%8B%E7%99%BC%E8%88%87%E6%8C%81%E7%BA%8C%E6%95%B4%E5%90%88) · [全書目錄](Home) · [6.9 C# SDK →](6.9-C-SDK)
|
||||
|
||||
@@ -29,3 +29,8 @@ dpkg -i packages-microsoft-prod.deb
|
||||
```bash
|
||||
apt update && apt install -y dotnet-sdk-10.0
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 6.8 Node JS](6.8-Node-JS) · [本章目錄](%E7%AC%AC6%E7%AB%A0-%E9%96%8B%E7%99%BC%E8%88%87%E6%8C%81%E7%BA%8C%E6%95%B4%E5%90%88) · [全書目錄](Home) · [6.10 VS Code →](6.10-VS-Code)
|
||||
|
||||
@@ -32,3 +32,8 @@ nano ~/.claude/settings.json
|
||||
```bash
|
||||
npx -y ccstatusline@latest
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 第7章 AI 工具](%E7%AC%AC7%E7%AB%A0-AI-%E5%B7%A5%E5%85%B7) · [本章目錄](%E7%AC%AC7%E7%AB%A0-AI-%E5%B7%A5%E5%85%B7) · [全書目錄](Home) · [7.2 CLIProxyAPI →](7.2-CLIProxyAPI)
|
||||
|
||||
@@ -43,3 +43,8 @@ WantedBy=multi-user.target
|
||||
```bash
|
||||
systemctl daemon-reload && systemctl enable cliproxyapi.service && systemctl start cliproxyapi.service && systemctl status cliproxyapi.service
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 7.1 ccstatusline](7.1-ccstatusline) · [本章目錄](%E7%AC%AC7%E7%AB%A0-AI-%E5%B7%A5%E5%85%B7) · [全書目錄](Home) · [7.3 OpenClaw →](7.3-OpenClaw)
|
||||
|
||||
@@ -61,3 +61,8 @@ echo "$(openssl rand -hex 32)" > openclaw-token
|
||||
```bash
|
||||
openclaw config set gateway.auth.token "$(cat openclaw-token)"
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 7.2 CLIProxyAPI](7.2-CLIProxyAPI) · [本章目錄](%E7%AC%AC7%E7%AB%A0-AI-%E5%B7%A5%E5%85%B7) · [全書目錄](Home) · [7.4 OpenCode →](7.4-OpenCode)
|
||||
|
||||
@@ -55,3 +55,8 @@ WantedBy=multi-user.target
|
||||
```bash
|
||||
systemctl daemon-reload && systemctl enable opencode.service && systemctl start opencode.service && systemctl status opencode.service
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 7.3 OpenClaw](7.3-OpenClaw) · [本章目錄](%E7%AC%AC7%E7%AB%A0-AI-%E5%B7%A5%E5%85%B7) · [全書目錄](Home) · [7.5 PicoClaw →](7.5-PicoClaw)
|
||||
|
||||
@@ -97,3 +97,8 @@ wget https://github.com/sipeed/picoclaw/releases/download/v0.3.1/picoclaw_x86_64
|
||||
```bash
|
||||
picoclaw-launcher -public
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 7.4 OpenCode](7.4-OpenCode) · [本章目錄](%E7%AC%AC7%E7%AB%A0-AI-%E5%B7%A5%E5%85%B7) · [全書目錄](Home) · [7.6 補充解決方案內，所有專案的註解，並整理 README →](7.6-%E8%A3%9C%E5%85%85%E8%A7%A3%E6%B1%BA%E6%96%B9%E6%A1%88%E5%85%A7%EF%BC%8C%E6%89%80%E6%9C%89%E5%B0%88%E6%A1%88%E7%9A%84%E8%A8%BB%E8%A7%A3%EF%BC%8C%E4%B8%A6%E6%95%B4%E7%90%86-README)
|
||||
|
||||
@@ -35,3 +35,8 @@
|
||||
- 註解要清楚說明參數的用途和預期值
|
||||
- 使用繁體中文撰寫所有註解
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 7.5 PicoClaw](7.5-PicoClaw) · [本章目錄](%E7%AC%AC7%E7%AB%A0-AI-%E5%B7%A5%E5%85%B7) · [全書目錄](Home) · [第8章 應用服務 →](%E7%AC%AC8%E7%AB%A0-%E6%87%89%E7%94%A8%E6%9C%8D%E5%8B%99)
|
||||
|
||||
+5
@@ -23,3 +23,8 @@ wget https://github.com/MediaBrowser/Emby.Releases/releases/download/4.8.11.0/em
|
||||
```bash
|
||||
dpkg -i emby-server-deb_4.8.11.0_amd64.deb
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 第8章 應用服務](%E7%AC%AC8%E7%AB%A0-%E6%87%89%E7%94%A8%E6%9C%8D%E5%8B%99) · [本章目錄](%E7%AC%AC8%E7%AB%A0-%E6%87%89%E7%94%A8%E6%9C%8D%E5%8B%99) · [全書目錄](Home) · [8.2 MeTube →](8.2-MeTube)
|
||||
|
||||
@@ -90,3 +90,8 @@ systemctl daemon-reload && systemctl enable metube.service && systemctl start me
|
||||
```
|
||||
|
||||
### 7. 連接埠 8081
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 8.1 Emby](8.1-Emby) · [本章目錄](%E7%AC%AC8%E7%AB%A0-%E6%87%89%E7%94%A8%E6%9C%8D%E5%8B%99) · [全書目錄](Home) · [8.3 Vaultwarden →](8.3-Vaultwarden)
|
||||
|
||||
@@ -15,3 +15,8 @@ wget -qO- https://vaultwarden-deb.pages.dev/dists/trixie/install.sh | bash
|
||||
```bash
|
||||
apt update && apt install vaultwarden
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 8.2 MeTube](8.2-MeTube) · [本章目錄](%E7%AC%AC8%E7%AB%A0-%E6%87%89%E7%94%A8%E6%9C%8D%E5%8B%99) · [全書目錄](Home) · [8.4 ezBookkeeping →](8.4-ezBookkeeping)
|
||||
|
||||
@@ -82,3 +82,8 @@ ALTER SCHEMA public OWNER TO ezbookkeeping;
|
||||
-- 3. Ensure the user has create permissions (Crucial for Postgres 15+)
|
||||
GRANT USAGE, CREATE ON SCHEMA public TO ezbookkeeping;
|
||||
```
|
||||
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 8.3 Vaultwarden](8.3-Vaultwarden) · [本章目錄](%E7%AC%AC8%E7%AB%A0-%E6%87%89%E7%94%A8%E6%9C%8D%E5%8B%99) · [全書目錄](Home) · [目錄 →](Home)
|
||||
|
||||
+6
-2
@@ -1,6 +1,6 @@
|
||||
# JSC 知識庫
|
||||
|
||||
以「一本書」整理自 [knowledges](https://gitea.jsc.idv.tw/knowledges) 各知識庫的 wiki，依領域分為八章。每頁是一個可直接照做的步驟紀錄。
|
||||
以「一本書」整理自 [knowledges](https://gitea.jsc.idv.tw/knowledges) 各知識庫的 wiki，依領域分為 8 章。每頁是一個可直接照做的步驟紀錄。
|
||||
|
||||
## 目錄
|
||||
|
||||
@@ -13,13 +13,17 @@
|
||||
7. [第7章 AI 工具](%E7%AC%AC7%E7%AB%A0-AI-%E5%B7%A5%E5%85%B7)：Claude、CLIProxyAPI、OpenClaw、OpenCode、PicoClaw 與提示詞。（6 篇）
|
||||
8. [第8章 應用服務](%E7%AC%AC8%E7%AB%A0-%E6%87%89%E7%94%A8%E6%9C%8D%E5%8B%99)：影音、密碼庫、記帳等自架應用。（4 篇）
|
||||
|
||||
## 新增內容
|
||||
|
||||
`/jsc-wiki:book-search <主題>` 蒐集並整理網路上的知識，`/jsc-wiki:book-import` 依本書結構加入 wiki。
|
||||
|
||||
## 閱讀
|
||||
|
||||
安裝 `jsc-wiki` 插件後可直接在 Claude Code 讀取：`/jsc-wiki:wiki` 看目錄與搜尋，或 `/jsc-wiki:system`、`/jsc-wiki:network` 等依領域查詢。
|
||||
|
||||
## 頁面格式
|
||||
|
||||
每頁固定為：`# 標題` → 章節與來源 → `## 簡介` → `## 步驟`（`### 1.`、`### 2.` 依序編號）→ 選用的補充段落（常見問題、範例設定檔等）。非步驟型頁面以「參考連結」或「提示詞」取代步驟。
|
||||
每頁固定為：標題、來源列、簡介、步驟，並遵守簡化技術中文（STE100）與「繁體中文無亂碼、盡量用圖表」規則。完整規則見 [頁面格式](頁面格式)。
|
||||
|
||||
## 說明
|
||||
|
||||
|
||||
+4
-1
@@ -10,4 +10,7 @@
|
||||
- [1.6 常用工具](1.6-%E5%B8%B8%E7%94%A8%E5%B7%A5%E5%85%B7)（Ubuntu）
|
||||
- [1.7 使用舊的右鍵選項](1.7-%E4%BD%BF%E7%94%A8%E8%88%8A%E7%9A%84%E5%8F%B3%E9%8D%B5%E9%81%B8%E9%A0%85)（Windows）
|
||||
|
||||
[回目錄](Home)
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 目錄](Home) · [全書目錄](Home) · [1.1 修改成台北時區 →](1.1-%E4%BF%AE%E6%94%B9%E6%88%90%E5%8F%B0%E5%8C%97%E6%99%82%E5%8D%80)
|
||||
|
||||
+4
-1
@@ -11,4 +11,7 @@
|
||||
- [2.7 OpenWrt](2.7-OpenWrt)（Proxmox VE）
|
||||
- [2.8 DiskStation Manager](2.8-DiskStation-Manager)（Proxmox VE）
|
||||
|
||||
[回目錄](Home)
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 1.7 使用舊的右鍵選項](1.7-%E4%BD%BF%E7%94%A8%E8%88%8A%E7%9A%84%E5%8F%B3%E9%8D%B5%E9%81%B8%E9%A0%85) · [全書目錄](Home) · [2.1 netplan →](2.1-netplan)
|
||||
|
||||
+4
-1
@@ -12,4 +12,7 @@ Proxmox VE、Hyper-V、WSL 與直通設定。
|
||||
- [3.8 WSL：安裝 Ubuntu 26.04](3.8-WSL%EF%BC%9A%E5%AE%89%E8%A3%9D-Ubuntu-26.04)（Windows）
|
||||
- [3.9 避免虛擬化啟動失敗](3.9-%E9%81%BF%E5%85%8D%E8%99%9B%E6%93%AC%E5%8C%96%E5%95%9F%E5%8B%95%E5%A4%B1%E6%95%97)（Raspberry Pi）
|
||||
|
||||
[回目錄](Home)
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 2.8 DiskStation Manager](2.8-DiskStation-Manager) · [全書目錄](Home) · [3.1 套件更新設定 →](3.1-%E5%A5%97%E4%BB%B6%E6%9B%B4%E6%96%B0%E8%A8%AD%E5%AE%9A)
|
||||
|
||||
+4
-1
@@ -8,4 +8,7 @@ Docker、K3s、k3d 與 Traefik 反向代理。
|
||||
- [4.4 k3d](4.4-k3d)（Ubuntu）
|
||||
- [4.5 Traefik](4.5-Traefik)（Ubuntu）
|
||||
|
||||
[回目錄](Home)
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 3.9 避免虛擬化啟動失敗](3.9-%E9%81%BF%E5%85%8D%E8%99%9B%E6%93%AC%E5%8C%96%E5%95%9F%E5%8B%95%E5%A4%B1%E6%95%97) · [全書目錄](Home) · [4.1 Docker（Ubuntu） →](4.1-Docker%EF%BC%88Ubuntu%EF%BC%89)
|
||||
|
||||
+4
-1
@@ -7,4 +7,7 @@ PostgreSQL、SQL Server、Redis、Elasticsearch。
|
||||
- [5.3 Redis](5.3-Redis)（Ubuntu）
|
||||
- [5.4 ElasticSearch](5.4-ElasticSearch)（Ubuntu）
|
||||
|
||||
[回目錄](Home)
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 4.5 Traefik](4.5-Traefik) · [全書目錄](Home) · [5.1 PostgreSQL →](5.1-PostgreSQL)
|
||||
|
||||
+6
-3
@@ -4,15 +4,18 @@
|
||||
|
||||
- [6.1 Gitea](6.1-Gitea)（Ubuntu）
|
||||
- [6.2 GiteaRunner（Ubuntu）](6.2-GiteaRunner%EF%BC%88Ubuntu%EF%BC%89)（Ubuntu）
|
||||
- [6.3 Gitea Runner](6.3-Gitea-Runner)（Windows）
|
||||
- [6.3 Gitea Runner（Windows）](6.3-Gitea-Runner)（Windows）
|
||||
- [6.4 GiteaRunner（Alpine）](6.4-GiteaRunner%EF%BC%88Alpine%EF%BC%89)（Alpine）
|
||||
- [6.5 Gitlab](6.5-Gitlab)（Ubuntu）
|
||||
- [6.6 ASP.NET](6.6-ASP.NET)（Ubuntu）
|
||||
- [6.7 Django](6.7-Django)（Python）
|
||||
- [6.8 Node JS](6.8-Node-JS)（Ubuntu）
|
||||
- [6.9 C# SDK](6.9-C%23-SDK)（Ubuntu）
|
||||
- [6.9 C# SDK](6.9-C-SDK)（Ubuntu）
|
||||
- [6.10 VS Code](6.10-VS-Code)（Ubuntu）
|
||||
- [6.11 Coder](6.11-Coder)（Ubuntu）
|
||||
- [6.12 Oh My Posh](6.12-Oh-My-Posh)（Ubuntu）
|
||||
|
||||
[回目錄](Home)
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 5.4 ElasticSearch](5.4-ElasticSearch) · [全書目錄](Home) · [6.1 Gitea →](6.1-Gitea)
|
||||
|
||||
+4
-1
@@ -9,4 +9,7 @@ Claude、CLIProxyAPI、OpenClaw、OpenCode、PicoClaw 與提示詞。
|
||||
- [7.5 PicoClaw](7.5-PicoClaw)（Ubuntu）
|
||||
- [7.6 補充解決方案內，所有專案的註解，並整理 README](7.6-%E8%A3%9C%E5%85%85%E8%A7%A3%E6%B1%BA%E6%96%B9%E6%A1%88%E5%85%A7%EF%BC%8C%E6%89%80%E6%9C%89%E5%B0%88%E6%A1%88%E7%9A%84%E8%A8%BB%E8%A7%A3%EF%BC%8C%E4%B8%A6%E6%95%B4%E7%90%86-README)（Prompt）
|
||||
|
||||
[回目錄](Home)
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 6.12 Oh My Posh](6.12-Oh-My-Posh) · [全書目錄](Home) · [7.1 ccstatusline →](7.1-ccstatusline)
|
||||
|
||||
+4
-1
@@ -7,4 +7,7 @@
|
||||
- [8.3 Vaultwarden](8.3-Vaultwarden)（Ubuntu）
|
||||
- [8.4 ezBookkeeping](8.4-ezBookkeeping)（Ubuntu）
|
||||
|
||||
[回目錄](Home)
|
||||
<!-- nav -->
|
||||
---
|
||||
|
||||
[← 7.6 補充解決方案內，所有專案的註解，並整理 README](7.6-%E8%A3%9C%E5%85%85%E8%A7%A3%E6%B1%BA%E6%96%B9%E6%A1%88%E5%85%A7%EF%BC%8C%E6%89%80%E6%9C%89%E5%B0%88%E6%A1%88%E7%9A%84%E8%A8%BB%E8%A7%A3%EF%BC%8C%E4%B8%A6%E6%95%B4%E7%90%86-README) · [全書目錄](Home) · [8.1 Emby →](8.1-Emby)
|
||||
|
||||
+123
@@ -0,0 +1,123 @@
|
||||
# 頁面格式
|
||||
|
||||
> 附錄 · 來源：本書編輯規則
|
||||
|
||||
## 簡介
|
||||
|
||||
本頁定義每個頁面的固定格式。`/jsc-wiki:book-search` 與 `/jsc-wiki:book-import` 都依本頁建立與修改頁面。
|
||||
|
||||
## 規則
|
||||
|
||||
### 1. 頁面結構
|
||||
|
||||
每頁依下列順序排列：
|
||||
|
||||
| 順序 | 內容 | 必要 |
|
||||
| --- | --- | --- |
|
||||
| 1 | `# 標題` | 是 |
|
||||
| 2 | 來源列：`> 第N章 領域 · 來源：…` | 是 |
|
||||
| 3 | `## 簡介`：一到兩句，說明這頁的用途 | 是 |
|
||||
| 4 | `## 步驟`：`### 1.`、`### 2.` 依序編號 | 是 |
|
||||
| 5 | 補充段落：常見問題、範例設定檔、參考來源 | 否 |
|
||||
| 6 | 頁尾導覽（由工具自動產生） | 自動 |
|
||||
|
||||
非步驟型頁面可用 `## 參考連結` 或 `## 提示詞` 取代 `## 步驟`。
|
||||
|
||||
### 2. 一頁一個主題
|
||||
|
||||
- 一頁只寫一個主題。主題已存在時，修改原頁面，不新增重複頁面。
|
||||
- 只寫來源有說明的內容。不要補充來源沒有的事實。
|
||||
- 網路來源要在頁尾的 `## 參考來源` 列出連結。用自己的話改寫，不要整段複製。
|
||||
- 密碼、token 和金鑰一律用占位符，例如 `<密碼>`、`<Runner token>`。
|
||||
|
||||
### 3. 程式碼
|
||||
|
||||
- 每個程式碼區塊標示語言，例如 `bash`、`powershell`、`json`。
|
||||
- 一個區塊只放一個動作。需要說明時，把說明放在區塊前面。
|
||||
|
||||
### 4. 簡化技術中文（參考 STE100）
|
||||
|
||||
這條規則參考 [ASD-STE100 skill](https://github.com/danyuchn/asd-ste100-skill) 的結構規則，改成適用於繁體中文。目的是讓讀者與 AI 都不會誤讀。
|
||||
|
||||
| 規則 | 正確 | 避免 |
|
||||
| --- | --- | --- |
|
||||
| 一句一個動作 | 「開啟檔案。讀取第 3 行。」 | 「開啟檔案並讀取第 3 行，然後確認是否相符。」 |
|
||||
| 句子長度 | 步驟句 30 字以內，說明句 40 字以內 | 多個子句串成長句 |
|
||||
| 步驟用祈使句 | 「安裝 Redis。」 | 「Redis 需要被安裝。」 |
|
||||
| 主動語態 | 「服務會讀取設定檔。」 | 「設定檔會被服務讀取。」 |
|
||||
| 不用分號 | 拆成兩個句子 | 「；」 |
|
||||
| 一詞一義 | 同一個動作整頁只用一個詞（例如一律用「安裝」） | 同一個動作交替用「安裝」「部署」「裝設」 |
|
||||
| 名詞堆疊不超過 3 個 | 「資料庫連線設定」 | 「高可用資料庫叢集連線逾時設定」 |
|
||||
| 不省略主詞和受詞 | 「重新啟動服務。」 | 「重啟。」 |
|
||||
| 不用行銷用語 | 寫出數字或事實 | 強大、無縫、輕鬆、完美 |
|
||||
| 保留語氣強度 | 「可能失敗」維持「可能」 | 把「可能」改成肯定句 |
|
||||
| 段落 | 一段一個主題，最多 6 句 | 一段混合多個主題 |
|
||||
| 序列用清單 | 三個以上的步驟或條件用編號清單 | 把步驟藏在一個長句裡 |
|
||||
|
||||
簡化只改文字形式，不可以刪除警告、條件、版本號和數值。
|
||||
|
||||
### 5. 繁體中文與圖表
|
||||
|
||||
**繁體中文且無亂碼**
|
||||
|
||||
- 檔案一律使用 UTF-8（無 BOM、LF 換行）。
|
||||
- 全文使用繁體中文與台灣慣用詞，例如「軟體」「檔案」「伺服器」。
|
||||
- 中文句子使用全形標點（，。：？！）。程式碼、網址與路徑使用半形。
|
||||
- 英文與數字前後不強制加空格，但全頁要一致。
|
||||
- 存檔後執行 `book.py lint`。工具會檢查 U+FFFD 與常見亂碼字元。
|
||||
|
||||
**盡量用圖表**
|
||||
|
||||
| 內容類型 | 使用 |
|
||||
| --- | --- |
|
||||
| 流程、判斷、步驟順序 | Mermaid `flowchart` |
|
||||
| 元件之間的互動 | Mermaid `sequenceDiagram` |
|
||||
| 架構與關係 | Mermaid `flowchart` 或 `graph` |
|
||||
| 參數、連接埠、版本、比較 | 表格 |
|
||||
| 目錄結構 | 縮排清單或程式碼區塊 |
|
||||
|
||||
範例：本頁的建立流程。
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
A[網路蒐集] --> B[整理成草稿]
|
||||
B --> C{主題已存在?}
|
||||
C -- 是 --> D[修改原頁面]
|
||||
C -- 否 --> E[新增頁面]
|
||||
D --> F[檢查格式]
|
||||
E --> F
|
||||
F --> G[更新目錄與導覽]
|
||||
G --> H[推送到 wiki]
|
||||
```
|
||||
|
||||
每頁至少放一張圖或一個表格。內容確實不適合時可以省略。圖要放在說明文字之後，並用一句話說明圖在表達什麼。
|
||||
|
||||
## 範本
|
||||
|
||||
````markdown
|
||||
# Redis
|
||||
|
||||
> 第5章 資料庫與搜尋 · 來源：Ubuntu 知識庫
|
||||
|
||||
## 簡介
|
||||
|
||||
Redis 是記憶體式鍵值資料庫。本頁說明在 Ubuntu 安裝 Redis 的步驟。
|
||||
|
||||
## 步驟
|
||||
|
||||
### 1. 安裝相依套件
|
||||
|
||||
```bash
|
||||
apt update && apt install -y lsb-release curl gpg
|
||||
```
|
||||
|
||||
### 2. 啟動服務
|
||||
|
||||
```bash
|
||||
systemctl enable --now redis-server
|
||||
```
|
||||
|
||||
## 參考來源
|
||||
|
||||
- [Redis 官方文件](https://redis.io/docs/)
|
||||
````
|
||||
Reference in New Issue
Block a user