설정

키

modootoday:
  color_scheme: auto  # auto | auto-dark | auto-light | light | dark
  components: [callout, badge, cta, card, tabs]
  tokens: {primary: "#4f46e5", radius: "0.5rem"}
  nav: main

modootoday-check가 모든 키를 검사합니다. 안정 이름 전체 목록은 공개 API에 있습니다.

새 창으로 여는 링크

새 창으로 여는 건 직접 켤 때만 동작합니다. 링크마다 켜거나, 외부 링크 전체에 켤 수 있습니다.

# _config.yml: 외부 링크 전체
modootoday:
  external_links:
    new_window: true
    icon: true        # false면 화살표를 숨깁니다

# 링크마다: 메뉴, 카드, 버튼, 링크 카드, 디렉터리 항목, 요금제 버튼, 푸터 링크
- {title: "상태 페이지", url: "https://status.example.com", new_window: true}
- {title: "포럼", url: "https://forum.example.com", target: _blank}

[릴리스 노트](https://github.com/modootoday/jekyll-theme-modootoday/releases "new-window")

이런 링크에는 target="_blank", rel="noopener noreferrer", CSS로 그린 작은 화살표, 그리고 스크린 리더가 aria-describedby로 읽는 숨은 안내(“새 창에서 열림”, 페이지 언어로 번역)가 붙습니다. 스크립트를 쓰지 않아서 엄격한 콘텐츠 보안 정책(CSP)에서도 그대로 동작합니다. 사이트 설정을 켰더라도 링크에 new_window: false를 쓰면 그 링크는 같은 창에서 열립니다.

헤드와 SEO

url:을 설정하면 모든 페이지에 canonical 링크와 Open Graph 태그가 들어가며 플러그인이 필요 없습니다. languages:를 설정하면 여러 언어로 있는 페이지끼리 hreflang으로 연결됩니다. 사이트맵과 피드는 GitHub Pages가 허용하는 플러그인으로 직접 켭니다.

url: https://example.github.io
modootoday:
  languages: [en, ko]
  edit_url: https://github.com/OWNER/REPO/edit/main/docs/
plugins: [jekyll-remote-theme, jekyll-sitemap, jekyll-feed]

jekyll-seo-tag를 쓰려면 seo: false로 두고 _includes/head-custom.html에 jekyll-seo-tag의 seo 태그를 넣으세요. front matter의 last_modified_at:으로 수정일을 표시할 수 있습니다. 이동 경로의 첫 항목은 홈 페이지 front matter에 short_title:이 있으면 그것을, 없으면 title을 보여 줍니다. 엄격한 콘텐츠 보안 정책은 CSP를 보세요.

언어

인터페이스 문자열은 _data/i18n/<lang>.yml에, 페이지는 <lang>/에 둡니다.

language: 한국어
site_title: 모두의오늘 테마   # 헤더, <title>, og:site_name, JSON-LD 이름. 없으면 site.title
callout: {note: 참고, tip: 팁, important: 중요, warning: 경고, caution: 주의}
tabs: {label: 설치 방법}
status: {available: 사용 가능, partial: 일부 구현, planned: 계획}
skip: 본문으로 건너뛰기

lang:만 지정하면 테마가 표시하는 문구(본문 바로가기, 내비게이션, 알림 상자, 상태 배지, 목차, 이전/다음 페이지, 코드 복사, 검색, 언어 메뉴)가 23개 언어로 바로 현지화됩니다. 지원 언어는 en, zh-CN, zh-TW, ja, ko, tr, ru, vi, th, de, es, fr, uk, pl, pt-BR, ar, fa, id, it, el, ml, ur-Latn, ro입니다. GitHub Pages에서도, Jekyll 4에서도 아무것도 복사할 필요가 없습니다. 테마에 없는 지역 코드는 기본 언어를 따르고(pt → pt-BR, zh → zh-CN), 그 밖의 언어는 영어로 표시됩니다.

각 문구는 다음 순서로 정해집니다.

1. 사이트의 _data/i18n/<lang>.yml (키 단위)
2. 테마에 들어 있는 해당 언어 카탈로그
3. 영어

그래서 사이트 카탈로그에는 바꾸고 싶은 키와 직접 만든 컴포넌트가 쓰는 키만 넣으면 됩니다. 확장자는 .yml을 쓰세요. 검사기는 .yaml을 오류로 처리합니다. 테마 문구에서 시작하고 싶다면 카탈로그를 복사한 뒤 검사하세요.

modootoday-check . _site --i18n-init=ko   # optional: copy the theme's ko.yml to edit
modootoday-check . _site --i18n           # unknown keys and placeholder mismatches

테마가 제공하지 않는 언어는 영어 카탈로그와 같은 키로 _data/i18n/<code>.yml을 만들고 languages에 코드를 추가하세요. 아랍어, 페르시아어, 히브리어, 우르두어 같은 RTL 언어 페이지에는 dir="rtl"이 붙습니다(ur-Latn은 왼쪽에서 오른쪽). 카탈로그나 front matter의 direction: rtl 또는 ltr로 바꿀 수 있습니다. 페이지 본문은 카탈로그가 아니라 <lang>/ 아래 Markdown으로 번역합니다.

경로가 다른 번역 페이지끼리는 front matter에 같은 ref:를 둡니다. 예를 들어 guides/start.md와 ko/guides/sijak.md에 모두 ref: guide를 씁니다. 그러면 hreflang 링크와 언어 선택기가 그 페이지를 사용합니다. ref:가 있는데 번역이 없는 페이지는 hreflang에서 빠지고, 언어 선택기는 그 언어의 홈으로 보냅니다. include와 레이아웃에서 modootoday/link.html에 ref="guide"를 주면 현재 언어의 ref: guide 페이지 URL을, 없으면 기본 언어 페이지 URL을 얻습니다(대체하지 않으려면 exact=true, 전체 URL은 absolute=true). 어떤 페이지에도 없는 ref=는 modootoday-check가 오류로 알립니다. full_languages를 설정하면 modootoday-check . _site --i18n-pages가 그 언어의 번역(같은 ref:, 또는 <lang>/ 아래 같은 경로)이 없는 기본 언어 페이지를 경고로 보여 줍니다. --strict를 함께 쓰면 실패합니다.

테마가 아니라 사이트가 정하는 문구도 있습니다. tabs.label은 탭을 쓰는 페이지에서 탭 목록의 이름입니다(예: tabs: {label: 설치 방법}). 스크린 리더가 무엇을 고르는 탭인지 읽어 주니, 언어별 카탈로그마다 넣어 주세요.

직접 만든 include에서는 modootoday/t.html에 key="nav.label"을 넘기면 같은 순서를 따르는 문구를 출력할 수 있습니다.

컴포넌트 레지스트리

선택 파일 _data/components.yml이 있으면 검사기가 sections: 매개변수를 검증합니다.

features: {params: {cols: {allowed: [2, 3, 4], required: false}, badge: {allowed: [bottom], required: false}}}
tabs: {i18n: [tabs.label]}
cta: {}