note.nkmk.me

FAQ

問い合わせフォームTwitterに何度か寄せられた質問への回答です。

以下は2018年11月3日時点での回答であり、今後方針が変わる可能性もあります。

なぜ目次がページ内リンクになっていないのか

コードを抜き出して説明を書くという当サイトの構成上、途中から読んだ場合は先に定義した変数などがコード中にいきなり登場することになります。

以前試験的にリンク付きの目次を入れてみたところ、最初の方を読んでないと思われる方・コードの一部だけをコピペして動かないと困っている方からの問い合わせが急増したため、「途中から読んでもOK」という誤解を与えかねないリンク付き目次の導入は見送りました。

試験期間中の目次リンクのクリック率が2%弱と、そこまで利用されていなかったのも導入を見送った理由の一つです。

なお、このページやまとめページのようなどこから読んでも問題ないページの目次はページ内リンクになっています。

どうしてもリンク付き目次が欲しいという方には、見出しタグなどを元にアウトラインを生成するHTML5 Outlinerというプロジェクトが便利です。Chromeの拡張機能のほかブックマークレットも用意されています。

  • h5o - HTML5 Outliner
    • ブックマークレットはDrag this to your favorites:の下のリンクをブックマークバーなどにドラッグアンドドロップして利用

ページ内の任意の場所に飛びたい場合はブラウザのページ内検索(cmd + f または ctrl + f)も活用してみてください。

このサイトはどうやって作っているのか

当サイトは自作の静的サイトジェネレーター(Python製)で作成、Amazon S3 + CloudFrontで配信しています。

「WordPressのテーマ / プラグインを教えてほしい」という問い合わせもいただきましたが、WordPressではないです。

もろもろの理由は以下の通り。

  • WordPressではなく静的サイトジェネレーターを使っている理由
    • 静的サイトにすると、面倒な問題(セキュリティや高速化など)を考えなくて済むから
  • 既存の静的サイトジェネレーターを使わずに自作した理由
    • シンプルなサイトを作るには既存のものは多機能・複雑過ぎるから
    • 自分の使いやすいようにカスタマイズしようとした場合、既存のものを修正するよりも1から作ったほうが早そうだったから

サイト名(ドメイン名)のnkmkの由来は

深い意味はありません。「本名が中牧(nakamaki)」というわけでも「肉巻き(nikumaki)おにぎりが大好き」というわけでもありません。

キーボードでリズミカルに打てる、という理由だけで適当に決めたGitHubアカウントの名残です。