shiplog 0.2.0 → 0.3.1

data/app/views/shiplog/admin/entries/_entry_row.html.erb

@@ -2,6 +2,9 @@
   <td>
     <%= link_to entry_heading(entry), edit_entry_path(entry, inbox_filter_params) %>
     <%= render "shiplog/admin/entries/badges", entry: %>
+    <% if entry.area %>
+      <span class="shiplog-badge shiplog-badge--area"><%= entry.area.name %></span>
+    <% end %>
     <% if entry.discarded? && entry.discard_reason.present? %>
       <div class="shiplog-admin__muted"><%= entry.discard_reason %></div>
     <% end %>

data/app/views/shiplog/admin/entries/_images.html.erb

@@ -0,0 +1,41 @@
+<%# locals: (entry:) %>
+<section class="shiplog-admin-panel shiplog-admin-images">
+  <h2><%= t("shiplog.admin.entries.images.title", default: "Screenshots") %></h2>
+  <p class="shiplog-admin__muted"><%= t("shiplog.admin.entries.images.help", default: "Shown under the text on the changelog (the first one in the list, all of them on the entry's page). Taken from the GitHub issue or pull request when the draft is written; you can also upload your own.") %></p>
+  <% images = entry.ordered_images %>
+  <% if images.empty? %>
+    <p class="shiplog-admin__muted"><%= t("shiplog.admin.entries.images.empty", default: "No screenshots yet.") %></p>
+  <% else %>
+    <ol class="shiplog-admin-images__list">
+      <% images.each_with_index do |image, index| %>
+        <li class="shiplog-admin-images__item">
+          <% thumbnail = image_thumbnail_path(image) %>
+          <%= tag.img(src: thumbnail, alt: entry.image_alt(image), class: "shiplog-admin-images__thumb", loading: "lazy") if thumbnail %>
+          <div class="shiplog-admin-images__controls">
+            <%= form_with url: entry_image_path(entry, image.blob_id, inbox_filter_params), method: :patch, class: "shiplog-admin-inline-form" do |form| %>
+              <%= form.label :alt, t("shiplog.admin.entries.images.alt", default: "Alt text"), for: "alt_#{image.blob_id}" %>
+              <%= form.text_field :alt, id: "alt_#{image.blob_id}", value: entry.custom_image_alt(image), maxlength: Shiplog::Entry::Images::ALT_MAX_LENGTH, placeholder: t("shiplog.admin.entries.images.alt_placeholder", default: "Describe the image (defaults to the title)") %>
+              <%= form.submit t("shiplog.admin.entries.images.save_alt", default: "Save alt text"), class: "shiplog-button" %>
+            <% end %>
+            <div class="shiplog-admin-inline-form">
+              <% if index.positive? %>
+                <%= button_to t("shiplog.admin.entries.images.move_up", default: "Up"), entry_image_move_path(entry, image.blob_id, inbox_filter_params.merge(direction: "up")), class: "shiplog-button" %>
+              <% end %>
+              <% if index < images.size - 1 %>
+                <%= button_to t("shiplog.admin.entries.images.move_down", default: "Down"), entry_image_move_path(entry, image.blob_id, inbox_filter_params.merge(direction: "down")), class: "shiplog-button" %>
+              <% end %>
+              <%= button_to t("shiplog.admin.entries.images.remove", default: "Remove"), entry_image_path(entry, image.blob_id, inbox_filter_params), method: :delete, class: "shiplog-button" %>
+            </div>
+          </div>
+        </li>
+      <% end %>
+    </ol>
+  <% end %>
+  <%= form_with url: entry_images_path(entry, inbox_filter_params), multipart: true, class: "shiplog-admin-form" do |form| %>
+    <p>
+      <%= form.label :images, t("shiplog.admin.entries.images.upload_label", default: "Images (PNG, JPEG, GIF or WebP, up to 5 MB each)") %>
+      <%= form.file_field :images, multiple: true, name: "images[]", accept: Shiplog::ImageType::EXTENSIONS.keys.join(",") %>
+    </p>
+    <%= form.submit t("shiplog.admin.entries.images.upload", default: "Upload images"), class: "shiplog-button" %>
+  <% end %>
+</section>

data/app/views/shiplog/admin/entries/_translations.html.erb

@@ -0,0 +1,42 @@
+<%# locals: (entry:) %>
+<%# one editable title and body per configured locale (config.locales), with its state: missing, stale (made from older English text), edited by an admin, or up to date. Needs Shiplog::Admin::EntriesHelper. %>
+<% translations = entry.translations.index_by(&:locale) %>
+<section class="shiplog-admin-panel shiplog-translations">
+  <h2><%= t("shiplog.admin.entries.translations.title", default: "Translations") %></h2>
+  <p class="shiplog-admin__muted"><%= t("shiplog.admin.entries.translations.help", default: "Approving an entry translates it automatically, and the translation is published with the English text. A translation you edit is kept until the English text changes; then it is translated again. A stale or missing translation is not shown: visitors see the English text.") %></p>
+  <% unless entry.approved? %>
+    <p class="shiplog-admin__muted"><%= t("shiplog.admin.entries.translations.not_approved", default: "Translations are written when the entry is approved.") %></p>
+  <% end %>
+  <% Shiplog.config.locales.each do |locale| %>
+    <% translation = translations[locale.to_s] %>
+    <div class="shiplog-translation" data-locale="<%= locale %>">
+      <h3>
+        <%= translation_language_label(locale) %>
+        <% if translation.nil? %>
+          <span class="shiplog-badge"><%= t("shiplog.admin.entries.translations.missing", default: "Missing") %></span>
+        <% elsif translation.stale? %>
+          <span class="shiplog-badge"><%= t("shiplog.admin.entries.translations.stale", default: "Stale") %></span>
+        <% else %>
+          <span class="shiplog-badge"><%= t("shiplog.admin.entries.translations.current", default: "Up to date") %></span>
+        <% end %>
+        <% if translation&.edited_by_admin %>
+          <span class="shiplog-badge"><%= t("shiplog.admin.entries.translations.edited", default: "Edited by an admin") %></span>
+        <% end %>
+      </h3>
+      <%= form_with url: entry_translation_path(entry, inbox_filter_params.merge(translation_locale: locale)), scope: :translation, method: :patch, class: "shiplog-admin-form" do |form| %>
+        <p>
+          <%= form.label :title, t("shiplog.admin.entries.fields.title"), for: "translation_#{locale}_title" %>
+          <%= form.text_field :title, value: translation&.title, id: "translation_#{locale}_title", lang: locale %>
+        </p>
+        <p>
+          <%= form.label :body, t("shiplog.admin.entries.fields.body"), for: "translation_#{locale}_body" %>
+          <%= form.text_area :body, value: translation&.body, rows: 5, id: "translation_#{locale}_body", lang: locale %>
+        </p>
+        <%= form.submit t("shiplog.admin.entries.save"), class: "shiplog-button shiplog-button--primary" %>
+      <% end %>
+      <% if entry.approved? %>
+        <%= button_to t("shiplog.admin.entries.translations.retranslate", default: "Retranslate"), entry_translation_retranslation_path(entry, inbox_filter_params.merge(translation_locale: locale)), class: "shiplog-button" %>
+      <% end %>
+    </div>
+  <% end %>
+</section>

data/app/views/shiplog/admin/entries/edit.html.erb

@@ -28,6 +28,10 @@
             <%= form.select :changelog_kind, Shiplog::Entry::CHANGELOG_KINDS.map { |kind| [ t("shiplog.admin.entries.category_options.#{kind}"), kind ] } %>
           </p>
         <% end %>
+        <p>
+          <%= form.label :area_id, t("shiplog.admin.entries.fields.area", default: "Area") %>
+          <%= form.collection_select :area_id, Shiplog::Area.ordered, :id, :name, include_blank: t("shiplog.admin.entries.no_area", default: "None") %>
+        </p>
         <p>
           <%= form.label :released_on, t("shiplog.admin.entries.fields.released_on") %>
           <%= form.date_field :released_on %>
