/* ============================================================
   doc — 튜토리얼 문서 영역 (ROS 2 공식 문서 형태의 3단)

   색·크기·여백 리터럴 금지. tokens.css 의 var() 만 씁니다.
   1px 테두리와 100% 같은 구조값은 예외입니다 (base.css 와 같은 기준).

   미디어쿼리 기준점 1024 / 640 은 tokens.css 가 이미 쓰는 값입니다.
   CSS 변수는 @media 조건에 넣을 수 없어 숫자로 둡니다.
   ============================================================ */

/* ------------------------------------------------------------
   3단 골격
   ------------------------------------------------------------ */

/* 2단: 목차 + 본문. 오른쪽 "이 페이지" 목차는 뺐습니다 (layouts/doc.php 주석).
   본문은 읽기 좋은 폭(--doc-content-w)까지만 늘어납니다. 화면이 더 넓으면
   오른쪽이 비는 쪽이, 줄이 한없이 길어지는 것보다 읽기 쉽습니다. */
.doc {
  display: grid;
  grid-template-columns: var(--doc-sidebar-w) minmax(0, var(--doc-content-w));
  grid-template-areas:
    "toggle toggle"
    "tree   main";
  gap: 0;
  max-width: var(--doc-max-w);
  margin: 0;
  padding: 0;
  align-items: start;
}

/* 가운데 정렬을 쓰지 않습니다.
   ROS 2 공식 문서와 wikidocs 모두 목차를 화면 왼쪽 끝에 고정합니다.
   문서 사이를 오갈 때 목차가 자리를 안 옮기는 것이 중요하고,
   편집 화면과 같은 자리에 떠야 오갈 때 눈이 안 흔들립니다. */

.doc__toggle       { display: none; }          /* 체크박스 본체는 늘 숨김 */
.doc__toggle-label { grid-area: toggle; display: none; }

.doc__tree {
  grid-area: tree;
  padding: var(--section-y) var(--gutter-sm);
}

.doc__toc {
  grid-area: toc;
  padding: var(--section-y) var(--gutter-sm);
}

/* 본문만 흰 바탕입니다. 좌우 테두리가 목차와 본문을 가릅니다.
   선을 목차 쪽이 아니라 본문 쪽에 붙인 이유는,
   본문이 항상 더 길어서 선이 중간에 끊기지 않기 때문입니다. */
.doc__main {
  grid-area: main;
  min-width: 0;
  padding: var(--section-y) var(--gutter);
  background: var(--bg-card);
  border-left: 1px solid var(--border);
  border-right: 1px solid var(--border);
}

/* 좌우는 스크롤을 따라옵니다. 문서가 길어도 트리를 잃지 않게. */
.doc__tree,
.doc__toc {
  position: sticky;
  top: 0;
  max-height: calc(100vh - var(--header-h));
  overflow-y: auto;
  font-size: var(--fs-sm);
}

@media (max-width: 1024px) {
  .doc {
    grid-template-columns: var(--doc-sidebar-w) minmax(0, 1fr);
    grid-template-areas:
      "toggle toggle"
      "tree   main";
  }

  .doc__toc { display: none; }                  /* 우측 목차 숨김 */
}

@media (max-width: 640px) {
  .doc {
    grid-template-columns: minmax(0, 1fr);
    grid-template-areas:
      "toggle"
      "tree"
      "main";
    gap: 0;
  }

  .doc__main { border-left: 0; border-right: 0; }

  /* 트리를 "목차" 버튼 안으로. 자바스크립트 없이 체크박스로 여닫습니다. */
  .doc__toggle-label {
    display: block;
    padding: var(--row-y) var(--gutter-sm);
    background: var(--bg-card);
    border: 1px solid var(--border);
    border-radius: var(--radius);
    color: var(--ink);
    font-size: var(--fs-sm);
    font-weight: 700;
    cursor: pointer;
  }

  .doc__toggle-label::before { content: "\2630\00a0\00a0"; }

  .doc__tree { display: none; position: static; max-height: none; }
  .doc__toggle:checked ~ .doc__tree { display: block; }
}

/* ------------------------------------------------------------
   좌측 트리
   ------------------------------------------------------------ */

.doc-tree__book {
  margin: 0 0 var(--row-y);
  padding: 0 0 var(--row-y);
  border-bottom: 1px solid var(--border);
  font-weight: 700;
  letter-spacing: var(--tracking-head);
}

.doc-tree__book a { color: var(--ink); }

.doc-tree__list {
  list-style: none;
  margin: 0;
  padding: 0;
}

.doc-tree__list--l1 { padding-left: var(--gutter-sm); }
.doc-tree__list--l2 { padding-left: var(--gutter-sm); }

.doc-tree__link {
  display: block;
  padding: calc(var(--row-y) / 3) 0;
  color: var(--ink-soft);
  line-height: var(--lh-normal);
  text-decoration: none;
}

.doc-tree__link:hover {
  color: var(--accent);
  text-decoration: none;
}

/* 현재 문서. 왼쪽 선 하나로 표시합니다 (ROS 2 문서와 같은 방식) */
.doc-tree__link.is-current {
  color: var(--accent);
  font-weight: 700;
  box-shadow: inset 2px 0 0 var(--accent);
  padding-left: calc(var(--gutter-sm) / 2);
}

