DocusNotes

【置頂】

Tue, 01 Sep 2026 00:00:00 +0000

這裡是置頂文。

PowerShell與WSL

Sat, 05 Sep 2026 00:00:00 +0000

環境

作業系統：Windows 11
程式碼編輯器：Visual Studio Code
紀錄時間：2026年9月

Windows PowerShell和PowerShell 7+

Windows PowerShell是舊版的Windows內建工具（只支援Windows），而新一代的PowerShell是跨平台的現代化開源版本。

Windows PowerShell：只能在Windows作業系統上執行，版本停留在5.1，且是Windows系統的一部分無法移除。
PowerShell (v6/v7+)：是跨平台的，支援Windows、macOS和Linux。

PowerShell 7+

安裝

打開Windows PowerShell，輸入winget install Microsoft.PowerShell

更新

打開PowerShell，輸入winget upgrade Microsoft.PowerShell

其他

所有winget安裝軟體更新winget upgrade --all

最新的PowerShell可以用linux指令嗎？

這取決於你把PowerShell執行在哪個作業系統上。
當你在Linux或macOS上執行PowerShell，100% 可以直接使用真實的Linux指令，因為底層就是Linux系統。
當你在Windows上執行最新版PowerShell時，可以執行「部分常用」的Linux指令。

為了讓習慣Linux的人無痛上手，微軟在Windows的PowerShell內建了許多外號（別名）。當你輸入Linux指令時，它會在背後自動翻譯成對應的PowerShell指令，ls, cd, pwd, mkdir都能用。

雖然這些基礎指令能動，但不能加上Linux的進階參數。例如輸入ls -la會報錯，因為背後的Windows Get-ChildItem看不懂 -la是什麼。

如果你的Windows有安裝 WSL (Windows子系統Linux)，你只要在指令前面加上wsl，就能在最新版PowerShell裡調用100% 真正的Linux指令，
範例：wsl ls -la /home

WSL

安裝

打開PowerShell，輸入wsl --install
這個指令會自動幫你啟用Windows的虛擬化功能，並預設下載安裝最新的Ubuntu系統。
當視窗提示安裝完成後，手動重新啟動你的Windows 11電腦。這是啟用虛擬化核心必經的步驟。
重啟電腦並進入Windows後，系統會自動跳出一個黑色的Ubuntu命令列視窗（如果沒跳出，請去開始功能表搜尋「Ubuntu」並打開）。

設定帳號密碼：

Enter new UNIX username:
New password:
Retype new password:

當你看到綠色的文字（例如user@DESKTOP-XXXXXX:~$）時，就代表你已經成功登入真正的Linux系統了。現在，你可以在你原來的最新版PowerShell視窗裡，直接輸入wsl ls -la來調用Linux指令，或者輸入wsl直接切換進去Linux環境。

TOML語法

Sat, 05 Sep 2026 00:00:00 +0000

TOML的全名是Tom’s Obvious, Minimal Language（湯姆的明顯、極簡語言）。它的設計目標是成為一個比JSON更易讀、比YAML更嚴謹的組態設定格式。不同於YAML依賴縮排，TOML主要是透過方括號 [] 來定義資料結構。

核心規則

三個特點：

使用等號 = 賦值
TOML的鍵值對一律使用等號（例如 title = "我的文章" ）。
對空格非常寬容
等號兩邊有沒有空格都沒關係（ title=1 和 title = 1 都對），而且縮排只為了美觀，不影響程式解析。
嚴格的型態與字串要求：字串必須用引號包起來，布林值必須是小寫的 true 或 false 。

四大基礎語法與資料型態

在Markdown的文章開頭（Front Matter），你會用到的TOML語法主要有以下四種：

基礎鍵值對（Key-Value）

tomltitle = "我的第一篇文章" # 字串：TOML的字串「一定要」加引號
draft = false # 布林值：必須小寫
weight = 10 # 整數
price = 99.9 # 浮點數

字串與引號（String）
TOML區分雙引號與單引號的方式：

雙引號 "" （基本字串）：支援跳脫字元（例如 \n 代表換行）。
```
tomldescription = "第一行\n第二行"
```
單引號 '' （字面字串）：不解析任何跳脫字元，裡面寫什麼就完全顯示什麼（適合用來寫網址或正則表達式）。
```
tomlimage_url = 'https://example.com'
```

