wiki multilang support

apps/api/app/controllers/api/rss_controller.rb

@@ -5,23 +5,26 @@ class Api::RssController < ApiController
   end
 
   api :GET, "/api/rss/blog", "Blog RSS feed"
+  param :lang, String, required: false, desc: "Feed language (en, hu). Unknown values fall back to en"
   returns code: 200, desc: "RSS XML feed of blog posts"
   def blog
-    xml = Rss::BlogFeed.new.xml
+    xml = Rss::BlogFeed.new(lang: params[:lang]).xml
     render xml: xml, content_type: "application/rss+xml"
   end
 
   api :GET, "/api/rss/releases", "Software releases RSS feed"
+  param :lang, String, required: false, desc: "Feed language (en, hu). Unknown values fall back to en"
   returns code: 200, desc: "RSS XML feed of software releases"
   def releases
-    xml = Rss::ReleasesFeed.new.xml
+    xml = Rss::ReleasesFeed.new(lang: params[:lang]).xml
     render xml: xml, content_type: "application/rss+xml"
   end
 
   api :GET, "/api/rss/howtos", "HowTos RSS feed"
+  param :lang, String, required: false, desc: "Feed language (en, hu). Unknown values fall back to en"
   returns code: 200, desc: "RSS XML feed of tech howtos"
   def howtos
-    xml = Rss::HowtosFeed.new.xml
+    xml = Rss::HowtosFeed.new(lang: params[:lang]).xml
     render xml: xml, content_type: "application/rss+xml"
   end
 end

apps/api/app/controllers/api/wiki_controller.rb

@@ -7,8 +7,10 @@ class Api::WikiController < ApiController
   param :tag, String, required: false, desc: "Filter by tag (blog, howto, engine)"
   param :limit, :number, required: false, desc: "Limit number of results"
   param :body, String, required: false, desc: "Include body content (1 = yes)"
+  param :lang, String, required: false, desc: "Content language (en, hu). Unknown values fall back to en"
   returns code: 200, desc: "Wiki pages response" do
     property :tag, String, desc: "Applied tag filter"
+    property :lang, String, desc: "Requested content language"
     property :count, Integer, desc: "Number of pages returned"
     property :pages, Array, desc: "Array of wiki pages" do
       property :id, String, desc: "Page ID"
@@ -17,7 +19,7 @@ class Api::WikiController < ApiController
       property :description, String, desc: "Short description"
       property :createdAt, String, desc: "Created date (ISO 8601)"
       property :updatedAt, String, desc: "Updated date (ISO 8601)"
-      property :locale, String, desc: "Locale code"
+      property :locale, String, desc: "Language the page body is actually written in (differs from lang when the page has no translation)"
       property :route, String, desc: "URL slug"
       property :tags, Array, of: String, desc: "Tags"
       property :repo, String, desc: "Git repository URL (from page metadata, engines)"
@@ -31,7 +33,8 @@ class Api::WikiController < ApiController
     render json: Wiki::Pages.new.fetch(
       tag:   params[:tag],
       limit: params[:limit],
-      body:  params[:body]
+      body:  params[:body],
+      lang:  params[:lang]
     )
   end
 end

apps/api/app/services/rss/blog_feed.rb

@@ -2,12 +2,12 @@ module Rss
   class BlogFeed < Feed
     private
 
-    def title = "Teletype Games Blog"
+    def title = translate("rss.blog.title")
     def link = "#{site_url}/blog"
-    def description = "Latest blog posts from Teletype Games"
+    def description = translate("rss.blog.description")
 
     def items