@@ -63,5 +67,13 @@
     </aside>
   </div>
 
+  <% if Shiplog.config.locales.any? %>
+    <%= render "shiplog/admin/entries/translations", entry: @entry %>
+  <% end %>
+
+  <% if Shiplog.images? %>
+    <%= render "shiplog/admin/entries/images", entry: @entry %>
+  <% end %>
+
   <p><%= link_to t("shiplog.admin.entries.back"), entries_filter_path(**inbox_filter_params) %></p>
 <% end %>

data/app/views/shiplog/changelog_entries/show.html.erb

@@ -0,0 +1,23 @@
+<% content_for :title, t("shiplog.permalink.title", title: @entry.display_title, changelog: t("shiplog.changelog.title", default: "Changelog"), default: "%{title} · %{changelog}") %>
+<% shiplog_head_page :permalink, title: @entry.display_title, entry: @entry, url: shiplog_entry_url(@entry), json_ld: shiplog_article_json_ld(@entry) %>
+<%= render layout: "shiplog/page", locals: { name: "permalink" } do %>
+  <%= render "shiplog/page_header", title: t("shiplog.changelog.title", default: "Changelog"), lede: nil %>
+  <article class="<%= shiplog_class(:permalink, @entry.kind) %>">
+    <%= render "shiplog/changelogs/entry_content", entry: @entry, heading: "h2" %>
+  </article>
+  <%= link_to t("shiplog.permalink.back", default: "← Back to the changelog"), changelog_path(anchor: shiplog_month_anchor(@entry.released_on)), class: shiplog_class(:permalink_back) %>
+  <% if @newer || @older %>
+    <nav class="<%= shiplog_class(:permalink_nav) %>" aria-label="<%= t("shiplog.permalink.nav_label", default: "More changelog entries") %>">
+      <% if @newer %>
+        <%= shiplog_entry_link @newer, class: shiplog_class(:permalink_nav_link, :newer), rel: "prev" do %>
+          <%= t("shiplog.permalink.newer", title: @newer.display_title, default: "← Newer: %{title}") %>
+        <% end %>
+      <% end %>
+      <% if @older %>
+        <%= shiplog_entry_link @older, class: shiplog_class(:permalink_nav_link, :older), rel: "next" do %>
+          <%= t("shiplog.permalink.older", title: @older.display_title, default: "Older: %{title} →") %>
+        <% end %>
+      <% end %>
+    </nav>
+  <% end %>
+<% end %>

data/app/views/shiplog/changelog_feeds/show.atom.builder

@@ -0,0 +1,24 @@
+# The latest published features and changes. Entry ids are tag URIs built from the permalink path, so they
+# stay the same when a title changes.
+title = Shiplog.config.product_name.present? ? t("shiplog.feed.title_with_product", product: Shiplog.config.product_name, default: "%{product} changelog") : t("shiplog.changelog.title", default: "Changelog")
+
+atom_feed(language: I18n.locale.to_s, url: shiplog_absolute_url(:changelog_feed), root_url: shiplog_absolute_url(:changelog),
+    id: "tag:#{shiplog_tag_host},2005:#{changelog_path}") do |feed|
+  feed.title(title)
+  feed.author { |author| author.name(Shiplog.config.product_name.presence || "Changelog") } # RFC 4287 4.1.1: the feed or each entry needs one
+  # An entry is updated when its text or the translation shown in this feed changes.
+  updated_at = ->(entry) { [ entry.updated_at, entry.translation&.updated_at ].compact.max }
+  feed.updated(@entries.map(&updated_at).max || Time.current)
+
+  # Under a translated locale, an entry without a current translation is in English (the default locale): say so.
+  english = ->(entry) { Shiplog::Entry.translated_locale?(I18n.locale) && entry.translation.nil? ? { "xml:lang" => I18n.default_locale.to_s } : {} }
+
+  @entries.each do |entry|
+    feed.entry(entry, id: "tag:#{shiplog_tag_host},2005:#{shiplog_entry_path(entry)}", url: shiplog_entry_url(entry),
+        published: entry.released_on.in_time_zone, updated: updated_at.(entry)) do |item|
+      item.title(entry.display_title.to_s, english.(entry))
+      item.category(term: entry.area.slug, label: entry.area.display_name) if entry.area
+      item.content(shiplog_feed_content(entry), { type: "html" }.merge(english.(entry)))
+    end
+  end
+end

