milestoner 18.4.0 → 18.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f42cba7a4f2b93a05d7fcf25fb973e2a241c8d1813a143baa779c2e1a310f1ed
-  data.tar.gz: 73635a67814d59b11bae524f45cb4878196aba7e302fa595ecedaaf89e350a6a
+  metadata.gz: 013c7206025524458c33b20bceec9005313ae98a1ae4c6f93030548886bf24c2
+  data.tar.gz: 95a22be79d0443573db5b347a1f519c99ea2eab1c0298f8098824a1171e0d104
 SHA512:
-  metadata.gz: 9fcf5478cee6c0a63811cb133d27ae4bc292da15bacdbdb65f2edd29375057f87c23f15f4780ae68539439ed3c5c2011989477ea4c530b32effa5659f46735b1
-  data.tar.gz: a9e17509fa39de1247896518da061daa4586afbff8e905b5934728e5269e448ef973c1ffa1ac1136efd6d01a275912fe872c1fe84876c65c25dbaf7e32fed75a
+  metadata.gz: ef5612eea45a857439702238c5fc40a5ecdc01d024a60815b07d69ba9eea1fe4eced7e88fc4f62574445dd92df4e6916ec3522d062153280c03c7bdee9fcc111
+  data.tar.gz: e6f69f7dea0b85b11af8ee52060692141e27cff663ace8313694ed48745f31671026a9ef5f0afcabc9bdb089e7d5edf5c236b219b28f366a18fc5f0fa1a879d6

data/README.adoc

@@ -3,6 +3,7 @@
 :figure-caption!:
 
 :ascii_doc_link: link:https://asciidoctor.org/docs/what-is-asciidoc[ASCII Doc]
+:ascii_doctor_link: link:https://asciidoctor.org[Asciidoctor]
 :cff_link: link:https://github.com/citation-file-format/ruby-cff[CFF]
 :etcher_link: link:https://alchemists.io/projects/etcher[Etcher]
 :firefox_link: link:https://www.mozilla.org/en-US/firefox[Firefox]
@@ -11,8 +12,8 @@
 :git_commit_anatomy_link: link:https://alchemists.io/articles/git_commit_anatomy[Git Commit Anatomy]
 :git_link: link:https://git-scm.com[Git]
 :git_lint_link: link:https://alchemists.io/projects/git-lint[Git Lint]
-:git_trailers_link: link:https://alchemists.io/articles/git_trailers[Git Trailers]
 :git_notes_link: link:https://alchemists.io/articles/git_notes[Git Notes]
+:git_trailers_link: link:https://alchemists.io/articles/git_trailers[Git Trailers]
 :hanami_link: link:https://hanamirb.org[Hanami]
 :hanami_views_link: link:https://alchemists.io/articles/hanami_views[Hanami Views]
 :hanamismith_link: link:https://alchemists.io/projects/hanamismith[Hanamismith]
@@ -21,12 +22,15 @@
 :markdown_link: link:https://daringfireball.net/projects/markdown[Markdown]
 :marked_link: link:https://marked2app.com[Marked 2]
 :net_news_wire_link: link:https://netnewswire.com[NetNewsWire]
+:redcarpet_link: link:https://github.com/vmg/redcarpet[Redcarpet]
+:rouge_link: link:https://rouge.jneen.net[Rouge]
 :ruby_link: link:https://www.ruby-lang.org[Ruby]
 :rubygems_link: link:https://rubygems.org[RubyGems]
 :rubysmith_link: link:https://alchemists.io/projects/rubysmith[Rubysmith]
 :runcom_link: link:https://alchemists.io/projects/runcom[Runcom]
+:sanitize_link: link:https://github.com/rgrove/sanitize[Sanitize]
 :strict_semantic_versioning_link: link:https://alchemists.io/articles/strict_semantic_versioning[Strict Semantic Versioning]
-:string_formats_link: link:https://ruby-doc.org/3.3.0/format_specifications_rdoc.html[String Formats]
+:string_formats_link: link:https://docs.ruby-lang.org/en/master/format_specifications_rdoc.html[String Formats]
 :syndication_link: link:https://alchemists.io/articles/syndication[Syndication]
 :versionaire_link: link:https://alchemists.io/projects/versionaire[Versionaire]
 :xdg_link: link:https://alchemists.io/projects/xdg[XDG]