.doc-tree__flag,
.doc-tree__empty {
  color: var(--ink-faint);
  font-size: var(--fs-label);
}

.doc-tree__flag { margin-left: calc(var(--row-y) / 2); }
.doc-tree__empty { margin: 0; }

/* ---- 아코디언 (doc-tree.php · doc.js) ----
   접힌 가지는 보이지 않고, 지금 문서가 든 최상위 가지는 회색 바탕으로 묶습니다.
   (ROS 2 문서의 Distributions 펼친 모양) */

.doc-tree__item.has-kids:not(.is-open) > .doc-tree__kids { display: none; }

.doc-tree__row {
  display: flex;
  align-items: flex-start;
  gap: calc(var(--row-y) / 3);
}

.doc-tree__row .doc-tree__link { flex: 1 1 auto; min-width: 0; }

/* ⊞ / ⊟ 상자. 글자가 아니라 선으로 그려 어느 글꼴에서도 같은 모양입니다. */
.doc-tree__tog {
  position: relative;
  flex: 0 0 auto;
  width: 13px;
  height: 13px;
  margin-top: calc(var(--row-y) / 3 + 5px);
  padding: 0;
  background: none;
  border: 1px solid var(--ink-faint);
  border-radius: var(--radius);
  cursor: pointer;
}

.doc-tree__tog::before,
.doc-tree__tog::after {
  content: "";
  position: absolute;
  top: 50%;
  left: 50%;
  background: var(--ink-muted);
  transform: translate(-50%, -50%);
}

.doc-tree__tog::before { width: 7px; height: 1px; }              /* ─ */
.doc-tree__tog::after  { width: 1px; height: 7px; }              /* │ */
.is-open > .doc-tree__row > .doc-tree__tog::after { display: none; }  /* 펼치면 − */

.doc-tree__tog:hover { border-color: var(--accent); }
.doc-tree__tog:hover::before,
.doc-tree__tog:hover::after { background: var(--accent); }

/* 자식 없는 문서도 같은 자리를 비워 제목 줄이 맞게 */
.doc-tree__tog--none { border-color: transparent; cursor: default; }
.doc-tree__tog--none::before,
.doc-tree__tog--none::after { display: none; }

/* 펼쳐진 최상위 가지. 처음에는 지금 문서가 든 가지이고,
   ⊞ 로 다른 가지를 펼치면 회색 바탕도 그쪽으로 옮겨갑니다. */
.doc-tree__list--l0 > .doc-tree__item.is-open {
  margin: calc(var(--row-y) / 4) calc(var(--gutter-sm) * -1);
  padding: calc(var(--row-y) / 4) var(--gutter-sm);
  background: var(--bg-alt);
  border-top: 1px solid var(--border);
  border-bottom: 1px solid var(--border);
}

.doc-tree__list--l0 > .doc-tree__item.is-open > .doc-tree__row > .doc-tree__link { color: var(--ink); font-weight: 700; }

.doc-tree__all {
  margin: var(--row-y) 0 0;
  padding: var(--row-y) 0 0;
  border-top: 1px solid var(--border);
  font-size: var(--fs-xs);
}

.doc-tree__all a { color: var(--ink-muted); }

/* ------------------------------------------------------------
   좌측 목차 색 — ROS 2 문서 방식

   접힌 쪽은 어두운 바탕에 흰 글자, 펼친 가지는 밝은 회색에 검은 글자.
   바탕이 정반대라 "지금 여기" 가 한눈에 들어옵니다.

   핸드오프의 "짙은 면은 페이지당 두 곳" 은 홍보 화면 규칙입니다.
   문서 화면은 읽는 도구라 길잡이가 눈에 띄는 쪽을 골랐습니다. (2026-09 결정)
   ------------------------------------------------------------ */

/* 내용이 짧아도 화면 끝까지 어두운 기둥이 이어지게 합니다.
   stretch 로 늘리면 sticky 가 풀려서, 최소 높이로 채웁니다. */
.doc__tree {
  min-height: calc(100vh - var(--header-h));
  background: var(--doc-nav-bg);
  color: var(--on-dark);
}

.doc__tree .doc-tree__book { border-bottom-color: var(--doc-nav-line); }
.doc__tree .doc-tree__book a { color: var(--on-dark); }

/* 파란 바탕 위 메뉴는 흰 글자. 회색 글자는 파랑 위에서 탁해 보여 쓰지 않습니다. */
.doc__tree .doc-tree__link { color: var(--on-dark); }
.doc__tree .doc-tree__link:hover { color: var(--doc-nav-soft); text-decoration: underline; }

.doc__tree .doc-tree__tog { border-color: var(--doc-nav-soft); }
.doc__tree .doc-tree__tog::before,
.doc__tree .doc-tree__tog::after { background: var(--on-dark); }
.doc__tree .doc-tree__tog--none { border-color: transparent; }

.doc__tree .doc-tree__flag,
.doc__tree .doc-tree__empty { color: var(--doc-nav-soft); }

.doc__tree .doc-tree__all { border-top-color: var(--doc-nav-line); }
.doc__tree .doc-tree__all a { color: var(--doc-nav-soft); }
.doc__tree .doc-tree__all a:hover { color: var(--on-dark); }

/* 펼친 가지 — 밝은 회색 바탕, 검은 글자 */
.doc__tree .doc-tree__list--l0 > .doc-tree__item.is-open {
  background: var(--bg-footer);
  border-color: var(--bg-footer);
}

