bulmatown 1.0.2 → 1.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 491df0f4017115c834e573c2dbe73c9a4b7b06b723f68a5fec4528f241d67ee6
-  data.tar.gz: f64c37e0dd7372f115a3136c18431ffc9d1d72a319ef02ac005afe97a80e2780
+  metadata.gz: 3fdd94560f3a3ad5345ec3051e9ebef9102668ed9f099f9067bde8620dc2373b
+  data.tar.gz: af96dd52379a062027637d177b5ab2c1f3fdeef3ed02a410171125ad32c25e1e
 SHA512:
-  metadata.gz: ada1ec76386a705994c49455f0630fde74977cba340db71ea1248a4a37441b5a45b225fb8bb85ef55eafdf1c0e6176e07e2fc1a3f3558183f8214eec40f40abc
-  data.tar.gz: 313896cf57d651b83f1abf8355288ca40cabcd173c464170d9cd101ae1b4491faa045dbef93b024691555d0351de116febcb91bd4291643e5e57c22df881c82b
+  metadata.gz: e1a9784c62e29052f7d7ec2694cd5ae48ead466a5fedbf312c9be6960bfbc1feebb45c4c854d3f54922c73574c42d052cb29eed22671367f20903376c09d8f5f
+  data.tar.gz: 38436adc38ea4da59894c7f666f87969fe0eb865f584c989d8f0e79acb1c32c23ed81370ef67b1b4bef89b1eed91041baf99e374e06bcb480e1704e2c5e85093

data/CHANGELOG.md

@@ -1,7 +1,14 @@
 # master
 
-* Use this file to keep track of plugin updates
+# 1.0.7 / 2020-10-19
 
-# 0.1.0 / 2020-05-01
+* Change layout files to .liquid extension for better compatibility with Bridgetown 0.18 template engine configurations
 
-* First version
+# 1.0.6 / 2020-10-02
+
+* Remove red border from error syntax #3
+* Remove italics from syntax highlighting #2
+
+# 1.0.5 / 2020-06-27
+
+* Wide release

data/README.md

@@ -1,53 +1,117 @@
-# Sample plugin for Bridgetown
+# Bulmatown
+## A Bulma CSS starter theme for Bridgetown.
 
-_NOTE: This isn't a real plugin! Copy this sample code and use it to create your own Ruby gem! [Help guide here…](https://www.bridgetownrb.com/docs/plugins)_ 😃
+[Bulma](https://bulma.io) is a clean, modern CSS framework for rapid prototyping of content-focused websites. Use this theme to start using Bulma in your new [Bridgetown](https://www.bridgetownrb.com) site quickly, while preserving _all_ of the advanced customization possibilities as if you configured Bulma manually.
 
-A Bridgetown plugin to [fill in the blank]…
+**[LIVE DEMO](https://bulmatown.vercel.app)**
+
+![Bulmatown Example](https://res.cloudinary.com/mariposta/image/upload/c_thumb,w_900/v1593195961/bulmatown/bulmatown-example.jpg)
 
 ## Installation
 
-Run this command to add this plugin to your site's Gemfile:
+Bulmatown requires Bridgetown v0.15 or later
+
+To install Bulmatown while creating a new Bridgetown site:
+
+```sh
+bridgetown new mysite -a https://github.com/whitefusionhq/bulmatown
+```
+
+Or to add it to your existing Bridgetown site:
 
-```shell
-$ bundle add my-awesome-plugin -g bridgetown_plugins
+```sh
+bundle exec bridgetown apply https://github.com/whitefusionhq/bulmatown
 ```
 
+A few other (optional) plugins you might be interested in installing:
+
+* [SEO Tag](https://github.com/bridgetownrb/bridgetown-seo-tag)
+* [Atom Feed](https://github.com/bridgetownrb/bridgetown-feed)
+* Check out [Bridgetown community automations](https://github.com/bridgetownrb/automations) for some extra goodies like PurgeCSS, Swup page transitions, a test suite, and more!
+
 ## Usage
 
-The plugin will…
+The installation process will prompt you to configure your site to use Bulmatown automatically. However, if you decline those changes, you can inspect the [example site](https://github.com/whitefusionhq/bulmatown/tree/master/example) in this repository.
 
-### Optional configuration options
+Bulmatown comes with a few color variations out of the box. You can use the `theme_variation` Sass variable to switch the variation. For example:
 
-The plugin will automatically use any of the following metadata variables if they are present in your site's `_data/site_metadata.yml` file.
+```scss
+// frontend/styles/index.scss
 
-…
+$theme_variation: rust;
 
-## Testing
+@import "~bulmatown/frontend/styles"
+```
 
-* Run `bundle exec rspec` to run the test suite
-* Or run `script/cibuild` to validate with Rubocop and test with rspec together.
+The available options are:
 
-## Contributing
+* `default`
+* `rust`
+* `fuchsia`
+* `fineart`
 
-1. Fork it (https://github.com/username/my-awesome-plugin/fork)
-2. Clone the fork using `git clone` to your local development machine.
-3. Create your feature branch (`git checkout -b my-new-feature`)
-4. Commit your changes (`git commit -am 'Add some feature'`)
-5. Push to the branch (`git push origin my-new-feature`)
-6. Create a new Pull Request
+Speaking of Sass variables, you can put all your custom Bulma variables right before the `@import` statement and Bulma will pick up all the changes. You can even override any of the variables defined by Bulmatown out-of-the-box. [Read the Bulma documentation for more information.](https://bulma.io/documentation/)
 
-----
+### Hero Banners and Images
 
-## Releasing (you can delete this section in your own plugin repo)
+Bulmatown will automatically look for `image` front matter variables in your pages and documents and display those in the hero banners and in the card component for post previews. Check out the [bridgetown-cloudinary](https://github.com/bridgetownrb/bridgetown-cloudinary) plugin for an easy way to add advanced image asset handling to your site.
 
-To release a new version of the plugin, simply bump up the version number in both `version.rb` and
-`package.json`, and then run `script/release`. This will require you to have a registered account
-with both the [RubyGems.org](https://rubygems.org) and [NPM](https://www.npmjs.com) registries.
-You can optionally remove the `package.json` and `frontend` folder if you don't need to package frontend
-assets for Webpack.
+If you wish, you can alter which variable is loaded for the cards and social embeds vs. the hero banners using metadata:
+
+```yaml
+# src/_data/site_metadata.yml
+bulmatown_theme:
+  image_sizes:
+    embed: image
+    hero: image_hero
+```
 
-If you run into any problems or need further guidance, please check out our [Bridgetown community resources](https://www.bridgetownrb.com/docs/community)
-where friendly folks are standing by to help you build and release your plugin or theme.
+In addition, for a fun way to add some sparkle to a hero banner with an image background, you can put `rainbow_hero: true` in your front matter to display a nice colorful gradient.
+
+## Authors
+
+To show author information at the top of a blog post, add `authors.yml` to your data folder. For example:
+
+```yaml
+# src/_data/authors.yml
+jared:
+  name: Jared White
+  avatar: /images/jared-white-avatar.jpg
+  twitter: jaredcwhite
+  website: https://jaredwhite.com
+```
 
-**NOTE:** make sure you add the `bridgetown-plugin` [topic](https://github.com/topics/bridgetown-plugin) to your
-plugin's GitHub repo so the plugin or theme will show up on [Bridgetown's official Plugin Directory](https://www.bridgetownrb.com/plugins)! (There may be a day or so delay before you see it appear.)
+Then simply add `author: jared` to your post's front matter.
+
+This will link to an `/authors/<authorname>` URL. You can create a page at that URL manually, or you can auto-generate author archives using a Prototype Page. ([See this example file.](https://github.com/whitefusionhq/bulmatown/blob/master/example/src/authors/author.html))
+
+## Overriding Layout Templates and Components
+
+If you ever find yourself needing to override one or more of the layout templates or Liquid components provided by Bulmatown, you can use the `bridgetown plugins cd` command to drill down into the gem and copy files out to your own site. For example:
+
+```sh
+# copy the layouts folder:
+
+bundle exec bridgetown plugins cd Bulmatown/layouts
+
+cp -r bulmatown $BRIDGETOWN_SITE/src/_layouts
+exit
+
+# copy the components folder:
+
+bundle exec bridgetown plugins cd Bulmatown/components
+
+cp -r bulmatown $BRIDGETOWN_SITE/src/_components
+exit
+```
+
+Then you can go to the `bulmatown` folder in your layouts or components folders and make the changes from there. Or instead of wholesale copying over `bulmatown` entirely, you can pick and choose which files you want to copy.
+
+## Contributing
+
+1. Fork it (https://github.com/whitefusionhq/bulmatown/fork)
+2. Clone the fork using `git clone` to your local development machine.
+3. Create your feature branch (`git checkout -b my-new-feature`)
+4. Commit your changes (`git commit -am 'Add some feature'`)
+5. Push to the branch (`git push origin my-new-feature`)
+6. Create a new Pull Request

data/bridgetown.automation.rb

@@ -1,8 +1,17 @@
+# Thanks to https://github.com/ParamagicDev for a bunch of the smarts in this
+# automation :)
+
 add_bridgetown_plugin "bulmatown"
 add_bridgetown_plugin "bridgetown-quick-search"
-add_yarn_for_gem "bulmatown"
+
+# 0.15 bug! :( can't use this:
+#add_yarn_for_gem "bulmatown"
+
+gem_version = (`bundle info bulmatown`).match(/\*.*\((.*?)\)/)[1]
+run "yarn add bulmatown@#{gem_version}"
 
 require 'fileutils'
+require 'shellwords'
 
 unless Dir.exist? "frontend/fonts"
   FileUtils.mkdir_p "frontend/fonts"
@@ -12,18 +21,77 @@ run "cp node_modules/fork-awesome/fonts/* frontend/fonts"
 
 javascript_import 'import Bulmatown from "bulmatown"'
 
-if ask "The Bulmatown theme can update layout and page templates in your site to use the theme. Would you like to continue?"
-  layout_tmpl = ->(tmpl_name) do
-    <<~HTML
-      ---
-      layout: bulmatown/#{tmpl_name}
-      ---
-      
-      {{ content }}
-    HTML
+# *** Set up remote repo pull
+
+# Dynamically determined due to having to load from the tempdir
+@current_dir = File.expand_path(__dir__)
+
+# If its a remote file, the branch is appended to the end, so go up a level
+ROOT_PATH = if __FILE__ =~ %r{\Ahttps?://}
+              File.expand_path('../', __dir__)
+            else
+              File.expand_path(__dir__)
+            end
+
+DIR_NAME = File.basename(ROOT_PATH)
+
+# DIR_NAME = 'bulmtatown'
+GITHUB_PATH = "https://github.com/whitefusionhq/#{DIR_NAME}.git"
+
+# Copied from: https://github.com/mattbrictson/rails-template
+# Add this template directory to source_paths so that Thor actions like
+# copy_file and template resolve against our source files. If this file was
+# invoked remotely via HTTP, that means the files are not present locally.
+# In that case, use `git clone` to download them to a local temporary dir.
+def add_template_repository_to_source_path
+  if __FILE__ =~ %r{\Ahttps?://}
+    require 'tmpdir'
+
+    source_paths.unshift(tempdir = Dir.mktmpdir(DIR_NAME + '-'))
+    at_exit { FileUtils.remove_entry(tempdir) }
+    run("git clone --quiet #{GITHUB_PATH.shellescape} #{tempdir.shellescape}")
+
+    if (branch = __FILE__[%r{#{DIR_NAME}/(.+)/bridgetown.automation.rb}, 1])
+      Dir.chdir(tempdir) { system("git checkout #{branch}") }
+      @current_dir = File.expand_path(tempdir)
+    end
+  else
+    source_paths.unshift(DIR_NAME)
   end
-  create_file "src/_layouts/home.html", layout_tmpl(:home)
-  create_file "src/_layouts/page.html", layout_tmpl(:page)
-  create_file "src/_layouts/post.html", layout_tmpl(:post)
+end
+
+if yes? "The Bulmatown installer can update styles, layouts, and page templates to use the new theme. You'll have the option to type 'a' to overwrite all existing files or 'd' to inspect each change. Would you like to proceed? (Y/N)"
+  add_template_repository_to_source_path
 
+  create_file "frontend/styles/index.scss", '@import "~bulmatown/frontend/styles"'
+  
+  copy_file "example/src/_layouts/home.html", "src/_layouts/home.html"
+  copy_file "example/src/_layouts/page.html", "src/_layouts/page.html"
+  copy_file "example/src/_layouts/post.html", "src/_layouts/post.html"
+
+
+  gsub_file "src/_layouts/default.html", '{% render "footer", ', '{% render "footer", url: site.url, '
+
+  copy_file "example/src/index.md", "src/index.md"
+  copy_file "example/src/posts.md", "src/posts.md"
+  copy_file "example/src/404.html", "src/404.html"
+  
+  copy_file "example/src/_components/navbar.liquid", "src/_components/navbar.liquid"
+  copy_file "example/src/_components/footer.liquid", "src/_components/footer.liquid"
+
+  inject_into_file "bridgetown.config.yml", "pagination:\n  enabled: true\n", after: "permalink: pretty\n"
 end
+
+twitter = ask "Do you have a Twitter handle? If so, enter it here, otherwise type 'no'"
+
+if twitter != "" && twitter != "no"
+  append_to_file "src/_data/site_metadata.yml" do
+    <<~YAML
+
+      twitter: #{twitter}
+
+    YAML
+  end
+end
+
+say_status :bulmatown, "Theme installation complete! Enjoy your fresh new design :)"

data/bulmatown.gemspec

@@ -11,7 +11,7 @@ Gem::Specification.new do |spec|
   spec.homepage      = "https://github.com/whitefusionhq/bulmatown"
   spec.license       = "MIT"
 
-  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r!^(test|script|spec|features|frontend)/!) }
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r!^(test|script|spec|features|frontend|example)/!) }
   spec.test_files    = spec.files.grep(%r!^spec/!)
   spec.require_paths = ["lib"]
   spec.metadata      = { "yarn-add" => "bulmatown@#{Bulmatown::VERSION}" }

data/components/bulmatown/hero.scss

@@ -6,6 +6,7 @@ $gradient-bottom-right: transparentize(lighten(saturate(adjust-hue($dark, 10deg)
 .hero {
   background-size: cover;
   background-position: center center;
+  overflow: hidden;
   --overlay-center: #{$center};
   --overlay-top-left: #{$gradient-top-left};
   --overlay-bottom-right: #{$gradient-bottom-right};
@@ -21,6 +22,15 @@ $gradient-bottom-right: transparentize(lighten(saturate(adjust-hue($dark, 10deg)
     background-image: linear-gradient(141deg, var(--overlay-top-left) 0%, var(--overlay-center) 65%, var(--overlay-bottom-right) 100%);
   }
 
+  .container.is-fluid {
+    @include mobile {
+      margin-left: 0;
+      margin-right: 0;
+      padding-left: 0;
+      padding-right: 0;
+    }
+  }
+
   .title {
     text-shadow: 0px 2px 3px transparentize($black, 0.5);
   }

data/components/bulmatown/navbar.scss

@@ -18,6 +18,10 @@
     }
   }
 
+  .navbar-brand {
+    font-weight: bold;
+  }
+
   .search-item input {
     font-size: 1em;
     height: 1.5em;

data/lib/bulmatown.rb

@@ -6,6 +6,5 @@ require "bulmatown/version"
 Bridgetown::PluginManager.new_source_manifest(
   origin: Bulmatown,
   components: File.expand_path("../components", __dir__),
-  content: File.expand_path("../content", __dir__),
   layouts: File.expand_path("../layouts", __dir__)
 )

data/lib/bulmatown/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Bulmatown
-  VERSION = "1.0.2"
+  VERSION = "1.0.7"
 end

data/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bulmatown",
   "description": "A Bulma CSS starter theme for Bridgetown",
-  "version": "1.0.2",
+  "version": "1.0.7",
   "main": "frontend/javascript/index.js",
   "repository": {
     "type": "git",

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bulmatown
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.0.7
 platform: ruby
 authors:
 - Jared White
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-06-26 00:00:00.000000000 Z
+date: 2020-10-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bridgetown
@@ -139,45 +139,9 @@ files:
 - components/bulmatown/navbar.liquid
 - components/bulmatown/navbar.scss
 - components/bulmatown/pagination.liquid
-- content/bulmatown/example_page.md
-- content/bulmatown/train-on-rails.jpeg
-- example/.gitignore
-- example/Gemfile
-- example/bridgetown.config.yml
-- example/frontend/fonts/forkawesome-webfont.eot
-- example/frontend/fonts/forkawesome-webfont.svg
-- example/frontend/fonts/forkawesome-webfont.ttf
-- example/frontend/fonts/forkawesome-webfont.woff
-- example/frontend/fonts/forkawesome-webfont.woff2
-- example/frontend/javascript/index.js
-- example/frontend/styles/index.scss
-- example/package.json
-- example/plugins/builders/.keep
-- example/plugins/site_builder.rb
-- example/src/404.html
-- example/src/_components/footer.liquid
-- example/src/_components/head.liquid
-- example/src/_components/navbar.liquid
-- example/src/_data/authors.yml
-- example/src/_data/site_metadata.yml
-- example/src/_layouts/default.html
-- example/src/_layouts/home.html
-- example/src/_layouts/page.html
-- example/src/_layouts/post.html
-- example/src/_posts/2020-06-13-this-is-groovy.md
-- example/src/_posts/2020-06-13-welcome-to-bridgetown.md
-- example/src/about.md
-- example/src/favicon.ico
-- example/src/images/jared-white-avatar.jpg
-- example/src/index.md
-- example/src/posts.md
-- example/start.js
-- example/sync.js
-- example/webpack.config.js
-- example/yarn.lock
-- layouts/bulmatown/homepage.html
-- layouts/bulmatown/page.html
-- layouts/bulmatown/post.html
+- layouts/bulmatown/homepage.liquid
+- layouts/bulmatown/page.liquid
+- layouts/bulmatown/post.liquid
 - lib/bulmatown.rb
 - lib/bulmatown/version.rb
 - package.json
@@ -186,7 +150,7 @@ homepage: https://github.com/whitefusionhq/bulmatown
 licenses:
 - MIT
 metadata:
-  yarn-add: bulmatown@1.0.2
+  yarn-add: bulmatown@1.0.7
 post_install_message: 
 rdoc_options: []
 require_paths:

data/content/bulmatown/example_page.md

@@ -1,8 +0,0 @@
----
-layout: default
-title: Example Page
----
-
-If all goes well, this page will be accessible as [`{{ page.url }}`]({{ page.url }}), and you will see a photo of a train:
-
-![Train on Rails]({{ "/bulmatown/train-on-rails.jpeg" | relative_url }})