콘텐츠 작업하기

EmDash 관리자를 사용해 항목을 첫 초안에서 게시된 페이지까지 가져가세요. 에디터는 초안 변경을 방문자가 볼 수 있는 버전과 분리해 유지하므로, 저장과 게시는 두 가지 별도 동작입니다.

컬렉션 열기

사이트의 /_emdash/admin을 열고 로그인하세요. 사이드바에서 Posts 또는 Pages 같은 컬렉션을 선택하세요.

컬렉션 페이지는 항목을 나열합니다. 여기서 다음을 할 수 있습니다.

• Add New를 선택해 항목을 만들기
• 항목 제목, 슬러그, searchable로 표시된 필드로 검색하기
• 게시 상태, 작성자, 바이라인, 날짜, 로케일로 필터하기
• 일괄 게시, 초안으로 되돌리기, 휴지통으로 이동을 위해 항목 선택하기
• Trash를 열어 항목을 복원하거나 영구 삭제하기

에디터에서 사용할 수 있는 필드와 게시 기능은 컬렉션의 콘텐츠 모델에 따라 다릅니다. 예를 들어 컬렉션은 개정, 미리보기, 택소노미, 검색을 지원할 수 있습니다.

항목 만들고 게시하기

항목에는 안정적인 콘텐츠 ID와 별도의 슬러그가 있습니다. 슬러그가 바뀌어도 ID는 같은 항목을 계속 식별합니다. 템플릿은 보통 getEmDashCollection()이 반환하는 URL 지향 식별자를 사용합니다. 콘텐츠 조회 가이드가 두 값을 설명합니다.

리치 텍스트 작성

Portable Text 필드는 제목, 단락, 인용, 목록, 링크, 이미지, 갤러리, 코드 블록, 표, HTML 블록, 재사용 가능한 섹션용 블록 에디터를 제공합니다. 설치된 플러그인이 블록을 더 추가할 수 있습니다.

도구 모음으로 선택한 텍스트를 서식 지정하세요. 블록을 삽입하려면 단락 옆의 블록 추가 컨트롤을 선택하거나 /를 입력하고 이름으로 블록을 검색하세요. 이미지 및 갤러리 블록은 이미지 필드와 같은 미디어 피커를 엽니다.

이미지 블록을 선택하면 설정에서 해당 이미지 사용을 교체하거나 제거하고 표시 크기, 정렬, 대체 텍스트, 캡션, 선택적 툴팁을 설정할 수 있습니다. Edit asset은 기본 미디어 라이브러리 항목을 열며, 에셋을 변경하거나 교체하면 사용하는 다른 항목에 영향을 줄 수 있습니다. 그 구분은 미디어 라이브러리를 보세요.

초안 변경 저장

첫 저장 후 에디터는 입력을 멈춘 뒤 2초 후에 변경을 자동 저장합니다. Save 버튼은 **Saving…**에서 Saved로 바뀌어 서버가 초안을 수락했는지 확인할 수 있습니다. 자동 저장은 현재 자동 저장 개정을 교체하며, 일시 정지마다 체크포인트로 개정 이력을 채우지 않습니다.

편집 시퀀스의 한 지점을 개정 이력에 남기려면 Save를 선택하세요. 저장이 실패하면 에디터는 저장되지 않은 필드를 유지하고 오류를 표시합니다. 버튼이 Saved로 돌아가거나 저장되지 않은 작업을 다른 곳에 복사할 때까지 페이지를 떠나지 마세요.

게시된 항목에서는 변경 저장이 초안만 업데이트합니다. 방문자는 계속 이전 라이브 개정을 받습니다. 대기 버전을 확인하려면 Preview draft, 공개 버전을 확인하려면 Live View, 초안으로 교체할 준비가 되면 Publish changes를 사용하세요.

게시된 항목의 슬러그 변경도 같은 초안 흐름을 따릅니다. 공개 URL은 자동 저장이 실행될 때가 아니라 초안을 게시할 때 바뀝니다.

다른 편집자와 작업하기

항목을 열면 해당 항목과 로케일에 대한 편집 잠금을 가져갑니다. 다른 사람이 이미 열어 두면 EmDash가 잠금 보유자를 식별하고 두 가지 선택을 제공합니다.

• Open read-only는 편집을 받지 않고 항목을 보여 주어, 버려질 작업을 입력할 수 없습니다.
• Take over는 잠금을 당신에게 줍니다. 상대는 입력한 내용을 유지하지만, 2분 안에 상대 에디터가 당신이 항목을 보유한다고 보고합니다. 상대의 다음 저장은 거부됩니다.

