jekyll-admin-josercc 0.5.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 0d4dd148a0b78a087f60188c699c0dd31b909fea
+  data.tar.gz: 627708ca25128a6c7f6f2f6faaf0066bd6131b43
+SHA512:
+  metadata.gz: 334d87089477b0d97d85641a076637e9fbbc42bce1264ff736b4edeb4c6454b78a51c541d6a3850f8bd252704434e29f3818641460be8b03511b79b27c5b27c7
+  data.tar.gz: 68fa43bfccb85cdc8b6a7c3695418ee87a399d653e39dbac6ffd92a5e4dd0217ec585fc983b5ceae93a31399394221abae37971470aa2c511888cd12553f8a49

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright 2017 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

@@ -0,0 +1,54 @@
+[![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).

data/lib/jekyll/commands/build.rb

@@ -0,0 +1,14 @@
+module Jekyll
+  module Commands
+    class Build < Command
+      class << self
+        alias_method :original_build, :build
+
+        def build(site, options)
+          options["watch"] = false
+          original_build(site, options)
+        end
+      end
+    end
+  end
+end

data/lib/jekyll/commands/serve.rb

@@ -0,0 +1,26 @@
+module Jekyll
+  module Commands
+    class Serve < Command
+      class << self
+        def start_up_webrick(opts, destination)
+          server = WEBrick::HTTPServer.new(webrick_opts(opts)).tap { |o| o.unmount("") }
+          server.mount(opts["baseurl"], Servlet, destination, file_handler_opts)
+
+          jekyll_admin_monkey_patch(server)
+
+          Jekyll.logger.info "Server address:", server_address(server, opts)
+          launch_browser server, opts if opts["open_url"]
+          boot_or_detach server, opts
+        end
+
+        def jekyll_admin_monkey_patch(server)
+          server.mount "/admin", Rack::Handler::WEBrick, JekyllAdmin::StaticServer
+          server.mount "/_api",  Rack::Handler::WEBrick, JekyllAdmin::Server
+          Jekyll.logger.warn "Auto-regeneration:", "disabled by JekyllAdmin."
+          Jekyll.logger.warn "", "The site will regenerate only via the Admin interface."
+          Jekyll.logger.info "JekyllAdmin mode:", ENV["RACK_ENV"] || "production"
+        end
+      end
+    end
+  end
+end

data/lib/jekyll-admin/apiable.rb

@@ -0,0 +1,153 @@
+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["name"] = basename
+      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
+
+    # 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

data/lib/jekyll-admin/data_file.rb

@@ -0,0 +1,106 @@
+module JekyllAdmin
+  class DataFile
+    METHODS_FOR_LIQUID = %w(path relative_path slug ext title).freeze
+    EXTENSIONS = %w(yaml yml json csv).freeze
+
+    include APIable
+    include URLable
+    include PathHelper
+    extend PathHelper
+
+    attr_reader :id
+
+    # Initialize a new DataFile object
+    #
+    # id - the file ID as passed from the API. This may or may not have an extension
+    def initialize(id)
+      @id ||= File.extname(id).empty? ? "#{id}.yml" : id
+    end
+    alias_method :path, :id
+
+    def exists?
+      @exists ||= File.exist?(absolute_path)
+    end
+
+    # Returns unparsed content as it exists on disk
+    def raw_content
+      @raw_content ||= File.open(absolute_path, "r:UTF-8", &:read)
+    end
+
+    # Returnes (re)parsed content using Jekyll's native parsing mechanism
+    def content
+      @content ||= data_reader.read_data_file(absolute_path)
+    end
+
+    # Returns the file's extension with preceeding `.`
+    def ext
+      @ext ||= if File.extname(id).to_s.empty?
+                 ".yml"
+               else
+                 File.extname(id)
+               end
+    end
+    alias_method :extension, :ext
+
+    # Returns the file's sanitized slug (as used in `site.data[slug]`)
+    def slug
+      @slug ||= data_reader.sanitize_filename(basename)
+    end
+
+    # Returns the human-readable title of the data file
+    def title
+      @title ||= Jekyll::Utils.titleize_slug(slug.tr("_", "-"))
+    end
+
+    # Return path relative to configured `data_dir`
+    def relative_path
+      id.sub("/#{DataFile.data_dir}/", "")
+    end
+
+    # Return the absolute path to given data file
+    def absolute_path
+      sanitized_path id
+    end
+
+    # Mimics Jekyll's native to_liquid functionality by returning a hash
+    # of data file metadata
+    def to_liquid
+      @to_liquid ||= METHODS_FOR_LIQUID.map { |key| [key, public_send(key)] }.to_h
+    end
+
+    def self.all
+      data_dir = sanitized_path DataFile.data_dir
+      files = Dir["#{data_dir}/**/*.{#{EXTENSIONS.join(",")}}"].reject do |d|
+        File.directory?(d)
+      end
+
+      files.map do |path|
+        new path_without_site_source(path)
+      end
+    end
+
+    # Relative path to data directory within site source
+    def self.data_dir
+      JekyllAdmin.site.config["data_dir"]
+    end
+
+    private
+
+    def data_reader
+      @data_reader = Jekyll::DataReader.new(JekyllAdmin.site)
+    end
+
+    def basename
+      @basename ||= File.basename(id, ".*")
+    end
+
+    def basename_with_extension
+      [basename, extension].join
+    end
+    alias_method :filename, :basename_with_extension
+
+    def namespace
+      "data"
+    end
+  end
+end

data/lib/jekyll-admin/directory.rb

@@ -0,0 +1,70 @@
+module JekyllAdmin
+  class Directory
+    extend Forwardable
+    def_delegator :@path, :basename, :name
+    def_delegator :@path, :mtime, :modified_time
+    attr_reader :path, :splat, :content_type, :base
+
+    include Enumerable
+    include JekyllAdmin::URLable
+    include JekyllAdmin::APIable
+
+    TYPE = :directory
+
+    # Arguments:
+    #
+    # path - full path of the directory which its entries will be listed
+    #
+    # base - passes site.source to generate `relative_path` needed for `to_api`
+    #
+    # content_type - type of the requested directory entries, this is used to generate
+    # API endpoint of the directory along with `splat`
+    #
+    # splat - the requested directory path relative to content namespace
+    def initialize(path, base: nil, content_type: nil, splat: nil)
+      @base = Pathname.new base
+      @content_type = content_type
+      @splat = Pathname.new splat
+      @path = Pathname.new path
+    end
+
+    def to_liquid
+      {
+        :name          => name,
+        :modified_time => modified_time,
+        :path          => relative_path,
+        :type          => TYPE,
+      }
+    end
+
+    def relative_path
+      path.relative_path_from(base).to_s
+    end
+
+    def resource_path
+      if content_type == "pages"
+        "/pages/#{splat}/#{name}"
+      elsif content_type == "data"
+        "/data/#{splat}/#{name}/"
+      else
+        "/collections/#{content_type}/entries/#{splat}/#{name}"
+      end
+    end
+    alias_method :url, :resource_path
+
+    def http_url
+      nil
+    end
+
+    def directories
+      path.entries.map do |entry|
+        next if [".", ".."].include? entry.to_s
+        next unless path.join(entry).directory?
+        self.class.new(
+          path.join(entry),
+          :base => base, :content_type => content_type, :splat => splat
+        )
+      end.compact!
+    end
+  end
+end

data/lib/jekyll-admin/file_helper.rb

@@ -0,0 +1,64 @@
+module JekyllAdmin
+  module FileHelper
+
+    # The file the user requested in the URL
+    def requested_file
+      find_by_path(path)
+    end
+
+    # The file ultimately written to disk
+    # This may be the requested file, or in the case of a rename will be read
+    # from the new path that was actually written to disk
+    def written_file
+      find_by_path(write_path)
+    end
+
+    # Write a file to disk with the given content
+    def write_file(path, content)
+      Jekyll.logger.debug "WRITING:", path
+      path = sanitized_path(path)
+      FileUtils.mkdir_p File.dirname(path)
+      File.write(path, content)
+      site.process
+    end
+
+    # Delete the file at the given path
+    def delete_file(path)
+      Jekyll.logger.debug "DELETING:", path
+      FileUtils.rm_f sanitized_path(path)
+      site.process
+    end
+
+    private
+
+    def ensure_requested_file
+      ensure_file(requested_file)
+    end
+
+    def ensure_written_file
+      ensure_file(written_file)
+    end
+
+    def find_by_path(path)
+      files = case namespace
+              when "collections"
+                collection.docs
+              when "data"
+                DataFile.all
+              when "pages", "static_files"
+                site.public_send(namespace.to_sym)
+              else
+                []
+              end
+      files.find { |f| sanitized_path(f.path) == path }
+    end
+
+    def ensure_file(file)
+      render_404 if file.nil?
+    end
+
+    def ensure_directory
+      render_404 unless Dir.exist?(directory_path)
+    end
+  end
+end

data/lib/jekyll-admin/page_without_a_file.rb

@@ -0,0 +1,7 @@
+module JekyllAdmin
+  class PageWithoutAFile < Jekyll::Page
+    def read_yaml(*)
+      @data ||= {}
+    end
+  end
+end

data/lib/jekyll-admin/path_helper.rb

@@ -0,0 +1,74 @@
+module JekyllAdmin
+  module PathHelper
+    def sanitized_path(path)
+      path = path_without_site_source(path)
+      Jekyll.sanitized_path JekyllAdmin.site.source, path
+    end
+
+    # Returns the basename + extension for the requested file
+    def filename
+      params["ext"] ||= "yml" if namespace == "data"
+      "#{params["path"]}.#{params["ext"]}"
+    end
+
+    # Returns the sanitized path relative to the site source
+    def sanitized_relative_path(path)
+      path_without_site_source sanitized_path(path)
+    end
+
+    # Returns the sanitized absolute path to the requested object
+    def absolute_path
+      sanitized_path File.join(directory_path, filename)
+    end
+    alias_method :path, :absolute_path
+
+    # Returns the sanitized relative path to the requested object
+    def relative_path
+      sanitized_relative_path absolute_path
+    end
+
+    # Returns the sanitized absolute path to write the requested object
+    def write_path
+      if renamed?
+        sanitized_path request_payload["path"]
+      else
+        path
+      end
+    end
+    alias_method :request_path, :write_path
+
+    # Returns the sanitized relative path to write the requested object
+    def relative_write_path
+      sanitized_relative_path write_path
+    end
+
+    # Is this request renaming a file?
+    def renamed?
+      return false unless request_payload["path"]
+      ensure_leading_slash(request_payload["path"]) != relative_path
+    end
+
+    private
+
+    # Returns the path to the requested file's containing directory
+    def directory_path
+      case namespace
+      when "collections"
+        sanitized_path File.join(collection.relative_directory, params["splat"].first)
+      when "data"
+        sanitized_path File.join(DataFile.data_dir, params["splat"].first)
+      else
+        sanitized_path params["splat"].first
+      end
+    end
+
+    def ensure_leading_slash(input)
+      return input if input.nil? || input.empty? || input.start_with?("/")
+      "/#{input}"
+    end
+
+    def path_without_site_source(path)
+      path.to_s.gsub(%r!\A#{Regexp.escape(JekyllAdmin.site.source)}!, "")
+    end
+  end
+end

data/lib/jekyll-admin/public/03945ac4fc7fdefc44bc110bf1ba2393.svg

@@ -0,0 +1,18 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg xmlns="http://www.w3.org/2000/svg">
+<metadata>Copyright (C) 2015 by original authors @ fontello.com</metadata>
+<defs>
+<font id="rw-widgets" horiz-adv-x="1000" >
+<font-face font-family="rw-widgets" font-weight="400" font-stretch="normal" units-per-em="1000" ascent="850" descent="-150" />
+<missing-glyph horiz-adv-x="1000" />
+<glyph glyph-name="up-dir" unicode="&#xe800;" d="m571 171q0-14-10-25t-25-10h-500q-15 0-25 10t-11 25 11 26l250 250q10 10 25 10t25-10l250-250q10-11 10-26z" horiz-adv-x="571.4" />
+<glyph glyph-name="left-dir" unicode="&#xe801;" d="m357 600v-500q0-14-10-25t-26-11-25 11l-250 250q-10 11-10 25t10 25l250 250q11 11 25 11t26-11 10-25z" horiz-adv-x="357.1" />
+<glyph glyph-name="right-dir" unicode="&#xe802;" d="m321 350q0-14-10-25l-250-250q-11-11-25-11t-25 11-11 25v500q0 15 11 25t25 11 25-11l250-250q10-10 10-25z" horiz-adv-x="357.1" />
+<glyph glyph-name="down-dir" unicode="&#xe803;" d="m571 457q0-14-10-25l-250-250q-11-11-25-11t-25 11l-250 250q-11 11-11 25t11 25 25 11h500q14 0 25-11t10-25z" horiz-adv-x="571.4" />
+<glyph glyph-name="calendar" unicode="&#xe804;" d="m71-79h161v161h-161v-161z m197 0h178v161h-178v-161z m-197 197h161v178h-161v-178z m197 0h178v178h-178v-178z m-197 214h161v161h-161v-161z m411-411h179v161h-179v-161z m-214 411h178v161h-178v-161z m428-411h161v161h-161v-161z m-214 197h179v178h-179v-178z m-196 482v161q0 7-6 12t-12 6h-36q-7 0-12-6t-6-12v-161q0-7 6-13t12-5h36q7 0 12 5t6 13z m410-482h161v178h-161v-178z m-214 214h179v161h-179v-161z m214 0h161v161h-161v-161z m18 268v161q0 7-5 12t-13 6h-35q-8 0-13-6t-5-12v-161q0-7 5-13t13-5h35q8 0 13 5t5 13z m215 36v-715q0-29-22-50t-50-21h-786q-29 0-50 21t-21 50v715q0 29 21 50t50 21h72v54q0 36 26 63t63 26h36q37 0 63-26t26-63v-54h214v54q0 36 27 63t63 26h35q37 0 63-26t27-63v-54h71q29 0 50-21t22-50z" horiz-adv-x="928.6" />
+<glyph glyph-name="clock" unicode="&#xe805;" d="m500 546v-250q0-7-5-12t-13-5h-178q-8 0-13 5t-5 12v36q0 8 5 13t13 5h125v196q0 8 5 13t12 5h36q8 0 13-5t5-13z m232-196q0 83-41 152t-110 111-152 41-153-41-110-111-41-152 41-152 110-111 153-41 152 41 110 111 41 152z m125 0q0-117-57-215t-156-156-215-58-216 58-155 156-58 215 58 215 155 156 216 58 215-58 156-156 57-215z" horiz-adv-x="857.1" />
+<glyph glyph-name="search" unicode="&#xe806;" d="m643 386q0 103-74 176t-176 74-177-74-73-176 73-177 177-73 176 73 74 177z m286-465q0-29-22-50t-50-21q-30 0-50 21l-191 191q-100-69-223-69-80 0-153 31t-125 84-84 125-31 153 31 152 84 126 125 84 153 31 152-31 126-84 84-126 31-152q0-123-69-223l191-191q21-21 21-51z" horiz-adv-x="928.6" />
+</font>
+</defs>
+</svg>