Help us understand the problem. What is going on with this article?

Gitbook-Plugin-Plantumlをgit cloneから利用できるようにする

More than 1 year has passed since last update.

Abstract

wordで仕様書であったり設計書を書いてたけど,
とってもいいツール(gitbook)を見つけてしまったのでそちらへ移行した際にプラグインの一つが上手く動かなかったのでそのお話.

開発環境はMacです.

Background

gitbookを使うことでmarkdown形式でドキュメントが書けるようになりました.
しかも,HTML,PDFなどに簡単にエキスポートできます.素晴らしい.

ですが,設計書を書く上で図表作成は避けれぬ道.

そこで,gitbookに図表生成ツールがあるのか探していたところ,ツールがありました.

二つあります.どちらでもいいと思います.
今回は,vowstar/gitbook-plugin-umlで作業を進めます.(私の環境ではlyhcode/gitbook-plugin-plantumlが動かなかった

npm installが進まない...

How to

graphvizとplantuml本体をインストール

# もしかしたらこの作業はいらないかもしれない
$ brew install graphviz
$ brew install plantuml

npmでvowstar/gitbook-plugin-umlをインストール

$ npm i -D gitbook-plugin-uml
⸨░░░░░░░░░░░░░░░░░░⸩ ⠋ fetchMetadata: sill resolveWithNewModule gitbook-plugin-uml@1.0.0 checking installable status

止まった.動かない.


しょうがないのでgitから直接インストールする.

$ git clone https://github.com/vowstar/gitbook-plugin-uml.git

gitbookのnode_modulesの中にcloneしたvowstar/gitbook-plugin-umlを配置
vowstar/gitbook-plugin-umlはnode-plantumlを用いているのでそれもインストール

$ npm i -D node-plantuml

gitbookのbook.jsonのpluginsへ以下を記述

{
    "plugins": ["uml"],
}

gitbook への適用

$ gitbook install
info: installing 1 plugins using npm@3.9.2 
info:  
info: installing plugin "uml" 
info: install plugin "uml" (*) from NPM with version 1.0.0 
info: >> plugin "uml" installed with success 

確認

ここのサンプルコードをmdファイルに書く

$ gitbook serve

http://localhost:4000/ へアクセス,表示できていれば終了

Conclusion

結構時間かかったので,苦戦している方は是非お試しあれ.

References

Why not register and get more from Qiita?
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away
Comments
No comments
Sign up for free and join this conversation.
If you already have a Qiita account
Why do not you register as a user and use Qiita more conveniently?
You need to log in to use this function. Qiita can be used more conveniently after logging in.
You seem to be reading articles frequently this month. Qiita can be used more conveniently after logging in.
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away
ユーザーは見つかりませんでした