Sisk

Class

HtmlDocumentationExporter

Namespace
Sisk.Documenting.Html
Assembly
Sisk.Documenting.Html.dll

Represents a class for exporting API documentation to HTML format.

C#
public class HtmlDocumentationExporter : IApiDocumentationExporter

Inheritance #

object ← HtmlDocumentationExporter

Implements #

IApiDocumentationExporter

Inherited Members #

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Constructors #

NameDescription
HtmlDocumentationExporter()Creates an new instance of the HtmlDocumentationExporter class.

Properties #

NameDescription
FooterGets or sets an optional object to append after the generated contents, right at the end of the <main> tag of the generated page.
FormatEndpointHeadersGets or sets the format string for endpoint headers.
FormatEndpointParametersGets or sets the format string for endpoint request parameters.
FormatEndpointPathParametersGets or sets the format string for endpoint path parameters.
FormatEndpointRequestExamplesGets or sets the format string for endpoint request examples.
FormatEndpointResponsesGets or sets the format string for endpoint responses.
FormatMainTitleServiceVersionGets or sets the format string for the main title service version.
FormatRequiredTextGets or sets the format string for required text.
HeadGets or sets an optional object to append inside the <head> tag of the generated page.
HeaderGets or sets an optional object to append after the main title, at the beginning of the <main> tag of the generated page.
PageTitleGets or sets the title of the HTML page.
ScriptGets or sets the JavaScript script to be included in the HTML page.
StyleGets or sets the CSS styles of the HTML page.

Methods #

NameDescription
CreateCodeBlock(string, string?)Creates an HTML code block element from the provided code and language.
CreateEndpointBadge(RouteMethod, string?)Creates an HTML badge element for an API endpoint.
CreateParagraphs(string?)Creates one or more HTML paragraph elements from the provided text.
Ellipsis(string?, int)Truncates a string to the specified size, appending an ellipsis if necessary.
ExportDocumentationContent(ApiDocumentation)Exports the API documentation as HTTP content.
ExportHtml(ApiDocumentation)Exports the API documentation as an HTML string.
GetRouteMethodHexColor(RouteMethod)Gets the hex color code associated with the specified route method.
TransformId(string)Transforms an unsafe ID into a safe and valid HTML ID.
WriteEndpointDescription(ApiEndpoint)Writes the description of an API endpoint.
WriteMainTitle(ApiDocumentation)Writes the main title of the API documentation.

Type to search the documentation and the API reference.