RubyGems - mint - Versions diffs - 0.8.1 → 0.10.0 - Mend

mint 0.8.1 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (83) hide show

checksums.yaml +4 -4
data/Gemfile +1 -26
data/README.md +117 -37
data/bin/mint +2 -81
data/config/templates/base/navigation.css +136 -0
data/config/templates/base/print.css +152 -0
data/config/templates/{reset.css → base/reset.css} +1 -1
data/config/templates/base/style.css +117 -137
data/config/templates/base/utilities.css +136 -0
data/config/templates/base/variables.css +124 -0
data/config/templates/basic/style.css +151 -0
data/config/templates/default/layout.erb +33 -3
data/config/templates/default/style.css +95 -164
data/config/templates/magazine/style.css +383 -0
data/config/templates/nord/style.css +105 -220
data/config/templates/nord-dark/style.css +82 -263
data/lib/mint/commandline/parse.rb +144 -0
data/lib/mint/commandline/publish.rb +46 -0
data/lib/mint/commandline/run.rb +30 -0
data/lib/mint/config.rb +162 -0
data/lib/mint/{css.rb → css_dsl.rb} +9 -9
data/lib/mint/css_parser.rb +45 -25
data/lib/mint/document.rb +250 -365
data/lib/mint/document_tree.rb +163 -0
data/lib/mint/exceptions.rb +2 -3
data/lib/mint/helpers.rb +23 -180
data/lib/mint/layout.rb +26 -9
data/lib/mint/renderers/css_renderer.rb +32 -0
data/lib/mint/renderers/erb_renderer.rb +11 -0
data/lib/mint/renderers/markdown_renderer.rb +45 -0
data/lib/mint/style.rb +21 -31
data/lib/mint/template.rb +30 -0
data/lib/mint/version.rb +1 -1
data/lib/mint/workspace.rb +171 -0
data/lib/mint.rb +44 -12
data/man/mint.1 +85 -44
data/spec/cli/README.md +2 -2
data/spec/cli/argument_parsing_spec.rb +89 -147
data/spec/cli/bin_integration_spec.rb +23 -243
data/spec/cli/full_workflow_integration_spec.rb +99 -442
data/spec/cli/original_style_integration_spec.rb +58 -0
data/spec/cli/publish_workflow_spec.rb +72 -70
data/spec/commandline_path_integration_spec.rb +230 -0
data/spec/config_file_integration_spec.rb +362 -0
data/spec/{css_spec.rb → css_dsl_spec.rb} +7 -3
data/spec/css_parser_spec.rb +59 -1
data/spec/document_spec.rb +37 -242
data/spec/flattened_path_spec.rb +150 -0
data/spec/layout_spec.rb +42 -3
data/spec/mint_spec.rb +22 -217
data/spec/path_handling_spec.rb +237 -0
data/spec/run_cli_tests.rb +1 -1
data/spec/spec_helper.rb +3 -10
data/spec/style_spec.rb +31 -56
data/spec/support/cli_helpers.rb +7 -10
data/spec/support/matchers.rb +1 -1
data/spec/template_spec.rb +31 -0
data/spec/workspace_spec.rb +177 -0
metadata +75 -89
data/bin/mint-epub +0 -20
data/config/templates/garden/layout.erb +0 -38
data/config/templates/garden/style.css +0 -303
data/config/templates/nord/layout.erb +0 -11
data/config/templates/nord-dark/layout.erb +0 -11
data/config/templates/zen/layout.erb +0 -11
data/config/templates/zen/style.css +0 -114
data/lib/mint/command_line.rb +0 -360
data/lib/mint/css_template.rb +0 -37
data/lib/mint/markdown_template.rb +0 -47
data/lib/mint/mint.rb +0 -313
data/lib/mint/plugin.rb +0 -136
data/lib/mint/plugins/epub.rb +0 -293
data/lib/mint/resource.rb +0 -101
data/plugins/templates/epub/layouts/container.haml +0 -5
data/plugins/templates/epub/layouts/content.haml +0 -35
data/plugins/templates/epub/layouts/layout.haml +0 -6
data/plugins/templates/epub/layouts/title.haml +0 -11
data/plugins/templates/epub/layouts/toc.haml +0 -26
data/spec/cli/configuration_management_spec.rb +0 -363
data/spec/cli/template_management_spec.rb +0 -300
data/spec/helpers_spec.rb +0 -249
data/spec/plugin_spec.rb +0 -449
data/spec/resource_spec.rb +0 -135

