jekyll-notion 0.1.4 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b38cf8b23326c2c3194070cf8524128f90b479a7f98f7380eaa0f43d1beaa211
-  data.tar.gz: 359ffd254d24ad6fbc1d3fc5ca4ab389a098fae102577f2ed2ecb9f4b6ee1cb4
+  metadata.gz: 1c220aa475033e8ddb50ef928b9104c3b8d5da793bbe777062783eb5fbd1491e
+  data.tar.gz: c99b1e1b3cebbc00420d8b857e545fa9ae6ac83aad4da110fabf780a0c42a816
 SHA512:
-  metadata.gz: 9c2b17935b8c5512650a1eb5bfa2dddfca7aad405ca3482ec2ae8a5cb2b4157b70df1be10956075c275d4ab839c1c3156366e85c533c64e34c206167204878de
-  data.tar.gz: 2047c8d35e0713edc09253fb44ecd20bc364a6daa4a21620f9431951b5a41ac7c55c2171441364c3b21e474d1340bef2129612b2069b571930f9797c35d10c06
+  metadata.gz: 74c1c36de04d025b121fce5634bfdd739796880208114e1dcdac9f49ec2302b16188f54abb1f8bafc07b3911627a2753e6e6c8d750559384ea9bfb94f1c25cb0
+  data.tar.gz: a42ae853c9371cd60ffd6e4cd00cc47e02c9eee64d44579ec1ea88f1e4c0e64208a536cec7bc2fea0c6ab1b6ea00b6dcdde23d5aa1110190b48e7e3b6bceabc3

data/README.md

@@ -32,13 +32,48 @@ Export the notion secret token in an environment variable named `NOTION_TOKEN`.
 $ export NOTION_TOKEN=<secret_...>
 ```
 
-Once your notion database has been shared, specify the `id` in your `_config.yml` as follows.
+Once your notion database has been shared, specify the  database `id` in your `_config.yml` as follows.
 
 ```yml
 notion:
-  fetch_on_watch: false
   database:
-    id: b91d5...
+    id: e42383cd-4975-4897-b967-ce453760499f
+```
+
+### Mutiple dabatases
+
+You can also define multiple databases as follows.
+
+```yml
+collections:
+  - recipes
+  - films
+
+notion:
+  databases:
+    - id: b0e688e1-99af-4295-ae80-b67eb52f2e2f
+    - id: 2190450d-4cb3-4739-a5c8-340c4110fe21
+      collection: recipes
+    - id: e42383cd-4975-4897-b967-ce453760499f 
+      collection: films
+```
+
+When no collection is defined, the `posts` collection is used by default.
+
+### Database options
+
+Each dabatase support the following options.
+
+* `id`: the notion database unique identifier,
+* `collection`: the collection each page belongs to (posts by default),
+* `filter`: the database query filter,
+* `sort`: the database query sort,
+* `frontmatter`: additional front matter to append to each page in the collection.
+
+```yml
+notion:
+  database:
+    id: e42383cd-4975-4897-b967-ce453760499f
     collection: posts
     filter: { "property": "Published", "checkbox": { "equals": true } }
     sort: { "property": "Last ordered", "direction": "ascending" }
@@ -46,47 +81,51 @@ notion:
       layout: post
 ```
 
-`fetch_on_watch` when set to `true` it allows fetching notion pages on each rebuild. By default is off, pages are only retrieved in the first build.
+Note that you can also use [front matter defaults](https://jekyllrb.com/docs/configuration/front-matter-defaults/) to declare common key value pairs per collection.
 
-`database` properties are:
-* `id`: the notion database unique identifier,
-* `collection`: the collection each page belongs to (posts by default),
-* `filter`: the database query filter,
-* `sort`: the database query sort,
-* `frontmatter`: additional frontmatter to append to each page in the collection.
+### Watch
 
-Note: Only one notion database is available.
+By default, databases are only requested during the first build. Subsequent builds use the results from the cache.
+
+Set `fetch_on_watch` to true to allow request on each rebuild.
+
+```yml
+notion:
+  fetch_on_watch: true
+  database:
+    id: e42383cd-4975-4897-b967-ce453760499f
+```
 
 And that's all. Each page in the notion database will be included in the selected collection.
 
 ## Notion properties
 
-Below, page notion default properties are set in each page frontmatter.
+Below, default properties per notion page are set for each document front matter.
 
-Default properties include  `title`, created_time`, `last_edited_time`, `icon` and `cover.
+Notion properties include page `id`, `title`, `created_time`, `last_edited_time`, `icon` and `cover`.
 
 ```
 ---
-id: b2998...
-title: A title
+id: e42383cd-4975-4897-b967-ce453760499f
+title: An amazing post
 cover: https://img.bank.sh/an_image.jpg
 date: 2022-01-23T12:31:00.000Z
 icon: \U0001F4A5
 ---
 ```
 
-Any property provided in the frontmatter config that matches a default property will be overwritten by the default value.
+Default properties prevail over custom properties declared in the front matter config.
 
 ### Custom properties
 
 In addition to default properties, custom properties are also supported.
 
-Custom properties are appended to page frontmatter by default. Every property name is snake-cased.
+Custom properties are appended to the page frontmatter by default. Every property name are downcased and snake-cased.
 For example, two properties named `Multiple Options` and `Tags` will be transformed to `multiple_options` and `tags`, respectively.
 
 ```
 ---
-id: b2998...
+id: 2190450d-4cb3-4739-a5c8-340c4110fe21
 title: A title
 cover: https://img.bank.sh/an_image.jpg
 date: 2022-01-23T12:31:00.000Z
@@ -96,7 +135,7 @@ multiple_options: option1, option2
 ---
 ```
 
-The supported properties are:
+The supported property types are:
 
 * `number`
 * `select`

data/lib/jekyll-notion/generator.rb

@@ -2,50 +2,79 @@
 
 module JekyllNotion
   class Generator < Jekyll::Generator
-    attr_reader :current_page
+    attr_reader :current_page, :current_db
 
     def generate(site)
       @site = site
 
       return unless notion_token? && config?
 
-      if fetch_on_watch? || docs.empty?
+      if fetch_on_watch? || collections.empty?
         read_notion_database
       else
-        collection.docs = docs
+        collections.each_pair { |key, val| @site.collections[key] = val }
       end
     end
 
+    protected
+
     def read_notion_database
-      @db = NotionDatabase.new(:config => config)
-      @db.pages.each do |page|
-        @current_page = page
-        collection.docs << make_page
-        Jekyll.logger.info("Jekyll Notion:", "New notion page at #{collection.docs.last.path}")
+      databases.each do |db_config|
+        @current_db = NotionDatabase.new(:config => db_config)
+        @current_db.pages.each do |page|
+          @current_page = page
+          next if file_exists?(make_path)
+
+          current_collection.docs << make_page
+          log_new_page
+        end
+        # Store current collection
+        collections[current_db.collection] = current_collection
       end
-      @docs = collection.docs
     end
 
-    def docs
-      @docs ||= []
+    def databases
+      config["databases"] || [config["database"]]
+    end
+
+    def collections
+      @collections ||= {}
+    end
+
+    # Checks if a file already exists in the site source
+    def file_exists?(file_path)
+      File.exist? @site.in_source_dir(file_path)
     end
 
     def make_page
       new_post = DocumentWithoutAFile.new(
-        "#{Dir.pwd}/_#{collection_name}/#{make_filename}",
-        { :site => @site, :collection => collection }
+        make_path,
+        { :site => @site, :collection => current_collection }
       )
       new_post.content = "#{make_frontmatter}\n\n#{make_md}"
       new_post.read
       new_post
     end
 
+    def make_path
+      "_#{current_db.collection}/#{make_filename}"
+    end
+
+    def make_filename
+      if current_db.collection == "posts"
+        "#{current_page.created_date}-#{Jekyll::Utils.slugify(current_page.title,
+                                                              :mode => "latin")}.md"
+      else
+        "#{current_page.title.downcase.parameterize}.md"
+      end
+    end
+
     def make_md
       NotionToMd::Converter.new(:page_id => current_page.id).convert
     end
 
     def make_frontmatter
-      data = Jekyll::Utils.deep_merge_hashes(config_frontmatter, page_frontmatter)
+      data = Jekyll::Utils.deep_merge_hashes(current_db.frontmatter, page_frontmatter)
       frontmatter = data.to_a.map { |k, v| "#{k}: #{v}" }.join("\n")
       <<~CONTENT
         ---
@@ -58,25 +87,8 @@ module JekyllNotion
       Jekyll::Utils.deep_merge_hashes(current_page.custom_props, current_page.default_props)
     end
 
-    def config_frontmatter
-      config.dig("database", "frontmatter") || {}
-    end
-
-    def make_filename
-      if collection_name == "posts"
-        "#{current_page.created_date}-#{Jekyll::Utils.slugify(current_page.title,
-                                                              :mode => "latin")}.md"
-      else
-        "#{current_page.title.downcase.parameterize}.md"
-      end
-    end
-
-    def collection_name
-      config.dig("database", "collection") || "posts"
-    end
-
-    def collection
-      @site.collections[collection_name]
+    def current_collection
+      @site.collections[current_db.collection]
     end
 
     def config
@@ -102,5 +114,16 @@ module JekyllNotion
       end
       true
     end
+
+    def log_new_page
+      Jekyll.logger.info("Jekyll Notion:", "Page => #{current_page.title}")
+      if @site.config.dig(
+        "collections", current_db.collection, "output"
+      )
+        Jekyll.logger.info("",
+                           "Path => #{current_collection.docs.last.path}")
+      end
+      Jekyll.logger.debug("", "Props => #{page_frontmatter.keys.inspect}")
+    end
   end
 end

data/lib/jekyll-notion/notion_database.rb

@@ -11,28 +11,40 @@ module JekyllNotion
       return [] unless id?
 
       @pages ||= @notion.database_query(query)[:results].map do |page|
-        NotionPage.new(:page => page, :layout => config["layout"])
+        NotionPage.new(:page => page, :layout => layout)
       end
     end
 
-    private
-
     def config
-      @config["database"]
+      @config || {}
     end
 
     def filter
-      @config.dig("database", "filter")
+      config["filter"]
     end
 
     def sort
-      @config.dig("database", "sort")
+      config["sort"]
     end
 
     def id
-      @config.dig("database", "id")
+      config["id"]
+    end
+
+    def frontmatter
+      config["frontmatter"] || {}
+    end
+
+    def collection
+      config["collection"] || "posts"
+    end
+
+    def layout
+      config["layout"]
     end
 
+    private
+
     def id?
       if id.nil? || id.empty?
         Jekyll.logger.warn("Jekyll Notion:",
@@ -43,7 +55,7 @@ module JekyllNotion
     end
 
     def query
-      { :id => id, :filter => filter, :sort => sort }
+      { :id => id, :filter => filter, :sort => sort }.compact
     end
   end
 end

data/lib/jekyll-notion/notion_page.rb

@@ -61,12 +61,12 @@ module JekyllNotion
 
     def default_props
       @default_props ||= {
-        :id           => id,
-        :title        => title,
-        :date         => created_datetime,
-        :cover        => cover,
-        :icon         => icon,
-        :updated_date => updated_datetime,
+        "id"           => id,
+        "title"        => title,
+        "date"         => created_datetime,
+        "cover"        => cover,
+        "icon"         => icon,
+        "updated_date" => updated_datetime,
       }
     end
 
@@ -113,6 +113,10 @@ module JekyllNotion
         def date(prop)
           prop.date.start
         end
+
+        def url(prop)
+          prop.url
+        end
       end
     end
   end

data/lib/jekyll-notion/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module JekyllNotion
-  VERSION = "0.1.4"
+  VERSION = "0.2.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-notion
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.2.1
 platform: ruby
 authors:
 - Enrique Arias
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-02-02 00:00:00.000000000 Z
+date: 2022-02-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport