Pelican에서 마이그레이션

Pelican은 Python을 기반으로 구축된 오픈 소스 정적 사이트 생성기입니다.

Pelican과 Astro의 주요 유사점

Pelican과 Astro는 프로젝트 마이그레이션에 도움이 되는 몇 가지 유사점을 공유합니다.

Pelican과 Astro는 모두 블로그와 같은 콘텐츠 중심 웹사이트에 이상적으로 적합한 정적 사이트 생성기입니다.
Pelican과 Astro는 모두 페이지 메타데이터를 위한 프런트매터 YAML 속성을 포함하여 Markdown 작성을 기본적으로 지원합니다. 그러나 Astro는 Pelican에 비해 예약된 프런트매터 속성이 거의 없습니다. 기존 Pelican 프런트매터 속성 중 다수가 Astro에서 “특별”하지 않더라도 기존 Markdown 파일과 프런트매터 값을 계속 사용할 수 있습니다.

Pelican과 Astro의 주요 차이점

Astro에서 Pelican 사이트를 다시 빌드하면 몇 가지 중요한 차이점을 발견할 수 있습니다.

Pelican은 Markdown 및 reStructured Text (.rst)로 콘텐츠 작성을 지원합니다. Astro는 Markdown 및 MDX 파일에서 페이지 생성을 지원하지만 reStructured Text는 지원하지 않습니다.
Pelican은 템플릿 작성을 위해 HTML 파일과 Jinja 구문을 사용합니다. Astro 구문은 JSX와 유사한 HTML 상위 집합입니다. 유효한 모든 HTML은 유효한 .astro 구문입니다.
Pelican은 블로그와 같이 콘텐츠가 풍부한 웹사이트를 빌드하도록 설계되었으며 Astro에서 직접 빌드해야 하는 몇 가지 블로그 기능이 내장되어 있습니다. 대신 Astro는 공식 블로그 테마에 포함된 이러한 기능 중 일부를 제공합니다.

Pelican에서 Astro로 전환

Pelican 문서 사이트를 Astro로 변환하려면 공식 Starlight 문서 테마 시작 템플릿으로 시작하거나 테마 쇼케이스에서 더 많은 커뮤니티 테마를 탐색하세요.

공식 스타터 중 하나를 사용하여 새로운 Astro 프로젝트를 시작하려면 --template 인수를 create astro 명령에 전달할 수 있습니다. 또는 GitHub의 기존 Astro 저장소에서 새 프로젝트를 시작할 수 있습니다.

npm create astro@latest -- --template starlight

pnpm create astro@latest --template starlight

yarn create astro --template starlight

기존 Markdown 콘텐츠 파일을 가져와 Markdown 페이지를 만듭니다. 이러한 문서를 Pelican의 content/ 폴더에서 Astro의 src/pages/로 복사하여 파일 기반 라우팅을 활용할 수 있습니다. 파일이 어디에 있어야 하는지 알아보려면 Astro의 프로젝트 구조를 읽어보세요.

Pelican은 사이트 레이아웃과 메타데이터의 대부분을 처리했을 수도 있습니다. <head> 페이지를 포함하여 Astro에서 템플릿 작성을 직접 관리하는 방법을 알아보려면 Astro 레이아웃을 Markdown 페이지 래퍼로 빌드하는 방법을 읽어보세요.

Pelican과 마찬가지로 Astro에는 기능을 확장하는 많은 플러그인이 있습니다. 공식 통합 목록에서 MDX 지원 등의 기능을 추가하고, Astro 통합 디렉터리에서 커뮤니티에서 관리하는 수백 가지의 통합을 찾아보세요. Astro 통합 API를 사용하여 프로젝트의 기능을 확장하는 사용자 지정 통합을 구축할 수도 있습니다.

포트폴리오나 블로그 등 다른 유형의 사이트를 변환하려면 astro.new에서 더 많은 공식 시작 템플릿을 참조하세요. 각 프로젝트의 GitHub 저장소에 대한 링크는 물론 StackBlitz, CodeSandbox, Gitpod 온라인 개발 환경에서 작업 중인 프로젝트를 열 수 있는 원클릭 링크도 찾을 수 있습니다.