.doc__tree .is-open .doc-tree__link { color: var(--ink-soft); }
.doc__tree .is-open .doc-tree__link:hover { color: var(--accent); }

.doc__tree .doc-tree__list--l0 > .doc-tree__item.is-open > .doc-tree__row > .doc-tree__link { color: var(--ink); }

.doc__tree .is-open .doc-tree__tog { border-color: var(--ink-muted); }
.doc__tree .is-open .doc-tree__tog::before,
.doc__tree .is-open .doc-tree__tog::after { background: var(--ink-soft); }
.doc__tree .is-open .doc-tree__tog--none { border-color: transparent; }

.doc__tree .is-open .doc-tree__flag { color: var(--ink-muted); }

/* 지금 문서 — 가장 진하게, 왼쪽 파란 선 */
.doc__tree .doc-tree__link.is-current,
.doc__tree .is-open .doc-tree__link.is-current {
  color: var(--ink);
  font-weight: 700;
}

/* 접힌 쪽에 있는 지금 문서(하위가 없는 최상위 문서)는 어두운 바탕 위라 흰 글자 */
.doc__tree .doc-tree__list--l0 > .doc-tree__item:not(.is-open) > .doc-tree__row > .doc-tree__link.is-current { color: var(--on-dark); }

/* ------------------------------------------------------------
   우측 "이 페이지" 목차
   ------------------------------------------------------------ */

.doc-toc__label {
  margin: 0 0 var(--row-y);
  font-family: var(--font-mono);
  font-size: var(--fs-label);
  letter-spacing: var(--tracking-label);
  color: var(--ink-faint);
}

.doc-toc__list {
  list-style: none;
  margin: 0;
  padding: 0 0 0 var(--gutter-sm);
  border-left: 1px solid var(--border);
}

.doc-toc__item--l3 { padding-left: var(--gutter-sm); }

.doc-toc__link {
  display: block;
  padding: calc(var(--row-y) / 4) 0;
  color: var(--ink-muted);
  font-size: var(--fs-xs);
  line-height: var(--lh-normal);
  text-decoration: none;
}

.doc-toc__link:hover { color: var(--accent); text-decoration: none; }

/* ------------------------------------------------------------
   머리말 · 배지 · 브레드크럼
   ------------------------------------------------------------ */

.doc-crumb {
  margin: 0 0 var(--row-y);
  color: var(--ink-faint);
  font-size: var(--fs-xs);
}

.doc-crumb a { color: var(--ink-muted); }
.doc-crumb__sep { padding: 0 calc(var(--row-y) / 3); }

.doc-head {
  margin: 0 0 var(--section-y);
  padding: 0 0 var(--row-y);
  border-bottom: 1px solid var(--border);
}

.doc-head__badges { margin: 0 0 var(--row-y); }

.doc-head__title {
  margin: 0;
  font-size: var(--fs-h1);
}

.doc-head__sub {
  margin: var(--row-y) 0 0;
  color: var(--ink-soft);
  font-size: var(--fs-lead);
}

.doc-head__meta {
  margin: var(--row-y) 0 0;
  color: var(--ink-faint);
  font-size: var(--fs-xs);
}

.doc-badge {
  display: inline-block;
  padding: calc(var(--row-y) / 4) calc(var(--row-y) / 2);
  border-radius: var(--radius);
  color: var(--on-dark);
  font-family: var(--font-mono);
  font-size: var(--fs-label);
  letter-spacing: var(--tracking-label);
}

.doc-badge--official   { background: var(--state-official); }
.doc-badge--instructor { background: var(--state-instructor); }
.doc-badge--draft      { background: var(--state-warn); }

.doc-badge__owner {
  margin-left: calc(var(--row-y) / 2);
  color: var(--ink-muted);
  font-size: var(--fs-xs);
}

/* 읽다가 틀린 것을 보면 바로 고칠 수 있게.
   권한이 있는 사람에게만 보입니다. */
.doc-head__edit {
  margin-left: calc(var(--row-y) / 2);
  padding: 0 calc(var(--row-y) / 2);
  border: 1px solid var(--border);
  border-radius: var(--radius);
  color: var(--ink-muted);
  font-size: var(--fs-xs);
}

.doc-head__edit:hover {
  border-color: var(--accent);
  color: var(--accent);
  text-decoration: none;
}

/* ------------------------------------------------------------
   본문 — MarkdownService 가 만든 HTML 이 들어오는 곳
   ------------------------------------------------------------ */

.doc-body { font-size: var(--fs-body); line-height: var(--lh-body); }

.doc-body h2 {
  margin: var(--section-y) 0 var(--row-y);
  padding: 0 0 calc(var(--row-y) / 2);
  border-bottom: 1px solid var(--border-soft);
  font-size: var(--fs-h2);
}

.doc-body h3 {
  margin: var(--section-y) 0 var(--row-y);
  font-size: var(--fs-h3);
}

.doc-body h4 {
  margin: var(--section-y) 0 var(--row-y);
  font-size: var(--fs-body);
  font-weight: 700;
}

/* 앵커로 뛰었을 때 제목이 헤더 밑에 숨지 않게 */
.doc-body h2[id],
.doc-body h3[id] { scroll-margin-top: var(--header-h); }