@@ -50,7 +54,7 @@ toc::[]
 
 The following are screenshots of using this gem to render release notes for the {lode_link} gem. Even though {lode_link} is used for example purposes, keep in mind that Milestoner can be used for _any project and/or programming language_.
 
-=== ASCII Doc Format
+=== ASCII Doc
 
 image:https://alchemists.io/images/projects/milestoner/screenshots/build-ascii_doc-collapsed.png[Release Notes,width=1149,height=830,role=focal_point]
 
@@ -59,7 +63,7 @@ image:https://alchemists.io/images/projects/milestoner/screenshots/build-ascii_d
 * *Command*: `milestoner build --format ascii_doc`
 * *Renderer*: {ascii_doc_link}
 
-=== Feed Format
+=== Feed
 
 image:https://alchemists.io/images/projects/milestoner/screenshots/build-feed-collapsed.png[Release Notes,width=1109,height=1143,role=focal_point]
 
@@ -75,14 +79,14 @@ image:https://alchemists.io/images/projects/milestoner/screenshots/build-markdow
 * *Command*: `milestoner build --format markdown`
 * *Renderer*: {marked_link}
 
-=== Stream Format
+=== Stream
 
 image:https://alchemists.io/images/projects/milestoner/screenshots/build-stream.png[Release Notes,width=586,height=341,role=focal_point]
 
 * *Command*: `milestoner build --format stream`
 * *Renderer*: {iterm_link}
 
-=== Web Format
+=== Web
 
 image:https://alchemists.io/images/projects/milestoner/screenshots/build-web-collapsed.png[Release Notes,width=1195,height=878,role=focal_point]
 
@@ -112,7 +116,7 @@ image:https://alchemists.io/images/projects/milestoner/screenshots/build-web-exp
 ** Stream (console)
 ** link:https://html.spec.whatwg.org/multipage[Web]
 * Supports {git_notes_link}.
-* Supports customization via your personal {xdg_link} and {hanami_views_link} configuration.
+* Supports customization via your personal {xdg_link}, {runcom_link}, and/or {hanami_views_link} configuration.
 
 == Requirements
 
@@ -297,34 +301,38 @@ User information should be sourced from whatever service you use for managing yo
 [source,bash]
 ----
 milestoner cache --list
-# 🟢 Listing users...
-# 🟢 No users found.
+# 🟢 [milestoner] Listing users...
+# 🟢 [milestoner] No users found.
 
 milestoner cache --create "111,jsmith,Jane Smith"
-# 🟢 Created: "Jane Smith"
+# 🟢 [milestoner] Created: "Jane Smith"
 
 milestoner cache --create "222,jdoe,John Doe"
-# 🟢 Created: "John Doe"
+# 🟢 [milestoner] Created: "John Doe"
 
 milestoner cache --create "333,jgrey,Jill Grey"
-# 🟢 Created: "Jill Grey"
+# 🟢 [milestoner] Created: "Jill Grey"
 
 milestoner cache --list
-# 🟢 Listing users...
-# 111, jsmith, Jane Smith
-# 222, jdoe, John Doe
-# 333, jgrey, Jill Grey
+# 🟢 [milestoner] Listing users...
+# External ID, Handle, Name
+# -------------------------
+# "111", "jsmith", "Jane Smith"
+# "222", "jdoe", "John Doe"
+# "333", "jgrey", "Jill Grey"
 
 milestoner cache --delete "Jill Grey"
-🟢 Deleted: "Jill Grey".
+# 🟢 [milestoner] Deleted: "Jill Grey".
 
 milestoner cache --list
-# 🟢 Listing users...
-# 111, jsmith, Jane Smith
-# 222, jdoe, John Doe
+# 🟢 [milestoner] Listing users...
+# External ID, Handle, Name
+# -------------------------
+# "111", "jsmith", "Jane Smith"
+# "222", "jdoe", "John Doe"
 
 milestoner cache --info
-# 🟢 Path: /Users/demo/.cache/milestoner/database.store.
+# 🟢 [milestoner] Path: /Users/bkuhlmann/.cache/milestoner/database.store.
 ----
 
 💡 Use `+https://api.github.com/users/<handle>+` to acquire the external ID for any GitHub user.
