LoginSignup
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

@TanukiTam

honkitを使った[Docker][docker-compose]

Posted at

honkit

はじめに

そうだ Docker も使えるようになろうと唐突に思い立ち、honkit（始めはGitBook）環境を作りながらやったら、すごい大変だった。

参考にしたサイトは沢山。ありがとう皆々様。
honkitは、マークダウン文章をpdfにしたり、説明書をオシャっぽくHTMLで仕上げたいとか、便利だと思う。

でも、環境構築するための学習コスト高くて辛かった。

ディレクトリ構成

~/docker/honkit:
  d _bin
  d _book
  d assets
  d book
  d images
  d node_modules
  d styles
  - .bookignore
  - Dockerfile
  - GLOSSARY.md
  - README.md
  - SUMMARY.md
  - book.json
  - package.json
  - puppeteer-config.json

~/docker/honkit/book:
  d 01-docker
      - Dockerfile.md
      - README.md
      - book.json.md
      - image-alpine-homebrew.md
      - image-alpine.md
      - y-vectorfield.md
  d 05-honkit
      d 05-plugins
          - 99-plugin.org
          - 99-scrap.md
          - README.md
          - alerts.md
          - anchor-navigation-ex.md
          - auto-scroll-table.md
          - auto-summary.md
          - chapter-fold.md
          - code.md
          - collapsible-chapters.md
          - copy-code-button.md
          - custom-js-css.md
          - expandable-chapters-small.md
          - expandable-chapters.md
          - flexible-alerts.md
          - hide-published-with.md
          - hints.md
          - image-captions.md
          - include-codeblock.md
          - include-csv.md
          - isummary.md
          - japanese-support.md
          - katex-pro.md
          - lb2br.md
          - mermaid-gb3.md
          - mermaid-newface.md
          - plantuml.md
          - search-pro-fixed.md
          - splitter.md
          - summary.md
          - tags.md
          - theme-code.md
          - todo.md
          - uml.md
          - url-embed.md
      - README.md
      - summary.md
  d 80-test
  d 99-formats
      - 01-formats.md
      - 10-formats-titles.md
      - 11-formats-table.md
      - 20-formats-code.md
      - 30-formats-link.md
      - 31-formats-image.md
      - 60-formats-mermaid.md
      - 61-formats-plantuml.md
      - README.md
  - README.md

インストール

~/docker/honkit/Dockerfile

  • dockerで使う
FROM node:lts-bookworm
RUN apt-get update && apt-get upgrade -y
RUN apt-get install --no-install-recommends --allow-unauthenticated -y \
    calibre \
    sudo locales \
    fdclone lv ng-cjk silversearcher-ag \
    build-essential default-jre graphviz \
    libatk-bridge2.0-0 \
    fonts-ipafont fonts-ipaexfont fonts-noto-cjk
COPY ./_bin/.* /root/
COPY ./_bin/.*.sh /usr/local/bin

RUN mkdir -p /honkit && mkdir -p /work
RUN curl --compressed -o- -L https://yarnpkg.com/install.sh | bash
ENV PATH=/honkit/node_modules/.bin:$PATH
ENV QTWEBENGINE_CHROMIUM_FLAGS="--no-sandbox"

WORKDIR /honkit
ENV BOOKDIR=/honkit
EXPOSE 4000 35729
VOLUME $BOOKDIR
COPY ./ ./

# PlantUMLの吐き出す画像で日本語が表示出来ない問題に対応
RUN echo "ja_JP.UTF-8 UTF-8" > /etc/locale.gen
RUN locale-gen ja_JP
RUN update-locale LANG=ja_JP.UTF-8
ENV LANG="ja_JP.UTF-8" \
    LANGUAGE="ja_JP:ja" \
    LC_ALL="ja_JP.UTF-8" \
    TZ=Asia/Tokyo

~/docker/honkit/.bookignore

  • _book ディレクトリにビルドしないファイル