data/app/views/shiplog/changelogs/_areas.html.erb

@@ -0,0 +1,8 @@
+<%# locals: (areas:, current: nil, query: nil) %>
+<%# the area filter: an "All" link and one link per area (GET ?area=slug, works without JavaScript); the search query is kept %>
+<nav class="<%= shiplog_class(:areas) %>" aria-label="<%= t("shiplog.changelog.areas.label", default: "Filter by area") %>">
+  <%= link_to t("shiplog.changelog.areas.all", default: "All"), changelog_path(q: query), class: shiplog_class(:area_link, ("current" unless current)), "aria-current": ("page" unless current) %>
+  <% areas.each do |area| %>
+    <%= link_to area.display_name, changelog_path(area: area.slug, q: query), class: shiplog_class(:area_link, ("current" if area == current)), "aria-current": ("page" if area == current) %>
+  <% end %>
+</nav>

data/app/views/shiplog/changelogs/_entry.html.erb

@@ -1,8 +1,5 @@
 <%# locals: (entry:) %>
-<%# one changelog entry: category pill ("New" for features, "Improved" for changes), date, title and body %>
+<%# one changelog entry in the list; the entry itself is the entry_content partial, shared with the permalink page %>
 <li class="<%= token_list(shiplog_class(:entry, entry.kind), (shiplog_class(:entry_feature) if entry.feature?)) %>">
-  <span class="<%= shiplog_class(:entry_category) %>"><%= t("shiplog.categories.#{entry.kind}") %></span>
-  <time class="<%= shiplog_class(:entry_date) %>" datetime="<%= entry.released_on.iso8601 %>"><%= l(entry.released_on, format: t("shiplog.date_format", default: "%-d %B %Y")) %></time>
-  <h3 class="<%= shiplog_class(:entry_title) %>"><%= entry.title %></h3>
-  <div class="<%= shiplog_class(:entry_body) %>"><%= simple_format(h(entry.body)) %></div>
+  <%= render "shiplog/changelogs/entry_content", entry:, heading: "h3", linked: true %>
 </li>

data/app/views/shiplog/changelogs/_entry_content.html.erb

@@ -0,0 +1,10 @@
+<%# locals: (entry:, heading: "h3", linked: false, all_images: !linked) %>
+<%# what an entry shows: category pill ("New" for features, "Improved" for changes), date, title (a permalink link in the list) and body. The area tag (features and changes only) follows the category. The images follow the body: the first one in the list, all of them on the permalink page. %>
+<span class="<%= shiplog_class(:entry_category) %>"><%= t("shiplog.categories.#{entry.kind}", default: (entry.feature? ? "New" : "Improved")) %></span>
+<% if entry.area && Shiplog::Entry::CHANGELOG_KINDS.include?(entry.kind) %>
+  <span class="<%= shiplog_class(:entry_area) %>"><%= entry.area.display_name %></span>
+<% end %>
+<time class="<%= shiplog_class(:entry_date) %>" datetime="<%= entry.released_on.iso8601 %>"><%= l(entry.released_on, format: t("shiplog.date_format", default: "%-d %B %Y")) %></time>
+<%= content_tag heading, (linked && shiplog_entry_path(entry) ? link_to(entry.display_title, shiplog_entry_path(entry)) : entry.display_title), class: shiplog_class(:entry_title) %>
+<div class="<%= shiplog_class(:entry_body) %>"><%= simple_format(h(entry.display_body)) %></div>
+<%= shiplog_entry_images(entry, limit: (all_images ? nil : 1)) %>

