알림
참고
훑어보더라도 꼭 알아야 할 유용한 정보입니다.
팁
더 쉽고 낫게 하는 데 도움이 되는 조언입니다.
중요
목표를 이루려면 반드시 알아야 할 핵심 정보입니다.
경고
문제를 막으려면 바로 확인해야 하는 긴급한 정보입니다.
주의
특정 동작의 위험이나 나쁜 결과를 경고합니다.
참고
내용이 많은 알림:
inline code가 들어간 목록 항목- 컴포넌트 목록 링크가 있는 두 번째 항목
echo "code inside an alert"
2열 카드
- 짧은 카드 한 줄.
- 긴 카드 설명이 길어 여러 줄로 넘어가는 카드로, 그리드 전체의 간격, 줄 높이, 정렬을 확인합니다.
- 배지 포함 카드에 상태를 표시할 수 있습니다. 사용 가능
- 링크 포함 설치 안내를 읽어 보세요.
3열 카드
- 알림 GitHub 알림 다섯 종류. 사용 가능
- 탭 접근성을 갖춘 설치 탭. 일부 구현
- 검색 계획된 항목의 예. 계획
- 토큰 색상, 모서리 반경, 글꼴. 사용 가능
- Sass 컴포넌트마다 파셜 하나. 사용 가능
- Markdown 버전 에이전트용 Markdown. 사용 가능
4열 카드
- 알림 GitHub 알림 다섯 종류. 사용 가능
- 탭 접근성을 갖춘 설치 탭. 일부 구현
- 검색 계획된 항목의 예. 계획
- 토큰 색상, 모서리 반경, 글꼴. 사용 가능
- Sass 컴포넌트마다 파셜 하나. 사용 가능
- Markdown 버전 에이전트용 Markdown. 사용 가능
- 그리드 넓은 화면에서 네 열.
- 줄 카드 여덟 장이 두 줄을 채웁니다.
패널이 두 개인 탭
macOS
brew install ruby
gem install jekyll bundler
Linux
sudo apt install ruby-full
gem install jekyll bundler
패널이 많은 탭
Ruby
puts "Hello"
JavaScript
console.log("Hello");
Python
print("Hello")
Shell
echo Hello
이름이 훨씬 긴 탭
greeting: Hello
상태 배지
인라인 배지: 사용 가능 일부 구현 계획
태그 배지: beta experimental
| 기능 | 상태 |
|---|---|
| 알림 | 사용 가능 |
| 탭 | 일부 구현 |
| 검색 | 계획 |
아코디언
키친싱크는 어디에 쓰나요?
모든 컴포넌트를 한곳에 모아 보여 주므로 화면이 깨진 곳을 쉽게 찾을 수 있습니다.
JavaScript 없이도 동작하나요?
네. JavaScript가 없으면 모든 답이 질문 아래에 펼쳐진 채로 보입니다.
답에 코드를 넣을 수 있나요?
bundle exec jekyll serve
목록으로 쓴 단계
_config.yml에 테마를 추가합니다.- 평범한 Markdown으로
index.md를 씁니다. bundle exec jekyll build를 실행합니다.modootoday-check로 결과를 확인합니다.
제목으로 쓴 단계
설치
remote_theme과 플러그인을 추가합니다.
작성
front matter가 있는 페이지를 만듭니다.
배포
main에 푸시하고 GitHub Pages를 켭니다.
그림
타임라인
설치
알림, 섹션, 카드, 탭, 상태 배지, 검사기.
작성
디자인 토큰, modootoday: 블록, 내비게이션, 코드 복사.
확인
테마 전환, 이동 경로, 목차, 아코디언, 단계, 그림.
배포
타임라인, 키보드 키, 클라이언트 검색, post 레이아웃.
목록으로 쓴 타임라인
- 설치: 알림, 섹션, 카드, 탭.
- 작성: 디자인 토큰, 내비게이션.
- 확인: 테마 전환, 목차, 단계.
키보드 키
Ctrl+K나 /만 눌러도 검색이 열립니다. 복사는 Cmd+C입니다.
표
| 키 | 유형 | 기본값 | 설명 |
|---|---|---|---|
badges |
boolean | true |
상태 코드 스팬을 배지로 바꿈 |
color_scheme |
string | auto |
운영체제 설정을 따르거나 색 구성을 고정 |
components |
list | 모든 핵심 컴포넌트 | 브라우저로 보내는 CSS와 JavaScript를 줄임 |
tokens |
map | 테마 기본값 | 주 색상, 모서리 반경, 글꼴 스택 같은 디자인 토큰을 덮어씀 |
| 왼쪽 | 가운데 | 오른쪽 |
|---|---|---|
| a | b | 1 |
| 긴 셀 | 가운데 정렬 | 1,000 |
코드
인라인 code, 펜스 코드 블록, 가로로 스크롤되는 긴 줄:
# frozen_string_literal: true
Jekyll::Hooks.register :site, :post_write do |site|
puts "Built #{site.pages.size} pages into #{site.dest} with a deliberately long line to test horizontal scrolling"
end
- theme: minima
+ theme: jekyll-theme-modootoday
타이포그래피
굵게, 기울임, 취소선, code, 컴포넌트 목록 링크가 있는 문단입니다. 각주도 쓸 수 있습니다.1
3단계 제목
4단계 제목
- 번호 항목
- 번호 항목
- 중첩 항목
- 중첩 항목
- 완료한 작업
- 남은 작업
알림이 아닌 일반 인용문입니다.
구분선 다음의 글입니다.
- 1
- 2
- 3
행동 유도
코드 제목과 diff
사용 가능 펜스 코드 블록 바로 앞에 file과 콜론으로 시작하는 코드 스팬만 있는 줄을 두면 블록의 제목 표시줄이 됩니다. diff 블록은 추가된 줄과 삭제된 줄에 색을 입히고 더하기·빼기 기호를 유지합니다.
파일: _config.yml
theme: jekyll-theme-modootoday
- remote_theme: old/theme
+ theme: jekyll-theme-modootoday
진행률
사용 가능 progress와 콜론 뒤에 0부터 100까지의 정수가 오는 코드 스팬은 값을 텍스트로 함께 보여 주는 레이블 있는 진행률 막대가 됩니다.
번역 60%
임베드
사용 가능 embed와 콜론, https URL, 선택 제목으로 된 코드 스팬만 있는 문단은 지연 로드되는 16:9 프레임이 되며, 로드되는 동안에도 자리를 유지합니다.
로딩과 스켈레톤
사용 가능 loading 또는 skeleton과 콜론으로 시작하는 코드 스팬은 스피너, 얇은 상단 막대, 자리 표시자(text, card, image, avatar, row)가 됩니다. 모두 role="status"와 스크린 리더용 로딩 레이블이 붙고, 사용자가 동작 줄이기를 켜면 움직이지 않습니다. 스타일은 별도 스타일시트에 있어 이 요소를 쓰는 페이지만 불러옵니다.
불러오는 중…
불러오는 중… 불러오는 중… 불러오는 중…
파일 트리
사용 가능 c: filetree 섹션에서는 중첩 목록이 폴더 트리로 그려집니다. 하위 목록이 있는 항목은 폴더입니다.
- docs
- _config.yml
- index.md
- ko
- index.md
세부 정보
사용 가능 c: details 섹션에서는 각 ### 제목이 브라우저 기본 펼침 요소가 됩니다. JavaScript 없이 열고 닫힙니다.
무엇이 필요한가요?
브라우저만 있으면 됩니다.
자주 묻는 질문
사용 가능 c: faq 섹션은 세부 정보처럼 동작합니다. FAQPage 구조화 데이터가 필요하면 schema: 블록을 추가하세요(구조화 데이터 참고).
테마는 무료인가요?
네, MIT 라이선스입니다.
GitHub Pages에서 동작하나요?
네, github-pages gem으로 동작합니다.
매개변수 표
사용 가능 c: params 섹션에서는 표가 옵션을 이름, 유형, 기본값, 설명으로 나열합니다. 필수만 있는 셀은 필수 배지로 표시됩니다.
| 이름 | 유형 | 기본값 | 설명 |
|---|---|---|---|
title |
문자열 | 필수 | 페이지 제목 |
cols |
숫자 | 2 | 카드 열 수 |
링크 카드
사용 가능 c: linkcards 섹션에서는 링크로 시작하는 목록 항목이 카드가 됩니다. 카드 전체가 링크 대상입니다.
인용
사용 가능 c: quote 섹션에서는 마지막 줄이 줄표(—)로 시작하는 인용문의 그 줄이 출처가 됩니다.
문서가 github.com에서도 사이트에서도 잘 읽힙니다.
갤러리
사용 가능 c: gallery 섹션에서는 이미지 목록이 썸네일 격자가 됩니다. 각 썸네일은 JavaScript 없이 원본 크기 보기를 엽니다. 모든 이미지에 대체 텍스트가 필요합니다.
요금제
사용 가능 c: pricing 섹션에서는 각 ### 제목이 가격, 기능 목록, 링크로 이루어진 요금제 카드가 됩니다. recommended 매개변수는 한 요금제에 추천 레이블을 붙입니다.
구독
사용 가능 c: subscribe 섹션은 텍스트와 modootoday.subscribe.action의 주소로 전송하는 이메일 양식을 표시합니다. 이 설정이 없으면 텍스트만 표시합니다. 여기서는 항목에 bleed: true도 있습니다. 모든 섹션 항목과 hero:에 쓸 수 있으며, 내용은 읽기 폭을 유지한 채 --mt-bleed-bg(기본값은 muted 표면색) 배경 띠가 화면 전체 폭으로 깔립니다. bleed: wide는 내용 폭도 컨테이너 폭까지 넓힙니다. 사이드바나 목차가 있는 페이지에서는 띠가 본문 열 안에 머뭅니다.
릴리스가 나오면 이메일을 한 통 받으세요.
분할
사용 가능 c: split 섹션은 48rem 이상에서 텍스트와 그림을 나란히 놓고, 그보다 좁으면 위아래로 쌓습니다. 그림은 visual: include입니다. side: start는 그림을 시작 쪽으로 옮기고, ratio: "5:7"은 그림에 넓은 열을 줍니다. 여기의 label:처럼 항목의 다른 키는 include에서 include.section.label로 받습니다. 이 그림은 일러스트입니다. class="mt-illustration", role="img", aria-label이 있는 figure이고, .mt-illustration-tag 배지의 글자도 레이블에 들어 있습니다. decor: decor-demo는 위쪽 모서리의 점을 aria-hidden 장식으로 더합니다. 히어로도 같은 형태를 쓸 수 있습니다. hero: {c: split, visual: <이름>, side: start, ratio: "5:7"}는 제목, 리드 문단, 체크 행, 버튼을 텍스트 열에 두고 include를 그 옆에 놓습니다. 키친 싱크의 히어로가 이 형태입니다.
한쪽에는 텍스트, 다른 쪽에는 그림이 옵니다.
코드 분할
사용 가능 c: split 섹션이나 분할 히어로의 visual: code는 include가 필요 없습니다. 그 섹션의 첫 코드 블록(file: 제목이 있으면 제목 포함)이 그림 열로 옮겨지고, 코드 스타일과 복사 버튼은 그대로입니다. chrome: terminal(사용하는 페이지에만 연결되는 작은 시트)은 테두리와 장식용 막대를 더하며, 스크린 리더는 이 막대를 건너뜁니다. 다른 곳에서 visual: code는 계속 _includes/sections/code.html을 뜻합니다.
키트를 설치한 뒤 빌드할 때마다 검사기를 실행합니다.
파일: terminal
bundle add jekyll-theme-modootoday
bundle exec modootoday-check . _site
목록
사용 가능 _config.yml에 modootoday.lists를 두면 일반 섹션과 페이지에 목록 스타일 두 가지가 적용됩니다. link_chips: true는 모든 항목이 링크 하나뿐인 목록을 칩 한 줄로 바꾸고, titled_items: true는 굵은 제목과 콜론으로 시작하는 항목에 제목과 구분자를 따로 줍니다. hero: {checks: true}는 위처럼 히어로의 첫 목록을 체크 표시 줄로 바꿉니다. 컴포넌트 섹션의 목록은 원래 스타일을 유지합니다.
제목이 있는 항목:
- 칩: 링크만 있는 목록
- 제목 항목: 굵은 제목, 콜론, 그다음 텍스트
-
각주입니다. ↩





