_config.yml

# Welcome to Jekyll!
#
# This config file is meant for settings that affect your whole blog, values
# which you are expected to set up once and rarely edit after that. If you find
# yourself editing this file very often, consider using Jekyll's data files
# feature for the data you need to update frequently.
#
# For technical reasons, this file is *NOT* reloaded automatically when you use
# 'bundle exec jekyll serve'. If you change this file, please restart the server process.

# Site settings
# These are used to personalize your new site. If you look in the HTML files,
# you will see them accessed via {{ site.title }}, {{ site.email }}, and so on.
# You can create any custom variable you would like, and they will be accessible
# in the templates via {{ site.myvariable }}.
title: Internet Public Library
email: admin@iplibrary.org
description: >- # this means to ignore newlines until "baseurl:"
  The Internet Public Library (IPL) is a free encyclopedia of curated internet resources,
  organized by category and maintained by a global community of contributors.
baseurl: "" # the subpath of your site, e.g. /blog
url: "https://ipl.better-web.org" # the base hostname & protocol for your site
twitter_username: internetpubliclibrary
github_username: InternetPublicLibrary

# File encoding
encoding: UTF-8

# Enable dynamic page generation
enable_dynamic_pages: false

# Intelligent page generation system
enable_intelligent_page_generation: false

# Enhanced API system
api:
  version: "2.0"
  enabled: true
  cache_duration: 3600

# Giscus configuration
giscus:
  en:
    repo: "InternetPublicLibrary/en-US"
    repo_id: "MDEwOlJlcG9zaXRvcnkxMzE5MzIxNzk="
    category: "General"
    category_id: "DIC_kwDOB90gE84CrNxh"
  pt:
    repo: "InternetPublicLibrary/pt-BR"
    repo_id: "MDEwOlJlcG9zaXRvcnkxMzE5MzI0NzA="
    category: "General"
    category_id: "DIC_kwDOB90hNs4CrNxb"

# Staticman settings for wiki-like contributions
staticman:
  branch: "main"
  # Instance hosted on Heroku (replace with your own instance URL)
  endpoint: "https://api.staticman.net/v2/entry"
  # GitHub repositories
  repositories:
    en:
      name: "InternetPublicLibrary/en-US"
      branch: "main"
    pt:
      name: "InternetPublicLibrary/pt-BR" 
      branch: "main"
  # Allowed fields in forms (customize per form as needed)
  allowedFields: ["name", "email", "url", "message", "title", "description", "content", "tags", "category"]
  # Whether to send PR notification to PR authors
  notifications:
    enabled: true
  # Secret used to secure communication with Staticman
  secret: "REPLACE_WITH_YOUR_SECRET"
  # reCAPTCHA configuration
  # Off until contribute (spec 003) replaces Staticman; the site key below is a placeholder.
  recaptcha:
    enabled: false
    siteKey: "REPLACE_WITH_YOUR_SITE_KEY"
    secret: "REPLACE_WITH_YOUR_SECRET"

# Build settings
plugins:
  - jekyll-admin
  - jekyll-feed
  - jekyll-mentions
  - jemoji
  - jekyll-redirect-from
  - jekyll-sitemap
  - jekyll-seo-tag
  - jekyll-paginate
  - jekyll-gist

markdown: kramdown

# Explicitly allow custom plugins
safe: false

# Exclude from processing.
# The following items will not be processed, by default. Create a custom list
# to override the default setting.
exclude:
  # Package managers and dependencies
  - Gemfile
  - Gemfile.lock
  - package.json
  - yarn.lock
  - node_modules/
  - vendor/
  - vendor/bundle/
  - vendor/cache/
  - vendor/gems/
  - vendor/ruby/
  
  # Development and documentation files
  - README.md
  - en-US/README.md
  - pt-BR/README.md
  - AGENTS.md
  - TODO.md
  - claude.md
  - LICENSE
  # Submodule repo licenses collide with /<lang>/license/ on case-insensitive filesystems
  - en-US/LICENSE
  - pt-BR/LICENSE
  - Makefile
  - Rakefile
  - build.sh
  - tree.txt
  - metadata.json
  - redirects.json
  
  # Development/debug directories and files
  - debug_data/
  - test_debug/
  - docs/
  - scripts/
  - test/
  - e2e/
  - pages/
  - _plugins_bak/
  - _en-US_bak/
  
  # Ruby/Jekyll development files
  - "*.rb"
  - fix_indices.rb
  
  # Editor and IDE files
  - .vscode/
  - .idea/
  - "*.swp"
  - "*.swo"
  - .DS_Store
  
  # Git files (except .git which is already ignored)
  - .gitignore
  - .gitattributes
  
  # Temporary files
  - tmp/
  - temp/
  - "*.log"








# PAGE GENERATION CONFIGURATION
# Controls how pages are generated to prevent duplication
page_generation:
  # Strategy: 'rake' (Rakefile only), 'jekyll' (plugins only), 'hybrid' (both with coordination)
  strategy: 'jekyll'
  # Enable caching for faster builds
  enable_caching: true
  # Skip Jekyll plugins when using Rake strategy
  skip_jekyll_plugins: false

# Legacy settings (deprecated - use page_generation.strategy instead)
enable_menu_pages: true
enable_wiki_pages: true

# Track generated pages between plugin executions to prevent conflicts
page_registry: true

# Default language
lang: "en-US"
languages:
  - code: "en-US"
    name: "English (US)"
    dir: "en-US"
  - code: "pt-BR"
    name: "Português (Brasil)"
    dir: "pt-BR"

# Permalink structure
permalink: /:categories/:title/

# Collections configuration
collections:
  resources:
    output: true
    permalink: /:collection/:path/

# Defaults for pages
defaults:
  - scope:
      path: ""
    values:
      layout: "default"
  - scope:
      path: "en-US"
    values:
      lang: "en-US"
  - scope:
      path: "pt-BR"
    values:
      lang: "pt-BR"