data/app/views/shiplog/changelogs/_search.html.erb

@@ -1,8 +1,10 @@
 <%# locals: (query: nil, count: nil) %>
-<%# the changelog search form (GET, works without JavaScript); with a query, also the result summary and a link back to the full changelog %>
+<%# the selected area is read from @area, not a local: a copy of this partial from 0.2.0 declares only query and count %>
+<%# the changelog search form (GET, works without JavaScript); with a query, also the result summary and a link back to the changelog (of the same area, when one is selected) %>
 <% label = t("shiplog.changelog.search.label", default: "Search the changelog") %>
 <form class="<%= shiplog_class(:search) %>" role="search" action="<%= changelog_path %>" method="get">
   <input class="<%= shiplog_class(:search_input) %>" type="search" name="q" value="<%= query %>" aria-label="<%= label %>" placeholder="<%= label %>" maxlength="<%= Shiplog::Entry::SEARCH_MAX_LENGTH %>">
+  <% if @area %><input type="hidden" name="area" value="<%= @area.slug %>"><% end %>
   <button class="<%= shiplog_class(:search_button) %>" type="submit"><%= t("shiplog.changelog.search.submit", default: "Search") %></button>
 </form>
 <% if query %>
@@ -11,6 +13,6 @@
     <% if count.to_i.positive? %>
       <%= t("shiplog.changelog.search.summary", count: count, query: query, default: { one: "%{count} result for “%{query}”", other: "%{count} results for “%{query}”" }) %>
     <% end %>
-    <%= link_to t("shiplog.changelog.search.clear", default: "Clear search"), changelog_path, class: shiplog_class(:search_clear) %>
+    <%= link_to t("shiplog.changelog.search.clear", default: "Clear search"), changelog_path(area: @area&.slug), class: shiplog_class(:search_clear) %>
   </p>
 <% end %>

data/app/views/shiplog/changelogs/show.html.erb

@@ -1,12 +1,15 @@
-<% content_for :title, t("shiplog.changelog.title") %>
+<% changelog_title = t("shiplog.changelog.title", default: "Changelog") %>
+<% list_url = shiplog_absolute_url(:changelog, area: @area&.slug, page: (@page if @page > 1)) %>
+<% content_for :title, changelog_title %>
+<% shiplog_head_page :changelog, title: changelog_title, url: list_url, query: @query, json_ld: shiplog_changelog_json_ld(@months.values.flatten, name: changelog_title, url: list_url) %>
 <%= render layout: "shiplog/page", locals: { name: "changelog" } do %>
-  <%= render "shiplog/page_header", title: t("shiplog.changelog.title"), lede: t("shiplog.changelog.lede") %>
-  <% if @query %>
-    <% content_for :shiplog_robots, "noindex" %>
-  <% end %>
+  <%= render "shiplog/page_header", title: t("shiplog.changelog.title", default: "Changelog"), lede: t("shiplog.changelog.lede", default: "New features and improvements, as they ship.") %>
   <% if Shiplog.config.changelog_search %>
     <%= render "shiplog/changelogs/search", query: @query, count: @result_count %>
   <% end %>
+  <% if @areas.any? %>
+    <%= render "shiplog/changelogs/areas", areas: @areas, current: @area, query: @query %>
+  <% end %>
   <% if @months.empty? && @query %>
     <p class="<%= shiplog_class(:search_empty) %>"><%= t("shiplog.changelog.search.empty", query: @query, default: "No entries match “%{query}”.") %></p>
   <% elsif @months.empty? %>
@@ -19,6 +22,9 @@
     </div>
   <% end %>
   <%= render "shiplog/pagination",
