Skip to content

Commit 8d239ce

Browse files
committed
Share the hub's header on every page and suggest related searches
Library, game, lab, article, Builder and 404 pages now carry the same six stops as the hub, the current page marked on the rail, and the next forum badge (header.js). Every library search box lists matching topics and glossary terms as you type, with Korean initials, English names and abbreviations, and a note when a topic matches only through a keyword (suggest.js). Searches are recorded on the library page with where they came from (typed, enter, suggest, try, hero, topics, link) and whether anything was found; a search from the hub is recorded when it lands. A search with only glossary hits opens the glossary, and an empty result offers Pseudo. Discord links use the new onboarding invite.
1 parent ca8afe4 commit 8d239ce

14 files changed

Lines changed: 292 additions & 26 deletions

File tree

‎404.html‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,8 @@
1616
<header class="site-header">
1717
<div class="wrap header-row">
1818
<a class="brand" href="/"><img class="brand-logo" src="/assets/img/team-mark.png" alt="" width="34" height="34"><span class="brand-text"><span class="brand-name">Causal Inference Hub</span><span class="brand-sub">가짜연구소 인과추론팀</span></span></a>
19-
<nav class="site-nav" aria-label="주요 메뉴"><a href="/library.html">자료실</a><a href="/#curriculum">커리큘럼</a><a href="/game.html">게임</a><a href="/lab.html">실험실</a><a href="/builders/">Builder</a><a href="/#join">참여하기</a></nav>
19+
<nav class="site-nav" aria-label="주요 메뉴"><a href="/#curriculum" class="stn s-main">커리큘럼</a><a href="/library.html" class="stn s-topics">자료실</a><a href="/#contrib" class="stn s-ml">Builder</a><a href="/#events" class="stn s-exp">행사</a><a href="/#posts" class="stn s-behavior">연재</a><a href="/#join" class="stn s-research" data-event="click_join" data-event-params='{"target":"pseudo","source":"nav"}'>참여하기</a></nav>
20+
<a class="hdr-ev" id="hdr-event" hidden></a>
2021
<button type="button" class="pass-btn" data-passport aria-label="활동 여권 열기">여권 <b data-passport-count>0/9</b></button>
2122
</div>
2223
</header>
@@ -29,5 +30,6 @@ <h1>페이지를 찾을 수 없습니다</h1>
2930
</main>
3031
<script src="/assets/js/track.js" defer></script>
3132
<script src="/assets/js/passport.js" defer></script>
33+
<script src="/assets/js/header.js" defer></script>
3234
</body>
3335
</html>

