콧수염을 지원하는 DocFx 템플릿을 만들려고합니다. 프로젝트 루트의 toc.yml 파일을 기반으로 생성 된 모든 HTML 페이지의 navbar에 사이트 메뉴를 생성하고 싶습니다. 기본 템플릿이이 작업을 수행한다는 것을 알고 있습니다. 그러나 그것은 명백하게 Toc.yml을 독립 HTML 파일로 변환하여 개념 HTML 파일의 javascript로 파싱하여
NuGet 패키지가 포함 된 Visual Studio의 DocFx 문서를 컴파일하고 있습니다. 나는 이탈리아어로 작성하고 우리는 같은 문자가 많이 있습니다 àèìòù합니다. 최종 렌더링에서 내 페이지는 다음과 같습니다 최종 HTML은 다음과 같습니다 가 어떻게 제대로 렌더링 할 수 있습니까?
명령 줄에서 tutorial을 따르려고합니다. 프로젝트를 생성하고 빈 웹 사이트를 배포 한 다음 원래 계층을 유지하면서 원본 폴더에 vs2012 프로젝트를 추가했습니다. docfx.json 파일을 편집하여 "src/.csproj" "src/ .cs *"를 포함하여 재귀 적으로 검색한다고 가정합니다. 이 프로젝트는 이전에 SandCastle에서 사용하도록 주
DocFX에서 필자는 모든 (또는 대부분의) 마크 다운 파일을 넣을 필요가있는 콘텐츠 블록을 가지고 있습니다. 다른 md 파일의 내용을 병합하거나 현재 파일로 가져 오는 방법이 있습니까? 기본적으로 나는 자신을 반복하지 말고 어떤 종류의 공유 메커니즘을 찾고 있습니다.
두 가지 책임이 있습니다. 첫 번째 문제 내 프로젝트 계층 this 내가 전에 내가 docfx을 사용하여 이에 대한 설명서를 각 프로젝트 코드를합니다. 첫 번째 문제입니다. 빌드 코드를 다시 작성하지 않으려합니다. 예. docfx ./docs/docfx.json --serve -> doing the build
두 번째 문제; 다른 경로를 제공하는 문서
DocFX 구성에서 누락 된 것이 있으므로 적절한 문서가 생성되지 않습니다. 는 나는 다음과 같은 폴더 구조 한 : +Documentation
|- _site
|- api
|- apidoc
|- articles
|- images
|- src <-- This folder is autogenerated by `docfx init` command as
솔루션에 여러 프로젝트가있는 프로젝트에서 작업하고 있습니다. 응용 프로그램 코드 폴더를 깨끗하게 유지하려면 외부 디렉터리에서 설명서를 생성 할 수 있어야합니다. 내 docfx.json에 src 디렉토리를 설정하려고하면 절대 경로가 좋아 보이지 않으며 상대 경로도 마음에 들지 않습니다. {
"metadata":
[{
"src":