Problem with TOC in SLATE

foliant-docs / foliant

Comprehensive markdown-based documentation toolkit

https://foliant-docs.github.io/docs/

MIT License

160 stars 9 forks source link

Problem with TOC in SLATE #56

Closed AlejandroOteroFreire closed 4 years ago

AlejandroOteroFreire commented 4 years ago

Hi, I'm using your tool to create and slate api doc site but I have a problem with the TOC list. It put the Parameters, Response and Response Schema at the same level of the method. (docker-compose run --rm foliant make site -w slate)

If I've converted the project to slate source (docker-compose run --rm foliant make slate) and run the slate source, it appear OK.

Do you know where is the problem?

moigagoo commented 4 years ago

@AlejandroOteroFreire Hi! Did you solve the issue on your own? Would you mind sharing the solution for the future generations of Foliant users?

AlejandroOteroFreire commented 4 years ago

Yes the problem was when you tried to mix content (static and swagger), you must do it is this way: `chapters:

index.md
apis.md But if you do it is this way it not work: chapters:
index.md _ APIS:
- apis.md`

Now I'm looking a way to put together few swagger file without repeat the schema part. Do you have some prepocessor to do that?

I've this `

` The result of that is:

In the image you can se "Schema" twice, the idea is to have one "Schema" with all schema from all api.