‎CONTRIBUTING.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,9 @@ PR을 올리기 전에 `python3 scripts/check_data.py`를 실행해 주세요.
2323
| `data/topics.json` | 자료실의 주제와 자료를 고칠 때. 주제마다 `shelf`(`causal` 인과추론, `exp` 온라인 실험), `name`, `about`, 검색어 `keys`, 자료 `items`를 적습니다. 자료는 `kind`(`video`·`read`·`code`·`slides`·`case`), `repo`(`repos.json`의 레포), `title`, `url`이고, 영상에 딸린 노트북은 `notebook`, 발표 자료 PDF는 `slides`로 붙입니다. 연재 글은 `articles.json`에 `topics`(주제 id 목록)를 적으면 공개일부터 그 주제에 함께 나옵니다. |
2424
| `data/experiments.json` | 허브에서 Iterglow(가짜연구소 실험 플랫폼)로 A/B 테스트를 돌릴 때. 기본은 꺼져 있습니다(`"enabled": false`). 켜려면 관리자가 만든 sdk_v1 실험의 `experimentId`와 연결된 flag의 `flagKey`를 실험마다 적고 `enabled`를 `true`로 바꿉니다. 공개 SDK 키(`pk_…`)는 저장소에 적지 않고(`apiKey`는 비워 둡니다) 저장소 Actions secret `ITERGLOW_SDK_KEY`에 둡니다. 배포가 실험이 켜져 있을 때만 그 키를 게시본에 넣고, secret이 없으면 실험은 꺼진 채로 배포됩니다. 공개 키는 실험이 켜지면 방문자 브라우저로 전달되는 값이라 관리 권한은 없지만, 서버 키나 계정 세션은 어디에도 넣지 않습니다. `goals`는 허브가 이미 보내는 이벤트 이름을 Iterglow 지표 이름에 잇습니다. 켜져 있는 동안 SDK가 방문자 브라우저에 익명 ID(`experibase_uid`)를 만들고, 그 ID와 페이지 경로, 기기 종류를 Iterglow로 보냅니다. 첫 실험은 `pseudo-greeting`(Pseudo가 먼저 인사하기)이고, 코드는 `assets/js/experiment.js`에 있습니다. |
2525
| `data/pseudo.json` | Pseudo가 용어를 설명할 때 쓰는 한두 문장 풀이. 키는 `glossary.json`의 용어 id(`term-…`)입니다. 풀이가 없는 용어는 원어와 웹북 장만 알려 줍니다. 해요체로, 예시를 하나 넣어 짧게 씁니다. 다른 용어를 쓸 때는 용어집의 번역어 그대로 씁니다(예: 처치군이 아니라 실험군). 배포 때마다 웹북 용어집을 새로 읽고, 웹북에서 사라진 용어나 다른 표기를 쓴 풀이는 `check_data.py`가 경고로 알려 줍니다. |
26-
| `assets/js/helper.js` | Pseudo(자료실 마스코트)의 답과 추천 질문, 마스코트가 먼저 거는 말(`LINES`: 페이지마다 첫 인사와 특정 섹션·스크롤 위치에서 한 번씩, 방문당 한 번, 닫으면 그 방문 동안 조용히)을 고칠 때. Pseudo는 `topics.json`의 이름·`keys`와 `glossary.json`의 용어로 답을 찾으므로, 잘 못 찾는 질문이 있으면 먼저 해당 주제의 `keys`를 늘려 보세요. 질문 내용은 `helper_ask` 이벤트(앞 100자)로만 남고 저장하지 않습니다. |
26+
| `assets/js/helper.js` | Pseudo(자료실 마스코트)의 답과 추천 질문, 마스코트가 먼저 거는 말(`LINES`: 페이지마다 첫 인사와 특정 섹션·스크롤 위치에서 한 번씩, 방문당 한 번, 닫으면 그 방문 동안 조용히)을 고칠 때. Pseudo는 `topics.json`의 이름·`keys`와 `glossary.json`의 용어로 답을 찾으므로, 잘 못 찾는 질문이 있으면 먼저 해당 주제의 `keys`를 늘려 보세요. 방문자가 적은 문장은 어디에도 보내지 않고, `helper_ask` 이벤트에는 질문이 들어온 경로(`source`)와 답의 종류(`answer`)만 남습니다. |
27+
| `assets/js/header.js` | 허브가 아닌 페이지(자료실, 게임, 실험실, 글, Builder, 404)의 상단. 메뉴는 허브와 같은 여섯 곳이고, 다음 Data Forum 배지를 `events.json`에서 그립니다. 메뉴를 바꿀 때는 `index.html`, 각 페이지, `scripts/build_builders.py`의 `site-nav`를 함께 고칩니다. |
28+
| `assets/js/suggest.js` | 검색창 아래 관련 검색어. `data-suggest`가 붙은 입력창에서 `topics.json`의 주제(이름·영문·`keys`)와 `glossary.json`의 용어(번역어·다른 표기·원어)를 찾고, 한글 초성(ㅇㅈㅊㅂ)과 영문 약어(DID)도 받습니다. 주제가 숨은 키워드로만 걸리면 어떤 키워드인지 함께 보여 줍니다. 잘 안 걸리는 말이 있으면 해당 주제의 `keys`를 늘리세요. |
2729
| `data/glossary.json` | 직접 고치지 않습니다. 배포할 때 `scripts/build_glossary.py`가 웹북 용어집 페이지를 읽어 새로 만듭니다. 용어를 고치려면 Causal-Inference-with-Python의 `TRANSLATION_GUIDE.md` 용어표를 고치세요. 웹북이 다시 배포된 다음 허브 배포 때 반영됩니다. |
2830
| `data/repos.json` | 레포를 추가하거나 설명·단계·트랙·상태를 바꿀 때 |
2931
| `data/map.json` | 트랙 지도에서 레포의 위치를 정할 때. 책과 강의(`paid`)의 표지와 소개도 여기서 고칩니다. |

