Hugoサイトの目次(TOC)制御:PaperModテーマでの設定方法

TOCはどうやって表示できるようにするのが良いのだろうか? Hugoでブログに目次(Table of Contents, TOC)は重要です。TOCがあることで記事の読みやすさを向上できるからです。 でも、このときに疑問があります。 このTOCの制御する方法とは? また複数の選択肢があった場合にどこでやるのが良いのだろうか? こういう事を考えてみたいと思います。 TOCの制御方法はPaperModの機能で実現するのが良い。 この記事の結論としてはPaperModの機能で実現するのが良いとしました。 config/_default/hugo.toml に以下の設定を加える方法です。 [params] UseHugoToc = true showtoc = true なぜこのような設定にしたのでしょうか? その結論を得るための前提の方法の洗い出し、各選択肢の比較と最終的にPaperModの機能で良いとした理由を記述します。 HugoのブログのTOC表示の選択肢は3つある。 Hugoのブログでは3つの選択肢があります。 Hugo自身の設定 Hugoテーマ(本サイトではPaperMod)の機能 コンテンツ変換ツールでTOCをMarkdownに挿入する 私の場合、 ox-hugo でEmacs Org modeからMarkdownへ変換しています。 色々ありますね。 ox-hugoでのTOC生成を試し、却下した 当初、私は ox-hugo の機能を使ってTOCを生成しようと考えました。 Orgファイルのプロパティとして以下の設定を加える方法です。 #+TOC: headlines 3 しかし、この方法にはいくつかの課題がありました。 課題点 生成されるMarkdownファイルに、TOCがHTMLの = <div class“ox-hugo-toc”>…</div> == のように直接書き込まれてしまう。 これにより、Markdownファイルが冗長になる。 Hugoやテーマ側での動的なTOC制御(サイドバーでの追従表示など)が効かなくなる。 Hugoの強みは、コンテンツ(Markdown)とプレゼンテーション(テーマ)を分離できる点にあります。 コンテンツファイルに直接HTMLを埋め込むこの方法は、その思想とは少しずれていると感じました。 また、この試行錯誤をしたときにはHugo自体にTOCを生成する機能があるとは知りませんでした。 最終的な解決策:HugoとPaperModのTOC機能を利用する そこで、TOCの生成と表示はHugoとテーマ側に一任する方針に切り替えました。 本サイトで利用しているPaperModテーマには、TOCを制御する機能があります。 設定は config/_default/hugo.toml ファイルで行います。 [params] UseHugoToc = true showtoc = true UseHugoToc = true : Hugoの組み込みTOC生成機能を使用することをPaperModに伝えます。 showtoc = true : 記事ページでTOCを表示します。 この設定により、各記事のMarkdownファイルに特別な記述が不要になります。 また、Hugoが自動で見出しを解析してTOCを生成し、PaperModがそれを適切な場所に表示してくれます。 ...

August 17, 2025 · 1 min · moai

LLMを活用した求人検索ガイド

ステップの概要 探索ステップ Deep Researchに利用するプロンプトを作成します。 上記のプロンプトを使ってLLMにDeep Researchさせます。 深堀りステップ プロンプト例 改善案と追加のヒント ステップの概要 探索: AIに自身の興味・関心事を伝え、それに基づいた求人検索用のプロンプトを作成させる。そのプロンプトを使い、世の中の求人候補を広くリストアップする。 深掘り: 気になる企業を個別に調査する。LLMに事業の成長性、福利厚生、業務委託の有無などを質問し、理解を深めてから応募する。 探索ステップ Deep Researchに利用するプロンプトを作成します。 まずはプロンプト自体をLLMに作成させます。 プロンプト作成のプロンプトは以下です。 プロンプト作成依頼文 私の興味のある業種で求人を検索したいです。Deep Resarchで検索するうえで利用可能なプロンプトを作成してくれますか? 出力されたプロンプト具体例 この具体例を使って、Deep Researchを実行します。 私の興味に合致した企業・組織・事業をリストアップしてください。対象はスタートアップ、大手企業の新規事業、NPO、研究機関を含みます。 【興味のある領域】 意味や価値の定義が揺らいでいる領域(例:教育、介護、創造性、メンタルヘルスなど) 現実世界との物理的接続がある領域(例:IoT、ロボティクス、農業、物流など) データの世界に物理環境を再現するような領域(例:デジタルツイン、行動モデル設計、AR/VR) 【重視したい観点】 データ化しづらい現場の知見や構造の革新 LLMやAIを活用して構造を読み替えるような事業 プロセスや構造が未整備・未標準で、仮説検証の余地がある領域 社会的意義や中長期的に意味のある課題に取り組んでいること 【条件】 日本語での求人があることが望ましい リモート勤務可能であれば尚良い 年収900万円以上が理想(ただしリストアップ時点では必須ではない) 【出力フォーマット】 企業名(URLあれば) 主な事業内容 該当する興味との関連 求人有無とそのURL(ある場合) 上記のプロンプトを使ってLLMにDeep Researchさせます。 上記のプロンプト自体の質が、結果に反映されます。 深堀りステップ 興味ある項目を個別の企業ごとに聞いていく プロンプト例 〇〇という企業の競合について教えてください。それに対してどのようなポジションを取っているのでしょうか? 出力はいろいろです。 ...