!assets/images/
/.*
/*.sh
/.bookignore
/.gitignore
/_arc
/LICENSE
docker-compose.*
package.json
yarn.lock

~/docker/honkit/book.json

  • honkit 設定ファイル
{
  "language": "ja",
  "root": ".",
  "sortedBy": "-",
  "​structure": {
    "readme": "README.md",
    "summary": "SUMMARY.md​",
    "glossary":"GLOSSARY.md",
    "languages":"LANGS.md"
  },
  "redirects": {
    "previous/page": "new-folder/page.md"
  },
  "plugins": [
    "-chapter-fold",
    "-collapsible-chapters",
    "-expandable-chapters",
    "-lunr", "-search", "search-pro-fixed",
    "-summary",
    "mermaid-newface",
    "puml",
    "-highlight", "-highlight-pro",
    "@ansanloms/uml",
    "alerts",
    "anchor-navigation-ex",
    "auto-scroll-table",
    "auto-summary",
    "code",
    "codeblock-filename",
    "custom-js-css",
    "expandable-chapters-small",
    "hide-published-with",
    "hints",
    "image-captions",
    "include-codeblock",
    "japanese-support",
    "katex-pro",
    "lb2br",
    "livereload",
    "splitter",
    "tags",
    "theme-code",
    "todo"
  ],
  "pluginsConfig": {
    "anchor-navigation-ex": {
      "showLevel": false,
      "float": {
        "floatIcon": "fa fa-navicon",
        "showLevelIcon": false,
        "level1Icon": "fa fa-hand-o-right",
        "level2Icon": "fa fa-hand-o-right",
        "level3Icon": "fa fa-hand-o-right"
      },
      "pageTop": {
        "showLevelIcon": false,
        "level1Icon": "fa fa-hand-o-right",
        "level2Icon": "fa fa-hand-o-right",
        "level3Icon": "fa fa-hand-o-right"
      },
      "themeDefault": {
        "showLevel": false
      }
    },
    "custom-js-css": {
      "js": [
        "styles/my.js"
      ],
      "css": [
        "styles/github-css.css",
        "styles/my.css"
      ]
    },
    "auto-summary": {
      "parts": {
        "README.md": "はじめに",
        "book/01-docker/**/*.md": "docker",
        "book/05-honkit/**/*.md": "honkit",
        "book/80-test/**/*.md": "テスト",
        "book/99-formats/**/*.md": "フォーマット"
      }
    },
    "uml": {
      "format": "svg",
      "charset": "utf8",
      "config": "classic"
    },
    "highlight-pro": {
      "theme": "mono-blue",
      "map": {
        "shell": "bash",
        "sh": "bash",
        "mermaid": "bash",
        "txt": "markdown"
      }
    }
  },
  "pdf":{
    "pageNumbers":true,
    "fontFamily":"Arial",
    "fontSize":12,
    "paperSize":"a4",
    "margin":{
      "right":62,
      "left":62,
      "top":56,
      "bottom":56
    }
  },
  "styles": {
    "website": "styles/website.css",
    "ebook": "styles/ebook.css",
    "pdf": "styles/pdf.css",
    "mobi": "styles/mobi.css",
    "epub": "styles/epub.css"
  }
}

~/docker/honkit/package.json

  • yarn install で node_modules にインストールする
{
  "name": "honkit",
  "version": "1.0.0",
  "main": "index.js",
  "license": "MIT",
  "dependencies": {
    "@ansanloms/honkit-plugin-uml": "^0.0.8",
    "auto-scroll-table": "git+https://github.com/ideamean/gitbook-plugin-auto-scroll-table.git",
    "gitbook-plugin-ace": "^0.3.2",
    "gitbook-plugin-alerts": "^0.2.0",
    "gitbook-plugin-anchor-navigation-ex": "^1.0.14",
    "gitbook-plugin-auto-scroll-table": "^0.0.5",
    "gitbook-plugin-auto-summary": "^0.0.2",
    "gitbook-plugin-chapter-fold": "^0.0.4",
    "gitbook-plugin-code": "^0.1.0",
    "gitbook-plugin-codeblock-filename": "^0.0.9",
    "gitbook-plugin-collapsible-chapters": "^0.1.8",
    "gitbook-plugin-custom-js-css": "^0.0.1",
    "gitbook-plugin-expandable-chapters": "^0.2.0",
    "gitbook-plugin-expandable-chapters-small": "^0.1.7",
    "gitbook-plugin-hide-published-with": "^0.0.1",
    "gitbook-plugin-highlight-pro": "https://github.com/tkggcelt/gitbook-plugin-highlight-pro.git",
    "gitbook-plugin-hints": "^1.0.2",
    "gitbook-plugin-include-codeblock": "^3.2.3",
    "gitbook-plugin-japanese-support": "^0.0.1",
    "gitbook-plugin-katex-pro": "^0.16.3",
    "gitbook-plugin-lb2br": "^0.0.5",
    "gitbook-plugin-mermaid-newface": "^4.1.0",
    "gitbook-plugin-puml": "^1.0.1",
    "gitbook-plugin-search-pro-fixed": "^1.0.1",
    "gitbook-plugin-splitter": "^0.0.8",
    "gitbook-plugin-tags": "^1.5.2",
    "gitbook-plugin-theme-code": "^0.0.24",
    "gitbook-plugin-todo": "^0.1.3",
    "gitbook-summary": "^1.2.4",
    "honkit": "^6.0.3",
    "honkit-plugin-image-captions": "https://github.com/youyinnn/honkit-plugin-image-captions",
    "node-sass": "^9.0.0"
  }
}

~/docker/honkit/puppeteer-config.json

  • 忘れた
{
  "args": ["--no-sandbox"]
}

~/docker/honkit/_bin/.bashrc

※ 必要じゃない

  • ログインシェルで使う
# ~/.bashrc: executed by bash(1) for non-login shells.
# see /usr/share/doc/bash/examples/startup-files (in the package bash-doc)
# for examples

# If not running interactively, don't do anything
[ -z "$PS1" ] && return

# don't put duplicate lines in the history. See bash(1) for more options
# ... or force ignoredups and ignorespace
HISTCONTROL=ignoredups:ignorespace

# append to the history file, don't overwrite it
shopt -s histappend

# for setting history length see HISTSIZE and HISTFILESIZE in bash(1)
HISTSIZE=1000
HISTFILESIZE=2000

# check the window size after each command and, if necessary,
# update the values of LINES and COLUMNS.
shopt -s checkwinsize

# make less more friendly for non-text input files, see lesspipe(1)
[ -x /usr/bin/lesspipe ] && eval "$(SHELL=/bin/sh lesspipe)"

# set variable identifying the chroot you work in (used in the prompt below)
if [ -z "$debian_chroot" ] && [ -r /etc/debian_chroot ]; then
    debian_chroot=$(cat /etc/debian_chroot)
fi

# set a fancy prompt (non-color, unless we know we "want" color)
case "$TERM" in
    xterm-color) color_prompt=yes;;
esac

# uncomment for a colored prompt, if the terminal has the capability; turned
# off by default to not distract the user: the focus in a terminal window
# should be on the output of commands, not on the prompt
#force_color_prompt=yes

if [ -n "$force_color_prompt" ]; then
    if [ -x /usr/bin/tput ] && tput setaf 1 >&/dev/null; then
	# We have color support; assume it's compliant with Ecma-48
	# (ISO/IEC-6429). (Lack of such support is extremely rare, and such
	# a case would tend to support setf rather than setaf.)
	color_prompt=yes
    else
	color_prompt=
    fi
fi

if [ "$color_prompt" = yes ]; then
    PS1='${debian_chroot:+($debian_chroot)}\[\033[01;32m\]\u@\h\[\033[00m\]:\[\033[01;34m\]\w\[\033[00m\]\$ '
else
    PS1='${debian_chroot:+($debian_chroot)}\u@\h:\w\$ '
fi
unset color_prompt force_color_prompt

# If this is an xterm set the title to user@host:dir
case "$TERM" in
xterm*|rxvt*)
    PS1="\[\e]0;${debian_chroot:+($debian_chroot)}\u@\h: \w\a\]$PS1"
    ;;
*)
    ;;
esac