.doc-body p  { margin: 0 0 var(--row-y); }
.doc-body ul,
.doc-body ol { margin: 0 0 var(--row-y); padding-left: var(--gutter); }
.doc-body li { margin: 0 0 calc(var(--row-y) / 3); }

.doc-body img {
  max-width: 100%;
  height: auto;
  border: 1px solid var(--border-soft);
  border-radius: var(--radius);
}

/* ---- 이미지 크기와 정렬 ----
   에디터가 붙이는 클래스입니다. 값을 자유롭게 받지 않고
   네 단계로 고정한 이유는 MarkdownService 의 주석을 보세요. */

.doc-img { display: block; }

.doc-img--w25  { width: 25%; }
.doc-img--w50  { width: 50%; }
.doc-img--w75  { width: 75%; }
.doc-img--w100 { width: 100%; }

.doc-img--left   { margin-right: auto; }
.doc-img--center { margin-left: auto; margin-right: auto; }
.doc-img--right  { margin-left: auto; }

/* 좁은 화면에서는 비율을 무시하고 꽉 채웁니다.
   휴대에서 25% 짜리 스크린샷은 아무것도 안 보입니다. */
@media (max-width: 640px) {
  .doc-img--w25,
  .doc-img--w50,
  .doc-img--w75 { width: 100%; }
}

.doc-body hr {
  margin: var(--section-y) 0;
  border: 0;
  border-top: 1px solid var(--border);
}

.doc-body blockquote {
  margin: 0 0 var(--row-y);
  padding: var(--row-y) var(--gutter-sm);
  background: var(--bg-card);
  border-left: 2px solid var(--accent);
  color: var(--ink-soft);
}

.doc-body blockquote p:last-child { margin-bottom: 0; }

/* ---- 코드 ----
   ROS 2 자료라 명령어가 아주 많이 들어옵니다. 읽기 쉬워야 합니다.
   구문 색상(highlight.js)은 아직 붙이지 않았습니다. 클래스는
   language-bash 형태로 이미 나가고 있어 나중에 얹기만 하면 됩니다. */

.doc-body code {
  padding: 0 calc(var(--row-y) / 4);
  background: var(--bg-footer);
  border-radius: var(--radius);
  font-family: var(--font-mono);
  font-size: var(--fs-xs);
}

.doc-code {
  position: relative;
  margin: 0 0 var(--row-y);
  padding: var(--gutter-sm);
  background: var(--ink-hero);
  border-radius: var(--radius);
  overflow-x: auto;
}

/* 복사 버튼 자리를 비워둡니다. 명령어가 버튼 밑에 깔리면 안 됩니다. */
.doc-code.has-copy { padding-right: calc(var(--gutter) * 2); }

/* 복사 버튼을 담는 틀(doc.js). 버튼은 이 틀에 붙어 가로 스크롤을 따라가지 않습니다. */
.doc-code-wrap { position: relative; margin: 0 0 var(--row-y); }
.doc-code-wrap > .doc-code { margin: 0; }

/* ---- 긴 줄 — 네이버 방식 ----
   줄을 접지 않고 블록 맨 아래에 얇은 가로 스크롤바 하나만 둡니다.
   명령어는 접히면 복사해 붙였을 때 모양을 알아보기 어렵습니다.

   highlight.js 테마가 안쪽 <code> 에도 overflow-x 와 바탕색을 걸어서
   하얀 스크롤바가 하나 더 생겼습니다. 스크롤은 pre 하나에서만 합니다. */
.doc-code code,
.doc-code code.hljs {
  display: block;
  padding: 0;
  overflow: visible;
  background: none;
  white-space: pre;
}

.doc-code {
  scrollbar-width: thin;                              /* 파이어폭스 */
  scrollbar-color: var(--ink-muted) transparent;
}

.doc-code::-webkit-scrollbar { height: 8px; }
.doc-code::-webkit-scrollbar-track { background: transparent; }
.doc-code::-webkit-scrollbar-thumb {
  background: var(--ink-muted);
  border-radius: var(--radius);
}
.doc-code::-webkit-scrollbar-thumb:hover { background: var(--ink-faint); }

/* 아이콘 하나짜리 버튼(doc.js). 테두리 없이 두고 올렸을 때만 바탕이 생깁니다.
   선 색은 color 를 따릅니다(SVG currentColor). */
.doc-copy {
  position: absolute;
  top: calc(var(--row-y) / 2);
  right: calc(var(--row-y) / 2);
  display: flex;
  align-items: center;
  justify-content: center;
  width: 32px;
  height: 32px;
  padding: 0;
  background: none;
  border: 1px solid transparent;
  border-radius: var(--radius);
  color: var(--on-dark-muted);
  cursor: pointer;
}

.doc-copy svg { display: block; width: 16px; height: 16px; }

.doc-copy.is-done { color: var(--on-dark); border-color: var(--on-dark-muted); }
.doc-copy.is-error { color: var(--state-warn); border-color: var(--state-warn); }

.doc-copy:hover {
  background: var(--accent);
  border-color: var(--accent);
  color: var(--accent-ink);
}

.doc-copy.is-error {
  border-color: var(--state-warn);
  color: var(--state-warn);
}

.doc-code code {
  padding: 0;
  background: none;
  color: var(--on-dark-body);
  font-size: var(--fs-xs);
  line-height: var(--lh-normal);
  white-space: pre;
}