陣列 / 列表（Array）
用來設定多個同類型的資料（如文章標籤）。

單行寫法（最常用）：

tomltags = ["網站架設", "Hugo", "教學"]

多行寫法（適合項目很多時）：

YAML語法

Sat, 05 Sep 2026 00:00:00 +0000

YAML的設計核心是「人類可讀性高」，它的結構完全依賴縮排和特定的符號來決定。

核心規則

YAML三個禁忌：

只能使用「空格」縮排
絕對不能使用Tab鍵。如果使用Tab鍵，編譯時網站一定會報錯。通常建議固定使用2個空格作為一層縮排。
冒號後面一定要有空格
寫設定時，冒號後面必須加上一個空格（ 例如title: 我的文章 ），只寫 title:我的文章 是錯誤的。
大小寫敏感
Title 、 TITLE 和 title 在YAML裡被視為完全不同的東西。

四大基礎語法與資料型態

在Markdown的文章開頭（Front Matter），會用到的語法主要有以下四種：

基礎鍵值對（Key-Value）

最簡單的設定，用來宣告單一屬性。

yamltitle: 我的第一篇文章 # 字串：通常不需要加引號
draft: false # 布林值：必須是小寫的true或false
weight: 10 # 整數
price: 99.9 # 浮點數

字串與引號（String）

單引號會將內容視為純字串（Literal String）。裡面的所有字元都不會被轉義（Escape），寫什麼就是什麼。雙引號會解析跳脫字元（Escape Characters），用換行、縮排等特殊字元時用，如寫 text: "第一行\n第二行" 將會換行。定義物件（Key）時，YAML的Key通常不加引號，保持乾淨。布林值、數字、Null亦不加引號。

使用時機對照表

情況	無引號	`' '`	`" "`
一般純文字 ( `hello` )	建議使用	可用	可用
包含特殊符號 ( `:` , `#` , `[]` )	不可	最安全	可用
強制轉為字串 ( `true` , `123` )	不可，變布林/數字	最安全	可用
需要跳脫字元 ( `\n` 換行)	不可，失效	不可，失效	可用

範例：

中英文間隔CSS

Fri, 04 Sep 2026 00:00:00 +0000

環境

作業系統：Windows 11
程式碼編輯器：Visual Studio Code
紀錄時間：2026年9月

語法

text-autospace CSS屬性允許指定中日韓（CJK）字元和非中日韓字元之間的間距行為。

body {
 text-autospace: normal;
}

normal ：建立預設行為，自動在CJK字元與非CJK字元之間以及標點符號周圍新增間距。此值的效果等同於同時應用 ideograph-alpha 和 ideograph-numeric 。

為什麼用它代替空格

以往在網頁上用鍵盤打半形空格（Space）會顯得中英文間距過大（寬度高達0.5em）。而 text-autospace 是由瀏覽器自動計算並塞入約1/8 em的微小微調間距，視覺效果比純空格更緊湊、更具美感。

如果網頁內容本身已經有用鍵盤打的實體空格，瀏覽器在解析 text-autospace 時會自動跳過，不會讓你的間距疊加變得更寬。

在VS Code中把Markdown中英文之間的空格消除

方法一、搜尋與取代

在VS Code中打開你的檔案，按下Ctrl + H開啟取代視窗，並依照下列步驟設定：

開啟正規表達式模式：請務必點亮搜尋框最右側的 .* 圖示（或按下快捷鍵Alt + R，啟用正規表達式功能。
欄位輸入內容你需要分兩次操作，一次清除「中文+空格+英文」，一次清除「英文+空格+中文」：
- 步驟A：清除【中文 ➔ 英文】之間的空格尋找 (Find)： ([\u4e00-\u9fa5]+) +([a-zA-Z0-9]+) 取代為 (Replace)： $1$2 動作：點擊右側的Replace All（全部取代）圖示（或按Ctrl + Alt + Enter）。
- 步驟B：清除【英文 ➔ 中文】之間的空格尋找 (Find)： ([a-zA-Z0-9]+) +([\u4e00-\u9fa5]+) 取代為 (Replace)： $1$2 動作：再次點擊Replace All（全部取代）。

原理說明

[\u4e00-\u9fa5] ：代表所有的中文字（Unicode範圍）。 [a-zA-Z0-9] ：代表所有的英文字母與數字。 + （中間有空格）：代表匹配一個或多個連續的半形空格。 () 與 $1$2 ：把前後的文字暫存起來，並在取代時直接黏在一起，中間的空格就會被刪除。