data/spec/cli/publish_workflow_spec.rb CHANGED Viewed

@@ -1,7 +1,7 @@
 require "spec_helper"
 RSpec.describe "CLI Publishing Workflow" do
-  describe "Mint::CommandLine.publish!" do
+  describe "Mint::Commandline.publish!" do
     context "in isolated environment" do
       around(:each) do |example|
         in_temp_dir do |dir|
@@ -14,10 +14,10 @@ RSpec.describe "CLI Publishing Workflow" do
       describe "basic publishing" do
         it "publishes a single markdown file" do
-          markdown_file = create_markdown_file("test.md", "# Hello World\n\nThis is a test.")
+          markdown_path = create_markdown_path("test.md", "# Hello World\n\nThis is a test.")
           expect {
-            Mint::CommandLine.publish!([markdown_file], {})
+            Mint::Commandline.publish!([Pathname.new(markdown_path)], config: Mint::Config.defaults)
           }.not_to raise_error
           verify_file_content("test.html") do |content|
@@ -27,11 +27,11 @@ RSpec.describe "CLI Publishing Workflow" do
         end
         it "publishes multiple markdown files" do
-          file1 = create_markdown_file("doc1.md", "# Document 1")
-          file2 = create_markdown_file("doc2.md", "# Document 2")
+          file1 = create_markdown_path("doc1.md", "# Document 1")
+          file2 = create_markdown_path("doc2.md", "# Document 2")
           expect {
-            Mint::CommandLine.publish!([file1, file2], {})
+            Mint::Commandline.publish!([Pathname.new(file1), Pathname.new(file2)], config: Mint::Config.defaults)
           }.not_to raise_error
           verify_file_content("doc1.html") do |content|
@@ -44,9 +44,9 @@ RSpec.describe "CLI Publishing Workflow" do
         end
         it "uses default template when none specified" do
-          markdown_file = create_markdown_file("test.md", "# Test")
+          markdown_path = create_markdown_path("test.md", "# Test")
-          Mint::CommandLine.publish!([markdown_file], {})
+          Mint::Commandline.publish!([Pathname.new(markdown_path)], config: Mint::Config.defaults)
           verify_file_content("test.html") do |content|
             expect(content).to include("<!DOCTYPE html>")
@@ -58,10 +58,10 @@ RSpec.describe "CLI Publishing Workflow" do
       describe "with custom options" do
         it "publishes with custom destination" do
-          markdown_file = create_markdown_file("test.md", "# Test")
+          markdown_path = create_markdown_path("test.md", "# Test")
           FileUtils.mkdir_p("output")
-          Mint::CommandLine.publish!([markdown_file], { destination: "output" })
+          Mint::Commandline.publish!([Pathname.new(markdown_path)], config: Mint::Config.with_defaults(destination_directory: Pathname.new("output")))
           expect(File.exist?("output/test.html")).to be true
           expect(File.exist?("test.html")).to be false
@@ -71,11 +71,11 @@ RSpec.describe "CLI Publishing Workflow" do
           # Create a subdirectory structure
           FileUtils.mkdir_p("docs")
           Dir.chdir("docs") do
-            create_markdown_file("readme.md", "# Documentation")
+            create_markdown_path("readme.md", "# Documentation")
           end
           # Publish from parent directory with current directory as root
-          Mint::CommandLine.publish!(["docs/readme.md"], { root: Dir.getwd })
+          Mint::Commandline.publish!([Pathname.new("docs/readme.md")], config: Mint::Config.with_defaults(working_directory: Pathname.getwd, preserve_structure: true))
           expect(File.exist?("docs/readme.html")).to be true
         end
@@ -85,9 +85,9 @@ RSpec.describe "CLI Publishing Workflow" do
           File.write(".mint/templates/custom/layout.erb",
             "<html><body class='custom'><%= content %></body></html>")
