블로그 게시물 추가하기
목표
기존 정적 블로그에 사용자 콘텐츠를 추가하되, 새로운 블로그 시스템을 강제하지 않습니다.
이 스킬은 먼저 현재 사이트가 게시물을 어떻게 표현하는지 이해한 후, 해당 스타일에 맞춰 새 콘텐츠를 추가합니다. 일반적인 마크다운-투-HTML 변환기가 아닙니다.
계약
입력:
- 기존 정적 사이트 폴더와 현재 게시물/인덱스/템플릿 시스템.
- 하나 이상의 원본 게시물: 마크다운, 옵시디언 노트, 워드 문서, 이전 HTML, 붙여넣은 텍스트, 이미지, 첨부 파일 또는 콘텐츠 폴더.
- 제목, 날짜, 태그, 요약, 슬러그, 커버 이미지, 가져오기 범위와 같은 선택적 메타데이터.
출력:
- 사이트의 기존 게시물 스타일과 일치하는 새 문서/상세 페이지.
- 블로그 인덱스, 아카이브, 태그/카테고리, 홈페이지 최근 게시물, 검색 데이터, RSS 또는 사이트맵 등 기존 시스템이 이미 존재하는 경우 업데이트된 진입점.
- 페이지 상대 경로로 복사/재연결된 로컬 이미지 및 첨부 파일.
- 해당되는 경우 업데이트된
EDITING.md게시물 지침.
경계:
- 사이트를 재설계하거나 기존 게시물 시스템이 명확한 경우 새 시스템을 만들지 마십시오.
- 원본에서 지원하지 않는 메타데이터, 날짜, 작성자 또는 주장을 임의로 생성하지 마십시오.
- 원격 수학/CDN 종속성을 자동으로 추가하지 마십시오.
- 게시하지 마십시오. 대신
publish-static-site를 사용하십시오.
성공 게이트:
- 새 게시물이 기존 스타일로 렌더링되고 적절한 인덱스에서 접근 가능해야 합니다.
- 이미지, 수학, 링크, 코드, 표 및 리치 콘텐츠가 작동하거나 해결되지 않은 항목이 명시적으로 보고되어야 합니다.
- 경로는 문서 및 인덱스 페이지에서 페이지 상대적이어야 합니다.
- 영향을 받은 페이지가 브라우저 검증을 통과하고
review-static-site가 통과하거나 허용된 제한 사항만 보고해야 합니다.
게이트 실패 시:
- 이 스킬 내에서 변환, 메타데이터, 경로, 에셋 또는 인덱스 연결을 수정하십시오.
- 가져오기로 인한 사소한 시각적 수정은
edit-site-part를 사용하십시오. - 수정 후
review-static-site를 다시 사용하십시오.
사용 시기
사용자가 다음을 원할 때 이 스킬을 사용하십시오:
- 새 문서, 노트, 에세이 또는 블로그 게시물 하나를 추가.
- 여러 마크다운 파일을 정적 사이트로 가져오기.
- 이전 블로그의 게시물을 새로 생성된 사이트로 이동.
- 붙여넣은 문서 텍스트를 사이트 문서 페이지로 변환.
- 블로그 인덱스, 아카이브, 태그, 홈페이지 최근 게시물 또는 관련 진입점 업데이트.
- 콘텐츠를 추가하면서 현재 사이트의 시각적 언어 유지.
이 스킬을 사용하여 테마를 선택하거나, 처음부터 새 사이트를 구축하거나, 웹사이트 스타일을 재창조하거나, 프로필/소개 콘텐츠를 개인화하거나, 약간의 시각적 조정을 하거나, 사이트를 게시하거나, 프로젝트를 프레임워크로 변환하지 마십시오.
입력
사용 가능한 모든 것을 사용하십시오:
- 정적 사이트 폴더, 일반적으로
site/,dist/,out/또는public/. - 하나 이상의 마크다운 파일, 워드 문서, 붙여넣은 게시물, 이전 HTML 파일, 이미지 폴더 또는 콘텐츠 폴더.
- 이전 스킬의
EDITING.md, 페이지 맵 또는 인계 노트. - 기존 문서 템플릿 페이지 또는 대표 게시물.
- 사용자가 제공한 제목, 날짜, 태그, 카테고리, 요약, 슬러그, 커버 이미지 및 게시 선호도.
- 모든 게시물을 가져올지, 선택된 하위 집합을 가져올지, 아니면 먼저 대표 배치를 가져올지 여부.
원본 콘텐츠가 많은 경우 먼저 구조를 검사하고 무조건 모든 것을 가져오지 마십시오.
1. 기존 게시물 시스템 이해하기
새 게시물을 작성하기 전에 사이트가 현재 어떻게 작동하는지 검사하십시오.
다음을 확인하십시오:
posts/*.html,notes/*.html,articles/*.html또는 중첩된 라우트 폴더와 같은 게시물 파일.blog.html,archive/index.html,notes/index.html,tags/index.html또는category/index.html과 같은 인덱스 페이지.data/posts.json,data/notes.json,data/site.json또는profile.json과 같은 데이터 파일.assets/script.js또는 유사한 파일의 JavaScript 데이터 배열.- 최근 게시물, 추천 게시물, 노트, 읽기 목록 또는 글쓰기 하이라이트를 위한 홈페이지 섹션.
- 템플릿으로 사용할 수 있는 기존 문서/상세 페이지.
- 템플릿이
../assets/style.css와 같은 페이지 상대 링크를 사용하는지 아니면/assets/style.css와 같은 서버 루트 링크를 사용하는지와 같은 기존 경로 전략. - 이미 존재하는 경우 RSS, Atom, 사이트맵, 검색 인덱스 또는 태그/카테고리 페이지.
- 게시물 추가를 위한
EDITING.md지침. assets/images/posts/, 함께 위치한 게시물 폴더, 커버 필드, 그림 클래스, 라이트박스 마크업, 캡션 또는 반응형 이미지 래퍼와 같은 기존 이미지 및 첨부 파일 규칙.- 수학 렌더링, 코드 하이라이팅, 표, 각주, 콜아웃, 제목 앵커, 목차, 링크 카드, 임베드, 다이어그램 및 인용/참조 섹션과 같은 기존 리치 콘텐츠 규칙.
기존 구조를 따르십시오. 사이트에 이미 게시물 시스템이 있는 경우 새 시스템을 만들지 마십시오.
2. 게시물 메타데이터 추출
각 원본 게시물에 대해 다음을 추출하거나 파생하십시오:
- 제목.
- 날짜.
- 슬러그.
- 태그 또는 카테고리.
- 요약 또는 발췌.
- 커버 이미지 또는 히어로 이미지(있는 경우 사용 가능).
- 원본 경로.
- 현재 사이트에서 이미 사용 중이거나 일관되게 계산하기 쉬운 경우에만 읽기 시간.
있는 경우 프론트매터를 사용하십시오. 그렇지 않으면 첫 번째 제목, 파일 이름, 주변 폴더, 보이는 날짜 텍스트 또는 첫 번째 단락에서 유추하십시오.
특정 날짜, 태그, 작성자 또는 주장을 임의로 생성하지 마십시오. 필드가 누락되었고 유추할 수 없는 경우 명확한 자리 표시자를 사용하거나 사이트 스타일이 허용하는 경우 필드를 생략하십시오.
3. 사이트 스타일에 맞게 콘텐츠 변환
기존 문서 템플릿 및 읽기 환경과 일치하는 새 문서 페이지를 만드십시오.
다음을 유지하십시오:
- 헤더, 탐색, 푸터, 사이드바 및 공유 셸.
- 문서 타이포그래피, 간격, 메타데이터 레이아웃, 태그, 뒤로 링크 및 관련 링크.
- 로그 항목, 필드 노트, 카드, 터미널/아카이브 프레이밍 또는 미니멀 에세이와 같은 특수 테마 언어.
- 기존 CSS 클래스 규칙 및 데이터 구조.
마크다운의 경우:
- 제목, 단락, 인용구, 목록, 작업 목록, 표, 코드 블록, 링크, 각주, 콜아웃 및 이미지를 시맨틱 HTML로 변환하십시오.
- 사용 가능한 경우 코드 언어 레이블을 유지하십시오.
- 이미지 참조를 페이지 상대적으로 유지하고 필요한 경우에만 로컬 이미지를 복사하십시오.
- 중국어, 일본어, 한국어, 악센트가 있는 라틴어 및 기타 비ASCII 텍스트를 읽을 수 있는 UTF-8로 유지하십시오.
이전 HTML의 경우:
- 문서 본문과 메타데이터를 추출하십시오.
- 이전 사이트 크롬, 분석, 댓글, 관련 없는 탐색 및 원본 사이트 ID를 제거하십시오.
- 새 사이트의 문서 템플릿에 콘텐츠를 다시 래핑하십시오.
3.5. 정적 경로 호환성 유지
게시물을 추가할 때 각 생성된 페이지의 위치에서 경로를 계산하십시오. 중첩된 문서 페이지에 index.html의 경로를 맹목적으로 복사하지 마십시오.
기본 규칙:
- 새 문서 페이지는 공유 CSS, JavaScript, 글꼴, 이미지 및 탐색에 페이지 상대 링크를 사용해야 합니다.
- 게시물이
posts/my-post.html에서 생성된 경우 공유 에셋은 일반적으로../assets/style.css,../assets/script.js및../assets/images/posts/my-post/figure.png와 같은 게시물 이미지가 필요합니다. - 루트 페이지에서 게시물로의 링크는 일반적으로
posts/my-post.html이어야 합니다. - 게시물에서 루트 페이지로의 링크는 일반적으로 구조에 따라
../index.html,../blog.html또는../archive/index.html이어야 합니다. - 기존 사이트가 의도적으로 사용하고 사용자가 직접
file://열기 및 하위 경로 호스팅이 중단될 수 있음을 수락하지 않는 한/assets/...,/posts/...,/data/...또는/images/...와 같은 루트 절대 경로를 도입하지 마십시오. - JavaScript 생성 링크, 검색 결과, 태그 필터, 관련 게시물 링크, 커버 경로, RSS/사이트맵 항목 및 모든 데이터 파일을 동일한 경로 전략으로 업데이트하십시오.
- 기존 사이트에 실수로 루트 절대 링크가 있는 경우 보고하고 문제를 확장하는 대신 영향을 받은 경로를 수정하는 것을 선호하십시오.
로컬 파일 가져오기 문제 방지:
- 새로 추가된 게시물이 문서 본문을 위해 로컬 JSON/마크다운의
fetch()에 의존하지 않도록 하십시오. - 인덱스가 데이터에서 렌더링되는 경우 필수 게시물 링크를 HTML에 보이게 유지하거나 직접 열기 미리보기에서 작동하는 상대 JavaScript 데이터 객체를 사용하십시오.
4. 리치 콘텐츠 형식 처리
모든 것을 일반 단락으로 평탄화하는 대신 리치 콘텐츠를 의도적으로 유지하십시오.
먼저 현재 사이트가 이미 다음을 지원하는지 검사하십시오:
- KaTeX, MathJax, 사용자 정의 CSS 또는 원시 TeX 블록을 사용한 수학 렌더링.
- 코드 하이라이팅, 언어 레이블, 복사 버튼 또는 터미널 스타일 코드 프레임.
- 표, 반응형 표 래퍼, 각주, 콜아웃, 어드몬니션, 인용구 및 작업 목록.
- 제목 앵커, 목차, 역링크, 관련 노트 또는 섹션 링크.
- 링크 카드, 북마크 목록, URL 인덱스 페이지, 인용, 참조 목록 또는 참고 문헌 섹션.
- 비디오, 오디오, PDF, iframe, Mermaid 다이어그램, Excalidraw/SVG 다이어그램 또는 다운로드 가능한 첨부 파일과 같은 임베드된 미디어.
있는 경우 기존 패턴을 따르십시오. 패턴이 없는 경우 간단한 시맨틱 HTML을 사용하고 추가 렌더러가 필요한 기능을 보고하십시오.
수학 및 공식:
$...$,$$...$$,\(...\),\[...\]또는 Word 방정식 내보내기에서 인라인 및 디스플레이 수학을 유지하십시오.- 있는 경우 사이트의 기존 수학 렌더러를 사용하십시오.
- 원본에 많은 공식이 포함되어 있고 렌더러가 없는 경우 일반 정적 사이트의 경우 로컬 KaTeX 통합을 선호하십시오: 로컬 vendor 폴더 아래에 KaTeX CSS/JS/글꼴을 저장하고, 작은 로컬 렌더 스크립트를 추가하고, CDN에 의존하지 마십시오.
- 그렇지 않으면 종속성이 없는 사이트에 자동으로 원격 MathJax/KaTeX 종속성을 추가하지 마십시오.
- 수학 표시 요소 내부의 원래 TeX를 대체 수단으로 유지한 다음 브라우저에서 렌더링하십시오. 공식에 대해 렌더링이 실패하면 읽을 수 있는 TeX 대체 수단이 페이지를 깨는 대신 계속 표시되어야 합니다.
- KaTeX가 필요한 명백한 소스 구문(예: softmax 화살표,
\cdot,\times, 실수로 공식에 섞인 구두점 및 일반적인 Q/K/V 표현)을 정규화하십시오. - 수학 렌더러가 추가된 경우 공식이 많은 게시물을 코드처럼 보이는 TeX 상자로 남겨 두지 마십시오.
- 공식을 소스와 브라우저 대체 수단에서 읽을 수 있게 유지하십시오.
코드 블록:
- 펜스된 코드 언어 이름을 유지하십시오.
- 코드 블록 내부의 HTML을 이스케이프 처리하십시오.
- 긴 코드 줄을 페이지 레이아웃을 깨지 않고 스크롤 가능하게 유지하십시오.
- 기존 코드 블록 스타일링, 복사 버튼 및 구문 하이라이팅 규칙을 재사용하십시오.
- 게시물에서 소스 코드를 실행하지 마십시오.
표:
- 마크다운, 워드 또는 HTML 표를 시맨틱 표로 변환하십시오.
- 넓은 표를 사이트의 기존 반응형 표 컨테이너에 래핑하거나 작은 로컬 래퍼를 추가하십시오.
- 헤더 행, 정렬 의도 및 가능한 경우 캡션을 유지하십시오.
링크, URL 인덱스 및 내부 참조:
- 명확한 링크 텍스트와 함께 외부 링크를 유지하십시오.
- 상대 링크 및 마크다운
.md링크를 대상 게시물이 가져온 경우 생성된 정적 HTML 경로로 변환하십시오. - Obsidian 위키링크(
[[Note]],[[Note#Heading]],[[Note|Alias]])를 대상이 확인 가능할 때 일반 링크로 변환하십시오. - 확인되지 않은 내부 링크를 보이는 자리 표시자나 일반 텍스트로 유지하고 보고하십시오.
- 사이트가 앵커 링크나 목차를 사용하는 경우 안정적인 제목 ID를 생성하십시오.
- URL 인덱스, 북마크 또는 링크 정리 게시물의 경우 목록 구조를 유지하십시오. 있는 경우 사이트의 기존 링크 카드/목록 스타일을 사용하십시오. 사용자가 요청하지 않는 한 원격 메타데이터를 가져와야 하는 미리보기 카드를 만들지 마십시오.
각주, 인용 및 참조:
- 마크다운 각주를 있는 경우 사이트의 기존 스타일을 사용하여 각주 섹션으로 변환하십시오.
- 인용 레이블, 참고 문헌 항목 및 참조 링크를 유지하십시오.
- 원본 텍스트가
[@paper2024]와 같은 확인되지 않은 인용 키를 사용하는 경우 참고 문헌 파일이 제공되지 않는 한 보이게 유지하고 인용 메타데이터가 누락되었음을 보고하십시오.
콜아웃, 어드모니션 및 블록 유형:
> [!NOTE],> [!TIP],> [!WARNING],> [!IMPORTANT]와 같은 Obsidian/GitHub 스타일 콜아웃을 사이트의 가장 가까운 콜아웃/카드/인용구 패턴으로 변환하십시오.- 현재 사이트에 체크리스트 스타일이 있는 경우 작업 목록을 체크리스트로 유지하십시오. 그렇지 않으면 비활성화된 체크박스 마크업이나 일반 목록을 사용하십시오.
임베드 및 첨부 파일:
- PDF, 슬라이드, 데이터세트, 다운로드, 오디오 및 비디오의 경우 사이트가 이미 해당 미디어 유형을 임베드하지 않는 한 명확한 링크나 다운로드 카드를 선호하십시오.
- 사용자가 제공한 경우에만 로컬 첨부 파일을 복사하십시오.
- 사용자가 소유하거나 의도적으로 참조하는 경우에만 원격 임베드를 유지하십시오.
- Mermaid 또는 다이어그램 블록의 경우 있는 경우 기존 렌더러를 사용하십시오. 렌더러가 없는 경우 소스 블록을 유지하고 보고하거나 실용적이고 적절한 경우에만 정적 SVG/PNG로 변환하십시오.
5. 게시물 이미지 및 에셋 처리
현재 사이트의 에셋 규칙에 따라 이미지를 처리하십시오.
먼저 기존 게시물이 이미지를 저장하고 렌더링하는 방법을 검사하십시오:
assets/images/posts/<slug>/와 같은 공유 에셋 폴더.posts/<slug>/images/와 같은 함께 위치한 게시물 에셋.cover,heroImage,thumbnail또는images와 같은 데이터 필드.- 그림 마크업, 캡션, 라이트박스 링크, 지연 로딩, 너비/높이 속성 및 반응형 CSS 클래스.
기존 패턴을 선호하십시오. 패턴이 없는 경우 다음과 같은 간단한 정적 규칙을 사용하십시오:
assets/images/posts/<post-slug>/
마크다운 소스의 경우:
- 마크다운 파일의 폴더에서 상대 이미지 링크를 확인하십시오.
- 필요한 경우 로컬 이미지를 사이트의 게시물 이미지 폴더로 복사하십시오.
- 마크다운 이미지 참조를 새 상대 사이트 경로로 다시 작성하십시오.
- 중첩된 문서 페이지의 경우 이미지 경로에 올바른
../깊이를 포함하십시오. - 있는 경우 마크다운의 대체 텍스트를 유지하십시오.
- 원본이 근처의 기울임꼴 텍스트, 제목 속성 또는 Obsidian 스타일 임베드를 사용하는 경우 이미지 캡션을 변환하십시오.
- 절대 로컬 디스크 경로를 가리키는 링크를 남겨 두지 마십시오.
옵시디언 노트의 경우:
![[image.png]]와 같은 일반적인 임베드 및 상대 첨부 파일 폴더를 지원하십시오.- 노트 근처의 가능한 첨부 파일 폴더(예:
attachments/,assets/,images/또는 보이는 경우 보관소의 구성된 첨부 파일 폴더)를 검색하십시오. - 임베드를 일반 HTML 이미지 또는 그림 마크업으로 다시 작성하십시오.
워드 .docx 소스의 경우:
- 문서 패키지에서 임베드된 이미지를 추출하거나 사용 가능한 문서 도구를 사용하십시오.
- 가능하면 주변 텍스트를 기준으로 이미지 순서를 유지하십시오.
...(원문이 잘려서 나머지 부분은 생략)