Introduction to Multiple Languages Support
DocFX supports generating API documentation for C# and VB natively. However, it's not limited to these. DocFX is designed to support any language. When generating documents for a language, two steps are required: generating metadata and building documents from the metadata.
2.1 Generate Metadata
As different programming language has different tool written with different language to generate API documentation, this step is not included in DocFX core. We call the tool used as Metadata Tool.
As UniversalReferenceDocumentProcessor is used to process these metadata files, the metadata tool should generate files according the processor's input schema. The files should:
- be in YAML format and end with
- have YamlMime
### YamlMime:UniversalReferenceas the first line
- conform to the data model defined for UniversalReference
Usually, a TOC should be generated along with YAML files for easy navigation among files.
2.2 Build Document
The YAML files generated are used as input to DocFX. DocFX will build these YAML files into HTML pages.