shiplog 0.1.1 → 0.3.0

data/app/views/shiplog/_pagination.html.erb

@@ -1,12 +1,12 @@
 <%# locals: (newer_path: nil, older_path: nil) %>
 <%# previous/next page links; renders nothing when both are nil %>
 <% if newer_path || older_path %>
-  <nav class="<%= shiplog_class(:pagination) %>" aria-label="<%= t("shiplog.changelog.pagination.label") %>">
+  <nav class="<%= shiplog_class(:pagination) %>" aria-label="<%= t("shiplog.changelog.pagination.label", default: "Pagination") %>">
     <% if newer_path %>
-      <%= link_to t("shiplog.changelog.pagination.newer"), newer_path, class: shiplog_class(:pagination_link, :newer), rel: "prev" %>
+      <%= link_to t("shiplog.changelog.pagination.newer", default: "Newer"), newer_path, class: shiplog_class(:pagination_link, :newer), rel: "prev" %>
     <% end %>
     <% if older_path %>
-      <%= link_to t("shiplog.changelog.pagination.older"), older_path, class: shiplog_class(:pagination_link, :older), rel: "next" %>
+      <%= link_to t("shiplog.changelog.pagination.older", default: "Older"), older_path, class: shiplog_class(:pagination_link, :older), rel: "next" %>
     <% end %>
   </nav>
 <% end %>

data/app/views/shiplog/_switcher.html.erb

@@ -0,0 +1,13 @@
+<%# locals: () %>
+<%# Roadmap, Changelog and config.extra_pages; the current page gets aria-current. Needs Shiplog::SwitcherHelper, which the public controllers and a host's `helper Shiplog::SwitcherHelper` provide. %>
+<nav class="<%= shiplog_class(:switcher) %>" aria-label="<%= shiplog_switcher_label %>">
+  <% shiplog_switcher_pages.each do |page| %>
+    <% if page[:path] %>
+      <%= link_to page[:label], page[:path],
+            class: shiplog_class(:switcher_link, ("current" if page[:current])),
+            aria: { current: ("page" if page[:current]) } %>
+    <% else %>
+      <span class="<%= shiplog_class(:switcher_link) %>"><%= page[:label] %></span>
+    <% end %>
+  <% end %>
+</nav>

data/app/views/shiplog/admin/_nav.html.erb

@@ -1,9 +1,10 @@
 <%# locals: (hosted: false) %>
-<%# the Drafts / Roadmap board / Sync links; `hosted` renders the compact variant used inside a host layout %>
+<%# the Drafts / Roadmap board / Areas / Sync links; `hosted` renders the compact variant used inside a host layout %>
 <nav class="shiplog-admin-nav<%= " shiplog-admin-nav--sub" if hosted %>" aria-label="<%= t("shiplog.admin.title") %>">
   <ul class="shiplog-admin-nav__list">
     <li><%= link_to t("shiplog.admin.nav.drafts"), root_path, class: "shiplog-admin-nav__link" %></li>
     <li><%= link_to t("shiplog.admin.nav.board"), board_path, class: "shiplog-admin-nav__link" %></li>
+    <li><%= link_to t("shiplog.admin.nav.areas", default: "Areas"), areas_path, class: "shiplog-admin-nav__link" %></li>
     <li><%= link_to t("shiplog.admin.nav.sync"), sync_path, class: "shiplog-admin-nav__link" %></li>
   </ul>
 </nav>

data/app/views/shiplog/admin/areas/index.html.erb