/* highlight.js 테마가 자기 배경을 깔고 오므로 다시 덮습니다.
   테마를 바꿔도 코드블록 배경은 사이트 색을 따르게 하기 위해서입니다.
   글자 색은 테마가 칠하도록 둡니다. 그게 구문 색칠하기니까요. */
.doc-code code.hljs,
.doc-code .hljs {
  padding: 0;
  background: none;
}

/* ---- 표 ---- */

.doc-table {
  width: 100%;
  margin: 0 0 var(--row-y);
  border-collapse: collapse;
  font-size: var(--fs-sm);
}

.doc-table th,
.doc-table td {
  padding: calc(var(--row-y) / 2) var(--gutter-sm);
  border: 1px solid var(--border);
  text-align: left;
  vertical-align: top;
}

.doc-table th { background: var(--bg-footer); font-weight: 700; }

.doc-table .is-center { text-align: center; }
.doc-table .is-right  { text-align: right; }

.doc-body__empty { color: var(--ink-faint); }

/* ------------------------------------------------------------
   출처

   가져온 자료임을 밝히는 줄입니다.
   본문과 섞이지 않게 왜쪽에 선 하나로 끊습니다.
   ------------------------------------------------------------ */

.doc-source {
  display: flex;
  align-items: baseline;
  gap: var(--gutter-sm);
  margin: var(--section-y) 0 0;
  padding: var(--row-y) var(--gutter-sm);
  border-left: 2px solid var(--border);
  color: var(--ink-muted);
  font-size: var(--fs-xs);
  line-height: var(--lh-normal);
}

.doc-source__label {
  flex: 0 0 auto;
  color: var(--ink-faint);
  font-family: var(--font-mono);
  font-size: var(--fs-label);
  letter-spacing: var(--tracking-label);
}

.doc-source__body { min-width: 0; }

.doc-source__license {
  margin-left: calc(var(--row-y) / 2);
  padding: 0 calc(var(--row-y) / 2);
  border: 1px solid var(--border);
  border-radius: var(--radius);
  color: var(--ink-faint);
  font-family: var(--font-mono);
  font-size: var(--fs-label);
}

/* ------------------------------------------------------------
   이전 / 다음

   상자를 쓰지 않습니다. MkDocs Material · Furo 가 하는 방식입니다.

     · 상자 두 개는 본문 끝에서 자리를 너무 많이 먹습니다
     · 둘이 같은 모양이면 어느 쪽이 앞인지 한눈에 안 들어옵니다

   화살표로 방향을 보이고, 다음 문서를 강조색으로 두었습니다.
   순서대로 읽는 사람이 대부분이라 다음이 기본 행동입니다.
   ------------------------------------------------------------ */

.doc-nav {
  display: flex;
  align-items: baseline;
  gap: var(--gutter-sm);
  margin: var(--section-y) 0 0;
  padding: var(--row-y) 0 0;
  border-top: 1px solid var(--border);
  font-size: var(--fs-sm);
}

.doc-nav__link {
  display: flex;
  align-items: baseline;
  gap: calc(var(--row-y) / 3);
  min-width: 0;
  text-decoration: none;
}

.doc-nav__link--next { margin-left: auto; }

/* "이전글" "다음글" — 네이버와 같은 말을 작게 붙입니다. */
.doc-nav__label {
  color: var(--ink-faint);
  font-size: var(--fs-xs);
  white-space: nowrap;
}

.doc-nav__link--prev::before { content: "\2190"; color: var(--ink-faint); }
.doc-nav__link--next::after  { content: "\2192"; color: var(--accent); }

.doc-nav__title {
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
  font-weight: 400;
}

.doc-nav__link--prev .doc-nav__title { color: var(--ink-muted); }
.doc-nav__link--next .doc-nav__title { color: var(--accent); font-weight: 700; }

.doc-nav__link:hover .doc-nav__title { text-decoration: underline; }

/* 좁은 화면에서도 한 줄입니다. 제목이 길면 뒤를 자릅니다.
   세로로 쌓으면 본문을 다 읽고 난 뒤에 또 두 줄이 남습니다. */
@media (max-width: 640px) {
  .doc-nav__link { max-width: 48%; }
  .doc-nav__title { font-size: var(--fs-xs); }
}

/* ------------------------------------------------------------
   하단 출강 문의 CTA — 검색으로 들어온 사람의 유일한 접점
   ------------------------------------------------------------ */

.doc-cta {
  display: flex;
  align-items: center;
  gap: var(--gutter-sm);
  flex-wrap: wrap;
  margin: var(--section-y) 0 0;
  padding: var(--row-y) var(--gutter-sm);
  background: var(--bg-card);
  border: 1px solid var(--border);
  border-radius: var(--radius);
  font-size: var(--fs-xs);
}

.doc-cta__text { color: var(--ink-muted); }

.doc-cta__link {
  margin-left: auto;
  color: var(--accent);
  font-weight: 700;
  white-space: nowrap;
}

/* ------------------------------------------------------------
   /tutorial 책 목록
   ------------------------------------------------------------ */

.doc-index { padding-top: var(--section-y); padding-bottom: var(--section-y); }

.doc-index__label {
  margin: 0 0 var(--row-y);
  font-family: var(--font-mono);
  font-size: var(--fs-label);
  letter-spacing: var(--tracking-label);
  color: var(--ink-faint);
}

