Note: This is the migration API reference for FAKE 5. The new (modularized) API documentation can be found here. If the API is already migrated you can check here if exists in a module. More information regarding the migration can be found here

DocFx

Contains helper functions to use DocFx https://dotnet.github.io/docfx/.

Nested types and modules

TypeDescription
BuildParams

Build-Command parameters

CommonParams
DownloadParams

Download-Command parameters

ExportTemplateParams

ExportTemplate-Command parameters

InitParams

Init-Command parameters

LogLevel
LogParams

Parameters for logging

MetadataParams

Metadata-Command parameters

PdfParams

Pdf-Command parameters

ServeParams

Serve-Command parameters

Functions and values

Function or valueDescription
DocFx.build(setParams)
Signature: setParams:(BuildParams -> BuildParams) -> unit

Builds a DocFx documentation.

Parameters

  • setParams - Function used to manipulate the default build parameters. See BuildParams.Create()

    Sample

    1: 
    2: 
    3: 
    4: 
    5: 
    
    DocFx.build (fun p -> 
     { p with 
         OutputFolder = "build" @@ "docs"
         ConfigFile = "docs" @@ "docfx.json"    
     })
    
DocFx.download(setParams)
Signature: setParams:(DownloadParams -> DownloadParams) -> unit

Download xref archive.

Parameters

  • setParams - Function used to manipulate the default download parameters. See DownloadParams.Create()

    Sample

    1: 
    2: 
    3: 
    4: 
    5: 
    
     DocFx.download (fun p -> 
         { p with 
                 ArchiveFile = "archive"
                 Uri = "uri"
         })
    
DocFx.exec setParams command args
Signature: setParams:(CommonParams -> CommonParams) -> command:string -> args:string -> unit
DocFx.exportTemplate(setParams)
Signature: setParams:(ExportTemplateParams -> ExportTemplateParams) -> unit

Exports template files.

Parameters

  • setParams - Function used to manipulate the default exportTemplate parameters. See ExportTemplateParams.Create()

    Sample

    1: 
    2: 
    3: 
    4: 
    5: 
    
     DocFx.exportTemplate (fun p -> 
         { p with 
                 All = true
                 OutputFolder = "templates"
         })
    
DocFx.init(setParams)
Signature: setParams:(InitParams -> InitParams) -> unit

Initialize a DocFx documentation.

Parameters

  • setParams - Function used to manipulate the default Init parameters. See InitParams.Create()

    Sample

    1: 
    2: 
    3: 
    4: 
    5: 
    
     DocFx.init (fun p -> 
      { p with 
          Overwrite = true
          Timeout = TimeSpan.FromMinutes 10.
      })
    
DocFx.metadata(setParams)
Signature: setParams:(MetadataParams -> MetadataParams) -> unit

Serves a DocFx documentation.

Parameters

  • setParams - Function used to manipulate the default serve parameters. See MetadataParams.Create()

    Sample

    1: 
    2: 
    3: 
    4: 
    5: 
    
     DocFx.metadata (fun p -> 
         { p with 
                 ConfigFile = "docs" @@ "docfx.json"
                 DisableGitFeatures = true
         })
    
DocFx.pdf(setParams)
Signature: setParams:(PdfParams -> PdfParams) -> unit

Builds a Pdf-File from a DocFx documentation.

Parameters

  • setParams - Function used to manipulate the default pdf parameters. See PdfParams.Create()

    Sample

    1: 
    2: 
    3: 
    4: 
    5: 
    6: 
    7: 
    8: 
    
    DocFx.pdf (fun p ->
        { p with
                Name = "Docs.pdf" }
          .WithBuildParams (fun b -> 
               { b with 
                   OutputFolder = "build" @@ "docs"
                   ConfigFile = "docs" @@ "docfx.json"})
                )   
    
DocFx.serve(setParams)
Signature: setParams:(ServeParams -> ServeParams) -> unit

Serves a DocFx documentation.

Parameters

  • setParams - Function used to manipulate the default serve parameters. See ServeParams.Create()

    Sample

    1: 
    2: 
    3: 
    4: 
    5: 
    6: 
    
     DocFx.serve (fun p -> 
         { p with 
                 Host = "localhost"
                 Port = Some 80
                 Folder = "docs"
         })
    
union case Option.Some: Value: 'T -> Option<'T>