2.2. 初次執行

在要存放書本的資料夾內執行指令mdbook init並回應內容:

2.2.1. 啟始環境

mdbook init

Do you want a .gitignore to be created? (y/n)
y
What title would you like to give the book?
我的第一本網頁書
2020-04-23 18:04:31 [INFO] (mdbook::book::init): Creating a new book with stub content

All done, no errors...

💡 要產生樣式檔則使用mdbook init --theme,/src會多出theme子目錄

mdBook自動產生書本的原始架構與相關檔案。目錄結構如下:

存放書本的資料夾/
├── book
└── src
    ├── chapter_1.md
    └── SUMMARY.md

2.2.2. 組建書本

子目錄與檔案都產生後以下列指令執行第一次組建:

mdbook build

一切正常的話表示 book 資料夾內已有需要的網頁檔案了,再來啟動測試用的網頁伺服器:

mdbook serve

2.2.3. 檢視輸出

最後用瀏覽器瀏覽 http://localhost:3000,一切無誤的話會看到預設的網頁內容。

1

2.2.4. 頁面基本操作

圖示操作說明
1目錄與內容左右變更大小
2切換目錄顯示或隱藏最左側的章節目錄
next跳至下一章節顯示下一章節網頁
prev跳至上一章節顯示上一章節網頁
search全文檢索搜尋輸入的文字
theme變更主題變更顯示的頁面樣式
2切換目錄顯示或隱藏最左側的章節目錄