feat: migrate blog FAQs to reusable MDX accordion

- add Astro MDX support and convert FAQ-bearing posts to MDX
- centralize FAQ markup, scoped styling, behavior, and JSON-LD
- preserve FAQ content and links across English and Spanish posts
- extend blog audits and document the MDX editing workflow
- remove obsolete global FAQ styles
- ignore Front Matter CMS generated state
This commit is contained in:
2026-06-08 15:46:20 -07:00
parent 9678fc9a3c
commit 826d5e8c7d
31 changed files with 1923 additions and 736 deletions
+16 -1
View File
@@ -253,6 +253,19 @@ Arabic routes automatically render with `lang="ar"` and `dir="rtl"`.
Do not publish unreviewed machine translations. Clearly mark placeholders.
### Edit A Blog FAQ
Posts with live-style FAQ sections use `.mdx` and import:
```mdx
import FAQAccordion from '../../../components/FAQAccordion.astro';
```
Edit the component's `label`, `heading`, and `items` data in the post. Keep
`answer` as plain text for JSON-LD and `answerHtml` as the matching visible
answer. Shared FAQ markup, styling, interaction, and schema generation live in
`src/components/FAQAccordion.astro`.
## Mirror Extraction Workflow
The mirror is read-only source material. Never modify:
@@ -288,7 +301,9 @@ npm run audit:blog
```
Extraction regenerates content files, copied assets, and inventories. Review
the complete Git diff before accepting it.
the complete Git diff before accepting it. Extraction may recreate FAQ-bearing
posts as Markdown; restore their `FAQAccordion` MDX blocks before accepting the
result. `npm run audit:blog` reports plain Markdown FAQ sections.
## Reports And Utilities