Convert to Jekyll with Markdown source files

Converts wiki.csswg.org DokuWiki content to a Jekyll static site with:

Content conversion:
- 294 pages converted from HTML to Markdown via pandoc
- DokuWiki plugins handled: definition lists, alerts, topic metadata
- Emoji conversion, broken media cleanup, attribute stripping

Frontend:
- Responsive mobile-first design with hamburger menu (<640px)
- WCAG 2.1 AA accessibility: skip link, ARIA landmarks, focus indicators
- Dark mode support via prefers-color-scheme
- Sticky header, fluid typography, responsive tables

Search (Lunr.js):
- Client-side full-text search across all pages
- search.json index generated at build time
- Highlighted excerpts in search results

Edit controls:
- "Edit" button next to page title (GitHub Octicons compose icon)
- Footer: "Edit this page" and "View version history" links

Author: sideshowbarker

.gitattributes

@@ -0,0 +1 @@
+*.md linguist-detectable

.github/workflows/deploy.yml

@@ -15,16 +15,30 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.2'
+      - name: Install Jekyll
+        run: gem install jekyll
+      - name: Setup Pages
+        id: pages
+        uses: actions/configure-pages@v4
+      - name: Build with Jekyll
+        run: jekyll build --baseurl "${{ steps.pages.outputs.base_path }}"
+        env:
+          JEKYLL_ENV: production
+      - uses: actions/upload-pages-artifact@v3
+
   deploy:
     runs-on: ubuntu-latest
+    needs: build
     environment:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/configure-pages@v4
-      - uses: actions/upload-pages-artifact@v3
-        with:
-          path: '.'
       - uses: actions/deploy-pages@v4
         id: deployment

.gitignore

@@ -0,0 +1 @@
+_site/

README.md

@@ -1,20 +1,121 @@
-# CSS Working Group Wiki Archive
+# CSS Working Group Wiki
 
