kristall

src/index.html

@@ -122,6 +122,8 @@
 	<dd>2024-01-18 (陰暦12月08日)</dd>
 <dt><a href="./aboutconfig.html">「about:config」の設定項目</a></dt>
 	<dd>2024-01-21 (陰暦12月11日)</dd>
+<dt><a href="./kristall.html">Kristallの紹介</a></dt>
+	<dd>2024-03-17 (陰暦02月08日)</dd>
 </dl>
 
 <h3>2.3. 電子計算機 <a name="COMP" href="#COMP">#COMP</a></h3>

src/kristall.html

@@ -0,0 +1,125 @@
+<title>Kristallの紹介 - 美々蝶々</title>
+
+<h1>Kristallの紹介</h1>
+
+<ul>
+	<li>2024-03-17 (陰暦02月08日) たかし</li>
+	<li>「OpenBSD 7.4」「kristall-2021111500p1」</li>
+</ul>
+
+<h2>1. 概要</h2>
+
+<p><a href="https://kristall.random-projects.net/">Kristall</a> は獨自の描畫エンジンを持つウェブブラウザーです。Qt で作成されてゐます。</p>
+
+<ul>
+	<li><a href="./images/kristall.png">Kristall の畫面寫眞</a></li>
+</ul>
+
+<p>Kristall は Gemini 用のブラウザーでもありますが、ここでは HTTP (S) の利用に限定して説明します。</p>
+
+<ul>
+	<li>HTML の他、Gemini や Markdown を描畫可能</li>
+	<li>CSS に非對應だが、文書のスタイルを設定で變更できる (書體・配色・餘白など)</li>
+	<li>見出しをツリー表示できる (ジャンプもできる)</li>
+	<li>畫像には非對應 (<strong>ALT 屬性すら表示されない</strong>)</li>
+	<li><strong>INPUT などのフォーム關聯の要素に非對應</strong></li>
+	<li><strong>Cookie に非對應</strong></li>
+</ul>
+
+<h2>2. 起動</h2>
+
+<p>CLI から Kristall を起動するには單に「<kbd>kristall <var>URL</var></kbd>」の樣に起動します。すでに Kristall を起動中なら新しいタブが開きます。</p>
+
+<h2>3. 設定</h2>
+
+<h3>3.1. HTTP (S) を有效化</h3>
+
+<p>Kristall を HTTP (S) に接續可能にします。</p>
+
+<ol>
+	<li>「File」 → 「Settings」を開く (<kbd>Ctrl + ,</kbd>)</li>
+	<li>「Generic」 → 「Enabled Protocols」の「HTTP」「HTTPS」にチェックを入れる</li>
+</ol>
+
+<p>ウェブサイトを開くときは、URL bar に「http://」または「https://」で始まる URL を入力し、<kbd>Enter</kbd> します。<strong>プロトコルを省略すると自動で「gemini://」になります。</strong></p>
+
+<h3>3.2. 書體を設定</h3>
+
+<p>筆者の環境では一部の文字 (數時) が表示されませんでした。書體を變更することで問題が解消しました。</p>
+
+<ol>
+	<li>「Settings」 → 「Style」を選擇</li>
+	<li>次の項目に適當な書體を設定
+		<ul>
+		<li>Standard Font</li>
+		<li>Preformatted Font</li>
+		<li>H1 Font</li>
+		<li>H2 Font</li>
+		<li>H3 Font</li>
+		<li>Blockquote Font</li>
+		</ul>
+	</li>
+</ol>
+
+<h3>3.3. タイムアウトを長くする</h3>
+
+<p>初期設定では 5000 ミリ秒でタイムアウトします。ネットワークが低速な場合 (特に I2P や Tor)、頻繁にタイムアウトしてしまひます。30000 ミリ秒 (30 秒) 程にしておくと安心です。</p>
+
+<ol>
+	<li>「Settings」 → 「General」を選擇</li>
+	<li>「Network timeout」を「<kbd>300000</kbd>」に設定</li>
+</ol>
+
+<h3>3.4. 見出しをツリー表示する</h3>
+
+<p>「View」 → 「Document outline (<kbd>Ctrl + m</kbd>)」 にチェックを入れるとウィンドウの左側に見出しがツリー表示されます。ツリーの項目 (見出し) をクリックすると、その見出しの場處までスクロールします。</p>
+
+<h3>3.5. その他の便利な設定</h3>
+
+<p>すべて「Settings」から設定します。</p>
+
+<dl>
+<dt>起動時に前囘の表示内容を復元しない</dt>
+	<dd>「General」 → 「Startup Behaviour」から「Start Page」を選擇</dd>
+<dt>ウェブ檢索エンジンをDuckDuckGoにする</dt>
+	<dd>「General」 → 「Search engine」に「<kbd>https://lite.duckduckgo.com/lite/?q=%1</kbd>」と入力</dd>
+<dt>ドメインごとにランダムに配色を變更する</dt>
+	<dd>「Style」 → 「Auto-Theme Generation」 → 「Light Theme」または「Dark Theme」を選擇</dd>
+</dl>
+
+<h2>4. I2P・Torに接續</h2>
+
+<ul>
+	<li>タイムアウトする場合、前述の手順でタイムアウト時間を調節する</li>
+</ul>
+
+<p>I2P に接續するには、環境變數 <var>http_proxy</var> にホスト名・ポート番號を指定します。</p>
+
+<ul>
+	<li><samp>$ <kbd>http_proxy=http://127.0.0.1:4444 kristall</kbd></samp></li>
+</ul>
+
+<p>Tor に接續するには torsocks を使用します。</p>
+
+<ul>
+	<li><samp>$ <kbd>torsocks kristall</kbd></samp></li>
+</ul>
+
+<h2>5. 細かい注意點</h2>
+
+<ul>
+	<li>「Settings」のウィンドウが割と大きく、PC の畫面が小さい場合は収まらない</li>
+	<li>URLの末尾に「#foobar」とつけても、ID 屬性・NAME 屬性の場處にジャンプできない</li>
+	<li>H4 要素は單なる太字、H5 要素は小さい太字で表示される</li>
+	<li>H6 要素は通常のテキストとして表示される</li>
+</ul>
+
+<h2>6. 餘談</h2>
+
+<p>Kristall は HTML の「見た目と構造を分離する」といふ考へを上手く表してゐます。</p>
+
+<p>Kristall が文書を表示するとき、ウェブサイトの管理者が指定したスタイルではなく、利用者が自分で設定したスタイルを使用します。</p>
+
+<p>それと、Kristall は H1 から H6 の見出しを元に文書の構造をツリーで表示することができます。これは見出しレベルといふ考へを理解するのに役立つはずです。</p>
+
+<p>自分や他人のウェブサイトを Kristall で表示してみることは、HTML の書き方を考へるよいきつかけになります。</p>