랜딩 페이지 빌드은(는) 무엇을 하나요?
승인된 카피, 비주얼 방향 및 디자인 토큰을 JavaScript가 비활성화된 상태에서도 완전한 정적 페이지로 전환합니다. 완전함이란 방문자가 모든 섹션을 읽고, 헤더에서 모든 섹션에 도달할 수 있으며, 폼을 전송할 수 있음을 의미합니다. 모션과 3D는 landing-skills:landing-motion에서 이후에 추가되며, 이미 작동하는 페이지 위에 구축됩니다.
이 스킬 없이 만든 여러 테스트 빌드에서 두 가지 버그가 발견되었으며, 이 스킬은 두 버그를 모두 불가능하게 만듭니다:
padding단축 속성을 가진 컨테이너 클래스가 섹션의 수직 패딩을 덮어써서 모든 섹션이 서로 붙어버렸습니다. 해결책은 구조적입니다: 섹션이 블록 축을 소유하고, 컨테이너가 인라인 축을 소유하며, 둘 다 단축 속성을 사용하지 않습니다(5단계).- 데드 폼:
action="#",onsubmit="return false"또는 "감사합니다"를 표시하고 데이터를 버리는 스크립트. 해결책: 실제action, 실제method, 서버 기반 성공 페이지, 그리고 페이지가 백업할 수 없는 성공 메시지는 없습니다(8단계).
입력
코드를 작성하기 전에 사용자의 프로젝트에서 다음을 읽어옵니다.
| 파일 | 가져올 내용 |
|---|---|
landing/brief.md | landing-skills:landing-page가 작성하는 필드. 사용할 항목: 언어(lang용); 전환 액션(필드와 엔드포인트가 있는 폼 또는 아직 없음, 또는 외부 URL); 스택(명시된 대로 또는 detect); 도메인(프로덕션 도메인 또는 unknown); 연락처 경로(푸터와 /form-error/용); 사용 가능한 에셋 |
landing/copy.md | 페이지 순서대로 페이지 섹션당 하나의 H2; 마지막 H2인 Placeholders는 모든 갭을 나열 |
landing/direction.md | 출처와 라이선스가 있는 서체, 각 섹션의 레이아웃 행, 가로세로비가 포함된 이미지, 표면, 마지막 H2 Motion and 3D intent |
landing/tokens.css | 사용자 정의 속성: --color-*, --font-*, --text-*, --space-*, --radius-* |
입력이 누락된 경우:
copy.md없음: 직접 마케팅 카피를 작성하지 마세요. 사용자에게 텍스트를 요청하거나landing-skills:landing-copy를 제안하세요. 사용자가 텍스트를 제공하면 그대로 사용하세요. 증거를 절대 만들어 내지 마세요: 사용 후기, 로고, 카운트 또는 평점 없음. 누락된 부분은[PLACEHOLDER: 필요한 것]이 됩니다.direction.md또는tokens.css없음: 먼저landing-skills:landing-art-direction을 제안하세요. 사용자가 계속 진행하려면 직접landing/tokens.css를 5개의 접두사로 작성하고, 사용자가 제공하는 브랜드 제약 조건에서 값을 도출한 후, 이 토큰이 임시임을 사용자에게 알려주세요.brief.md없음: 언어, 전환 액션(폼과 게시할 위치, 또는 외부 URL), 프로덕션 도메인 및 연락처 경로를 요청하세요.unknown또는none yet이라고 명시된 brief 필드는 오류가 아닌 갭입니다: 이 스킬이 제공하는 규칙(도메인 없는 URL 태그 없음, 엔드포인트 없는/api/lead자리 표시자, 연락처 경로 없는 자리 표시자 연락처 라인)으로 빌드하고 핸드오프에 나열하세요. 프로젝트 파일에서 스택을 감지하세요("스택 감지" 참조). 가능할 때 묻지 마세요.
프로세스
1. 스택 감지
"스택 감지"의 표를 사용하세요. 파일을 작성하기 전에 references/adapters.md의 해당 섹션을 읽으세요. 다른 참조의 일반 레시피와 다른 점만 다룹니다.
2. 인벤토리 만들기
마크업 전에 다음을 기록하세요:
copy.md의 각 H2와 그것이 되는<section>, 그리고id.tokens.css의 모든 토큰 이름. 색상, 서체, 간격 및 반경에 대해 이 이름들만 사용하고 다른 것은 사용하지 않습니다.- direction이 요청하는 각 이미지, 가로세로비, 파일 존재 여부.
- brief의 전환 액션: 외부 URL(링크, 폼 없음), 또는 필드와 엔드포인트가 있는 폼. 엔드포인트가
none yet인 경우 폼은/api/lead로 게시되며 그 갭은 핸드오프(11단계)에 포함됩니다. - 도메인(알려짐 또는
unknown) 및 연락처 경로. head, 푸터 및/form-error/에 필요합니다.
3. head 작성
제목, 설명, 표준(캐노니컬), Open Graph 및 소셜 카드, 파비콘 세트, theme-color, lang, 구조화된 데이터. 템플릿과 규칙은 references/seo-meta.md에 있습니다. copy.md에서 제목과 설명을 작성하세요; 프레임워크의 시작 제목과 같은 기본 제목은 신호입니다.
4. 폰트 로드
direction에 명명된 WOFF2 파일을 자체 호스팅하고, tokens.css의 스택과 정확히 일치하는 패밀리 이름으로 @font-face를 선언하고, 미터법 일치 대체를 추가하고, 접힌 부분 위에서 사용되는 하나 또는 두 개의 파일만 미리 로드하세요. references/performance.md에 레시피와 대체 값을 계산하는 테스트된 스크립트가 있습니다. 폰트를 지정하고 로드하지 않거나 system-ui로 폴백되는 페이지는 모든 기기에서 다르게 렌더링됩니다.
5. 레이아웃 스켈레톤 구축
페이지의 모든 밴드는 하나의 <div class="container">를 내부에 가진 <section class="section">입니다. 둘은 절대 역할을 공유하지 않습니다:
/* 섹션은 수직 리듬을 소유하고, 컨테이너는 너비와 거터를 소유합니다. */
.section { padding-block: var(--space-section-open); }
.container {
inline-size: min(100% - 2 * var(--space-gutter), var(--space-content-max));
margin-inline: auto;
}
위의 토큰 이름은 예시입니다. tokens.css의 이름을 사용하세요. references/css.md는 레시피가 가정하는 모든 토큰 역할과 파일에 해당 토큰이 없을 때 해야 할 일을 나열합니다.
컨테이너는 패딩을 전혀 설정하지 않으므로, 어떤 규칙 순서나 특수성도 섹션의 간격을 지울 수 없습니다. 섹션이나 컨테이너 클래스에 padding 또는 margin 단축 속성을 절대 작성하지 마세요: 단축 속성은 두 축을 모두 설정하고 다른 클래스가 설정한 축을 조용히 대체합니다. 이것이 버그 1을 제거하는 규칙입니다. references/css.md에는 이 버전 옆에 깨진 버전과 전체 너비 및 가는 선 케이스가 나와 있습니다.
6. 섹션 구축
- 시맨틱 요소 사용:
header,nav,main,section,footer, 단계에는ol, 사양에는dl또는table, 캡션이 있는 미디어에는figure. - 하나의
h1, 히어로에 위치. 각 섹션은copy.md에서 가져온h2로 시작합니다. 레벨을 건너뛰지 마세요. direction.md의 행에 따라 각 섹션을 배치하세요. direction이 모양을 열어둔 경우references/css.md의 레시피에서 선택하세요; 블록의 수와 모양은 콘텐츠를 따르므로, 세 개의 동일한 카드는 콘텐츠가 세 개의 동일한 것일 때만 나타납니다.- 모든 색상, 폰트, 크기, 간격 및 반경에 대해 토큰을 사용하세요. 페이지 CSS에서 토큰을 재선언하지 마세요. 필요한 값에 토큰이 없으면 토큰으로 구성하고(
calc(),color-mix()) 핸드오프에 나열하여 direction이 추가할 수 있도록 하세요. clamp()를 사용한 유동 크기, 논리적 속성,references/css.md의 폴백이 있는oklch()색상, 자체 너비에 따라 모양이 변하는 컴포넌트에 대한 컨테이너 쿼리를 사용하세요.
7. 미디어 배치
실제 이미지는 width와 height, 내용을 설명하는 alt 텍스트, 폴백이 있는 최신 형식, 히어로 이미지만 fetchpriority="high"를 가집니다(references/performance.md). 아직 존재하지 않는 에셋은 최종 가로세로비에 표시되는 보이는 레이블이 지정된 자리 표시자 상자가 되며, [PLACEHOLDER: photo, the workshop bench from above, 3:2]와 같은 텍스트를 포함합니다. 상자에 role="img"를 부여하지 마세요: 존재하지 않는 사진을 알리게 됩니다. 각 자리 표시자에 direction이 해당 이미지에 부여한 비율, 너비 및 배경을 제공하여 프레임이 동일한 점선 상자 행이 아닌 계획된 레이아웃을 표시하도록 하세요(references/css.md, 미디어 자리 표시자). 가짜 제품 화면을 그려 제품으로 제시하지 마세요.
8. 전환 액션 구축
brief의 전환 액션이 무엇을 구축할지 결정합니다:
- 외부 URL (체크아웃, 예약 페이지, 앱 스토어): 액션은 링크이며,
copy.md의 레이블과 함께<a class="button" href="https://...">입니다. 폼,form.js,/thanks/또는/form-error/페이지는 없습니다. 이 단계의 나머지는 건너뜁니다. brief가 클릭이 계산되어야 한다고 말하면landing-skills:landing-launch가 비콘을 추가합니다. - 사용자가 이미 가지고 있는 엔드포인트가 있는 폼: 폼은 해당 URL로 게시되며
/api/lead자리 표시자는 사용되지 않습니다. 엔드포인트가 결과 페이지로 리디렉션하는 경우에만 결과 페이지를 구축하세요. 그렇지 않으면 핸드오프에서 엔드포인트가 방문자를 보내는 위치를 말하세요. - 엔드포인트가
none yet인 폼: 폼은 자리 표시자/api/lead로 게시되며,landing-skills:landing-launch가 Worker로 구축합니다.
폼의 경우 references/forms-a11y.md를 읽으세요. 절대 타협할 수 없는 부분:
<form action="..." method="post">brief의 엔드포인트 사용, 또는action="/api/lead"와 함께 아직 엔드포인트가 존재하지 않는다는 HTML 주석을 옆에 추가하고 핸드오프에 나열.- 모든 필드에는
name, 보이는<label>, 올바른type및autocomplete, 형식을 설명해야 할 때aria-describedby로 연결된 힌트가 있습니다. - JavaScript 없이 브라우저가 폼을 게시하고 엔드포인트가 지금 구축하는 두 정적 페이지 중 하나로
303리디렉션으로 응답합니다:/thanks/및/form-error/.landing-skills:landing-launch가 Turnstile을 추가하면 JavaScript 없는 방문자는 토큰이 없어 항상/form-error/에 도달하므로, 해당 페이지는 brief의 연락처 경로에서 가져온 다른 연락 방법을 제공해야 합니다. - 항상
references/forms-a11y.md의form.js를 점진적 향상으로 제공하세요. 폼은 그것 없이도 작동합니다. 하지만 파일은 여전히 빌드의 일부입니다.landing-skills:landing-motion이 설정하는 상태를 확장하고landing-skills:landing-launch가 이를 확인하기 때문입니다. 응답이 2xx이고 JSON 본문이ok: true라고 말할 때만 성공을 표시합니다. 2xx만으로는 무언가가 응답했다는 것만 증명합니다:fetch는 리디렉션을 따르고 도착한 페이지를 200으로 보고하며, 정적 호스트는 일반 HTML 페이지로 POST에 응답할 수 있습니다. 두 경우 모두 테스트에서 발생했으며 둘 다 실패입니다. 실패 시 스크립트는 실패를 알리고 방문자가 입력한 내용을 유지합니다. 서버가 확인하기 전에 폼을 재설정하거나 "감사합니다"를 표시하지 마세요.
9. 접근성 최소 요구 사항 충족
건너뛰기 링크, 랜드마크, 링크가 실제 섹션 id를 가리키는 nav, /에 연결되는 로고, 모든 대화형 요소에 보이는 포커스 스타일, 최소 44x44px 대상, 페이지가 실제로 렌더링하는 모든 텍스트 및 배경 쌍의 대비 확인: 각 표면의 본문 텍스트, 캡션, 힌트, 자리 표시자 텍스트, 강조 색상의 텍스트. 세부 사항 및 숫자는 references/forms-a11y.md에 있습니다. 대체 없이 휴대폰에서 링크를 숨기는 탐색은 이 요구 사항을 충족하지 못합니다. 대신 링크가 줄 바꿈되도록 하세요.
10. 모션 제외
움직임 감소 설정에서 줄어드는 것은 움직임이며 피드백이 아닙니다. 따라서 전환을 0으로 설정하는 전역 규칙을 작성하지 마세요. 모든 요소를 최종 보이는 상태로 구축하세요. 진입 애니메이션, 스크립트를 기다리는 opacity: 0, 스크롤 라이브러리는 없습니다.
direction의 Motion and 3D intent에 명명된 모든 순간에 대해 대체물을 남겨두세요: 해당 순간의 최종 크기와 가로세로비의 정적 포스터 이미지 또는 레이블이 지정된 자리 표시자. landing-skills:landing-motion이 실제 것을 마운트할 때 레이아웃이 변경되지 않도록 합니다. data-moment="<name>"으로 표시하고, direction이 해당 순간에 부여한 짧은 이름을 사용하세요. 모션은 해당 속성으로 대상을 찾습니다. 대체물은 모션 없이 완전합니다: alt 텍스트가 있는 실제 이미지 또는 순간이 보여주는 내용을 말하는 자리 표시자 텍스트.
<div class="hero__media" data-moment="exploded-view">
<img src="/img/exploded-poster.jpg" width="1600" height="1000" alt="장치의 레이어가 분리됨: 케이스, 보드, 배터리, 렌즈">
</div>
의도가 none인 경우 data-moment 요소를 추가하지 마세요.
11. 확인 및 인계
"Definition of done"을 실행하세요. 그런 다음 사용자에게 짧은 목록으로 알려주세요:
- 구축된 내용과 위치(파일, 출력 폴더),
detect였다면 brief의 스택 필드에 기록된 해결된 스택, - 페이지에 여전히 있는 모든
[PLACEHOLDER: ...]및 제공해야 할 모든 에셋, - 구축된 전환 액션: 외부 URL에 대한 링크, 사용자 엔드포인트로 게시하는 폼, 또는 아직 존재하지 않는
/api/lead로 게시하는 폼, - 폼이 제출하는 모든 필드, 각 줄:
name, 유형(email,tel,text,textarea),required여부, 마크업의maxlength.landing-skills:landing-launch는 이 목록에서 Worker의 유효성 검사, 길이 제한, 스토리지 및 요청 크기 제한을 설정하고 알리지 않은 필드는 거부합니다. - 토큰이 없어 구성된 값과
tokens.css에 누락된 모든 선택적 토큰과 레시피가 사용한 대체 값, - brief가
unknown이라고 말하는 프로덕션 도메인과 그로 인해 생략된 URL 태그(표준,og:url,og:image, 사이트맵), - brief가
unknown으로 남긴 연락처 경로로, 푸터와/form-error/가 자리 표시자로 표시함, - 서브셋되지 않은 모든 폰트 파일과 바이트 단위 크기,
- 실행되지 않은 모든 "Definition of done" 검사와 이유와 함께 "실행되지 않음"으로 표시,
Motion and 3D intent의 각 순간:data-moment이름과 대체물이 있는 위치(섹션 및 요소), 또는 의도가none인 경우 "없음",- 다음 스킬: direction의
Motion and 3D intent가 순간을 명명한 경우landing-skills:landing-motion, 그런 다음landing-skills:landing-review, 그런 다음 호스팅 및 폼 엔드포인트를 위한landing-skills:landing-launch.
스택 감지
프로젝트 루트를 다음 순서로 확인하고 첫 번째 일치 항목에서 중지하세요. 프로젝트 폴더가 비어 있을 때 brief.md의 Stack 필드가 결정합니다.
스택이 해결되면 다시 작성하세요: brief의 Stack 필드가 detect라고 말하면 해당 한 단어를 해결된 스택(예: Astro 또는 plain HTML and CSS)으로 바꾸고 landing/brief.md의 다른 내용은 변경하지 마세요. 이후 스킬은 필드를 읽고 해결되지 않은 단어를 만나서는 안 됩니다. 사용자가 명명한 스택은 그대로 유지됩니다. landing/brief.md가 없으면 생성하지 마세요.
| 프로젝트의 신호 | 스택 | 어댑터 섹션 |
|---|---|---|
astro.config.mjs (또는 .ts, .js), 또는 package.json 종속성에 astro | Astro | Astro |
…
[번역을 위해 잘림]
