docfx 사용법

1.비주얼 스튜디오 내에서 폴더 만들고,

toc.md를 만들어서 헤드 상단 메뉴를 추가할 수 있다.
(md파일은 빌드시 자동으로 html파일로 바뀐다. )

추가한 폴더에 roc.md 에는 다음과 같이 사이드 메뉴를 추가할 수 있다.
메뉴이름. 바인딩 파일 (같은 폴더)
#[mmm1](menu1.md)
#[mmm2](menu2.md)



2.그 후에는 탑레벨 폴더의
toc.yml에 다음을 추가해 준다.


- name: Articles
  href: articles/
- name: API Documentation
  href: obj/api/
- name: ScondMenu 상당 바 메뉴에서 표시될 이름
  href: Second/  폴더이름
  homepage: api/index.md

탑레벨의  Index.md파일은 홈페이지 대문 페이지 이다. 

3. 추가한 폴더에 메뉴 대문용 페이지파일은 만든다. 

ex: intro.md

 

4. 빌드후 _site폴더에 toc.html 을 편집하자. 

여기에 보면 

 

   

     

       

       

     

   

   

     

          

         

           

              Articles

           

           

              API Documentation

           

           

              ScondMenu

           

         

     

   

 

저부분이 멋대로 써져있는데 이부분은 _site/Second 폴더안의 파일로 바꿔 줘야 한다. 

bref는 대문용 페이지를 , name 은 toc.html로 바꾼다. 

그러면 끝

r