GROWIがシンタックスハイライトに対応している言語は以下のページのcommonリスト内のもの。
このページで分かること
対応言語を追加するには,下記サイトから必要なjsのURLをコピーし、
カスタムHTML Headerに追加する。
<!--Dockerfile Highlight-->
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.15.10/languages/dockerfile.min.js" defer></script>
# go to growi-docker-compose workdir
cd growi
# stop
docker-compose stop
# remove current container and images
docker-compose rm app
docker rmi weseek/growi:4
# rebuild app container image
git pull
docker-compose build
# start
docker-compose up
今回はSynology Docker上での作業なので"git pull"が利かない。
# go to growi-docker-compose workdir
cd growi
# stop
docker-compose stop
# remove current container and images
docker-compose rm app
docker rmi weseek/growi:4 #3系からのアップグレードなのでエラーが出る。
ここでdockerfileを編集
FROM weseek/growi:4 #FROM weseek/growi:3 を変更して保存
LABEL maintainer Yuki Takei <yuki@weseek.co.jp>
ENV APP_DIR /opt/growi
# rebuild app container image
git pull
docker-compose build
# start
docker-compose up
以上でちょっと不安ではあったがアップデートできた。
つまずき・注意
docker rmi weseek/growi:4 のところでエラーが出るのは、3系のイメージを使っていて 4 のタグが残っていないためだ。本文のとおり Dockerfile の FROM を weseek/growi:4 に書き換えてから build し直す流れになる。git pull が利かないので、docker-compose 一式(docker-compose.yml と Dockerfile)を手動で最新化してから build する。バージョンアップのたびに同じ確認が要る。docker-compose logs app でコンテナのログを見る。DB(MongoDB など)のバージョンやデータの整合が原因になっていることが多い。Q. ハイライトを追加したのに色が付かない。
A. カスタム HTML Header に script タグを入れても、ブラウザのキャッシュやページの再生成で反映が遅れることがある。キャッシュを消して再読込し、管理画面でヘッダーの保存を確認する。
Q. Docker でなく npm 運用でも同じ方法が使えるか。
A. カスタム HTML Header は GROWI 共通の機能なので設定方法は同じ。このページのアップデート手順は docker-compose 運用向けで、npm 運用には当てはまらない。
Q. 更新後に記事やユーザーが消えた。
A. コンテナ削除の際に DB のデータが残っているか確認する。docker-compose の volumes で MongoDB 等を永続化していない構成だと、rm と同時にデータも消える。更新前のバックアップは必ず取っておく。
🤖 このページにはAIエージェント(ノア)による編集・加筆が含まれます。内容の正確性は保証できないため、重要な判断は一次情報でご確認ください。