jekyll-notion-cms 1.0.0

data/docs/templates/github-actions_notion-sync.yml

@@ -0,0 +1,101 @@
+name: Notion Sync Workflow
+
+on:
+  workflow_dispatch:
+    inputs:
+      notion_event:
+        description: 'Type of Notion event'
+        required: true
+        type: string
+      page_id:
+        description: 'Notion page ID'
+        required: true
+        type: string
+      database_id:
+        description: 'Notion database ID'
+        required: true
+        type: string
+      updated_at:
+        description: 'Last update timestamp'
+        required: true
+        type: string
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      
+      - name: Process Notion update
+        env:
+          NOTION_EVENT: ${{ inputs.notion_event }}
+          PAGE_ID: ${{ inputs.page_id }}
+          DATABASE_ID: ${{ inputs.database_id }}
+          UPDATED_AT: ${{ inputs.updated_at }}
+        run: |
+          echo "📝 Notion event: $NOTION_EVENT"
+          echo "🆔 Page ID: $PAGE_ID"
+          echo "🗄️  Database ID: $DATABASE_ID"
+          echo "⏰ Updated at: $UPDATED_AT"
+          
+          # Ajoutez votre logique ici
+          # Exemples:
+          # - Regénérer un site statique
+          # - Déployer du contenu
+          # - Synchroniser avec un autre service
+          # - Envoyer des notifications
+      
+      - name: Your custom action
+        run: |
+          echo "🚀 Executing your custom logic..."
+          # Votre code personnalisé ici
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Ruby
+        # https://github.com/ruby/setup-ruby/releases/tag/v1.207.0
+        uses: ruby/setup-ruby@4a9ddd6f338a97768b8006bf671dfbad383215f4
+        with:
+          ruby-version: '3.3.5' # Not needed with a .ruby-version file
+          bundler-cache: true # runs 'bundle install' and caches installed gems automatically
+          cache-version: 0 # Increment this number if you need to re-download cached gems
+      - name: Setup Pages
+        id: pages
+        uses: actions/configure-pages@v5
+      - name: Build with Jekyll
+        # Outputs to the './_site' directory by default
+        run: bundle exec jekyll build
+        env:
+          JEKYLL_ENV: production
+          NOTION_TOKEN: ${{ secrets.NOTION_TOKEN }}
+          # Add your Notion database secrets below:
+          # NOTION_BLOG_DB: ${{ secrets.NOTION_BLOG_DB }}
+          # NOTION_PROJECTS_DB: ${{ secrets.NOTION_PROJECTS_DB }}
+          # NOTION_EXPERIENCES_DB: ${{ secrets.NOTION_EXPERIENCES_DB }}
+          # NOTION_SKILLS_DB: ${{ secrets.NOTION_SKILLS_DB }}
+          # NOTION_SERVICES_DB: ${{ secrets.NOTION_SERVICES_DB }}
+          # NOTION_TESTIMONIALS_DB: ${{ secrets.NOTION_TESTIMONIALS_DB }}
+      - name: Upload artifact
+        # Automatically uploads an artifact from the './_site' directory by default
+        uses: actions/upload-pages-artifact@v3
+
+  # Deployment job
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

data/docs/templates/n8n-workflow_Notion-database-change-trigger-GitHub-Actions.json