@@ -333,7 +341,7 @@ Once team member information is stored in your cache, you'll be able to build re
 
 If you don't use the cache, your release notes use a question mark (?) and _unknown_ for team members as highlighted below:
 
-image:https://alchemists.io/images/projects/milestoner/screenshots/no_cache.png[Usage,width=851,height=571,role=focal_point]
+image:https://alchemists.io/images/projects/milestoner/screenshots/no_cache.png[Usage,width=916,height=397,role=focal_point]
 
 === Build
 
@@ -344,8 +352,9 @@ The build command allows you to quickly build release notes to check the current
 [source,bash]
 ----
 milestoner build --format web
-# 🟢 Building milestone...
-# 🟢 Milestone built: /Users/bkuhlmann/Engineering/OSS/milestoner/tmp/milestone
+# 🟢 [milestoner] Building Milestoner (web)...
+# 🟢 [milestoner] Built: /Users/bkuhlmann/Engineering/OSS/milestoner/tmp/milestones/page.css.
+# 🟢 [milestoner] Built: /Users/bkuhlmann/Engineering/OSS/milestoner/tmp/milestones/index.html.
 ----
 
 The above command is so useful that I use the following `msw` (i.e. Milestoner Web) Bash alias to build current release notes or release notes for several tags:
@@ -357,22 +366,113 @@ The above command is so useful that I use the following `msw` (i.e. Milestoner W
 # Parameters: $1 (optional): Maximum tags to build. Default: 1.
 msw() {
   local max=${1:-1}
+  local root="tmp/milestones"
+  local path="$root/index.html"
 
   rm -rf tmp/milestones
 
   if [[ "$max" == 1 ]]; then
-    milestoner build --max "$max" --format web && open "tmp/milestones/index.html"
+    milestoner build --max "$max" --format web
+
+    if [[ -f "$path" ]]; then
+      open "$path"
+    fi
   else
     milestoner build --max "$max" --stylesheet "../page" --format web
-    ruby -run -e httpd "tmp/milestones" --port 3030 &
-    open "http://localhost:3030"
-    fg
+
+    if [[ -d "$root" ]]; then
+      ruby -run -e httpd "tmp/milestones" --port 3030 &
+      open "http://localhost:3030"
+      fg
+    fi
   fi
 }
 ----
 
 Check out the help documentation (i.e. `milestoner build --help`) for addition usage that explains what command line options you can use to overwrite the current configuration.
 
+==== Commits
+
+By default, all {git_link} commit messages support {ascii_doc_link} syntax but you can use {markdown_link} if customized.
+
+{ascii_doc_link} is rendered using the {ascii_doctor_link} gem while {markdown_link} is rendered using the {redcarpet_link} gem. Regardless of what renderer you choose, each supports syntax highlighting via the {rouge_link} gem. This also means you can customize the {rouge_style} stylesheet as documented in the xref:_templates[Templates] section below.
+
+Here's a couple examples of commit messages using {ascii_doc_link} and {markdown_link} syntax:
+
+*ASCII Doc*
+
+image:https://alchemists.io/images/projects/milestoner/screenshots/syntax-ascii_doc.png[ASCII Doc,width=950,height=763,role=focal_point]
+
+*Markdown*
+
+image:https://alchemists.io/images/projects/milestoner/screenshots/syntax-markdown.png[Markdown,width=933,height=921,role=focal_point]
+
+💡 To see an example of what this renders to HTML as, see the xref:_formats[Formats] section below.
+
+==== Sanitization
+
+Sanitization of commit messages is handled by the {sanitize_link} gem. This means you can only use a limited set of HTML elements (this includes {ascii_doc_link} and {markdown_link} rendering). Here's what's allowed:
+
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/b[b]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/em[em]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/i[i]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/strong[strong]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/u[u]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a[a]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/abbr[abbr]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/blockquote[blockquote]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/br[br]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/cite[cite]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/code[code]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/dd[dd]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/dfn[dfn]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/dl[dl]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/dt[dt]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/kbd[kbd]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/li[li]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/mark[mark]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/ol[ol]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/p[p]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/pre[pre]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/q[q]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/s[s]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/samp[samp]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/small[small]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/strike[strike]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/sub[sub]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/sup[sup]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/time[time]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/ul[ul]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/var[var]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/audio[audio]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/details[details]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/img[img]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/source[source]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/span[span]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/summary[summary]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Element/video[video]
+
+The following global attributes are allowed for all elements:
+
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/id[id]
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/class[class]
+
+The following attributes are limited to only a few elements like `a`, `abbr`, and `dfn` for the most part.
+
+* link:https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/title[title]
+
+Other attributes are allowed as well but are specific to each element. Ultimately, if you don't see an attribute being rendered then it's because it's not allowed.
+
+==== Trailers
+
+Multiple {git_trailers_link} for your commits are supported which are detailed in the linked article. At a minimum, the `Milestone` trailer is highly recommended since this is how Milestoner handles xref:_automatic_versioning[Automatic Versioning] for you.
+
+One of the more powerful features of using {git_trailers_link} in your commit messages is they give you the ability to fully resolve what is defined in your default global xref:_customization[configuration]. Here's a more detailed breakdown:
+
+* *Format* (optional): Use `ascii_doc` or `markdown` for the value to control what syntax used to render your commit message. The default is `ascii_doc` but if your configuration uses a different default you can override that per commit message if desired.
+* *Issue* (optional): When supplied, Milestoner will automatically associate your commit with the corresponding issue ID you provide as a value. This works in conjunction with your xref:_customization[configuration].
+* *Milestone* (optional): This is detailed in the xref:_automatic_versioning[Automatic Versioning] section below.
+
 ==== Automatic Versioning
 
 As mentioned earlier, the calculation of version information happens automatically based on your last {git_link} tag and any {git_link} commit trailer metadata used. If none of this information is present, then the default version of `0.0.0` is used instead. All of this information is available to you via the following command:
@@ -494,23 +594,27 @@ Of all build formats supported, the web format is the most powerful and feature
 
 *With Basic Git Commit*
 
-image:https://alchemists.io/images/projects/milestoner/screenshots/web_format-overview.png[Overview,width=1119,height=910,role=focal_point]
+image:https://alchemists.io/images/projects/milestoner/screenshots/web_format-overview.png[Overview,width=1119,height=902,role=focal_point]
 
 *With Collaborators and Signers*
 
-image:https://alchemists.io/images/projects/milestoner/screenshots/web_format-collaborators_and_signers.png[Collaborators and Signers,width=1118,height=1003,role=focal_point]
+image:https://alchemists.io/images/projects/milestoner/screenshots/web_format-collaborators_and_signers.png[Collaborators and Signers,width=903,height=903,role=focal_point]
 
 *With Invalid Tag*
 
-image:https://alchemists.io/images/projects/milestoner/screenshots/web_format-tag_invalid.png[Invalid Tag,width=1119,height=910,role=focal_point]
+image:https://alchemists.io/images/projects/milestoner/screenshots/web_format-tag_invalid.png[Invalid Tag,width=881,height=403,role=focal_point]
 
 *With Valid Tag*
 
-image:https://alchemists.io/images/projects/milestoner/screenshots/web_format-tag_valid.png[Valid Tag,width=1119,height=910,role=focal_point]
+image:https://alchemists.io/images/projects/milestoner/screenshots/web_format-tag_valid.png[Valid Tag,width=688,height=771,role=focal_point]
 
 *With Notes*
 
-image:https://alchemists.io/images/projects/milestoner/screenshots/web_format-notes.png[Notes,width=1119,height=910,role=focal_point]
+image:https://alchemists.io/images/projects/milestoner/screenshots/web_format-notes.png[Notes,width=903,height=757,role=focal_point]
+
+*With ASCII Doc/Markdown*
+
+image:https://alchemists.io/images/projects/milestoner/screenshots/web_format-asdcii_doc[ASCII Doc,width=908,height=1938,role=focal_point]
 
 💡 See {git_notes_link} to learn more.
 

data/lib/milestoner/builders/feed.rb

@@ -8,7 +8,6 @@ module Milestoner
     # Builds syndicated feed output.
     class Feed
       include Milestoner::Import[:settings, :logger]
-      include Dry::Monads[:result]
 
       using Refinements::Pathname
 

data/lib/milestoner/builders/web.rb

@@ -17,9 +17,6 @@ module Milestoner
       end
 
       def call
-        settings.build_root.make_path
-        copy_stylesheet
-
         tagger.call
               .fmap { |tags| build tags }
               .alt_map { |message| failure message }
@@ -30,10 +27,14 @@ module Milestoner
       attr_reader :tagger, :view
 
       def build tags
+        make_root
+        copy_stylesheet
         tags.each { |tag| write tag }
         settings.build_root
       end
 
+      def make_root = settings.build_root.make_path
+
       def copy_stylesheet
         return unless settings.build_stylesheet
 

data/lib/milestoner/cli/actions/cache/create.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require "core"
 require "sod"
 
 module Milestoner
@@ -17,17 +18,22 @@ module Milestoner
           on %w[-c --create], argument: "external_id,handle,name"
 
           def call values
-            process(values).bind { |user| log_info "Created: #{user.name.inspect}" }
+            case values.split ","
+              in String => external_id, String => handle, String => name
+                client.write(:users) { upsert({external_id:, handle:, name:}) }
+                      .bind { |user| log_info "Created: #{user.name.inspect}" }
+              in String, String then log_error "Name must be supplied."
+              in [String] then log_error "Handle and Name must be supplied."
+              in Core::EMPTY_ARRAY then log_error "No values given."
+              else log_error "Too many values given."
+            end
           end
 
           private
 
-          def process values
-            external_id, handle, name = values.split ","
-            client.write(:users) { upsert({external_id:, handle:, name:}) }
-          end
-
           def log_info(message) = logger.info { message }
+
+          def log_error(message) = logger.error { message }
         end
       end
     end

data/lib/milestoner/cli/actions/cache/list.rb

@@ -24,7 +24,15 @@ module Milestoner
           def print users
             return logger.info { "No users found." } if users.empty?
 
-            users.each { |user| io.puts user.to_h.values.join ", " }
+            header
+            users.each { |user| io.puts user.to_h.values.map(&:inspect).join ", " }
+          end
+
+          def header
+            header = "External ID, Handle, Name"
+
+            io.puts header
+            io.puts "-" * header.size
           end
         end
       end

data/lib/milestoner/commits/tagger.rb

@@ -24,15 +24,17 @@ module Milestoner
       end
 
       def call
-        git.tags("--sort=taggerdate")
-           .fmap { |tags| tail tags.last(settings.build_max).map(&:version) }
-           .fmap { |references| slice(references).reverse }
+        collect.fmap { |tags| tail tags.last(settings.build_max).map(&:version) }
+               .fmap { |references| slice(references).reverse }
+               .bind { |tags| tags.empty? ? Failure("No tags or commits.") : Success(tags) }
       end
 
       private
 
       attr_reader :enricher, :model
 
+      def collect = git.tagged? ? git.tags("--sort=taggerdate") : placeholder_with_commits
+
       def tail references
         references.append "HEAD" if settings.build_tail == "head"
         references
@@ -68,6 +70,21 @@ module Milestoner
         ]
       end
 