-      Wiki::Pages.new.all(tag: "blog", limit: 30).map do |page|
+      Wiki::Pages.new.all(tag: "blog", limit: 30, lang: lang).map do |page|
         {
           title:        page["title"],
           link:         "#{site_url}/blog/#{page['route']}",

apps/api/app/services/rss/feed.rb

@@ -2,12 +2,16 @@ require "rss"
 
 module Rss
   class Feed
+    def initialize(lang: nil)
+      @lang = Locales.resolve(lang)
+    end
+
     def xml
       RSS::Maker.make("2.0") do |maker|
         maker.channel.title       = title
         maker.channel.link        = link
         maker.channel.description = description
-        maker.channel.language    = "hu"
+        maker.channel.language    = lang
 
         items.each do |item|
           maker.items.new_item do |rss_item|
@@ -22,9 +26,13 @@ module Rss
 
     private
 
+    attr_reader :lang
+
     def site_url = Rails.configuration.x.site_url
 
-    def wiki_url = Rails.configuration.x.wiki_url
+    def wiki_url = "#{Rails.configuration.x.wiki_url}#{Wiki::Pages.path_prefix(lang)}"
+
+    def translate(key, **options) = I18n.t(key, locale: lang, **options)
 
     def parse_time(value)
       Time.parse(value.to_s)

apps/api/app/services/rss/howtos_feed.rb

@@ -2,12 +2,12 @@ module Rss
   class HowtosFeed < Feed
     private
 
-    def title = "Teletype Games HowTos"
+    def title = translate("rss.howtos.title")
     def link = "#{site_url}/howtos"
-    def description = "Latest tech howtos from Teletype Games"
+    def description = translate("rss.howtos.description")
 
     def items
-      Wiki::Pages.new.all(tag: "howto", limit: 30).map do |page|
+      Wiki::Pages.new.all(tag: "howto", limit: 30, lang: lang).map do |page|
         {
           title:        page["title"],
           link:         "#{wiki_url}/#{page['path']}",

apps/api/app/services/rss/releases_feed.rb

@@ -2,9 +2,9 @@ module Rss
   class ReleasesFeed < Feed
     private
 
-    def title = "Teletype Games Releases"
+    def title = translate("rss.releases.title")
     def link = "#{site_url}/catalog"
-    def description = "Latest game releases from Teletype Games"
+    def description = translate("rss.releases.description")
 
     def items
       WarpEngine::Release.includes(:software).order(created_at: :desc).limit(50).filter_map do |release|
@@ -14,7 +14,7 @@ module Rss
         {
           title:        "#{software.title} v#{release.version}",
           link:         "#{site_url}/catalog/#{software.name}",
-          description:  "#{software.title} #{release.version} released – #{software.desc}",
+          description:  translate("rss.releases.item_description", title: software.title, version: release.version, desc: software.desc),
           published_at: release.created_at.to_time
         }
       end

apps/api/app/services/wiki/pages.rb

@@ -3,12 +3,18 @@ require "json"
 
 module Wiki
   class Pages
-    def fetch(tag:, limit: nil, body: nil)
+    def self.path_prefix(language)
+      language == Locales::DEFAULT ? "" : "/#{language}"
+    end
+
+    def fetch(tag:, limit: nil, body: nil, lang: nil)
+      language = Locales.resolve(lang)
+
       query = { tag: tag }
       query[:limit] = limit if limit.present?
       query[:body]  = body  if body.present?
 
-      uri = URI.parse("#{Rails.configuration.x.wiki_url}/custom/pages.json")
+      uri = URI.parse("#{Rails.configuration.x.wiki_url}#{self.class.path_prefix(language)}/custom/pages.json")
       uri.query = URI.encode_www_form(query)
 
       response = Net::HTTP.start(
@@ -17,21 +23,21 @@ module Wiki
         open_timeout: 5, read_timeout: 10
       ) { |http| http.get(uri.request_uri) }
 
-      return empty(tag, "grav responded #{response.code}") unless response.is_a?(Net::HTTPSuccess)
+      return empty(tag, language, "grav responded #{response.code}") unless response.is_a?(Net::HTTPSuccess)
 
       JSON.parse(response.body)
     rescue StandardError => e
-      empty(tag, e.message)
+      empty(tag, language, e.message)
     end
 
-    def all(tag:, limit: nil)
-      fetch(tag: tag, limit: limit).fetch("pages", [])
+    def all(tag:, limit: nil, lang: nil)
+      fetch(tag: tag, limit: limit, lang: lang).fetch("pages", [])
     end
 
     private
 
-    def empty(tag, error)
-      { "tag" => tag, "count" => 0, "pages" => [], "error" => error }
+    def empty(tag, language, error)
+      { "tag" => tag, "lang" => language, "count" => 0, "pages" => [], "error" => error }
     end
   end
 end