.doc-index__title { margin: 0 0 var(--row-y); }

.doc-index__lead {
  margin: 0 0 var(--section-y);
  color: var(--ink-soft);
  font-size: var(--fs-lead);
}

.doc-index__list { list-style: none; margin: 0; padding: 0; }

.doc-index__item {
  padding: var(--card-gap) 0;
  border-top: 1px solid var(--border);
}

.doc-index__badges { margin: 0 0 calc(var(--row-y) / 2); }

.doc-index__name { margin: 0 0 calc(var(--row-y) / 2); font-size: var(--fs-h2); }
.doc-index__name a { color: var(--ink); }
.doc-index__name a:hover { color: var(--accent); text-decoration: none; }

.doc-index__sub  { margin: 0 0 calc(var(--row-y) / 2); color: var(--ink-muted); font-size: var(--fs-sm); }
.doc-index__desc { margin: 0; color: var(--ink-soft); font-size: var(--fs-sm); }

.doc-index__empty { color: var(--ink-faint); }

/* ------------------------------------------------------------
   /tutorial/{book} 표지의 목차
   ------------------------------------------------------------ */

.doc-book__desc { color: var(--ink-soft); }

.doc-book__toc-title {
  margin: var(--section-y) 0 var(--row-y);
  font-size: var(--fs-h2);
}

.doc-book__toc {
  margin: 0;
  padding-left: var(--gutter);
  line-height: var(--lh-normal);
}

.doc-book__toc--sub { margin: calc(var(--row-y) / 3) 0; }

.doc-book__toc-item { margin: 0 0 calc(var(--row-y) / 2); }

.doc-book__toc-excerpt {
  display: block;
  color: var(--ink-faint);
  font-size: var(--fs-xs);
}

.doc-book__empty { color: var(--ink-faint); }

/* ------------------------------------------------------------
   검색 — 좌측 목차 맨 위 칸 (layouts/doc.php) 과 결과 화면 (doc/search.php)
   ------------------------------------------------------------ */

/* 머리 상자 (layouts/doc.php) — 제목 · 로고 · 검색.
   목차 칸의 안쪽 여백을 거슬러(음수 여백) 칸 폭 가득, 맨 위까지 채웁니다.
   ROS 2 문서의 위쪽 파란 칸과 같은 모양입니다. */
.doc-brand {
  margin: calc(var(--section-y) * -1) calc(var(--gutter-sm) * -1) var(--row-y);
  padding: var(--row-y) var(--gutter-sm) var(--gutter-sm);
  background: var(--doc-brand-bg);
  border-bottom: 1px solid var(--doc-brand-edge);
  text-align: center;
}

.doc-brand__title {
  display: inline-flex;
  align-items: center;
  gap: calc(var(--row-y) / 3);
  margin: 0 0 var(--row-y);
  color: var(--on-dark);
  font-size: var(--fs-body);
  font-weight: 700;
  letter-spacing: var(--tracking-card);
  text-decoration: none;
}

.doc-brand__title:hover { color: var(--on-dark); text-decoration: underline; }

.doc-brand__home { width: 16px; height: 16px; fill: currentColor; }

.doc-search { margin: 0; }

/* 로고. 가운데, 누르면 홈으로. */
.doc-logo {
  display: block;
  width: 140px;
  margin: 0 auto var(--row-y);
}

.doc-logo img { display: block; width: 100%; height: auto; }

/* ROS 2 문서처럼 둥글고 흰 칸. 어두운 목차 위에 떠 보이게 합니다.
   모서리를 둥글게 하는 것은 입력칸이라 허용되는 자리입니다(핸드오프: 버튼·입력만). */
.doc-search__input {
  display: block;
  width: 100%;
  padding: calc(var(--row-y) / 2) var(--row-y);
  background: var(--bg);
  border: 1px solid var(--doc-brand-edge);
  text-align: left;
  border-radius: var(--row-y);
  color: var(--ink);
  font-family: var(--font-sans);
  font-size: var(--fs-sm);
}

.doc-search__input::placeholder { color: var(--ink-faint); }
.doc-search__input:focus { outline: 2px solid var(--accent); outline-offset: 1px; }

.doc-search__notice,
.doc-search__empty { color: var(--ink-muted); }

.doc-search__list { margin: 0; padding: 0; list-style: none; }

.doc-search__item {
  padding: var(--row-y) 0;
  border-bottom: 1px solid var(--border-soft);
}

.doc-search__title {
  font-size: var(--fs-h3);
  font-weight: 700;
  letter-spacing: var(--tracking-card);
}

.doc-search__book {
  margin-left: calc(var(--row-y) / 2);
  color: var(--ink-faint);
  font-size: var(--fs-xs);
}

.doc-search__snippet {
  margin: calc(var(--row-y) / 3) 0 0;
  color: var(--ink-soft);
  font-size: var(--fs-sm);
  line-height: var(--lh-normal);
  word-break: break-all;
}

.doc-search__list mark {
  padding: 0 1px;
  background: var(--accent);
  color: var(--accent-ink);
  border-radius: var(--radius);
}

/* ------------------------------------------------------------
   푸터의 출강 문의 띠 (components/doc-cta.php)

   본문 안에 있던 문의 상자를 여기로 옮겼습니다.
   한 줄 설명 + 버튼 하나.
   ------------------------------------------------------------ */

