# Internal Linking Quick Reference

**Last Updated:** 2026-03-03

Quick reference for internal linking during content creation and improvement.

## When to Add Links

### During Content Writing

**Add links naturally as you write:**
- First mention of lexikon topic → Link to lexikon post
- Industry mentioned → Link to industry page
- Calculable topic → Link to tool
- Solution discussed → Link to product page

**Don't force links** - only link where topics appear naturally.

## Quick Commands

### New Posts (After Content Draft)

```bash
# 1. Generate suggestions
php v2/scripts/blog/suggest-contextual-links.php --post={slug} --category={category}
php v2/scripts/blog/suggest-ordio-feature.php --post={slug} --category={category}

# 2. Review data/suggested-contextual-links.json
# 3. Add links to content-draft.html
# 4. Sync to JSON
php v2/scripts/blog/update-post-content.php --post={slug} --category={category} --html=docs/content/blog/posts/{category}/{slug}/content-draft.html

# 5. Validate
php v2/scripts/blog/audit-blog-lexikon-links.php --post={slug} --category={category}
php v2/scripts/blog/audit-blog-tool-links.php --post={slug} --category={category}
php v2/scripts/blog/audit-blog-industry-links.php --post={slug} --category={category}
```

### Content Improvements

```bash
# Same as new posts - run after expansion
php v2/scripts/blog/suggest-contextual-links.php --post={slug} --category={category}
# Review, add links, validate
```

### Content Blocks (Templates)

```bash
php v2/scripts/templates/suggest-template-contextual-links.php --template={id}
php v2/scripts/templates/validate-template-internal-links.php --template={id}
```

## Link Type Quick Guide

| Link Type | When | How Many | Anchor Text |
|-----------|------|----------|-------------|
| **Lexikon** | Topic mentioned with dedicated post | First mention | Topic name |
| **Industry** | Industry mentioned | 1 per industry | Industry name |
| **Tool** | Calculable topic discussed | 1-2 max | "kostenloser X-Rechner" |
| **Product** | Solution/problem matches feature | 1-2 max | "Schichtplanung mit Ordio" |

## Quality Checklist

- ✅ Natural anchor text (fits grammatically)
- ✅ First meaningful mention (not forced)
- ✅ Complete words only (no partial-word links)
- ✅ Varied anchor text (don't repeat >3 times)
- ✅ Not right after section titles
- ✅ Not at end of paragraph (unless conclusion)

## Common Mistakes

❌ **Forced phrases:** "Mehr dazu im Lexikon X"  
✅ **Natural:** Link term where it appears

❌ **Generic anchor:** "mehr zu dienstplan"  
✅ **Descriptive:** "Dienstplan erstellen"

❌ **Link dump:** List of links at end  
✅ **Integrated:** Links naturally in content flow

## Mapping Files

- **Lexikon posts:** `docs/content/blog/lexikon-inventory/LEXIKON_INVENTORY_REPORT.md`
- **Tool mapping:** `docs/data/blog-tool-mapping.json`
- **Industry mapping:** `docs/data/blog-industry-mapping.json`
- **Product mapping:** `docs/data/blog-product-feature-mapping.json`

## Full Documentation

- [INTERNAL_LINKING_WORKFLOW_2026.md](INTERNAL_LINKING_WORKFLOW_2026.md) - Complete workflow
- [INTERNAL_LINKING_GUIDE.md](guides/INTERNAL_LINKING_GUIDE.md) - Detailed guide
- [NEW_POST_LINKING_CHECKLIST.md](NEW_POST_LINKING_CHECKLIST.md) - New post checklist