[{"data":1,"prerenderedAt":362},["ShallowReactive",2],{"content-/excel-shortcuts-course-migration-improvement":3,"all-pages-for-dir":360,"og-image-/excel-shortcuts-course-migration-improvement":361},{"id":4,"title":5,"body":6,"category":340,"description":341,"extension":342,"meta":343,"navigation":344,"ogImage":345,"path":346,"project_name":347,"published":348,"publishedAt":349,"seo":350,"stem":351,"tags":352,"todo":358,"unpublished":348,"updatedAt":345,"__hash__":359},"pages/2026-04/2026-04-10/excel-shortcuts-course-migration-improvement.md","Excelショートカット講座の移行完了・字幕とtextsの役割分担・VOICEVOX音声テストの顛末",{"type":7,"value":8,"toc":302},"minimark",[9,13,17,20,25,29,32,36,44,47,49,53,56,59,62,65,68,71,73,82,85,88,91,110,113,116,118,122,125,127,131,135,138,142,145,147,151,155,158,161,164,168,171,173,177,221,223,227,230,233,236,239,243,246,249,251,255,262,264,267],[10,11,5],"h1",{"id":12},"excelショートカット講座の移行完了字幕とtextsの役割分担voicevox音声テストの顛末",[14,15,16],"p",{},"前日の積み残し5タスクを棚卸ししたら、完了済みは1つだけだった。残り4タスクの計画マークダウンを書き出してから作業に入った。字幕の品質改善に取りかかったところで「字幕に入れるべき情報とtextsに入れるべき情報は違う」という当たり前のことに気づいて方針が変わり、そこからtextsの品質レビュー、まとめページのリファクタリング、VOICEVOX音声テストと手を広げていった一日の記録。",[18,19],"hr",{},[21,22,24],"h2",{"id":23},"_1-字幕品質改善-方針転換","1. 字幕品質改善 → 方針転換",[26,27,28],"h3",{"id":28},"最初の想定",[14,30,31],{},"字幕テキストの品質が低いセクションがあったので、字幕に文脈説明を追加しようとした。「なぜこの操作をするのか」「どういう場面で使うのか」を織り込めば、動画だけ見ても内容が伝わるはずだと考えた。",[26,33,35],{"id":34},"気づき-字幕とtextsは別の仕事をする","気づき: 字幕とtextsは別の仕事をする",[14,37,38,39,43],{},"実際に書き直し始めると、字幕が長くなりすぎて画面を覆い尽くした。字幕はあくまで",[40,41,42],"strong",{},"動画の操作実況","であって、「Ctrl+Sを押します」「セルA1を選択します」のような短い指示が本来の役割だった。文脈や背景の説明はtextsパネルに入れるべき情報で、字幕に詰め込むものではない。",[14,45,46],{},"この区別に気づいたことで、以降のコンテンツ改善はtexts側に集中する方針に切り替えた。",[18,48],{},[21,50,52],{"id":51},"_2-textsコンテンツの品質レビュー","2. textsコンテンツの品質レビュー",[26,54,55],{"id":55},"プレースホルダーの解消",[14,57,58],{},"移行時に仮テキストのまま残っていたセクションを洗い出して、実際の説明文に差し替えた。",[26,60,61],{"id":61},"演習セクションの学習目標追加",[14,63,64],{},"演習ページを開くと、いきなり操作手順が始まっていて「何を学ぶセクションなのか」が分からなかった。各演習セクションの冒頭に学習目標テキストを追加し、その演習で身につくスキルを明示した。",[26,66,67],{"id":67},"説明不足セクションの補強",[14,69,70],{},"動画でショートカットの動作を見せるだけで、「いつ使うか」「なぜこの操作が速いか」の説明が抜けているセクションを補強した。",[18,72],{},[21,74,76,77,81],{"id":75},"_3-textsidxの表示問題と修正","3. texts",[78,79,80],"span",{},"idx","の表示問題と修正",[26,83,84],{"id":84},"症状",[14,86,87],{},"スライド1枚のセクションで、textsパネルが空白のまま何も表示されなかった。",[26,89,90],{"id":90},"原因",[14,92,93,94,98,99,102,103,106,107,109],{},"textsの表示ロジックが",[95,96,97],"code",{},"texts[idx]","でスライドインデックスに対応していた。スライドが複数枚あるセクションでは",[95,100,101],{},"texts[0]",", ",[95,104,105],{},"texts[1]",", ... とインデックスが進んで問題なく動く。しかしスライドが1枚のセクションでは常に",[95,108,101],{},"しか参照されず、textsにエントリが1つならそれだけが表示され、0件なら空白になる。",[26,111,112],{"id":112},"修正",[14,114,115],{},"スライド1枚のセクションではtextsの全エントリを統合して表示するように修正した。スライドインデックスとtextsインデックスが1対1で対応する前提の設計を、「スライド枚数が1のときは全textsを結合」というフォールバックで補った。",[18,117],{},[21,119,121],{"id":120},"_4-移行対応表の作成と全57ページ完了確認","4. 移行対応表の作成と全57ページ完了確認",[14,123,124],{},"旧プロジェクトのショートカット講座ページと新プロジェクトの対応を一覧にした移行対応表を新規作成した。57ページを1行ずつ突き合わせ、移行漏れがないことを確認した。",[18,126],{},[21,128,130],{"id":129},"_5-まとめページのリファクタリング","5. まとめページのリファクタリング",[26,132,134],{"id":133},"before-3つに分かれたインデックス","Before: 3つに分かれたインデックス",[14,136,137],{},"Ctrl系、Alt系、Other系の3つのまとめページが別々に存在していた。ショートカットを探すたびに「あれはCtrl系だったかAlt系だったか」を思い出す必要があり、3ページを行き来していた。",[26,139,141],{"id":140},"after-全講座目次テーブルに統合","After: 全講座目次テーブルに統合",[14,143,144],{},"3つのインデックスを1つの目次テーブルに統合し、種別タグ（セミラティス構造）で分類した。Ctrl系/Alt系/Otherをフィルタで絞り込める。ページ遷移が消えて、1画面で全ショートカットを見渡せるようになった。",[18,146],{},[21,148,150],{"id":149},"_6-個別ページの改善","6. 個別ページの改善",[26,152,154],{"id":153},"streamdeck紹介ページの移植","StreamDeck紹介ページの移植",[14,156,157],{},"Excel基礎講座に置いていたStreamDeck紹介ページをショートカット講座にも追加した。同じコンテンツが2箇所に存在するため、canonical URLをExcel基礎講座側に設定して重複を回避した。",[26,159,160],{"id":160},"パンくずリスト追加",[14,162,163],{},"「Eurekapu / 講義ノート / Excelショートカット講座」の階層をパンくずリストとして全ページに追加した。",[26,165,167],{"id":166},"非推奨ショートカットの注記","「非推奨」ショートカットの注記",[14,169,170],{},"セル結合、枠線、置換ウィンドウなど、実務で使うと後工程で問題を起こすショートカットに「非推奨」の注記を追加した。合わせてシートの3分類（データシート・集計シート・出力シート）を説明し、どの分類のシートでどのショートカットが有効かを明示した。",[18,172],{},[21,174,176],{"id":175},"_7-uiの細かい改善","7. UIの細かい改善",[178,179,180,193],"table",{},[181,182,183],"thead",{},[184,185,186,190],"tr",{},[187,188,189],"th",{},"改善項目",[187,191,192],{},"内容",[194,195,196,205,213],"tbody",{},[184,197,198,202],{},[199,200,201],"td",{},"テーブル行高さ",[199,203,204],{},"パディングを縮小して一画面あたりの表示行数を増やした",[184,206,207,210],{},[199,208,209],{},"ソート機能",[199,211,212],{},"目次テーブルのカラムヘッダーをクリックでソートできるようにした",[184,214,215,218],{},[199,216,217],{},"inlineTopicsの2行表示",[199,219,220],{},"トピック名の括弧内テキストを小さく別行に分離し、メインのトピック名が読みやすくなった",[18,222],{},[21,224,226],{"id":225},"_8-voicevox音声ナレーションの導入と撤回","8. VOICEVOX音声ナレーションの導入と撤回",[26,228,229],{"id":229},"動機",[14,231,232],{},"無音の操作動画にずんだもんの声でナレーションを入れたら、理解しやすくなるのではないかと考えた。",[26,234,235],{"id":235},"試作",[14,237,238],{},"VOICEVOX（ずんだもん）で字幕テキストを読み上げた音声ファイルを生成し、動画に重ねて再生するプロトタイプを作った。動画のタイムラインに合わせて音声を差し込む仕組みまで組んだ。",[26,240,242],{"id":241},"商用ライセンス調査-撤回","商用ライセンス調査 → 撤回",[14,244,245],{},"VOICEVOXの利用規約を確認したところ、商用利用にはクレジット表記が必須だった。全ページにクレジット表記を入れる運用コストと音声ナレーションの学習効果を天秤にかけた結果、現時点では見合わないと判断した。",[14,247,248],{},"音声ナレーション機能は削除し、動画の音声ON/OFFトグルのみを残した。ずんだもんの声は聞き取りやすく、テスト再生では操作の意図がすっと頭に入ってきただけに、クレジット表記の運用負荷が惜しかった。",[18,250],{},[21,252,254],{"id":253},"_9-git-lfsプッシュ問題の解決","9. Git LFSプッシュ問題の解決",[14,256,257,258,261],{},"195MB分のLFSオブジェクトがローカルに未プッシュで溜まっていた。",[95,259,260],{},"git lfs push","を実行して解消した。LFSオブジェクトはコミット時に自動追跡されるが、プッシュは明示的に実行しないとリモートに反映されない。ローカルだけで作業を続けていると、プッシュを忘れがちになる。",[18,263],{},[21,265,266],{"id":266},"今日の学び",[268,269,270,277,286,292],"ul",{},[271,272,273,276],"li",{},[40,274,275],{},"字幕とtextsの役割分担",": 字幕は操作実況、textsは文脈説明。この線引きを最初に決めておけば、字幕を書き直す時間が浮いた",[271,278,279,285],{},[40,280,281,282,284],{},"texts",[78,283,80],{},"の設計前提",": スライドインデックスとtextsインデックスの1対1対応は、スライド枚数が変動するセクションでは壊れる。フォールバックの設計を最初から入れておくべきだった",[271,287,288,291],{},[40,289,290],{},"VOICEVOXの商用利用",": クレジット表記必須。音声品質は申し分ないが、全ページにクレジットを入れる運用コストを無視できない。クレジット表記を一括管理する仕組みができたら再検討する余地はある",[271,293,294,297,298,301],{},[40,295,296],{},"Git LFSのプッシュ忘れ",": コミットとプッシュが分離しているLFSは、ローカルで作業を完結させているとプッシュが後回しになる。定期的に",[95,299,300],{},"git lfs status","で未プッシュを確認する習慣が要る",{"title":303,"searchDepth":304,"depth":304,"links":305},"",2,[306,311,316,322,323,327,332,333,338,339],{"id":23,"depth":304,"text":24,"children":307},[308,310],{"id":28,"depth":309,"text":28},3,{"id":34,"depth":309,"text":35},{"id":51,"depth":304,"text":52,"children":312},[313,314,315],{"id":55,"depth":309,"text":55},{"id":61,"depth":309,"text":61},{"id":67,"depth":309,"text":67},{"id":75,"depth":304,"text":317,"children":318},"3. textsidxの表示問題と修正",[319,320,321],{"id":84,"depth":309,"text":84},{"id":90,"depth":309,"text":90},{"id":112,"depth":309,"text":112},{"id":120,"depth":304,"text":121},{"id":129,"depth":304,"text":130,"children":324},[325,326],{"id":133,"depth":309,"text":134},{"id":140,"depth":309,"text":141},{"id":149,"depth":304,"text":150,"children":328},[329,330,331],{"id":153,"depth":309,"text":154},{"id":160,"depth":309,"text":160},{"id":166,"depth":309,"text":167},{"id":175,"depth":304,"text":176},{"id":225,"depth":304,"text":226,"children":334},[335,336,337],{"id":229,"depth":309,"text":229},{"id":235,"depth":309,"text":235},{"id":241,"depth":309,"text":242},{"id":253,"depth":304,"text":254},{"id":266,"depth":304,"text":266},"dev","Excelショートカット講座全57ページの移行完了確認、字幕品質改善で方針転換、textsコンテンツの品質レビュー、まとめページの統合リファクタリング、ずんだもん音声ナレーションの導入と撤回までの記録","md",{},true,null,"/excel-shortcuts-course-migration-improvement","eurekapu-nuxt4",false,"2026-04-10T00:00:00.000Z",{"title":5,"description":341},"2026-04/2026-04-10/excel-shortcuts-course-migration-improvement",[347,353,354,355,356,357],"Excelショートカット講座","VOICEVOX","字幕品質","UI改善","Git LFS","memo","Ny6aeMTjdJAaE0jU90GeZ3y4DqcHTFZ6Km0SXhFyWRk",[],"https://log.eurekapu.com/og/blog/excel-shortcuts-course-migration-improvement.png?v=2026-04-10T00%3A00%3A00.000Z&title=Excel%E3%82%B7%E3%83%A7%E3%83%BC%E3%83%88%E3%82%AB%E3%83%83%E3%83%88%E8%AC%9B%E5%BA%A7%E3%81%AE%E7%A7%BB%E8%A1%8C%E5%AE%8C%E4%BA%86%E3%83%BB%E5%AD%97%E5%B9%95%E3%81%A8texts%E3%81%AE%E5%BD%B9%E5%89%B2%E5%88%86%E6%8B%85%E3%83%BBVOICEVOX%E9%9F%B3%E5%A3%B0%E3%83%86%E3%82%B9%E3%83%88%E3%81%AE%E9%A1%9B%E6%9C%AB&author=Kei%20Komatsu&sig=fc16978495ce5578",1782528825229]