잠금은 항목이 열려 있는 동안 갱신되고, 에디터를 떠나거나 탭을 닫으면 해제됩니다. 브라우저나 컴퓨터가 해제하지 않고 닫히면 잠금은 마지막 갱신 후 7분 뒤에 만료됩니다.

잠금은 로케일마다 독립적이므로 두 사람이 같은 항목의 다른 번역을 편집할 수 있습니다. 스크립트나 API 클라이언트도 다른 편집자가 잠금을 보유하는 동안, 문서화된 오버라이드를 쓰지 않으면 거부됩니다. 전체 API 동작은 항목 편집 잠금을 보세요.

관리자는 Content Types, 해당 컬렉션, Edit locking에서 컬렉션 잠금을 끌 수 있습니다.

변경 게시 또는 예약

게시와 예약은 별도 컨트롤을 사용합니다.

• Publish now는 확인 후 새 초안을 라이브로 만듭니다.
• Publish changes는 확인 후 게시된 항목의 대기 변경을 라이브로 만듭니다.
• Schedule은 새 항목 또는 대기 변경이 라이브가 되는 시점을 설정합니다.
• Change schedule은 기존 예약을 업데이트합니다.
• Remove schedule은 기존 예약을 취소합니다.
• Unpublish는 공개 쿼리에서 라이브 개정을 제거하고, 예약을 취소하며, 편집 가능한 초안을 유지합니다.

항목을 예약하려면 먼저 저장하고, 게시 요약 아래 Schedule을 선택한 뒤 미래의 날짜와 시간을 고르세요. 에디터는 예약에 쓰는 시간대를 표시합니다. 그 시각까지 현재 라이브 개정은 공개로 유지됩니다. 새 항목에서는 아직 공개된 것이 없습니다.

Node.js 배포는 예약 게시 스윕을 자동으로 실행합니다. Cloudflare Workers에는 Cron Trigger가 필요합니다. Cloudflare 스타터 템플릿에 포함되어 있으며, 기존 배포는 예약 게시를 따라 트리거를 확인할 수 있습니다.

개정 복원

개정을 지원하는 컬렉션은 설정 패널에 Revisions를 표시합니다. 펼쳐 저장된 버전과 그 사이에서 바뀐 필드를 보세요. 개정을 선택해 내용을 검사한 뒤 그 버전을 다시 쓰려면 Restore를 선택하세요.

복원은 선택한 내용을 담은 새 개정을 만듭니다. 이전 개정을 지우지 않으므로 이후에도 전체 시퀀스를 검사할 수 있습니다.

항목 번역

국제화가 활성화되면 Translations 패널이 현재 항목의 구성된 로케일을 보여 줍니다.

각 번역에는 자체 슬러그, 게시 상태, 예약, 개정 이력이 있습니다. 컬렉션 페이지의 로케일 선택기로 한 번에 한 언어를 보세요.

콘텐츠를 휴지통으로 이동

항목 동작을 열거나 컬렉션 페이지에서 하나 이상의 행을 선택한 뒤 Move to Trash를 고르세요. 휴지통 항목은 일반 콘텐츠 쿼리에 나타나지 않지만 컬렉션의 Trash 탭에서 계속 사용할 수 있습니다.

Trash에서 Restore를 선택해 항목을 컬렉션으로 되돌리세요. 복원된 항목은 예약 없는 초안으로 돌아옵니다. 게시해 공개로 만드세요.

콘텐츠 작업 자동화

REST API와 EmDash CLI는 같은 초안 및 게시 워크플로를 지원합니다. 컬렉션 필드는 요청의 data 객체 안에 둡니다. 업데이트는 초안 개정을 저장하고, 게시는 별도 동작입니다. 업데이트 또는 게시 시 최신 _rev 값을 전달해 서버가 더 새 작업을 교체하는 대신 오래된 쓰기를 거부하게 하세요.

상태 전환, 권한, 충돌, 훅은 콘텐츠 수명 주기 참조를 사용하세요. REST API 참조는 요청 및 응답 본문을 정의하고, CLI 참조는 동등한 터미널 명령을 다룹니다.

Astro 사이트에서 게시된 항목을 렌더하려면 콘텐츠 조회로, 재사용 가능한 파일 추가 및 관리는 미디어 라이브러리로 계속하세요.