Merge pull request #1797 from coderdojo-japan/fix-meta-descriptions

ドキュメントの meta description を修正（TDD実践）

Author: yasulab

public/docs/post-backend-update-history.md

@@ -2,6 +2,8 @@
 
 <p class="text-center"><small>本記事は2016年12月12日に公開した記事を一部改訂したアーカイブ版です。</small></p>
 
+2016年の CoderDojo Advent Calendar で公開した、coderdojo.jp のバックエンド刷新に関する技術記事です。
+
 -----
 
 [CoderDojo Advent Calendar](http://www.adventar.org/calendars/1619) 12日目、coderdojo.jp の裏側をリニューアルした話です。 (執筆: [@yasulab](https://twitter.com/yasulab))

public/docs/regional-license.md

@@ -1,10 +1,8 @@
 # 🌐 地域ライセンス契約書
-<center><small>(本契約書は、契約当時の写しとなります。<a href="regional-license_en">英語の原文を読む</a>)</small></center>
 
-<div style="padding: 30px 0px;">
-  <img class='lazyload' loading='lazy' alt="Photo of License Agreement between Foundation and Japan."
-   src='/spinner.svg' data-src='/coderdojo-japan-2016_rect.png' />
-</div>
+<img class='lazyload' loading='lazy' alt="Photo of License Agreement between Foundation and Japan." src='/spinner.svg' data-src='/coderdojo-japan-2016_rect.png' style='padding: 30px 0px;' />
+
+CoderDojo Foundation (当時の名称: `HELLO WORLD Foundation`) と一般社団法人 CoderDojo Japan (英名: `CoderDojo Japan Association`) の間で締結された地域ライセンス契約書です。2016年の契約当時の写しとなります。
 
 <blockquote>
   <p style="font-size: 80%">
@@ -13,8 +11,12 @@
   </p>
 </blockquote>
 
+<center><small><a href="regional-license_en">&raquo; 英語の原文を読む (View in English)</a></small></center>
+
 <br>
 
+-----
+
 以下のライセンス契約は、地域または国の全ての登録済 CoderDojo 慈善団体と締結されるものです。本ライセンス契約は、ある地域を代表する組織または非公認のグループと締結する基本的な MOU（覚書）として行使されることになります。
 
 **本ライセンスの対象区域：日本**

public/docs/regional-license_en.md

@@ -1,10 +1,8 @@
 # 🌐 CoderDojo Regional License
-<center><small>(本契約書は、契約当時の写しとなります。<a href="regional-license">日本語の訳文を読む</a>)</small></center>
 
-<div style="padding: 30px 0px;">
-  <img class='lazyload' loading='lazy' alt="Photo of License Agreement between Foundation and Japan."
-   src='/spinner.svg' data-src='/coderdojo-japan-2016_rect.png' />
-</div>
+<img class='lazyload' loading='lazy' alt="Photo of License Agreement between Foundation and Japan." src='/spinner.svg' data-src='/coderdojo-japan-2016_rect.png' style='padding: 30px 0px;' />
+
+Regional license agreement between CoderDojo Foundation and CoderDojo Japan Association, dated August 27th, 2016.
 
 <blockquote>
   <p style="font-size: 80%">
@@ -13,8 +11,12 @@
   </p>
 </blockquote>
 
+<center><small><a href="regional-license">&raquo; 日本語で読む (View in Japanese)</a></small></center>
+
 <br>
 
+-----
+
 ## Regional License for Japan
 
 **Dated on the August 27th, 2016**

public/docs/teikan.md

@@ -2,7 +2,7 @@
 
 <img class='lazyload' loading='lazy' alt='Photo of announcement to found the CoderDojo Japan Association.' src='/spinner.svg' data-src='/coderdojo-japan-2016_rect.png' style='padding: 30px 0px;' />
 
-[一般社団法人 CoderDojo Japan](/about) の定款です。2016年の設立当時のもので、現在は改訂されている可能性がある点にご注意ください。
+[一般社団法人 CoderDojo Japan](/about) の定款です。2016年の設立当時の写しとなります。
 
 <center>
   ( <a href="https://github.com/coderdojo-japan/coderdojo.jp/commits/main/db/docs/teikan.md">&raquo; 定款の変更履歴を見る</a>

spec/models/document_spec.rb

@@ -52,4 +52,39 @@
       expect(doc.exist?).to be true
     end
   end
+
+  describe 'meta descriptions' do
+    it 'すべての公開ドキュメントの meta description に HTML タグが含まれていないこと' do
+      # 全ドキュメントファイルを取得（記録用ページ "_" で始まるものを除く）
+      doc_files = Dir.glob('public/docs/*.md').map { |f| File.basename(f, '.*') }
+      public_docs = doc_files.reject { |f| f.start_with?('_') }
+
+      # 各ドキュメントの meta description をチェック
+      problematic_docs = []
+      public_docs.each do |filename|
+        doc = Document.new(filename)
+        description = doc.description
+
+        # HTML タグまたは HTML エンティティが含まれている場合は問題あり
+        if description.match?(/<|&lt;|&gt;|&amp;/)
+          problematic_docs << {
+            filename: filename,
+            description: description[0..100] # 最初の100文字
+          }
+        end
+      end
+
+      # エラーメッセージを詳細に表示
+      if problematic_docs.any?
+        error_message = "\n以下のドキュメントの meta description に HTML タグが含まれています:\n"
+        problematic_docs.each do |doc|
+          error_message += "\n❌ #{doc[:filename]}\n"
+          error_message += "   Description: #{doc[:description]}...\n"
+        end
+        fail error_message
+      end
+
+      expect(problematic_docs).to be_empty
+    end
+  end
 end