Builder.io & Astro
Builder.io는 웹사이트 구축을 위한 드래그 앤 드롭 콘텐츠 편집을 지원하는 시각적 CMS입니다.
이 레시피는 클라이언트 측 JavaScript 없이 Builder space를 Astro에 연결하는 방법을 보여줍니다.
전제 조건
섹션 제목: “전제 조건”시작하려면 다음이 필요합니다.
- Builder 계정 및 space - 아직 계정이 없다면 무료로 가입하고 새 space을 만드세요. Builder를 사용하는 space가 이미 있는 경우 자유롭게 사용하세요. 단, 모델 이름 (
blogpost) 및 사용자 정의 데이터 필드와 일치하도록 코드를 수정해야 합니다. - Builder API 키 - 이 공개 키는 Builder에서 콘텐츠를 가져오는 데 사용됩니다. 키를 찾는 방법에 대한 Builder 가이드를 읽어보세요.
자격 증명 설정
섹션 제목: “자격 증명 설정”Astro에 Builder API 키와 Builder 모델 이름을 추가하려면 프로젝트 루트에 .env 파일을 만들고 (아직 없는 경우) 다음 변수를 추가하세요.
BUILDER_API_PUBLIC_KEY=YOUR_API_KEYBUILDER_BLOGPOST_MODEL='blogpost'이제 프로젝트에서 이 API 키를 사용할 수 있습니다.
작성 당시 이 키는 공개되어 있으므로 숨기거나 암호화하는 것에 대해 걱정할 필요가 없습니다.
환경 변수에 IntelliSense를 사용하려면 src/ 디렉터리에 env.d.ts 파일을 만들고 다음과 같이 ImportMetaEnv를 구성하면 됩니다.
interface ImportMetaEnv { readonly BUILDER_API_PUBLIC_KEY: string;}이제 프로젝트에 다음 파일이 포함되어야 합니다.
디렉터리src/
- env.d.ts
- .env
- astro.config.mjs
- package.json
.env 파일에 대해 자세히 알아보세요.
Astro와 Builder로 블로그 만들기
섹션 제목: “Astro와 Builder로 블로그 만들기”블로그 게시물 모델 만들기
섹션 제목: “블로그 게시물 모델 만들기”아래 지침은 title과 slug라는 두 개의 필수 텍스트 필드가 포함된 blogpost라는 Builder 모델 (Type: “Section”)을 사용하여 Astro 블로그를 만듭니다.
Builder의 공식 튜토리얼 중 하나에서 이 절차를 보여주는 동영상을 찾을 수 있습니다.
Builder 앱에서 블로그 게시물을 나타내는 모델을 생성합니다. Models 탭으로 이동하여 + Create Model 버튼을 클릭하여 다음 필드와 값을 사용하여 모델을 생성합니다.
- Type: Section
- Name: “blogpost”
- Description: “This model is for a blog post”
새 모델에서 + New Custom Field 버튼을 사용하여 2개의 새 필드를 만듭니다.
-
텍스트 필드
- Name: “title”
- Required: Yes
- Default value “I forgot to give this a title”
(다른 매개변수는 기본값으로 둡니다.)
-
텍스트 필드
- Name: “slug”
- Required: Yes
- Default value “some-slugs-take-their-time”
(다른 매개변수는 기본값으로 둡니다.)
그런 다음 오른쪽 상단에 있는 Save 버튼을 클릭하세요.
slug 필드에는 몇 가지 함정이 있습니다:
-
슬러그가 단순한 숫자가 아닌지 확인하세요. 이로 인해 Builder API에 대한 가져오기 요청이 중단되는 것 같습니다.
-
사이트의 라우팅이 이에 따라 달라지므로 슬러그가 고유한지 확인하세요.
미리보기 설정
섹션 제목: “미리보기 설정”Builder의 시각적 편집기를 사용하려면 특수 <builder-component>를 렌더링하는 src/pages/builder-preview.astro 페이지를 생성하세요.
디렉터리src/
디렉터리pages/
- builder-preview.astro
- env.d.ts
- .env
- astro.config.mjs
- package.json
그런 다음, 다음 내용을 추가합니다.
---const builderAPIpublicKey = import.meta.env.BUILDER_API_PUBLIC_KEY;const builderModel = import.meta.env.BUILDER_BLOGPOST_MODEL;---
<html lang="en"> <head> <title>Preview for builder.io</title> </head> <body> <header>This is your header</header>
<builder-component model={builderModel} api-key={builderAPIpublicKey}></builder-component> <script async src="https://cdn.builder.io/js/webcomponents"></script>
<footer>This is your footer</footer> </body></html>