shiplog 0.2.0 → 0.3.0

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,16 @@
-<% 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") %>
+  <%= 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? %>
@@ -19,6 +23,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/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,6 @@
-<% 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) %>

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

data/config/locales/es.yml

@@ -0,0 +1,223 @@
+# Textos de Shiplog en español. Los hosts pueden sobrescribir cualquier clave en sus propios archivos de idioma.
+es:
+  activerecord:
+    attributes:
+      shiplog/entry:
+        changelog_kind: Categoría
+  # Los nombres de los meses que usa el formato de fecha de Shiplog (rails-i18n los trae también; son los mismos).
+  date:
+    month_names: [~, enero, febrero, marzo, abril, mayo, junio, julio, agosto, septiembre, octubre, noviembre, diciembre]
+  shiplog:
+    columns:
+      in_progress: En desarrollo
+      coming_soon: Próximamente
+      later: Más adelante
+      in_progress_description: Lo que estamos construyendo ahora
+      coming_soon_description: Lo siguiente en la lista
+      later_description: En nuestro radar
+    categories:
+      feature: Nuevo
+      change: Mejorado
+    empty: Todavía no hay nada
+    date_format: "%-d de %B de %Y"
+    roadmap:
+      title: Hoja de ruta
+      lede: En qué estamos trabajando y qué viene después.
+      parts:
+        one: Incluye %{count} parte
+        other: Incluye %{count} partes
+      shipped_heading: Lanzado recientemente
+      shipped_date_format: "%-d de %B"
+      full_changelog: Ver el registro de cambios completo
+      footnote: ""
+      suggest: Sugerir una función
+    switcher:
+      label: Actualizaciones del producto
+      roadmap: Hoja de ruta
+      changelog: Registro de cambios
+    changelog:
+      title: Registro de cambios
+      lede: Nuevas funciones y mejoras, a medida que se lanzan.
+      pagination:
+        label: Paginación
+        older: Anteriores
+        newer: Más recientes
+      search:
+        label: Buscar en el registro de cambios
+        submit: Buscar
+        summary:
+          one: "%{count} resultado para “%{query}”"
+          other: "%{count} resultados para “%{query}”"
+        clear: Borrar búsqueda
+        empty: "Ninguna entrada coincide con “%{query}”."
+      areas:
+        label: Filtrar por área
+        all: Todas
+    permalink:
+      title: "%{title} · %{changelog}"
+      back: "← Volver al registro de cambios"
+      nav_label: Más cambios
+      newer: "← Más reciente: %{title}"
+      older: "Anterior: %{title} →"
+    feed:
+      title_with_product: "Registro de cambios de %{product}"
+      link_title: Registro de cambios (Atom)
+      subscribe: Suscribirse (Atom)
+    admin:
+      title: Administración de Shiplog
+      nav:
+        drafts: Borradores
+        board: Tablero de la hoja de ruta
+        sync: Sincronización
+        areas: Áreas
+      areas:
+        title: Áreas del producto
+        help: La IA agrupa las entradas en áreas (como máximo %{max}) mientras las reescribe. Los visitantes pueden filtrar el registro de cambios por área cuando hay dos áreas con entradas publicadas.
+        detect: Detectar áreas
+        recheck: Revisar de nuevo las entradas sin área
+        recheck_help: Vuelve a preguntar a la IA por las entradas que dejó sin área, por ejemplo después de renombrar, fusionar o añadir áreas.
+        no_rewriter: La detección necesita config.rewriter, que no está configurado.
+        last_detection: "Última detección: %{time}, %{count} asignadas"
+        last_error: "La última detección falló (%{time}): %{error}"
+        detection_queued: Detección en cola. Actualiza en un momento.
+        translate_names: Traducir nombres
+        translate_names_help: Pide a la IA los nombres que faltan en algún idioma. Los nombres que ya existen, incluidos los que editaste, se conservan.
+        no_locales: Traducir los nombres necesita config.locales, que está vacío.
+        no_rewriter_translate: Traducir los nombres necesita config.rewriter, que no está configurado.
+        translation_queued:
+          one: Traducción en cola para %{count} área. Actualiza en un momento.
+          other: Traducción en cola para %{count} áreas. Actualiza en un momento.
+        empty: Todavía no hay áreas. Detecta áreas para que se propongan a partir de tus entradas.
+        columns:
+          name: Nombre
+          entries: Entradas
+          order: Orden
+          merge: Fusionar con
+        name_label: Nombre
+        rename: Renombrar
+        renamed: Área renombrada.
+        move_up: Subir
+        move_down: Bajar
+        merge: Fusionar
+        merge_into: Fusionar con
+        merged: "%{from} se fusionó con %{into}."
+        merge_target: Elige otra área con la que fusionar.
+        merge_help: Al fusionar, las entradas pasan a la otra área y esta se elimina. Si eliminas un área, sus entradas se quedan sin área.
+        delete: Eliminar
+        deleted: Área eliminada. Sus entradas ya no tienen área.
+      entries:
+        title: Entradas
+        filters: Filtrar entradas
+        all_kinds: Todos los tipos
+        empty: Ninguna entrada coincide.
+        pagination: Paginación
+        older: Anteriores
+        newer: Más recientes
+        saved: Entrada guardada.
+        approved: Entrada aprobada.
+        discarded: Entrada descartada.
+        restored: Entrada devuelta a borrador.
+        invalid_transition: Esa acción no está disponible para esta entrada en su estado actual.
+        rewrite_queued: Reescritura en cola. Actualiza en un momento.
+        edit: Editar
+        edit_title: "Editar %{kind}"
+        approve: Aprobar
+        discard: Descartar
+        restore: Restaurar
+        save: Guardar
+        regenerate: Regenerar
+        no_area: Ninguna
+        area_gone: ya no existe
+        regenerate_warning: Al regenerar, esta entrada deja de estar publicada hasta que se apruebe de nuevo.
+        source_changed: El texto de GitHub cambió desde este borrador
+        rewrite_error: Falló la reescritura
+        not_rewritten: Todavía sin reescribir
+        public_text: Texto público
+        source: Origen en GitHub
+        back: Volver a los borradores
+        images:
+          title: Capturas de pantalla
+          help: Se muestran bajo el texto en el registro de cambios (la primera en la lista, todas en la página de la entrada). Se toman de la incidencia o del pull request de GitHub al escribir el borrador; también puedes subir las tuyas.
+          empty: Todavía no hay capturas.
+          alt: Texto alternativo
+          alt_placeholder: Describe la imagen (por defecto, el título)
+          save_alt: Guardar texto alternativo
+          remove: Quitar
+          move_up: Subir
+          move_down: Bajar
+          upload: Subir imágenes
+          upload_label: Imágenes (PNG, JPEG, GIF o WebP, hasta 5 MB cada una)
+          none_selected: Elige al menos una imagen.
+          rejected: "No se añadieron; solo se aceptan imágenes PNG, JPEG, GIF y WebP de hasta 5 MB y 10.000 píxeles por lado: %{names}"
+          added:
+            one: Imagen añadida.
+            other: "%{count} imágenes añadidas."
+          alt_saved: Texto alternativo guardado.
+          removed: Imagen quitada.
+          moved: Imagen movida.
+        translations:
+          title: Traducciones
+          help: "Al aprobar una entrada, esta se traduce automáticamente, y la traducción se publica junto con el texto en inglés. Una traducción que edites se conserva hasta que cambie el texto en inglés; entonces se vuelve a traducir. Una traducción desactualizada o ausente no se muestra: los visitantes ven el texto en inglés."
+          not_approved: Las traducciones se escriben cuando se aprueba la entrada.
+          missing: Falta
+          stale: Desactualizada
+          current: Al día
+          edited: Editada por un administrador
+          retranslate: Traducir de nuevo
+          saved: Traducción guardada.
+          queued: Traducción en cola. Actualiza en un momento.
+          only_approved: Solo se traducen las entradas aprobadas.
+          no_rewriter: Para traducir hace falta config.rewriter, que no está configurado.
+        category_options:
+          feature: Nueva función
+          change: Mejora
+        statuses:
+          draft: Borradores
+          approved: Aprobadas
+          discarded: Descartadas
+        kinds:
+          roadmap: Hoja de ruta
+          feature: Función
+          change: Cambio
+        columns:
+          entry: Entrada
+          kind: Tipo
+          source: Origen
+          actions: Acciones
+        fields:
+          title: Título
+          body: Texto
+          released_on: Fecha de lanzamiento
+          category: Categoría
+          area: Área
+          reason: Motivo
+      board:
+        title: Tablero de la hoja de ruta
+        help: Arrastra las tarjetas entre columnas para fijarlas y ordenarlas. Sin JavaScript, usa el botón Mover de cada tarjeta.
+        updated: Tablero actualizado.
+        not_approved: Sin aprobar
+        pinned: Fijada
+        move_to: Mover a
+        move: Mover
+        unpin: Quitar de fijadas
+      sync:
+        title: Estado de la sincronización
+        queued: Sincronización en cola.
+        webhook_secret_missing: El secreto del webhook no está configurado, así que se rechazan los webhooks de GitHub.
+        github_token_missing: El token de GitHub no está configurado, así que no se puede sincronizar.
+        sync_now: Sincronizar ahora
+        sync_and_scan: Sincronizar y buscar cambios
+        repositories: Repositorios
+        no_repositories: No hay repositorios configurados.
+        repository: Repositorio
+        synced_at: Última sincronización
+        changes_scanned_at: Cambios revisados
+        last_error: Último error
+        never: Nunca
+        deliveries: Últimas entregas de webhook
+        no_deliveries: Todavía no hay entregas.
+        event: Evento
+        action: Acción
+        received_at: Recibida
+        processed_at: Procesada
+        error: Error

