설정 가이드

Xingluo의 모든 설정 가능한 옵션은 루트 레벨의 xingluo.config.ts에 있습니다. 이 파일은 defineXingluoConfig를 통한 완전한 타입 제약을 제공하며, 소스 코드를 건드리지 않고 변경 사항이 즉시 적용됩니다.

site 사이트 설정

ts
site: {
  url: "https://xingluo.example.com/",  // 사이트 URL(절대 링크, RSS, 사이트맵에 사용)
  title: "Xingluo",                      // 사이트 제목
  description: "A modern blog CMS built with Astro and shadcn",
  author: "Xingluo",                     // 기본 저자 이름
  profile: "https://xingluo.example.com", // 저자 홈페이지(JSON-LD에 사용)
  ogImage: "default-og.jpg",              // 기본 OG 이미지(public 디렉토리 내)
  lang: "zh-cn",                          // 기본 언어
  timezone: "Asia/Shanghai",              // 타임존(게시물 날짜 표시)
  dir: "ltr",                             // 텍스트 방향: ltr | rtl
  googleVerification: "",                 // Google Search Console 확인 값(또는 환경 변수)
}

posts 게시물 설정

ts
posts: {
  perPage: 8,              // 목록 페이지당 게시물 수
  perIndex: 5,             // 홈페이지에 표시되는 게시물 수
  scheduledPostMargin: 900000, // 예약 게시 허용 시간(ms), 15분
}

• perPage: /posts/[...page] 및 /tags/[tag]/[...page]의 페이지 크기
• perIndex: 홈페이지 “최신” 섹션에 표시되는 게시물 수
• scheduledPostMargin: 이 시간 창 내의 미래 게시물은 게시된 것으로 처리됨(프로덕션에서 유효, 개발에서는 모두 표시)

features 기능 설정

ts
features: {
  lightAndDarkMode: true,
  dynamicOgImage: true,
  showArchives: true,
  showBackButton: true,
  editPost: { enabled: true, url: "https://github.com/.../edit/main/" },
  search: "flexsearch",
  mdx: true,
  comments: { provider: false /* giscus | twikoo | waline */ },
  players: { aplayer: false, dplayer: false },
}

editPost 편집 링크

editPost.url은 저장소 편집 URL 접두사입니다. Xingluo는 게시물의 상대 소스 경로(src/content/posts/...)를 끝에 추가합니다. 예：

ts
editPost: { enabled: true, url: "https://github.com/owner/repo/edit/main/" }

게시물 src/content/posts/welcome.md은 https://github.com/owner/repo/edit/main/src/content/posts/welcome.md 링크를 생성합니다.

socials 소셜 링크

ts
socials: [
  { name: "github", url: "https://github.com/xingluo/blog" },
  { name: "x", url: "https://x.com/xingluo" },
  { name: "mail", url: "mailto:[email protected]" },
];

• name: 아이콘 이름. src/assets/icons/socials/{name}.astro에 해당. 내장: github, x, mail, facebook, telegram, weibo
• url: 링크 URL. 메일은 mailto: 사용
• linkTitle: 선택적 접근성 제목. 생략 시 이름에서 자동 생성

소셜 플랫폼 추가: src/assets/icons/socials/에 동일한 이름의 .astro 아이콘 컴포넌트를 생성합니다. src/lib/socialIcons.ts가 import.meta.glob을 통해 자동으로 수집합니다.

shareLinks 공유 링크

ts
shareLinks: [
  { name: "x", url: "https://x.com/intent/post?url=" },
  { name: "facebook", url: "https://www.facebook.com/sharer.php?u=" },
  { name: "telegram", url: "https://t.me/share/url?url=" },
  { name: "weibo", url: "https://service.weibo.com/share/share.php?url=" },
  { name: "mail", url: "mailto:?subject=...&body=" },
];

이러한 공유 항목은 게시물 페이지 하단에 나타납니다. url은 공유 URL 접두사이며, Xingluo는 현재 게시물의 절대 URL을 끝에 추가합니다. name은 마찬가지로 src/assets/icons/socials/의 아이콘에 매핑됩니다.

환경 변수

astro.config.ts의 env.schema를 통해 선언:

예시(PowerShell):

powershell
$env:PUBLIC_GOOGLE_SITE_VERIFICATION = "your-verification-code"
pnpm build

이 값은 config.site.googleVerification에 주입되어 <meta name="google-site-verification">으로 렌더링됩니다.

전체 예시

xingluo.config.ts를 참조하세요. features.comments 및 features.players 섹션에는 giscus / twikoo / waline에 대한 주석 처리된 예제가 포함되어 있습니다. 주석을 해제하고 실제 값을 입력하여 활성화하세요.