# enable color support of ls and also add handy aliases
if [ -x /usr/bin/dircolors ]; then
    test -r ~/.dircolors && eval "$(dircolors -b ~/.dircolors)" || eval "$(dircolors -b)"
    alias ls='ls --color=auto'
    #alias dir='dir --color=auto'
    #alias vdir='vdir --color=auto'

    alias grep='grep --color=auto'
    alias fgrep='fgrep --color=auto'
    alias egrep='egrep --color=auto'
fi

# some more ls aliases
alias ll='ls -alF'
alias la='ls -A'
alias l='ls -CF'

# Alias definitions.
# You may want to put all your additions into a separate file like
# ~/.bash_aliases, instead of adding them here directly.
# See /usr/share/doc/bash-doc/examples in the bash-doc package.

if [ -f ~/.bash_aliases ]; then
    . ~/.bash_aliases
fi

~/docker/honkit/_bin/.fd2rc

※ 必要じゃない

  • FDCloneで使う
PAGER=lv
EDITOR=ng
SHELL=/bin/sh

MESSAGELANG=ja
SIZEUNIT=1
TMPDIR=/home/bone/tmp
SORTTYPE=201
DISPLAYMODE=3
ANSICOLOR=1
UNICODEBUFFER=1
#export	LANG=C
LANG=ja_JP.UTF-8
LANGUAGE=$LANG
INPUTKCODE=$LANG
FNAMEKCODE=$LANG

~/docker/honkit/_bin/.ng

※ 必要じゃない

