md2docs

お気に入り

更新

ブラウザだけで完結する、よく見るページのブックマーク機能。

頻繁に参照するページを手元に残しておけるよう、★ アイコンでブックマークできるお気に入り機能を備えています。サーバサイドの保存処理は無く、すべて ブラウザの localStorage に閉じています。

使い方

お気に入りに追加する

記事ページのタイトル右側にある ☆ アイコンをクリックします。クリックすると ★ に変わり、その時点でブラウザのローカルストレージに保存されます。

一覧を見る

右サイドバー（画面幅 1024px 以上で表示）の下部に「お気に入り」リストが現れます。

お気に入り
  ★ 記事タイトル A
  ★ 記事タイトル B
  ...

タイトルをクリックすればその記事に直接ジャンプできます。

お気に入りから外す

外し方は 2 通りあります。

  1. 詳細ページの ★ をクリック → ☆ に戻り、リストからも消えます
  2. 右サイドバーの ★ をクリック → ☆ に変わりますが、そのページ滞在中はリストに残ります

ヒント

2 番の挙動は、誤操作で外してしまった時にもう一度クリックして元に戻せるよう、その場では消さない仕様です。次のページに移動した時点でリストから完全に消えます。

データの保存場所

お気に入り情報はブラウザの localStorage に JSON として保存されます。

// localStorage のキー: md2docs.favorites
[
  { "url": "/getting-started/installation.html", "title": "インストール",      "addedAt": 1745539200000 },
  { "url": "/guide/callouts.html",                "title": "Callout の使い方", "addedAt": 1745539201000 }
]

開発者ツール（DevTools → Application → Local Storage）で中身を確認できます。

重要

サーバには一切送信されません。ブラウザを変えると別のリストになる、プライベートウィンドウでは保存されない、ブラウザ履歴を削除するとお気に入りも消える ことに注意してください。

バックアップとエクスポート

定期的にバックアップを取りたい場合は、DevTools のコンソールで取り出せます。

// 現在のお気に入りを JSON としてコピー
copy(localStorage.getItem('md2docs.favorites'));

別のブラウザに移行したい時は、コピーした JSON を移行先で代入してください。

// 移行先のブラウザで貼り付け
localStorage.setItem('md2docs.favorites', '<貼り付け>');
location.reload();

機能を無効にする

お気に入り機能を使わない場合は、テンプレートから外せます。

  • 詳細ページの ★ ボタン — themes/docs/entry.html.twig の .favorite-toggle ブロック
  • 右サイドバーの一覧 — themes/docs/layout.html.twig の {% include "modules/favorites.html.twig" %}
  • JS — themes/docs/layout.html.twig の <script src="/assets/docs/js/favorites.js">

3 箇所をコメントアウト or 削除すれば機能は完全に無効化されます。

次のページ

全文検索 →