공식 문서

EmDash 공식 문서.

EmDash로 Astro 사이트에 WordPress 스타일 CMS 기능 추가

WordPress 개발자를 위한 Astro

이미 알고 있는 WordPress 개념을 통해 Astro 기초를 배우세요

WordPress 개발자를 위한 EmDash

WordPress에 익숙한 개발자를 위한 EmDash의 기능과 개념 가이드

관리자 패널

EmDash 관리자 패널이 편집자, 관리자, 개발자에게 제공하는 기능.

아키텍처

EmDash로 빌드하기 위한 멘탈 모델 — 라이브로 편집 가능한 콘텐츠 모델을 가진 Astro 통합.

컬렉션과 필드

컬렉션과 필드로 콘텐츠 유형을 정의합니다—지원되는 필드 유형, 유효성 검사, 관계.

콘텐츠 모델

EmDash에서 콘텐츠 모델을 구성하고 발전시키는 방법 — 컬렉션, 필드, 런타임 변경, 타입, 시드.

EmDash에 기여하기

개발 환경을 설정하고 EmDash에 기여하는 방법.

아키텍처 (내부)

EmDash 자체에 기여하는 사람들을 위한 EmDash의 내부 동작 방식.

문서 스타일 가이드

EmDash 문서의 작성, 구조 및 코드 샘플 규칙.

EmDash 번역하기

EmDash 관리 UI 번역에 기여하는 방법.

Cloudflare에 배포

D1과 R2를 사용하여 EmDash를 Cloudflare Workers에 배포합니다.

코어 데이터베이스 마이그레이션 관리

EmDash의 내부 스키마 마이그레이션을 직렬화된 배포 단계로 실행합니다.

데이터베이스 옵션

D1, PostgreSQL, libSQL 또는 SQLite로 EmDash를 구성합니다.

Node.js에 배포

모든 Node.js 호스팅 플랫폼에 EmDash를 배포합니다.

오브젝트 캐시

매 요청마다 데이터베이스를 조회하지 않고 읽기를 제공하기 위해 Cloudflare KV 또는 메모리에 쿼리 결과를 캐시합니다.

플러그인 샌드박스

Cloudflare Workers 또는 Node.js에서 샌드박스된 플러그인을 실행하며, 각 샌드박스 러너의 바인딩, 리소스 제한 및 실패 모드를 설명합니다.

배포된 사이트 발전시키기

운영 중인 EmDash 사이트의 스키마와 콘텐츠 모델을 변경하고 시드 파일을 동기화합니다.

시크릿 및 키 관리

EmDash의 각 시크릿이 어디에 있는지, 어떻게 제공하는지, 교체하거나 잃어버리면 어떻게 되는지.

스토리지 옵션

R2, S3 또는 로컬 파일 시스템으로 미디어 스토리지를 구성합니다.

EmDash 업데이트

기존 사이트를 새 EmDash 릴리스로 이전하는 방법. 릴리스 항목 읽기부터 배포된 사이트 검증까지.

EmDash Docs MCP

AI 코딩 어시스턴트를 EmDash 문서에 연결하여 실제 문서에서 질문에 답하고 올바른 패턴을 찾을 수 있도록 합니다.

기존 Astro 프로젝트에 EmDash 추가하기

스타터 템플릿 없이 이미 가지고 있는 Astro 사이트에 EmDash를 통합합니다.

시작하기

5분 이내에 첫 번째 EmDash 사이트를 만듭니다.

AI 도구

Claude, ChatGPT 및 기타 AI 어시스턴트를 EmDash 사이트에 연결하세요.

Atmosphere Login

Atmosphere 계정으로 EmDash에 로그인하세요 — Bluesky와 더 넓은 AT Protocol 생태계 뒤에 있는 개방형 네트워크 ID입니다.

인증

GitHub, Google 및 Atmosphere를 위한 플러그형 공급자가 있는 패스키 우선 인증입니다.

백업

