Files
tech-log-frontend/src/features/tech-log/presentation/shared/public-render/prose-text.tsx
T
DongHyeonkaandClaude Opus 5 9b7ad82fe3 fix: 산문 칸의 문단과 인라인 코드를 읽어서 그린다
Case 만 블록 파서를 타고 나머지 유형은 문자열을 그대로 내보내고 있었다.
그래서 두 가지가 깨졌다.

작성자가 백틱으로 적은 식별자가 백틱째 화면에 나왔다. 어떤 Reference 는
한 문서에 백틱이 32개였고, 그 원문이 홈 카드·탐색 카드·검색 결과까지
그대로 퍼졌다. 판단 기준은 `<p>{rule.body}</p>` 로, 적용할 때·예외·예시는
`<li>{item.text}</li>` 로 아무것도 거치지 않고 나가고 있었다.

빈 줄로 나눈 문단이 문단으로 보이지 않았다. 어제 넣은 PlainText 는 모든
줄바꿈을 <br> 로 만들었기 때문에 빈 줄도 <br><br> 로 나갔고, 문단 사이
여백이 없었다. Reference 7개 전부에 빈 줄이 9~16개 있다.

ProseText 로 바꾼다 — 빈 줄은 문단을 가르고, 문단 안 줄바꿈은 그 자리에
지키고, 백틱은 코드로 읽는다. 백틱 수가 홀수면 원문을 그대로 둔다:
작성자가 백틱 자체를 쓴 것일 수 있고, 반쯤 해석해 한쪽만 코드로 만드는
쪽이 더 나쁘다.

블록 파서(parseCaseContent)를 쓰지 않는 이유는 그쪽이 Case 전용 문법과
도식 참조까지 물고 있어 이 칸들에 없는 해석기를 끌고 오기 때문이다.

머리말 가드는 <br> 개수로 재고 있었다. 이제 기준이 문단이므로 문단 수와
문단 안 줄바꿈을 함께 확인하도록 고친다 — 가드가 낡은 것이지 화면이
틀린 것이 아니다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011nAjrqNHGPNngN4aUbcyvJ
2026-08-31 08:06:03 +09:00

71 lines
2.7 KiB
TypeScript

import { Fragment, type ReactNode } from "react";
/**
* 작성자가 직접 쓴 산문 칸. 요약·판단 기준 본문·해결 내용처럼 Markdown 블록 파서를 거치지
* 않고 문자열 그대로 오는 자리에 쓴다.
*
* <p>이 칸들은 오래 평문으로 나갔다. 그래서 두 가지가 깨져 있었다. 빈 줄로 나눈 문단이 문단으로
* 보이지 않았고(줄바꿈 두 개가 그냥 이어졌다), 작성자가 백틱으로 적은 식별자가 백틱째 화면에
* 나왔다 — 어떤 Reference 는 한 문서에 백틱이 32개 있었고 그 원문이 카드와 검색 결과까지
* 그대로 퍼졌다.
*
* <p>블록 파서(`parseCaseContent`)를 쓰지 않는 이유는 그쪽이 Case 전용 문법(`:::evidence`,
* 도식 참조)까지 물고 있어 이 칸들에는 없는 해석기를 끌고 오기 때문이다. 여기 필요한 것은
* 문단과 인라인 코드 둘뿐이다.
*/
/**
* 백틱으로 감싼 조각을 코드로 읽는다.
*
* <p>백틱 수가 홀수면 짝이 맞지 않는다 — 작성자가 코드를 의도한 것이 아니라 백틱 자체를 쓴
* 것일 수 있으므로 원문을 그대로 둔다. 반쯤 해석해서 한쪽만 코드로 만드는 쪽이 더 나쁘다.
*/
function renderInlineCode(text: string, keyPrefix: string): ReactNode[] {
const parts = text.split("`");
if (parts.length % 2 === 0) return [text];
return parts.map((part, index) =>
index % 2 === 1 ? (
<code key={`${keyPrefix}-c${index}`}>{part}</code>
) : (
<Fragment key={`${keyPrefix}-t${index}`}>{part}</Fragment>
),
);
}
/** 문단 안의 줄바꿈. 작성자가 엔터로 나눠 쓴 줄을 그 자리에 지킨다. */
function renderLines(paragraph: string, keyPrefix: string): ReactNode[] {
const lines = paragraph.split("\n");
return lines.flatMap((line, index) => {
const rendered = renderInlineCode(line, `${keyPrefix}-${index}`);
if (index === 0) return rendered;
return [<br key={`${keyPrefix}-br${index}`} />, ...rendered];
});
}
export function ProseText({
text,
className,
}: {
text: string;
/** 문단마다 붙는다. 한 문단만 있던 시절 바깥 `<p>` 가 갖고 있던 클래스가 여기로 온다. */
className?: string;
}) {
// 빈 줄이 몇 개든 문단 하나의 경계다. 세 줄을 띄웠다고 빈 문단이 생기지는 않는다.
const paragraphs = text
.split(/\n{2,}/u)
.map((paragraph) => paragraph.trim())
.filter((paragraph) => paragraph !== "");
if (paragraphs.length === 0) return null;
return (
<>
{paragraphs.map((paragraph, index) => (
<p key={index} className={className}>
{renderLines(paragraph, String(index))}
</p>
))}
</>
);
}