August 17, 2025 · 1 min · moai

rclone設定トラブルシューティングのまとめ

今回rcloneの設定で発生した問題と、その解決に至るまでの手順は以下の通りです。 状況1:ポート使用中エラー (address already in use) 問題: `rclone config` 実行時、認証用ポートが他のプロセスで使用中のため起動できない。 対処: `rclone authorize` コマンドを直接実行し、手動認証を試みたが、次の問題が発生した。 状況2:リダイレクトURI不一致エラー (redirect_uri_mismatch) 問題: `rclone authorize` で表示されたURLにアクセスすると、Googleからエラー `400: redirect_uri_mismatch` が返される。これは、rcloneが要求するリダイレクト先URLがGoogle Cloudプロジェクトに登録されていないことが原因。 対処: `rclone config` の対話モードで、自動設定(`Use auto config?`)を「No (n)」にし、手動認証を試みた。 状況3:ヘッドレス環境としての誤認識 問題: 手動設定を選択してもGoogleの認証URLが表示されず、「ブラウザのあるマシンで `rclone authorize` を実行してください」というサーバー環境向けの指示が表示される。rcloneが実行環境を誤認識していることが原因。 根本原因の推定: rcloneに標準で組み込まれているクライアントIDが、Googleのセキュリティポリシー変更などにより正常に機能しなくなっている可能性が高い。 根本的解決策:専用のOAuthクライアントIDの作成と利用 手順1:Google Cloud PlatformでOAuthクライアントIDを作成 プロジェクト作成: Google Cloud Platformにログインし、新規プロジェクトを作成する。 APIの有効化: 「APIとサービス」から「Google Drive API」を検索し、有効化する。 OAuth同意画面の設定: User Typeを「外部」に設定する。 アプリ名、ユーザーサポートメールなどを入力する。 認証情報の作成: 「認証情報を作成」から「OAuthクライアントID」を選択する。 アプリケーションの種類を「デスクトップアプリ」に設定して作成する。 表示された「クライアントID」と「クライアントシークレット」を控える。 手順2:作成したクライアントIDでrcloneを設定 `rclone config` を再度実行し、新しいリモート接続の作成を開始する。 `client_id`と`client_secret`を尋ねられた際、手順1で控えた自身の値を入力して認証を進める。 状況4:Googleによるアプリ未審査エラー 問題: 自作のクライアントIDで認証を進めると、「このアプリは現在テスト中で、承認されたテスターのみがアクセスできます」というエラーがGoogleから表示される。 原因: 作成したOAuthクライアントIDが「テストモード」のため、許可されたテストユーザー以外からのアクセスがブロックされている。 手順3:テストユーザーに自身のアカウントを追加(最終解決策) 再度、Google Cloud Platformの「OAuth同意画面」を開く。 「テストユーザー」の項目で「+ ADD USERS」をクリックし、rcloneで認証したい自身のGoogleアカウントのメールアドレスを追加する。 上記設定後、rcloneの認証プロセスを再実行することで、認証が正常に完了した。 ...

August 17, 2025 · 1 min · moai