Kotlin introduction

Kotlin 導入のための資料です。
GitHub pages を使ってホスティングしています。
https://access-company.github.io/kotlin_intro/

ドキュメントのビルド方法

Minimum

必要なツール

npm
HonKit
- npm install -g honkit
GitBook各種プラグイン
- Dockerfileを参考に入れてください

ビルド方法

リポジトリをクローンします。
トップディレクトリにて、以下のコマンドを実行します。

$ make

ドキュメントが docs ディレクトリに生成されます。
参照する場合は、docs ディレクトリを何らかの形でホスティングしてください。

おすすめ（Docker利用）

必要なツール

Docker Desktop
VSCode
Remote Containers
docker-sync via gem install docker-sync（Rubyも必要）

ビルド準備

VSCodeでkotlin_introフォルダを開く
VSCodeのターミナル→新しいターミナル
docker-sync start
VSCodeの左下端をタップ
Reopen in Containerを選択

ビルド方法

Dockerコンテナ内でmakeを実行

ドキュメントがDockerコンテナ内のdocsに生成され、ホスト側にもsyncされます。

プレビュー方法

Dockerコンテナ内でhttp-server docsを実行
http://localhost:8080/ をブラウザで開く

トラブルシューティング

Error: Couldn't locate plugins "codeblock-filename", Run 'gitbook install' to install plugins from registry.

と出力された場合、npm経由でプラグインをインストールしてください。

npm i -g gitbook-plugin-codeblock-filename