브랜드 출시
모든 출시 영화는 brand/brand.json에서 스타일을 읽어옵니다. 이 스킬은 독자의 웹사이트에서 해당 파일을 생성하고, 검증한 후 launch-film에 전달합니다. 브랜드당 한 번 실행하고, 사이트 스타일이 변경되면 다시 실행하세요.
1. 추출
npm install # 최초 1회: puppeteer 및 해당 Chrome
node tools/brand-from-url.mjs https://your-site.com --out brand
1920x1080 해상도로 페이지를 열고, 쿠키 배너를 닫고, 지연 로딩 콘텐츠를 위해 한 번 스크롤한 후 다음 파일들을 작성합니다:
| 파일 | 설명 |
|---|---|
brand.json | 영화에서 사용하는 역할(role)들입니다. 영화가 읽는 유일한 파일입니다. |
evidence.json | 각 역할이 결정된 근거: 계산된 스타일, CSS 색상 변수, 픽셀 히스토그램, 버튼 및 링크 색상, 글꼴, 모든 로고 후보(점수 및 사유 포함). |
logo.svg 또는 logo.png | 밝은 배경용 로고입니다. 어두운 배경용은 logo-on-dark.*, 아이콘만 분리 가능한 경우 mark.svg입니다. |
fonts/ | 페이지에서 실제로 로드한 디스플레이 및 본문 글꼴 파일입니다(페이지가 제공하지 않는 Google Fonts는 css2 API에서 가져옵니다). |
screens/hero.png, screens/full.png | 첫 번째 뷰포트와 전체 페이지(최대 6000px)입니다. |
images/ | 가장 큰 콘텐츠 이미지(보통 제품 사진)입니다. |
preview.png | 한 장의 시트: 밝은 배경 및 어두운 배경의 로고, 모든 색상 역할, 하이라이트가 있는 디스플레이 글꼴, 어두운 히어로 카드, 강조 버튼. |
플래그: --no-fonts는 글꼴 파일을 건너뛰고, --max-images 0은 이미지를 건너뜁니다. 로컬 페이지도 작동합니다
(node tools/brand-from-url.mjs ./site/index.html). brand.json을 수동으로 편집한 후, node tools/brand-from-url.mjs --preview --out brand로 시트를 다시 렌더링하세요.
2. 검토 (절대 건너뛰지 마세요)
preview.png와 screens/hero.png를 나란히 읽으세요. 역할들은 휴리스틱(heuristics)입니다. 시트는 10초 안에 올바르게 선택되었는지 보여줍니다. 다음 순서로 확인하세요:
- 밝은 배경 및 어두운 배경의 로고. 둘 다 읽을 수 있어야 합니다. 어두운 배경에서 사라지는 로고는 밝은 버전이 필요합니다: 독자에게 파일을 요청하거나
logo-on-dark.svg내부의 색상을 편집하세요. - 강조(Accent). 사람들이 브랜드와 연관 짓는 색상(보통 메인 버튼)이어야 합니다.
evidence.json에는accent_candidates가 득표수와 함께 나열됩니다. 히어로 일러스트레이션 색상이나 상태 색상을 선택한 경우 올바른 16진수 코드로 교체하세요. - 배경(Ground) 및 잉크(Ink). 성명(statement) 장면은
ground위에ink타입으로 표시됩니다. 사이트의 느낌(따뜻한 오프화이트, 순백색, 색조 종이)과 일치해야 합니다. - 어두움(Dark). 히어로 카드는
dark를 사용합니다. 브랜드 자체의 어두운 섹션처럼 보여야 하며, 임의의 거의 검은색이 아니어야 합니다. 사이트에 어두운 섹션이 없으면 도구가 강조 색상을 어둡게 합니다. 의도된 것처럼 보이는지 확인하세요. - 글꼴. 디스플레이 글꼴이 시트의 히어로 단어에서 렌더링되어야 합니다.
evidence.json의fonts아래에서 찾은 파일을 보여줍니다. - 이름 및 태그라인. 태그라인은 잠금(lockup)에서 이름 아래에 위치합니다: 2~8 단어, 사이트 자체의 단어입니다.
잘못된 값을 brand.json에 직접 수정하고, 미리보기를 다시 렌더링한 후 독자에게 보여주고, 그때서야 "reviewed": true로 설정하세요. 수동으로 변경한 모든 내용을 답변에 한 줄로 기록하세요.
각 역할이 영화에서 하는 일
| 역할 | 용도 |
|---|---|
ground | 모든 성명 장면, 제품 둘러보기의 바닥, 종료 잠금. |
surface | 배경 위의 카드, 칩 및 창. |
ink, ink_secondary | 밝은 배경 위의 히어로 단어 및 보조 단어. |
accent | 드물게 사용: 장면당 1개 요소(버튼 누름, 스위치, 완료 상태). 요청사항에 강조 히어로 카드가 없는 한 절대 전체 배경으로 사용하지 마세요. |
accent_ink | 강조 색상 위의 텍스트. |
dark, dark_ink | 하드 컷 히어로 카드, 어두운 순간. |
accent_on_dark | 어두운 카드의 핵심 단어(읽을 수 있을 때까지 밝아진 강조 색상; 단색 브랜드의 경우 dark_ink). |
highlight | 줄당 1~2개의 핵심 단어 뒤에 있는 부드러운 마커. 절대 더 많이 사용하지 마세요. |
success, danger | 체크 표시, 완료 상태, 드문 실패 단어. |
fonts.display | 히어로 단어(사이트 h1의 두께 및 자간). |
fonts.body | 보조 라인, UI 칩. |
logo, name, tagline, domain | 컷의 이름 비트와 종료 잠금. |
copy | 스크립트 단어. 영화는 사이트의 언어를 사용합니다. launch-story는 copy.h1, copy.subhead, copy.h2 및 copy.features에서 시작합니다. |
images | 후보 제품 사진. 독자의 실제 제품 화면 또는 녹화본이 스크랩된 어떤 것보다 낫습니다. |
대체(Fallback)
- 로고를 찾을 수 없음. 도구가 사이트 아이콘으로 대체하고 그렇게 말합니다. 독자에게 SVG(가장 좋음) 또는 1000px 이상의 투명 PNG를 요청하세요.
brand/에 넣고logo.file이 이를 가리키도록 하세요. - 다크 모드 사이트.
mode는dark입니다. 페이지 배경색이dark가 되고,ground와ink는 밝은 성명 장면을 위해 파생됩니다. 브랜드가 어두운 성명 장면도 원하는 경우ground와dark(그리고ink와dark_ink)를 수동으로 바꾸세요. - 단색(Monochrome) 브랜드. 채도가 있는 색상이 득표를 얻지 못했으므로
accent는 메인 버튼 색상(종종 검은색)이고highlight는 밝은 회색입니다. 독자에게 시그니처 색상이 있는지 물어보세요. 없으면 단색을 유지하고 타입과 모션이 영화를 이끌도록 하세요. - 웹 글꼴을 다운로드할 수 없음. 일부 파운드리(글꼴 제작사)는 직접 다운로드를 차단합니다. 글꼴을 로컬에 설치하거나(영화는 패밀리 이름으로 설치된 글꼴로 대체됨) Google Fonts에서 가장 가까운 오픈 글꼴을 선택해
brand/fonts/에 파일을 넣으세요. - 글꼴 라이선스. 웹 라이선스가 항상 비디오를 포함하지는 않습니다. 영화를 출시하기 전에 디스플레이 및 본문 글꼴이 비디오 또는 모션 사용에 대해 라이선스가 부여되었는지 확인하거나 오픈(OFL) 글꼴을 사용하세요.
- 독자에게 브랜드 가이드가 있음. 독자의 가이드가 우선입니다. 해당 값을
brand.json에 수동으로 입력하고(동일한 키 유지), 로고 파일을brand/에 넣고, 미리보기를 다시 렌더링한 후 검토됨으로 표시하세요. - 사이트가 헤드리스 브라우저를 차단함. 일반 브라우저에서 페이지를 저장하고(파일, 다른 이름으로 페이지 저장, 완료) 저장된 HTML 파일에 도구를 실행하세요.
인계(Hand-off)
launch-film은 빌드 시 brand/brand.json을 읽습니다. "reviewed": false로 빌드된 영화는 초안입니다. 보여줄 때 그렇게 말하세요.