Table of Contents

Sandcastle.Tools.BuildComponents Namespace

This namespace group contains various namespaces related to the Sandcastle build components.

Classes

AdditionalHeaderResourcesComponent

This component is used add additional metadata, style sheet, and script file resources to the header of the transformed topics.

AdditionalHeaderResourcesComponent.Factory

This is used to create a new instance of the build component

CloneComponent

This build component is used to clone the topic for each set of build components and execute them on the cloned topic.

CloneComponent.Factory

This is used to create a new instance of the build component

CodeBlockComponent

This build component is used to search for <code> XML comment tags and colorize the code within them. It can also include code from an external file or a region within the file.

CodeBlockComponent.Factory

This is used to create a new instance of the build component used to colorize code blocks

CopyFromFileComponent

This build component copies elements from one or more constant XML files into the target document based on one or more copy commands that define the elements to copy and where to put them.

CopyFromFileComponent.Factory

This is used to create a new instance of the build component

CopyFromFilesComponent

This build component copies elements from one or more XML files determined using an XPath query into the target document based on one or more copy commands that define the elements to copy and where to put them.

CopyFromFilesComponent.Factory

This is used to create a new instance of the build component

CopyFromIndexComponent

This build component copies elements from an indexed set of XML files into the target document based on one or more copy commands that define the elements to copy and where to put them.

CopyFromIndexComponent.Factory

This is used to create a new instance of the build component

ExampleComponent

This build component is used to replace code references with snippets from a file

ExampleComponent.Factory

This is used to create a new instance of the build component

ForEachComponent

This component is used to execute a set of components on the topic

ForEachComponent.Factory

This is used to create a new instance of the build component

IfThenComponent

This component is used to conditionally execute a set of components based on an XPath condition

IfThenComponent.Factory

This is used to create a new instance of the build component

IntelliSenseComponent

This build component is used to generate IntelliSense files based on the documented APIs.

IntelliSenseComponent.Factory

This is used to create a new instance of the build component

LanguageSpecificTextComponent

This component is used to convert the span style language-specific text elements to the script style elements used in the HTML-based presentation styles.

LanguageSpecificTextComponent.Factory

This is used to create a new instance of the build component

MSHCComponent

This class is a modified version of the original MSHCComponent that is used to add MS Help Viewer meta data to the topics. This version allows the inclusion of a sortOrder attribute on the table of contents file elements. This allows the sort order of the elements to be defined to set the proper placement of the TOC entries when parented to an entry outside of the help file and to parent the API content within a conceptual content folder.

MSHCComponent.Factory

This is used to create a new instance of the build component

MicrosoftLearnMemberIdUrlResolver

This class is used to convert member IDs for .NET Framework class members to their Microsoft Learn URL

MultiFormatOutputComponent

This build component is used to execute one or more sets of build components each based on a specific help file output format.

MultiFormatOutputComponent.Factory

This is used to create a new instance of the build component

ResolveArtLinksComponent

This component is used to resolve links to media files (i.e images)

ResolveArtLinksComponent.Factory

This is used to create a new instance of the build component

ResolveConceptualLinksComponent

This is a modified version of the original ResolveConceptualLinksComponent that is used to resolve links to conceptual topics.

ResolveConceptualLinksComponent.Factory

This is used to create a new instance of the build component

ResolveReferenceLinksComponent

This build component is used to resolve links to reference topics

ResolveReferenceLinksComponent.Factory

This is used to create a new instance of the build component

SaveComponent

This build component is used to save the generated document or parts of it to a file

SaveComponent.Factory

This is used to create a new instance of the build component

SharedContentComponent

This build component is used to replace a given set of elements with the content of shared content items loaded from XML files.

SharedContentComponent.ApiTokenResolutionComponentFactory

This is used to create a new instance of the build component used for API token resolution

SharedContentComponent.DefaultFactory

This is used to create a new instance of the build component

ShowMissingComponent

This build component is used to add "missing" notes for missing summary, parameter, returns, value, and remarks tags. It can also add default summary documentation for constructors.

ShowMissingComponent.Factory

This is used to create a new instance of the build component

SwitchComponent

This build component executes a set of build components on the topic based on the result of an XPath expression.

SwitchComponent.Factory

This is used to create a new instance of the build component

SyntaxComponent

This build component is used to generate syntax sections for API member topics

SyntaxComponent.Factory

This is used to create a new instance of the build component

TransformComponent

This build component is used to transform the intermediate topic to its final form such as an HTML document.

TransformComponent.Factory

This is used to create a new instance of the build component

TransformDocumentDumpComponent

This build component is a development aid. It is used to save the pre-transform and post-transform document data for use in testing presentation style transformations and comparing the output.

TransformDocumentDumpComponent.Factory

This is used to create a new instance of the build component