위키의 기본 작성법및 기능 추가 방법

일단 시작

기본 편집 방법

마크다운 작성법 가이드 모음

사이트내 문서에 링크하는 방법

  • 같은 페이지내에서의 참조
    • 제목은 #<제목문자열>으로 참조가 가능하다.
    • 아래 마크다운 코드는 현재 페이지에서 가장 첫번째 제목인 일단 시작 세션에 링크된다. 
      [일단 시작](#일단-시작)
    • 스페이스는 보통 가운데 대쉬로 변환된다.

개선 사항

insertAfter 기능 구현하기

  • jQuery에서는 기본적으로 제공하는 기능이라서 jQuery를 사용하면 간단하지만 … 딱 이 기능 하나 쓰자고 jQuery 도입하기 싫을 때
  • 참조할 링크 : 자바스크립트 insertAfter() 구현하기

StackExchange API 사용법

  • 원문 : StackExchange API v2.2
  • 파라메터 이름이 복수형 이름(이름뒤에 ~s가 붙는식)이면 복수의 인자를 사용할수 있다.
    • 참조 : vectorized requests
    • 예를들어 /tags/{tags}/wikis 을 사용한다고 했을 때..
      • {tags} 가 20개의 tag를 한 번의 request로 받아올 수 있다고 설명되어있다.
      • 복수의 tag를 조사한다면 tags 에 javascript;python 으로 ; 구분자를 넣어 구분하는식이다.
  • anonymous quota가 있어 몇번하니까 bad request 에러남
  • 등록하고 써야함 : 내 app 링크
  • 대충 등록하면 위의 app 링크 페이지로 리다이렉트 되는데 여기에서 key를 요청하는 파라메터중 하나로 넣으면 quota가 풀림.

태그 편집시 참고할 사항

  • 중요한 사항임. (:star: :star2: )

에러 상황

  • stackoverflow 태그 중에서는 태그 가운데 .이 들어가는 태그가 종종 있다.
  • 가운데 .이 들어가는 태그를 사용할 경우 태그페이지에서 태그를 클릭할 때 아래에 위키 링크가 나타나지 않는다.
    • 디버그 창을 보면 뭔가 에러가 나고 있다.

해결책

  • 위와 같이 vue.js를 태그로 사용하고 싶으면 대신 vue_js를 사용하라 ( :star: :star2: )
  • 위키내의 태그링크도 문제가 없으며, stackoverflow의 태그 페이지도 잘 연결된다

태그 변경후 수동 확인 방법

  • 매번 필요할 때 마다 까먹어서 다시 적는다..
  • 태그 변경 사항은 ./generateData.js를 git hook을 걸어서 commit시에 자동으로 반영되도록 하고 있다.
  • 수동으로 확인하려면 다음과 같이 command line에서 입력한다. 
    > node ./generateData.js
tagMap saved.
pageMap saved.
tagList saved.
  • _data/tagLists.yml, _data/tagMap.yml, tag.html이 편집된다.
  • 다시 되돌리려면 git restore 명령을 사용한다.

추가하고 싶은 기능 (2021-05-20)

  • 현재 default로 StackExcahgne 의 태그만 가져오고 있는데..
  • vi.stackexchange.com/tags에 등록된 태그들도 있다.
  • 요것도 하고 싶은데..
    • default로 SO 것 먼저하고 SE 것을 선택할 수 있도록 할지..
    • 아님 자동으로 순회해서 갯수가 제일 많은 것으로 선택하도록 할지..
    • 고민중인데.. 아무거나 먼저 구현하고 다른것도 구현해보자

블로그 포스트에 이전 포스트, 다음 포스트로 가는 링크를 넣고 싶다.

필요성

  • 2021년 현재 블로그는 주차별로 기록하고 있다.
  • 어느 시점에 어떤 작업을 했는지 정확히 기억이 안날 때 앞 뒤로 검색해보면서 뒤져야 한다.
  • 목록으로 다시 나갔다가 콘텐츠로 돌아오기는 귀찮다.
  • 포스팅 콘텐츠 페이지에서 이전과 이후 포스팅으로 연결해주는 링크가 필요했다.

구글링

반영