# metanorma/metanorma-mbxif architecture

> Architecture diagram of the GitHub repository metanorma/metanorma-mbxif, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/metanorma/metanorma-mbxif
- Repository: https://github.com/metanorma/metanorma-mbxif

## Overview

This repository is an authoring guide for the MBx-IF Metanorma document class, not the class implementation itself. Authors prepare Metanorma AsciiDoc documents with MBx-IF metadata, contributor information, and a supported document type; Metanorma processes them using the mbxif class and produces requested output formats. The README documents recommended document structure and optional presentation settings. Only README.adoc is present in the supplied tree, so implementation internals and individual processing calls cannot be represented.

Main entry points: [`README.adoc`](https://github.com/metanorma/metanorma-mbxif/blob/main/README.adoc) (AsciiDoc document)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Document authoring"]
  node_adoc["AsciiDoc document<br/>[README.adoc]"]
end

subgraph group_document_model["Document definition"]
  node_doctype["Document types<br/>[README.adoc]"]
  node_structure["Document structure<br/>[README.adoc]"]
  node_metadata["Header attributes<br/>[README.adoc]"]
  node_contributors["Contributor details<br/>[README.adoc]"]
end

subgraph group_processing["Metanorma processing"]
  node_class["mbxif document class<br/>[README.adoc]"]
  node_outputs["Selected output formats<br/>[README.adoc]"]
end

node_author(("MBx-IF author"))
node_metanorma["Metanorma"]

node_author -->|"authors"| node_adoc
node_adoc -->|"selects type"| node_doctype
node_adoc -->|"organizes content"| node_structure
node_adoc -->|"sets attributes"| node_metadata
node_adoc -->|"records contributors"| node_contributors
node_adoc -->|"submits document"| node_metanorma
node_metanorma -->|"uses class"| node_class
node_metanorma -->|"generates formats"| node_outputs

click node_adoc "https://github.com/metanorma/metanorma-mbxif/blob/main/README.adoc"
click node_doctype "https://github.com/metanorma/metanorma-mbxif/blob/main/README.adoc"
click node_structure "https://github.com/metanorma/metanorma-mbxif/blob/main/README.adoc"
click node_metadata "https://github.com/metanorma/metanorma-mbxif/blob/main/README.adoc"
click node_contributors "https://github.com/metanorma/metanorma-mbxif/blob/main/README.adoc"
click node_class "https://github.com/metanorma/metanorma-mbxif/blob/main/README.adoc"
click node_outputs "https://github.com/metanorma/metanorma-mbxif/blob/main/README.adoc"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_adoc toneBlue
class node_doctype,node_structure,node_metadata,node_contributors toneAmber
class node_class,node_outputs toneMint
class node_author,node_metanorma toneIndigo
```

## Components

### Document authoring

- [AsciiDoc document](https://github.com/metanorma/metanorma-mbxif/blob/main/README.adoc): `README.adoc`

### Document definition

- [Document types](https://github.com/metanorma/metanorma-mbxif/blob/main/README.adoc): `README.adoc`
- [Document structure](https://github.com/metanorma/metanorma-mbxif/blob/main/README.adoc): `README.adoc`
- [Header attributes](https://github.com/metanorma/metanorma-mbxif/blob/main/README.adoc): `README.adoc`
- [Contributor details](https://github.com/metanorma/metanorma-mbxif/blob/main/README.adoc): `README.adoc`

### Metanorma processing

- [mbxif document class](https://github.com/metanorma/metanorma-mbxif/blob/main/README.adoc): `README.adoc`
- [Selected output formats](https://github.com/metanorma/metanorma-mbxif/blob/main/README.adoc): `README.adoc`

### Other components

- **MBx-IF author**
- **Metanorma**

## Connections

- MBx-IF author → AsciiDoc document: authors
- AsciiDoc document → Document types: selects type
- AsciiDoc document → Document structure: organizes content
- AsciiDoc document → Header attributes: sets attributes
- AsciiDoc document → Contributor details: records contributors
- AsciiDoc document → Metanorma: submits document
- Metanorma → mbxif document class: uses class
- Metanorma → Selected output formats: generates formats