-          markdown_file = create_markdown_file("test.md", "# Test")
+          markdown_path = create_markdown_path("test.md", "# Test")
-          Mint::CommandLine.publish!([markdown_file], { layout: "custom" })
+          Mint::Commandline.publish!([Pathname.new(markdown_path)], config: Mint::Config.with_defaults(layout_name: "custom"))
           verify_file_content("test.html") do |content|
             expect(content).to include("class='custom'")
@@ -99,9 +99,9 @@ RSpec.describe "CLI Publishing Workflow" do
           File.write(".mint/templates/styled/style.css",
             "body { background: red; }")
-          markdown_file = create_markdown_file("test.md", "# Test")
+          markdown_path = create_markdown_path("test.md", "# Test")
-          Mint::CommandLine.publish!([markdown_file], { style: "styled" })
+          Mint::Commandline.publish!([Pathname.new(markdown_path)], config: Mint::Config.with_defaults(style_name: "styled"))
           # Check if style file was created and linked
           expect(File.exist?("test.html")).to be true
@@ -115,39 +115,45 @@ RSpec.describe "CLI Publishing Workflow" do
           FileUtils.mkdir_p("docs/section1")
           FileUtils.mkdir_p("docs/section2")
-          create_markdown_file("docs/index.md", "# Main Documentation")
-          create_markdown_file("docs/section1/intro.md", "# Introduction")
-          create_markdown_file("docs/section2/advanced.md", "# Advanced Topics")
+          create_markdown_path("docs/index.md", "# Main Documentation")
+          create_markdown_path("docs/section1/intro.md", "# Introduction")
+          create_markdown_path("docs/section2/advanced.md", "# Advanced Topics")
           # Also create non-markdown files that should be ignored
           File.write("docs/config.yaml", "key: value")
           File.write("docs/section1/script.js", "console.log('test');")
-          Mint::CommandLine.publish!(["docs"], { recursive: true })
+          # Find all markdown files and process them explicitly since recursive option was removed
+          md_files = Dir.glob("docs/**/*.md").map {|f| Pathname.new(f) }
+          Mint::Commandline.publish!(md_files, config: Mint::Config.with_defaults(preserve_structure: true))
-          expect(File.exist?("docs/index.html")).to be true
-          expect(File.exist?("docs/section1/intro.html")).to be true
-          expect(File.exist?("docs/section2/advanced.html")).to be true
+          expect(File.exist?("index.html")).to be true
+          expect(File.exist?("section1/intro.html")).to be true
+          expect(File.exist?("section2/advanced.html")).to be true
           # Non-markdown files should not be converted
           expect(File.exist?("docs/config.html")).to be false
           expect(File.exist?("docs/section1/script.html")).to be false
         end
-        it "handles empty directories gracefully" do
+        it "raises an error when no files are specified" do
           FileUtils.mkdir_p("empty/nested/dirs")
           expect {
-            Mint::CommandLine.publish!(["empty"], { recursive: true })
-          }.not_to raise_error
+            # Process empty directory - should raise an error
+            md_files = Dir.glob("empty/**/*.md").map {|f| Pathname.new(f) }
+            Mint::Commandline.publish!(md_files, config: Mint::Config.with_defaults(preserve_structure: true))
+          }.to raise_error(ArgumentError, "No files specified. Use file paths or '-' to read from STDIN.")
         end
         it "processes current directory when no files specified" do
-          create_markdown_file("current.md", "# Current Directory")
+          create_markdown_path("current.md", "# Current Directory")
           FileUtils.mkdir_p("sub")
-          create_markdown_file("sub/nested.md", "# Nested File")
+          create_markdown_path("sub/nested.md", "# Nested File")
-          Mint::CommandLine.publish!([], { recursive: true })
+          # Process all markdown files in current directory and subdirectories
+          md_files = Dir.glob("**/*.md").map {|f| Pathname.new(f) }
+          Mint::Commandline.publish!(md_files, config: Mint::Config.with_defaults(preserve_structure: true))
           expect(File.exist?("current.html")).to be true
           expect(File.exist?("sub/nested.html")).to be true