@@ -0,0 +1,78 @@
+<%= render layout: "shiplog/admin/page" do %>
+  <h1 class="shiplog-admin__title"><%= t("shiplog.admin.areas.title", default: "Product areas") %></h1>
+  <p class="shiplog-admin__muted"><%= t("shiplog.admin.areas.help", max: Shiplog.config.max_areas, default: "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.") %></p>
+
+  <div class="shiplog-admin-actions">
+    <%= form_with url: area_detection_path, class: "shiplog-admin-inline-form" do |form| %>
+      <%= form.button t("shiplog.admin.areas.detect", default: "Detect areas"), type: "submit", class: "shiplog-button shiplog-button--primary" %>
+      <%= form.check_box :recheck, {}, "1", nil %>
+      <%= form.label :recheck, t("shiplog.admin.areas.recheck", default: "Re-check unplaced entries"), title: t("shiplog.admin.areas.recheck_help", default: "Ask the AI again about entries it left without an area, e.g. after renaming, merging or adding areas.") %>
+    <% end %>
+    <% if Shiplog.config.locales.any? %>
+      <%= form_with url: area_translation_path, class: "shiplog-admin-inline-form" do |form| %>
+        <%= form.button t("shiplog.admin.areas.translate_names", default: "Translate names"), type: "submit", class: "shiplog-button", title: t("shiplog.admin.areas.translate_names_help", default: "Ask the AI for the names that are missing in some language. Names that are already there, including ones you edited, are kept.") %>
+      <% end %>
+    <% end %>
+  </div>
+
+  <% if @detection %>
+    <% time = (Time.zone.parse(@detection["at"].to_s) || Time.current).utc.strftime("%Y-%m-%d %H:%M UTC") %>
+    <% if @detection["error"] %>
+      <p class="shiplog-admin__muted shiplog-area-detection shiplog-area-detection--error" role="alert"><%= t("shiplog.admin.areas.last_error", time:, error: @detection["error"], default: "Last detection failed (%{time}): %{error}") %></p>
+    <% else %>
+      <p class="shiplog-admin__muted shiplog-area-detection"><%= t("shiplog.admin.areas.last_detection", time:, count: @detection["assigned"].to_i, default: "Last detection: %{time}, assigned %{count}") %></p>
+    <% end %>
+  <% end %>
+
+  <% if @areas.empty? %>
+    <p class="shiplog-admin__empty"><%= t("shiplog.admin.areas.empty", default: "No areas yet. Detect areas to propose some from your entries.") %></p>
+  <% else %>
+    <table class="shiplog-admin-table">
+      <thead>
+        <tr>
+          <th scope="col"><%= t("shiplog.admin.areas.columns.name", default: "Name") %></th>
+          <th scope="col"><%= t("shiplog.admin.areas.columns.entries", default: "Entries") %></th>
+          <th scope="col"><%= t("shiplog.admin.areas.columns.order", default: "Order") %></th>
+          <th scope="col"><%= t("shiplog.admin.areas.columns.merge", default: "Merge into") %></th>
+          <th scope="col"><%= t("shiplog.admin.entries.columns.actions") %></th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @areas.each_with_index do |area, index| %>
+          <tr class="shiplog-area-row" id="shiplog-area-<%= area.id %>">
+            <td>
+              <%= form_with model: area, url: area_path(area), method: :patch, class: "shiplog-admin-inline-form" do |form| %>
+                <%= form.label :name, t("shiplog.admin.areas.name_label", default: "Name"), class: "shiplog-admin__visually-hidden" %>
+                <%= form.text_field :name, maxlength: Shiplog::Area::NAME_MAX_LENGTH %>
+                <% Shiplog.config.locales.each do |locale| %>
+                  <%= label_tag "area_#{area.id}_name_#{locale}", locale.to_s, class: "shiplog-admin__muted" %>
+                  <%= text_field_tag "area[name_translations][#{locale}]", area.name_translations[locale.to_s], id: "area_#{area.id}_name_#{locale}", lang: locale.to_s, maxlength: Shiplog::Area::NAME_MAX_LENGTH, size: 16, placeholder: area.name %>
+                <% end %>
+                <%= form.submit t("shiplog.admin.areas.rename", default: "Rename"), class: "shiplog-button" %>
+              <% end %>
+              <span class="shiplog-admin__muted"><%= area.slug %></span>
+            </td>
+            <td class="shiplog-area-row__count"><%= @counts.fetch(area.id, 0) %></td>
+            <td class="shiplog-admin-table__actions">
+              <%= button_to t("shiplog.admin.areas.move_up", default: "Move up"), area_move_path(area), params: { direction: "up" }, class: "shiplog-button", disabled: index.zero? %>
+              <%= button_to t("shiplog.admin.areas.move_down", default: "Move down"), area_move_path(area), params: { direction: "down" }, class: "shiplog-button", disabled: index == @areas.size - 1 %>
+            </td>
+            <td>
+              <% if @areas.size > 1 %>
+                <%= form_with url: area_merge_path(area), class: "shiplog-admin-inline-form" do |form| %>
+                  <%= form.label :target_id, t("shiplog.admin.areas.merge_into", default: "Merge into"), class: "shiplog-admin__visually-hidden" %>
+                  <%= form.select :target_id, (@areas - [ area ]).map { |other| [ other.name, other.id ] } %>
+                  <%= form.submit t("shiplog.admin.areas.merge", default: "Merge"), class: "shiplog-button" %>
+                <% end %>
+              <% end %>
+            </td>
+            <td class="shiplog-admin-table__actions">
+              <%= button_to t("shiplog.admin.areas.delete", default: "Delete"), area_path(area), method: :delete, class: "shiplog-button" %>
+            </td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+    <p class="shiplog-admin__muted"><%= t("shiplog.admin.areas.merge_help", default: "Merging moves the entries to the other area and deletes this one. Deleting an area leaves its entries without one.") %></p>
+  <% end %>
+<% end %>

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 %>
@@ -14,6 +17,7 @@
     <%= link_to t("shiplog.admin.entries.edit"), edit_entry_path(entry, inbox_filter_params), class: "shiplog-button" %>
     <% if entry.draft? %>
       <%= button_to t("shiplog.admin.entries.approve"), entry_approval_path(entry, inbox_filter_params), class: "shiplog-button shiplog-button--primary", form: { data: { shiplog_inline: true } } %>
+      <%= button_to t("shiplog.admin.entries.discard"), entry_discard_path(entry, inbox_filter_params), class: "shiplog-button", form: { data: { shiplog_inline: true } } %>
     <% elsif entry.discarded? %>
       <%= button_to t("shiplog.admin.entries.restore"), entry_discard_path(entry, inbox_filter_params), method: :delete, class: "shiplog-button", form: { data: { shiplog_inline: true } } %>
     <% 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,25 @@