@@ -0,0 +1,184 @@
+{
+  "name": "Notion to GitHub Actions Sync",
+  "nodes": [
+    {
+      "parameters": {
+        "resource": "workflow",
+        "owner": {
+          "mode": "list",
+          "value": "YOUR_GITHUB_USERNAME"
+        },
+        "repository": {
+          "__rl": true,
+          "value": "your-repository-name",
+          "mode": "list",
+          "cachedResultName": "your-repository-name",
+          "cachedResultUrl": "https://github.com/YOUR_GITHUB_USERNAME/your-repository-name"
+        },
+        "workflowId": {
+          "__rl": true,
+          "value": 123456789,
+          "mode": "list",
+          "cachedResultName": "Notion Sync Workflow"
+        },
+        "ref": {
+          "__rl": true,
+          "value": "main",
+          "mode": "list",
+          "cachedResultName": "main"
+        },
+        "inputs": "={\n  \"notion_event\": \"event\",\n  \"page_id\": \"{{ $json.id }}\",\n  \"database_id\": \"skills\",\n  \"updated_at\": \"=now\"\n}"
+      },
+      "id": "github-dispatch-1",
+      "name": "Trigger GitHub Action",
+      "type": "n8n-nodes-base.github",
+      "position": [
+        608,
+        304
+      ],
+      "typeVersion": 1.1,
+      "credentials": {
+        "githubApi": {
+          "id": "YOUR_GITHUB_CREDENTIAL_ID",
+          "name": "GitHub account"
+        }
+      }
+    },
+    {
+      "parameters": {
+        "pollTimes": {
+          "item": [
+            {
+              "mode": "everyHour"
+            }
+          ]
+        },
+        "event": "pagedUpdatedInDatabase",
+        "databaseId": {
+          "__rl": true,
+          "value": "YOUR_NOTION_DATABASE_ID",
+          "mode": "list",
+          "cachedResultName": "Your Database Name",
+          "cachedResultUrl": "https://www.notion.so/YOUR_NOTION_DATABASE_ID"
+        }
+      },
+      "type": "n8n-nodes-base.notionTrigger",
+      "typeVersion": 1,
+      "position": [
+        0,
+        96
+      ],
+      "id": "notion-trigger-1",
+      "name": "Notion Trigger",
+      "credentials": {
+        "notionApi": {
+          "id": "YOUR_NOTION_CREDENTIAL_ID",
+          "name": "Notion account"
+        }
+      }
+    },
+    {
+      "parameters": {
+        "pollTimes": {
+          "item": [
+            {
+              "mode": "everyHour"
+            }
+          ]
+        },
+        "databaseId": {
+          "__rl": true,
+          "value": "YOUR_NOTION_DATABASE_ID_2",
+          "mode": "list",
+          "cachedResultName": "Your Second Database",
+          "cachedResultUrl": "https://www.notion.so/YOUR_NOTION_DATABASE_ID_2"
+        }
+      },
+      "type": "n8n-nodes-base.notionTrigger",
+      "typeVersion": 1,
+      "position": [
+        0,
+        304
+      ],
+      "id": "notion-trigger-2",
+      "name": "Notion Trigger 2",
+      "credentials": {
+        "notionApi": {
+          "id": "YOUR_NOTION_CREDENTIAL_ID",
+          "name": "Notion account"
+        }
+      }
+    },
+    {
+      "parameters": {
+        "chatId": "YOUR_TELEGRAM_CHAT_ID",
+        "text": "=Deployment via GitHub Action successfully triggered!",
+        "additionalFields": {
+          "appendAttribution": false
+        }
+      },
+      "id": "telegram-notification-1",
+      "name": "Send Notification",
+      "type": "n8n-nodes-base.telegram",
+      "position": [
+        880,
+        304
+      ],
+      "typeVersion": 1.2,
+      "credentials": {
+        "telegramApi": {
+          "id": "YOUR_TELEGRAM_CREDENTIAL_ID",
+          "name": "Telegram Bot"
+        }
+      }
+    }
+  ],
+  "pinData": {},
+  "connections": {
+    "Notion Trigger": {
+      "main": [
+        [
+          {
+            "node": "Trigger GitHub Action",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    },
+    "Notion Trigger 2": {
+      "main": [
+        [
+          {
+            "node": "Trigger GitHub Action",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    },
+    "Trigger GitHub Action": {
+      "main": [
+        [
+          {
+            "node": "Send Notification",
+            "type": "main",
+            "index": 0
+          }
+        ]
+      ]
+    }
+  },
+  "active": false,
+  "settings": {
+    "executionOrder": "v1",
+    "saveDataErrorExecution": "all",
+    "saveDataSuccessExecution": "all",
+    "saveManualExecutions": true,
+    "saveExecutionProgress": true
+  },
+  "meta": {
+    "templateCredsSetupCompleted": false
+  },
+  "tags": []
+}

data/lib/jekyll-notion-cms.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require 'jekyll'
+require_relative 'jekyll_notion_cms/version'
+require_relative 'jekyll_notion_cms/notion_client'
+require_relative 'jekyll_notion_cms/property_extractors'
+require_relative 'jekyll_notion_cms/data_organizers'
+require_relative 'jekyll_notion_cms/generator'
+
+module JekyllNotionCMS
+  class Error < StandardError; end
+  class ConfigurationError < Error; end
+  class APIError < Error; end
+end

data/lib/jekyll_notion_cms/data_organizers.rb

@@ -0,0 +1,229 @@
+# frozen_string_literal: true
+
+module JekyllNotionCMS
+  # Module for organizing Notion data into different structures
+  module DataOrganizers
+    module_function
+
+    # Organize data based on the specified organizer type
+    # @param notion_data [Hash] Raw data from Notion API
+    # @param config [Hash] Collection configuration
+    # @return [Hash, Array] Organized data
+    def organize(notion_data, config)
+      organizer = config['organizer'] || 'simple_list'
+      properties_config = config['properties'] || []
+      sort_by = config['sort_by']
+      sort_order = config['sort_order'] || 'asc'
+
+      case organizer
+      when 'simple_list'
+        organize_simple_list(notion_data, properties_config, sort_by, sort_order)
+      when 'items_by_category'
+        organize_items_by_category(notion_data, properties_config)
+      when 'grouped_by'
+        group_field = config['group_by']
+        organize_grouped_by(notion_data, properties_config, group_field, sort_by, sort_order)
+      when 'nested'
+        parent_field = config['parent_field'] || 'parent_id'
+        organize_nested(notion_data, properties_config, parent_field, sort_by, sort_order)
+      else
+        organize_simple_list(notion_data, properties_config, sort_by, sort_order)
+      end
+    end
+
+    # Organize as a simple sorted list
+    # @param notion_data [Hash] Raw data from Notion API
+    # @param properties_config [Array<Hash>] Property configuration
+    # @param sort_by [String] Field to sort by
+    # @param sort_order [String] Sort order ('asc' or 'desc')
+    # @return [Array<Hash>] Sorted list of items
+    def organize_simple_list(notion_data, properties_config, sort_by, sort_order)
+      items = notion_data['results'].map do |page|
+        item = PropertyExtractors.extract_all(page['properties'], properties_config)
+        item['id'] = page['id']
+        item['created_time'] = page['created_time']
+        item['last_edited_time'] = page['last_edited_time']
+        item
+      end
+
+      # Filter out items without title
+      items = items.select { |item| item['title'] && !item['title'].to_s.empty? }
+
+      # Sort if sort_by is specified
+      sort_items(items, sort_by, sort_order)
+    end
+
+    # Organize items grouped by category
+    # Useful for skills, products, team members, or any items with category grouping
+    # @param notion_data [Hash] Raw data from Notion API
+    # @param properties_config [Array<Hash>] Property configuration
+    # @return [Hash] Items grouped by category
+    def organize_items_by_category(notion_data, _properties_config)
+      items_by_category = {}
+
+      notion_data['results'].each do |page|
+        properties = page['properties']
+
+        name = PropertyExtractors.extract(properties, 'Name', 'title')
+        next if name.nil? || name.empty?
+
+        level = PropertyExtractors.extract(properties, 'Level', 'number')
+        years = PropertyExtractors.extract(properties, 'Years', 'number')
+        featured = PropertyExtractors.extract(properties, 'Featured', 'checkbox')
+        order = PropertyExtractors.extract(properties, 'Order', 'number')
+        category_name = PropertyExtractors.extract(properties, 'Category', 'rollup') || 'Other'
+        category_icon = PropertyExtractors.extract(properties, 'Icon', 'rollup')
+        category_color = PropertyExtractors.extract(properties, 'Color', 'rollup')
+        category_order = PropertyExtractors.extract(properties, 'Category Order', 'rollup')
+
+        items_by_category[category_name] ||= {
+          'title' => category_name,
+          'category' => category_name,
+          'subcategory' => nil,
+          'icon' => category_icon,
+          'order' => category_order || 999,
+          'items' => []
+        }
+
+        items_by_category[category_name]['items'] << {
+          'name' => name,
+          'level' => level,
+          'years' => years,
+          'description' => nil,
+          'icon' => nil,
+          'color' => category_color,
+          'featured' => featured,
+          'order' => order || 999,
+          'id' => page['id']
+        }
+      end
+
+      # Sort categories by order
+      items_by_category = items_by_category.sort_by { |_, data| data['order'].to_i }.to_h
+
+      # Sort items within each category
+      items_by_category.each_value do |data|
+        data['items'].sort_by! { |item| item['order'].to_i }
+      end
+
+      items_by_category
+    end
+
+    # Organize items grouped by a field
+    # @param notion_data [Hash] Raw data from Notion API
+    # @param properties_config [Array<Hash>] Property configuration
+    # @param group_field [String] Field to group by
+    # @param sort_by [String] Field to sort by within groups
+    # @param sort_order [String] Sort order
+    # @return [Hash] Items grouped by field
+    def organize_grouped_by(notion_data, properties_config, group_field, sort_by, sort_order)
+      grouped = {}
+
+      notion_data['results'].each do |page|
+        item = PropertyExtractors.extract_all(page['properties'], properties_config)
+        item['id'] = page['id']
+
+        next if item['title'].nil? || item['title'].to_s.empty?
+
+        group_key = item[group_field]
+        group_key = group_key.first if group_key.is_a?(Array)
+        group_key ||= 'Other'
+
+        grouped[group_key] ||= []
+        grouped[group_key] << item
+      end
+
+      # Sort within groups
+      grouped.each_value do |items|
+        sort_items(items, sort_by, sort_order)
+      end
+
+      grouped
+    end
+
+    # Organize items in a nested tree structure
+    # @param notion_data [Hash] Raw data from Notion API
+    # @param properties_config [Array<Hash>] Property configuration
+    # @param parent_field [String] Field containing parent reference
+    # @param sort_by [String] Field to sort by
+    # @param sort_order [String] Sort order
+    # @return [Array<Hash>] Nested tree of items
+    def organize_nested(notion_data, properties_config, parent_field, sort_by, sort_order)
+      items = {}
+      roots = []
+
+      # First pass: extract all items
+      notion_data['results'].each do |page|
+        item = PropertyExtractors.extract_all(page['properties'], properties_config)
+        item['id'] = page['id']
+        item['children'] = []
+        items[page['id']] = item
+      end
+
+      # Second pass: build tree structure
+      items.each_value do |item|
+        parent_ids = item[parent_field]
+        parent_id = parent_ids.is_a?(Array) ? parent_ids.first : parent_ids
+
+        if parent_id && items[parent_id]
+          items[parent_id]['children'] << item
+        else
+          roots << item
+        end
+      end
+
+      # Sort at each level
+      sort_nested(roots, sort_by, sort_order)
+
+      roots
+    end
+
+    # Sort items by field
+    # @param items [Array<Hash>] Items to sort
+    # @param sort_by [String] Field to sort by
+    # @param sort_order [String] Sort order ('asc' or 'desc')
+    # @return [Array<Hash>] Sorted items
+    def sort_items(items, sort_by, sort_order)
+      return items unless sort_by && !sort_by.empty?
+
+      items.sort_by! do |item|
+        value = item[sort_by]
+        case value
+        when nil then sort_order == 'desc' ? -Float::INFINITY : Float::INFINITY
+        when Numeric then value
+        when String then value.downcase
+        when Hash then value['start'] || '' # For date objects
+        else value.to_s.downcase
+        end
+      end
+
+      items.reverse! if sort_order == 'desc'
+      items
+    end
+
+    # Recursively sort nested items
+    # @param items [Array<Hash>] Items to sort
+    # @param sort_by [String] Field to sort by
+    # @param sort_order [String] Sort order
+    def sort_nested(items, sort_by, sort_order)
+      sort_items(items, sort_by, sort_order)
+
+      items.each do |item|
+        sort_nested(item['children'], sort_by, sort_order) if item['children']&.any?
+      end
+    end
+
+    # Check if data is present (non-empty)
+    # @param data [Hash, Array] Data to check
+    # @return [Boolean] True if data is present
+    def data_present?(data)
+      return false if data.nil?
+
+      if data.is_a?(Hash)
+        data.size.positive?
+      else
+        data.length.positive?
+      end
+    end
+  end
+end