-This is a read-only static archive of the [CSS Working Group Wiki](https://wiki.csswg.org/), originally hosted on DokuWiki at wiki.csswg.org.
+Community-editable documentation for the [CSS Working Group](https://www.w3.org/Style/CSS/).
 
-**Live site:** https://w3c.github.io/csswg-wiki-archive/
+**Live site:** https://w3c.github.io/csswg-wiki/
+
+This replaces the original DokuWiki at wiki.csswg.org. Pages are now Markdown files that can be edited directly on GitHub.
 
 ## Contents
 
-The archive contains 294 pages covering:
+The wiki was initially populated with 294 pages from wiki.csswg.org covering:
+
+- **[Meeting Planning](/planning/)** — Face-to-face meeting plans and schedules
+- **[Ideas and Resolutions](/ideas/)** — Ideas not yet in a spec
+- **[CSSWG Tools](/tools/)** — Documentation about working group tools
+- **[Specification Issues and Planning](/spec/)** — Wiki pages for tracking spec-related thoughts
+- **[Testing](/test/)** — CSS testing documentation
+
+## Search
+
+The site includes client-side full-text search powered by [Lunr.js](https://lunrjs.com/):
+
+- **Build-time indexing** — `search.json` generates a JSON index of all pages at build time
+- **Client-side search** — No server required; search runs entirely in the browser
+- **Highlighted excerpts** — Search results show matching terms highlighted in context
+- **Keyboard accessible** — Header search form submits to dedicated results page
+
+Search is available via the search box in the site header, or directly at `/search/`.
+
+## Editing
+
+Each page has an “edit this page” link that takes you to the GitHub editor. Changes are deployed automatically when merged to `main`.
+
+## Local Development
+
+The site uses Jekyll. To preview locally:
+
+```bash
+gem install jekyll
+jekyll serve
+```
+
+Then open http://localhost:4000/csswg-wiki/
+
+## Frontend Design
+
+The site uses a modern, accessible frontend built with vanilla HTML, CSS, and JavaScript.
+
+### Responsive Design
+
+- **Mobile-first layout** with hamburger menu on screens under 640px
+- **Fluid typography** using CSS `clamp()` for readable text at any viewport
+- **Sticky header** for persistent navigation access
+- **Responsive tables** wrapped for horizontal scrolling on small screens
+
+### Accessibility
+
+The site follows WCAG 2.1 AA guidelines:
+
+- **Skip link** — "Skip to main content" link for keyboard users
+- **ARIA landmarks** — `banner`, `navigation`, `main`, `complementary` roles
+- **Focus indicators** — Visible 2px outline on all interactive elements
+- **Keyboard navigation** — Escape closes mobile menu, focus is managed
+- **Reduced motion** — Respects `prefers-reduced-motion` preference
+- **High contrast** — Supports Windows High Contrast Mode (`forced-colors`)
+- **Touch targets** — Minimum 44×44px tap targets on interactive elements
+- **Current page indication** — `aria-current` on navigation and breadcrumbs
+
+### Browser Support
+
+- All modern browsers (Chrome, Firefox, Safari, Edge)
+- Graceful degradation for older browsers
+- Print stylesheet with expanded URLs
+
+## Conversion from wiki.csswg.org
+
+The wiki was converted from the DokuWiki installation at wiki.csswg.org in February 2026.
+
+### Conversion process
+
+1. **Scrape** — A Python scraper (`bin/scrape.py`) crawled the DokuWiki site and extracted all 294 pages as static HTML files with clean styling.
+
+2. **Convert to Markdown** — A conversion script (`bin/convert-to-markdown.py`) processed the HTML using pandoc to generate Markdown source files, with special handling for DokuWiki plugins:
+
+   **Definition lists** — DokuWiki’s `plugin_definitionlist` used `<dl>/<dt>/<dd>` markup. Since pandoc doesn’t output kramdown’s definition list syntax, the script extracts these before pandoc runs and restores them afterward as proper kramdown:
+   ```
+   Term
+   : Definition
+   ```
+
+   **GFM-style alerts** — DokuWiki’s `plugin_note` divs (with classes like `noteimportant`, `notewarning`, `notetip`) are converted to GitHub-flavored Markdown alert syntax, rendered at runtime by `assets/alerts.js`:
+   ```
+   > [!IMPORTANT]
+   > Alert content here
+   ```
 
-- **Specification Issues and Planning** (`/spec/`) — Wiki pages for tracking spec-related thoughts
-- **Ideas and Resolutions** (`/ideas/`) — Ideas not yet in a spec
-- **Testing** (`/test/`) — CSS testing documentation
-- **Meeting Planning** (`/planning/`) — Face-to-face meeting plans and schedules
-- **CSSWG Tools** (`/tools/`) — Documentation about working group tools
+   **Topic metadata** — The `dataplugin_entry` structured data (used on `/topics/` pages for tracking spec issues) is converted to inline metadata:
+   ```
+   **Spec:** css3-flexbox | **Owner:** tabatkins | **Status:** Closed | **Added:** 2012-05-16
+   ```
 
-## Last Modified Dates
+   **Emoji conversion** — DokuWiki smiley images (`/lib/images/smileys/*.svg`) are replaced with Unicode emoji: `:!:` → ⚠️, `:?:` → ❓, `FIXME` → 🚧, etc.
+
+   **Broken media cleanup** — References to missing wiki images (`/_media/`) and DokuWiki proxy URLs (`/lib/exe/fetch.php`) are removed or replaced with placeholder text.
+
+   **General cleanup** — Stripped `rel`, `class`, and `id` attributes from links; removed redundant `title` attributes; converted `<span class="abbr">` to plain text (handled by JavaScript at runtime).
+
+3. **Jekyll setup** — Added Jekyll configuration, layout template with “edit this page” links, and automatic breadcrumb generation.
+
+4. **Abbreviation handling** — Added `assets/abbr.js` to wrap known abbreviations (CSS, HTML, W3C, IRC, URL, GUI) in `<abbr>` tags with tooltips at runtime.
+
+### Requirements for re-conversion
+
+- Python 3.8+
+- pandoc
+- Network access to wiki.csswg.org
+
+## Analysis of wiki.csswg.org Page Activity
 
 Generated: 2026-02-14
 
@@ -65,48 +166,6 @@ This listing excludes 166 pages that were bulk-imported on 2014/12/09.
 | | | test/ | [to-do](https://wiki.csswg.org/test/to-do), [css-writing-modes-3](https://wiki.csswg.org/test/css-writing-modes-3) |
 | 2014 | 3 | planning/ | [sophia-2014](https://wiki.csswg.org/planning/sophia-2014), [seoul-2014](https://wiki.csswg.org/planning/seoul-2014), [seattle-2014](https://wiki.csswg.org/planning/seattle-2014) |
 
-To regenerate this listing:
-
-```bash
-python3 bin/list-timestamps.py
-```
-
-## Regenerating the Archive
-
-The archive was generated using a Python scraper that crawls the DokuWiki site and produces static HTML files.
-
-### Requirements
-
-- Python 3.8+
-- Network access to wiki.csswg.org
-
-### Usage
-
-```bash
-# Scrape the wiki and output to a directory
-python3 bin/scrape.py /path/to/output
-
-# Or output to current directory
-python3 bin/scrape.py .
-
-# Preview locally
-python3 -m http.server -d /path/to/output
-```
-
-The scraper:
-1. Discovers all pages by crawling the DokuWiki index
-2. Fetches each page and extracts the main content
-3. Generates clean HTML with modern styling and dark mode support
-4. Creates proper relative links for hosting at any URL path
-
-### Rate Limiting
-
-The scraper includes a 0.3-second delay between requests, to be nice to the server. A full scrape of ~294 pages takes approximately 2 minutes.
-
-## Deployment
-
-The site is automatically deployed to GitHub Pages via the workflow in `.github/workflows/deploy.yml` whenever changes are pushed to the `main` branch.
-
 ## License
 
 The wiki content is governed by the [W3C Document License](https://www.w3.org/Consortium/Legal/2015/doc-license).

_config.yml

@@ -0,0 +1,23 @@
+title: CSS Working Group Wiki
+description: Community-editable wiki for CSS Working Group documentation
+url: https://w3c.github.io
+baseurl: /csswg-wiki
+repository: w3c/csswg-wiki
+
+markdown: kramdown
+kramdown:
+  input: GFM
+  hard_wrap: false
+
+permalink: pretty
+
+defaults:
+  - scope:
+      path: ""
+    values:
+      layout: default
+
+exclude:
+  - README.md
+  - bin/
+  - .mypy_cache/