typo3-typoscript-ref（typo3 打字稿参考）

TYPO3 TypoScript, TSconfig and Fluid Reference

Version-aware local lookup with always-on best practices.

Usage

scripts/lookup.sh "stdWrap wrap"              # Reference lookup
scripts/lookup.sh "PAGEVIEW" --with-fluid     # With Fluid context
scripts/lookup.sh --recipe page-setup         # Recipe for common tasks
scripts/lookup.sh "FLUIDTEMPLATE" --review    # Adds deprecation warnings
scripts/lookup.sh --deprecations              # Deprecation list
scripts/lookup.sh --checklist typoscript      # Review checklist (typoscript|tsconfig|fluid)
scripts/lookup.sh --lint-rules                # Project lint rules
scripts/lookup.sh --debug "The page is not configured"  # Debug error
scripts/lookup.sh --update                    # Update cache
scripts/lookup.sh "TEXT" --version 12         # Override version

Rules

1. ALWAYS run lookup.sh before writing or reviewing TypoScript/TSconfig/Fluid code
2. ALWAYS follow best practice annotations (required/deprecated/recommended/tip)
3. ALWAYS check project lint rules (--lint-rules) before writing TypoScript
4. When writing NEW code: use the most modern approach for the detected version
5. When reviewing EXISTING code: flag deprecated patterns, check --deprecations for the project's version
6. For combined TypoScript+Fluid tasks: use --with-fluid flag
7. Never generate config.no_cache = 1 in production setups
8. Prefer DataProcessors over CONTENT cObject in Fluid-based templates

Version-Specific Guidance

• v12: Use FLUIDTEMPLATE, sys_template static includes, constants.typoscript
• v13: Prefer PAGEVIEW for new page templates, introduce Site Sets, use settings.definitions.yaml
• v14: Site Sets mandatory, FLUIDTEMPLATE deprecated, @import replaces INCLUDE_TYPOSCRIPT

When answering version-specific questions, always consult references/review/deprecations.md and the relevant migration guide (migration-v12-to-v13.md or migration-v13-to-v14.md).

Review Workflow

When reviewing TypoScript/TSconfig/Fluid code:

1. Run --checklist for the file type (typoscript, tsconfig, or fluid)
2. Run --deprecations filtered to project version
3. Cross-reference references/review/common-mistakes.md for known pitfalls
4. Check references/review/security.md for Fluid XSS patterns (f:format.raw, f:sanitize.html)
5. Check references/review/performance.md for COA_INT/USER_INT overuse
6. Use --review flag on keyword lookups to append deprecation context

Reference Index

First Run

scripts/lookup.sh --update