사이트 백업을 다운로드하고, 스토리지에 자동 백업을 예약하고, D1 Time Travel로 복원합니다.

블로그 만들기

EmDash를 사용하여 게시물, 카테고리, 태그가 포함된 완전한 블로그를 구축합니다.

다크 모드

방문자의 색상 구성표를 따르고, 편집자가 이미지의 다크 변형을 선택하고, Image 컴포넌트로 올바른 것을 렌더링합니다.

국제화 (i18n)

로케일별 게시, 슬러그, 자동 폴백을 통해 콘텐츠를 여러 언어로 번역합니다.

미디어 라이브러리

EmDash에서 이미지와 파일을 업로드하고 관리합니다.

내비게이션 메뉴

헤더, 푸터, 사이드바를 위한 내비게이션 메뉴를 생성하고 관리합니다.

페이지 레이아웃

템플릿 필드를 사용하여 편집자가 개별 페이지에 대해 다른 레이아웃을 선택할 수 있도록 합니다.

미리보기 모드

게시 전에 초안 콘텐츠의 안전한 미리보기를 활성화합니다.

콘텐츠 쿼리

getEmDashCollection과 getEmDashEntry를 사용하여 템플릿에서 콘텐츠를 가져옵니다.

Sections

사이트 전체에서 재사용 가능한 콘텐츠 블록을 만들고 사용하세요.

사이트 설정

사이트 제목, 로고, 소셜 링크와 같은 전역 설정을 구성합니다.

택소노미

카테고리, 태그 및 사용자 정의 택소노미로 콘텐츠를 정리합니다.

위젯 영역

사이드바, 푸터 및 기타 템플릿 영역에 동적 콘텐츠 블록을 추가합니다.

콘텐츠 작업

EmDash 관리자 대시보드에서 콘텐츠를 생성, 편집, 관리합니다.

x402 Payments

x402 결제 프로토콜로 콘텐츠를 수익화하세요 — 사람이 아닌 봇에게 청구합니다.

EmDash

Astro 네이티브 CMS. 타입 안전 콘텐츠, 플러그인 확장성, 포터블 배포를 갖춘 WordPress의 현대적 후속작.

EmDash 소개

EmDash가 무엇인지, 어떻게 작동하는지, 그리고 프로젝트에 적합한지 알아보세요.

콘텐츠 가져오기

WordPress 및 기타 소스에서 EmDash로 콘텐츠를 가져옵니다.

WordPress에서 마이그레이션

단계별 가이드를 통해 WordPress 콘텐츠를 EmDash로 가져오세요.

WordPress 플러그인 포팅

Plugin API를 사용하여 WordPress 플러그인을 EmDash 플러그인으로 변환

관리 UI 확장

EmDash 관리 패널에 관리 페이지와 대시보드 위젯을 추가합니다.

플러그인 API 라우트

관리 UI와 외부 연동을 위해 플러그인에서 REST 엔드포인트를 노출합니다.

Block Kit

샌드박스 플러그인 관리 페이지 및 위젯용 선언적 UI 블록.

네이티브 플러그인 배포

npm을 통해 네이티브 플러그인을 패키징하고 배포하기.

페이지 프래그먼트

렌더링된 공개 페이지에 스크립트, 스타일시트 또는 HTML을 주입 — 네이티브 플러그인 전용.

Portable Text 렌더링 컴포넌트

플러그인에서 정의한 Portable Text 블록 타입을 공개 사이트에서 렌더링하는 Astro 컴포넌트를 제공합니다.

React 관리 페이지와 위젯

플러그인 관리 페이지와 대시보드 위젯을 위한 사용자 정의 React 컴포넌트를 제공합니다.

첫 번째 네이티브 플러그인

디스크립터 + createPlugin 패턴으로 네이티브 EmDash 플러그인을 구축합니다.

플러그인 만들기

훅, 스토리지, 설정 및 관리 UI를 사용하여 EmDash 플러그인을 구축합니다.

API 라우트