data/config/routes.rb

@@ -1,5 +1,10 @@
 Shiplog::Engine.routes.draw do
   get Shiplog.config.roadmap_path, to: "roadmaps#show", as: :roadmap
+  # The feed and the permalinks come before the plain changelog route, whose optional (.:format) would
+  # otherwise take /changelog.atom. A slug has no dot, and the permalink takes no format.
+  get "#{Shiplog.config.changelog_path}.atom", to: "changelog_feeds#show", as: :changelog_feed, defaults: { format: "atom" }
+  get "#{Shiplog.config.changelog_path}/:slug", to: "changelog_entries#show", as: :changelog_entry,
+    format: false, constraints: { slug: /[a-z0-9-]+/ }
   get Shiplog.config.changelog_path, to: "changelogs#show", as: :changelog
   post "shiplog/github/webhook", to: "webhooks#create", as: :github_webhook
   get "shiplog/assets/:version/:name", to: "frontends#show", as: :frontend, constraints: { version: /[^\/]+/, name: /[a-z_]+\.(css|js)/ }

data/db/migrate/20261027000002_shiplog_0_3_0.rb

@@ -0,0 +1,105 @@
+# Everything 0.3.0 adds to the schema, one section per feature. Additive and reversible.
+class Shiplog030 < ActiveRecord::Migration[8.1]
+  # A migration must not depend on model code that changes later: this is a bare table-backed class.
+  class MigrationEntry < ActiveRecord::Base
+    self.table_name = "shiplog_entries"
+    self.inheritance_column = nil
+  end
+
+  SLUG_MAX_LENGTH = 80
+
+  def change
+    # --- Entry permalinks (/changelog/:slug) ---
+    # Set when an entry is first approved, never changed afterwards, so links never break. Nil for roadmap
+    # entries and drafts. Entries approved before 0.3.0 get theirs here (oldest first, so the oldest keeps the
+    # plain slug on duplicate titles): the public pages never write, so nothing else fills them in.
+    add_column :shiplog_entries, :slug, :string
+    add_index :shiplog_entries, :slug, unique: true, where: "slug IS NOT NULL"
+    reversible do |direction|
+      direction.up do
+        MigrationEntry.reset_column_information
+        backfill_slugs
+      end
+    end
+
+    # --- "What's new" unseen count ---
+    # `Shiplog.unseen_count` counts approved feature and change entries with `approved_at > since`:
+    # an equality column first, then the range column.
+    add_index :shiplog_entries, [ :status, :approved_at ]
+
+    # --- Product areas (detected by AI) ---
+    # `entries.area_id` is nullable; deleting an area nullifies it (merging moves the entries first).
+    # `area_set_by_admin` marks an area chosen by hand, which detection never overwrites.
+    create_table :shiplog_areas do |t|
+      t.string :name, null: false
+      t.string :slug, null: false
+      t.integer :position, null: false, default: 0
+      # The name in each of config.locales, keyed by locale string ({ "es" => "Listas de embalaje" }); empty
+      # until translated. Slugs stay English, so ?area= URLs are shared across locales.
+      t.jsonb :name_translations, null: false, default: {}
+      t.timestamps
+    end
+    add_index :shiplog_areas, :slug, unique: true
+    add_reference :shiplog_entries, :area, null: true, index: true, foreign_key: { to_table: :shiplog_areas, on_delete: :nullify }
+    add_column :shiplog_entries, :area_set_by_admin, :boolean, null: false, default: false
+    # When detection last asked the AI about the entry (placed or not): unplaced entries are not asked again
+    # until an admin asks for a re-check.
+    add_column :shiplog_entries, :area_detected_at, :datetime
+    # A small key-value store for state that belongs to no record, e.g. the result of the last area detection
+    # (shown on the admin's Areas page).
+    create_table :shiplog_settings do |t|
+      t.string :key, null: false
+      t.jsonb :value, null: false, default: {}
+      t.timestamps
+    end
+    add_index :shiplog_settings, :key, unique: true
+
+    # --- Screenshots (needs Active Storage in the host; the columns are harmless without it) ---
+    # `image_order` is the ordered list of the entry's image blob ids, `image_alts` the alt text per blob id
+    # ({ "12" => "The dark theme" }); a missing alt text falls back to the entry's title.
+    add_column :shiplog_entries, :image_order, :jsonb, null: false, default: []
+    add_column :shiplog_entries, :image_alts, :jsonb, null: false, default: {}
+
+    # --- Translations of entries (config.locales) ---
+    # One row per entry and locale, published with the English text (no second approval). `source_digest` is the
+    # digest of the English title and body it was made from: a row whose digest differs from the entry's current
+    # text is stale and never shown. `edited_by_admin` keeps an admin's edit until the English text changes.
+    create_table :shiplog_entry_translations do |t|
+      t.references :entry, null: false, index: false, foreign_key: { to_table: :shiplog_entries, on_delete: :cascade }
+      t.string :locale, null: false
+      t.string :title, null: false
+      t.text :body, null: false, default: ""
+      t.string :source_digest, null: false
+      t.boolean :edited_by_admin, null: false, default: false
+      t.timestamps
+    end
+    add_index :shiplog_entry_translations, [ :entry_id, :locale ], unique: true
+  end
+
+  # Gives every approved feature and change with a release date, and no slug, one: the title as [a-z0-9-] only
+  # (cut at 80 characters), made unique with -2, -3, ...; entry-<id> when nothing is left. The same rules as
+  # Shiplog::Entry#generate_slug at the time of 0.3.0.
+  def backfill_slugs
+    taken = MigrationEntry.where.not(slug: nil).pluck(:slug).to_set
+    MigrationEntry.where(status: "approved", kind: %w[feature change], slug: nil).where.not(released_on: nil)
+      .order(:released_on, :approved_at, :id).to_a.each do |entry|
+      slug = slug_for(entry, taken)
+      taken << slug
+      MigrationEntry.where(id: entry.id, slug: nil).update_all(slug:)
+    end
+  end
+
+  private
+
+  def slug_for(entry, taken)
+    base = entry.title.to_s.parameterize.tr("_", "-").squeeze("-").first(SLUG_MAX_LENGTH).gsub(/\A-+|-+\z/, "").presence || "entry-#{entry.id}"
+    candidate = base
+    suffix = 2
+    while taken.include?(candidate)
+      tail = "-#{suffix}"
+      candidate = "#{base.first(SLUG_MAX_LENGTH - tail.length).delete_suffix("-")}#{tail}"
+      suffix += 1
+    end
+    candidate
+  end
+end

