Neopress 런타임으로 제작하고 발행하기
페이지 코드와 CMS·폼 연결 규칙을 이해하고, 초안에서 실제 공개까지 필요한 단계를 확인합니다.
Neopress 개발은 페이지 코드와 사이트에서 관리하는 리소스를 연결하는 작업입니다. 런타임 규칙을 읽고 필요한 리소스를 만든 뒤, 페이지 컴파일과 변경 사항 검토를 거쳐 실제 공개 주소를 확인하는 순서로 진행하세요.
먼저 런타임 규칙 읽기
TSX, 컬렉션 스키마, 동적 페이지, 참조 관계, 폼을 생성하기 전에 MCP의 neopress_get_runtime_contract를 호출하도록 AI에게 요청하세요. 반환된 규칙과 현재 CLI 도움말을 함께 확인합니다. 사용할 수 있는 모듈과 페이지에 전달되는 데이터, 발행 조건이 설명되어 있습니다.
공통 사이트 레이아웃은 헤더, 푸터, 전역 CSS, 404 콘텐츠를 담당합니다. 개별 페이지 컴포넌트에는 해당 페이지의 본문을 작성합니다. 역할을 나누면 메뉴가 중복되거나 사이트 공통 스타일이 페이지마다 달라지는 일을 줄일 수 있습니다.
지원하는 페이지 환경에서 작업하기
페이지 TSX는 Neopress의 제한된 실행 환경에서 동작합니다. 현재 런타임 규칙에서 허용한 모듈을 사용하세요. 임의의 npm 패키지, 환경 변수, 파일 시스템, 서버 액션, 데이터베이스 직접 접근을 일반적인 페이지 기능처럼 사용할 수는 없습니다.
마케팅 페이지, 포트폴리오, CMS 목록과 상세 페이지, 화면 내 인터랙션, 관리형 폼을 만들 수 있습니다. 방문자 회원가입과 로그인, 회원 전용 공간, 장바구니, 결제, 고객 구독, 주문 관리는 지원하는 방문자 기능이 아닙니다. 이런 서비스가 필요하다면 사이트에 작동하지 않는 로그인이나 결제 화면을 만드는 대신 적절한 외부 서비스로 연결하세요.
CMS 콘텐츠와 폼 연결하기
컬렉션 스키마를 만들고 숫자 컬렉션 ID로 페이지와 조회 조건을 연결합니다. 콘텐츠 데이터의 키는 스키마 필드 ID와 일치해야 합니다.
/articles/[slug]같은 상세 페이지에는 컬렉션과 조회 설정을 연결합니다. 조회의 label이 페이지 prop 이름이 됩니다. 콘텐츠 필드는 펼쳐져 전달되므로article이라는 prop에는article.body로 접근합니다.첫 화면의 콘텐츠는 전달된 조회 prop을 사용합니다. 선택적으로 제공되는
entryClient는 화면이 열린 뒤 더 보기 등의 상호작용에 사용할 수 있습니다.관리형 폼은
@neopress/forms의NeopressForm에 숫자 폼 ID와 전달받은formClient를 넣어 표시합니다. 필드 구성과 제출 동작은 폼에서 관리합니다.
어떤 변경에 발행이 필요한지 구분하기
페이지와 레이아웃 코드, 번역 데이터, 전역 CSS, 컬렉션 스키마, 폼 초안은 공개된 버전과 분리됩니다. 수정한 페이지 주소도 사이트를 발행할 때 공개 주소에 반영됩니다. 컴파일은 코드 검증이며 발행이 아닙니다.
모든 설정이 이 초안 절차를 따르지는 않습니다. 사이트 이름이나 언어 설정 같은 사이트 설정은 직접 저장됩니다. 메타데이터도 별도 필드로 저장하므로, 설정 문서를 수정할 때는 먼저 현재 값을 읽고 관련 없는 값을 유지하세요.
CMS 콘텐츠는 별도로 발행합니다. 콘텐츠를 발행하면 공개 사이트에서 사용할 버전이 만들어지며, 이후 수정 내용은 다시 발행할 때까지 그 버전에 포함되지 않습니다. 사이트 발행만으로 콘텐츠 초안이 발행되지는 않습니다. 참조 관계를 변경했다면 참조를 가진 원본 콘텐츠를 다시 발행하고 연결된 콘텐츠도 발행되어 있는지 확인하세요.
순서대로 검토하고 발행하기
각 명령에서 반환된 ID를 사용하세요. 아래 숫자는 예시이며 콘텐츠와 폼 단계는 해당 변경이 있을 때만 실행합니다.
neopress --site 123 forms publish 789
neopress --site 123 pages compile 456
neopress --site 123 publish preview
neopress --site 123 entries publish 654
neopress --site 123 publish콘텐츠와 폼 발행은 마지막 사이트 발행 전에도 기존 공개 페이지에 영향을 줄 수 있습니다. 각각의 발행 명령을 실행하기 전에 검토하세요. CLI의 사이트 발행은 해당 사이트의 대기 중인 변경을 반영하므로 다른 변경 사항도 함께 확인해야 합니다.
마지막으로 실제 공개 주소를 엽니다. 기본 언어와 공개할 추가 언어, CMS 상세 페이지, 이미지, 폼을 확인하세요. 로컬이나 스테이징 API를 대상으로 발행해도 프로덕션은 바뀌지 않습니다. 초안에서 번역한 페이지는 해당 언어의 공개 설정을 켜고 사이트 발행에도 포함해야 합니다.