API Blueprintファイルには何を意味するのですか？

Question

他のファイルをインクルードするためのインクルードディレクティブを追加する機能要求がありましたが、API Blueprint仕様ではそれについて言及することはできません。

Answer 1

Includeは、他のファイルを含むための同名の非標準指令（API Blueprintのaglioツールは後者をサポートしていますが）と混同しないでください。

Includeは、the MSON specificationで定義されています。これは、API Blueprint仕様で参照されています。たとえば、API Blueprintファイルのデータ構造セクションで定義されている名前付きの型は、MSONを使用して定義されます。

これは、Javaではextendsと同様です。現在定義されている型は、指定された「スーパータイプ」のすべてのフィールドを継承します。キーワードIncludeインライン型定義により、幾分奇妙、名前付きの型（その通常の使用）の名前が続いてもよい。

MSONは 別の名前付きの型の多重継承をサポートしてミックスインタイプを定義します。継承される名前付きタイプは、構造 タイプまたはそのサブタイプでなければなりません。

mixed-in名前付き タイプに定義され継承されたネストされたメンバータイプは、ミックスインタイプと同じインデントレベルで追加されます。

ミックスインタイプ→ - タイプ名を含む| - タイプ定義を含める