mdBook

環境

rustc 1.52.0-nightly (fe1bf8e05 2021-02-23)

インストール

cargo install mdbook

HelloWorld

serve時のデフォルトポートは3000
serve時のライブリロードに利用するWebSocketポートは3001(localhostのみ)

mkdir -p note
cd note
mdbook init
mdbook build
ls book

step2

コマンドはMakefileでまとめる
Markdownディレクトリをmdディレクリに変更
html出力先をhtmlディレクトリに変更
(細かい挙動をbook.tomlで変更)
リソースを追加(theme/additional.css,theme/additional.js)
highlightjsのカラーテーマを変更
localhost以外からアクセスさせるためserve時に-n 0.0.0.0を指定
テンプレートを変更したい場合はtheme/index.hbsやtheme/header.hbsなどを修正

////シンタックスハイライトをSublimeTextのmonokaiテーマにする
wget https://raw.githubusercontent.com/highlightjs/highlight.js/master/src/styles/monokai-sublime.css -O theme/highlight.css

##Makefile
watch:
	mdbook watch
build:
	mdbook build
serve:
	mdbook serve -p 3000 -n 0.0.0.0

##book.toml
[book]
authors = ["root"]
language = "ja"
multilingual = false
src = "md"

[build]
build-dir = "html"
create-missing = false

[output.html]
additional-css = ["theme/additional.css"]
additional-js = ["theme/additional.js"]
mathjax-support = true
no-section-label = true
#google-analytics = "UA-XXXXXXXX"
#site-url = "/note/"

#[preprocessor.random]
#command = "python random.py"

////additional.js
(function () {
  var as = document.querySelectorAll('a.header')
  var newList = document.createElement('ul');
  newList.setAttribute('class', 'innerLink');
  for (var i = 1, l = as.length; i < l; i += 1) {
    var a = as[i];
    var label = a.innerText;
    var href = a.getAttribute('href');
    var newAnchor = document.createElement('a');
    newAnchor.setAttribute('href', href);
    newAnchor.innerHTML = label;
    var newItem = document.createElement('li');
    newItem.appendChild(newAnchor);
    newList.appendChild(newItem);
  }
  document.querySelector('.sidebar .active').appendChild(newList);
})();

/*theme/additional.css*/

pre > .buttons button {
  color: white;
}

html {
  height: 100%;
}

body {
  min-height: 100%;
  position: relative;
}

.chapter li.chapter-item {
  font-size: 12px;
  line-height: 12px;
}

/**/
ul.innerLink {
  margin: 5px 0px 0px 0px;

}

ul.innerLink > li,
ul.innerLink > li > a {
  font-size: 10px;
  line-height: 12px;
}

ul.innerLink > li > a {
  position: relative;
}

ul.innerLink > li > a:before {
  content: ">>";
  position: absolute;
  left: -1.5em;
}

/**/
.page {
  padding: 57px var(--page-padding) 0px var(--page-padding) !important;
}

.sidebar .sidebar-scrollbox {
  padding: 57px 10px 10px 10px !important;
}

# mdBook

# 環境

# インストール

# HelloWorld

# step2

# Reference

mdBook

環境

インストール

HelloWorld

step2

Reference