-        newer_path: (changelog_path(page: (@page - 1 if @page > 2), q: @query) if @page > 1),
-        older_path: (changelog_path(page: @page + 1, q: @query) if @older) %>
+        newer_path: (changelog_path(area: @area&.slug, page: (@page - 1 if @page > 2), q: @query) if @page > 1),
+        older_path: (changelog_path(area: @area&.slug, page: @page + 1, q: @query) if @older) %>
+  <p class="<%= shiplog_class(:footnote) %>">
+    <%= link_to t("shiplog.feed.subscribe", default: "Subscribe (Atom)"), changelog_feed_path, class: shiplog_class(:footnote_link, :feed) %>
+  </p>
 <% end %>

data/app/views/shiplog/head/_feed.html.erb

@@ -0,0 +1 @@
+<%= auto_discovery_link_tag(:atom, feed_url, title: feed_title) if feed_url.present? %>

data/app/views/shiplog/head/_meta.html.erb

@@ -0,0 +1,3 @@
+<%= tag.meta(name: "description", content: description) if description.present? %>
+<%= tag.link(rel: "canonical", href: canonical) if canonical.present? %>
+<%= tag.meta(name: "robots", content: robots) if robots.present? %>

data/app/views/shiplog/head/_open_graph.html.erb

@@ -0,0 +1,6 @@
+<% open_graph.each do |property, content| %>
+<%= tag.meta(property:, content:) %>
+<% end %>
+<% twitter.each do |name, content| %>
+<%= tag.meta(name:, content:) %>
+<% end %>

data/app/views/shiplog/head/_structured_data.html.erb

@@ -0,0 +1 @@
+<%= json_ld if json_ld.present? %>

data/app/views/shiplog/roadmaps/_card.html.erb

@@ -6,8 +6,8 @@
   parts = issue.children.size
 %>
 <li class="<%= shiplog_class(:card) %>">
-  <h3 class="<%= shiplog_class(:card_title) %>"><%= entry.title %></h3>
-  <div class="<%= shiplog_class(:card_body) %>"><%= simple_format(h(entry.body)) %></div>
+  <h3 class="<%= shiplog_class(:card_title) %>"><%= entry.display_title %></h3>
+  <div class="<%= shiplog_class(:card_body) %>"><%= simple_format(h(entry.display_body)) %></div>
   <% if tag_label || parts > 1 %>
     <p class="<%= shiplog_class(:card_meta) %>">
       <% if tag_label %><span class="<%= shiplog_class(:card_tag) %>"><%= tag_label %></span><% end %>

data/app/views/shiplog/roadmaps/_column.html.erb

@@ -3,12 +3,12 @@
 <% heading_id = "shiplog-column-#{column.dasherize}" %>
 <section class="<%= shiplog_class(:column, column) %>" aria-labelledby="<%= heading_id %>">
   <header class="<%= shiplog_class(:column_header) %>">
-    <h2 class="<%= shiplog_class(:column_title) %>" id="<%= heading_id %>"><span class="<%= shiplog_class(:column_marker, column) %>" aria-hidden="true"></span><%= t("shiplog.columns.#{column}") %></h2>
+    <h2 class="<%= shiplog_class(:column_title) %>" id="<%= heading_id %>"><span class="<%= shiplog_class(:column_marker, column) %>" aria-hidden="true"></span><%= t("shiplog.columns.#{column}", default: shiplog_column_defaults.fetch(column.to_sym, {})[:title] || column.humanize) %></h2>
     <span class="<%= shiplog_class(:column_count) %>"><%= entries.size %></span>
-    <p class="<%= shiplog_class(:column_description) %>"><%= t("shiplog.columns.#{column}_description") %></p>
+    <p class="<%= shiplog_class(:column_description) %>"><%= t("shiplog.columns.#{column}_description", default: shiplog_column_defaults.fetch(column.to_sym, {})[:description].to_s) %></p>
   </header>
   <% if entries.empty? %>
-    <p class="<%= shiplog_class(:column_empty) %>"><%= t("shiplog.empty") %></p>
+    <p class="<%= shiplog_class(:column_empty) %>"><%= t("shiplog.empty", default: "Nothing here yet") %></p>
   <% else %>
     <ol class="<%= shiplog_class(:cards) %>">
       <%= render partial: "shiplog/roadmaps/card", collection: entries, as: :entry %>

