Cake.DocFx

Cake AddIn that generates documentation for .Net API reference and markdown files using DocFx.

#addin nuget:?package=Cake.DocFx&version=1.0.0

dotnet add package Cake.DocFx --version 1.0.0

<PackageReference Include="Cake.DocFx" Version="1.0.0" />

Aliases

Contains functionality related to merging base API files using DocFx.

Build

DocFx(DocFxSettings) Obsolete. Use Cake.DocFx.DocFxBuildAliases.DocFxBuild(Cake.Core.ICakeContext,Cake.DocFx.Build.DocFxBuildSettings) instead.
DocFx(FilePath, DocFxSettings) Obsolete. Use Cake.DocFx.DocFxBuildAliases.DocFxBuild(Cake.Core.ICakeContext,Cake.Core.IO.FilePath,Cake.DocFx.Build.DocFxBuildSettings) instead.
DocFx(FilePath) Obsolete. Use Cake.DocFx.DocFxBuildAliases.DocFxBuild(Cake.Core.ICakeContext,Cake.Core.IO.FilePath) instead.
DocFx() Obsolete. Use Cake.DocFx.DocFxBuildAliases.DocFxBuild(Cake.Core.ICakeContext) instead.
DocFxBuild(DocFxBuildSettings) Generate client-only website combining API in YAML files and conceptual files for the docfx.json file in the current working directory using the specified settings.
DocFxBuild(FilePath, DocFxBuildSettings) Generate client-only website combining API in YAML files and conceptual files for a specific docfx.json file using the specified settings.
DocFxBuild(FilePath) Generate client-only website combining API in YAML files and conceptual files for a specific docfx.json file.
DocFxBuild() Generate client-only website combining API in YAML files and conceptual files for the docfx.json file in the current working directory.

Init

DocFxInit(DocFxInitSettings) Generate an initial docfx.json file, with the specified settings.
DocFxInit() Generate an initial docfx.json file.

Merge

DocFxMerge(DocFxMergeSettings) Merge base API in YAML files and toc files for the docfx.json file in the current working directory using the specified settings.
DocFxMerge(FilePath, DocFxMergeSettings) Merge base API in YAML files and toc files for a specific docfx.json file using the specified settings.
DocFxMerge(FilePath) Merge base API in YAML files and toc files for a specific docfx.json file.
DocFxMerge() Merge base API in YAML files and toc files for the docfx.json file in the current working directory.

Metadata

DocFxMetadata(DocFxMetadataSettings) Extract API documentation using DocFx, with the specified settings.
DocFxMetadata(FilePath) Extract API documentation using DocFx for a specific docfx.json file.
DocFxMetadata(IEnumerable<FilePath>) Extract API documentation using DocFx, with the specified project/source files or search patterns.
DocFxMetadata() Extract API documentation using DocFx for the docfx.json file in the current working directory.

Pdf

DocFxPdf(DocFxPdfSettings) Generates a PDF document for the docfx.json file in the current working directory using the specified settings.
DocFxPdf(FilePath, DocFxPdfSettings) Generates a PDF document for a specific docfx.json file using the specified settings.
DocFxPdf(FilePath) Generates a PDF document for a specific docfx.json file.
DocFxPdf() Generates a PDF document for the docfx.json file in the current working directory.

Serve

DocFxServe(DirectoryPath, DocFxServeSettings) Serve a website from the specified directory with the specified settings.
DocFxServe(DirectoryPath) Serve a website from the specified directory.
DocFxServe() Serve a website from the current directory.
DocFxServeStart(DirectoryPath, DocFxServeSettings) Start serving a website from the specified directory with the specified settings.
DocFxServeStart(DirectoryPath) Start serving a website from the specified directory.
DocFxServeStart() Start serving a website from the current directory.