feat: 프로젝트를 공개할 수 있게 하고, 홈이 무엇을 앞에 둘지 고를 수 있게 한다
공개 화면 다섯 곳이 조용히 비어 있었다. 원인은 하나씩 달랐지만 모두 "값을 채울 방법이 없었다"는 같은 모양이었다. 홈의 "지금 집중하는 것" — `home_focus_config` 는 마이그레이션이 빈 행 하나만 넣어 두었고, 계약에 선언된 `getHomeFocus`/`updateHomeFocus` 는 구현이 없었다. 세 슬롯이 모두 비면 홈은 그 영역을 아예 그리지 않으므로, 운영에서는 한 번도 나타난 적이 없다. Studio 대시보드에 고르는 화면을 둔다. 홈의 "최근 기록" — 화면이 공개된 프로젝트를 하나씩 돌며 타임라인을 조립했다. 그래서 게시한 문서라도 그 프로젝트가 공개되어 있지 않으면 목록에서 통째로 빠졌고, 실제로 릴리스 한 줄만 남았다. 무엇이 최근인지는 공개 투영이 이미 알고 있으므로 그것을 그대로 읽는다. 프로젝트마다 요청을 보내던 N+1 도 사라진다. 프로젝트 공개 — 프로젝트는 `RecordKind` 에 없어 문서 게시 파이프라인을 타지 못하는데, 공개 화면들(프로젝트 목록·프로필의 "현재 프로젝트"·홈 focus)은 전부 `public_resource_projection` 의 PROJECT 행을 가시성 관문으로 쓴다. 그 행을 세우는 경로가 없었으므로 프로젝트는 영원히 비공개였다. 계약에 이미 있던 `publishProject`/`unpublishProject` 를 구현하고 주제·프로젝트 화면에 버튼을 둔다. 문서 사이 관계 연결 — `JdbcCatalogQueryAdapter` 의 RELATION/EVIDENCE 가 `List.of()` 스텁이라 어떤 기록도 연결 대상 목록을 채울 수 없었다. RELATION 은 작성 중에 고르는 것이므로 작업본까지 포함하고, EVIDENCE 는 읽는 사람이 따라갈 수 있어야 하므로 공개된 것만 포함한다. 본문 너비 — 문서 한 편이 세 폭으로 갈라져 있었다. 머리말 920px, 유형·프로젝트 줄은 shell 전체 1180px, 본문은 672px 를 가운데 정렬. 셋을 같은 폭·같은 왼쪽 끝에 세우고 읽는 단을 56rem 으로 넓힌다. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XEHXspz4rv5pB5wiiSsVDu
This commit is contained in:
co-authored by
Claude Opus 5
parent
c03b0c77b8
commit
b3aa304975
@@ -180,14 +180,27 @@ function normalizeDirectives(source: string): string {
|
||||
return line;
|
||||
}
|
||||
|
||||
/*
|
||||
`:::name key="value"` 를 remark-directive 가 읽는 `:::name{key="value"}` 로 바꾼다.
|
||||
|
||||
이름과 나머지 사이의 경계를 `\s` 로 못 박는 것이 중요하다. 예전에는 이름을
|
||||
`[a-z0-9-]*` 로 두고 나머지가 `{` 로 시작하지 않기만 요구했는데, 정규식이 되돌아가며
|
||||
이름의 마지막 글자를 나머지 쪽으로 넘겨 그 조건을 피해 갔다 — `:::note` 는 이름 `not`
|
||||
에 본문 `e` 가 되어 `:::not{e}` 로, 이미 중괄호를 쓴 `:::table{id="t"}` 는
|
||||
`:::tabl{e{id="t"}}` 로 망가졌다. 그래서 속성 없는 디렉티브는 이름이 통째로 바뀌고,
|
||||
중괄호 형태는 아예 해석되지 않았다.
|
||||
*/
|
||||
return line.replace(
|
||||
/^(:::[a-z][a-z0-9-]*)([^\n{][^\n]*)(\n?)$/i,
|
||||
/^(:::[a-z][a-z0-9-]*)(\s+[^\n]*?)(\n?)$/i,
|
||||
(
|
||||
_match,
|
||||
marker: string,
|
||||
attributes: string,
|
||||
newline: string,
|
||||
) => `${marker}{${attributes.trim()}}${newline}`,
|
||||
) => {
|
||||
const trimmed = attributes.trim();
|
||||
return trimmed ? `${marker}{${trimmed}}${newline}` : `${marker}${newline}`;
|
||||
},
|
||||
);
|
||||
})
|
||||
.join("");
|
||||
@@ -199,6 +212,14 @@ function assertNever(value: never): never {
|
||||
|
||||
const trustedRelativeLinkOrigin = "https://techlog.invalid";
|
||||
|
||||
/** 서버가 아는 callout 이름과 화면에 붙일 말. 이름이 tone 을 겸하므로 속성을 받지 않는다. */
|
||||
const CALLOUT_LABELS: Readonly<Record<string, string>> = {
|
||||
note: "참고",
|
||||
tip: "도움말",
|
||||
warning: "주의",
|
||||
danger: "위험",
|
||||
};
|
||||
|
||||
function hasAsciiControlCharacter(value: string): boolean {
|
||||
return Array.from(value).some((character) => {
|
||||
const codePoint = character.codePointAt(0) ?? 0;
|
||||
@@ -326,8 +347,8 @@ function headingBlock(
|
||||
node: Heading,
|
||||
usedIds: Set<string>,
|
||||
): components["schemas"]["HeadingBlock"] {
|
||||
if (node.depth < 2 || node.depth > 4) {
|
||||
invalid(node, "only heading levels 2 through 4 are supported");
|
||||
if (node.depth < 1 || node.depth > 6) {
|
||||
invalid(node, "only heading levels 1 through 6 are supported");
|
||||
}
|
||||
|
||||
const children = [...node.children];
|
||||
@@ -417,15 +438,34 @@ function tableCellContent(cell: TableCell): Inline[] {
|
||||
return inlineFromNodes(cell.children);
|
||||
}
|
||||
|
||||
/**
|
||||
* `:::table` 없이 쓴 GFM 표에 붙일 값.
|
||||
*
|
||||
* <p>서버 렌더러는 파이프 표를 그대로 읽는다 — `:::table` 이라는 directive 자체를 모른다.
|
||||
* 여기서만 감싸기를 요구하면 같은 본문이 Studio 와 공개 화면에서 다르게 읽히므로, 감싸지 않은
|
||||
* 표도 받는다. `id` 는 자리 순서로 만들고 `caption` 은 비운다. 설명이 필요하면 `:::table` 로
|
||||
* 감싸 `caption` 을 주면 된다.
|
||||
*/
|
||||
function bareTableAttributes(index: number): Record<string, string> {
|
||||
return { id: `table-${index}`, caption: "", rowHeaderColumn: "none" };
|
||||
}
|
||||
|
||||
function tableBlock(
|
||||
node: ContainerDirective,
|
||||
node: ContainerDirective | Table,
|
||||
usedIds: Set<string>,
|
||||
bareIndex?: number,
|
||||
): components["schemas"]["DataTableBlock"] {
|
||||
const attributes = attributesOf(node, ["id", "caption", "rowHeaderColumn"]);
|
||||
if (node.children.length !== 1 || node.children[0].type !== "table") {
|
||||
invalid(node, "table directive must contain exactly one GFM table");
|
||||
const bare = node.type === "table";
|
||||
const attributes = bare
|
||||
? bareTableAttributes(bareIndex!)
|
||||
: attributesOf(node as ContainerDirective, ["id", "caption", "rowHeaderColumn"]);
|
||||
if (!bare) {
|
||||
const container = node as ContainerDirective;
|
||||
if (container.children.length !== 1 || container.children[0].type !== "table") {
|
||||
invalid(node, "table directive must contain exactly one GFM table");
|
||||
}
|
||||
}
|
||||
const table = node.children[0] as Table;
|
||||
const table = (bare ? node : (node as ContainerDirective).children[0]) as Table;
|
||||
if (table.children.length === 0) invalid(table, "table header is required");
|
||||
|
||||
const id = attributes.id;
|
||||
@@ -506,6 +546,25 @@ function directiveBlock(
|
||||
content: inlineFromNodes((node.children[0] as Paragraph).children),
|
||||
};
|
||||
}
|
||||
/*
|
||||
서버 렌더러가 아는 callout 이름이다(`note`/`tip` 은 정보, `warning`/`danger` 는 경고).
|
||||
`:::callout tone="..."` 만 받으면 서버가 정상으로 읽는 본문을 여기서 거절하게 되므로 둘 다
|
||||
받는다. 이름이 곧 tone 이라 속성이 없고, 라벨은 이름에서 만든다.
|
||||
*/
|
||||
case "note":
|
||||
case "tip":
|
||||
case "warning":
|
||||
case "danger": {
|
||||
if (node.children.length !== 1 || node.children[0].type !== "paragraph") {
|
||||
invalid(node, `${node.name} directive must contain exactly one paragraph`);
|
||||
}
|
||||
return {
|
||||
type: "CALLOUT",
|
||||
tone: node.name === "note" || node.name === "tip" ? "info" : "warning",
|
||||
label: CALLOUT_LABELS[node.name],
|
||||
content: inlineFromNodes((node.children[0] as Paragraph).children),
|
||||
};
|
||||
}
|
||||
case "evidence": {
|
||||
const attributes = attributesOf(node, ["key", "alt", "caption", "zoom"]);
|
||||
if (node.children.length !== 0) {
|
||||
@@ -533,10 +592,34 @@ function directiveBlock(
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 문단 하나에 그림만 있으면 그림 블록으로 읽는다.
|
||||
*
|
||||
* <p>Markdown 에서 `` 는 문단 안의 inline 이다. 인라인 유니온에는 그림이 없고
|
||||
* 앞으로도 둘 이유가 없다 — 글 가운데 끼워 넣는 그림은 이 문서 형식이 다루는 대상이 아니다.
|
||||
* 그래서 "문단이 그림 하나로만 이루어진 경우"만 블록으로 올린다.
|
||||
*/
|
||||
function imageBlockOf(node: Paragraph): components["schemas"]["ImageBlock"] | null {
|
||||
const visible = node.children.filter(
|
||||
(child) => !(child.type === "text" && child.value.trim() === ""),
|
||||
);
|
||||
if (visible.length !== 1) return null;
|
||||
const only = visible[0]!;
|
||||
if (only.type !== "image") return null;
|
||||
const image = only as unknown as { url: string; alt?: string | null; title?: string | null };
|
||||
if (!isSafeLink(image.url)) invalid(node, `unsafe image URL: ${image.url}`);
|
||||
return {
|
||||
type: "IMAGE",
|
||||
src: image.url,
|
||||
alt: image.alt ?? "",
|
||||
title: image.title ?? null,
|
||||
};
|
||||
}
|
||||
|
||||
function paragraphBlock(
|
||||
node: Paragraph,
|
||||
): components["schemas"]["ParagraphBlock"] {
|
||||
return { type: "PARAGRAPH", content: inlineFromNodes(node.children) };
|
||||
): components["schemas"]["ParagraphBlock"] | components["schemas"]["ImageBlock"] {
|
||||
return imageBlockOf(node) ?? { type: "PARAGRAPH", content: inlineFromNodes(node.children) };
|
||||
}
|
||||
|
||||
export function parseCaseContent(source: string): CaseAuthoringBlock[] {
|
||||
@@ -564,6 +647,7 @@ export function parseCaseContent(source: string): CaseAuthoringBlock[] {
|
||||
listItemCount += 1;
|
||||
return `list-item-${listItemCount}`;
|
||||
};
|
||||
let bareTableCount = 0;
|
||||
|
||||
return tree.children.map((node: Content): CaseAuthoringBlock => {
|
||||
switch (node.type) {
|
||||
@@ -585,11 +669,17 @@ export function parseCaseContent(source: string): CaseAuthoringBlock[] {
|
||||
return codeBlock(node);
|
||||
case "containerDirective":
|
||||
return directiveBlock(node, usedIds);
|
||||
case "html":
|
||||
case "table": {
|
||||
// 서버 렌더러는 파이프 표를 그대로 읽는다. 여기서 거절하면 같은 본문이 Studio 와
|
||||
// 공개 화면에서 다르게 읽힌다.
|
||||
bareTableCount += 1;
|
||||
return tableBlock(node, usedIds, bareTableCount);
|
||||
}
|
||||
case "thematicBreak":
|
||||
return { type: "THEMATIC_BREAK" };
|
||||
case "html":
|
||||
case "definition":
|
||||
case "yaml":
|
||||
case "table":
|
||||
case "footnoteDefinition":
|
||||
case "leafDirective":
|
||||
return invalid(node, `unsupported block syntax: ${node.type}`);
|
||||
|
||||
@@ -188,6 +188,14 @@ function serializeBlock(block: CaseRenderBlock): string {
|
||||
`:::evidence key=${quoteAttribute(block.key)} alt=${quoteAttribute(block.alt)} caption=${quoteAttribute(block.caption)} zoom=${quoteAttribute(String(block.zoom))}`,
|
||||
":::",
|
||||
].join("\n");
|
||||
case "THEMATIC_BREAK":
|
||||
return "---";
|
||||
case "IMAGE":
|
||||
// 제목은 Markdown 이 따옴표로 감싼다. 없으면 붙이지 않아야 다시 읽었을 때 빈 제목이 되지
|
||||
// 않는다.
|
||||
return block.title === null
|
||||
? ``
|
||||
: `}")`;
|
||||
default:
|
||||
return assertNever(block);
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user