Fix IG Export Links

Fix IG Export Links

Fix broken /​resolve? links in Simplifier IG exports to work offline and on official MII pages.

Link Categories and Targets

Procedure

1. Download and extract the IG ZIP from Simplifier to a working directory
2. Navigate to the extracted directory containing HTML files
3. Run the fix script:

   cd /​path/​to/​extracted-ig
   bash /​path/​to/​fix-links.sh
   

4. Verify remaining resolve links (should only be intentional Simplifier links):

   grep -c "resolve?" *.html | grep -v ":0$"
   

Script Location

The fix script is located at: .claude/​skills/​fix-ig-export-links/​scripts/​fix-links.sh

Technical Notes

HTML Encoding Variants

The script handles two encoding patterns:

• Single-quoted href with &: Used in FQL canonical box tables (href='...')
• Double-quoted href with &: Used elsewhere (href="...")

Link Pattern Types

• ?canonical=: Links to profile canonical URLs (should resolve via Simplifier)
• ?filepath=: Links to package files (should resolve to official spec URLs or Simplifier packages)

ValueSet and CodeSystem Handling

Unlike simpler IGs, Onkologie defines ~97 ValueSets and ~43 CodeSystems that are referenced in binding tables. These are transformed to Simplifier resolve links with the canonical URL pattern:

https://simplifier.net/​resolve?canonical=https://www.medizininformatik-initiative.de/​fhir/​ext/​modul-onko/​ValueSet/​{id}&fhirVersion=R4

Expected Remaining Links

After running the script, these Simplifier resolve links are intentional:

• MII Onko profile/​ValueSet/​CodeSystem canonical URLs -> https://simplifier.net/​resolve?canonical=...&fhirVersion=R4
• CapabilityStatement canonical -> remains as Simplifier resolve

Example Usage

# Extract the downloaded IG
unzip "[email protected]" -d ig-export

# Run the fix script
cd ig-export
bash ~/​.claude/​skills/​fix-ig-export-links/​scripts/​fix-links.sh

# Verify - count should show only intentional Simplifier links
grep -o "simplifier.net/​resolve" *.html | wc -l

# Check a specific high-traffic page
grep "resolve?" MIIIGModulOnkologie-TechnischeImplementierung-FHIR-Profile-Diagnose-Diagnose-Condition.html | head -5

Package Information

• Package Name: de.medizininformatikinitiative.kerndatensatz.onkologie
• Current Version: 2026.0.0
• Canonical Base: https://www.medizininformatik-initiative.de/​fhir/​ext/​modul-onko
• Guide Name: mii-ig-modul-onkologie-v2026-de

Dependencies Handled