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
,一切無誤的話會看到預設的網頁內容。
2.2.4. 頁面基本操作
圖示 | 操作 | 說明 |
---|---|---|
目錄與內容 | 左右變更大小 | |
切換目錄 | 顯示或隱藏最左側的章節目錄 | |
跳至下一章節 | 顯示下一章節網頁 | |
跳至上一章節 | 顯示上一章節網頁 | |
全文檢索 | 搜尋輸入的文字 | |
變更主題 | 變更顯示的頁面樣式 | |
切換目錄 | 顯示或隱藏最左側的章節目錄 |