/* 한 줄 푸터. 설명 · 버튼 · 저작권을 가로로 나란히.
   두 줄로 쌓고 상하 여백을 크게 줬더니 본문보다 무겁게 보여 얇게 줄였습니다.
   좁은 화면에서는 자동으로 줄이 바뀝니다. */
.site-footer.doc-foot {
  display: flex;
  align-items: center;
  gap: var(--gutter-sm);
  flex-wrap: wrap;
  margin-top: 0;
  padding: calc(var(--row-y) * 0.75) var(--gutter);
}

.doc-foot-cta {
  display: flex;
  align-items: center;
  gap: var(--row-y);
  flex-wrap: wrap;
  margin: 0;
}

.doc-foot-cta__text {
  display: flex;
  align-items: baseline;
  gap: calc(var(--row-y) / 2);
  flex-wrap: wrap;
  margin: 0;
  font-size: var(--fs-xs);
  line-height: var(--lh-normal);
}

.doc-foot-cta__text strong { color: var(--ink); }
.doc-foot-cta__text span   { color: var(--ink-muted); }

.doc-foot__copy { margin-left: auto; }

.doc-foot-cta__btn {
  flex: 0 0 auto;
  padding: calc(var(--row-y) / 4) var(--row-y);
  background: var(--accent);
  border-radius: var(--radius);
  color: var(--accent-ink);
  font-size: var(--fs-xs);
  font-weight: 700;
  text-decoration: none;
}

.doc-foot-cta__btn:hover {
  background: var(--accent-hover);
  color: var(--accent-ink);
  text-decoration: none;
}

.doc-foot__copy { color: var(--ink-faint); }

/* ------------------------------------------------------------
   실습 파일 (본문 밑)

   네이버 블로그 파일 블록처럼 한 줄에 한 파일. 줄 전체가 링크입니다.
   ------------------------------------------------------------ */

.doc-files {
  margin: var(--section-y) 0 0;
  padding: var(--gutter-sm);
  background: var(--bg-alt);
  border: 1px solid var(--line);
}

.doc-files__title {
  display: flex;
  align-items: center;
  gap: calc(var(--row-y) / 2);
  margin: 0 0 var(--row-y);
  font-size: var(--fs-sm);
}

.doc-files__count {
  color: var(--accent);
  font-family: var(--font-mono);
  font-size: var(--fs-xs);
}

.doc-files__list { list-style: none; margin: 0; padding: 0; }

.doc-files__item {
  display: flex;
  align-items: center;
  gap: var(--row-y);
  margin: 0 0 calc(var(--row-y) / 3);
  padding: calc(var(--row-y) / 2) calc(var(--row-y) * 0.75);
  background: var(--bg);
  border: 1px solid var(--line);
  color: var(--ink);
  font-size: var(--fs-sm);
  text-decoration: none;
}

.doc-files__item:hover {
  border-color: var(--accent);
  color: var(--ink);
  text-decoration: none;
}

.doc-files__ext {
  flex: 0 0 auto;
  min-width: 44px;
  padding: calc(var(--row-y) / 6) calc(var(--row-y) / 3);
  background: var(--ink);
  color: var(--on-dark);
  font-family: var(--font-mono);
  font-size: var(--fs-label);
  text-align: center;
  text-transform: uppercase;
}

.doc-files__name {
  flex: 1 1 auto;
  min-width: 0;
  overflow: hidden;
  white-space: nowrap;
  text-overflow: ellipsis;
  color: var(--accent);
  font-family: var(--font-mono);
  font-size: var(--fs-xs);
  font-weight: 700;
}

.doc-files__size {
  flex: 0 0 auto;
  color: var(--ink-faint);
  font-family: var(--font-mono);
  font-size: var(--fs-label);
}

/* 내려받기 아이콘. 글자 대신 주황 화살표로 보여 줍니다. 모양은 아래 공통 규칙. */
.doc-files__get { flex: 0 0 auto; }

@media (max-width: 767px) {
  .doc-files__size { display: none; }
}

/* 본문 중간의 첨부 파일 링크 (/files/{uuid}). 에디터 툴바 "파일" 이 넣습니다.
   네이버 블로그 본문 속 파일 블록처럼 상자로 보이게 합니다.
   내려받기 권한은 /files/ 가 한 번 더 봅니다. */
.doc-body a[href^="/files/"] {
  display: inline-flex;
  align-items: center;
  gap: calc(var(--row-y) / 2);
  max-width: 100%;
  padding: calc(var(--row-y) / 3) calc(var(--row-y) * 0.75);
  background: var(--bg-alt);
  border: 1px solid var(--line);
  color: var(--accent);
  font-family: var(--font-mono);
  font-size: var(--fs-xs);
  font-weight: 700;
  text-decoration: none;
  word-break: break-all;
}

.doc-body a[href^="/files/"]:hover {
  border-color: var(--accent);
  color: var(--accent-hover);
  text-decoration: none;
}

/* 주황 다운로드 아이콘 — 본문 속 파일과 아래 첨부 목록이 같이 씁니다.
   SVG 를 모양(mask)으로만 쓰고 색은 토큰(--file-get)으로 칠합니다. */
