Standardize language file naming to underscore convention

- Rename 18 Spanish/French guides from .es.qmd/.fr.qmd to _es.qmd/_fr.qmd
- Rename how-to-read.qmd and indices.qmd to include _en suffix
- Update _quarto.yml sidebar links to match new filenames
- Add CLAUDE.md for Claude Code guidance

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: jwbowers

CLAUDE.md

@@ -0,0 +1,76 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is the EGAP (Evidence in Governance and Politics) Methods website, a Quarto-based multilingual educational resource for impact evaluation methodology. The site provides methods guides, software tools catalog, and teaching materials for researchers and practitioners.
+
+## Build and Development Commands
+
+```bash
+# Preview the site locally (starts dev server with live reload)
+quarto preview
+
+# Build the site (outputs to _site/)
+quarto render
+
+# Render a single guide
+quarto render guides/research-questions/effect-types_en.qmd
+
+# Restore R package dependencies (required before first build)
+# R will auto-activate renv via .Rprofile
+R -e "renv::restore()"
+```
+
+## Architecture
+
+### Content Structure
+
+- **guides/** — Methods guides organized by topic subdirectories:
+  - `analysis-procedures/`, `assessing-designs/`, `causal-inference/`, `data-collection/`, `implementation/`, `interpretation/`, `planning/`, `research-questions/`
+- **index.qmd** — Homepage with featured guides listing
+- **guides.qmd** — Main guides index using Quarto listings
+- **software.qmd** — Searchable R/Stata software catalog (uses DataTables)
+- **teaching.qmd** — Links to Learning Days coursebook
+
+### Multilingual File Naming Convention
+
+Guides use underscore + language code before `.qmd`:
+- English: `*_en.qmd` (e.g., `effect-types_en.qmd`)
+- Spanish: `*_es.qmd` (e.g., `effect-types_es.qmd`)
+- French: `*_fr.qmd` (e.g., `effect-types_fr.qmd`)
+
+Language switching uses sidebar configuration in `_quarto.yml` with flag icons linking between translations.
+
+### Guide YAML Frontmatter
+
+Each guide includes:
+- `title:` — Guide title
+- `author:` — List with name/url pairs
+- `image:` — Thumbnail image filename (stored alongside the .qmd)
+- `bibliography:` — BibTeX file for references
+- `sidebar:` — ID matching `_quarto.yml` sidebar for language switcher (translations only)
+- `abstract:` — Summary shown at top of guide
+
+### Configuration Files
+
+- `_quarto.yml` — Site structure, navigation, sidebar definitions, HTML format options
+- `_language.yml` — Custom labels (author, date display)
+- `renv.lock` / `renv/` — R package versions for reproducibility
+- `DESCRIPTION` — R package dependencies list
+
+### Quarto Features in Use
+
+- `freeze: auto` — Caches code execution results in `_freeze/`
+- `cache: true` — R code chunk caching
+- `code-fold: true` — Collapsible code blocks
+- Listings for grid-based guide indexes
+- Custom partials in `partials/` for title blocks and TOC
+
+## Deployment
+
+GitHub Actions (`.github/workflows/build-quarto.yml`) builds and publishes to GitHub Pages on push to `main`. The workflow:
+1. Sets up R with renv
+2. Installs system dependencies (libgit2, udunits2, gdal, geos, proj)
+3. Runs `quarto render` and publishes to `gh-pages` branch

_quarto.yml

@@ -23,108 +23,108 @@ website:
     - title: ""
       # contents:
       #   - text: "How to read this guide"
-      #     href: /guides/how-to-read.html
+      #     href: /guides/how-to-read_en.html
 
     - title: "Guides"
 
     - title: ""
       id: effect-types
       contents:
         - text: "How to read this guide"
-          href: /guides/how-to-read.html
+          href: /guides/how-to-read_en.html
         # - text: "What is a simulation?"
         - text: "Language"
           contents:
             - text: "<img src='https://flagcdn.com/w20/gb.png' width=20px>&nbsp;&nbsp;English"
-              href: /guides/research-questions/effect-types.en.html
+              href: /guides/research-questions/effect-types_en.html
             - text: "<img src='https://flagcdn.com/w20/fr.png' width=20px>&nbsp;&nbsp;French"
-              href: /guides/research-questions/effect-types.fr.html
+              href: /guides/research-questions/effect-types_fr.html
             - text: "<img src='https://flagcdn.com/w20/es.png' width=20px>&nbsp;&nbsp;Spanish"
-              href: /guides/research-questions/effect-types.es.html
+              href: /guides/research-questions/effect-types_es.html
 
     - title: ""
       id: hypothesis-testing
       contents:
         - text: "How to read this guide"
-          href: /guides/how-to-read.html
+          href: /guides/how-to-read_en.html
         - text: "Language"
           contents:
             - text: "<img src='https://flagcdn.com/w20/gb.png' width=20px>&nbsp;&nbsp;English"
-              href: /guides/analysis-procedures/hypothesis-testing.en.html
+              href: /guides/analysis-procedures/hypothesis-testing_en.html
             # - text: "<img src='https://flagcdn.com/w20/fr.png' width=20px>&nbsp;&nbsp;French"
-            #   href: /guides/analysis-procedures/hypothesis-testing.fr.html
+            #   href: /guides/analysis-procedures/hypothesis-testing_fr.html
             - text: "<img src='https://flagcdn.com/w20/es.png' width=20px>&nbsp;&nbsp;Spanish"
-              href: /guides/analysis-procedures/hypothesis-testing.es.html
+              href: /guides/analysis-procedures/hypothesis-testing_es.html
 
     - title: ""
       id: external-validity
       contents:
         - text: "How to read this guide"
-          href: /guides/how-to-read.html
+          href: /guides/how-to-read_en.html
         - text: "Language"
           contents:
             - text: "<img src='https://flagcdn.com/w20/gb.png' width=20px>&nbsp;&nbsp;English"
-              href: /guides/assessing-designs/external-validity.en.html
+              href: /guides/assessing-designs/external-validity_en.html
             - text: "<img src='https://flagcdn.com/w20/fr.png' width=20px>&nbsp;&nbsp;French"
-              href: /guides/assessing-designs/external-validity.fr.html
+              href: /guides/assessing-designs/external-validity_fr.html
             - text: "<img src='https://flagcdn.com/w20/es.png' width=20px>&nbsp;&nbsp;Spanish"
-              href: /guides/assessing-designs/external-validity.es.html
+              href: /guides/assessing-designs/external-validity_es.html
 
     - title: ""
       id: power
       contents:
         - text: "How to read this guide"
-          href: /guides/how-to-read.html
+          href: /guides/how-to-read_en.html
         - text: "Language"
           contents:
             - text: "<img src='https://flagcdn.com/w20/gb.png' width=20px>&nbsp;&nbsp;English"
-              href: /guides/assessing-designs/power.en.html
+              href: /guides/assessing-designs/power_en.html
             - text: "<img src='https://flagcdn.com/w20/fr.png' width=20px>&nbsp;&nbsp;French"
-              href: /guides/assessing-designs/power.fr.html
+              href: /guides/assessing-designs/power_fr.html
             - text: "<img src='https://flagcdn.com/w20/es.png' width=20px>&nbsp;&nbsp;Spanish"
-              href: /guides/assessing-designs/power.es.html
+              href: /guides/assessing-designs/power_es.html
 
     - title: ""
       id: mechanisms
       contents:
         - text: "How to read this guide"
-          href: /guides/how-to-read.html
+          href: /guides/how-to-read_en.html
         - text: "Language"
           contents:
             - text: "<img src='https://flagcdn.com/w20/gb.png' width=20px>&nbsp;&nbsp;English"
-              href: /guides/research-questions/mechanisms.en.html
+              href: /guides/research-questions/mechanisms_en.html
             - text: "<img src='https://flagcdn.com/w20/fr.png' width=20px>&nbsp;&nbsp;French"
-              href: /guides/research-questions/mechanisms.fr.html
+              href: /guides/research-questions/mechanisms_fr.html
             - text: "<img src='https://flagcdn.com/w20/es.png' width=20px>&nbsp;&nbsp;Spanish"
-              href: /guides/research-questions/mechanisms.es.html
+              href: /guides/research-questions/mechanisms_es.html
 
     - title: ""
       id: pap
       contents:
         - text: "How to read this guide"
-          href: /guides/how-to-read.html
+          href: /guides/how-to-read_en.html
         - text: "Language"
           contents:
             - text: "<img src='https://flagcdn.com/w20/gb.png' width=20px>&nbsp;&nbsp;English"
-              href: /guides/planning/pap.en.html
+              href: /guides/planning/pap_en.html
             - text: "<img src='https://flagcdn.com/w20/fr.png' width=20px>&nbsp;&nbsp;French"
-              href: /guides/planning/pap.fr.html
+              href: /guides/planning/pap_fr.html
             - text: "<img src='https://flagcdn.com/w20/es.png' width=20px>&nbsp;&nbsp;Spanish"
-              href: /guides/planning/pap.es.html
+              href: /guides/planning/pap_es.html
 
     - title: ""
       id: xcausey
       contents:
         - text: "How to read this guide"
-          href: /guides/how-to-read.html
+          href: /guides/how-to-read_en.html
         - text: "Language"
           contents:
             - text: "<img src='https://flagcdn.com/w20/gb.png' width=20px>&nbsp;&nbsp;English"
-              href: /guides/causal-inference/x-cause-y.en.html
+              href: /guides/causal-inference/x-cause-y_en.html
             - text: "<img src='https://flagcdn.com/w20/fr.png' width=20px>&nbsp;&nbsp;French"
-              href: /guides/causal-inference/x-cause-y.fr.html
+              href: /guides/causal-inference/x-cause-y_fr.html
             - text: "<img src='https://flagcdn.com/w20/es.png' width=20px>&nbsp;&nbsp;Spanish"
-              href: /guides/causal-inference/x-cause-y.es.html
+              href: /guides/causal-inference/x-cause-y_es.html
 
 
 format: