Skip to content

서로 연결된 주제를 가진 문서들을 그래프 형태로 보고 읽을 수 있는 프로젝트. Obsidian Vault 보존 및 그래프 시각화를 통한 공유 목적

Notifications You must be signed in to change notification settings

1026minjae/SecondBrain

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

73 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SecondBrain

개요

이 프로젝트는 서로 연결된 주제를 가진 문서들을 그래프 형태로 보고 읽을 수 있는 프로젝트입니다.
각각의 문서는 하나의 주제를 가지며, 어떠한 문서 내에서 다른 문서를 명시적으로 링크함으로써 문서 간 연결이 이루어집니다.

모든 문서는 Obsidian Flavoured Markdown 문법에 따라 작성되었습니다.
이 프로젝트의 모든 텍스트는 D2Coding 글꼴로 표시됩니다.

당부의 말씀

이 프로젝트는 그다지 거창한 것이 아니며, 간단하게나마 제가 공부한 내용을 메모하고 그 내용을 보존하려는 취지에서 시작되었습니다.
또한 마크다운 문법과 옵시디언이라는 도구를 2025년에 갓 알게된 상태이기에 다소 미숙한 방식으로 사용하고 있습니다.
따라서 문서에 작성된 내용이 충분히 상세하지 못하거나 그다지 세련되지 않게 문서가 구성되었을 수 있습니다.

이러한 형태가 된 이유

이 프로젝트는 2020년에 WhatNeed라는 이름으로 시작했습니다.
이는 어떤 소프트웨어를 개발하거나 어떤 서비스를 제공하기 위해 어떠한 것이 필요한지 생각해보고 그 내용을 정리하는 프로젝트였습니다.
하지만 막상 내용을 적으려니 영 손이 가지 않았고 결국 몇 년이 넘도록 방치되었습니다.

이후 저는 Obsidian이라는 메모 프로그램을 알게 되었고 해당 프로그램이 매우 유용하다는 생각이 들었습니다.
그런데 해당 프로그램은 로컬 환경에서만 작동한다는 단점이 있었으며 저는 데스크탑, 랩탑, 때로는 모바일 환경에서도 옵시디언을 사용하고 싶었습니다.
또한 옵시디언의 그래프 뷰에 너무나 감명을 받은 저는 이 도구를 개인 블로그에 접목할 수 있겠다고 생각했습니다. 따라서 Github repository를 활용하여 메모를 클라우드 저장소에 보존하면서 Github Page를 활용하여 옵시디언의 그래프 형태로 시각화하자는 결론에 이르렀습니다.

마침 몇 년동안 방치되었던 WhatNeed가 생각났기에 해당 프로젝트의 레포지토리의 이름을 SecondBrain으로 변경하고 새로운 구조의 웹사이트를 구축했습니다.
웹사이트 구축에 대해 잘 몰라서 ChatGPT를 활용하였고, 이 프로젝트는 제가 AI를 개발에 적극 활용한 최초의 경험이 되었습니다.

처음에는 브라우저 단에서 JS를 통한 링크 탐지를 구현했으나, 문서가 늘어나면서 그래프 로딩 시간이 상당히 증가하는 것을 확인했습니다.
따라서 Python을 활용하여 링크 탐지 및 생성 여부 판단 스크립트를 작성하였고, 제가 문서를 추가/수정할 때마다 수동으로 실행하는 형태가 되었습니다.

현재 구현된 사항

  • Vis.js를 활용한 그래프 시각화
  • Marked.js를 활용한 마크다운-HTML 변환
  • Python을 활용한 마크다운 문서-링크 맵 생성 (스크립트 수동 실행)
  • 마크다운 문서에 대한 위키 링크 [[목표 문서 이름]]
  • 마크다운 문서에 대한 마크다운 링크 [표시되는 텍스트](목표 문서 이름)
  • 아직 생성되지 않았으나 링크된 문서에 대한 구분된 표시
  • 기기 설정에 따른 다크모드/라이트모드 표시

앞으로 추가할만한 요소

  • 문서 뷰어 내 링크 클릭을 통한 문서 이동
  • 옵시디언에서 제공되는 링크 형식 추가로 반영
  • 문서 추가/수정 시 자동으로 Python 스크립트 실행

About

서로 연결된 주제를 가진 문서들을 그래프 형태로 보고 읽을 수 있는 프로젝트. Obsidian Vault 보존 및 그래프 시각화를 통한 공유 목적

Topics

Resources

Stars

Watchers

Forks