data/app/views/shiplog/roadmaps/_shipped.html.erb

@@ -8,7 +8,7 @@
     <% entries.each do |entry| %>
       <li class="<%= shiplog_class(:shipped_item) %>">
         <time class="<%= shiplog_class(:shipped_date) %>" datetime="<%= entry.released_on.iso8601 %>"><%= l(entry.released_on, format: t("shiplog.roadmap.shipped_date_format", default: "%-d %B")) %></time>
-        <%= link_to entry.title, changelog_path(anchor: "shiplog-month-#{entry.released_on.strftime("%Y-%m")}"), class: shiplog_class(:shipped_link) %>
+        <%= link_to entry.display_title, changelog_path(anchor: "shiplog-month-#{entry.released_on.strftime("%Y-%m")}"), class: shiplog_class(:shipped_link) %>
       </li>
     <% end %>
   </ul>

data/app/views/shiplog/roadmaps/show.html.erb

@@ -1,6 +1,9 @@
-<% content_for :title, t("shiplog.roadmap.title") %>
+<% roadmap_title = t("shiplog.roadmap.title", default: "Roadmap") %>
+<% roadmap_url = shiplog_absolute_url(:roadmap) %>
+<% content_for :title, roadmap_title %>
+<% shiplog_head_page :roadmap, title: roadmap_title, url: roadmap_url, feed: false, json_ld: shiplog_roadmap_json_ld(@columns.values.flatten.map(&:entry), name: roadmap_title, url: roadmap_url) %>
 <%= render layout: "shiplog/page", locals: { name: "roadmap" } do %>
-  <%= render "shiplog/page_header", title: t("shiplog.roadmap.title"), lede: t("shiplog.roadmap.lede") %>
+  <%= render "shiplog/page_header", title: t("shiplog.roadmap.title", default: "Roadmap"), lede: t("shiplog.roadmap.lede", default: "What we're working on and what comes next.") %>
   <div class="<%= shiplog_class(:columns) %>">
     <% @columns.each do |column, items| %>
       <%= render "shiplog/roadmaps/column", column:, entries: items.map(&:entry) %>

data/config/admin_routes.rb

@@ -5,6 +5,22 @@ Shiplog::Admin::Engine.routes.draw do
       resource :approval, only: :create
       resource :discard, only: %i[create destroy]
       resource :rewrite, only: :create
+      # The locale segment is :translation_locale, not :locale: a host's around_action that switches the locale
+      # from params[:locale] must not read it (a configured translation locale may not be an available one).
+      locale = { translation_locale: /[A-Za-z][A-Za-z0-9_-]*/ }
+      patch "translations/:translation_locale", to: "translations#update", as: :translation, constraints: locale
+      post "translations/:translation_locale/retranslation", to: "translations/retranslations#create", as: :translation_retranslation, constraints: locale
+      resources :images, only: %i[create update destroy] do
+        resource :move, only: :create, module: :images
+      end
+    end
+  end
+  resource :area_detection, only: :create, path: "areas/detection"
+  resource :area_translation, only: :create, path: "areas/translation"
+  resources :areas, only: %i[index update destroy] do
+    scope module: :areas do
+      resource :merge, only: :create
+      resource :move, only: :create
     end
   end
   resource :board, only: %i[show update]

data/config/locales/en.yml

@@ -46,12 +46,61 @@ en:
           other: "%{count} results for “%{query}”"
         clear: Clear search
         empty: "No entries match “%{query}”."
+      areas:
+        label: Filter by area
+        all: All
+    permalink:
+      title: "%{title} · %{changelog}"
+      back: "← Back to the changelog"
+      nav_label: More changelog entries
+      newer: "← Newer: %{title}"
+      older: "Older: %{title} →"
+    feed:
+      title_with_product: "%{product} changelog"
+      link_title: Changelog (Atom)
+      subscribe: Subscribe (Atom)
     admin:
       title: Shiplog admin
       nav:
         drafts: Drafts
         board: Roadmap board
         sync: Sync