@@ -159,11 +165,11 @@ RSpec.describe "CLI Publishing Workflow" do
           # Create files with different markdown extensions
           extensions = %w[md markdown mkd]
           extensions.each_with_index do |ext, i|
-            create_markdown_file("test#{i}.#{ext}", "# Test #{i}")
+            create_markdown_path("test#{i}.#{ext}", "# Test #{i}")
           end
-          files = extensions.map.with_index {|ext, i| "test#{i}.#{ext}" }
-          Mint::CommandLine.publish!(files, {})
+          files = extensions.map.with_index {|ext, i| Pathname.new("test#{i}.#{ext}") }
+          Mint::Commandline.publish!(files, config: Mint::Config.defaults)
           extensions.each_with_index do |ext, i|
             expect(File.exist?("test#{i}.html")).to be true
@@ -196,9 +202,9 @@ RSpec.describe "CLI Publishing Workflow" do
             [Link to example](https://example.com)
           MARKDOWN
-          create_markdown_file("complex.md", complex_content)
+          create_markdown_path("complex.md", complex_content)
-          Mint::CommandLine.publish!(["complex.md"], {})
+          Mint::Commandline.publish!([Pathname.new("complex.md")], config: Mint::Config.defaults)
           verify_file_content("complex.html") do |content|
             expect(content).to include("<h1>Main Title</h1>")
@@ -215,36 +221,26 @@ RSpec.describe "CLI Publishing Workflow" do
       describe "error handling" do
         it "handles missing source files gracefully" do
           expect {
-            Mint::CommandLine.publish!(["nonexistent.md"], {})
+            Mint::Commandline.publish!([Pathname.new("nonexistent.md")], config: Mint::Config.defaults)
           }.to raise_error(Errno::ENOENT) # Should raise an error for missing file
         end
-        it "handles permission errors" do
-          # Create a file, then make directory read-only
-          markdown_file = create_markdown_file("test.md", "# Test")
-          # Try to publish to a non-writable location
-          # This test might be platform-specific
-          expect {
-            Mint::CommandLine.publish!([markdown_file], { destination: "/root" })
-          }.to raise_error(Errno::EROFS) # Should fail due to permissions
-        end
-        it "handles invalid templates gracefully" do
-          markdown_file = create_markdown_file("test.md", "# Test")
+        it "handles invalid templates by throwing error" do
+          markdown_path = create_markdown_path("test.md", "# Test")
+          # Should throw error when user specifies nonexistent style
           expect {
-            Mint::CommandLine.publish!([markdown_file], { layout: "nonexistent" })
-          }.to raise_error(Mint::TemplateNotFoundException)
+            Mint::Commandline.publish!([Pathname.new(markdown_path)], config: Mint::Config.with_defaults(style_name: "nonexistent"))
+          }.to raise_error(Mint::StyleNotFoundException)
         end
       end
       describe "output file naming" do
         it "preserves directory structure in output" do
           FileUtils.mkdir_p("input/subdir")
-          create_markdown_file("input/subdir/doc.md", "# Nested Document")
+          create_markdown_path("input/subdir/doc.md", "# Nested Document")
-          Mint::CommandLine.publish!(["input/subdir/doc.md"], {})
+          Mint::Commandline.publish!([Pathname.new("input/subdir/doc.md")], config: Mint::Config.with_defaults(preserve_structure: true))
           expect(File.exist?("input/subdir/doc.html")).to be true
         end
@@ -257,10 +253,10 @@ RSpec.describe "CLI Publishing Workflow" do
         end
         it "overwrites existing output files" do
-          markdown_file = create_markdown_file("test.md", "# Version 1")
+          markdown_path = create_markdown_path("test.md", "# Version 1")
           File.write("test.html", "<html>Old content</html>")
-          Mint::CommandLine.publish!([markdown_file], {})
+          Mint::Commandline.publish!([Pathname.new(markdown_path)], config: Mint::Config.defaults)
           verify_file_content("test.html") do |content|
             expect(content).to include("Version 1")
