preview-import
/preview-import
Podgląda i weryfikuje treść zaimportowaną do lokalnego serwera deweloperskiego AEM Edge Delivery Services: renderowanie bloków, struktura DOM, porównanie z oryginałem oraz błędne odwołania i 404.
Ocena i bezpieczeństwo
- Pliki w paczce
- 4
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 8
Brak sygnałów. Repozytorium zmienione 24.10.2026, bez odwołań do wycofanych modeli i API.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
Co robi i kiedy
Podgląda i weryfikuje treść zaimportowaną do lokalnego serwera deweloperskiego AEM Edge Delivery Services: renderowanie bloków, struktura DOM, porównanie z oryginałem oraz błędne odwołania i 404.
Oryginalny opis (EN)
Use this when you need to preview and verify content you imported into a local AEM Edge Delivery Services (EDS, Franklin, Helix) dev server on localhost. Starts the dev server against the imported HTML, checks block rendering, inspects DOM structure, compares against the original page, and troubleshoots broken references and 404s.
Jak działa
- When to Use This Skill
- Prerequisites
- Related Skills
- Preview Workflow
- Troubleshooting
- Output
Podgląd SKILL.md
---
name: preview-import
description: Use this when you need to preview and verify content you imported into a local AEM Edge Delivery Services (EDS, Franklin, Helix) dev server on localhost. Starts the dev server against the imported HTML, checks block rendering, inspects DOM structure, compares against the original page, and troubleshoots broken references and 404s.
license: Apache-2.0
metadata:
version: "2.0.1"
---
# Preview Import
Open and verify imported content in local development server.
## When to Use This Skill
Use this skill when:
- You have generated HTML file (from generate-import-html)
- Ready to preview in browser and verify rendering
- Need to compare with original page structure
**Invoked by:** page-import skill (Step 5)
## Prerequisites
From previous skills, you need:
- ✅ HTML file at correct path (from generate-import-html)
- ✅ Images folder in same directory
- ✅ screenshot.png from scrape-webpage (for comparison)
- ✅ documentPath from metadata.json (for URL construction)
## Related Skills
- **page-import** - Orchestrator that invokes this skill
- **generate-import-html** - Provides HTML file to preview
- **scrape-webpage** - Provides screenshot for comparison
## Preview Workflow
### Step 1: Start Development Server with HTML Folder Flag
**Determine the folder from metadata.json:**
- Look at `paths.dirPath` from metadata.json (e.g., `/us`)
- This is the root folder containing your imported HTML file
**Command:**
```bash
aem up --html-folder {dirPath}
```
**Examples based on imported content location:**
| HTML File Location | Command | Preview URL |
|-------------------|---------|-------------|
| `us/en.plain.html` | `aem up --html-folder us` | `http://localhost:3000/us/en` |
| `products/widget.plain.html` | `aem up --html-folder products` | `http://localhost:3000/products/widget` |
| `blog/2024/post.plain.html` | `aem up --html-folder blog` | `http://localhost:3000/blog/2024/post` |
**Why this is required:**
- Without `--html-folder`, AEM CLI proxies requests to the remote server
- The remote server doesn't have your locally imported content
- Result: 404 "Page not found" errors
---
### Step 2: Navigate in Browser
**For most files, use the document path directly:**
```
http://localhost:3000${documentPath}
```
Example:
- HTML file: `us/en/about.plain.html`
- URL: `http://localhost:3000/us/en/about`
**IMPORTANT: For index files, use `/` instead of `/index`:**
```
If file is: index.plain.html
Preview at: http://localhost:3000/
NOT: http://localhost:3000/index
```
**Note:** If you used `--html-folder` flag (e.g., `aem up --html-folder drafts`), prepend that folder to the URL:
```
File: drafts/test.plain.html
URL: http://localhost:3000/drafts/test
```
Use `paths.documentPath` from metadata.json, but for index files ensure the path is `/` not `/index`
---
### Step 3: Verify Rendering
**Check the following:**
- ✅ Blocks render with correct styling
- ✅ Layout matches original page structure (compare to screenshot.png)
- ✅ Images load (or show appropriate placeholders)
- ✅ No raw HTML visible
- ✅ Metadata appears in page source (view source, check `<meta>` tags)
- ✅ Section styling applied correctly
---
### Step 4: Compare with Original
**Side-by-side comparison:**
1. Open `./import-work/screenshot.png` alongside browser preview
2. Check that content structure matches
3. Verify blocks decorated correctly
4. Confirm section boundaries align
5. Validate styling consistency
---
## Troubleshooting
**Blocks don't render correctly:**
- Check HTML structure matches expected format
- Verify block names match exactly (case-sensitive)
- Review [../content-driven-development/references/html-structure.md](../content-driven-development/references/html-structure.md) for format guidance
**Images not loading:**
- Verify images folder is in same directory as HTML file
- Check image paths are `./images/...` format
- Ensure images were copied correctly from `./import-work/images/`
**Raw HTML visible:**
- Block name might not match existing block in project
- Check browser console for JavaScript errors
- Verify block exists in `blocks/` directory
**Metadata not in page source:**
- Check metadata block is at end of HTML file
- View page source and search for `<meta>` tags in `<head>`
- Verify metadata properties match expected format
**Dev server not running:**
- Start server with `aem up`
- Check for port conflicts (default 3000)
- Verify you're in correct project directory
**Page not found (404):**
- **Most common cause:** Missing `--html-folder` flag - restart server with `aem up --html-folder {dirPath}`
- Verify HTML file exists at expected path
- Check documentPath from metadata.json matches URL
- For index files, use `/` not `/index`
- Check terminal output confirms "Serving HTML files from folder: {folder}"
---
## Output
This skill provides:
- ✅ Verified preview that matches original page structure
- ✅ Visual confirmation of correct rendering
- ✅ Validated block decoration
- ✅ Confirmed metadata presence
**Import complete when all verification points pass.**
Pliki w paczce (4)
- .releaserc.json 1 KB
- CHANGELOG.md 1 KB
- SKILL.md 5 KB
- package.json 1 KB
Wersje
W bazie nie ma innych skilli o nazwie preview-import.
Migawka bazy z 13.11.2026 · wersja paczki 353e021a396f (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 89code-review
Przegląda kod AEM Edge Delivery Services pod kątem struktury bloków, wzorców CSS i JS, wydajności Lighthouse oraz dostępności i publikuje uwagi jako komentarze w pull requeście. - 100aem-cli
Pomaga instalować, uruchamiać i konfigurować Adobe AEM CLI (dawniej helix-cli): aem up, import, content, lokalny serwer Edge Delivery, zmienne AEM_*, HTTPS oraz naprawę błędów aem up. - 90Code Review
Przegląda kod projektów AEM Edge Delivery Services przed commitem lub w pull requestach, z sugestiami zmian w GitHub. - 100aem-fe-verify
Weryfikuje wizualnie renderowanie komponentu na lokalnym AEM względem projektu w Figmie lub wymagań i w pętli poprawia znalezione rozbieżności. - 100experience-lwc-runtime-observe
Uruchamia Salesforce Lightning Preview dla aplikacji lub pojedynczego komponentu LWC i wyciąga runtime'owy DOM do inspekcji, także shadow DOM i faktycznie wyrenderowany HTML. - 100local-dev
Pomaga w konfiguracji lokalnego środowiska deweloperskiego i jego poleceniach: serwer deweloperski, Docker i testy lokalne.