Open LuisHPorras opened 2 months ago
First of all, thanks a lot for your work, looks great and I'm willing to be able to test it and make use of it!
I'm just trying to make use of the plugin but I'm not able to do it. I'm following the docs, install the dependencies, configure the mkdocs.yml:
mkdocs.yml
# ... some config nav: - Inicio: index.md - 'Hoja de ruta': roadmap.md - Cliente: - Inicio: client/index.md - Servidor: - Inicio: server/index.md - API: server/api.md - 'Meta-documentación': metadocs.md # ... more config plugins: - search - git-revision-date - neoteroi.mkdocsoad: use_pymdownx: true markdown_extensions: - admonition - pymdownx.details - pymdownx.superfences - pymdownx.tabbed: alternate_style: true - toc: permalink: true
Create the new entry in the docs ./server/api.md:
./server/api.md
# __API__ [OAD(./openapi.yaml)]
Provide the openapi generated json file in the samse directory. And I get the following error when launching mkdocs serve:
mkdocs serve
ValueError: Invalid source: it must be either a path to .json or a .yaml file, or a valid URL.
I'm using Swagger editor to validate the openapi file and it doesn't contain errors. You can find the code at PROECOS branch 19-documentation
I haven't found much information for troubleshooting in the docs, I'll be willing to PR with updated docs if we get to find the solution.
Cheers!
I've got the same issue, not including [OAD(./openapi.json)] in the md file makes mkdocs build succeed. Having it included fails with noted error.
[OAD(./openapi.json)]
mkdocs build
First of all, thanks a lot for your work, looks great and I'm willing to be able to test it and make use of it!
Problem
I'm just trying to make use of the plugin but I'm not able to do it. I'm following the docs, install the dependencies, configure the
mkdocs.yml
:Create the new entry in the docs
./server/api.md
:Provide the openapi generated json file in the samse directory. And I get the following error when launching
mkdocs serve
:I'm using Swagger editor to validate the openapi file and it doesn't contain errors. You can find the code at PROECOS branch 19-documentation
I haven't found much information for troubleshooting in the docs, I'll be willing to PR with updated docs if we get to find the solution.
Cheers!