+<% content_for :title, t("shiplog.permalink.title", title: @entry.display_title, changelog: t("shiplog.changelog.title", default: "Changelog"), default: "%{title} · %{changelog}") %>
+<% content_for :shiplog_description, shiplog_entry_description(@entry) %>
+<% content_for :shiplog_og, shiplog_og_tags(@entry, url: shiplog_entry_url(@entry)) %>
+<% content_for :shiplog_feed, auto_discovery_link_tag(:atom, shiplog_absolute_url(:changelog_feed), title: t("shiplog.feed.link_title", default: "Changelog (Atom)")) %>
+<%= 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

@@ -0,0 +1,18 @@
+<%# locals: (query: nil, count: nil) %>
+<%# 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 %>
+  <p class="<%= shiplog_class(:search_summary) %>">
+    <%# with no results the page says so below; a "0 results" line would repeat it %>
+    <% 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(area: @area&.slug), class: shiplog_class(:search_clear) %>
+  </p>
+<% end %>

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

@@ -1,7 +1,19 @@
-<% content_for :title, t("shiplog.changelog.title") %>
+<% content_for :title, t("shiplog.changelog.title", default: "Changelog") %>
+<% content_for :shiplog_feed, auto_discovery_link_tag(:atom, shiplog_absolute_url(:changelog_feed), title: t("shiplog.feed.link_title", default: "Changelog (Atom)")) %>
 <%= render layout: "shiplog/page", locals: { name: "changelog" } do %>
-  <%= render "shiplog/page_header", title: t("shiplog.changelog.title"), lede: t("shiplog.changelog.lede") %>
-  <% if @months.empty? %>
+  <%= 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 @query %>
+    <% content_for :shiplog_robots, "noindex" %>
+  <% end %>
+  <% 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? %>
     <%= render "shiplog/empty" %>
   <% else %>
     <div class="<%= shiplog_class(:months) %>">
@@ -11,6 +23,9 @@
     </div>
   <% end %>
   <%= render "shiplog/pagination",
-        newer_path: (changelog_path(page: (@page - 1 if @page > 2)) if @page > 1),
-        older_path: (changelog_path(page: @page + 1) 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/roadmaps/_card.html.erb

@@ -1,6 +1,17 @@
 <%# locals: (entry:) %>
-<%# one roadmap item: its public title and body %>
+<%# one roadmap item: its public title and body, then what places it: the repository's label (config.repository_labels) and how many parts a grouped item has. No label and fewer than two parts renders no meta. Needs Shiplog::RoadmapHelper, which every public controller includes. %>
+<%
+  issue = entry.subject
+  tag_label = shiplog_repository_label(issue.repository)
+  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 %>
+      <% if parts > 1 %><span><%= t("shiplog.roadmap.parts", count: parts, default: { one: "Includes %{count} part", other: "Includes %{count} parts" }) %></span><% end %>
+    </p>
+  <% end %>
 </li>

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

@@ -1,14 +1,14 @@
 <%# locals: (column:, entries:) %>
-<%# one roadmap column (in_progress, coming_soon or later) and its approved entries %>
+<%# one roadmap column (in_progress, coming_soon or later) and its approved entries; the marker and the rule on top carry its status %>
 <% 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 %>"><%= 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

@@ -0,0 +1,15 @@
+<%# locals: (entries:) %>
+<%# "Recently shipped": the latest approved changelog entries, each linking to its month on the changelog %>
+<% heading_id = "shiplog-recently-shipped" %>
+<section class="<%= shiplog_class(:shipped) %>" aria-labelledby="<%= heading_id %>">
+  <h2 class="<%= shiplog_class(:shipped_title) %>" id="<%= heading_id %>"><%= t("shiplog.roadmap.shipped_heading", default: "Recently shipped") %></h2>
+  <%= link_to t("shiplog.roadmap.full_changelog", default: "See the full changelog"), changelog_path, class: shiplog_class(:shipped_link, :all) %>
+  <ul class="<%= shiplog_class(:shipped_list) %>">
+    <% 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.display_title, changelog_path(anchor: "shiplog-month-#{entry.released_on.strftime("%Y-%m")}"), class: shiplog_class(:shipped_link) %>
+      </li>
+    <% end %>
+  </ul>
+</section>

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

@@ -1,9 +1,18 @@
-<% content_for :title, t("shiplog.roadmap.title") %>
+<% content_for :title, t("shiplog.roadmap.title", default: "Roadmap") %>
 <%= 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) %>
     <% end %>
   </div>
+  <%= render "shiplog/roadmaps/shipped", entries: @shipped if @shipped.any? %>
+  <% footnote = t("shiplog.roadmap.footnote", default: "").presence %>
+  <% feedback_path = shiplog_feedback_path %>
+  <% if footnote || feedback_path %>
+    <p class="<%= shiplog_class(:footnote) %>">
+      <%= footnote %>
+      <% if feedback_path %><%= link_to t("shiplog.roadmap.suggest", default: "Suggest a feature"), feedback_path, class: shiplog_class(:footnote_link) %><% end %>
+    </p>
+  <% end %>
 <% end %>

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]