Growiの構築方法（Dockerでオンプレミス）
はてなブログとMarkdownと数式 - 63rabbitsのめも・めも・めも で頑張ったが数式の表示がうまく行かず手戻りが多すぎたので Growi に浮気してみた。
Mac Book Air 2018 (macOS Catalina 10.15.6)に Growi を構築した記録をメモっとく。
ダウンロード
Docker Desktop
https://www.docker.com/products/docker-desktop
ホスト環境に合わせて何れかを選択。
Growi
growi-docker-compose … code > download zip
構築手順
１．Docker Desktop をインストール。
２．growi-docker-compose.zip を解凍。
３．ターミナルを開き、解凍後のフォルダ内（docker-compose.yml の在る場所）に移動。
４．docker-compose.yml をつぎのように修正。（ここはお好みで設定）
:
:
# - FILE_UPLOAD=mongodb
- FILE_UPLOAD=local
- MATHJAX=1
# - PLANTUML_URI=http://
# - HACKMD_URI=http://
# - HACKMD_URI_FOR_SERVER=http://hackmd:3000
# - FORCE_WIKI_MODE='public'
- FORCE_WIKI_MODE='private'
:
:
設定ファイル : docker-compose.yml
| 変数 | 値 | 意味 |
|---|---|---|
| FILE_UPLOAD | local | 添付ファイルをコンテナ内の下記に保存する。 /data/uploads/attachment |
| MATHJAX | 1 | 数式記述（Mathjax）を有効にする。 |
| FORCE_WIKI_MODE | private | Wikiを公開しない。（プライベート・モード） |
【注意】FILE_UPLOAD で「コンテナ内の…」と書いたが、/data は永続化のためにコンテナの外のボリュームをマウントしている。 ところで Docker Deskop for Mac では Docker Engine をVMで動かしている。/data の実体はこのVMの中にある。
[Docker for Mac] Docker Volumeの実態がどこにあるのか、探してみた｜w0o0ps｜note
５．下記コマンドを実行する。
docker-compose up
６．ブラウザからGrowi（http://localhost:3000）にアクセスしユーザ兼管理者を登録する。
７．Wiki管理 > アプリ設定 > サイトURL設定 で Ddatabase 欄にhttp://localhost:3000を設定する。
以上で構築は終わり。
その後、コンテナの起動／停止はDocker Desktop の Dashboard で行うことができる。
あとがき
Dockerを初めて使った。Vmwareなどの仮想化と比べると驚くほど軽いことにびっくり。
はてなブログとMarkdownと数式
旧から新Google Sites へ移行したけど使いにくい。
下記を主眼に新しいサイトを探したところ「はてなブログ」に行き着いた。
数式の前後に若干のコードが必要だが満足できる結果が得られたので使い方をメモっとく！
- Markdownで書ける。
で数式を書ける。
- Typoraで書いて貼り付けられたらベスト。
1.Markdownを使うには
はてなブログの 設定 を開き編集モードをMarkdownモードにする。
（このページはMarkdownで書いている。）
2.数式を使うには
1.はてなブログのデザイン>カスタマイズ>ヘッダを開く。
2.つぎのHTMLを貼り付ける。
<!-- Mathjaxを使うための設定 -->
<script type="text/x-mathjax-config">
MathJax.Hub.Config({
tex2jax: {
inlineMath: [['$','$'], ['\\(','\\)']],
displayMath: [ ['$$','$$'], ["\\[","\\]"] ]
}
});
</script>
<script type="text/javascript" async
src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js?config=TeX-MML-AM_CHTML">
</script>
<!-- Mathjaxを使うための設定 -->
3.「変更を保存する」を押す。
3.Markdownモードでの数式の書き方
インライン数式
計算式は$f(x)=x^{2}$である。
計算式は$f(x)=x^{2}$である。
ブロック数式
計算式は$$f(x)=x^{2}$$である。
計算式は$$f(x)=x^{2}$$である。
または
計算式は、 <pre> [tex: f(x)=x^2 ] </pre> である。
計算式は、
である。
4.テーマ
数式を強調しすぎないので、個人的には「Block Memo」が好き！
Epic, Wideboardも良さげ。
5.問題点
数式ブロックが変換されない。
2020-11-21 問題発生
<pre>[tex: 数式 ]</pre> の後方にコードブロック( ` x３個で挟む)を記述すると数式に変換されない。なんで？
回避策
原因は不明だが、下記の記述法で問題を回避できる。
<p align="center">[tex: 数式 ]</p>
全体的に数式が変換されない場合がある。
解決策
最初の数式だけつぎの形式で書くと全体が変換される。
[tex: 数式 ]
べき乗が正しく表示されない。
解決策 べき乗を波括弧で括る。
x^2 -> x^{2}
-を含む式が正しく表示されない。
解決策 -の前後に半角空白を入れる。
L-1 -> L - 1
