mint 0.8.0 → 0.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 70a879d8b2c0b7150b6535b2c2c00c366d3e8484c499c7c0065e76bd5454b768
-  data.tar.gz: a2595df94714597a9937a232115b963c096b6b71acbe373878a700181653adb4
+  metadata.gz: 49d66d53b189d1897ab9938358279f7dc0c4ede1d44926eba5f1b9b6f7d8344b
+  data.tar.gz: '08b1882ec1972dbedd02c87e0e6a4cf1f61ca0a631c7f56bca20b4dfeb1ea36b'
 SHA512:
-  metadata.gz: 1ca15ee5ad05556ca6d7aef47d2f74f048a2f2cd7c11fc78931ffd6af7a36417dc65c04dae0661b53a71c9515dcdef09557d7538e0607da161a424061e3049f6
-  data.tar.gz: 4d2b342e58022fde932ad266825bfed9d2b08ba029c0b0469868560a7d87e69383d8c0eab5fa3b28e63630283a33e808cb6319fd4ae9f0bc9734ca93dbea2598
+  metadata.gz: 3acb8ce3fc1856014e0efe3aa94d3720faeb8f677e2f9e3a46c541ecc8bd62f65a187558421ac10acc0599f813a8d161bed142bf44c75b51e6bc8f140351cc7f
+  data.tar.gz: 3851e818c5bad026bfde0302c8fe3184dfe4d79e93ca87479e85590015bb3fd082926fe88f7397144b8fbbb4163ae9e602bbb510bf23da009d20943b334896c2

data/README.md

@@ -1,137 +1,100 @@
-# What is Mint?
+# Mint
 
-Mint transforms your plain text documents into beautiful documents. It makes the process simple but customizable.
+Transform your plain text documents into beautiful HTML documents with customizable styling and templates.
 
-Why would you want to keep all of your documents as plain text?
+## Installation
 
-- To focus on words and structure when you write
-- To control style with a single command, independently of document structure
-- To keep your text and formatting under version control
-- To make your text amenable to scripting--for example, text analysis
+```bash
+gem install mint
+```
 
-What does Mint create from these source files? Beautiful, styled HTML ready to print, e-mail, export, and present.
+## Quick Start
 
-In a few words: *Mint processes words so you don't have to.*
+Transform a Markdown document into styled HTML:
 
-## The mint command
+```bash
+mint publish Document.md
+```
 
-If you have a plain text document formatted in Markdown or Textile or almost any other templating
-language, you're ready to go.
+This creates `Document.html` in your current directory with beautiful default styling.
 
-The easiest Mint command doesn't require configuration. It transforms a document into HTML and links
-it to the default stylesheet, which I've designed for you.
+## Usage
 
-Simply type:
+### Basic Commands
 
-    mint publish Document.md
+```bash
+# Publish a single document
+mint publish Document.md
 
-And voilà, Minimalism.html will show up next to Document.md.
+# Publish with a template
+mint publish Document.md --template nord
 
-Opening Minimalism.html with your favorite web browser--[Firefox is best for typography][Firefox
-typography], but Webkit-based browsers (Chrome, Safari) work, too--will show what looks like a
-word-processed document, complete with big bold headers, italic emphasis, automatically indented
-and numbered lists, and bullets. If you're in a modern browser, you'll even see ligatures and
-proper kerning. The page will be on a white canvas that looks like a page, even though you are in a
-browser.
+# Publish to a specific directory
+mint publish Document.md --destination public
 
-Sending that page to a printer is as easy as clicking "Print" from your browser. What comes out of
-your printer will have a 12 pt base font, normal margins, and a not-too-cramped baseline. (Ah the
-wonder of print stylesheets.)
+# Publish multiple files
+mint publish *.md --destination final-drafts
 
-You can throw as many files as you'd like in. Any commandline argument *not* preceded by an option
-(e.g., `--template`) or in the `mint` command vocabulary (more on that in a minute) will be
-interpreted as a file name:
+# Publish a digital garden, with linked navigation
+mint publish content/**/*.md --template garden --destination public
+```
 
-    mint publish Document.md Proposal.md
+### Common Options
 
-This command can be tweaked with options and arguments to be more flexible:
+| Flag | Description |
+|------|-------------|
+| `-t, --template TEMPLATE` | Use a built-in template (combines layout + style) |
+| `-l, --layout LAYOUT` | Specify only the layout |
+| `-s, --style STYLE` | Specify only the style |
+| `-d, --destination DIR` | Output directory |
+| `-o, --output-file FORMAT` | Custom output filename format |
+| `--style-mode MODE` | How styles are included (inline, external, original) |
+| `--style-destination PATH` | Create external stylesheet and link it (sets mode to external) |
+| `-r, --recursive` | Find all Markdown files in any directories specified |
 
-    mint publish Document.md --template resume                      # specifies a style template
-    mint publish Document.md --style-destination styles             # creates external stylesheet in styles directory
-    mint publish Document.md --style-destination styles/custom.css  # creates external stylesheet at specific path
+### Style modes
 
-For a listing of mint options, take [a look at the tutorial][tutorial] or the [full API](http://www.rubydoc.info/github/davejacobs/mint).
+Mint offers three ways to include styles in your HTML output:
 
-## A basic Mint document
+- **`inline`** (default) – CSS is embedded directly in the HTML document as `<style>` tags
+- **`external`** – CSS is compiled and saved as separate files, linked with `<link>` tags
+- **`original`** – Links directly to original CSS template files without processing (for live editing)
 
-Mint is loaded with smart defaults, so if you don't want to configure something--say, the basic HTML
-skeleton of your document or the output directory--you don't have to. You'll probably be surprised
-at how easy it is to use out of the box, and how configurable it is.
+The `original` mode is particularly useful for template development, as it allows you to edit CSS files and see changes immediately without republishing. Only `.css` files are supported in this mode, and `@import` statements in CSS files will be included as additional `<link>` tags.
 
-    document = Mint::Document.new("Document.md")
-    document.publish!
+### Built-in templates
 
-If you want to customize your document, though--and that's why I built this library--Mint makes that
-easy with explicit parameters:
+- `default` – Clean, minimal styling
+- `nord` – Clean, uses Nord color scheme
+- `nord-dark` – Dark version of Nord
+- `garden` – For digital gardens; includes navigation
 
-    # Create a document with external stylesheet
-    document = Mint::Document.new("Document.md", 
-                                  style_destination: "css",
-                                  template: "zen")
-    document.publish!
+## Documentation
 
-    # Create with specific layout and style
-    document = Mint::Document.new("Resume.md",
-                                  destination: "output",
-                                  layout: "resume",
-                                  style: "professional")
-    document.publish!
+- **Complete usage guide:** [TUTORIAL.md](doc/TUTORIAL.md)
+- **Man page:** `man mint` (after installation)
+- **API documentation:** [RubyDoc](http://www.rubydoc.info/github/davejacobs/mint)
 
-To understand Mint's flexibility, you'll want to [take a look at the API][API].
+## Why Mint?
 
-[Firefox typography]: http://opentype.info/blog/2008/06/14/kerning-and-opentype-features-in-firefox-3/ "Firefox 3 supports
-kerning and automatic ligatures"
+- **Focus on writing** – Keep documents as plain text
+- **Version control friendly** – Text files work great with Git
+- **Scriptable** – Automate document processing
+- **Beautiful output** – Professional-looking HTML ready for print or web
+- **Highly customizable** – Create your own templates and styles
 
-## Templates
+## Templates and customization
 
-Templates can be written in any format accepted by the Tilt template interface library. (See [the
-Tilt TEMPLATES file][Tilt templates] for more information.)
+Mint supports layouts written in HAML or ERB and stylesheets can be written in CSS, SCSS, or SASS.
 
-In a template layouts, Ruby calls are sparse but necessary.
+## Contributing
 
-If you're designing a layout, you need to indicate where Mint should place your content. For that
-simple reason, raw HTML files cannot be layouts. Instead, if you want to use HTML templates, you
-should use the ERB format. These files are essentially HTML with the possibility for Ruby calls. You
-can even use the .html extension for your files. Just code the dynamic portion using ERB syntax.
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Run the tests: `rspec`
+5. Submit a pull request
 
-Inside your template, use the `content` method to place your source's content.
+## License
 
-For stylesheets, use the `stylesheet_tag` method, which automatically handles both inline and external stylesheets based on the document's style mode:
-
-So if you're writing your layout using Haml, the template might look like this:
-
-    !!! 
-    %html 
-      %head 
-        = stylesheet_tag
-      %body 
-        #container= content
-
-The `stylesheet_tag` method will generate either:
-- `<style>...</style>` tags with inlined CSS for inline mode (default)
-- `<link rel="stylesheet" href="...">` tags for external stylesheets
-
-You can create template stylesheets using [CSS][] or [SCSS][].
-
-Mint comes preloaded with a few templates to get you started.
-
-1. Default
-2. Zen
-3. Nord
-4. Nord Dark
-
-## Plugins: A work in progress
-
-I've designed the beginnings of a plugin system. With this system, you can implement a callback or
-two and have full control over document creation and sharing. I'll get documentation going soon. For
-now, look to lib/mint/plugins/epub.rb and bin/mint-epub for an example of how to build one. It's not
-complete and I'm open to API suggestions.
-
-This is going to be useful for things like creating actual office documents or e-books or even bound
-novels. I'm actually thinking that half the power of this library is its plugin system.
-
-[tutorial]: http://github.com/davejacobs/mint/tree/master/doc/API.md
-[Tilt templates]: http://github.com/rtomayko/tilt/blob/master/TEMPLATES.md "A listing of all templates supported by Tilt."
-[CSS]: http://en.wikipedia.org/wiki/Cascading_Style_Sheets
-[SASS/SCSS]: http://sass-lang.com/
-[Less]: http://lesscss.org/
+MIT License. See [LICENSE](LICENSE) for details.

data/lib/mint/command_line.rb

@@ -41,8 +41,8 @@ module Mint
           parsed_options[:destination] = d
         end
 
-        cli.on "--inline-style", "Inline CSS into the HTML document (default)" do
-          parsed_options[:style_mode] = :inline
+        cli.on "--style-mode MODE", ["inline", "external", "original"], "Specify how styles are included (inline, external, original)" do |mode|
+          parsed_options[:style_mode] = mode.to_sym
         end
 
         cli.on "--style-destination DESTINATION", "Create stylesheet at specified directory or file path and link it" do |destination|
@@ -58,7 +58,7 @@ module Mint
           parsed_options[:scope] = :user
         end
 
-        cli.on "-l", "--local", "Specify config changes on a project-specific level" do
+        cli.on "--local", "Specify config changes on a project-specific level" do
           parsed_options[:scope] = :local
         end
 
@@ -71,7 +71,7 @@ module Mint
       parser.parse! transient_argv
       
       if parsed_options[:style_mode] == :inline && parsed_options[:style_destination]
-        raise ArgumentError, "--inline-style and --style-destination cannot be used together"
+        raise ArgumentError, "--style-mode inline and --style-destination cannot be used together"
       end
       
       default_options = Mint.default_options.merge(destination: Dir.getwd)

data/lib/mint/css_parser.rb

@@ -0,0 +1,76 @@
+require "pathname"
+
+module Mint
+  # Parses CSS files to extract @import statements and calculate relative paths
+  class CssParser
+    
+    # Extracts @import statements from CSS content
+    #
+    # @param [String] css_content the CSS content to parse
+    # @return [Array<String>] array of imported file paths
+    def self.extract_imports(css_content)
+      imports = []
+      
+      # Match @import statements with various formats:
+      # @import "file.css";
+      # @import 'file.css';
+      # @import url("file.css");
+      # @import url('file.css');
+      css_content.scan(/@import\s+(?:url\()?['"]([^'"]+)['"](?:\))?;?/i) do |match|
+        imports << match[0]
+      end
+      
+      imports
+    end
+    
+    # Resolves all CSS files (main + imports) and calculates their paths relative to HTML output
+    #
+    # @param [String] main_css_path absolute path to the main CSS file
+    # @param [String] html_output_path absolute path to the HTML output file
+    # @return [Array<String>] array of relative paths from HTML to CSS files
+    def self.resolve_css_files(main_css_path, html_output_path)
+      css_files = []
+      main_css_file = Pathname.new(main_css_path)
+      html_file = Pathname.new(html_output_path)
+      
+      # Add the main CSS file
+      css_files << main_css_file.relative_path_from(html_file.dirname).to_s
+      
+      # Only process if main CSS file exists and is a .css file
+      return css_files unless main_css_file.exist? && main_css_file.extname == '.css'
+      
+      begin
+        css_content = File.read(main_css_path)
+        imports = extract_imports(css_content)
+        
+        imports.each do |import_path|
+          # Resolve import path relative to the main CSS file's directory
+          import_file = main_css_file.dirname + import_path
+          
+          # Only include if it's a .css file and exists
+          if import_file.exist? && import_file.extname == '.css'
+            # Calculate path relative to HTML output
+            relative_import = import_file.relative_path_from(html_file.dirname).to_s
+            css_files << relative_import
+          end
+        end
+        
+      rescue => e
+        # If we can't read the CSS file, just return the main file
+        # This allows the system to gracefully handle missing or unreadable files
+      end
+      
+      css_files
+    end
+    
+    # Generates HTML link tags for CSS files
+    #
+    # @param [Array<String>] css_file_paths array of relative paths to CSS files
+    # @return [String] HTML link tags
+    def self.generate_link_tags(css_file_paths)
+      css_file_paths.map do |css_path|
+        %Q{<link rel="stylesheet" href="#{css_path}">}
+      end.join("\n    ")
+    end
+  end
+end

data/lib/mint/document.rb

@@ -1,6 +1,7 @@
 require "mint/resource"
 require "mint/layout"
 require "mint/style"
+require "mint/css_parser"
 
 module Mint
   class Document < Resource
@@ -245,11 +246,28 @@ module Mint
       case @style_mode
       when :external
         "<link rel=\"stylesheet\" href=\"#{stylesheet}\">".html_safe
+      when :original
+        original_stylesheet_tags.html_safe
       else # :inline (default)
         "<style>#{self.style.render}</style>".html_safe
       end
     end
 
+    # Generates stylesheet link tags for original mode
+    # Links directly to original CSS files without processing
+    def original_stylesheet_tags
+      return "" unless self.style&.template_path
+      
+      main_css_path = self.style.template_path
+      html_output_path = self.output_file
+      
+      # Only process .css files
+      return "" unless File.extname(main_css_path) == '.css'
+      
+      css_file_paths = CssParser.resolve_css_files(main_css_path, html_output_path)
+      CssParser.generate_link_tags(css_file_paths)
+    end
+
     # Parses styles defined in YAML metadata in content, including it
     # in output CSS style
     # 

data/lib/mint/version.rb

@@ -1,3 +1,3 @@
 module Mint
-  VERSION = "0.8.0"
+  VERSION = "0.8.1"
 end

data/man/mint.1

@@ -18,16 +18,16 @@ Transform one or more source files into HTML documents
 .BR \-d ", " \-\-destination " " \fIDIRECTORY\fR
 Specify a destination directory, relative to the root
 .TP
-.BR \-\-inline\-style
-Inline CSS into the HTML document (default behavior)
+.BR \-\-style\-mode " " \fIMODE\fR
+Specify how styles are included (inline, external, original). Default is inline.
 .TP
 .BR \-\-style\-destination " " \fIDESTINATION\fR
-Create stylesheet at specified directory or file path and link it. This option is mutually exclusive with --inline-style.
+Create stylesheet at specified directory or file path and link it. This sets style mode to external.
 .TP
 .BR \-\-template " " \fITEMPLATE\fR
 Specify a template to use for both layout and styling
 .TP
-.BR \-\-layout " " \fILAYOUT\fR
+.BR \-l ", " \-\-layout " " \fILAYOUT\fR
 Specify a specific layout template
 .TP
 .BR \-\-style " " \fISTYLE\fR
@@ -39,7 +39,7 @@ Specify config changes on a global level
 .BR \-u ", " \-\-user
 Specify config changes on a user-wide level
 .TP
-.BR \-l ", " \-\-local
+.BR \-\-local
 Specify config changes on a local level (default)
 .TP
 .BR \-r ", " \-\-recursive

data/spec/cli/README.md

@@ -6,17 +6,17 @@ This directory contains a comprehensive test suite for the Mint command-line int
 
 ### Core test files
 
-- **`argument_parsing_spec.rb`** - Tests command-line argument parsing and option handling
-- **`template_management_spec.rb`** - Tests template installation, uninstallation, editing, and listing
-- **`publish_workflow_spec.rb`** - Tests markdown publishing, file discovery, and output generation
-- **`configuration_management_spec.rb`** - Tests configuration setting, reading, and scope management
-- **`bin_integration_spec.rb`** - Tests actual `bin/mint` executable integration
-- **`full_workflow_integration_spec.rb`** - End-to-end workflow tests for common user scenarios
+- **`argument_parsing_spec.rb`** – Tests command-line argument parsing and option handling
+- **`template_management_spec.rb`** – Tests template installation, uninstallation, editing, and listing
+- **`publish_workflow_spec.rb`** – Tests markdown publishing, file discovery, and output generation
+- **`configuration_management_spec.rb`** – Tests configuration setting, reading, and scope management
+- **`bin_integration_spec.rb`** – Tests actual `bin/mint` executable integration
+- **`full_workflow_integration_spec.rb`** – End-to-end workflow tests for common user scenarios
 
 ### Support files
 
-- **`../support/cli_helpers.rb`** - Helper methods for CLI testing (temp directories, file creation, output capture)
-- **`run_cli_tests.rb`** - Custom test runner with better output formatting
+- **`../support/cli_helpers.rb`** – Helper methods for CLI testing (temp directories, file creation, output capture)
+- **`run_cli_tests.rb`** – Custom test runner with better output formatting
 
 ## Running tests
 
@@ -79,9 +79,9 @@ end
 ## Debugging failed tests
 
 ### Common issues
-1. **Missing templates** - Tests create minimal templates; check `create_template_directory`
-2. **File paths** - All paths should be relative within temp directory
-3. **Configuration** - Use `setup_basic_config` to establish minimal config
+1. **Missing templates** – Tests create minimal templates; check `create_template_directory`
+2. **File paths** – All paths should be relative within temp directory
+3. **Configuration** – Use `setup_basic_config` to establish minimal config
 
 ### Debug helpers
 

data/spec/cli/argument_parsing_spec.rb

@@ -29,6 +29,13 @@ RSpec.describe "CLI Argument Parsing" do
         expect(result[:options][:layout_or_style_or_template]).to eq([:layout, "custom"])
       end
 
+      it "parses -l option for layout" do
+        result = Mint::CommandLine.parse(["-l", "custom", "file.md"])
+        
+        expect(result[:argv]).to eq(["file.md"])
+        expect(result[:options][:layout_or_style_or_template]).to eq([:layout, "custom"])
+      end
+
       it "parses --style option" do
         result = Mint::CommandLine.parse(["--style", "minimal", "file.md"])
         
@@ -107,9 +114,6 @@ RSpec.describe "CLI Argument Parsing" do
 
         result = Mint::CommandLine.parse(["-u"])
         expect(result[:options][:scope]).to eq(:user)
-
-        result = Mint::CommandLine.parse(["-l"])
-        expect(result[:options][:scope]).to eq(:local)
       end
     end
 
@@ -203,5 +207,31 @@ RSpec.describe "CLI Argument Parsing" do
         end
       end
     end
+
+    context "with style mode options" do
+      it "parses --style-mode inline" do
+        result = Mint::CommandLine.parse(["--style-mode", "inline", "file.md"])
+        
+        expect(result[:options][:style_mode]).to eq(:inline)
+      end
+
+      it "parses --style-mode external" do
+        result = Mint::CommandLine.parse(["--style-mode", "external", "file.md"])
+        
+        expect(result[:options][:style_mode]).to eq(:external)
+      end
+
+      it "parses --style-mode original" do
+        result = Mint::CommandLine.parse(["--style-mode", "original", "file.md"])
+        
+        expect(result[:options][:style_mode]).to eq(:original)
+      end
+
+      it "defaults to inline style mode" do
+        result = Mint::CommandLine.parse(["file.md"])
+        
+        expect(result[:options][:style_mode]).to eq(:inline)
+      end
+    end
   end
 end

data/spec/css_parser_spec.rb

@@ -0,0 +1,149 @@
+require "spec_helper"
+require "mint/css_parser"
+require "tempfile"
+require "pathname"
+
+describe Mint::CssParser do
+  describe ".extract_imports" do
+    it "extracts @import statements with double quotes" do
+      css = '@import "reset.css"; body { margin: 0; }'
+      imports = Mint::CssParser.extract_imports(css)
+      expect(imports).to eq(["reset.css"])
+    end
+
+    it "extracts @import statements with single quotes" do
+      css = "@import 'normalize.css'; .class { color: red; }"
+      imports = Mint::CssParser.extract_imports(css)
+      expect(imports).to eq(["normalize.css"])
+    end
+
+    it "extracts @import url() statements" do
+      css = '@import url("fonts.css"); @import url(\'colors.css\');'
+      imports = Mint::CssParser.extract_imports(css)
+      expect(imports).to eq(["fonts.css", "colors.css"])
+    end
+
+    it "extracts multiple @import statements" do
+      css = <<~CSS
+        @import "reset.css";
+        @import 'normalize.css';
+        @import url("fonts.css");
+        body { margin: 0; }
+      CSS
+      imports = Mint::CssParser.extract_imports(css)
+      expect(imports).to eq(["reset.css", "normalize.css", "fonts.css"])
+    end
+
+    it "returns empty array when no imports found" do
+      css = "body { margin: 0; color: blue; }"
+      imports = Mint::CssParser.extract_imports(css)
+      expect(imports).to eq([])
+    end
+  end
+
+  describe ".resolve_css_files" do
+    let(:temp_dir) { Dir.mktmpdir }
+    
+    after do
+      FileUtils.rm_rf(temp_dir)
+    end
+
+    it "resolves main CSS file path relative to HTML output" do
+      # Create directory structure:
+      # temp_dir/
+      #   css/
+      #     main.css
+      #   output/
+      #     index.html (output file)
+      
+      css_dir = File.join(temp_dir, "css")
+      output_dir = File.join(temp_dir, "output")
+      FileUtils.mkdir_p([css_dir, output_dir])
+      
+      main_css = File.join(css_dir, "main.css")
+      html_output = File.join(output_dir, "index.html")
+      
+      File.write(main_css, "body { margin: 0; }")
+      
+      css_files = Mint::CssParser.resolve_css_files(main_css, html_output)
+      expect(css_files).to eq(["../css/main.css"])
+    end
+
+    it "resolves main CSS and imported files" do
+      # Create directory structure:
+      # temp_dir/
+      #   css/
+      #     main.css (imports reset.css)
+      #     reset.css
+      #   output/
+      #     index.html
+      
+      css_dir = File.join(temp_dir, "css")
+      output_dir = File.join(temp_dir, "output")
+      FileUtils.mkdir_p([css_dir, output_dir])
+      
+      main_css = File.join(css_dir, "main.css")
+      reset_css = File.join(css_dir, "reset.css")
+      html_output = File.join(output_dir, "index.html")
+      
+      File.write(main_css, '@import "reset.css"; body { margin: 0; }')
+      File.write(reset_css, "* { box-sizing: border-box; }")
+      
+      css_files = Mint::CssParser.resolve_css_files(main_css, html_output)
+      expect(css_files).to eq(["../css/main.css", "../css/reset.css"])
+    end
+
+    it "ignores non-existent imported files" do
+      css_dir = File.join(temp_dir, "css")
+      output_dir = File.join(temp_dir, "output")
+      FileUtils.mkdir_p([css_dir, output_dir])
+      
+      main_css = File.join(css_dir, "main.css")
+      html_output = File.join(output_dir, "index.html")
+      
+      File.write(main_css, '@import "nonexistent.css"; body { margin: 0; }')
+      
+      css_files = Mint::CssParser.resolve_css_files(main_css, html_output)
+      expect(css_files).to eq(["../css/main.css"])
+    end
+
+    it "only processes .css files" do
+      scss_dir = File.join(temp_dir, "scss")
+      output_dir = File.join(temp_dir, "output")
+      FileUtils.mkdir_p([scss_dir, output_dir])
+      
+      main_scss = File.join(scss_dir, "main.scss")
+      html_output = File.join(output_dir, "index.html")
+      
+      File.write(main_scss, '@import "reset"; body { margin: 0; }')
+      
+      css_files = Mint::CssParser.resolve_css_files(main_scss, html_output)
+      expect(css_files).to eq(["../scss/main.scss"])
+    end
+  end
+
+  describe ".generate_link_tags" do
+    it "generates HTML link tags for CSS files" do
+      css_paths = ["../css/main.css", "../css/reset.css"]
+      
+      html = Mint::CssParser.generate_link_tags(css_paths)
+      
+      expected = <<~HTML.strip
+        <link rel="stylesheet" href="../css/main.css">
+            <link rel="stylesheet" href="../css/reset.css">
+      HTML
+      
+      expect(html).to eq(expected)
+    end
+
+    it "handles empty array" do
+      html = Mint::CssParser.generate_link_tags([])
+      expect(html).to eq("")
+    end
+
+    it "handles single CSS file" do
+      html = Mint::CssParser.generate_link_tags(["styles.css"])
+      expect(html).to eq('<link rel="stylesheet" href="styles.css">')
+    end
+  end
+end

data/spec/plugin_spec.rb

@@ -188,21 +188,21 @@ describe Mint do
   end
 
   # TODO: Document expected document functionality changes related to plugins
-  describe Mint::Document do
-    context "when plugins are registered with Mint" do
-      describe "#content=" do
-        it "applies each registered plugin's before_render filter"
-      end
-
-      describe "#render" do
-        it "applies each registered plugin's after_render filter"
-      end
-
-      describe "#publish!" do
-        it "applies each registered plugin's after_publish filter"
-      end
-    end
-  end
+  # describe Mint::Document do
+  #   context "when plugins are registered with Mint" do
+  #     describe "#content=" do
+  #       it "applies each registered plugin's before_render filter"
+  #     end
+
+  #     describe "#render" do
+  #       it "applies each registered plugin's after_render filter"
+  #     end
+
+  #     describe "#publish!" do
+  #       it "applies each registered plugin's after_publish filter"
+  #     end
+  #   end
+  # end
 
   describe Mint::Plugin do
     # We have to instantiate these plugins in a before block,
@@ -217,7 +217,7 @@ describe Mint do
     describe ".underscore" do
       let(:plugin) { Class.new(Mint::Plugin) }
 
-      it "when anonymous, returns a random identifier"
+      # it "when anonymous, returns a random identifier"
 
       it "when named, returns its name, underscored" do
         expect(plugin).to receive(:name).and_return("EPub")
@@ -255,7 +255,7 @@ describe Mint do
         end
       end
 
-      it "returns a hash of options the plugin can take, including constraints"
+      # it "returns a hash of options the plugin can take, including constraints"
     end
 
     context "plugin callbacks" do
@@ -328,47 +328,47 @@ describe Mint do
           expect(File.exist?("second-half.html")).to be_truthy
         end
 
-        it "allows changes to the style file" do
-          pending "figure out a better strategy for style manipulation"
-          document = Mint::Document.new "content.md", style: "style.css" 
-
-          plugin.instance_eval do
-            def after_publish(document)
-              # I'd like to take document.style_destination_file,
-              # but the current Mint API doesn't allow for this
-              # if we're setting the style via a concrete
-              # stylesheet in our current directory
-              style_source = document.style.source_file
-              style = File.read style_source
-              File.open style_source, "w" do |file|
-                file << style.gsub(/#/, ".")
-              end
-            end
-          end
-
-          document.publish! :plugins => [plugin]
-
-          File.read(document.style.source_file).should =~ /\#container/
-        end
-
-        context "when the output is in the default directory" do
-          it "doesn't allow changes to the document directory" do
-            pending "figuring out the best way to prevent directory manipulation"
-            document = Mint::Document.new "content.md"
-            plugin.instance_eval do
-              def after_publish
-                original = document.destination_directory
-                new = File.expand_path "invalid"
-                FileUtils.mv original, new
-                document.destination = "invalid"
-              end
-
-              expect do
-                document.publish! :plugins => [plugin]
-              end.to raise_error(InvalidPluginAction)
-            end
-          end
-        end
+        # it "allows changes to the style file" do
+        #   pending "figure out a better strategy for style manipulation"
+        #   document = Mint::Document.new "content.md", style: "style.css" 
+
+        #   plugin.instance_eval do
+        #     def after_publish(document)
+        #       # I'd like to take document.style_destination_file,
+        #       # but the current Mint API doesn't allow for this
+        #       # if we're setting the style via a concrete
+        #       # stylesheet in our current directory
+        #       style_source = document.style.source_file
+        #       style = File.read style_source
+        #       File.open style_source, "w" do |file|
+        #         file << style.gsub(/#/, ".")
+        #       end
+        #     end
+        #   end
+
+        #   document.publish! :plugins => [plugin]
+
+        #   File.read(document.style.source_file).should =~ /\#container/
+        # end
+
+        # context "when the output is in the default directory" do
+        #   it "doesn't allow changes to the document directory" do
+        #     pending "figuring out the best way to prevent directory manipulation"
+        #     document = Mint::Document.new "content.md"
+        #     plugin.instance_eval do
+        #       def after_publish
+        #         original = document.destination_directory
+        #         new = File.expand_path "invalid"
+        #         FileUtils.mv original, new
+        #         document.destination = "invalid"
+        #       end
+
+        #       expect do
+        #         document.publish! :plugins => [plugin]
+        #       end.to raise_error(InvalidPluginAction)
+        #     end
+        #   end
+        # end
 
         context "when the output is a new directory" do
           it "allows changes to the document directory" do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mint
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.8.1
 platform: ruby
 authors:
 - David Jacobs
@@ -182,24 +182,21 @@ files:
 - bin/mint
 - bin/mint-epub
 - config/templates/base/style.css
-- config/templates/default/css/style.css
 - config/templates/default/layout.erb
 - config/templates/default/style.css
 - config/templates/garden/layout.erb
 - config/templates/garden/style.css
-- config/templates/newspaper/layout.erb
 - config/templates/nord-dark/layout.erb
 - config/templates/nord-dark/style.css
 - config/templates/nord/layout.erb
 - config/templates/nord/style.css
-- config/templates/protocol/layout.erb
-- config/templates/protocol/style.css
 - config/templates/reset.css
 - config/templates/zen/layout.erb
 - config/templates/zen/style.css
 - lib/mint.rb
 - lib/mint/command_line.rb
 - lib/mint/css.rb
+- lib/mint/css_parser.rb
 - lib/mint/css_template.rb
 - lib/mint/document.rb
 - lib/mint/exceptions.rb
@@ -225,6 +222,7 @@ files:
 - spec/cli/full_workflow_integration_spec.rb
 - spec/cli/publish_workflow_spec.rb
 - spec/cli/template_management_spec.rb
+- spec/css_parser_spec.rb
 - spec/css_spec.rb
 - spec/document_spec.rb
 - spec/helpers_spec.rb
@@ -271,6 +269,7 @@ test_files:
 - spec/cli/full_workflow_integration_spec.rb
 - spec/cli/publish_workflow_spec.rb
 - spec/cli/template_management_spec.rb
+- spec/css_parser_spec.rb
 - spec/css_spec.rb
 - spec/document_spec.rb
 - spec/helpers_spec.rb

data/config/templates/default/css/style.css

@@ -1,205 +0,0 @@
-@import '../reset.css';
-body {
-  font-family: Ubuntu, "Hoefler Text", "Grandesign Neue Serif", Ubuntu, Georgia, FreeSerif, serif, Georgia, serif;
-}
-
-h1, h2 {
-  line-height: 1.3;
-}
-
-h2, h3, h4, h5, h6 {
-  line-height: 22.5px;
-}
-
-h1, h2, h3, h4, h5, h6 {
-  font-family: "Hoefler Text", Garamond, Georgia;
-  font-weight: normal;
-}
-
-h1 {
-  font-size: 22.5px;
-  margin-top: 22.5px;
-  margin-bottom: 22.5px;
-}
-
-h2 {
-  font-size: 18px;
-  margin-top: 33.75px;
-  margin-bottom: 11.25px;
-}
-
-h3 {
-  font-size: 16.5px;
-  margin-top: 39.375px;
-  margin-bottom: 5.625px;
-}
-
-h4 {
-  font-size: 15.75px;
-  margin-top: 19.6875px;
-  margin-bottom: 2.8125px;
-}
-
-h5, h6 {
-  font-size: 15px;
-  margin-top: 19.6875px;
-  margin-bottom: 2.8125px;
-}
-
-ul {
-  list-style-type: square;
-}
-ul ul {
-  list-style-type: circle;
-}
-
-ul, ol {
-  margin: 5.625px 0 0 11.25px;
-  padding-left: 27px;
-}
-ul li p, ol li p {
-  text-indent: 0 !important;
-}
-ul li + li, ol li + li {
-  margin-top: 5.625px;
-}
-
-p {
-  margin: 11.25px 0;
-}
-
-ul + p, ol + p, blockquote + p, pre + p {
-  text-indent: 0;
-}
-
-a:link, a:visited, a:active {
-  color: #cb0018;
-  text-decoration: none;
-}
-a:hover {
-  text-decoration: underline;
-}
-
-code {
-  font-family: Monaco, Menlo, Mensch, Consolas, Monotype, mono;
-  font-style: normal;
-}
-
-pre, blockquote {
-  display: block;
-  margin-left: 22.5px;
-  margin-right: 45px;
-  padding: 7.5px 22.5px;
-  padding-left: 16.875px;
-  white-space: pre;
-}
-pre p, blockquote p {
-  margin: 0;
-  line-height: 1.35;
-}
-
-img {
-  display: block;
-}
-
-@media screen {
-  body {
-    font-size: 15px;
-    line-height: 22.5px;
-    background-color: #666;
-    color: #333;
-  }
-  #container {
-    display: block;
-    border: solid 1px #999;
-    width: 780px;
-    padding: 40px 60px;
-    margin: 11.25px auto;
-    background-color: #fff;
-    box-sizing: border-box;
-    -moz-box-sizing: border-box;
-    -webkit-box-sizing: border-box;
-  }
-  code {
-    font-size: 13.125px;
-  }
-  pre {
-    white-space: pre-wrap;
-    white-space: -moz-pre-wrap;
-    white-space: -o-pre-wrap;
-    word-wrap: break-word;
-  }
-  pre code {
-    font-size: 11.25px;
-  }
-}
-@media print {
-  @page {
-    margin-left: 1in;
-    margin-right: 1in;
-    margin-top: 1in;
-    margin-bottom: 1in;
-  }
-  body {
-    font-size: 12pt;
-    line-height: 15.6pt;
-    width: auto;
-    margin: 0;
-    padding: 0;
-  }
-  code {
-    font-size: 10.5pt;
-  }
-  pre code {
-    font-size: 9pt;
-  }
-  h1, h2, h3, h4, h5, h6, li, blockquote {
-    page-break-inside: avoid;
-  }
-  p {
-    widows: 3;
-    orphans: 3;
-  }
-}
-body {
-  text-rendering: optimizeLegibility;
-}
-
-h1 {
-  font-size: 25.5px;
-  border-bottom: solid 2px #666;
-}
-
-h2 {
-  font-size: 19.5px;
-}
-
-h3 {
-  font-size: 18px;
-  font-style: italic;
-}
-
-h4 {
-  font-variant: small-caps;
-}
-
-h5, h6 {
-  font-weight: bold;
-}
-
-p + p {
-  text-indent: 22.5px;
-}
-
-pre, blockquote {
-  border-left: solid 2px #ddd;
-  background-color: #fdffe8;
-}
-
-blockquote {
-  font-style: italic;
-}
-
-code {
-  font-family: "Ubuntu Mono";
-}

data/config/templates/newspaper/layout.erb

@@ -1,16 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="utf-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1">
-    <link rel="preconnect" href="https://fonts.googleapis.com">
-    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-    <link href="https://fonts.googleapis.com/css2?family=Libre+Baskerville:ital,wght@0,400;0,700;1,400&family=Old+Standard+TT:ital,wght@0,400;0,700;1,400&display=swap" rel="stylesheet">
-    <%= stylesheet_tag %>
-  </head>
-  <body>
-    <main id="container">
-      <div class="newspaper-columns"><%= content %></div>
-    </main>
-  </body>
-</html>

data/config/templates/protocol/layout.erb

@@ -1,9 +0,0 @@
-<!DOCTYPE html>
-<html>
-  <head>
-    <%= stylesheet_tag %>
-  </head>
-  <body>
-    <div id="container"><%= content %></div>
-  </body>
-</html>

data/config/templates/protocol/style.css

@@ -1,25 +0,0 @@
-:root {
-  --screen-font-size: 16px;
-  --screen-line-height: calc(var(--screen-font-size) * 1.3);
-  --screen-unit: var(--screen-line-height);
-
-  --print-font-size: 12pt;
-  --print-line-height: calc(var(--print-font-size) * 1.3);
-  --print-unit: var(--print-line-height);
-
-  --link-color: #cb0018;
-}
-
-@import "../base/style.css";
-
-body {
-  font-family: ScalaSansPro, "Helvetica Neue";
-}
-
-p + h2, p + h3, p + h4, p + h5, p + h6 {
-  margin-top: calc(var(--screen-unit) * 1.5);
-}
-
-p {
-  line-height: 1.25;
-}