CODEWITHSUNDEEP
restapiblueprintaglio
Sumit Maingi
Sumit Maingi

Reputation: 2263

Aglio - API Blueprint - Path variables not showing up

I have an API blueprint which goes something like this:

## Organization Users [/organizations/{id}/Users]

         + Parameters

            + id (string, required) - path variable, id of the organization.


some text was here.

### Get Org Users [GET]

some text was here.

+ Request (application/json)

When I run Aglio with something akin to:

aglio --theme-variables streak  -i AppServices/Organizations.apib -o Build/AppServices.html

I get the output like: No path variable

Notice that the path variables are simply not present.

Other facts:

  1. No warning is shown by aglio while generating the output
  2. The API blueprint validates fine.
  3. I tried all the themes aglio has to offer, same result.

Upvotes: 0

Views: 400

Answers (1)

Sumit Maingi
Sumit Maingi

Reputation: 2263

Kyle Fuller (https://github.com/kylef) answered my question on the Aglio's github issues:

The parameters section is incorrectly intended and thus showing up as raw markdown description.

I think you want something like:

## Organization Users [/organizations/{id}/Users]

+ Parameters
    + id (string, required) - path variable, id of the organization.

some text was here.

### Get Org Users [GET]

some text was here.

+ Request (application/json)

Upvotes: 0

Related Questions