fix: 열리지 않는 주소를 링크로 그리지 않는다
「다음에 읽을 것」에 걸린 결정 링크가 404 였다. 주소는 서버가 게시할 때 만들어 저장한 문자열이라 화면 코드 어디에도 흔적이 없었고, 방문자만 그것을 만났다. - `resolvesToPublicRoute` 가 route contract 에서 읽은 라우트 표에 주소를 맞춰 본다. 맞는 라우트가 없는 줄은 관계 목록이 링크로 그리지 않는다. - 결정 목록의 각 항목이 `slug` 를 element id 로 단다 — 결정의 공개 주소가 이 목록 위의 앵커이므로, id(UUID)를 달면 다른 기록이 건 링크가 갈 곳을 잃는다. - 앵커로 들어오면 그 결정까지 내려간다. 목록은 받아온 뒤에 그려지므로 브라우저의 기본 앵커 이동만으로는 닿지 않는다. 주제 화면 셋을 더하면서 함께 늘려야 했던 것들도 여기서 맞춘다 — nginx 로 나가는 경로 패턴, 라우트마다 하나씩인 수동 접근성 증거, 그리고 그 둘을 세는 CI 게이트 기준값. 게이트 형상 digest 는 이전 gates.json 에서 옛 값(87a22f68…)을 먼저 재현한 뒤 새로 계산했다.
This commit is contained in:
@@ -1,4 +1,5 @@
|
||||
import { Link } from "react-router-dom";
|
||||
import { useEffect } from "react";
|
||||
import { Link, useLocation } from "react-router-dom";
|
||||
|
||||
import {
|
||||
RegisteredNotFoundRoute,
|
||||
@@ -11,12 +12,24 @@ import { usePublicContent } from "../use-public-content.tsx";
|
||||
export function ProjectDecisionsPage() {
|
||||
const { params } = useRouteInput<"TECH_LOG_PROJECT_DECISIONS">();
|
||||
const slug = typeof params.slug === "string" ? params.slug : "";
|
||||
const { hash } = useLocation();
|
||||
const view = usePublicContent(["tech-log", "project", slug, "decisions"], async (queries) => {
|
||||
const project = await queries.getProject(slug);
|
||||
return project
|
||||
? { project, decisions: await queries.getProjectDecisions(slug) }
|
||||
: { project: undefined, decisions: [] };
|
||||
});
|
||||
/*
|
||||
결정은 상세 화면이 없다. 다른 기록이 거는 주소가 이 목록 위의 앵커(`#slug`)이므로, 그 링크로
|
||||
들어오면 해당 결정까지 내려가 있어야 한다. 브라우저의 기본 앵커 이동은 문서가 이미 그려져
|
||||
있을 때만 일어나는데 이 목록은 받아온 뒤에 그려지므로, 그려진 다음 한 번 더 맞춘다.
|
||||
*/
|
||||
const ready = view.ready;
|
||||
useEffect(() => {
|
||||
if (!ready || !hash) return;
|
||||
document.getElementById(decodeURIComponent(hash.slice(1)))?.scrollIntoView();
|
||||
}, [ready, hash]);
|
||||
|
||||
if (!view.ready) return view.fallback;
|
||||
|
||||
const { project, decisions } = view.data;
|
||||
@@ -28,7 +41,7 @@ export function ProjectDecisionsPage() {
|
||||
<ol className="project-decision-list">
|
||||
{decisions.map((decision) => (
|
||||
<li key={decision.id}>
|
||||
<article id={decision.id}>
|
||||
<article id={decision.slug || decision.id}>
|
||||
{/*
|
||||
작성자가 나눠 쓴 줄은 그대로 나눠 보여야 한다. 이 칸들은 Markdown 을 거치지 않고
|
||||
텍스트 노드로 들어가므로, HTML 이 줄바꿈을 공백으로 접어 여러 문단이 한 줄로
|
||||
|
||||
+10
-2
@@ -1,5 +1,7 @@
|
||||
import { Link } from "react-router-dom";
|
||||
|
||||
import { resolvesToPublicRoute } from "../../../domain/navigation/public-path.ts";
|
||||
|
||||
/**
|
||||
* 관계 한 줄.
|
||||
*
|
||||
@@ -35,14 +37,20 @@ export function PublicDocumentRelations({
|
||||
kicker?: string;
|
||||
title?: string;
|
||||
}) {
|
||||
if (relations.length === 0) return null;
|
||||
/*
|
||||
주소는 서버가 게시할 때 만들어 저장한 문자열이다. 라우트가 없는 모양으로 저장되면 화면 코드
|
||||
어디에도 흔적이 없고 방문자만 404 를 만난다 — 결정의 주소가 실제로 그랬다. 열리지 않는 줄은
|
||||
링크로 그리지 않는다.
|
||||
*/
|
||||
const reachable = relations.filter((relation) => resolvesToPublicRoute(relation.path));
|
||||
if (reachable.length === 0) return null;
|
||||
|
||||
return (
|
||||
<section className="document-relations" aria-labelledby="relations-title">
|
||||
<p className="section-kicker">{kicker}</p>
|
||||
<h2 id="relations-title">{title}</h2>
|
||||
<ul>
|
||||
{relations.map((relation) => {
|
||||
{reachable.map((relation) => {
|
||||
/*
|
||||
링크의 이름은 「묶음 이름 + 제목」까지다. 설명까지 이름에 들어가면 관계 목록을 훑을 때
|
||||
링크 하나하나가 문단이 되어 목록으로서 쓸모가 없어진다. 설명은 눈으로 보는 보조
|
||||
|
||||
Reference in New Issue
Block a user