Neoteroi / mkdocs-plugins

Plugins for MkDocs.
MIT License
116 stars 9 forks source link

[OpenAPI, Styles] Missing CSS styling for OpenAPI Docs? #59

Open Jadarma opened 4 months ago

Jadarma commented 4 months ago

I was trying to set up a demo sample, everything works as intended, except the styling does not seem to match the images in the documentation.

I did download the CSS from Release 1.0.4 (and seems like 1.0.5 doesn't provide it?), and I am sure it is correctly set up because other plugins like cards work.

The main thing I noticed missing is the coloring of the HTTP methods, like how POST is colored blue in the example result. Inspecting the HTML, I see the elements do have a http-post class and everything, but there is no mention of it anywhere in the CSS file. I then looked at the source files in this repo, and there is no file for the OpenAPI docs, only the other plugins.

Is the CSS for this plugin available somewhere separately, or am I missing something? Thank you!

For reference, my mkdocs.yml:

site_name: My Docs
theme:
  name: material

plugins:
  - search
  - neoteroi.mkdocsoad:
      use_pymdownx: true

markdown_extensions:
  - pymdownx.details
  - pymdownx.superfences
  - pymdownx.tabbed:
      alternate_style: true
  - neoteroi.cards

extra_css:
  - css/mkdocsoad.css

And a screenshot: image

awaldow commented 2 months ago

Agreed with this...I can't find a CSS file that references any of the classes I see in the Dev Console for elements in the OAD guy, and I don't even seem to be able to get the right side nav for the API methods working (if that's a CSS problem). Looked through the recent builds outputs as well, nothing there either that I can see.

awaldow commented 2 months ago

I went through all the releases, and it seems like 0.0.5 was the last release to have any OAD CSS in it of note. The next release also happens to be the one where CSS -> SASS so maybe something was missed?

RobertoPrevato commented 2 months ago

Hi @Jadarma and @awaldow Thank you for reporting this issue and the insight. I take a look this weekend.

xontab commented 3 weeks ago

Any updates @RobertoPrevato? I am encountering the same issue.