starlight-openapi icon indicating copy to clipboard operation
starlight-openapi copied to clipboard

Decorate more html entities with classes

Open jbergstroem opened this issue 1 year ago • 2 comments

Is your feature request related to a problem?

When attempting to style the generated html I found it difficult to target certain elements. It would be great if more classes/other targeting options were available to style it.

Describe the solution you'd like

All elements are easily stylable with classnames for recurring elements and perhaps path for the rest

Describe alternatives you've considered

No response

Additional Context

No response

jbergstroem avatar Jul 23 '24 17:07 jbergstroem

Thanks for the feedback :raised_hands:

Customization was definitely not something that was considered a lot when building the initial version of the plugin but this is a totally valid point that could be easily improved :thumbsup:

If you already know some parts that you had difficulties with, feel free to let me know so I can make sure to not miss them.

HiDeoo avatar Jul 24 '24 07:07 HiDeoo

Hi, I'm also looking at using Astro/Starlight as docsite for an OpenAPI REST interface, and especially looking how to customize styles.

Here a re few examples:

Image

Above section is divided in 3 <p> but the bottom margin for each <p> is to less. How to increase that? Next to that it contains <code> tags for describing the fields, Is it possible to style these <code> elements within the description?

Image

Here with a bit longer field names it looks quite jumpy... is it possible to change the width? OR maybe better to change the font size as well?

marceloverdijk avatar May 27 '25 17:05 marceloverdijk