📌목적
hexo를 통해 공개적으로 지식을 다듬고자
hexo 세팅과 컨벤션 세팅을 위한 자료조사를 진행하였음
📌구체적인 작업 목차
- 구축 형태, 활용 방법 구상 , Hexo 조사
- 댓글, 태그, 카테고리 활성화
- 카테고리, 태그 작성 방법 문서화
- 목적 구체화
- url 컨벤션 만들기
0. 구축 형태, 활용 방법 구상
a. 호스팅에 대한 회고
hexo 는 동적인 척 정적인 웹 사이트로
제작된 public 폴더의 구조를 보면 양이 많아질 수록 서버에 올려야하는 데이터가 많아지는 구조지만
microsoft 의 github에서 github.io 를 지원해주니 마음껏 쓰고자 한다
b. sub tool : obsidian
hexo에는 고질적인 한계가 존재한다
1. 온라인 기반 ( 쿠키로 해소 될 수 있지만 일단 온라인 기반이다 )
2. 검색이 안된다
옵시디언은 이 문제를 해결해준다
c. 굳이 Hexo 를 쓰는 이유
카테고리를 통해 구조를 쌓을 수 있다
온라인이니까 접근이 용이하고
마크다운을 공유하면 다 같이 작성하는 것이 가능하다 ( 무제한 페이지의 장점 )
카페나 블로그를 쓰지 않고 Hexo를 쓰는 이유라 함은
사이트 커스텀이 가능해서
d. 프로그램 뜯어본 결과
일단 node_module 에 hexo를 변환하거나 올리는 것들이 다 들어가 있고
theme 에 사이트의 형태가 다 들어가있다
기본 폼 조차 기본 다운로드되는 테마로써 들어가 있음
1. 댓글, 태그, 카테고리 활성화
삽을 정말 많이 팠다
다른 테마들은 개발된지 3년 지난 것들도 있는데 hexo는 최신 버전이고
module에는 기능이 있는데 기본 테마에는 없고
next에는 있고 , 그런데 또 console에는 변화가 없어서 어디에서 이런 변화가 적용된 파일이 있는지 찾는게 오래 걸렸는데
결론적으로 말하자면
태그와 카테고리는 root 폴더의 _config.yml 를 수정하면 되고
댓글은 node_module/hexo-theme-next/config.yml 를 수정하면 된다
공식문서를 꼼꼼히 읽고 일단 공식 문서대로 해보고 , 안되면 다른 방법을 찾는게 맞다는 교훈을 얻었다
잘못된 지식은 해롭다
2. 카테고리, 태그 작성 방법 문서화
크게 쓸 내용은 없었다
카테고리 태그 등의 정보가 있는 부분을 front-matter 라고 부르고
작성하는 문법을 yaml 문법이라고 하는 것을 알 수 있었다
권장하는 형태는 다음과 같았는데
tags:
- 1
- 2
- 3
tags: [4,5,6]가독성에 대한 관점으로 봤을 때 - 를 쓰는 것이 더 보기 좋아서 - 로 통일하기로 했다
그리하여 필수로 사용하는 태그는 아래와 같게 됬다
title: 문서의 보이는 제목
date: 작성 날짜 (YYYY-MM-DD HH:mm:ss)
categories:
- 영어로
- 띄어쓰기 가능 ( 자동 - 기능 있음 )
tags:
- 한글 가능
- 띄어쓰기 가능작성 방식은 한글도 되고 띄어쓰기도 된다
카테고리와 파일 이름의 경우 카테고리 경로로 사용되고
date는 YYYY-MM--DD 가 폴더 경로로 사용된다
HH:mm:ss는 너무 과하지만 자동생성되는 형식에 따르고 있다
3. 목적 구체화
notion to obsidian to hexo 로 연결하려한다
notion의 경우 가볍게 사용되지만 점점 느려지고, 공유 엑세스가 제한적이다
obsidian의 경우 소프트웨어로써 성능을 뽑아낼 수 있어 빠르지만 접근성이 제한된다
hexo의 경우 git을 통한 배포가 가능하고 빠르지만, 검색이 안되고, 수정이 번거롭다
라는 각각의 문제가 있지만
공통적으로는 markdown으로 묶이기 때문에 연결이 가능하다
이러한 점을 살려서 접근이 용이한 hexo는 핵심을 담는 사전으로
obsidian은 빠른 검색 엔진 + 수정이 가능한 툴로
notion은 hexo나 옵시디언을 못쓰더라도 쉽게 접근 할 수 있는 접근성 도구로 사용하고자 한다
notion > obsidian은 아직 어렵지만
obsidian > hexo는 쉽기 때문에 obsidian hexo 를 위한 세팅을 하기로 했다
4. url 컨벤션 만들기
카테고리와 파일이름... 한글도 지원되고 띄어쓰기도 -로 변환되서 지원된다
hexo 카테고리는 대소문자를 구분한다
-와 숫자를 사용 할 수 있다
그래서 구체적으로 정해보자면
영어를 우선적으로 쓰면서 소문자만
카테고리 명칭은 관리한다
a. 파일이름은 띄어쓰기 쓰면 안된다 -로 통일
띄어쓰기도 지원되긴하지만 형태가 %20 으로 나온다 불편하다
그리고 데이터 상으로 태그와 카테고리가 유사하여 구분하기 좋을 것 같다
카테고리 미러링 목적의 태그는 대문자로 표기할 수 있을 것이다
URL이 대소문자를 구분하는 경우와 아닌 경우
경로를 표시할 때는 구분하지 않고, 요소를 표시할 때는 구분한다
소문자로 맞추는게 좋다
그런데 소문자로 쓰되 , 보이는 건 대문자로 하고 싶다..
이유는 아래와 같다
html css javascript typescript story-book
HTML CSS JAVASCRIPT TYPESCRIPT STORY-BOOK
뽀대나는게 다른데 아쉬운 부분