샌드박스 플러그인에서 관리 UI와 외부 연동을 위한 REST 엔드포인트를 노출합니다.

Block Kit

샌드박스 플러그인 관리 페이지 및 위젯을 위한 선언적 UI 블록.

기능과 보안

플러그인이 필요한 것을 선언하고 샌드박스가 무엇을 강제하는지 이해합니다.

플러그인 형식 선택

코드 작성을 시작하기 전에 샌드박스와 네이티브 플러그인 중 선택합니다.

emdash-plugin CLI

init, build, dev, bundle, validate, 프로필 설정 및 배포.

자동 플러그인 릴리스

EmDash 릴리스 서비스를 통해 GitHub Actions에서 샌드박스 플러그인을 게시합니다.

훅

콘텐츠, 미디어, 라이프사이클, 페이지 렌더링 이벤트에 응답하여 코드를 실행합니다.

플러그인 매니페스트

Reference for emdash-plugin.jsonc — identity, trust contract, profile fields, and publisher pinning.

플러그인 CLI로 마이그레이션

Breaking changes for sandboxed-plugin authors, and how to update your plugin.

번들링과 배포

Bundle a sandboxed plugin and publish it to the EmDash plugin registry.

설정

KV 스토어를 통한 플러그인별 구성으로, 관리 UI에서 Block Kit 페이지로 노출됩니다.

Storage

인덱스된 쿼리로 문서 컬렉션에 플러그인 데이터를 저장합니다.

첫 번째 샌드박스 플러그인

Build, register, and run a hello-world sandboxed plugin.

Field Kit

시드 옵션을 통해 구성된 JSON 필드용 조합 가능한 필드 위젯입니다.

플러그인 훅

콘텐츠, 미디어, 플러그인 라이프사이클 이벤트에 훅합니다.

플러그인 설치

Install plugins from the EmDash Marketplace or add them from code.

플러그인

훅, 스토리지, 설정, 관리 페이지 및 API 라우트로 EmDash를 확장합니다.

플러그인 게시

EmDash 플러그인을 번들링하여 마켓플레이스에 게시합니다.

플러그인 레지스트리

Install plugins from the experimental, federated EmDash plugin registry, and query it from your own site.

레지스트리 쿼리

Build a plugin directory, search page, or release feed against the registry's public discovery API with @emdash-cms/registry-client.

플러그인 샌드박스

EmDash가 Cloudflare Workers와 Node.js 배포에서 신뢰할 수 없는 플러그인을 어떻게 격리하는지 설명합니다.

플러그인 설정

설정 스키마와 KV 저장소로 플러그인을 구성합니다.

플러그인 스토리지

인덱스된 쿼리로 문서 컬렉션에 플러그인 데이터를 영속화합니다.

사이트 플러그인 업그레이드

Breaking changes for sites that install EmDash plugins, and how to adapt your project.

JavaScript API 참조

EmDash 콘텐츠를 쿼리하고 관리하기 위한 프로그래매틱 API.

CLI 참조

EmDash CMS 명령줄 인터페이스.

설정 참조

EmDash 설정 옵션 전체 참조.

필드 타입 참조

모든 EmDash 필드 타입 전체 참조.

훅 참조

EmDash 기능을 확장하는 플러그인 훅.

MCP 서버 참조

MCP 서버의 프로토콜 세부사항, 도구 사양, OAuth 설정.

REST API 참조

콘텐츠, 미디어, 스키마 관리 HTTP 엔드포인트.

테마 생성

나만의 EmDash 테마를 빌드하고 배포합니다.

테마 개요

EmDash 테마의 작동 방식과 새 사이트를 시작하는 방법을 이해합니다.

WordPress 테마 포팅

구조화된 접근 방식을 사용하여 WordPress 테마를 EmDash 테마로 변환

시드 파일 형식

EmDash 시드 파일 구조와 문법 참조.

EmDash를 선택하는 이유

EmDash가 해결하는 문제와 다른 접근 방식과의 비교를 이해합니다.