使用raml2html时，未展开JSON模式引用（$ ref）

Question

我使用raml2html从JSON模式生成HTML页面。但是我的JSON模式中使用的模式引用（$ ref）没有按预期扩展，我不确定原因。

我已按照raml-jsonschema-expander的说明操作，这是raml2html用来扩展参考文献的工具。

我的引用JSON架构：

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "id": "http://raw.github.com/path/to/balances.json#",
  ...
  ...
      "$ref": "balance.json#"
  ...

我引用的JSON架构balance.json，它托管在GitHub上：

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "id": "http://raw.github.com/path/to/balance.json#",
  ...

Answer 1

问题似乎来自GitHub提供内容的方式，如this SO question中所述。

我最终在该存储库中设置了gh-pages分支，并将JSON模式文件存储在该分支中。现在可以正确地获取和呈现引用的模式。