@@ -272,35 +268,41 @@ RSpec.describe "CLI Publishing Workflow" do
       describe "configuration integration" do
         it "respects configuration file settings" do
           # Create custom config
-          config_content = {
-            'layout' => 'custom',
-            'style' => 'minimal',
-            'destination' => 'build'
-          }
-          File.write(".mint/config.yaml", config_content.to_yaml)
+          File.write(".mint/config.toml", <<~TOML)
+            layout = "custom"
+            style = "minimal"
+            destination = "build"
+          TOML
           # Create the referenced templates
           create_template_directory("custom")
           create_template_directory("minimal")
           FileUtils.mkdir_p("build")
-          markdown_file = create_markdown_file("test.md", "# Test")
+          markdown_path = create_markdown_path("test.md", "# Test")
+          # Load configuration from file and convert string paths to Pathnames
+          loaded_config = Mint.configuration
+          config_with_pathnames = Mint::Config.with_defaults(
+            layout_name: loaded_config.layout_name,
+            style_name: loaded_config.style_name,
+            destination_directory: Pathname.new(loaded_config.destination_directory.to_s)
+          )
-          Mint::CommandLine.publish!([markdown_file], {})
+          Mint::Commandline.publish!([Pathname.new(markdown_path)], config: config_with_pathnames)
           expect(File.exist?("build/test.html")).to be true
         end
         it "allows command-line options to override config" do
           # Set config with default destination
-          config_content = { 'destination' => 'config_output' }
-          File.write(".mint/config.yaml", config_content.to_yaml)
+          File.write(".mint/config.toml", 'destination = "config_output"')
           FileUtils.mkdir_p("cli_output")
-          markdown_file = create_markdown_file("test.md", "# Test")
+          markdown_path = create_markdown_path("test.md", "# Test")
           # Override with CLI option
-          Mint::CommandLine.publish!([markdown_file], { destination: "cli_output" })
+          Mint::Commandline.publish!([Pathname.new(markdown_path)], config: Mint::Config.with_defaults(destination_directory: Pathname.new("cli_output")))
           expect(File.exist?("cli_output/test.html")).to be true
           expect(File.exist?("config_output/test.html")).to be false
@@ -311,11 +313,11 @@ RSpec.describe "CLI Publishing Workflow" do
         it "processes multiple files efficiently" do
           files = []
           10.times do |i|
-            files << create_markdown_file("doc#{i}.md", "# Document #{i}")
+            files << Pathname.new(create_markdown_path("doc#{i}.md", "# Document #{i}"))
           end
           start_time = Time.now
-          Mint::CommandLine.publish!(files, {})
+          Mint::Commandline.publish!(files, config: Mint::Config.defaults)
           end_time = Time.now
           # All files should be processed
@@ -331,7 +333,7 @@ RSpec.describe "CLI Publishing Workflow" do
           # This tests the all_files feature for multi-file processing
           files = []
           3.times do |i|
-            files << create_markdown_file("page#{i}.md", "# Page #{i}")
+            files << Pathname.new(create_markdown_path("page#{i}.md", "# Page #{i}"))
           end
           # Create a template that uses the all_files variable
@@ -353,7 +355,7 @@ RSpec.describe "CLI Publishing Workflow" do
           FileUtils.mkdir_p(".mint/templates/nav")
           File.write(".mint/templates/nav/layout.erb", nav_template)
-          Mint::CommandLine.publish!(files, { layout: "nav" })
+          Mint::Commandline.publish!(files, config: Mint::Config.with_defaults(layout_name: "nav", navigation: true))
           # Check that navigation was included
           verify_file_content("page0.html") do |content|

data/spec/commandline_path_integration_spec.rb ADDED Viewed