‎README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -83,7 +83,7 @@
8383
3. **Builder로 프로젝트 열기:** 다음 기수에 직접 프로젝트를 엽니다. 레포는 [Project-template](https://github.com/CausalInferenceLab/Project-template)으로 시작합니다.
8484
4. **Builder라면:** [프로필·회고 양식](https://github.com/CausalInferenceLab/CausalInferenceLab.github.io/issues/new?template=builder-profile.yml)으로 한 줄 소개와 회고 세 줄을 남겨 주세요. Builder 페이지에 실립니다.
8585

86-
질문은 [가짜연구소 디스코드](https://discord.gg/QEdcGbYSQ)에 남겨 주세요.
86+
질문은 [가짜연구소 디스코드](https://discord.com/invite/EPurkHVtp2)에 남겨 주세요.
8787

8888
## English summary
8989

‎article.html‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,8 @@
2626
<img class="brand-logo" src="assets/img/team-mark.png" alt="" width="34" height="34">
2727
<span class="brand-text"><span class="brand-name">Causal Inference Hub</span><span class="brand-sub">가짜연구소 인과추론팀</span></span>
2828
</a>
29-
<nav class="site-nav" aria-label="주요 메뉴"><a href="library.html">자료실</a><a href="./#curriculum">커리큘럼</a><a href="game.html">게임</a><a href="lab.html">실험실</a><a href="builders/">Builder</a><a href="./#join">참여하기</a></nav>
29+
<nav class="site-nav" aria-label="주요 메뉴"><a href="/#curriculum" class="stn s-main">커리큘럼</a><a href="/library.html" class="stn s-topics">자료실</a><a href="/#contrib" class="stn s-ml">Builder</a><a href="/#events" class="stn s-exp">행사</a><a href="/#posts" class="stn s-behavior">연재</a><a href="/#join" class="stn s-research" data-helper-ask="같이 하고 싶어요" data-event="click_join" data-event-params='{"target":"pseudo","source":"nav"}'>참여하기</a></nav>
30+
<a class="hdr-ev" id="hdr-event" hidden></a>
3031
<button type="button" class="pass-btn" data-passport aria-label="활동 여권 열기">여권 <b data-passport-count>0/9</b></button>
3132
</div>
3233
</header>
@@ -62,6 +63,7 @@ <h2 id="more-title">다른 연재</h2>
6263
<script src="assets/js/article.js" defer></script>
6364
<script src="assets/js/track.js" defer></script>
6465
<script src="assets/js/passport.js" defer></script>
66+
<script src="assets/js/header.js" defer></script>
6567
<script src="assets/js/experiment.js" defer></script>
6668
<script src="assets/js/helper.js" defer></script>
6769
</body>

‎assets/css/hub.css‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2664,3 +2664,21 @@ body.has-helper .site-footer { padding-bottom: calc(96px + env(safe-area-inset-b
26642664
@media (max-width: 520px) { .lt-card.lt-slim { grid-template-columns: minmax(0, 1fr); } .lt-card.lt-slim .lt-t p:last-child { display: none; } }
26652665
/* the open-source list keeps to the top of its panel when the left column grows */
26662666
@media (min-width: 861px) { .hero .banner-side { justify-content: flex-start; align-self: center; } .hero .featured { align-content: start; } }
2667+
2668+
/* related searches under a search box (suggest.js) */
2669+
.sg-host { position: relative; }
2670+
.sg { position: absolute; z-index: 60; list-style: none; margin: 0; padding: 6px; min-width: 260px; background: var(--surface); color: var(--ink); border: 1px solid var(--rule); border-radius: 14px; box-shadow: 0 14px 36px rgba(20, 22, 43, .2); max-height: min(56vh, 430px); overflow-y: auto; overscroll-behavior: contain; text-align: left; }
2671+
.sg-head { padding: 6px 10px 6px; font-size: 12px; color: var(--muted); }
2672+
.sg-o { display: grid; grid-template-columns: auto minmax(0, 1fr); column-gap: 10px; row-gap: 1px; align-items: center; min-height: 46px; padding: 7px 10px; border-radius: 10px; cursor: pointer; }
2673+
.sg-o[aria-selected="true"] { background: var(--surface-2); box-shadow: inset 3px 0 0 var(--accent); }
2674+
.sg-k { grid-row: 1 / 3; align-self: center; font-size: 11.5px; font-weight: 800; padding: 3px 7px; border-radius: 6px; background: color-mix(in srgb, var(--l-main) 12%, var(--surface)); color: var(--l-main); }
2675+
.sg-o.t-term .sg-k { background: color-mix(in srgb, var(--l-exp) 12%, var(--surface)); color: var(--l-exp); }
2676+
.sg-l { font-size: 15px; font-weight: 600; line-height: 1.35; }
2677+
.sg-l b { font-weight: 800; color: var(--accent); }
2678+
.sg-s { font-size: 12.5px; color: var(--muted); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
2679+
@media (max-width: 520px) { .sg { max-height: 46vh; } .sg-head { display: none; } }
2680+
/* the hero lets the list hang below its card */
2681+
.hero .banner { overflow: visible; }
2682+
/* the header's current page on pages other than the hub */
2683+
.site-nav a.stn[aria-current="page"] { background: none; color: var(--ink); font-weight: 800; }
2684+
.site-nav a.stn[aria-current="page"]::after { background: var(--sec); transform: scale(1.25); }

‎assets/js/header.js‎

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
/* The header on every page other than the hub: the same six stops as the hub, and the next Data Forum
2+
badge until the day (sign-up while it is open, the date after). The hub draws its own (hub.js). */
3+
(() => {
4+
"use strict";
5+
const ROOT = new URL("../../", document.currentScript ? document.currentScript.src : location.href).href;
6+
const esc = (s) => String(s ?? "").replace(/[&<>"']/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" }[c]));
7+
const today = () => new Date(Date.now() + 9 * 3600e3).toISOString().slice(0, 10);
8+
const days = (iso) => Math.round((Date.parse(iso) - Date.parse(today())) / 864e5);
9+
const md = (iso) => { const [, m, d] = iso.split("-").map(Number); return `${m}.${d}`; };
10+
const WD = "일월화수목금토";
11+
const dot = (iso) => `${iso.replace(/-/g, ".")}(${WD[new Date(`${iso}T00:00:00Z`).getUTCDay()]})`;
12+
const ICON = '<svg class="hdr-ev-i" viewBox="0 0 20 20" aria-hidden="true"><path d="M3 6.5A1.5 1.5 0 0 1 4.5 5h11A1.5 1.5 0 0 1 17 6.5V8a2 2 0 0 0 0 4v1.5a1.5 1.5 0 0 1-1.5 1.5h-11A1.5 1.5 0 0 1 3 13.5V12a2 2 0 0 0 0-4z" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linejoin="round"/><path d="M12 5.5v9" stroke="currentColor" stroke-width="1.4" stroke-dasharray="1.6 1.6"/></svg>';
13+
14+
async function badge() {
15+
const el = document.getElementById("hdr-event");
16+
if (!el) return;
17+
let events = [];
18+
try { events = await fetch(`${ROOT}data/events.json`).then((r) => (r.ok ? r.json() : [])); } catch (e) { return; }
19+
const next = (Array.isArray(events) ? events : []).find((e) => e.upcoming && e.date && days(e.date) >= 0);
20+
if (!next) return;
21+
const t = today(), d = days(next.date), name = String(next.name).split(" - ")[0];
22+
const state = next.signupStart && t < next.signupStart ? "soon" : next.signupEnd && t > next.signupEnd ? "closed" : "open";
23+
const open = state === "open" && next.link;
24+
const title = open ? "참가자 모집 중" : state === "soon" ? "참가 신청 예정" : d === 0 ? "오늘 행사" : `행사 D-${d}`;
25+
const sub = open ? `${name} · ${next.signupEnd ? `${md(next.signupEnd)} 마감` : ""}` : state === "soon" ? `${name} · ${md(next.signupStart)} 오픈` : `${name} · ${dot(next.date)}`;
26+
el.className = `hdr-ev ${open ? "open" : state}`;
27+
if (open) { el.href = next.link; el.target = "_blank"; el.rel = "noopener"; } else el.href = `${ROOT}#events`;
28+
el.setAttribute("aria-label", `${name} ${title}${open ? ", 신청 페이지 열기" : ", 행사 안내로 이동"}`);
29+
el.dataset.event = "click_event";
30+
el.dataset.eventParams = JSON.stringify({ event_order: next.order, action: open ? "signup" : "event_info", placement: "header" });
31+
el.innerHTML = `${ICON}${open ? '<span class="hdr-ev-dot" aria-hidden="true"></span>' : ""}<span class="hdr-ev-t">${open ? '<span class="hdr-ev-long">참가자 </span>모집 중' : esc(title)}</span><span class="hdr-ev-s">${esc(sub)}</span>${open ? '<span class="hdr-ev-go" aria-hidden="true">↗</span>' : ""}`;
32+
el.hidden = false;
33+
}
34+
35+
/* the rail under the stops fills up to the page you are on */
36+
function rail() {
37+
const nav = document.querySelector(".site-nav"), stops = nav ? [...nav.querySelectorAll("a.stn")] : [];
38+
const i = stops.findIndex((a) => a.getAttribute("aria-current") === "page");
39+
if (nav && stops.length > 1) nav.style.setProperty("--p", String(i < 0 ? 0 : i / (stops.length - 1)));
40+
}
41+
42+
const start = () => { rail(); badge(); };
43+
if (document.readyState === "loading") document.addEventListener("DOMContentLoaded", start); else start();
44+
})();

‎assets/js/helper.js‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -256,7 +256,7 @@
256256
builders: { title: "Builder 둘러보기", url: "builders/", note: "지난 기수 프로젝트" },
257257
term: { title: "용어 제안하기", url: "https://github.com/CausalInferenceLab/Causal-Inference-with-Python/issues/new?template=term-proposal.yml", note: "웹북 번역어" },
258258
guide: { title: "허브에 올리는 방법", url: "https://github.com/CausalInferenceLab/CausalInferenceLab.github.io/blob/main/CONTRIBUTING.md", note: "데이터 파일 PR" },
259-
discord: { title: "가짜연구소 디스코드", url: "https://discord.gg/QEdcGbYSQ", note: "질문 · 참여 이야기", t: "discord" },
259+
discord: { title: "가짜연구소 디스코드", url: "https://discord.com/invite/EPurkHVtp2", note: "질문 · 참여 이야기", t: "discord" },
260260
linkedin: { title: "신진수 LinkedIn", url: "https://www.linkedin.com/in/jinsoo-shin-436060162", note: "협업 · 강연 · 제안", t: "linkedin" },
261261
/* the address is put together here so it is not sitting whole in the page source */
262262
mail: { title: "메일 보내기", url: "mailto:" + ["jsshin2013", "gmail.com"].join("@"), note: ["jsshin2013", "gmail.com"].join("@"), t: "email" }

0 commit comments

Comments
 (0)