+      def placeholder_with_commits = enricher.call.fmap { |commits| placeholder_for commits }
+
+      def placeholder_for commits
+        return commits if commits.empty?
+
+        [
+          model[
+            author: commits.last.author,
+            commits:,
+            committed_at: Time.now,
+            version: settings.project_version
+          ]
+        ]
+      end
+
       def author tag
         author_enricher.call tag.with(author_name: tag.author_name || settings.project_author)
       end

data/lib/milestoner/renderers/asciidoc.rb

@@ -6,15 +6,24 @@ module Milestoner
   module Renderers
     # Renders ASCII Doc as HTML.
     class Asciidoc
-      def initialize client: Asciidoctor
+      SETTINGS = {
+        safe: :safe,
+        attributes: {
+          "source-highlighter" => "rouge",
+          "rouge-linenums-mode" => "inline"
+        }
+      }.freeze
+
+      def initialize settings: SETTINGS, client: Asciidoctor
+        @settings = settings
         @client = client
       end
 
-      def call(content) = client.convert content
+      def call(content) = client.convert content, settings
 
       private
 
-      attr_reader :client
+      attr_reader :settings, :client
     end
   end
 end

data/lib/milestoner/renderers/markdown.rb

@@ -1,12 +1,25 @@
 # frozen_string_literal: true
 
 require "redcarpet"