Git bash設定

Thu, 03 Sep 2026 00:00:00 +0000

環境

作業系統：Windows 11
程式碼編輯器：Visual Studio Code
紀錄時間：2026年9月

在Windows Terminal中使用Git Bash

到Windows Terminal的設定畫面
左側選單到最下方，點擊「開啟JSON檔案」。

尋找 "profiles" 底下的 "list" 區段，將以下這段程式碼複製，貼到 "list": [ 的中括號內部（記得與其他項目之間用逗號 , 隔開）：

{
// 這是我手動新增的Git Bash設定檔
"guid": "{1c4de342-38b7-51cf-b111-23098613f530}",
"hidden": false,
"name": "Git Bash",
// 鎖定標籤頁標題，不要顯示冗長的路徑
"suppressApplicationTitle": true,
// 徹底關閉Windows Terminal的鈴鐺通知圖示與聲音
"bellStyle": "none",
// --login用來讀取個人設定，-i用來開啟互動打字模式
"commandline": "C:\\Program Files\\Git\\bin\\bash.exe --login -i",
"icon": "C:\\Program Files\\Git\\mingw64\\share\\git\\git-for-windows.ico"
}

注意：在JSON檔案中，標準語法其實不支援任何註解（像是 // 或 /* */ ）。如果直接寫 // ，很多軟體會直接報錯，導致設定檔失效。Windows Terminal和VS Code這兩款微軟的軟體在讀取settings.json時，有特別開外掛支援「JavaScript風格的註解」，可以直接使用 // 來寫單行註解。

說明

標籤頁標題

Git Bash預設會主動將目前的「工作目錄路徑」傳送給終端機，覆蓋掉你設定的名字。只需要把它關閉即可只顯示乾淨的「Git Bash」。

`--login` (登入模式)

告訴Bash：「請把我當成剛開機、第一次登入的使用者。」只有在 --login 模式下，Git Bash才會去讀取並執行讀取你的個人設定檔。如果拿掉它，終端機就不會載入你的自訂顏色與標籤設定。

各縣市人口統計連結

Wed, 02 Sep 2026 00:00:00 +0000

說明

表格包含網站連結、資料提供形式及下載檔案格式。
檔案格式「web」的意思是可以直接在網站看到資料，不用另外下載。
縣市順序依照內政部戶政司公布的人口統計資料來排序。
要查出生、死亡、結婚及離婚等數據，找標有戶籍動態登記數的檔案或連結就可以了。

列表

縣市	檔案格式	備註
總計一	.xls, .ods	內政部戶政司人口統計資料
總計二	.csv	數位發展部政府資料開放平台
新北市	web, .xls, .ods, .csv
臺北市	.ods
桃園市	.pdf, .ods
臺中市	web, .xlsx, .ods
臺南市	.xls, .ods
高雄市	web, .xlsx, .ods, .csv
宜蘭縣	.ods
新竹縣	.xlsx, .pdf, .ods
苗栗縣	web, .xlsx	下載要點左邊的某年人口統計下載區
彰化縣	.pdf, .ods
南投縣	web, .xlsx, .ods, .xml
雲林縣	web, .xls, .ods
嘉義縣	.xlsx, .pdf, .ods	在公告裡，表1
屏東縣	.xlsx, .pdf, .ods
臺東縣	.pdf	標題點開直接就是檔案連結
花蓮縣	.xlsx
澎湖縣	.xlsx, .pdf, .ods
基隆市	.ods, .csv
新竹市	.csv, .pdf
嘉義市	web, .xls, .ods
金門縣	.xls, .pdf, .ods	在公告裡，人口異動表
連江縣	.xlsx, .ods, .zip

文件閱讀軟體（免費的）

LibreOffice：桌面版
數發部ODF文件應用工具：桌面版
ONLYOFFICE：桌面版手機版皆有
Sumatra PDF：看PDF專用，限Windows
MobiOffice：手機版，看微軟文件格式及PDF
OpenDocument Reader：看ODF格式
Google文件：需連網

ODF格式

ODF（Open Document Format，開放文件格式）是一種基於 XML 的國際標準電子文件格式，常用於文書處理（如 .odt）、試算表（如 .ods）與簡報（如 .odp）。
人口統計都是表格，所以是 .ods。

PaperMod主題設定

Tue, 01 Sep 2026 00:00:00 +0000

顏色

設定的顏色

程式碼

檔案路徑： /assets/css/extended/custom.css
HEX（十六進位色碼）是我有修改的，RGB是原本的。

/* Dark mode下的顏色 */
:root[data-theme="dark"] {
 --theme: #0e1923;
 --entry: #474a4d;
 --primary: #e7e7eb;
 --secondary: #e7e7eb;
 --tertiary: rgb(65, 66, 68);
 --content: #e7e7eb;
 --code-block-bg: rgb(46, 46, 51);
 --code-bg: rgb(55, 56, 62);
 --border: #afafb0;
 color-scheme: dark;
}
/* 文章底下的標籤 */
.post-tags a {
 background: #474a4d;
}

字體大小與排版

檔案路徑： /assets/css/extended/custom.css

/* 全站適用：開啟中英文與數字之間的自動微調空格 */
html,
body {
 text-autospace: normal !important;
}
/* 調整文章內文的字體大小 */
.post-content,
.post-content p {
 font-size: 1.2rem;
 line-height: 1.7;
 /* 同步調大行高，閱讀起來更舒適 */
}
/* 放大文章日期、作者、閱讀時間等 */
.post-meta {
 font-size: 1.2rem !important;
 margin-top: 0.5rem !important;
 /* 增加日期與上方標題之間的間距，看起來更舒適 */
}
.post-tags a {
 font-size: 1.2rem !important;
 padding: 0.25rem 0.625rem !important;
 /* 同步將邊距換算為rem，按鈕會隨字體完美縮放 */
}
/* 調整文章內的程式碼區塊字體大小 */
.post-content pre code {
 font-size: 16px !important;
 line-height: 1.6 !important;
}
/* 行內程式碼也一起放大 */
.post-content code {
 font-size: 0.95em !important;
 /* 使用相對大小，讓它隨段落文字等比例放大 */
}
/* 放大程式碼複製按鈕 */
.copy-code {
 transform: scale(1.5) !important;
 transform-origin: right top;
 /* 確保按鈕以右上角為基準點放大，不影響排版 */
}
/* 單篇文章頁面底部的標籤區塊 */
.share-buttons+.post-tags,
footer.post-footer .post-tags a {
 font-size: 1.2rem !important;
}
/* 強制放大首頁文章列表的日期與資訊文字 */
.first-entry footer,
.post-entry footer,
.entry-footer {
 font-size: 1.2rem !important;
}
/* 縮小首頁文章卡片的邊框內邊距，讓邊框緊貼文字 */
.post-entry {
 padding: 0.5rem 1rem !important;
}
/* 確保點擊整張卡片時的互動範圍同步縮小 */
.post-link {
 padding: 0 !important;
 /* 清除連結的預設補白，避免撐開卡片 */
}
/* 微調標題與日期之間的距離，讓整張卡片更緊湊 */
.post-entry .entry-header h2 {
 margin-bottom: 0.25rem !important;
 /* 縮小標題與日期之間的空隙 */
}
/* 縮小首頁文章卡片之間的間距 */
.post-entry {
 margin-bottom: 20px !important;
}
/* 放大網頁最下方的Footer頁尾文字 */
.footer {
 font-size: 1rem !important;
 line-height: 1.6 !important;
 /* 同步調大行高，避免多行時擠在一起 */
}

連結

設定連結在新分頁開啟。
檔案路徑： /layouts/_default/_markup/render-link.html"

DocusNotes

【置頂】

PowerShell與WSL

環境

Windows PowerShell和PowerShell 7+

PowerShell 7+

安裝

更新

其他

最新的PowerShell可以用linux指令嗎？

WSL

安裝

TOML語法

核心規則

四大基礎語法與資料型態

YAML語法

核心規則

四大基礎語法與資料型態

基礎鍵值對（Key-Value）

字串與引號（String）

中英文間隔CSS

環境

語法

為什麼用它代替空格

在VS Code中把Markdown中英文之間的空格消除

方法一、搜尋與取代

原理說明

Git bash設定

環境

在Windows Terminal中使用Git Bash

說明

標籤頁標題

--login (登入模式)

各縣市人口統計連結

說明

列表

文件閱讀軟體（免費的）

ODF格式

PaperMod主題設定

顏色

設定的顏色

程式碼

字體大小與排版

連結

`--login` (登入模式)