@@ -0,0 +1,230 @@
+require "spec_helper"
+RSpec.describe "Mint::Commandline.publish! Path Integration" do
+  context "in isolated environment" do
+    around(:each) do |example|
+      in_temp_dir do |dir|
+        @test_dir = dir
+        create_template_directory("default")
+        example.run
+      end
+    end
+    describe "batch file processing with mixed paths" do
+      it "handles mixed relative and nested paths in single batch" do
+        FileUtils.mkdir_p(["docs/api", "content/blog", "output"])
+        files = [
+          Pathname.new("readme.md"),
+          Pathname.new("docs/installation.md"),
+          Pathname.new("docs/api/reference.md"),
+          Pathname.new("content/blog/post1.md")
+        ]
+        files.each_with_index do |file, i|
+          create_markdown_path(file, "# Document #{i + 1}")
+        end
+        config = Mint::Config.with_defaults(destination_directory: Pathname.new("output"), preserve_structure: true)
+        Mint::Commandline.publish!(files, config: config)
+        expect(File.exist?("output/readme.html")).to be true
+        expect(File.exist?("output/docs/installation.html")).to be true
+        expect(File.exist?("output/docs/api/reference.html")).to be true
+        expect(File.exist?("output/content/blog/post1.html")).to be true
+      end
+      it "handles glob patterns maintaining directory structure" do
+        FileUtils.mkdir_p(["guides/beginner", "guides/advanced", "tutorials", "site"])
+        create_markdown_path("guides/beginner/basics.md", "# Basics")
+        create_markdown_path("guides/beginner/setup.md", "# Setup")
+        create_markdown_path("guides/advanced/config.md", "# Configuration")
+        create_markdown_path("tutorials/first-steps.md", "# First Steps")
+        files = Dir.glob("**/*.md").map {|f| Pathname.new(f) }
+        config = Mint::Config.with_defaults(destination_directory: Pathname.new("site"), preserve_structure: true)
+        Mint::Commandline.publish!(files, config: config)
+        expect(File.exist?("site/guides/beginner/basics.html")).to be true
+        expect(File.exist?("site/guides/beginner/setup.html")).to be true
+        expect(File.exist?("site/guides/advanced/config.html")).to be true
+        expect(File.exist?("site/tutorials/first-steps.html")).to be true
+      end
+    end
+    describe "root directory configuration effects" do
+      it "processes files with explicit root directory in batch" do
+        FileUtils.mkdir_p(["source/pages", "source/assets", "build"])
+        files = [
+          Pathname.new("source/pages/home.md"),
+          Pathname.new("source/pages/about.md"),
+          Pathname.new("source/assets/docs.md")
+        ]
+        files.each_with_index do |file, i|
+          create_markdown_path(file, "# Page #{i + 1}")
+        end
+        config = Mint::Config.with_defaults(
+          working_directory: Pathname.new("source"),
+          destination_directory: Pathname.new("../build"),  # Relative to root directory
+          preserve_structure: true
+        )
+        Mint::Commandline.publish!(files, config: config)
+        # Should strip 'source/' prefix due to root directory
+        expect(File.exist?("build/pages/home.html")).to be true
+        expect(File.exist?("build/pages/about.html")).to be true
+        expect(File.exist?("build/assets/docs.html")).to be true
+        # Should not have source/ prefix
+        expect(File.exist?("build/source/pages/home.html")).to be false
+      end
+    end
+    describe "style file placement with paths" do
+      it "creates style files in correct destination with external mode" do
+        FileUtils.mkdir_p(["content", "public"])
+        create_markdown_path("content/article.md", "# Article")
+        config = Mint::Config.with_defaults(
+          destination_directory: Pathname.new("public"),
+          style_mode: :external,
+          preserve_structure: true
+        )
+        Mint::Commandline.publish!([Pathname.new("content/article.md")], config: config)
+        expect(File.exist?("public/content/article.html")).to be true
+        expect(File.exist?("public/style.css")).to be true
+      end
+      it "handles style destination directory with nested sources" do
+        FileUtils.mkdir_p(["src/docs", "web/pages", "web/assets"])
+        create_markdown_path("src/docs/guide.md", "# Guide")
+        config = Mint::Config.with_defaults(
+          destination_directory: Pathname.new("web/pages"),
+          style_destination_directory: Pathname.new("web/assets"),
+          style_mode: :external,
+          preserve_structure: true
+        )
+        Mint::Commandline.publish!([Pathname.new("src/docs/guide.md")], config: config)
+        expect(File.exist?("web/pages/src/docs/guide.html")).to be true
+        expect(File.exist?("web/pages/web/assets/style.css")).to be true
+      end
+    end
+    describe "error handling with paths" do
+      it "handles nonexistent source files gracefully" do
+        config = Mint::Config.with_defaults(destination_directory: Pathname.new("output"), preserve_structure: true)
+        expect {
+          Mint::Commandline.publish!([Pathname.new("nonexistent/file.md")], config: config)
+        }.to raise_error(Errno::ENOENT)
+      end
+      it "creates deeply nested destination directories as needed" do
+        create_markdown_path("test.md", "# Test")
+        config = Mint::Config.with_defaults(
+          destination_directory: Pathname.new("very/deeply/nested/output/directory")
+        )
+        expect {
+          Mint::Commandline.publish!([Pathname.new("test.md")], config: config)
+        }.not_to raise_error
+        expect(File.exist?("very/deeply/nested/output/directory/test.html")).to be true
+      end
+    end
+    describe "cross-linking with preserved paths" do
+      it "transforms markdown links correctly with nested paths" do
+        FileUtils.mkdir_p(["docs/guides", "docs/api", "site"])
+        # Create files with cross-references
+        create_markdown_path("docs/guides/intro.md",
+          "# Introduction\n\nSee also [API Reference](../api/reference.md).")
+        create_markdown_path("docs/api/reference.md",
+          "# API Reference\n\nBack to [Introduction](../guides/intro.md).")
+        files = [Pathname.new("docs/guides/intro.md"), Pathname.new("docs/api/reference.md")]
+        config = Mint::Config.with_defaults(destination_directory: Pathname.new("site"), preserve_structure: true)
+        Mint::Commandline.publish!(files, config: config)
+        # Check that links were transformed
+        intro_content = File.read("site/guides/intro.html")
+        expect(intro_content).to include("../api/reference.html")
+        api_content = File.read("site/api/reference.html")
+        expect(api_content).to include("../guides/intro.html")
+      end
+    end
+    describe "real-world scenarios" do
+      it "handles documentation site structure" do
+        # Simulate hugo/jekyll-style structure
+        FileUtils.mkdir_p([
+          "content/posts/2023",
+          "content/docs/v1.0",
+          "content/about",
+          "public"
+        ])
+        files = [
+          Pathname.new("content/posts/2023/welcome.md"),
+          Pathname.new("content/docs/v1.0/getting-started.md"),
+          Pathname.new("content/docs/v1.0/api.md"),
+          Pathname.new("content/about/index.md")
+        ]
+        files.each_with_index do |file, i|
+          create_markdown_path(file, "# Content #{i + 1}")
+        end
+        config = Mint::Config.with_defaults(destination_directory: Pathname.new("public"), preserve_structure: true)
+        Mint::Commandline.publish!(files, config: config)
+        expect(File.exist?("public/posts/2023/welcome.html")).to be true
+        expect(File.exist?("public/docs/v1.0/getting-started.html")).to be true
+        expect(File.exist?("public/docs/v1.0/api.html")).to be true
+        expect(File.exist?("public/about/index.html")).to be true
+      end
+      it "handles monorepo documentation structure" do
+        # Simulate monorepo with multiple packages
+        FileUtils.mkdir_p([
+          "packages/core/docs",
+          "packages/ui/docs",
+          "packages/utils/docs",
+          "docs-site"
+        ])
+        files = [
+          Pathname.new("packages/core/docs/api.md"),
+          Pathname.new("packages/ui/docs/components.md"),
+          Pathname.new("packages/utils/docs/helpers.md")
+        ]
+        files.each_with_index do |file, i|
+          create_markdown_path(file, "# Package Documentation #{i + 1}")
+        end
+        config = Mint::Config.with_defaults(destination_directory: Pathname.new("docs-site"), preserve_structure: true)
+        Mint::Commandline.publish!(files, config: config)
+        expect(File.exist?("docs-site/core/docs/api.html")).to be true
+        expect(File.exist?("docs-site/ui/docs/components.html")).to be true
+        expect(File.exist?("docs-site/utils/docs/helpers.html")).to be true
+      end
+    end
+  end
+end