Skip to content
Open
3 changes: 3 additions & 0 deletions app/controllers/help_controller.rb
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,9 @@ class HelpController < ApplicationController
skins_basics
skins_creating
skins_parents
skins_wizard_font_size
skins_wizard_font
Comment on lines +20 to +21

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Following the ancient tag wrangling wisdom of "nothing before something", these two should switch places to be alphabetical please (and in routes.rb as well)

@ASalbenblatt ASalbenblatt Oct 24, 2026 •

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Even though that would make this list no longer match how the files themselves are automatically ordered in the folder? (due to _ coming before .)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

That's a good point and I had to take a bit to think about it. I think in this case both reasonings are perfectly sensible so I'll leave it up to you what you go for. I'll just force future PRs to match yours so we're consistent 😂

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I think leave it like this, because I feel like the only reason you'd really go looking through this list is if you were also modifying the files in some way, so I feel like they should match.

skins_wizard_vertical_gap
symbols_key
tags_additional
tags_categories
Expand Down
3 changes: 3 additions & 0 deletions app/views/help/skins_wizard_font.html.erb
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
<p><%= t(".default_html", default_fonts_code: tag.code("'Lucida Grande', 'Lucida Sans Unicode', Verdana, Helvetica, sans-serif, 'GNU Unifont'")) %></p>
<p><%= t(".description") %></p>
<p><%= t(".single_or_double_quotes_html", double_quote_example: tag.kbd('"Lucida Grande"'), single_quote_example: tag.kbd("'Lucide Sans Unicode'")) %></p>
2 changes: 2 additions & 0 deletions app/views/help/skins_wizard_font_size.html.erb
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
<p><%= t(".default_html", one_hundred_percent_code: tag.code("100%")) %></p>
<p><%= t(".description_html", one_hundred_typed: tag.kbd("100")) %></p>
3 changes: 3 additions & 0 deletions app/views/help/skins_wizard_vertical_gap.html.erb
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
<p><%= t(".default_html", default_value_code: tag.code("1.1286em")) %></p>
<p><%= t(".description") %></p>
<p><%= t(".examples_html", two_typed: tag.kbd("2"), zero_point_five_typed: tag.kbd("0.5")) %></p>
6 changes: 3 additions & 3 deletions app/views/skins/_wizard_form.html.erb
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@
<dl>
<dt>
<%= f.label :font, ts('Font') %>
<%= link_to_help('skins-wizard-font') %>
<%= link_to_help_modal(help_skins_wizard_font_path, t(".font_help_title")) %>
</dt>
<dd>
<%= f.text_field :font, "aria-describedby" => "font-field-notes" %>
Expand All @@ -30,7 +30,7 @@

<dt>
<%= f.label :base_em, ts('Percent of browser font size') %>
<%= link_to_help('skins-wizard-font-size') %>
<%= link_to_help_modal(help_skins_wizard_font_size_path, t(".font_size_help_title")) %>
</dt>
<dd>
<%= f.text_field :base_em, "aria-describedby" => "base-em-field-notes" %>
Expand All @@ -51,7 +51,7 @@

<dt>
<%= f.label :paragraph_margin, ts('Vertical gap between paragraphs') %>
<%= link_to_help('skins-wizard-vertical-gap') %>
<%= link_to_help_modal(help_skins_wizard_vertical_gap_path, t(".vertical_gap_help_title")) %>
</dt>
<dd>
<%= f.text_field :paragraph_margin %>
Expand Down
14 changes: 14 additions & 0 deletions config/locales/views/en.yml
Original file line number Diff line number Diff line change
Expand Up @@ -1607,6 +1607,17 @@ en:
load_archive_skin_components: If you create a replacement skin, you might want to load up all the skins that make up the current default Archive site as parents. This option is only available when you select "replace archive skin entirely" from the "What it does" menu. After that, you can edit your skin and delete just the ones you don't want. This will be easier if you are using nearly all of them, since there are a lot!
load_archive_skin_components_header: Load Archive Skin Components
skins_interface_faq: the Skins and Interface FAQ
skins_wizard_font:
default_html: 'The default is: %{default_fonts_code}'
description: Put any font name in here, and if it's installed on your computer, it'll work for you. If you use several different devices, specify some fall-back fonts, with commas in between the names, in case one of your devices doesn't have the first font.
single_or_double_quotes_html: You can use either single or double quotation marks around fonts with multi-word names, e.g. %{double_quote_example} or %{single_quote_example}.
skins_wizard_font_size:
default_html: 'The default is: %{one_hundred_percent_code}'
description_html: Font sizes on the Archive are based on a percentage of your browser's default font size. Use a number smaller than 100 to make the Archive's text smaller, or use a number larger than 100 to make the text larger. Entering %{one_hundred_typed} will keep the Archive's default font sizes.
skins_wizard_vertical_gap:
default_html: 'The default is: %{default_value_code}'
description: Put any number in here and it will be applied as a multiple of the work's font size. A larger number will give you bigger spacing between paragraphs.
examples_html: For example, most users see works at a font size of 15 pixels. Entering %{two_typed} will create a vertical gap of 30 pixels, and entering %{zero_point_five_typed} will create a gap of about 8 pixels.
symbols_key:
categories:
alt: Second Square
Expand Down Expand Up @@ -2942,8 +2953,11 @@ en:
revert_to_default: Revert to Default Skin
wizard_form:
description: Description
font_help_title: Skins wizard font
font_size_help_title: Skins wizard font size
skins_parents_help_title: Skins parents
title: Title
vertical_gap_help_title: Skins wizard vertical gap
stats:
index:
flat_view: Flat View
Expand Down
3 changes: 3 additions & 0 deletions config/routes.rb
Original file line number Diff line number Diff line change
Expand Up @@ -675,6 +675,9 @@
get "/help/skins-basics.html", to: redirect("/help/skins_basics")
get "/help/skins-creating.html", to: redirect("/help/skins_creating")
get "/help/skins-parents.html", to: redirect("/help/skins_parents")
get "/help/skins-wizard-font-size.html", to: redirect("/help/skins_wizard_font_size")
get "/help/skins-wizard-font.html", to: redirect("/help/skins_wizard_font")
get "/help/skins-wizard-vertical-gap.html", to: redirect("/help/skins_wizard_vertical_gap")
get "/help/symbols-key.html", to: redirect("/help/symbols_key")
get "/help/additional-tags-help.html", to: redirect("/help/tags_additional")
get "/help/categories-help.html", to: redirect("/help/tags_categories")
Expand Down
2 changes: 0 additions & 2 deletions public/help/skins-wizard-font-size.html

This file was deleted.

3 changes: 0 additions & 3 deletions public/help/skins-wizard-font.html

This file was deleted.

3 changes: 0 additions & 3 deletions public/help/skins-wizard-vertical-gap.html

This file was deleted.

Loading