워크스페이스 랜딩 페이지 편집기은(는) 무엇을 하나요?
워크스페이스 랜딩 페이지(/w/:slug에서 렌더링됨)는 workspace.landing_page_html에 저장된 단일 자체 포함 HTML 블롭입니다. brief가 제출될 때마다 서버 측 LANDING_PAGE_PROMPT에 의해 처음부터 생성됩니다. 이 경로는 HTML을 완전히 덮어씁니다.
전체 페이지를 다시 생성하지 않아야 하는 변경(예: 타이포그래피 조정, 레이아웃 편집, 섹션 추가, 카피 변경, 이미지 교체, 태그라인 수정)에는 HTML을 직접 편집하고 다시 작성하세요. 사용자가 전체 재생성을 원하지 않는 한 brief를 보내지 마십시오.
모든 명령은 astria CLI(astria-api 스킬 참조)를 사용합니다. -w <workspace_id>를 전달하여 워크스페이스를 대상으로 지정하세요.
LANDING_PAGE_PROMPT에서 이월된 제약 조건
편집 시 다음 불변 조건을 유지하세요. (실시간 /w/:slug 페이지가 이에 의존합니다):
- 출력은 내부 body HTML입니다.
<html>,<head>,<body>또는<!DOCTYPE>태그가 없습니다. - 스타일링은 Tailwind 유틸리티 클래스를 사용합니다(이미 페이지에 로드됨). Tailwind가 표현할 수 없는 호버/애니메이션 효과에만
<style>을 사용하세요. - 팩 링크는 정확히
/p/{slug}입니다. 모델/참조 링크는 tunes JSON의link필드를 그대로 사용합니다(%5B/%5D를 다시 인코딩하지 마십시오). - 모든 이미지/비디오는
<a>태그로 감싸져 있습니다. - 이미지 및 비디오 URL은 이미 존재하는 URL이어야 합니다. URL을 임의로 만들지 마십시오.
- 비디오는
<video autoplay muted loop playsinline poster="POSTER_URL"><source src="VIDEO_URL" type="video/mp4"></video>를 사용합니다. <script type="application/json" id="tunes-data">…</script>내부의 문자열__TUNES_JSON_PAYLOAD__는 서버 측 플레이스홀더입니다. 서버는 렌더링 시점에 이를 실시간 tunes JSON으로 대체합니다. 리터럴 JSON으로 절대 대체하지 마십시오. 그렇게 하면 캐스트가 고정되어 새로 추가된 tunes가 나타나지 않습니다.- 편집 스타일링: 세리프 헤드라인, 넉넉한 공백, 가는 구분선, 인물 이미지에
object-cover object-[center_top], 히어로 스프레드에max-h-[70vh], 인물 컨테이너에aspect-[4/5]또는aspect-[3/4]를 사용합니다.
워크플로우
1. 현재 랜딩 페이지 HTML 가져오기
astria landing get -w <workspace_id> --html > /tmp/landing_page.html
astria landing get -w <workspace_id> (--html 없이)는 전체 워크스페이스 JSON(title, slug, brief, url, public_at, unlisted_at)을 반환합니다. 이 값들이 필요할 때 사용합니다. 렌더링된 페이지는 /w/{slug}에서 미리보기 할 수 있습니다.
2. 워크스페이스 데이터 가져오기(편집 시 실제 팩/프롬프트/tunes를 참조해야 하는 경우)
astria packs list -w <workspace_id> --limit 100
astria tunes list -w <workspace_id> --limit 200 # 페이지에 렌더링된 "캐스트"
astria prompts list -w <workspace_id> --limit 100 --offset 0 # 빈 페이지가 나올 때까지 --offset 사용
astria prompts list -w <workspace_id> --pack-id <pack_id> # 더 가볍게, 한 섹션씩
목록 엔드포인트는 --limit/--offset을 통해 페이지네이션됩니다(기본 정렬 id desc). 페이지가 비어서 반환될 때까지 --offset으로 반복합니다.
3. 증분 편집 수행
/tmp/landing_page.html을 로컬에서 편집합니다. 변경 사항을 최소한으로 유지하세요. 생성기는 수천 바이트의 레이아웃을 생성했으며 대부분은 그대로 두어야 합니다. 저장하기 전에 위의 제약 조건 섹션을 다시 읽으세요.
4. 페이지 다시 쓰기
astria landing set -w <workspace_id> --html-file /tmp/landing_page.html
여기서 --brief를 전달하지 마십시오. 그러면 편집 내용이 폐기되고 Gemini를 통해 처음부터 다시 생성됩니다.
5. 확인
/w/{slug}를 열고 변경 사항을 시각적으로 확인합니다. __TUNES_JSON_PAYLOAD__ 플레이스홀더는 렌더링 시 서버 측에서 대체됩니다. 렌더링된 페이지에 JSON 모양의 문자열이 계속 표시되면 플레이스홀더가 실수로 삭제되었거나 이름이 변경된 것입니다.
처음부터 다시 생성하기
사용자가 명시적으로 전체 재설계를 요청한 경우에만 brief를 제출하면 서버가 LANDING_PAGE_PROMPT를 Gemini에 대해 실행하여 HTML을 덮어씁니다:
astria landing set -w <workspace_id> \
--brief "Editorial fashion lookbook, AW26, dark moody palette, emphasize the womenswear packs"