markdowndocs 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 310be55d869a1dbc1399c9964424ce458494aca95a702272cd3529ae9a212f63
-  data.tar.gz: a6f95d22f40b2385b92ab455b467fc271c22ba93449d7b07eafc34beaa5f37a8
+  metadata.gz: a3676879e3360254289b2fb0b936ba79d2f9a0d5fd239f31a2965a1533877009
+  data.tar.gz: b946557e2429279886c3adfc457419e80c295f093ac851f40d92d77ade4729ba
 SHA512:
-  metadata.gz: f01d9eabec60ff72ff96dba5c4b03f270ab8087fe72d70f68ad405c15cb51645d341c10354156951bea744e0167242ecb0a739389cee986688a3eca7fa46dbff
-  data.tar.gz: 67d251f7b2b0266dc6b6d71951f0cf11a4d243639b8f6e248385e165221d0f828a6723a207480165ad8c996577179b9ec4c1bbdcddaf289cebe893d010d3a579
+  metadata.gz: 3e2ebee186f301c5773e1bd0b8bfe611b94951c3b00ace072ffc7685a91ff10f7e616e5c47be032ad9b9ddd103fb1041e4ac1577d63eecc3843667b7fc47d2ad
+  data.tar.gz: 56b9585de9c4a0ee088d6d5618aee160e8deb7ac3cab376245810541fb517206b9d11502e8eb9edb085844c7d7a0d85a46f60609d0773e8cd77e7b913157c691

data/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.3] - 2026-02-20
+
+### Fixed
+
+- Install generator now injects a Tailwind `@source` directive into the host app's CSS so the gem's view templates are scanned for CSS classes. Without this, Tailwind 4 purges the gem's layout classes (grid, sticky sidebar, etc.) and the sidebar renders at the bottom of the page instead of as a column.
+
+## [0.1.2] - 2026-02-20
+
+### Fixed
+
+- `root_path` in host app layouts now resolves to the host app's root (`/`) instead of the engine's root (`/docs/`). The engine defines its own `root` route, so the existing `method_missing` delegation couldn't intercept it. Added explicit `root_path`/`root_url` overrides that delegate to `main_app`.
+
 ## [0.1.1] - 2026-02-20
 
 ### Fixed
@@ -29,5 +41,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - i18n support for all UI strings
 - Install generator (`rails generate markdowndocs:install`)
 
+[0.1.3]: https://github.com/dschmura/markdowndocs/releases/tag/v0.1.3
+[0.1.2]: https://github.com/dschmura/markdowndocs/releases/tag/v0.1.2
 [0.1.1]: https://github.com/dschmura/markdowndocs/releases/tag/v0.1.1
 [0.1.0]: https://github.com/dschmura/markdowndocs/releases/tag/v0.1.0

data/app/controllers/markdowndocs/application_controller.rb

@@ -11,6 +11,18 @@ module Markdowndocs
     # against the engine's catch-all :slug route instead.  This delegation
     # ensures host app route helpers always work correctly in engine views.
     helper do
+      # Explicitly delegate root_path/root_url to the host app.
+      # The engine defines its own root route, so these helpers exist in the
+      # engine scope and method_missing won't intercept them — but they resolve
+      # to /docs/ instead of /. Engine views use markdowndocs.root_path directly.
+      def root_path(*args)
+        main_app.root_path(*args)
+      end
+
+      def root_url(*args)
+        main_app.root_url(*args)
+      end
+
       def method_missing(method, *args, &block)
         if main_app.respond_to?(method)
           main_app.send(method, *args, &block)

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

@@ -20,6 +20,25 @@ module Markdowndocs
         route 'mount Markdowndocs::Engine, at: "/docs"'
       end
 
+      def inject_tailwind_source
+        css_file = find_tailwind_css_file
+        return unless css_file
+
+        gem_views_path = Markdowndocs::Engine.root.join("app", "views")
+        source_line = %(@source "#{gem_views_path}/**/*.erb";)
+
+        if File.read(css_file).include?(source_line)
+          say_status :skip, "Tailwind @source for markdowndocs already present", :yellow
+          return
+        end
+
+        inject_into_file css_file, after: %(@import "tailwindcss";\n) do
+          "\n/* Markdowndocs gem views — required so Tailwind scans the gem's templates */\n#{source_line}\n"
+        end
+
+        say_status :inject, "Tailwind @source for markdowndocs views", :green
+      end
+
       def show_post_install_message
         say ""
         say "Markdowndocs installed successfully!", :green
@@ -29,6 +48,22 @@ module Markdowndocs
         say "  2. Add markdown files to app/docs/"
         say "  3. Visit /docs to see your documentation"
         say ""
+        unless find_tailwind_css_file
+          say "  NOTE: Could not find your Tailwind CSS file.", :yellow
+          say "  Add this line after @import \"tailwindcss\" in your CSS:"
+          say "    @source \"#{Markdowndocs::Engine.root.join("app", "views")}/**/*.erb\";"
+          say ""
+        end
+      end
+
+      private
+
+      def find_tailwind_css_file
+        candidates = [
+          "app/assets/tailwind/application.css",
+          "app/assets/stylesheets/application.tailwind.css"
+        ]
+        candidates.find { |f| File.exist?(Rails.root.join(f)) }&.then { |f| Rails.root.join(f).to_s }
       end
     end
   end

data/lib/markdowndocs/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Markdowndocs
-  VERSION = "0.1.1"
+  VERSION = "0.1.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: markdowndocs
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.3
 platform: ruby
 authors:
 - Dave Chmura