aboutsummaryrefslogtreecommitdiff
path: root/posts/redesign-www-tojo-tokyo.md
diff options
context:
space:
mode:
authorMasaya Tojo <masaya@tojo.tokyo>2021-03-26 23:18:20 +0900
committerMasaya Tojo <masaya@tojo.tokyo>2021-03-26 23:32:17 +0900
commit72f49c071d817ecfd9273d8227596981787bec63 (patch)
tree7f4720e183479b501e3c6048ce6d6c4f773671f2 /posts/redesign-www-tojo-tokyo.md
parent54ccdb558f4d23861ee5f8fb3feffb6bbd6d246f (diff)
org-mode から commonmark へ移行する
pandoc への依存をなくすため、org-mode ではなく commonmark を使用するよ うに修正する。プロセス間通信で利用している pandoc は GPLv2 でライセン スされていて、本プログラムは GPLv3 であり GPLv2 と GPLv3 には互換性が ないためにライセンス違反を起こしている可能性がある。 プロセス間通信でしか使用していないため、 pandoc が本ソフトウェアの一部 と見做されるかどうかは微妙なところだが、念のため対応する。 pandoc は org-mode で記事を書く場合にしか使用していないため、org-mode から commonmark へ移行することで対応できる。
Diffstat (limited to 'posts/redesign-www-tojo-tokyo.md')
-rw-r--r--posts/redesign-www-tojo-tokyo.md54
1 files changed, 54 insertions, 0 deletions
diff --git a/posts/redesign-www-tojo-tokyo.md b/posts/redesign-www-tojo-tokyo.md
new file mode 100644
index 0000000..8f7e571
--- /dev/null
+++ b/posts/redesign-www-tojo-tokyo.md
@@ -0,0 +1,54 @@
+title: ウェブサイトの見た目を改善しました
+id: redesign-www-tojo-tokyo
+date: 2020-05-08 06:45
+updated: 2020-05-08 12:51
+description: ダークテーマよりも普通の方がよかった
+---
+
+## ダークテーマよりも普通の方がよかった
+
+いままでこのウェブサイトはダークテーマを意識していて、黒い背景に白い文字を使用していました。 しかし、この Web で記事を閲覧するよりも
+GitLab で直接元の `org-mode` の文書を読んだ方が視認性が良いことにショックを受け、
+根本的に見た目を改善する必要があることに気づきました。
+
+ダークテーマはターミナルや Emacs で文書を書いているときには良いのですが、Web ではあまり良くないようです。 視認性の良い Web
+ページをダークテーマで作成するのは難しいと思います。
+
+基本的に配色のこだわりを捨てて Web ブラウザのデフォルトに任せることにしました。
+すると、悲しいことにその方がずっと見やすくてより良いものになりました……。
+
+## 文字を大きくしました
+
+このサイトの文字のサイズは小さすぎました。 全体的に文字が小さくて自分で記事を読み返すたびに、 「この Web
+サイトの作者はどうしてこの文字サイズでよいと思ったんだろう」と疑問に思ったほどです。
+
+なので、デフォルトでは少し大きめにしました。 かなり読みやすくなったと思います。
+
+## コードが読みやすくなりました
+
+コードの装飾をちょっと良くしました。 ソースコードが良い感じに表示されるようになっています。 例として階乗の定義を示します。
+
+``` scheme
+(define (factorial n)
+ (if (zero? n)
+ 1
+ (* n (factorial (- n 1)))))
+```
+
+また、文中のコードの表示も改善しました。 「 `(factorial 10)` の値は `3628800`
+です」というように良い感じにコードがハイライトされるようになりました。
+
+## 感想
+
+だいぶ見た目が良くなったと思います。
+このウェブサイトは[バージョン管理](https://gitlab.com/tojoqk/www-tojo-tokyo)されているので、
+暇な人は過去のコミットに戻ってサイトをビルドしてみると良いと思います。
+
+Guix を使用していれば、ビルド環境の構築をしなくても下記のコマンドで一瞬です。
+
+``` shell
+guix environment -l environment.scm -- make serve
+```
+
+特に環境を準備していなくてもこのコマンドだけで `8080` ポートを待ち受けるサーバーを起動することができます。 やはり Guix
+は最高ですね。