jekyll-admin 0.8.0 → 0.10.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: c6c8cb4b507e24358e055d92c823931ddba82099
-  data.tar.gz: 2f9057824d1dab4285a596022a98618feef283da
+SHA256:
+  metadata.gz: c93755ba95fdfd4f990c1acf408229fbed7ab74f00346dd790c3d50387ea6a5b
+  data.tar.gz: 3fe240a9ee0ebef55deb07de51fcee8ee13fc8db3e511e76e11ca4bc59fd440d
 SHA512:
-  metadata.gz: 5adb026ac7cbbd4178e8b83800c94393b59250881dd733f38e38c43e4dd669bf85b6f9c4da011cd7d1956d2a1dbf082a3aa426d3ccde4e3f901c70453f0bec27
-  data.tar.gz: 4e4afa807df84b51cdbf40a2d3be587de4426b494f8ef59dc309989197d966984de7cdc38dfbf7e75882e144fec7249388df5ca5d53b1dd1314da475d2227dbc
+  metadata.gz: daf916c04fa0321001c032e3107b584ebe34158033227de8fd6ae8a0d09a57fc58556dde94eeb6e55a7470dd46e901260871048a841c04ccd09abfbd4915cf36
+  data.tar.gz: 99a4956fc3b8eae740a87f1851a4240bbebcfff6ec46b46ab28d517b622ec074a78dcbd0b6fbe349386c3a9187fc57c36b1d78ce92130b201acd9d0a1f9177f7

data/LICENSE

@@ -1,21 +1,21 @@
-The MIT License (MIT)
-
-Copyright 2016-present Mert Kahyaoğlu and the Jekyll Admin contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
+The MIT License (MIT)
+
+Copyright 2016-present Mert Kahyaoğlu and the Jekyll Admin contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -1,54 +1,94 @@
-[![Gem Version](https://img.shields.io/gem/v/jekyll-admin.svg)](https://rubygems.org/gems/jekyll-admin)
-[![Build Status](https://travis-ci.org/jekyll/jekyll-admin.svg?branch=master)](https://travis-ci.org/jekyll/jekyll-admin)
-[![Build status](https://ci.appveyor.com/api/projects/status/biop1r6ae524xlm2/branch/master?svg=true)](https://ci.appveyor.com/project/benbalter/jekyll-admin/branch/master)
-[![Coverage Status](https://coveralls.io/repos/github/jekyll/jekyll-admin/badge.svg?branch=master)](https://coveralls.io/github/jekyll/jekyll-admin?branch=master)
-[![NPM Dependencies](https://david-dm.org/jekyll/jekyll-admin.svg)](https://david-dm.org/jekyll/jekyll-admin)
-
-A Jekyll plugin that provides users with a traditional CMS-style graphical interface to author content and administer Jekyll sites. The project is divided into two parts. A Ruby-based HTTP API that handles Jekyll and filesystem operations, and a JavaScript-based front end, built on that API.
-
-![screenshot of Jekyll Admin](/screenshot.png)
-
-## Installation
-
-Refer to the [installing plugins](https://jekyllrb.com/docs/plugins/#installing-a-plugin) section of Jekyll's documentation and install the `jekyll-admin` plugin as you would any other plugin. Here's the short version:
-
-1. Add the following to your site's Gemfile:
-
-    ```ruby
-    gem 'jekyll-admin', group: :jekyll_plugins
-    ```
-
-2. Run `bundle install`
-
-## Usage
-
-1. Start Jekyll as you would normally (`bundle exec jekyll serve`)
-2. Navigate to `http://localhost:4000/admin` to access the administrative interface
-
-## Options
-
-Jekyll Admin related options can be specified in `_config.yml`
-under a key called `jekyll_admin`. Currently it has only one option `hidden_links`
-which is for hiding unwanted links on the sidebar. The following keys under `hidden_links` can be used in order to hide default links;
-
-```yaml
-jekyll_admin:
-  hidden_links:
-    - posts
-    - pages
-    - staticfiles
-    - datafiles
-    - configuration
-```
-
-## Contributing
-
-Interested in contributing to Jekyll Admin? We’d love your help. Jekyll Admin is an open source project, built one contribution at a time by users like you. See [the contributing instructions](.github/CONTRIBUTING.md), and [the development docs](http://jekyll.github.io/jekyll-admin/development/) for more information.
-
-## Looking for a hosted version?
-
-Jekyll Admin is intended to be run on your computer alongside your local Jekyll installation. If you're looking for a hosted version, we'd recommend checking out [Siteleaf](https://www.siteleaf.com/) a hosted Jekyll editor with deep GitHub integration (whom we'd also like to thank for inspiring parts of Jekyll Admin itself!).
-
-## License
-
-The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+[![Gem Version](https://img.shields.io/gem/v/jekyll-admin.svg)](https://rubygems.org/gems/jekyll-admin)
+[![Build Status](https://travis-ci.org/jekyll/jekyll-admin.svg?branch=master)](https://travis-ci.org/jekyll/jekyll-admin)
+[![Build status](https://ci.appveyor.com/api/projects/status/u6u9tn7rk5tln33s/branch/master?svg=true)](https://ci.appveyor.com/project/jekyll/jekyll-admin)
+[![Coverage Status](https://coveralls.io/repos/github/jekyll/jekyll-admin/badge.svg?branch=master)](https://coveralls.io/github/jekyll/jekyll-admin?branch=master)
+[![NPM Dependencies](https://david-dm.org/jekyll/jekyll-admin.svg)](https://david-dm.org/jekyll/jekyll-admin)
+[![Financial Contributors on Open Collective](https://opencollective.com/jekyll-admin/all/badge.svg?label=financial+contributors)](https://opencollective.com/jekyll-admin)
+
+A Jekyll plugin that provides users with a traditional CMS-style graphical interface to author content and administer Jekyll sites. The project is divided into two parts. A Ruby-based HTTP API that handles Jekyll and filesystem operations, and a JavaScript-based front end, built on that API.
+
+![screenshot of Jekyll Admin](/screenshot.png)
+
+## Installation
+
+Refer to the [installing plugins](https://jekyllrb.com/docs/plugins/installation/) section of Jekyll's documentation and install the `jekyll-admin` plugin as you would any other plugin. Here's the short version:
+
+1.  Add the following to your site's Gemfile:
+
+    ```ruby
+    gem 'jekyll-admin', group: :jekyll_plugins
+    ```
+
+2.  Run `bundle install`
+
+## Usage
+
+1.  Start Jekyll as you would normally (`bundle exec jekyll serve`)
+2.  Navigate to `http://localhost:4000/admin` to access the administrative interface
+
+## Options
+
+Jekyll Admin related options can be specified in `_config.yml`
+under a key called `jekyll_admin`. Currently it has only one option `hidden_links`
+which is for hiding unwanted links on the sidebar. The following keys under `hidden_links` can be used in order to hide default links;
+
+```yaml
+jekyll_admin:
+  hidden_links:
+    - posts
+    - pages
+    - staticfiles
+    - datafiles
+    - configuration
+```
+
+### Customizing collection label in Sidebar
+
+The plugin allows you to customize the name of a collection that is displayed in the sidebar by defining it in the collection's
+metadata in the config file. For example, if your source's *posts* are actually *news-items* on the deployed site, then it can
+be distracting to see the label `Posts` in the admin's sidebar. This situation can be resolved with the following configuration:
+
+```yaml
+collections:
+  posts:
+    output: true
+    sidebar_label: News
+```
+
+## Contributing
+
+Interested in contributing to Jekyll Admin? We’d love your help. Jekyll Admin is an open source project, built one contribution at a time by users like you. See [the contributing instructions](.github/CONTRIBUTING.md), and [the development docs](https://jekyll.github.io/jekyll-admin/development/) for more information.
+
+## Contributors
+
+### Code Contributors
+
+This project exists thanks to all the people who contribute. [[Contribute](.github/CONTRIBUTING.md)].
+<a href="https://github.com/jekyll/jekyll-admin/graphs/contributors"><img src="https://opencollective.com/jekyll-admin/contributors.svg?width=890&button=false" /></a>
+
+### Financial Contributors
+
+Become a financial contributor and help us sustain our community. [[Contribute](https://opencollective.com/jekyll-admin/contribute)]
+
+#### Individuals
+
+<a href="https://opencollective.com/jekyll-admin"><img src="https://opencollective.com/jekyll-admin/individuals.svg?width=890"></a>
+
+#### Organizations
+
+Support this project with your organization. Your logo will show up here with a link to your website. [[Contribute](https://opencollective.com/jekyll-admin/contribute)]
+
+<a href="https://opencollective.com/jekyll-admin/organization/0/website"><img src="https://opencollective.com/jekyll-admin/organization/0/avatar.svg"></a>
+<a href="https://opencollective.com/jekyll-admin/organization/1/website"><img src="https://opencollective.com/jekyll-admin/organization/1/avatar.svg"></a>
+<a href="https://opencollective.com/jekyll-admin/organization/2/website"><img src="https://opencollective.com/jekyll-admin/organization/2/avatar.svg"></a>
+<a href="https://opencollective.com/jekyll-admin/organization/3/website"><img src="https://opencollective.com/jekyll-admin/organization/3/avatar.svg"></a>
+<a href="https://opencollective.com/jekyll-admin/organization/4/website"><img src="https://opencollective.com/jekyll-admin/organization/4/avatar.svg"></a>
+<a href="https://opencollective.com/jekyll-admin/organization/5/website"><img src="https://opencollective.com/jekyll-admin/organization/5/avatar.svg"></a>
+<a href="https://opencollective.com/jekyll-admin/organization/6/website"><img src="https://opencollective.com/jekyll-admin/organization/6/avatar.svg"></a>
+<a href="https://opencollective.com/jekyll-admin/organization/7/website"><img src="https://opencollective.com/jekyll-admin/organization/7/avatar.svg"></a>
+<a href="https://opencollective.com/jekyll-admin/organization/8/website"><img src="https://opencollective.com/jekyll-admin/organization/8/avatar.svg"></a>
+<a href="https://opencollective.com/jekyll-admin/organization/9/website"><img src="https://opencollective.com/jekyll-admin/organization/9/avatar.svg"></a>
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/jekyll-admin.rb

@@ -1,46 +1,47 @@
-# Default Sinatra to "production" mode (surpress errors) unless
-# otherwise specified by the `RACK_ENV` environmental variable.
-# Must be done prior to requiring Sinatra, or we'll get a LoadError
-# as it looks for sinatra/cross-origin, which is development only
-ENV["RACK_ENV"] = "production" if ENV["RACK_ENV"].to_s.empty?
-
-require "json"
-require "jekyll"
-require "base64"
-require "webrick"
-require "sinatra"
-require "fileutils"
-require "sinatra/base"
-require "sinatra/json"
-require "addressable/uri"
-require "sinatra/reloader"
-require "sinatra/namespace"
-
-module JekyllAdmin
-  autoload :APIable,          "jekyll-admin/apiable"
-  autoload :DataFile,         "jekyll-admin/data_file"
-  autoload :Directory,        "jekyll-admin/directory"
-  autoload :FileHelper,       "jekyll-admin/file_helper"
-  autoload :PageWithoutAFile, "jekyll-admin/page_without_a_file"
-  autoload :PathHelper,       "jekyll-admin/path_helper"
-  autoload :Server,           "jekyll-admin/server"
-  autoload :StaticServer,     "jekyll-admin/static_server"
-  autoload :URLable,          "jekyll-admin/urlable"
-  autoload :Version,          "jekyll-admin/version"
-
-  def self.site
-    @site ||= begin
-      site = Jekyll.sites.first
-      site.future = true
-      site
-    end
-  end
-end
-
-# Monkey Patches
-require_relative "./jekyll/commands/serve"
-
-[Jekyll::Page, Jekyll::Document, Jekyll::StaticFile, Jekyll::Collection].each do |klass|
-  klass.include JekyllAdmin::APIable
-  klass.include JekyllAdmin::URLable
-end
+# frozen_string_literal: true
+
+# Default Sinatra to "production" mode (surpress errors) unless
+# otherwise specified by the `RACK_ENV` environmental variable.
+# Must be done prior to requiring Sinatra, or we'll get a LoadError
+# as it looks for sinatra/cross-origin, which is development only
+ENV["RACK_ENV"] = "production" if ENV["RACK_ENV"].to_s.empty?
+
+require "json"
+require "jekyll"
+require "base64"
+require "webrick"
+require "sinatra"
+require "fileutils"
+require "sinatra/base"
+require "sinatra/json"
+require "addressable/uri"
+require "sinatra/reloader"
+require "sinatra/namespace"
+
+module JekyllAdmin
+  autoload :APIable,      "jekyll-admin/apiable"
+  autoload :DataFile,     "jekyll-admin/data_file"
+  autoload :Directory,    "jekyll-admin/directory"
+  autoload :FileHelper,   "jekyll-admin/file_helper"
+  autoload :PathHelper,   "jekyll-admin/path_helper"
+  autoload :Server,       "jekyll-admin/server"
+  autoload :StaticServer, "jekyll-admin/static_server"
+  autoload :URLable,      "jekyll-admin/urlable"
+  autoload :Version,      "jekyll-admin/version"
+
+  def self.site
+    @site ||= begin
+      site = Jekyll.sites.first
+      site.future = true
+      site
+    end
+  end
+end
+
+[Jekyll::Page, Jekyll::Document, Jekyll::StaticFile, Jekyll::Collection].each do |klass|
+  klass.include JekyllAdmin::APIable
+  klass.include JekyllAdmin::URLable
+end
+
+# Monkey Patches
+require_relative "jekyll/commands/serve"

data/lib/jekyll-admin/apiable.rb

@@ -1,162 +1,224 @@
-module JekyllAdmin
-  # Abstract module to be included in Convertible and Document to provide
-  # additional, API-specific functionality without duplicating logic
-  module APIable
-
-    CONTENT_FIELDS = %w(next previous content excerpt).freeze
-
-    # Returns a hash suitable for use as an API response.
-    #
-    # For Documents and Pages:
-    #
-    # 1. Adds the file's raw content to the `raw_content` field
-    # 2. Adds the file's raw YAML front matter to the `front_matter` field
-    #
-    # For Static Files it addes the Base64 `encoded_content` field
-    #
-    # Options:
-    #
-    # include_content - if true, includes the content in the respond, false by default
-    #                   to support mapping on indexes where we only want metadata
-    #
-    #
-    # Returns a hash (which can then be to_json'd)
-    def to_api(include_content: false)
-      output = hash_for_api
-      output = output.merge(url_fields)
-
-      # Include content, if requested, otherwise remove it
-      if include_content
-        output = output.merge(content_fields)
-      else
-        CONTENT_FIELDS.each { |field| output.delete(field) }
-      end
-
-      # Documents have duplicate output and content fields, Pages do not
-      # Since it's an API, use `content` in both for consistency
-      output.delete("output")
-
-      # By default, calling to_liquid on a collection will return a docs
-      # array with each rendered document, which we don't want.
-      if is_a?(Jekyll::Collection)
-        output.delete("docs")
-        output["entries_url"] = entries_url
-      end
-
-      if is_a?(Jekyll::Document)
-        output["relative_path"] = relative_path.sub("_drafts/", "") if draft?
-        output["name"] = basename
-      end
-
-      if is_a?(Jekyll::StaticFile)
-        output["from_theme"] = from_theme_gem?
-      end
-
-      output
-    end
-
-    private
-
-    # Pages don't have a hash method, but Documents do
-    def file_path
-      if is_a?(Jekyll::Document)
-        path
-      else
-        File.join(@base, @dir, name)
-      end
-    end
-
-    def from_theme_gem?
-      @base == site.in_theme_dir
-    end
-
-    # StaticFiles don't have `attr_accesor` set for @site or @name
-    def site
-      @site
-    end
-
-    def name
-      @name
-    end
-
-    def file_contents
-      @file_contents ||= File.read(file_path, file_read_options) if file_exists?
-    end
-
-    def file_read_options
-      Jekyll::Utils.merged_file_read_opts(site, {})
-    end
-
-    def front_matter
-      return unless file_exists?
-      @front_matter ||= if file_contents =~ Jekyll::Document::YAML_FRONT_MATTER_REGEXP
-                          SafeYAML.load(Regexp.last_match(1))
-                        else
-                          {}
-                        end
-    end
-
-    def raw_content
-      return unless file_exists?
-      @raw_content ||= if file_contents =~ Jekyll::Document::YAML_FRONT_MATTER_REGEXP
-                         $POSTMATCH
-                       else
-                         file_contents
-                       end
-    end
-
-    def encoded_content
-      @encoded_content ||= Base64.encode64(file_contents) if file_exists?
-    end
-
-    def file_exists?
-      return @file_exists if defined? @file_exists
-      @file_exists = File.exist?(file_path)
-    end
-
-    # Base hash from which to generate the API output
-    def hash_for_api
-      output = to_liquid
-      if output.respond_to?(:hash_for_json)
-        output.hash_for_json
-      else
-        output.to_h
-      end
-    end
-
-    # Returns a hash of content fields for inclusion in the API output
-    def content_fields
-      output = {}
-
-      # Include file content-related fields
-      if is_a?(Jekyll::StaticFile)
-        output["encoded_content"] = encoded_content
-      elsif is_a?(JekyllAdmin::DataFile)
-        output["content"] = content
-        output["raw_content"] = raw_content
-      else
-        output["raw_content"] = raw_content
-        output["front_matter"] = front_matter
-      end
-
-      # Include next and previous documents non-recursively
-      if is_a?(Jekyll::Document)
-        %w(next previous).each do |direction|
-          method = "#{direction}_doc".to_sym
-          doc = public_send(method)
-          output[direction] = doc.to_api if doc
-        end
-      end
-
-      output
-    end
-
-    def url_fields
-      return {} unless respond_to?(:http_url) && respond_to?(:api_url)
-      {
-        "http_url" => http_url,
-        "api_url"  => api_url,
-      }
-    end
-  end
-end
+# frozen_string_literal: true
+
+module JekyllAdmin
+  # Abstract module to be included in Convertible and Document to provide
+  # additional, API-specific functionality without duplicating logic
+  module APIable
+    CONTENT_FIELDS = %w(next previous content excerpt).freeze
+    API_SCAFFOLD   = %w(name path relative_path).map { |i| [i, nil] }.to_h.freeze
+
+    # Returns a hash suitable for use as an API response.
+    #
+    # For Documents and Pages:
+    #
+    # 1. Adds the file's raw content to the `raw_content` field
+    # 2. Adds the file's raw YAML front matter to the `front_matter` field
+    #
+    # For Static Files it addes the Base64 `encoded_content` field
+    #
+    # Options:
+    #
+    # include_content - if true, includes the content in the respond, false by default
+    #                   to support mapping on indexes where we only want metadata
+    #
+    # Returns a hash (which can then be to_json'd)
+    def to_api(include_content: false)
+      output = API_SCAFFOLD.merge hash_for_api
+
+      # Include content, if requested, otherwise remove it
+      if include_content
+        output.merge!(content_fields)
+      else
+        CONTENT_FIELDS.each { |field| output.delete(field) }
+      end
+
+      # Documents have duplicate output and content fields, Pages do not
+      # Since it's an API, use `content` in both for consistency
+      output.delete("output")
+
+      output["name"] = basename if is_a?(Jekyll::Document)
+      output["from_theme"] = from_theme_gem? if is_a?(Jekyll::StaticFile)
+      output["relative_path"] = relative_path_for_api
+
+      # By default, calling to_liquid on a collection will return a docs
+      # array with each rendered document, which we don't want.
+      if is_a?(Jekyll::Collection)
+        output.delete("docs")
+        output["name"] = label
+        output["path"] = relative_directory
+        output["entries_url"] = entries_url
+      end
+
+      output.merge!(url_fields)
+      output
+    end
+
+    private
+
+    # Relative path of files and directories with their *special directories*
+    # and any leading slashes stripped away.
+    #
+    # Examples:
+    #        `_drafts/foo/draft-post.md` => `foo/draft-post.md`
+    #   `_posts/foo/2019-10-18-hello.md` => `foo/2019-10-18-hello.md`
+    #             `/assets/img/logo.png` => `assets/img/logo.png`
+    def relative_path_for_api
+      return unless respond_to?(:relative_path) && relative_path
+
+      @relative_path_for_api ||= begin
+        rel_path = relative_path.dup
+        strip_leading_slash!(rel_path)
+        strip_leading_special_directory!(rel_path)
+        strip_leading_slash!(rel_path)
+
+        rel_path
+      end
+    end
+
+    # Prefer substituting substrings instead of using a regex in order to avoid multiple
+    # regex allocations. String literals are frozen and reused.
+
+    def strip_leading_slash!(path)
+      return unless path.start_with?("/")
+
+      path.sub!("/", "")
+    end
+
+    def strip_leading_special_directory!(path)
+      return unless special_directory && path.start_with?(special_directory)
+
+      path.sub!(special_directory, "")
+    end
+
+    def special_directory
+      return @special_directory if defined?(@special_directory)
+
+      @special_directory = begin
+        if is_a?(Jekyll::Document) && draft?
+          "_drafts"
+        elsif is_a?(Jekyll::Document)
+          collection.relative_directory
+        elsif is_a?(Jekyll::Collection)
+          relative_directory
+        end
+      end
+    end
+
+    # Pages don't have a hash method, but Documents do
+    def file_path
+      if is_a?(Jekyll::Document)
+        path
+      else
+        File.join(@base, @dir, name)
+      end
+    end
+
+    def from_theme_gem?
+      @base == site.in_theme_dir
+    end
+
+    # StaticFiles don't have `attr_accesor` set for @site or @name
+    def site
+      @site
+    end
+
+    def name
+      @name
+    end
+
+    def file_contents
+      @file_contents ||= File.read(file_path, file_read_options) if file_exists?
+    end
+
+    def file_read_options
+      Jekyll::Utils.merged_file_read_opts(site, {})
+    end
+
+    def front_matter_defaults
+      return unless file_exists?
+
+      @front_matter_defaults ||= begin
+        return {} unless respond_to?(:relative_path) && respond_to?(:type)
+
+        site.frontmatter_defaults.all(relative_path, type)
+      end
+    end
+
+    def front_matter
+      return unless file_exists?
+
+      @front_matter ||= if file_contents =~ Jekyll::Document::YAML_FRONT_MATTER_REGEXP
+                          SafeYAML.load(Regexp.last_match(1))
+                        else
+                          {}
+                        end
+    end
+
+    def raw_content
+      return unless file_exists?
+
+      @raw_content ||= if file_contents =~ Jekyll::Document::YAML_FRONT_MATTER_REGEXP
+                         $POSTMATCH
+                       else
+                         file_contents
+                       end
+    end
+
+    def encoded_content
+      @encoded_content ||= Base64.encode64(file_contents) if file_exists?
+    end
+
+    def file_exists?
+      return @file_exists if defined? @file_exists
+
+      @file_exists = File.exist?(file_path)
+    end
+
+    # Base hash from which to generate the API output
+    def hash_for_api
+      output = to_liquid
+      if output.respond_to?(:hash_for_json)
+        output.hash_for_json
+      else
+        output.to_h
+      end
+    end
+
+    # Returns a hash of content fields for inclusion in the API output
+    def content_fields
+      output = {}
+
+      # Include file content-related fields
+      if is_a?(Jekyll::StaticFile)
+        output["encoded_content"] = encoded_content
+      elsif is_a?(JekyllAdmin::DataFile)
+        output["content"] = content
+        output["raw_content"] = raw_content
+      else
+        output["raw_content"] = raw_content
+        output["front_matter"] = front_matter
+        output["front_matter_defaults"] = front_matter_defaults
+      end
+
+      # Include next and previous documents non-recursively
+      if is_a?(Jekyll::Document)
+        %w(next previous).each do |direction|
+          method = "#{direction}_doc".to_sym
+          doc = public_send(method)
+          output[direction] = doc.to_api if doc
+        end
+      end
+
+      output
+    end
+
+    def url_fields
+      return {} unless respond_to?(:http_url) && respond_to?(:api_url)
+
+      {
+        "http_url" => http_url,
+        "api_url"  => api_url,
+      }
+    end
+  end
+end