Skip to content

witch-factory/archive

Repository files navigation

Witch's Archive

개인 학습 내용과 기술 스크랩을 아카이빙하는 정적 사이트입니다. Eleventy (11ty)를 사용하여 구축되었습니다.

목적

블로그에 점점 공들인 글이 많아지고 어느 정도의 독자가 생겼습니다. 그래서 이제는 생각나는 대로, 나만 보기 위해서 휘갈긴 글을 블로그에 올리기가 심리적으로 힘들어졌습니다. 이걸 극복하기 위해 이 아카이브를 만들었습니다. 아무거나 제가 배우는 내용들을 아무렇게나 적어서 올릴 수 있도록.

하지만 저는 TIL에 가까운 문서들을 아무리 만들어도 제가 이후에 찾아보지 않는다는 걸 깨달았습니다. 그렇게 사실상 죽어버린 기록들이 제 USB 같은 곳에 수없이 남아 있습니다. 그렇게 제게 아무 발전도 가져다주지 않고 저를 포함한 그 누구도 보지 않는 "YYYYMMDD TIL"같은 게 모여 있는, 인터넷 공간 낭비에 불과한 아카이브를 만들기는 원치 않았습니다.

따라서 이 아카이브의 목적은 단순한 기록은 아닙니다. 언젠가는 여기 있는 모든 주제들이 잘 깎은 글이 되어 블로그에 올라가기를 바랍니다. 이건 거기 올라갈 글들을 위한 시험장이라고 생각합니다. 처음에는 아무거나 휘갈기다가 조금 자료가 모이면 묶어서 주제를 만들고 이후에 그게 다듬어지면 블로그에 올라가는 구조를 생각합니다. 그걸 위해서 다음과 같은 구조를 짰습니다.

아카이브 구성

  • Daily: 생각나는 대로 휘갈기는 문서
    • 형식: "YYYY-MM-DD 주제"
  • Scrap: 기술 관련 스크랩 및 메모
  • Books: 도서 리뷰 및 요약
  • Math: 수학 관련 메모
  • Study: 위의 자료들을 기반으로 어느 정도 정리된 주제들이 올라가는 곳

daily에서 메모한 내용들, scrap에서 스크랩해둔 글들, books에 있는 책 내용, 이외에 제가 들은 강의 등이 합해져서 study의 정리된 글들을 이룹니다. 해당 내용들이 제대로 모이고 제 생각이 조금씩 담기면 블로그에 올라갑니다.

프로젝트 구조

archive/
├── _data/              # 전역 데이터
├── _includes/          # 템플릿 포함 파일
├── _layouts/           # 레이아웃 템플릿
├── _site/              # 빌드 출력 디렉토리
├── assets/             # 정적 자산 (이미지, 아이콘)
├── data/               # 콘텐츠 데이터
│   ├── daily/          # 배우는 대로 쓰는 메모들
│   ├── books/          # 도서 관련 콘텐츠
│   ├── scrap/          # 스크랩 콘텐츠
│   └── study/          # 학습 노트
├── styles/             # CSS 스타일
└── eleventy.config.js  # 11ty 설정

콘텐츠 추가

새로운 콘텐츠를 추가하려면 해당 카테고리 디렉토리에 마크다운 파일을 생성

  • 배우는 대로 쓰는 메모: data/daily/ 디렉토리
  • 스크랩: data/scrap/ 디렉토리
  • 도서: data/books/ 디렉토리
  • 어느 정도 정리된 주제: data/study/ 디렉토리

각 마크다운 파일은 frontmatter에 title을 포함해야 합니다:

---
title: 문서 제목
---

콘텐츠 내용...

기술 스택

  • Static Site Generator: Eleventy (11ty)
  • Package Manager: pnpm

개발 시작하기

필수 요구사항

  • Node.js 18.0 이상
  • pnpm

설치

pnpm install

개발 서버 실행

pnpm dev

개발 서버가 시작되면 http://localhost:8080에서 사이트를 확인할 수 있습니다. 파일 변경 시 자동으로 새로고침됩니다.

빌드

pnpm build

정적 파일이 _site 디렉토리에 생성됩니다.

커스터마이징

  • 스타일 수정: styles/ 디렉토리의 CSS 파일
  • 레이아웃 수정: _layouts/ 디렉토리의 HTML 템플릿
  • 설정 수정: eleventy.config.js 파일

📄 라이선스

이 프로젝트는 개인 학습 목적으로 제작되었습니다.

About

마녀 아카이브

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published