Skip to content

Conversation

@hunternet93
Copy link
Contributor

Issue

https://otwarchive.atlassian.net/browse/AO3-7210

Purpose

Migrates the static skins-creating.html help file to a localized view on the help controller.

@hunternet93
Copy link
Contributor Author

Styling: When in a modal, the skins-creating page is in a context where rules like .userstuff dt apply, causing <dt> headers to appear in bold. However, when rendered directly at /help/skins_creating, the parent userstuff class is not applied, resulting in the page being a bit harder to read. Should this be fixed by applying .userstuff as a class on a parent element, or in some other way?

@slavalamp
Copy link
Contributor

Styling: When in a modal, the skins-creating page is in a context where rules like .userstuff dt apply, causing <dt> headers to appear in bold. However, when rendered directly at /help/skins_creating, the parent userstuff class is not applied, resulting in the page being a bit harder to read. Should this be fixed by applying .userstuff as a class on a parent element, or in some other way?

that's a problem with all new help pages (and not the only problem either), i think the ad&t are still deciding what to do about it, so you don't need to do anything right now. i'm expecting there will be a new issue or several in the future for this

@hunternet93 hunternet93 marked this pull request as ready for review January 21, 2026 21:20
@Bilka2 Bilka2 changed the title AO3-7210: Migrate skins-creating.html help file to help controller AO3-7210 Migrate skins-creating.html help file to help controller Jan 22, 2026
@Bilka2 Bilka2 self-requested a review January 22, 2026 21:39
Copy link
Contributor

@Bilka2 Bilka2 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for working on this complicated file!

t(".numeric_values.description.various_units"),
"https://w3schools.com/css/css_units.asp"
)
) %><br /><code>cm, em, ex, in, mm, pc, pt, px</code></p>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this list should be entirely in the locale file, since we need to be able to localise the comma, as it's a sentence, not CSS. And language like Chinese use a different comma character. Ideally this should be part of the precision_html string, if possible

<p><%= t(
".scale.description_html",
transform_code: tag.code("transform"),
scale_numeric_value_code: tag.code("scale(#{t('.scale.numeric_value')})")
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm wondering whether it would be better to have the entire scale(numeric value) be in the locale file, not just numeric value. But I can't really come up with a reason for it other than this looking quite strange, which isn't enough of a reason to make you change it

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It does look kinda weird, but since scale is an actual CSS keyword and not an example term I figured it belonged in the code instead of the localization. I'm fine with it either way though, just let me know if you want it changed.

@Bilka2 Bilka2 changed the title AO3-7210 Migrate skins-creating.html help file to help controller AO3-7210 I18n skins-creating.html help file Jan 27, 2026
Copy link
Contributor

@Bilka2 Bilka2 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just two more things!

Comment on lines +148 to +156
units_list_code: tag.br + tag.code(t(".numeric_values.description.units_list",
cm_code: "cm",
em_code: "em",
ex_code: "ex",
in_code: "in",
mm_code: "mm",
pc_code: "pc",
pt_code: "pt",
px_code: "px"))) %>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would prefer to have the units in the locale file so that the string isn't so split up

<dd>
<p>
<%= t(".css_basics.description.line_of_css_html",
example_css_code: tag.code("#{t('.css_basics.description.selector')} {#{t('.css_basics.description.property')}: #{t('.css_basics.description.value')};}")) %>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would prefer to have the entire thing, including the {} and semicolon, in the locale file, instead of splitting the string this much

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants