jekyll-tailwindcss 0.1.0-x64-mingw32 → 0.2.0-x64-mingw32

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ccb6520ae45fdc4a106d15bf12fdcaa0ccb3f35da68b6cedf187f7074949898d
-  data.tar.gz: fd4dee767a3e28f55836a6a97678939029160875c411738f4846a7b209bb8ed9
+  metadata.gz: 27b0657f16878adc0235dfc96e54d1428baf56f3ece70dcde68effbe027acecc
+  data.tar.gz: 737ef5f35155cae8034ff51f0b6b92b13c74fd0bd552afe54f6fcb82408ecad5
 SHA512:
-  metadata.gz: 3f2ddb7dcd329a150a804e0e2683715071302405fb335471d15360131278010432aad09c7b99ed81cbbc3ad7ea7164a5e1ef9a29d20c1c6e840a7ebf1180ccb7
-  data.tar.gz: 5b71d526abff5186ffbe89b0af6858dd23e3102bac13040beebe08627f5e6ab51b6f982013d29cb3989c09ce62387d8ab19e772c80c28ccd851c2e023444fbd9
+  metadata.gz: 0ac78751ac65371fc794f0085bb0f841815e3edc6fd3aeec7c7888cba44434ae6bdee460325393f286d1a08f4e8f56aa52268448bd48bf8681b64dc2088ca929
+  data.tar.gz: 460464aa480bc6a860d12259314853b35a2d3f30c8193d97dadccec423bb8413498691a06a0c64aba25bc309d463e13f828c6ca61019350aa033a3755e16cb92

data/README.md

@@ -1,53 +1,152 @@
 # Jekyll::Tailwindcss
 
+Bring the fun of building with TailwindCSS into your Jekyll project (without any JavaScript)
+
+**TL;DR** This gem borrows *heavily* from github.com/rails/tailwindcss-rails to provide platform-specific tailwind executables and provide a smooth developer experience in Jekyll projects
+
+Much like the Rails gem, this gem wraps [the standalone executable version](https://tailwindcss.com/blog/standalone-cli) of the Tailwind CSS v3 framework. It installs these as platform-specific executables, so there are separate underlying gems per platform, but the correct gem will automatically be picked for your platform.
+
+> “Because building a great jekyll site shouldn’t require a `node_modules` folder
+
 ## Installation
 
 Install the gem in your jekyll project's Gemfile by executing the following:
 
-```sh
-$ bundle add jekyll-tailwindcss
+```
+bundle add jekyll-tailwindcss
 ```
 
-Add it to your list of jekyll-plugins
+Add the plugin to your list of jekyll plugins in `_config.yml`
 
 ```yml
 plugins:
   - jekyll-tailwindcss
 ```
 
+## Tailwind Configuration
+
+This plugin requires you to have a tailwind configuration file (`tailwind.config.js`) at the root level of your project, which can be generated by running:
+
+```
+bundle exec tailwindcss init
+```
+
+Tailwind will include the CSS for the classes found in `content` directories. For most jekyll sites, this would work well.
+
+```js
+  content: [
+    "./_includes/**/*.{html,liquid}",
+    "./_layouts/**/*.{html,liquid}",
+    "./_pages/*.{html,liquid}",
+    "./_posts/**/*.md",
+    "./*.md",
+    "./*.html",
+  ],
+```
+
+Learn more at https://tailwindcss.com/docs/configuration
+
+
+
 ## Usage
 
-Currently, this gem assumes you have several files in your project:
+```sh
+bundle exec jekyll serve # or build
+```
+
+Any `*.css` file processed by jekyll [^1] that contains the `@tailwind` [directive](https://tailwindcss.com/docs/functions-and-directives#config) will now be converted through the Tailwind CLI.
+
+[^1]: Jekyll will process any file that begins with yaml [frontmatter](https://jekyllrb.com/docs/front-matter/)
+
+### Examples
 
-**`tailwind.config.js`**
 
-This is the tailwind configuration for your project. Learn [more here](https://tailwindcss.com/docs/configuration).
+A CSS file with frontmatter and `@tailwind` directives:
 
-**`_input.css`**
+```css
+/* assets/css/styles.css */
+---
+# This yaml frontmatter is required for jekyll to process the file
+---
 
-This file will contain your tailwind directives and any custom classes. Read more in the [docs here](https://tailwindcss.com/docs/functions-and-directives#config)
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
 
-**`*.tailwindcss`**
+.btn {
+  @apply font-bold py-2 px-4 rounded !important;
+}
+```
+
+will be converted to
+
+```css
+/* _site/assets/css/styles.css */
 
-Any files with this extension (and contain [frontmatter](https://jekyllrb.com/docs/front-matter/)) will be processed by tailwind, and converted into a corresponding filename with a `.css` extension.
+/*
+ * Tailwind generated CSS
+ */
+```
 
-For instance, `assets/css/styles.tailwindcss` will convert to `_site/assets/css/styles.css`
 
 
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+To install this gem on your local machine, run `bundle exec rake install`.
+
+### Updating to the latest upstream tailwindcss version
+
+Update `lib/tailwindcss/upstream.rb` with the upstream version.
+
+Run `bundle exec rake clobber` and then `bundle exec rake download` to ensure the tailwindcss binaries can be downloaded and you have the correct versions on the local disk.
+
+
+## Testing this gem
+
+### Running the test suite
+
+The unit tests are run with `bundle exec rspec`
+
+There is an additional integration test which runs in CI, `spec/integration/user_journey_test.sh` which you may also want to run.
+
+
+### Testing in a Jekyll project
+
+If you want to test modifications to this gem, you must run `rake download` once to download the upstream `tailwindcss` executables.
+
+Then you can point your Jekyll project's `Gemfile` at the local version of the gem as you normally would:
+
+``` ruby
+gem "jekyll-tailwindcss", path: "/path/to/jekyll-tailwindcss"
+```
+
+### Cutting a release
+
+- bump the version
+  - [ ] update `lib/jekyll-tailwindcss/version.rb`
+  - [ ] update `CHANGELOG.md`
+  - [ ] commit and create a git tag
+- build the native gems:
+  - [ ] `bundle exec rake clobber` to clean up possibly old tailwindcss executables
+  - [ ] `bundle exec rake package`
+- push
+  - [ ] `for g in pkg/*.gem ; do gem push $g ; done`
+  - [ ] `git push`
+- announce
+  - [ ] create a release at https://github.com/vormwald/jekyll-tailwindcss/releases
 
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/vormwald/jekyll-tailwindcss. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/vormwald/jekyll-tailwindcss/blob/main/CODE_OF_CONDUCT.md).
 
+
+
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
 
 ## Code of Conduct
 
-Everyone interacting in the Jekyll::Tailwindcss project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/vormwald/jekyll-tailwindcss/blob/main/CODE_OF_CONDUCT.md).
+Everyone interacting in the Jekyll::Tailwindcss project's codebases, issue trackers, chat rooms, and mailing lists is expected to follow the [code of conduct](https://github.com/vormwald/jekyll-tailwindcss/blob/main/CODE_OF_CONDUCT.md).

data/lib/jekyll/converters/tailwindcss.rb

@@ -1,3 +1,5 @@
+require "open3"
+
 module Jekyll
   module Converters
     class Tailwindcss < Converter
@@ -5,20 +7,43 @@ module Jekyll
       priority :low
 
       def matches(ext)
-        /^\.tailwindcss$/i.match?(ext)
+        /^\.css$/i.match?(ext)
       end
 
       def output_ext(ext)
-        ".css"
+        # At this point, we will have a CSS file
+        ext
       end
 
       def convert(content)
+        return content unless /@tailwind/i.match?(content)
+
         dev_mode = Jekyll.env == "development"
         Jekyll.logger.info "Jekyll Tailwind:", "Generating #{dev_mode ? "" : "minified "}CSS"
 
         compile_command = ::Tailwindcss::Commands.compile_command(debug: dev_mode).join(" ")
 
-        `#{compile_command}`
+        output, error = nil
+        Open3.popen3(tailwindcss_env_options, compile_command) do |stdin, stdout, stderr, _wait_thread|
+          stdin.write content # write the content of *.tailwindcss to the tailwindcss CLI as input
+          stdin.close
+          error = stderr.read
+          output = stdout.read
+        end
+        Jekyll.logger.warn "Jekyll Tailwind:", error unless error.nil?
+
+        output
+      rescue => e
+        Jekyll.logger.error "Jekyll Tailwind:", e.message
+        content
+      end
+
+      private
+
+      def tailwindcss_env_options
+        # Without this ENV you'll get a warning about `Browserslist: caniuse-lite is outdated`
+        # Since we're using the CLI, we can't update the data, so we ignore it.
+        {"BROWSERSLIST_IGNORE_OLD_DATA" => "1"}
       end
     end
   end

data/lib/jekyll-tailwindcss/version.rb

@@ -2,6 +2,6 @@
 
 module Jekyll
   module Tailwindcss
-    VERSION = "0.1.0"
+    VERSION = "0.2.0"
   end
 end

data/lib/tailwindcss/commands.rb

@@ -76,8 +76,8 @@ module Tailwindcss
       def compile_command(debug: false, **kwargs)
         command = [
           executable(**kwargs),
-          "-i", "./_input.css",
-          "-c", "./tailwind.config.js"
+          "--input", "-",
+          "--config", "./tailwind.config.js"
         ]
 
         command << "--minify" unless debug

metadata

@@ -1,16 +1,16 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-tailwindcss
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: x64-mingw32
 authors:
 - Mike Vormwald
-autorequire:
+autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-04-16 00:00:00.000000000 Z
+date: 2024-04-17 00:00:00.000000000 Z
 dependencies: []
-description:
+description: 
 email:
 - mvormwald@gmail.com
 executables:
@@ -34,7 +34,7 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://github.com/vormwald/jekyll-tailwindcss
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -49,8 +49,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.20
-signing_key:
+rubygems_version: 3.5.7
+signing_key: 
 specification_version: 4
 summary: Integrate Tailwind CSS into your Jekyll site.
 test_files: []