Case study · Website migration

Methodolodys

スイスの特別支援教育の先生 Martine Jiménez さんが10年かけて作った、Dys(ディスレクシアなど)の子ども向け無料教材サイトです。WordPressで動いていたこのサイトを、教材を一つも失わずに、速くて安全な静的サイトへ作り直しました。
A free learning-resources site for children with dyslexia and other « dys » disorders, built over 10 years by Martine Jiménez, a special-needs teacher in Switzerland. I rebuilt it from WordPress into a fast, secure static site, without losing a single resource.

新しいサイト(テスト版) / New site (test) コード / Code (GitHub)

1. なぜ作り直したか Why rebuild it

見た目は動いていても、中身は古くなっていました。毎日先生や保護者が使うサイトなので、壊れる前に作り直すことにしました。
The site still worked, but it was ageing underneath. Teachers and parents use it every day, so it was worth rebuilding before something broke.

数値:東京からcurlで計測(5回の中央値、接続時間を除く)、2026年10月。旧サイトはまだ公開中なので、セキュリティの詳細は載せていません。
Figures: measured from Tokyo with curl (median of 5, connection time removed), October 2026. Security details are left out while the old site is still online.

2. 全体の構成 Architecture

ページ(16 MB)とダウンロード用のファイル(5.3 GB)を分けました。ページはAzure Static Web Apps、ファイルはAzure Blob Storage。どちらも管理するサーバーはありません。
Pages (16 MB) and downloadable files (5.3 GB) are kept apart: pages on Azure Static Web Apps, files on Azure Blob Storage. No server to manage on either side.

Methodolodys architecture: the WordPress backup is read by a Python pipeline that produces a JSON data file and HTML pages; pages are served by Azure Static Web Apps and the 1,909 downloadable files by Azure Blob Storage; the browser loads pages from one and downloads files from the other 移行 / Migration (Python) WordPressのバックアップ .wpress 12 GB · MySQL dump extraire.py Divi shortcodes → blocks · repairs generer_pages.py 63 pages · 71 redirects · 404 ressources.json · WebP previews Microsoft Azure (East Asia) Azure Static Web Apps (Free) HTML · CSS · JavaScript, no framework · 16 MB 301 redirects · cache headers · Brotli search + pages built from one JSON file Azure Blob Storage 1,909 files · 5.3 GB · PDF / PowerPoint / Word / video public read · cached 1 day · a few cents a month old /wp-content/uploads links forwarded here deploy upload ブラウザ / Browser ページ・検索 pages · search ダウンロード direct file links

3. 5.3 GBのファイルをAzureへ 5.3 GB of files on Azure

このサイトの中心は、10年分の教材ファイルです。ページの中に入れると、Static Web Apps無料プランの上限(250 MB)の20倍以上になります。そこでファイルだけをBlob Storageに置き、ページからは直接リンクしています。
The heart of the site is ten years of teaching files. Inside the pages they would be over 20 times the Static Web Apps free-plan limit (250 MB), so the files live on Blob Storage and the pages link to them directly.

何が入っている? What is stored?

PDF、PowerPoint、Word、動画・音声の1 909ファイル。そのうち1 097枚は「視覚意味辞書」(単語カードとその説明)です。全教材のタイトル・場所・種類・サイズ・日付は1つのJSON(1 920件)にまとめ、ページと検索はこのJSONから作ります。
1,909 PDF, PowerPoint, Word, video and audio files, including 1,097 cards of a visual-semantic dictionary (a word card and its explanation for each word). One JSON file (1,920 entries) describes every resource: title, page, section, type, size and date. Pages and search are built from it.

どうやって確認した? How was it checked?

アップロード後、ローカルとAzureの全ファイルを名前とサイズで比べました(差分0)。次に、公開されたサイトの1 909個のダウンロードリンクを全部、実際にリクエストして確認しました(エラー0)。アクセント付きのファイル名(« trésor.pdf »など)も正しく開きます。
After the upload I compared every file by name and size between my Mac and Azure (0 differences), then requested each of the 1,909 download links of the published site (0 errors). File names with accents, such as « trésor.pdf », open correctly.

コストは? Cost?

ページはStatic Web Appsの無料プラン。ファイルの保存は月に数十円程度。ダウンロードの転送量は、無料枠(月100 GB)を超えた分だけ課金されます。
Pages run on the Static Web Apps free plan. Storing the files costs a few cents a month; download traffic is only charged past the free 100 GB a month.

4. 失わない移行 A lossless migration

  1. 読む Read 12 GBのバックアップから必要な7.2 GBだけを取り出し、MySQLダンプとページビルダーDiviのショートコードを順番どおりに解析。 Take the 7.2 GB that matter out of a 12 GB backup, then parse the MySQL dump and the Divi page-builder shortcodes in page order.
  2. 直す Repair 文字化けしたファイル名、2つのURLがくっついたリンク、閉じていないブロック、「こちらをクリック」だけのタイトルを自動で修正。 Fix mojibake file names, links with two glued URLs, unclosed blocks and titles that only said « click here ».
  3. 補う Complete 画像のない144の教材には、ファイルの1ページ目からプレビューを作成。旧トップページにしかなかった2つの教材も見つけて移しました。 Generate a preview from the first page of the 144 resources without an image, and recover 2 resources that only existed on the old homepage.
  4. 確かめる Verify 全ページのリンク・画像3 000件以上、71のリダイレクト、1 909のダウンロードをスクリプトで確認してから公開。 Check 3,000+ links and images, 71 redirects and 1,909 downloads by script before publishing.

5. 旧サイトと新サイト Before and after

項目 Item旧 Old新 New
仕組み StackWordPress · Divi · PHP · MySQLHTML · CSS · JavaScript · JSON
ページの処理時間 Server time1.1 – 1.5 s~7 ms
HTML(圧縮後) HTML, compressed33 KB1 – 3 KB
プラグイン Plugins70
管理画面 Admin loginあり / yesnone
探し方 Finding a resourceメニューと長いページ / menus, long pagessearch, one page per topic, previews
古いURL Old URLs—71 × 301 redirect

6. 設計で考えたこと Design decisions

7. まだやっていないこと Not done yet

依頼者の確認を待っているテスト版です。まだのこと:methodolodys.ch のドメインの切り替え、利用者に近いヨーロッパのリージョンへの移動(いまは学生用サブスクリプションの制限で東アジア)、編集を簡単にするための更新手順の整備。
This is a test version waiting for the owner's review. Not in place yet: switching the methodolodys.ch domain, moving to a European region closer to its users (East Asia for now, because of the student subscription's region policy), and a simpler update workflow for the content.

8. 作り方と学んだこと How it was built, what I learned

Claude Code(AIのコーディングエージェント)と一緒に作りました。移行の方針、ページの構成、何を残して何を直すか、公開の判断は私が決め、毎回ブラウザで確認しました。大きな移行では、作ることより「何も失っていない」と証明することのほうが大事だと学びました。
Built with Claude Code, an AI coding agent. I decided the migration plan, the page structure, what to keep and what to fix, checked every change in the browser and made the publishing decisions. On a large migration, proving that nothing was lost matters more than building fast.