+require "rouge"
+require "rouge/plugins/redcarpet"
 
 module Milestoner
   module Renderers
     # Renders Markdown as HTML.
     class Markdown
-      def initialize client: Redcarpet::Markdown.new(Redcarpet::Render::HTML.new)
+      CLIENT = Redcarpet::Markdown.new Class.new(Redcarpet::Render::HTML)
+                                            .include(Rouge::Plugins::Redcarpet)
+                                            .set_temporary_name("redcarpet_html_rouge")
+                                            .new,
+                                       disable_indented_code_blocks: true,
+                                       fenced_code_blocks: true,
+                                       footnotes: true,
+                                       highlight: true,
+                                       superscript: true,
+                                       tables: true
+
+      def initialize client: CLIENT
         @client = client
       end
 

data/lib/milestoner/sanitizer.rb

@@ -19,13 +19,22 @@ module Milestoner
 
     attr_reader :defaults, :client
 
-    def configuration
-      client::Config.merge defaults,
-                           elements: defaults[:elements].including("img", "video"),
-                           attributes: defaults[:attributes].merge(
-                             "img" => %w[alt class height id loading src width],
-                             "video" => %w[class controls height id poster src width]
-                           )
+    def configuration = client::Config.merge(defaults, elements:, attributes:)
+
+    def elements
+      defaults[:elements].including "audio", "details", "img", "source", "span", "summary", "video"
+    end
+
+    def attributes
+      defaults[:attributes].merge(
+        all: %w[class id],
+        "a" => %w[href title],
+        "audio" => %w[autoplay controls controlslist crossorigin loop muted preload src],
+        "details" => %w[name open],
+        "img" => %w[alt height loading src width],
+        "source" => %w[type src srcset sizes media height width],
+        "video" => %w[controls height poster src width]
+      )
     end
   end
 end