;; $Id: dot.ng,v 1.1.1.1 2000/06/27 01:47:57 amura Exp $
;;
;;	Ng startup file by H.Ohkubo
;;
;;
;; (global-unset-key "\^[\[" 'backward-paragraph)
;; (global-set-key "\^[\[A" 'previous-line)
;; (global-set-key "\^[\[B" 'next-line)
;; (global-set-key "\^[\[C" 'forward-char)
;; (global-set-key "\^[\[D" 'backward-char)
;;
;; (global-set-key "\^[OA" 'previous-line)
;; (global-set-key "\^[OB" 'next-line)
;; (global-set-key "\^[OC" 'forward-char)
;; (global-set-key "\^[OD" 'backward-char)
;;
;; (global-set-key "\^[2A" 'beginning-of-buffer)
;; (global-set-key "\^[2B" 'end-of-buffer)
;; (global-set-key "\^[5A" 'beginning-of-line)
;; (global-set-key "\^[5B" 'end-of-line)
;
; 'next-line' doesn't insert newline at the end of buffer.
(next-line-add-newlines nil)
;
; backspace <-> ^H
; exchange C-h with DEL.
(bsmap-mode)
;
; for No Backup files
; don't make backup files.
(make-backup-files nil)
 
; regexp search by typing ESC C-s/C-r
(global-set-key "\^[\^s" 're-search-forward)
(global-set-key "\^[\^r" 're-search-backward)

;	set-mark-command to ^\
;(global-set-key "\^\\" 'set-mark-command)

;	set-fep-toggle to ^\
;(global-set-key "\^\\" 'fep-toggle)

;(global-set-key "\^\\" 'set-mark-command)

;(set-kanji-expected-code nil)
;(set-default-fileio-code 'euc)
;(set-kanji-fileio-code 'euc)
(set-kanji-expected-code nil)
(set-default-fileio-code 'utf)
(set-kanji-fileio-code 'utf)

; c-mode setting
; C モードの変数を一般的な C 言語のスタイルに合わせたい時は次のようにします。
;
(set-c-argdecl-indent 0)
(set-c-continued-statement-offset 4)
(set-c-continued-brace-offset -4)
(set-c-brace-offset -4)
(set-c-brace-imaginary-offset 0)
(set-c-indent-level 4)
(set-c-label-offset -2)
(set-c-tab-always-indent t)

;   行頭禁則文字に '>' を、行末禁則文字に '<' を追加したい場合、次のようにし
;   ます。
;
;(add-kinsoku-bol-chars ">")
;(add-kinsoku-eol-chars "<")
;
;   行頭禁則文字から「／」と「＼」を削除したい場合は次のようにします。
;
;(delete-bol-kinsoku-chars "／＼") 
;
; blink matching parens
; 括弧の対応を自動的に表示させたい場合は次のようにします。
;
(global-set-key ")" 'blink-matching-paren-hack)
(global-set-key "}" 'blink-matching-paren-hack)
(global-set-key "]" 'blink-matching-paren-hack)


; ESC C-s/C-r で正規表現検索をするようにしたい場合は次のようにします。
; set regular-exp. re-search
;
;(global-set-key "\^[\^s" 're-search-forward)
;(global-set-key "\^[\^r" 're-search-backward)

;
;   FEP 自動制御機能を常に有効にしたい場合は次のようにします。
;
;(set-fep-control t)

;	setting for SKG
;(set-skg-roman-dictionary "/home/anonymous/etc/SKG-ROMAN")
;(set-skg-kanji-dictionary "/home/anonymous/etc/SKG-JISYO")
;
: other setting
(set-fill-column 80)


;; ;C-\ to canna-toggle (jedε
;;     (global-set-key "\^\\" 'canna-toggle)
;; ;C-t
;;     (global-set-key "\^t" 'scroll-down)
;; ;C-j
(global-set-key "\^xj" 'goto-line)
;;  (global-set-key "\^[g" 'goto-line)
;; ;ESC-h to help
(global-set-key "\^[h" 'help-help)
;; ;C-h Backspace to delete backward
(global-set-key "\^h" 'delete-backward-char)
;; ;Del to delete char(can't use on kon2)
;;     (global-set-key "\^?" 'delete-char)
;; ;Cursor
(global-set-key "\^[[A" 'previous-line)
(global-set-key "\^[[B" 'next-line)
(global-set-key "\^[[D" 'backward-char)
(global-set-key "\^[[C" 'forward-char)
;Home and End(for console only)
(global-set-key "\E[H" 'beginning-of-line)
(global-set-key "\E[F" 'end-of-line)
(global-set-key ";5H" 'beginning-of-buffer)
(global-set-key ";5F" 'end-of-buffer)
;; ;PageUp and PageDown(for console)
(global-set-key "\E[I" 'scroll-down)
(global-set-key "\E[G" 'scroll-up)
;; ;PageUp and PageDown(for X)
(global-set-key "\E[5~" 'scroll-down)
(global-set-key "\E[6~" 'scroll-up)
;; ;Ins(for X)
;; ;   (global-set-key "\E[2~" 'overwrite-mode)
;;
;;(global-set-key "5~" 'scroll-down)
;;(global-set-key "6~" 'scroll-up)

~/docker/honkit/_bin/.profile

※ 必要じゃない

  • ログインシェルで使う
# ~/.profile: executed by Bourne-compatible login shells.

if [ "$BASH" ]; then
  if [ -f ~/.bashrc ]; then
    . ~/.bashrc
  fi
fi

mesg n 2> /dev/null || true

~/docker/honkit/_bin/add-plugins.sh

※ 必要じゃない

  • node_modules ディレクトリを作り直したい時に使う
  • プラグインをメモっておくのに使う
  • yarnの使い方を忘れた時に使う
#!/bin/bash
yarn global upgrade npm@latest
# yarn global upgrade
yarn
yarn init --yes
yarn add honkit
## npx honkit init
## npx honkit build
## npx honkit serve
## yarn add 

# npm install -g @mermaid-js/mermaid-cli

disableds=(
gitbook-plugin-advanced-emoji
gitbook-plugin-anchors@https://github.com/chick-p/honkit-plugin-anchors.git
gitbook-plugin-auto-summary
gitbook-plugin-back-to-top-button
gitbook-plugin-copy-code-button
gitbook-plugin-changelog
gitbook-plugin-comments-footer
gitbook-plugin-custom-js-css
gitbook-plugin-edit-link
gitbook-plugin-git-author
gitbook-plugin-graph
gitbook-plugin-include
gitbook-plugin-include-codeblock
gitbook-plugin-insert-logo
gitbook-plugin-intopic-toc
gitbook-plugin-lb2br@https://github.com/uniquejava/gitbook-plugin-lb2br.git
gitbook-plugin-mathjax-pro@https://github.com/kevinkangkang/gitbook-plugin-mathjax-pro.git
gitbook-plugin-recently-updated
gitbook-plugin-simple-mind-map
gitbook-plugin-splitter
gitbook-summary
honkit-plugin-image-captions
honkit-plugin-katex
honkit-plugin-mermaid
gitbook-plugin-mermaid-gb3
mathjax@2
mkdirp
svgexport
mermaid
@mermaid-js/mermaid-cli
csv-parse
gitbook-plugin-summary
gitbook-plugin-isummary
gitbook-plugin-custom-js-css
gitbook-plugin-mermaid-2
gitbook-plugin-chapter-fold
gitbook-plugin-anchors@https://github.com/chick-p/honkit-plugin-anchors.git
)

items=(
@ansanloms/honkit-plugin-uml
gitbook-plugin-ace
gitbook-plugin-alerts
gitbook-plugin-anchor-navigation-ex
gitbook-plugin-auto-scroll-table@git+https://github.com/ideamean/gitbook-plugin-auto-scroll-table.git
gitbook-plugin-auto-summary
gitbook-plugin-code
gitbook-plugin-codeblock-filename
gitbook-plugin-collapsible-chapters
gitbook-plugin-custom-js-css
gitbook-plugin-expandable-chapters
gitbook-plugin-expandable-chapters-small
gitbook-plugin-hide-published-with
gitbook-plugin-hints
gitbook-plugin-include-codeblock
gitbook-plugin-japanese-support
gitbook-plugin-katex-pro
gitbook-plugin-lb2br
gitbook-plugin-mermaid-newface
gitbook-plugin-puml
gitbook-plugin-search-pro-fixed
gitbook-plugin-splitter
gitbook-plugin-tags
gitbook-plugin-theme-code
gitbook-plugin-todo
honkit-plugin-image-captions
)

for item in "${items[@]}" ; do
  yarn add ${item}
done

~/docker/honkit/_bin/pdfmaker.sh

*** PDF書き出し用にクリーンなディレクトリを構築するシェルスクリプト

#!/bin/bash

## Honkit でつくられたドキュメント群を PDF で書き出すメモ Posted on 2021年11月24日 by seigo
## https://www.1ft-seabass.jp/memo/2021/11/24/honkit-all-docs-convert-pdf-knowledge/

function MyEcho()
{
    echo "[`date '+%Y/%m/%d %T'`] $1"
}

### 全ドキュメントを1ページにまとめて Honkit で書き出して PDF 印刷してしまおう
## はい。できるだけシンプルに出来ないかなということで、こういう着地になりました。
## 
##   * 全ドキュメントを目次ページである SUMMARY.md から結合する Markdown ファイル群を取得
##   * 全ドキュメントを1ページにまとめて Honkit で書き出し
##   * その1ページを PDF 印刷
## でやってみます。

MyEcho "*** start ***"

rm -rf /pdfmaker
mkdir -p /pdfmaker
## *** 超重要 ***
## *** 以降、カレントディレクトリ前提なのでうっかり上書き超怖い！！
cd /pdfmaker

MyEcho "mess - yarn --初期化-- ベース作成"
yarn init -y

MyEcho "mess - honbook --初期化-- ベース作成"
echo y | npx honkit init

# ### SUMMARY.md
# MyEcho "mess - make SUMMARY.md"
# cat << 'EOT' >> /pdfmaker/SUMMARY.md
# # Summary
#  
# - [README](README.md)
# EOT

MyEcho "mess - copy markown documents"
mkdir -p /pdfmaker/book
mkdir -p /pdfmaker/pdf
# copy directory all. recursive force update
cp -Rfu /honkit/book/* /pdfmaker/book
# cp /honkit/README.md /pdfmaker/book
# cp /honkit/SUMMARY.md /pdfmaker/book
# sed -i".stok" 's@(book/@(./@g' /pdfmaker/book/SUMMARY.md

cp /honkit/README.md /pdfmaker/
cp /honkit/SUMMARY.md /pdfmaker/

## ## ### 元ネタの SUMMARY.md から全ドキュメントを 1 ページにまとめる Node.js のコード
## ## cat << 'EOT' >> /pdfmaker/app.js
## ## const fs = require('fs').promises;
## ## const path = require('path');
## ## 
## ## async function main (){
## ## 
## ##   // SUMMARY.md から結合する Markdown ファイル群を取得
## ##   const filepath = path.resolve(__dirname , './book/SUMMARY.md');
## ##   const message = await fs.readFile(filepath, {encoding: 'utf-8'});
## ##   // Markdown のリンク記法の配列で入ってくる
## ##   let resultMarkdownLinkList = message.match(/\[(.*)\]\((.*)\)/gm);
## ##   console.log(resultMarkdownLinkList);
## ## 
## ##   // 大量に取得してしまうと確認がしにくいので、いったん取得後に数件に限定する処理
## ##   // チューニング用
## ##   /*
## ##   resultMarkdownLinkList = [
## ##     resultMarkdownLinkList[0],
## ##     resultMarkdownLinkList[1],
## ##     resultMarkdownLinkList[2]
## ##   ]
## ##   */
## ## 
## ##   // ファイルを結合して README.md 1ファイルに集約
## ##   let targetContent = "";
## ##   let targetContentAll = "";
## ##   for(let i = 0; i < resultMarkdownLinkList.length; i++){
## ##     const targetMatchResult = resultMarkdownLinkList[i];
## ## 
## ##     // Markdown のリンク記法からリンクタイトルとファイルパスを抽出
## ##     const regexp = /\[(.*)\]\((.*)\)/gm;
## ##     const match = regexp.exec(targetMatchResult);
## ##     // console.log(match[1],match[2]);
## ##     const targetSummaryTitle = match[1];
## ##     const targetResolveFilepath = match[2];
## ## 
## ##     // 相対パス化
## ##     const targetFilepath = path.resolve(__dirname , './book/' , targetResolveFilepath);
## ## 
## ##     // 非同期でコンテンツ読み込み
## ##     targetContent = await fs.readFile(targetFilepath, {encoding: 'utf-8'});
## ##     console.log('----');
## ##     console.log(targetContent.substr(0,100));
## ## 
## ##     // コンテンツ連結
## ##     targetContentAll += targetContent;
## ##   }
## ## 
## ##   console.log('----');
## ##   console.log('コンテンツ書き込み');
## ##   console.log('----');
## ## 
## ##   // pdf というフォルダに格納する
## ##   // この pdf フォルダを honkit で書き出し
## ##   const filepathMainContent = path.resolve(__dirname , './pdf/' , 'README.md');
## ## 
## ##   // コンテンツ書き込み
## ##   await fs.writeFile(filepathMainContent,targetContentAll);
## ## }
## ## 
## ## main();
## ## EOT

### website.css の調整
MyEcho "mess - make styles/website.css"
mkdir -p /pdfmaker/styles
cat << 'EOT' >> /pdfmaker/styles/website.css
/* 印刷用 */
@media print {
  @page {
    size: 190mm 277mm;
    margin: 0;
  }
 
  body{
    /*A4縦 210mm x 297mm*/
    width: 186mm;
    height: 270mm;
  }
 
  .page-inner {
    width: 100% !important;
  }
}
EOT

### pdf.css の調整
MyEcho "mess - make styles/pdf.css"
mkdir -p /pdfmaker/styles
cat << 'EOT' >> /pdfmaker/styles/pdf.css
EOT


### book.json の調整
MyEcho "mess - make book.json"
cat << 'EOT' >> /pdfmaker/book.json
{
  "title": "あああいいいううう",
  "description": "2021 授業資料",
  "language": "ja",
  "plugins": [
    "-lunr", "-search",
    "-summary",
    "@ansanloms/uml",
    "alerts",
    "anchors@https://github.com/chick-p/honkit-plugin-anchors.git",
    "auto-scroll-table",
    "code",
    "codeblock-filename",
    "hide-published-with",
    "highlight",
    "hints",
    "image-captions",
    "include-codeblock",
    "intopic-toc",
    "japanese-support",
    "lb2br",
    "mermaid-gb3",
    "puml",
    "tags",
    "theme-code",
    "todo"
  ],
  "pluginsConfig": {
    "custom-js-css": {
      "js": [
        "styles/my.js"
      ],
      "css": [
        "styles/github-css.css",
        "styles/my.css"
      ]
    },
    "uml": {
      "format": "svg",
      "charset": "utf8",
      "config": "classic"
    }
  },
  "pdf":{
    "pageNumbers":true,
    "fontFamily":"Arial",
    "fontSize":12,
    "paperSize":"a4",
    "margin":{
      "right":62,
      "left":62,
      "top":56,
      "bottom":56
    }
  },
  "styles": {
    "website": "styles/website.css",
    "ebook": "styles/ebook.css",
    "pdf": "styles/pdf.css",
    "mobi": "styles/mobi.css",
    "epub": "styles/epub.css"
  }
}
EOT

### プラグイン導入
MyEcho "mess - honbook --プラグイン導入-- コマンド発呼"
plugins=(
honkit
@ansanloms/honkit-plugin-uml
gitbook-plugin-ace
gitbook-plugin-alerts
gitbook-plugin-anchors@https://github.com/chick-p/honkit-plugin-anchors.git
gitbook-plugin-auto-scroll-table@git+https://github.com/ideamean/gitbook-plugin-auto-scroll-table.git
gitbook-plugin-code
gitbook-plugin-codeblock-filename
gitbook-plugin-hide-published-with
gitbook-plugin-hints
honkit-plugin-image-captions


gitbook-plugin-include-codeblock
gitbook-plugin-intopic-toc
gitbook-plugin-japanese-support
gitbook-plugin-lb2br
gitbook-plugin-mermaid-gb3
gitbook-plugin-puml
gitbook-plugin-tags
gitbook-plugin-theme-code
gitbook-plugin-todo
)
for PLG in "${plugins[@]}" ; do
  MyEcho "mess - honbook Plugins -- yarn add ${PLG}"
  yarn add ${PLG}
done

## head --lines=-1 /pdfmaker/package.json > /pdfmaker/aaa.json
## cat << 'EOT' >> /pdfmaker/aaa.json
##   ,
##   "scripts": {
##     "serve-pdf": "export QTWEBENGINE_CHROMIUM_FLAGS="--no-sandbox" && npx honkit pdf src-pdf",
##     "serve": "honkit serve base src",
##     "build": "honkit build base docs"
##   }
## }
## EOT
## 
## cat /pdfmaker/aaa.json > /pdfmaker/package.json


MyEcho "*** end ***"
MyEcho 'ディレクトリ移動(cd)してPDF作成を続行してください'
MyEcho 'cd /pdfmaker'
MyEcho 'npx honkit pdf'
exit 0

~/docker/honkit/_bin/plantuml.sh

#!/bin/sh
exec /usr/bin/java -Dswing.defaultlaf=com.sun.java.swing.plaf.gtk.GTKLookAndFeel -jar '/usr/share/java/plantuml.jar' "$@"

起動

ビルドコマンド → 起動コマンド

ビルドコマンド

export CNAME=ohonkit && docker buildx build ./ -t ${CNAME}

起動コマンド

$ docker run -it -p 4000:4000 -p 35729:35729 -v "$PWD:/honkit" -w "/honkit" ${CNAME} bash
# ここから起動したdockerイメージ内部でのコマンド
$ ./add-plugins.sh
$ yarn install
$ npx honkit serve

npxコマンドを付けないで honkit を使うと、結果が違うので注意する

使う

ホストPCでブラウザからアクセスする

  • 再起動はhonkitを再起動する npx honkit serve
  • マークダウンファイル(xxxx.md)を追加・削除した時はhonkitを再起動する
  • 目次の自動生成は２回の再起動が必要
  • コード表示のシンタックスハイライトは無効にする。有効にするとエラーが手に負えない
0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?