data/lib/generators/shiplog/install/install_generator.rb

@@ -59,7 +59,16 @@ module Shiplog
         search_button: "rounded-md bg-indigo-600 px-3 py-1.5 text-sm font-medium text-white hover:bg-indigo-500",
         search_summary: "mb-4 text-sm text-gray-500 dark:text-gray-400",
         search_clear: "ml-2 font-medium text-indigo-600 hover:underline dark:text-indigo-400",
-        search_empty: "text-gray-500 dark:text-gray-400"
+        search_empty: "text-gray-500 dark:text-gray-400",
+        permalink: "mx-auto max-w-2xl rounded-lg border border-gray-200 bg-white p-6 dark:border-gray-800 dark:bg-gray-900",
+        permalink_back: "mt-6 inline-block text-sm font-medium text-indigo-600 hover:underline dark:text-indigo-400",
+        permalink_nav: "mt-8 flex flex-wrap justify-between gap-4 border-t border-gray-200 pt-4 dark:border-gray-800",
+        permalink_nav_link: "text-sm font-medium text-indigo-600 hover:underline dark:text-indigo-400",
+        areas: "my-4 flex flex-wrap gap-2",
+        area_link: "rounded-full border border-gray-300 px-3 py-0.5 text-sm hover:border-indigo-500 dark:border-gray-700 [&.shiplog-areas__link--current]:border-indigo-600 [&.shiplog-areas__link--current]:bg-indigo-600 [&.shiplog-areas__link--current]:text-white",
+        entry_area: "text-xs font-semibold uppercase tracking-wide text-gray-500 dark:text-gray-400",
+        entry_images: "mt-3 grid w-full gap-3",
+        entry_image: "h-auto max-w-full rounded-lg border border-gray-200 dark:border-gray-800"
       }.freeze
 
       def copy_initializer