data/lib/milestoner/syndication/builder.rb

@@ -21,7 +21,7 @@ module Milestoner
       end
 
       def call tags
-        return Failure "No content." if tags.empty?
+        return Failure "No tags or commits." if tags.empty?
 
         Success build_feed(tags).to_s
       rescue NoMethodError, RSS::Error => error

data/lib/milestoner/templates/public/page.css.erb

@@ -2,6 +2,308 @@
   --font-family: Verdana;
 }
 
+/* Rouge (https://rouge.jneen.net) */
+.rouge.highlight {
+  --color-berry: hsl(240, 18%, 40%);
+  --color-blue: hsl(223, 100%, 74%);
+  --color-cold: hsl(189, 100%, 93%);
+  --color-dark: hsl(191, 12%, 27%);
+  --color-eclipse: hsl(0, 3%, 21%);
+  --color-enoki: hsl(60, 30%, 95%);
+  --color-goblin: hsl(84, 82%, 49%);
+  --color-green: hsl(140, 67%, 66%);
+  --color-grey: hsl(0, 0%, 65%);
+  --color-ice: hsl(184, 74%, 83%);
+  --color-ink: hsl(210, 4%, 11%);
+  --color-khaki: hsl(35, 26%, 75%);
+  --color-lime: hsl(82, 100%, 58%);
+  --color-purple: hsl(259, 60%, 79.4%);
+  --color-red: hsl(0, 100%, 73%);
+  --color-sea: hsl(190, 100%, 60%);
+  --color-sky: hsl(203, 93%, 74%);
+  --color-teal: hsl(189, 23%, 53%);
+  --color-white: hsl(0, 0%, 100%);
+  --color-yellow: hsl(49, 100%, 59%);
+
+  table {
+    td {
+      padding: 5px;
+    }
+
+    pre {
+      margin: 0;
+    }
+  }
+
+  .c, .ch, .cd, .cpf {
+    color: var(--color-grey);
+    font-style: italic;
+  }
+
+  .cm {
+    color: var(--color-berry);
+    font-style: italic;
+  }
+
+  .c1 {
+    color: var(--color-grey);
+    font-style: italic;
+  }
+
+  .cp {
+    color: var(--color-teal);
+    font-weight: bold;
+  }
+
+  .cs {
+    color: var(--color-dark);
+    font-weight: bold;
+    font-style: italic;
+  }
+
+  .err {
+    color: var(--color-enoki);
+    background-color: var(--color-eclipse);
+  }
+
+  .gi {
+    color: var(--color-lime);
+  }
+
+  .gd {
+    color: var(--color-blue);
+  }
+
+  .ge {
+    color: var(--color-ink);
+    font-style: italic;
+  }
+
+  .gr {
+    color: var(--color-blue);
+  }
+
+  .gt {
+    color: var(--color-blue);
+  }
+
+  .gh {
+    color: var(--color-eclipse);
+  }
+
+  .go {
+    color: var(--color-eclipse);
+  }
+
+  .gp {
+    color: var(--color-sea);
+  }
+
+  .gs {
+    font-weight: bold;
+  }
+
+  .gu {
+    color: var(--color-dark);
+  }
+
+  .k, .kv {
+    color: var(--color-sky);
+    font-weight: bold;
+  }
+
+  .kc {
+    color: var(--color-sea);
+    font-weight: bold;
+  }
+
+  .kd {
+    color: var(--color-sea);
+    font-weight: bold;
+  }
+
+  .kp {
+    color: var(--color-ice);
+    font-weight: bold;
+  }
+
+  .kr {
+    color: var(--color-sea);
+    font-weight: bold;
+  }
+
+  .kt {
+    color: var(--color-sea);
+    font-weight: bold;
+  }
+
+  .kn {
+    color: var(--color-blue);
+    font-weight: bold;
+  }
+
+  .ow {
+    color: var(--color-blue);
+    font-weight: bold;
+  }
+
+  .o {
+    color: var(--color-blue);
+    font-weight: bold;
+  }
+
+  .mf {
+    color: var(--color-ice);
+  }
+
+  .mh {
+    color: var(--color-purple);
+  }
+
+  .il {
+    color: var(--color-purple);
+  }
+
+  .mi {
+    color: var(--color-ice);
+  }
+
+  .mo {
+    color: var(--color-purple);
+  }
+
+  .m, .mb, .mx {
+    color: var(--color-purple);
+  }
+
+  .se {
+    color: var(--color-purple);
+  }
+
+  .sb {
+    color: var(--color-khaki);
+  }
+
+  .sc {
+    color: var(--color-khaki);
+  }
+
+  .sd {
+    color: var(--color-khaki);
+  }
+
+  .s2 {
+    color: var(--color-khaki);
+  }
+
+  .sh {
+    color: var(--color-khaki);
+  }
+
+  .si {
+    color: var(--color-purple);
+  }
+
+  .sx {
+    color: var(--color-green);
+  }
+
+  .sr {
+    color: var(--color-ice);
+  }
+
+  .s1 {
+    color: var(--color-khaki);
+  }
+
+  .ss {
+    color: var(--color-green);
+  }
+
+  .s, .sa, .dl {
+    color: var(--color-khaki);
+  }
+
+  .n {
+    color: var(--color-white);
+  }
+
+  .na {
+    color: var(--color-lime);
+  }
+
+  .nc {
+    color: var(--color-lime);
+    font-weight: bold;
+  }
+
+  .nd {
+    color: var(--color-lime);
+    font-weight: bold;
+  }
+
+  .ne {
+    color: var(--color-lime);
+    font-weight: bold;
+  }
+
+  .nf, .fm {
+    color: var(--color-goblin);
+    font-weight: bold;
+  }
+
+  .no {
+    color: var(--color-sea);
+  }
+
+  .bp {
+    color: var(--color-enoki);
+  }
+
+  .nb {
+    color: var(--color-cold);
+  }
+
+  .ni {
+    color: var(--color-enoki);
+  }
+
+  .nn {
+    color: var(--color-lime);
+  }
+
+  .vc {
+    color: var(--color-red);
+  }
+
+  .vg {
+    color: var(--color-enoki);
+  }
+
+  .vi {
+    color: var(--color-yellow);
+  }
+
+  .nv, .vm {
+    color: var(--color-enoki);
+  }
+
+  .w {
+    color: var(--color-enoki);
+  }
+
+  .nl {
+    color: var(--color-enoki);
+    font-weight: bold;
+  }
+
+  .nt {
+    color: var(--color-cold);
+  }
+
+  color: var(--color-enoki);
+}
+
 .milestone {
   --border-width: 0.15rem;
   --color-black: hsl(0, 0%, 0%);
@@ -15,10 +317,12 @@
   --color-ice: hsl(216, 100%, 98%);
   --color-major: hsl(7, 79%, 32%);
   --color-minor: hsl(221, 79%, 32%);
+  --color-night: hsl(216, 9%, 21%);
   --color-orange: hsl(24.8, 100%, 50.2%);
   --color-patch: hsl(156, 79%, 32%);
   --color-powder: hsl(0, 0%, 98%);
   --color-red: hsl(0, 84.1%, 44.5%);
+  --color-silver: hsl(224, 33%, 94%);
   --color-slate: hsl(211, 23%, 41%);
   --color-smoke: hsl(229, 31%, 93%);
   --color-white: hsl(0, 0%, 100%);
@@ -29,6 +333,62 @@
   font-family: var(--font-family);
   margin: 0 12vw;
 
+  blockquote {
+    background-color: var(--color-silver);
+    border-left: 0.5rem solid var(--color-slate);
+    border-radius: 0.5rem;
+    padding: 0.5rem 1rem;
+
+    p {
+      margin: 0;
+      quotes: "\201C""\201D";
+
+      &::before, &::after {
+        font-family: cursive;
+        font-size: 1.5rem;
+      }
+
+      &::before {
+        content: open-quote;
+        padding-right: 0.3rem;
+      }
+
+      &::after {
+        content: close-quote;
+        padding-left: 0.1rem;
+      }
+    }
+  }
+
+  :not(pre) > code {
+    background-color: var(--color-night);
+    border-radius: 0.3rem;
+    color: var(--color-white);
+    font-size: 0.95rem;
+    padding: 0.1rem 0.3rem;
+  }
+
+  pre:not([class^=language]) {
+    background-color: var(--color-night);
+    color: var(--color-ghost);
+    line-height: 1.5rem;
+    padding: 0.5rem 1rem;
+    font-size: 0.9rem;
+    white-space: pre-wrap;
+  }
+
+  pre {
+    border-radius: 0.5rem;
+    font-weight: 400;
+    padding: 0.5rem;
+  }
+
+  img, video {
+    max-width: 100%;
+    height: auto;
+    object-fit: cover;
+  }
+
   .normal {
     border-bottom-color: var(--color-ghost);
     border-color: transparent;
@@ -46,6 +406,7 @@
 
   .avatar {
     border-radius: 50%;
+    height: fit-content;
   }
 
   .pill {
@@ -138,8 +499,9 @@
   }
 
   .overview {
-    display: flex;
     align-items: center;
+    display: flex;
+    flex-wrap: wrap;
     justify-content: space-between;
     margin-bottom: 0.5rem;
   }

data/milestoner.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "milestoner"
-  spec.version = "18.4.0"
+  spec.version = "18.5.0"
   spec.authors = ["Brooke Kuhlmann"]
   spec.email = ["brooke@alchemists.io"]
   spec.homepage = "https://alchemists.io/projects/milestoner"
@@ -37,6 +37,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency "lode", "~> 1.8"
   spec.add_dependency "redcarpet", "~> 3.6"
   spec.add_dependency "refinements", "~> 12.8"
+  spec.add_dependency "rouge", "~> 4.3"
   spec.add_dependency "rss", "~> 0.3"
   spec.add_dependency "runcom", "~> 11.5"
   spec.add_dependency "sanitize", "~> 6.1"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: milestoner
 version: !ruby/object:Gem::Version
-  version: 18.4.0
+  version: 18.5.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -35,7 +35,7 @@ cert_chain:
   3n5C8/6Zh9DYTkpcwPSuIfAga6wf4nXc9m6JAw8AuMLaiWN/r/2s4zJsUHYERJEu
   gZGm4JqtuSg8pYjPeIJxS960owq+SfuC+jxqmRA54BisFCv/0VOJi7tiJVY=
   -----END CERTIFICATE-----
-date: 2024-09-07 00:00:00.000000000 Z
+date: 2024-09-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: asciidoctor
@@ -233,6 +233,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '12.8'
+- !ruby/object:Gem::Dependency
+  name: rouge
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.3'
 - !ruby/object:Gem::Dependency
   name: rss
   requirement: !ruby/object:Gem::Requirement