대형 백본 스타일 응용 프로그램 (~ 100 개 파일)이 있으며 설명서 자동화에 가장 적합한 방법을 선택하려고합니다.더 나은 Docco 페이지 구성 방법
저는 docco (실험실은 grunt-docco2)이지만 문제가 있습니다. 모든 파일을 가지고 왼쪽에 목록이 있고 스크롤 할 방법이없는 창을지나 아래로 내려갑니다. 그들을 그룹화 할 수 있습니까, 어쩌면 드롭 다운 스타일일까요?
또한 색인 페이지를 생성 할 수 있습니까? Docco는 내가 원하는 모든 것의 99 %를하는 것처럼 보이지만,이 두 가지가 나를 미치게 만듭니다!
그래, 단단한 목차를 생성하는 방법을 찾지 못했습니다.
그러나 미친 스크롤을 막을 방법을 찾았습니다.
#jump_page가 docco.css에 정의되어, 그것은 변경 :
#jump_page {
padding: 5px 0 3px;
margin: 0 0 25px 25px;
max-height:750px;
overflow: scroll;
}
나는 다음 내 변경된 스타일 시트를 가져다가 대신 docco CSS의 옵션을 사용하여 그것을 통과시켰다.
가장 좋은 해결책은 아니지만 최대 높이를 설정하고 스크롤링을 허용하므로 많은 양의 파일을 문서화하려는 경우 더 빠르게 탐색 할 수 있습니다.
아마도 지금은 관련이 없지만 Docco Husky 프로젝트가 있습니다. 체크 아웃해야합니다. Docco와 같은 프로젝트입니다. 자신의 README.md에서
:
Docco를 기반으로 프로젝트 문서에 대한 효율적인 정적 사이트 발전기. "허스키"는 Docco보다 더 크고 불규칙하기 때문에 허스키 청바지처럼 Sears에서 다시 살 수 있습니다.