nesta 0.14.0 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e14e3ed99700277225c068df787864f52f19385f08469d91bf1a8f4073e24568
-  data.tar.gz: 84e9c0fb31ba8b380b0ce86f9edc6f660fd8a8f9474ad28400e7c921fd745c01
+  metadata.gz: f57754ef13ef4b4533c03ab454b2114fb35d3e168d20107c1fb39941d6af4b92
+  data.tar.gz: 9aa4a9b8e0715d77c1ec515a114f63827e8a117e1f3b807755a59d0c0eba0c45
 SHA512:
-  metadata.gz: e39c4ada00a1ac3b4be18b6887240a670d4f1c050023771dc71fa6703bbb315bac54f959053788dc7018761a5bfc3e1fe387486e856629a785ae3098c8203704
-  data.tar.gz: 4da9e195b6679df8c9f2c9ec3a07b780409b2a68f6cffe66feab9276a0ee90b987b7221a13d5f363c0b700c3d5b8d956e9b6a5753a0aa81058e1e10458ced75f
+  metadata.gz: effa2dcecf9d3ed0de395102c893d9f1571171b4bc4d63968911f3538c27bd8ef15692df2586239e2986d1b32e4bd4ef23513245c2cd89d0d159df3d9bf79903
+  data.tar.gz: c0f318224b4f70322af4d30b55e517b1d790b3087129eb0601d434eabf79cc65e3b8ae24262f7300812a0414dd5402d2969d0f11be1f5d0516afe1ad7474d27c

data/.github/workflows/tests.yml

@@ -8,10 +8,10 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        ruby: ["2.7", "3.0", "3.1", "3.2", "head"]
+        ruby: ["3.0", "3.1", "3.2", "3.3"]
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby }}

data/{CHANGES → CHANGELOG.md}

@@ -1,4 +1,43 @@
-= 0.14.0 / (23 March 2023)
+# Changelog
+
+## 0.16.0 (11 April 2024)
+
+ * Update Google Analytics JS code to GA4. (Matthew Bass)
+
+ * Upgrade to Sinatra 3.1. (なつき)
+
+ * Tilt renderers (e.g. for Markdown, Haml, or Textile) are now configurable.
+   See #146 for details. (Graham Ashton)
+
+ * Drop support for Ruby 2.7, which is no longer supported by Nokogiri,
+   which is one of Nesta's dependencies. This is understandable; Ruby
+   2.7 reached end-of-life in March 2023. (Graham Ashton)
+
+ * Bug fix: Config variables that were defined for an environment (test,
+   dev, production), but for which there was no default, were always read
+   as nil. (Matthew Bass)
+
+## 0.15.0 (11 July 2023)
+
+ * Upgrade to Sinatra 3. (Graham Ashton)
+
+ * The `models.rb` file has been long and unnecessarily hard to navigate
+   for too long. It has been split up into multiple files, one for each
+   class. (Graham Ashton, suggested by Lilith River)
+
+ * Remove support for the BlueCloth markdown library. Nesta uses Tilt
+   for rendering Markdown, and BlueCloth support has been removed in
+   Tilt 2.2.0. See rtomayko/tilt#382 for details.
+
+   If your site uses BlueCloth, remove your call to `Tilt.prefer`,
+   and Nesta will use its default Markdown processor. See Nesta's docs
+   on [configuring the Markdown processor] for more details.
+
+   [configuring the Markdown processor]: https://nestacms.com/docs/creating-content/changing-the-markdown-processor
+
+   (Graham Ashton)
+
+## 0.14.0 (23 March 2023)
 
  * Nesta can now be used as a Static Site Generator (SSG) with its new
    `nesta build` command! Server Side Rendering (SSR) is still supported,
@@ -71,7 +110,7 @@
  * The breadcrumb_label helper method (deprecated in 0.9.3) has been removed.
    (Graham Ashton)
 
-= 0.13.0 / (28 September 2022)
+## 0.13.0 (28 September 2022)
 
  * Update dependencies in order to support Ruby 3.0 and above.
    (Graham Ashton)
@@ -97,7 +136,7 @@
  * Stopped the test suite from executing external commands during tests.
    (Graham Ashton)
 
-= 0.12.0 / (30 June 2020)
+## 0.12.0 (30 June 2020)
 
  * Upgrade to Sinatra 2 and Rack 2. (Graham Ashton)
 
@@ -113,12 +152,12 @@
  * Stop running the test suite under Ruby 2.3 and 2.4, both of which
    have reached end-of-life. (Graham Ashton)
 
-= 0.11.1 / (26 March 2015)
+## 0.11.1 (26 March 2015)
 
  * Tighten dependency on Tilt, as version 2.x is incompatible.
    (Graham Ashton)
 
-= 0.11.0 / (16 March 2015)
+## 0.11.0 (16 March 2015)
 
  * Allow Haml pages to use the built-in Markdown filter again, by
    including the haml-contrib gem.
@@ -161,7 +200,7 @@
 
  * Support for Ruby 2.2. (Graham Ashton)
 
-= 0.10.0 / (25 April 2014)
+## 0.10.0 (25 April 2014)
 
  * Upgraded the default theme to a responsive design, using Google's
    Roboto Slab web font. (Graham Ashton)
@@ -285,7 +324,7 @@
    this list. See GitHub for the full list of commits.
    https://github.com/gma/nesta/compare/v0.9.13...v0.10.0
 
-= 0.9.13 / (3 March 2012)
+## 0.9.13 (3 March 2012)
 
  * The nesta script has a new command; edit. You can pass it the path
    to a file within your content/pages folder and it will open the file
@@ -343,9 +382,9 @@
  * Bug fix: Summaries on Haml pages were not marked up as paragraphs.
    See #75.
 
-= 0.9.12 / (Released then pulled, due to rubygems [still] being a total mess)
+## 0.9.12 (Released then pulled, due to rubygems [still] being a total mess)
 
-= 0.9.11 / (22 September 2011)
+## 0.9.11 (22 September 2011)
 
  * Use Tilt to render the Markdown, Textile and Haml in content/pages.
    RDiscount is now the default Markdown processor. To continue using
@@ -372,7 +411,7 @@
    within the content folder by crafting a relative path containing
    the string '../' (Louis Nyffenegger).
 
-= 0.9.10 / (9 September 2011)
+## 0.9.10 (9 September 2011)
 
  * Load Nesta plugins from gems. Any gem whose name begins with
    nesta-plugin- can be used in a project by adding it to the project's
@@ -390,7 +429,7 @@
    the Sass rendering engine by default, which allows it to find .sass
    files within the gem if no matching files are found locally.
 
-= 0.9.9 / (24 August 2011)
+## 0.9.9 (24 August 2011)
 
  * Bug fix: What a debacle this is turning into. The new Nesta::Env
    class must be required before the code in 'nesta/app' is loaded.
@@ -398,7 +437,7 @@
    via config.ru. Running Nesta any other way lead to an immediate
    crash.
 
-= 0.9.8 / (22 August 2011)
+## 0.9.8 (22 August 2011)
 
  * Bug fix: The Sinatra app's root directory wasn't set which meant
    that Nesta couldn't always find the ./public directory (such as when
@@ -409,12 +448,12 @@
    Nesta::Env class. In 0.9.6 I forgot to actually set Nesta::App.root
    as well, which was a big mistake. Whoops.
 
-= 0.9.7 / (19 August 2011)
+## 0.9.7 (19 August 2011)
 
  * No code changes from 0.9.6; version number increased to allow new gem
    to be deployed to rubygems.org.
 
-= 0.9.6 / (18 August 2011) [never released due to packaging bug]
+## 0.9.6 (18 August 2011) [never released due to packaging bug]
 
  * Nesta no longer cares whether you write your Sass stylesheets in the
    original indented Sass format or the default SCSS syntax (which is a
@@ -440,7 +479,7 @@
    Nesta::App.root would be before requiring nesta/app. Fixed by
    creating Nesta::Env and moving root to there instead.
 
-= 0.9.5 / (1 May 2011)
+## 0.9.5 (1 May 2011)
 
  * Added --version option to nesta command (Christopher Lindblom).
 
@@ -466,14 +505,14 @@
    within Haml templates. See https://github.com/gma/nesta/pull/18
    (Carl Furrow).
 
-= 0.9.4 / 18 February 2011
+## 0.9.4 (18 February 2011)
 
  * Updated the link colours in the default theme.
 
  * Set the default encoding to UTF-8. Without it Heroku would sometimes
    fail to render pages (issue 14).
 
-= 0.9.3 / 18 January 2011
+## 0.9.3 (18 January 2011)
 
  * The route and view for serving the home page (/) has been removed,
    and the home page must now be created as an index page in
@@ -515,7 +554,7 @@
  * Bug fix: Don't output empty <li> tags for nested submenus that are
    beneath the requested number of levels.
 
-= 0.9.2 / 10 January 2011
+## 0.9.2 (10 January 2011)
 
  * Made the FileModel.metadata method public, to allow for custom
    metadata at the top of each page. (Wynn Netherland)
@@ -525,7 +564,7 @@
 
  * Added templates required by `nesta theme:create`.
 
-= 0.9.1 / 31 December 2010
+## 0.9.1 (31 December 2010)
 
  * Re-implemented the default theme, using semantic HTML5 and
    Andy Clarke's Universal Internet Explorer 6 CSS. Named the previous
@@ -538,15 +577,16 @@
  * Moved the navigation helpers into the Nesta::Navigation::Renderers
    module.
 
-= 0.9.0 / 20 December 2010
+## 0.9.0 (20 December 2010)
 
  * Packaged Nesta as a gem for the first time, instead of as a template
    site that can be cloned, edited and deployed. Added the `nesta`
    command for generating new sites and managing themes.
 
-= Previous versions / from 26 November 2008
+## Previous versions (from 26 November 2008)
 
  * Prior to 0.9.0 Nesta was distributed as a git repository that could
    be forked, edited and deployed. The only change log for these
-   versions is the Git commit history.
+   versions is the commit history:
+
    https://github.com/gma/nesta/commits/master

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    nesta (0.14.0)
+    nesta (0.16.0)
       RedCloth (~> 4.2)
       haml (>= 3.1, < 6.0)
       haml-contrib (>= 1.0)
@@ -9,13 +9,13 @@ PATH
       rake
       rdiscount (~> 2.1)
       sass-embedded (~> 1.58)
-      sinatra (~> 2.0)
-      tilt (~> 2.0)
+      sinatra (~> 3.1)
+      tilt (~> 2.1)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    RedCloth (4.3.2)
+    RedCloth (4.3.3)
     addressable (2.8.1)
       public_suffix (>= 2.0.2, < 6.0)
     ansi (1.5.0)
@@ -41,7 +41,7 @@ GEM
       rb-inotify (>= 0.9)
       rb-kqueue (>= 0.2)
     mini_mime (1.1.2)
-    mini_portile2 (2.8.1)
+    mini_portile2 (2.8.5)
     minitest (5.18.0)
     minitest-reporters (1.6.0)
       ansi
@@ -53,16 +53,16 @@ GEM
       rb-fsevent (>= 0.9)
       rb-inotify (>= 0.8)
       unicorn (>= 4.5)
-    mustermann (2.0.2)
+    mustermann (3.0.0)
       ruby2_keywords (~> 0.0.1)
-    nokogiri (1.14.2)
-      mini_portile2 (~> 2.8.0)
+    nokogiri (1.16.2)
+      mini_portile2 (~> 2.8.2)
       racc (~> 1.4)
     public_suffix (5.0.1)
-    racc (1.6.2)
-    rack (2.2.6.4)
-    rack-protection (2.2.4)
-      rack
+    racc (1.7.3)
+    rack (2.2.8.1)
+    rack-protection (3.1.0)
+      rack (~> 2.2, >= 2.2.4)
     rack-test (2.0.2)
       rack (>= 1.3)
     raindrops (0.20.1)
@@ -78,10 +78,10 @@ GEM
     sass-embedded (1.58.3)
       google-protobuf (~> 3.21)
       rake (>= 10.0.0)
-    sinatra (2.2.4)
-      mustermann (~> 2.0)
-      rack (~> 2.2)
-      rack-protection (= 2.2.4)
+    sinatra (3.1.0)
+      mustermann (~> 3.0)
+      rack (~> 2.2, >= 2.2.4)
+      rack-protection (= 3.1.0)
       tilt (~> 2.0)
     temple (0.10.0)
     tilt (2.1.0)

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2008-2022 Graham Ashton
+Copyright (c) 2008-2023 Graham Ashton
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,34 +1,37 @@
-# Nesta - a CMS for Ruby Developers
+# Lightweight file-based CMS and Static Site Generator
 
-A file-based CMS for web sites and blogs, written in [Sinatra][frank].
+Nesta is a lightweight CMS for building content sites and blogs, written in
+[Sinatra].
 
-Content can be written in [Markdown][markdown] or [Textile][textile] and
-stored in text files (though you can also use Haml if you need to add
-some HTML to your pages). There's no database; write your content in
-your editor. Publish by pushing to a git repository.
+Content can be written in [Markdown] or [Textile], stored in text files on your
+computer. There is no database.
 
-[frank]: http://www.sinatrarb.com/ "Sinatra"
-[markdown]: http://daringfireball.net/projects/markdown/
-[textile]: http://textism.com/tools/textile/
+You do your writing in your text editor.
+
+Publish by pushing your changes to a git repository that's setup to deploy your
+changes to the web.
+
+[Sinatra]: http://www.sinatrarb.com/ "Sinatra"
+[Markdown]: http://daringfireball.net/projects/markdown/
+[Textile]: http://textism.com/tools/textile/
 
 ## Installation
 
-Begin by installing the gem:
+Begin by [installing Ruby], then the Nesta gem:
 
     $ gem install nesta
 
-Then use the `nesta` command to generate a new site:
+Use the `nesta` command to generate a new site:
 
-    $ nesta new mysite.com --git
+    $ nesta new mysite.com --git  # a git repo is optional, but recommended
 
 Install a few dependencies, and you're away:
 
     $ cd mysite.com
     $ bundle
 
-You'll find basic configuration options for your site in
-`config/config.yml`. The defaults will work, but you'll want to tweak it
-before you go very far.
+You'll find configuration options for your site in `config/config.yml`. The
+defaults will work, but you'll want to tweak it before you go very far.
 
 That's it - you can launch a local web server in development mode using
 mr-sparkle...
@@ -36,34 +39,43 @@ mr-sparkle...
     $ bundle exec mr-sparkle config.ru
 
 ...then point your web browser at http://localhost:8080. Start editing
-the files in `content/pages` (see the [docs on writing content][] for
-full instructions).
+the files in `content/pages` (see the [docs on writing content] for full
+instructions).
+
+You can either [deploy it] behind a web server, or build a static version of
+your site:
+
+    $ nesta build  # but see config.yml for related settings
 
-[docs on writing content]: http://nestacms.com/docs/creating-content
+[installing Ruby]: https://www.ruby-lang.org/en/documentation/installation/
+[docs on writing content]: http://nestacms.com/docs/creating-content/
+[deploy it]: https://nestacms.com/docs/deployment/
 
 ## Support
 
 There's plenty of information on <http://nestacms.com>. If you need some
 help with anything feel free to file an issue, or contact me on Mastodon
-(@gma@hachyderm.io) or Twitter (@grahamashton).
+([@gma@hachyderm.io]) or Twitter ([@grahamashton]).
 
-If you like Nesta you can keep up with developments by following [@nestacms][]
-on Twitter, and on [the blog][].
+If you like Nesta you can keep up with developments by following [@nestacms]
+on Twitter, and on [the blog].
 
-[@nestacms]: http://twitter.com/nestacms
-[the blog]: http://nestacms.com/blog
+[@gma@hachyderm.io]: https://hachyderm.io/@gma
+[@grahamashton]: https://twitter.com/grahamashton
+[@nestacms]: https://twitter.com/nestacms
+[the blog]: https://nestacms.com/blog
 
 ![Tests](https://github.com/gma/nesta/actions/workflows/tests.yml/badge.svg)
 
 ## Contributing
 
-If you want to add a new feature, I recommend that you file an issue to discuss
-it before you start coding. I'm likely to suggest that we implement it as a
-[plugin][] (to keep Nesta itself lean and simple), so you might save yourself
-some time if we chat about a good approach before you start.
+If you want to add a new feature, please [create an issue] to discuss it before
+you start coding. I might suggest that we implement it as a [plugin] (to keep
+Nesta itself lean and simple), or be able to chip in with ideas on how to
+approach it.
 
-[plugin]: http://nestacms.com/docs/plugins
+[create an issue]: https://github.com/gma/nesta/issues/new
+[plugin]: https://nestacms.com/docs/plugins
 
--- Graham ([@grahamashton][] on Twitter).
+-- Graham
 
-[@grahamashton]: http://twitter.com/grahamashton

data/RELEASING.md

@@ -8,15 +8,16 @@ the steps:
 
 2. Bump the version number in `lib/nesta/version.rb`. This will cause
    the version number in `Gemfile.lock` to be updated too, so regenerate
-   it now and check them in together.
+   it now (e.g. run `bundle install`) and check them in together.
 
-3. Update the `CHANGES` file with a summary of significant changes since
+3. Update the `CHANGLOG.md` file with a summary of significant changes since
    the previous release.
 
 4. Commit these changes with a commit message of 'Bump version to <version>'
 
-5. Generate a new site with the `nesta` command, install the demo content,
-   check that it runs okay locally.
+5. Install the gem locally (`rake install`), then generate a new site
+   with the `nesta` command. Install the demo content site, check that
+   it runs okay locally.
 
 6. If everything seems fine, run `rake release`.
 

data/lib/nesta/config.rb

@@ -33,10 +33,11 @@ module Nesta
       setting = setting.to_s
       self.config ||= read_config_file(setting)
       env_config = config.fetch(Nesta::App.environment.to_s, {})
-      env_config.fetch(
-        setting,
-        config.fetch(setting) { raise NotDefined.new(setting) }
-      )
+      env_config.fetch(setting) do
+        config.fetch(setting) do
+          raise NotDefined.new(setting)
+        end
+      end
     rescue NotDefined
       default.empty? && raise || (return default.first)
     end

data/lib/nesta/models/file_model.rb

@@ -0,0 +1,195 @@
+def register_template_handler(class_name, *extensions)
+  Tilt.register Tilt.const_get(class_name), *extensions
+rescue LoadError
+  # Only one of the Markdown processors needs to be available, so we can
+  # safely ignore these load errors.
+end
+
+register_template_handler :MarukuTemplate, 'mdown', 'md'
+register_template_handler :KramdownTemplate, 'mdown', 'md'
+register_template_handler :RDiscountTemplate, 'mdown', 'md'
+register_template_handler :RedcarpetTemplate, 'mdown', 'md'
+
+
+module Nesta
+  class MetadataParseError < RuntimeError; end
+
+  class FileModel
+    FORMATS = [:mdown, :md, :haml, :textile]
+    @@model_cache = {}
+    @@filename_cache = {}
+
+    attr_reader :filename, :mtime
+
+    class CaseInsensitiveHash < Hash
+      def [](key)
+        super(key.to_s.downcase)
+      end
+    end
+
+    def self.model_path(basename = nil)
+      Nesta::Config.content_path(basename)
+    end
+
+    def self.find_all
+      file_pattern = File.join(model_path, "**", "*.{#{FORMATS.join(',')}}")
+      Dir.glob(file_pattern).map do |path|
+        relative = path.sub("#{model_path}/", "")
+        load(relative.sub(/\.(#{FORMATS.join('|')})/, ""))
+      end
+    end
+
+    def self.find_file_for_path(path)
+      if ! @@filename_cache.has_key?(path)
+        FORMATS.each do |format|
+          [path, File.join(path, 'index')].each do |basename|
+            filename = model_path("#{basename}.#{format}")
+            if File.exist?(filename)
+              @@filename_cache[path] = filename
+              break
+            end
+          end
+        end
+      end
+      @@filename_cache[path]
+    end
+
+    def self.needs_loading?(path, filename)
+      @@model_cache[path].nil? || File.mtime(filename) > @@model_cache[path].mtime
+    end
+
+    def self.load(path)
+      if (filename = find_file_for_path(path)) && needs_loading?(path, filename)
+        @@model_cache[path] = self.new(filename)
+      end
+      @@model_cache[path]
+    end
+
+    def self.purge_cache
+      @@model_cache = {}
+      @@filename_cache = {}
+    end
+
+    def initialize(filename)
+      @filename = filename
+      @format = filename.split('.').last.to_sym
+      if File.zero?(filename)
+        @metadata = {}
+        @markup = ''
+      else
+        @metadata, @markup = parse_file
+      end
+      @mtime = File.mtime(filename)
+    end
+
+    def ==(other)
+      other.respond_to?(:path) && (self.path == other.path)
+    end
+
+    def index_page?
+      @filename =~ /\/?index\.\w+$/
+    end
+
+    def abspath
+      file_path = @filename.sub(self.class.model_path, '')
+      if index_page?
+        File.dirname(file_path)
+      else
+        File.join(File.dirname(file_path), File.basename(file_path, '.*'))
+      end
+    end
+
+    def path
+      abspath.sub(/^\//, '')
+    end
+
+    def permalink
+      File.basename(path)
+    end
+
+    def layout
+      (metadata('layout') || 'layout').to_sym
+    end
+
+    def template
+      (metadata('template') || 'page').to_sym
+    end
+
+    def to_html(scope = Object.new)
+      convert_to_html(@format, scope, markup)
+    end
+
+    def last_modified
+      @last_modified ||= File.stat(@filename).mtime
+    end
+
+    def description
+      metadata('description')
+    end
+
+    def keywords
+      metadata('keywords')
+    end
+
+    def metadata(key)
+      @metadata[key]
+    end
+
+    def flagged_as?(flag)
+      flags = metadata('flags')
+      flags && flags.split(',').map { |name| name.strip }.include?(flag)
+    end
+
+    def parse_metadata(first_paragraph)
+      is_metadata = first_paragraph.split("\n").first =~ /^[\w ]+:/
+      raise MetadataParseError unless is_metadata
+      metadata = CaseInsensitiveHash.new
+      first_paragraph.split("\n").each do |line|
+        key, value = line.split(/\s*:\s*/, 2)
+        next if value.nil?
+        metadata[key.downcase] = value.chomp
+      end
+      metadata
+    end
+
+    private
+
+    def markup
+      @markup
+    end
+
+    def parse_file
+      contents = File.open(@filename).read
+    rescue Errno::ENOENT
+      raise Sinatra::NotFound
+    else
+      first_paragraph, remaining = contents.split(/\r?\n\r?\n/, 2)
+      begin
+        return parse_metadata(first_paragraph), remaining
+      rescue MetadataParseError
+        return {}, contents
+      end
+    end
+
+    def add_p_tags_to_haml(text)
+      contains_tags = (text =~ /^\s*%/)
+      if contains_tags
+        text
+      else
+        text.split(/\r?\n/).inject('') do |accumulator, line|
+          accumulator << "%p #{line}\n"
+        end
+      end
+    end
+
+    def convert_to_html(format, scope, text)
+      text = add_p_tags_to_haml(text) if @format == :haml
+      template = Tilt[format].new(renderer_config(@format)) { text }
+      template.render(scope)
+    end
+
+    def renderer_config(format)
+      {}
+    end
+  end
+end