.doc-body a[href^="/files/"]::after,
.doc-files__get {
  content: "";
  display: inline-block;
  flex: 0 0 auto;
  width: 18px;
  height: 18px;
  background: var(--file-get);
  -webkit-mask: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2.4' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M12 4v11M7 10l5 5 5-5M5 20h14'/%3E%3C/svg%3E") center / contain no-repeat;
          mask: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2.4' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M12 4v11M7 10l5 5 5-5M5 20h14'/%3E%3C/svg%3E") center / contain no-repeat;
}

/* ------------------------------------------------------------
   블로그 모양 (2026-10) — 카테고리 칸 · 글 목록 · 글 머리
   ------------------------------------------------------------ */

/* 왼쪽 카테고리 칸 제목과 글 수 */
.doc-tree__head {
  margin: 0 0 calc(var(--row-y) / 2);
  padding: 0 0 calc(var(--row-y) / 2);
  border-bottom: 1px solid var(--doc-nav-line);
  color: var(--doc-nav-soft);
  font-size: var(--fs-label);
  letter-spacing: var(--tracking-label);
}

.doc-tree__n {
  color: var(--doc-nav-soft);
  font-size: var(--fs-label);
  font-weight: 400;
}

.doc__tree .is-open .doc-tree__n { color: var(--ink-muted); }

/* 글 목록 머리: 제목 · 글 수 · [글쓰기] */
.blog-head {
  display: flex;
  align-items: center;
  gap: var(--gutter-sm);
  margin: 0 0 var(--row-y);
  padding: 0 0 var(--row-y);
  border-bottom: 2px solid var(--ink);
}

.blog-head__title {
  margin: 0;
  font-size: var(--fs-h2);
}

.blog-head__n {
  margin-left: calc(var(--row-y) / 2);
  color: var(--ink-faint);
  font-size: var(--fs-sm);
  font-weight: 400;
}

.blog-head__write { margin: 0 0 0 auto; }

.blog-btn {
  display: inline-block;
  padding: calc(var(--row-y) / 3) var(--row-y);
  background: var(--accent);
  border: 1px solid var(--accent);
  border-radius: var(--radius);
  color: var(--accent-ink);
  font-size: var(--fs-sm);
  font-weight: 700;
  cursor: pointer;
  text-decoration: none;
}

.blog-btn:hover { background: var(--accent-hover); color: var(--accent-ink); text-decoration: none; }

.blog-btn--line {
  background: var(--bg-card);
  border-color: var(--border);
  color: var(--ink-soft);
  font-weight: 400;
}

.blog-btn--line:hover { background: var(--bg-card); border-color: var(--ink-muted); color: var(--ink); }

.blog-intro { margin: 0 0 var(--row-y); color: var(--ink-soft); }
.blog-empty { color: var(--ink-faint); }

/* 글 목록 표 — 네이버 "글 목록" 처럼 제목 · 작성일 두 칸 */
.blog-list {
  width: 100%;
  border-collapse: collapse;
  font-size: var(--fs-sm);
}

.blog-list th {
  padding: calc(var(--row-y) / 2) 0;
  border-bottom: 1px solid var(--border);
  color: var(--ink-faint);
  font-size: var(--fs-xs);
  font-weight: 400;
  text-align: left;
}

.blog-list td {
  padding: calc(var(--row-y) * 0.75) 0;
  border-bottom: 1px solid var(--border-soft);
  vertical-align: top;
}

.blog-list__date {
  width: 7em;
  color: var(--ink-faint);
  font-size: var(--fs-xs);
  text-align: right;
  white-space: nowrap;
}

.blog-list th.blog-list__date { text-align: right; }

.blog-list__title { color: var(--ink); font-weight: 700; }
.blog-list__title:hover { color: var(--accent); }

.blog-list__cat,
.blog-list__lock {
  margin-left: calc(var(--row-y) / 2);
  color: var(--ink-faint);
  font-size: var(--fs-xs);
}

.blog-list__lock { color: var(--state-warn); }

.blog-list__excerpt {
  display: block;
  margin-top: calc(var(--row-y) / 4);
  overflow: hidden;
  color: var(--ink-muted);
  font-size: var(--fs-xs);
  white-space: nowrap;
  text-overflow: ellipsis;
  max-width: 60ch;
}

.blog-pager {
  display: flex;
  justify-content: center;
  gap: var(--row-y);
  margin: var(--section-y) 0 0;
  font-size: var(--fs-sm);
}

.blog-pager a { color: var(--ink-muted); }
.blog-pager strong { color: var(--accent); }

/* 글 머리 아래 줄: 날짜 · 수정 · 삭제 */
.doc-head__line {
  display: flex;
  align-items: baseline;
  gap: var(--gutter-sm);
  margin: var(--row-y) 0 0;
}

.doc-head__line .doc-head__meta { margin: 0; }

.doc-head__tools {
  display: flex;
  align-items: baseline;
  gap: calc(var(--row-y) / 2);
  margin-left: auto;
  font-size: var(--fs-xs);
}

.doc-head__tools a,
.doc-head__tools button {
  padding: 0;
  background: none;
  border: 0;
  color: var(--ink-muted);
  font: inherit;
  cursor: pointer;
}

.doc-head__tools a:hover,
.doc-head__tools button:hover { color: var(--accent); text-decoration: underline; }

.doc-head__tools form { margin: 0; }

.doc-list-link {
  margin: var(--row-y) 0 0;
  text-align: right;
}
