Add link to internal handbook in homepage intro (#640)

* Add link to internal handbook in homepage intro

* Remove duplicate lock

Co-authored-by: Zach Margolis <[email protected]>

---------

Co-authored-by: Zach Margolis <[email protected]>

Gemfile

@@ -2,6 +2,7 @@ source "https://rubygems.org"
 
 ruby '~> 3.2.2'
 
+gem "activemodel", "~> 8.0.0"
 gem "actionpack", "~> 8.0.0"
 gem "activesupport", "~> 8.0.0"
 gem "actionview", "~> 8.0.0"

Gemfile.lock

@@ -17,6 +17,8 @@ GEM
       erubi (~> 1.11)
       rails-dom-testing (~> 2.2)
       rails-html-sanitizer (~> 1.6)
+    activemodel (8.0.0.1)
+      activesupport (= 8.0.0.1)
     activesupport (8.0.0.1)
       base64
       benchmark (>= 0.3)
@@ -176,6 +178,7 @@ PLATFORMS
 DEPENDENCIES
   actionpack (~> 8.0.0)
   actionview (~> 8.0.0)
+  activemodel (~> 8.0.0)
   activesupport (~> 8.0.0)
   html-proofer (~> 4.4.3)
   jekyll (~> 4)

_components/alert_component.html.erb

@@ -0,0 +1,5 @@
+<%= tag.div(**tag_options, class: css_class, role:) do %>
+  <div class="usa-alert__body">
+    <%= content_tag(text_tag, content, class: 'usa-alert__text') %>
+  </div>
+<% end %>

_components/alert_component.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+class AlertComponent < BaseComponent
+  attr_reader :type, :message, :tag_options, :text_tag
+
+  validates_inclusion_of :type, in: [nil, :info, :success, :warning, :error, :emergency]
+
+  def initialize(type: nil, text_tag: 'p', message: nil, **tag_options)
+    @type = type
+    @message = message
+    @tag_options = tag_options
+    @text_tag = text_tag
+  end
+
+  def role
+    if type == :error
+      'alert'
+    else
+      'status'
+    end
+  end
+
+  def css_class
+    ['usa-alert', modifier_css_class, *tag_options[:class]]
+  end
+
+  def modifier_css_class
+    case type
+    when :info
+      'usa-alert--info'
+    when :success
+      'usa-alert--success'
+    when :error
+      'usa-alert--error'
+    when :warning
+      'usa-alert--warning'
+    when :emergency
+      'usa-alert--emergency'
+    end
+  end
+
+  def content
+    @message || super
+  end
+end

_components/base_component.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require 'active_model'
+
+class BaseComponent < ViewComponent::Base
+  include ActiveModel::Model
+
+  def before_render
+    validate!
+  end
+end

_components/breadcrumb_component.rb

@@ -1 +1 @@
-class BreadcrumbComponent < ViewComponent::Base; end
+class BreadcrumbComponent < BaseComponent; end

_plugins/view_component.rb

@@ -29,10 +29,11 @@ def self.application
   end
 end
 
+require './_components/base_component.rb'
 Dir['_components/**/*.rb'].each { |f| require File.join('.', f) }
 
 class ComponentTag < Liquid::Block
-  PARAM_SYNTAX = /(\w+)(?:=(?:"([^"]+?)"|(\S+)))?/.freeze
+  PARAM_SYNTAX = /(\w+)(?:=(?:"([^"]+?)"|(:[a-z_]+)|(\S+)))?/.freeze
 
   def initialize(tag_name, variables, context)
     super
@@ -53,9 +54,11 @@ def initialize(tag_name, variables, context)
   # would be assigned to a string literal, and `current` would be `true`.
   def parse_params(context)
     params = {}
-    @params.scan(PARAM_SYNTAX) do |key, string, variable|
+    @params.scan(PARAM_SYNTAX) do |key, string, symbol, variable|
       if string
         params[key] = string
+      elsif symbol
+        params[key] = symbol[1..].to_sym
       elsif variable
         parts = variable.split('.')
         value = context
@@ -71,7 +74,13 @@ def parse_params(context)
   end
 
   def render(context)
-    content = super.html_safe
+    content = super
+    if !content.include?('<')
+      content = context.registers[:site].
+        find_converter_instance(Jekyll::Converters::Markdown).
+        convert(super).sub(/^<p>(.+)<\/p>$/, '\1')
+    end
+    content = content.html_safe
 
     component_class = "#{@component_name.camelize}Component".constantize
     component = component_class.new(**parse_params(context).symbolize_keys).with_content(content)

index.md

@@ -12,6 +12,10 @@ to [avoid contributing sensitive information][sensitive-information].
 
 [sensitive-information]: {{ site.baseurl }}/articles/contributing.html#sensitive-information
 
+{% component alert type=:info %}
+Internal documentation can be found in our [Internal Login.gov Handbook](https://lg-public.pages.production.gitlab.login.gov/identity-internal-handbook/).
+{% endcomponent %}
+
 ## Categories
 
 <div class="margin-bottom-4"></div>