TL;DR

  • Accent CMS는 Rust로 개발 중인 무료 플랫 파일 에이전트 CMS이며, 샌드박스형 WebAssembly(WASM) 플러그인을 지원함.
  • 콘텐츠 작성, 테마, 템플릿, 검색, 배포를 위한 문서와 기능 가이드를 제공함.
  • 플러그인은 훅, 필터, 숏코드, 사용자 정의 경로, 미디어 처리, 다이어그램 렌더러를 확장함.
  • 초안, 예약 게시, 자동 보관과 폴더 기반 페이지·일반 파일 문서를 함께 관리하는 콘텐츠 워크플로를 갖춤.
  • MCP 서버, 서명된 플러그인·테마 레지스트리, CLI 및 설정 참조 문서를 포함함.

문서

학습

  • 시작하기: Accent CMS를 설치하고 초기화한 뒤 첫 사이트를 실행하는 방법임.
  • 마크다운 가이드: 프런트매터, 컴포넌트, 구문 강조를 포함해 콘텐츠를 작성하는 방법임.
  • 콘텐츠 워크플로: 초안, 예약 게시, 콘텐츠 수명 주기를 관리하는 방법임.

구축

  • 테마: 테마를 선택하고 설정하며 사용자 정의 스타일을 만드는 방법임.
  • 템플릿 가이드: 템플릿 상속, 필터, 함수, 컬렉션, 미디어, 모듈형 페이지를 다룸.
  • 검색: 외부 의존성 없이 즉시 동작하는 클라이언트 측 검색을 추가하는 방법임.
  • 플러그인: WASM 플러그인으로 Accent CMS를 확장하는 방법임.
  • 무료

배포

  • 배포: 동적 제공과 정적 빌드 중 선택하고 프로덕션 설정을 구성하는 방법임.

Pro 통합

  • MCP 서버: 모델 컨텍스트 프로토콜(Model Context Protocol)을 통한 AI 지원 콘텐츠 관리임.

참조

  • CLI 참조: 모든 명령, 플래그, 환경 변수를 설명함.
  • 설정: config.yaml의 모든 필드를 참조할 수 있음.
  • 문제 해결: 일반적인 문제, 오류 메시지, 디버깅 방법을 다룸.

커뮤니티

  • 포럼: 질문, 문제 보고, 제작물 공유를 위한 공간임.
  • 허브: 플러그인, 테마, 시작 템플릿의 서명된 레지스트리이며, 자체 항목 제출 방법은 ‘아티팩트 게시’ 문서에서 다룸.

이 섹션의 문서

  • Accent 시작하기: Accent CMS를 설치하고 개발 서버를 시작한 뒤 관리자 화면에서 첫 페이지를 편집하는 전체 과정으로, 5분 이내에 완료할 수 있음.
  • 콘텐츠 구성: 폴더가 있는 미디어 중심 페이지와 일반 파일을 사용하는 경량 문서 중에서 선택하며, 두 모델을 한 사이트에서 자유롭게 혼합할 수 있음.
  • 콘텐츠 워크플로: 초안 상태, 예약 게시, 자동 보관으로 페이지 공개 여부를 관리함.
  • 마크다운 가이드: CommonMark 마크다운으로 콘텐츠를 작성하는 방법을 설명함.
  • 마크다운 확장: 위키 링크, 수식, 주의문, 정의 목록 등의 확장을 설정하고 사용하는 방법임.
  • 테마 가이드: 템플릿, 에셋, CSS 프레임워크로 사용자 정의 테마를 만드는 방법임.
  • 템플릿 가이드: MiniJinja 템플릿, 필터, 함수, 콘텐츠 기능으로 동적 페이지를 만드는 방법임.
  • 문서 모델: YAML 모델 파일의 형식 필드, 유효성 검사 규칙, 기본값으로 콘텐츠 스키마를 정의함.
  • 콘텐츠 마운트: 파일 시스템 마운트를 이용해 추가 콘텐츠 디렉터리를 사이트 URL 트리의 특정 위치에 연결함.
  • 에셋 핑거프린팅: CDN 친화적인 캐시 무효화와 하위 리소스 무결성(Subresource Integrity, SRI)을 위해 에셋 파일 이름에 콘텐츠 해시를 추가함.
  • 템플릿의 환경 변수: 환경 변수에서 빌드 시점 및 런타임 설정을 템플릿에 주입함.
  • 템플릿의 콘텐츠 해싱: 파일이나 문자열의 SHA 해시를 계산해 캐시 무효화, SRI, 콘텐츠 주소 지정 식별자에 활용함.
  • 테마 이식성: 개발, 프로덕션 제공, 정적 빌드에서 변경 없이 작동하는 테마를 작성함.
  • 검색: 외부 의존성 없이 사이트에 즉시 동작하는 클라이언트 측 검색을 추가함.
  • 플러그인: 샌드박스형 WebAssembly Component Model 플러그인으로 훅, 필터, 숏코드, 사용자 정의 경로, 미디어 처리, 다이어그램 렌더러를 제공함.
  • 문의 양식 플러그인: CSRF 보호와 이메일 전달 기능을 갖춘 문의 양식을 사이트에 추가함.
  • 아일랜드 아키텍처: Accent의 기본 자바스크립트 미사용 철학을 유지하면서 서버 렌더링 페이지에 격리된 클라이언트 측 상호작용 영역을 추가함.
  • 다국어 콘텐츠: 파일명 접미사를 사용해 한 사이트를 여러 언어로 제공함. 기본 언어는 일반 URL을 유지하고 번역은 언어 접두 경로로 제공하며, 템플릿에는 언어 전환기를 만드는 데 사용할 번역 목록이 제공됨.
  • 허브: 서명된 Accent CMS 생태계 레지스트리에서 플러그인과 테마를 설치하고 시작 템플릿을 생성함.
  • 이메일 알림(SMTP): 플러그인 이메일 전송과 핵심 알림에 내장 SMTP 서비스를 설정함.
  • 데이터 저장소: 파일 기반 데이터 저장소에 댓글, 양식 제출, 투표 등 사용자 생성 콘텐츠를 저장하고 템플릿에서 접근함.
  • 서버 역할: 개발자, 게시자, 작성자 역할로 프로덕션 서버의 기능을 제어함.
  • 사이트 접근 보호: 미리보기 및 스테이징 배포에서 HTTP 기본 인증과 IP 허용 목록으로 사이트 접근을 제한함.
  • Git 배포: 자동 가져오기와 브랜치 추적을 통해 Git 저장소의 콘텐츠를 배포함.
  • 배포: Accent CMS 사이트의 배포 전략을 선택함.
  • 통합: Accent CMS를 AI 어시스턴트 및 프로그래밍 방식 클라이언트와 연결함.
  • 관리자 UI: Accent Author의 HTMX 기반 관리자 셸에서 페이지 탐색·편집, 미디어 관리, 콘텐츠 모델 검사, 유효성 검사 보고서 확인을 수행함.
  • 문제 해결: 일반적인 문제, 오류 메시지, 디버깅 기법에 대한 해결책을 제공함.
  • 참조 문서: Accent CMS의 모든 명령, 설정 필드, 구문 구성 요소, API 엔드포인트를 설명함.