+        areas: Areas
+      areas:
+        title: Product areas
+        help: The AI groups entries into areas (at most %{max}) while it rewrites them. Visitors can filter the changelog by area once two areas have published entries.
+        detect: Detect areas
+        recheck: Re-check unplaced entries
+        recheck_help: Ask the AI again about entries it left without an area, e.g. after renaming, merging or adding areas.
+        no_rewriter: Detection needs config.rewriter, which is not set.
+        last_detection: "Last detection: %{time}, assigned %{count}"
+        last_error: "Last detection failed (%{time}): %{error}"
+        detection_queued: Detection queued. Refresh in a moment.
+        translate_names: Translate names
+        translate_names_help: Ask the AI for the names that are missing in some language. Names that are already there, including ones you edited, are kept.
+        no_locales: Translating names needs config.locales, which is empty.
+        no_rewriter_translate: Translating names needs config.rewriter, which is not set.
+        translation_queued:
+          one: Translation queued for %{count} area. Refresh in a moment.
+          other: Translation queued for %{count} areas. Refresh in a moment.
+        empty: No areas yet. Detect areas to propose some from your entries.
+        columns:
+          name: Name
+          entries: Entries
+          order: Order
+          merge: Merge into
+        name_label: Name
+        rename: Rename
+        renamed: Area renamed.
+        move_up: Move up
+        move_down: Move down
+        merge: Merge
+        merge_into: Merge into
+        merged: "%{from} merged into %{into}."
+        merge_target: Choose another area to merge into.
+        merge_help: Merging moves the entries to the other area and deletes this one. Deleting an area leaves its entries without one.
+        delete: Delete
+        deleted: Area deleted. Its entries have no area now.
       entries:
         title: Entries
         filters: Filter entries
@@ -73,6 +122,8 @@ en:
         restore: Restore
         save: Save
         regenerate: Regenerate
+        no_area: None
+        area_gone: no longer exists
         regenerate_warning: Regenerating unpublishes this entry until re-approved.
         source_changed: GitHub text changed since this draft
         rewrite_error: Rewrite failed
@@ -80,6 +131,39 @@ en:
         public_text: Public text
         source: GitHub source
         back: Back to drafts
+        images:
+          title: Screenshots
+          help: Shown under the text on the changelog (the first one in the list, all of them on the entry's page). Taken from the GitHub issue or pull request when the draft is written; you can also upload your own.
+          empty: No screenshots yet.
+          alt: Alt text
+          alt_placeholder: Describe the image (defaults to the title)
+          save_alt: Save alt text
+          remove: Remove
+          move_up: Up
+          move_down: Down
+          upload: Upload images
+          upload_label: Images (PNG, JPEG, GIF or WebP, up to 5 MB each)
+          none_selected: Choose at least one image.
+          rejected: "Not added, only PNG, JPEG, GIF and WebP images up to 5 MB and 10,000 pixels a side are accepted: %{names}"
+          added:
+            one: Image added.
+            other: "%{count} images added."
+          alt_saved: Alt text saved.
+          removed: Image removed.
+          moved: Image moved.
+        translations:
+          title: Translations
+          help: "Approving an entry translates it automatically, and the translation is published with the English text. A translation you edit is kept until the English text changes; then it is translated again. A stale or missing translation is not shown: visitors see the English text."
+          not_approved: Translations are written when the entry is approved.
+          missing: Missing
+          stale: Stale
+          current: Up to date
+          edited: Edited by an admin
+          retranslate: Retranslate
+          saved: Translation saved.
+          queued: Translation queued. Refresh in a moment.
+          only_approved: Only approved entries are translated.
+          no_rewriter: Translating needs config.rewriter, which is not set.
         category_options:
           feature: New feature
           change: Improvement
@@ -101,6 +185,7 @@ en:
           body: Text
           released_on: Released on
           category: Category
+          area: Area
           reason: Reason
       board:
         title: Roadmap board