_config.yml

# Welcome to the configuration file for Jekyll.
# Full docs at: http://jekyllrb.com/docs/configuration/
# YAML docs at: https://yaml.org/spec/1.2.2/
# ---------------------------------------------------------------------------------
#
# 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.
#
# If you need help with YAML syntax, here are some quick references for you: 
# https://learn-the-web.algonquindesign.ca/topics/markdown-yaml-cheat-sheet/#yaml
# https://learnxinyminutes.com/docs/yaml/
#
# You can find config options at: https://jekyllrb.com/docs/configuration/options/
#
# 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 }}.


# Site Settings ###################################################################

founder                  : "Amr"
# Pinned to a release tag so a theme push can never change production without review.
# Bump deliberately: test with both config stacks (dev + azure) before raising.
remote_theme             : "bamr87/zer0-mistakes@v1.26.0"
# theme                    : "jekyll-theme-zer0"  # Commented out - GitHub Pages uses remote_theme instead

## Github Information
github_user              : &github_user "bamr87"
repository_name          : &github_repository "bashconsultants"
repository               : "bamr87/bashconsultants" # GitHub username/repo-name
local_repo               : &local_repo "bashconsultants"
branch                   : &branch "main"
repo_map                 : "/sitemap/"
portfolio                : &portfolio [*github_user, '.', 'github.io']

## Site Information ---------------------------------------------------------------

title                    : &title "BASH Consultants"
title_url                : "/"
title_icon               : "globe"
subtitle                 : "Bourne Again Solutions Hero"
subtitle_url             : "localhost" # set to localhost to develop locally
subtitle_icon            : "code"
dev_mode                 : false
title_separator          : "|" # Appears in the web browser tab name
domain                   : &domain "github"
domain_ext               : &domain_ext "io"
baseurl                  : &baseurl "" # the subpath of your site, e.g. /blog - Use this if you want this whole repo to be a domain branch
url_test                 : &url_test [ 'https', '://', *github_user, '.', *domain, '.', *domain_ext ] # the base hostname & protocol for your site, e.g. http://example.com
url                      : &url https://bashconsultants.com
public_folder            : "/assets"
port                     : 4002 # Jekyll Serve Dev port
dg_port                  : 4001 # TODO: Doppelganger site. Use this if you want to switch between parallel deployments
og_image                 : '/assets/images/office.jpg'

### Owner Information -------------------------------------------------------------

name                     : &name "Amr"
email                    : "amr@bashconsultants.com"
contact-email            : "info@bashconsultants.com"
description              : >- # this `->` means to ignore newlines until the next variable
  Enterprise-grade IT for small business — cloud, ERP, data, and AI-augmented automation from Denver, Colorado
level                    : 'Jedi'

## Maintainer Information----------------------------------------------------------

maintainers:
  - name: *name
    profile: ["https://github.com", "/", *github_user]
  - name: "Vacant"
    profile: "/github.com"

## Personalization ----------------------------------------------------------------

locale                   : "en-US"
home_dir                 : &home '/Users/bamr87/'
local_git                : [ *home, 'github' ]
logo                     : /assets/brand/favicon.svg  # path of logo image to display in the masthead, e.g. "/assets/images/88x88.png"
logo_link                : 'https://bashconsultants.com' # URL to link the logo to, e.g. "/"

teaser                   : '/assets/images/favicon_gpt_computer_retro.png' # path of fallback teaser image, e.g. "/assets/images/500x300.png"
info_banner              : '/assets/images/network.jpg' # path of fallback teaser image, e.g. "/assets/images/500x300.png"

## Preview Image Generation (AI-powered) #####################################
# Settings for automatic preview image generation using AI
# Used by: scripts/generate-preview-images.sh

preview_images:
  enabled                : true
  provider               : 'openai'           # openai, stability, local
  model                  : 'gpt-image-2'      # gpt-image-2 (latest), gpt-image-1, gpt-image-1-mini; dall-e-3 is retired on this account
  size                   : '1536x1024'        # gpt-image landscape: 1536x1024, square: 1024x1024, portrait: 1024x1536, auto
  quality                : 'high'             # gpt-image quality: low, medium, high, auto (DALL-E's 'standard'/'hd' are not valid here)
  style                  : 'retro pixel art, 8-bit video game aesthetic, vibrant colors, nostalgic, clean pixel graphics'
  output_dir             : 'assets/images/previews'
  # Path normalization: allows omitting /assets/ prefix in frontmatter
  # e.g., preview: /images/previews/my-image.png becomes /assets/images/previews/my-image.png
  assets_prefix          : '/assets'          # Prefix to prepend to relative preview paths
  auto_prefix            : true               # Auto-add assets_prefix if path doesn't start with it
  # Additional style modifiers applied to all prompts
  style_modifiers        : 'pixelated, retro gaming style, CRT screen glow effect, limited color palette'

breadcrumbs              : true # true, false (default)
words_per_minute         : 200
_posts_file_structure    : "year-month-day-title.md"

## Identity #####################################################################

author:
  name                   : *name # *name is a YAML reference pointing to the &anchor earlier
  avatar                 : "/assets/images/gravatar-small.png"
  email_hash             : &email_hash '71d7a4fc9712df49e13d606e620f89c7' # https://en.gravatar.com/site/check/{ site.email }
  gravatar               : 'https://s.gravatar.com/avatar/71d7a4fc9712df49e13d606e620f89c7?s=80'
  bio                    : "IT nerd trying to be an IT hero"
  location               : "Denver, CO"
  twitter_username       : "bamr87"
  github_username        : *github_user

## LinkedIn (company page) ####################################################

# Public company-page identity for the org publisher (scripts/features/linkedin)
# and structured data. The org id/URN are public — not secrets. Access tokens
# live only in .env (local) and Actions secrets (CI), never here.
linkedin:
  org_id                   : 64517157
  org_urn                  : "urn:li:organization:64517157"
  company_url              : "https://www.linkedin.com/company/64517157/"
  api_version              : 202606              # LinkedIn-Version (YYYYMM); bump ~yearly

## Site Analytics #############################################################

# Google Analytics and Tag Manager are disabled for privacy — PostHog is the
# sole analytics tool (opt-in, consent-gated). GTM is neutralized by the
# local override in _includes/analytics/google-tag-manager-head.html.
# google_analytics         : 'G-ZBDKNMC168'

# PostHog Analytics Configuration
# https://posthog.com/docs/libraries/js
posthog:
  enabled                : true
  # Public project (write) key for THIS site's PostHog project (504877) — safe to
  # expose in the browser. Was the zer0-mistakes theme's demo key; corrected so
  # analytics reach our own project.
  api_key                : 'phc_mDdKv58vnxxkDJwQBZCrVRiSrnwRmHnwYmadU29tSZKB'
  api_host               : 'https://us.i.posthog.com'   # event ingestion host (US region)
  project_id             : 504877                       # PostHog project id, for scripts/features/posthog
  api_region             : 'us'                         # REST API host = https://us.posthog.com; server-side POSTHOG_API_KEY lives in .env
  person_profiles        : 'identified_only'  # Options: 'always', 'identified_only', 'never'
  autocapture            : true   # Automatically capture clicks, form submissions, etc.
  capture_pageview       : true   # Track page views
  capture_pageleave      : true   # Track when users leave pages
  session_recording      : false  # Enable session recordings (privacy consideration)
  disable_cookie         : false  # Set to true for cookieless tracking
  respect_dnt            : true    # Respect Do Not Track browser setting
  cross_subdomain_cookie : false  # Enable if you have multiple subdomains
  secure_cookie          : true   # Use secure cookies in production
  persistence            : 'localStorage+cookie'  # Options: 'localStorage+cookie', 'cookie', 'memory'
  custom_events:
    track_downloads      : true   # Track PDF, ZIP, etc. downloads
    track_external_links : true   # Track clicks to external websites
    track_search         : true   # Track search queries
    track_scroll_depth   : true   # Track how far users scroll
  privacy:
    mask_all_text        : false  # Mask all text in session recordings
    mask_all_inputs      : true   # Mask form inputs in session recordings
    ip_anonymization     : true   # Anonymize IP: client sends ip:false; project anonymize_ips=true

## Site verification #############################################################

google_site_verification : null
bing_site_verification   : null
alexa_site_verification  : null
yandex_site_verification : null
aver_site_verification   : null
baidu_site_verification  : null

## Affiliations ##############################################################

default_icon: "bi" ## Bootstrap Icons https://icons.getbootstrap.com/

links:
  - label: "Portfolio"
    url: [ 'https://', *github_user, '.github.io/']
    icon: "bi-link"
  - label: "Github"
    icon: "bi-github"
    url: [ 'https://github.com/' , *github_user ]
  - label: "LinkedIn"
    icon: "bi-linkedin"
    url: "https://linkedin.com/in/amrabdel"
  - label: "LinkedIn Page"
    icon: "bi-linkedin"
    url: "https://www.linkedin.com/company/64517157/"

socials:
  - label: "Portfolio"
    url: [ 'https://', *github_user, '.github.io/']
    icon: "bi-link"
  - label: "Github"
    icon: "bi-github"
    url: [ 'https://github.com/' , *github_user ]
  - label: "LinkedIn"
    icon: "bi-linkedin"
    url: "https://linkedin.com/in/amrabdel"
  - label: "LinkedIn Page"
    icon: "bi-linkedin"
    url: "https://www.linkedin.com/company/64517157/"

youtube:
  - label: "YouTube"
    icon: "bi-youtube"
    url: "https://www.youtube.com/channel/UCO0j3Opg3J9i2iWnDwHUsXQ"

## Build Framework ##############################################################

# What actually builds and runs this site. Keep accurate — the footer renders it
# as a credibility signal. Versions track the real toolchain (see Gemfile.azure,
# docker-compose.yml, _config.yml theme pin, scripts/, api/, .github/workflows/).
powered_by:
  - name: "Ruby"
    version: "3.3"
    url: "https://www.ruby-lang.org/"
    icon: "bi-gem"
  - name: "Jekyll"
    version: "3.10"
    url: "https://jekyllrb.com/"
    icon: "bi-joystick"
  - name: "zer0-mistakes"
    version: "1.26.0"
    url: "https://github.com/bamr87/zer0-mistakes"
    icon: "bi-palette"
  - name: "Bootstrap"
    version: "5.3.3"
    url: "https://getbootstrap.com/"
    icon: "bi-bootstrap"
  - name: "Claude"
    version: "Opus 4.8"
    url: "https://www.anthropic.com/claude"
    icon: "bi-robot"
  - name: "OpenAI gpt-image"
    version: "2"
    url: "https://platform.openai.com/docs/guides/image-generation"
    icon: "bi-stars"
  - name: "Python"
    version: "3.13"
    url: "https://www.python.org/"
    icon: "bi-filetype-py"
  - name: "Docker"
    version: "latest"
    url: "https://www.docker.com/"
    icon: "bi-box-seam"
  - name: "GitHub Pages"
    url: "https://pages.github.com/"
    icon: "bi-github"
  - name: "GitHub Actions"
    url: "https://github.com/features/actions"
    icon: "bi-git"
  - name: "Azure Static Web Apps"
    url: "https://azure.microsoft.com/products/app-service/static/"
    icon: "bi-cloud"


### Plugins 
# https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll#plugins
# http://jekyllrb.com/docs/plugins/

# All plugins are enabled by default for GitHub Pages. https://pages.github.com/versions/

plugins:
  - github-pages
  - jekyll-include-cache
  - jekyll-remote-theme
  - jekyll-feed
  - jekyll-sitemap
  - jekyll-seo-tag
  - jekyll-paginate
  - jekyll-relative-links
  # Note: jekyll-mermaid is NOT in GitHub Pages whitelist - it only provides {% mermaid %} Liquid tag
  # Mermaid diagrams work without this plugin via client-side JavaScript (see _includes/components/mermaid.html)
  - jekyll-mermaid

## AI Chat (theme component ZER0-060) ###########################################
# Floating Claude-powered assistant on every page. Renders NOTHING until a usable
# auth path exists: proxy mode requires proxy_ready: true. The proxy ships in this
# repo as an Azure Static Web Apps function (api/chat) — flip proxy_ready to true
# once ANTHROPIC_API_KEY is configured in the SWA app settings. Never use
# auth_mode 'direct' in production: it exposes the API key in page source.

ai_chat:
  enabled                : true
  provider               : 'anthropic'
  auth_mode              : 'proxy'
  proxy_ready            : false               # flip to true once /api/chat is live with a key
  model                  : 'claude-opus-4-8'
  endpoint               : '/api/chat'
  anthropic_version      : '2023-06-01'
  max_tokens             : 1024
  strict_context         : true
  out_of_scope_message   : "I can only answer from the content on this page — for anything else, email info@bashconsultants.com."
  system_prompt          : >-
    You are the assistant for BASH Consulting (bashconsultants.com), a
    Denver-based IT consulting practice for small and medium businesses:
    cloud architecture (AWS, Azure, GCP), ERP implementation (QAD, Infor,
    Oracle), accounting information systems, data and BI, custom software,
    and AI-overlay automation. Answer questions using the current page
    content. Be concise, plain-English, and outcome-focused. If a visitor
    describes a business problem, point them to the matching service page
    and suggest booking a consultation at /contact/. Never quote prices;
    engagements are scoped after a discovery conversation.
  welcome_message        : "Hi — ask about this page, or tell me what's slowing your business down and I'll point you to the right service."
  placeholder            : "Ask about this page..."
  context_max_length     : 2000
  icon                   : 'bi-robot'
  github:
    enabled              : true
    mode                 : 'url'               # pre-filled github.com forms; no token anywhere
    base_branch          : 'main'
    default_labels       : ['from-chat']

## Contact & newsletter form endpoints ###########################################
# Form handlers are config-driven so the site works on any static host.
# Leave an endpoint empty and the template falls back to a mailto: flow.
# contact_endpoint: e.g. a Formspree form URL (https://formspree.io/f/<id>)
#                   or the SWA function /api/contact once deployed.

forms:
  contact_endpoint       : ''
  newsletter_endpoint    : ''

## Gisgus Plugin #################################################################

gisgus:
  enabled: true
  data-repo-id: "MDEwOlJlcG9zaXRvcnkyODM4MjI1NzM"
  data-category-id: "DIC_kwDOEOrJ7c4CAn8D"

# Project resource links (used by landing page and includes)
resources:
  github_repo: [ 'https://github.com/', *github_user, '/', *github_repository ]
  github_fork: [ 'https://github.com/', *github_user, '/', *github_repository, '/fork' ]
  contributing: [ 'https://github.com/', *github_user, '/', *github_repository, '/blob/', *branch, '/CONTRIBUTING.md' ]
  docker:
    image: [ *github_user, '/', *github_repository ]
    hub_url: [ 'https://hub.docker.com/r/', *github_user, '/', *github_repository ]

## Mermaid Diagram Configuration #################################################
# Usage: Add 'mermaid: true' to page front matter and use ```mermaid code blocks
# GitHub Pages Compatible: Yes (client-side rendering)
# Distribution: The theme ships mermaid.min.js in assets/vendor/mermaid/ via the
# gem (gemspec includes assets/) and remote_theme (served from theme's GitHub repo).
# Local dev: npm install && npm run vendor:mermaid (copies from node_modules/)

mermaid:
  src: '/assets/vendor/mermaid/mermaid.min.js'

# https://github.blog/2022-02-14-include-diagrams-markdown-files-mermaid/

## Conversion
# Markdown Options https://jekyllrb.com/docs/configuration/markdown/
# https://github.com/github/jekyll-commonmark-ghpages

markdown: kramdown
# highlighter: rouge
# lsi: false
# excerpt_separator: "\n\n"
# incremental: false

# Markdown Processing https://jekyllrb.com/docs/configuration/markdown/
kramdown: # https://kramdown.gettalong.org/options.html
  input: GFM
  header_offset: 0
  # hard_wrap: false
  # auto_ids: true
  # footnote_nr: 1
  # entity_output: as_char
  toc_levels: 1..6
  # smart_quotes: lsquo,rsquo,ldquo,rdquo
  # enable_coderay: false

# Collections: https://jekyllrb.com/docs/collections/
  # Permalinks: https://jekyllrb.com/docs/permalinks/

collections_dir: &collections_dir pages
local_repo_path: [ *collections_dir, '/', *local_repo ]

collections:
  pages:
    output: true
    permalink: /:collection/:name/
  posts:
    output: true
    permalink: /:collection/:year/:month/:day/:slug/
  # docs:
  #   output: true
  #   permalink: /:collection/:categories/:name/
  # quests:
  #   output: true
  #   permalink: /:collection/:categories/:name/
  # hobbies:
  #   output: true
  #   permalink: /:collection/:categories/:name/
  # notebooks:
  #   output: true
  #   permalink: /:collection/:path/:name/
  # notes:
  #   output: true
  #   permalink: /:collection/:path/:name/
  services:
    output: true
    permalink: /:collection/:categories/:name/
  toolkit:
    output: true
    # Docs live under /tools/<track>/<slug>/ — categories drive the track segment
    # (business | partners). Track landing pages set an explicit permalink.
    permalink: /tools/:categories/:name/
  case-studies:
    output: true
    permalink: /case-studies/:name/
  about:
    output: true
    permalink: /:collection/:categories/:name/

permalink: pretty

#  pagination https://jekyllrb.com/docs/pagination/

paginate: 10
paginate_path: "/pages/:num/"

# Defaults https://jekyllrb.com/docs/configuration/front-matter-defaults/

defaults:
  # ALL
  - 
    scope:
      path: ""
    values:
      layout: root
      author_profile: false
      read_time: true
      comments: false # true
      share: true
      related: true
      sidebar:
        nav: main
    permalink: /:collection/:name/

  # pages
  - 
    scope:
      path: pages
    values:
      layout: &pages default
      author_profile: true
      read_time: true
      comments: # true
      share: true
      related: true
      toc_sticky: true
      sidebar:
        nav: searchCats
    permalink: /:path/:name/

  # pages/_about
  - 
    scope:
      path: pages/_about
    values:
      layout: *pages
      collection: about
      share: true
      related: true
      sidebar:
        nav: dynamic

  # pages/_services
  # -
  #   scope:
  #     path: pages/_services
  #   values:
  #     layout: default
  #     collection: services
  #     share: true
  #     related: true
  #     sidebar:
  #       nav: services

  # pages/_case-studies
  -
    scope:
      path: pages/_case-studies
    values:
      layout: *pages
      collection: case-studies
      author_profile: false
      share: true
      related: true
      sidebar:
        nav: dynamic

  # pages/_toolkit — the BASH toolkit docs/tutorials collection
  -
    scope:
      path: pages/_toolkit
    values:
      layout: *pages
      collection: toolkit
      author: "Amr Abdel-Motaleb"
      author_profile: false
      read_time: true
      share: true
      related: true
      toc_sticky: true
      sidebar:
        nav: toolkit

  # pages/_posts
  - 
    scope:
      path: pages/_posts
    values:
      layout: article
      author_profile: true
      read_time: true
      comments: # true
      share: true
      related: true
      sidebar:
        nav: dynamic
      # permalink: /:collection/:name/

  # pages/_docs
  # - 
  #   scope:
  #     path: pages/_docs
  #   values:
  #     layout: *pages
  #     # category: docs
  #     author_profile: true
  #     read_time: true
  #     comments: # true
  #     sidebar:
  #       nav: docs
    # permalink: /docs/:category/:name/

  # pages/_notes
  # - 
  #   scope:
  #     path: pages/_notes
  #     type: notes
  #   values:
  #     layout: *pages
  #     share: false
  #     author_profile: false
  #     sidebar:
  #       nav: dynamic

# Exclude from processing.
# The following items will not be processed, by default.
# Any item listed under the `exclude:` key here will be automatically added to
# the internal "default list".
#
# Excluded items can be processed by explicitly listing the directories or
# their entries' file path in the `include:` list.

exclude:
  - .sass-cache/
  - .jekyll-cache/
  - .obsidian
  # Transient browser-automation output; excluded so `jekyll serve --watch`
  # never rebuilds in a loop when these files appear or change.
  - .playwright-mcp/
  - Gemfile.lock
  - gemfiles/
  - Gemfile
  - node_modules/
  # Repo tooling and source that must never ship as site pages/static files:
  - scripts/
  - api/
  - drafts/
  - extension/
  # Exclude Bundler's vendor dir (Ruby gems). assets/vendor/ is a different path
  # and is intentionally committed for GitHub Pages (Bootstrap, jQuery, etc.).
  - vendor/bundle/
  - vendor/cache/
  - vendor/gems/
  - vendor/ruby/
  # - "*.sh"
  - submodules/
  - docs/
  - templates/
  - MERMAID-*.md
  - MERMAID-*/
  - test/
  - _site/lib/

# Sass/SCSS
sass:
  sass_dir: _sass
  style: expanded

#  TODO: Fix bootstrap plugin
  # load_paths:
  #   - /usr/local/bundle/gems/bootstrap-5.3.3/assets/stylesheets

# (Stale Algolia block removed — it pointed at another project's index, dev_it-journey.
#  Site search is served by the theme's search layout over search.json instead.)

## Style Settings -------------------------------------------------------------

# theme                  : "zer0-mistakes-jekyll"
# remote_theme           : "bamr87/zer0-mistakes"
theme_skin               : "aqua" # valid skins: "air", "aqua", "dirt", "neon", "mint", "plum", "sunrise"

# style                  : "default" # "default", "dark", "light", "solarized-dark", "solarized-light"
# remote_style           : "bamr87/zer0-mistakes"

# NOTE: hex values must be quoted — unquoted '#' starts a YAML comment and parses to null.
theme_color:
  main: "#007bff"
  secondary: "#6c757d"
  red: "#a11111"
  yellow: "#ffe900"
  teal: "#376986"
  blue: "#007bff"
  green: "#28a745"
  purple: "#6f42c1"
  pink: "#e83e8c"
  orange: "#fd7e14"
  brown: "#795548"
  cyan: "#17a2b8"
  indigo: "#6610f2"
  lime: "#cddc39"
  amber: "#ffc107"
  deep_orange: "#ff5722"
  deep_purple: "#673ab7"
  light_blue: "#03a9f4"
  light_green: "#8bc34a"
  light_purple: "#9c27b0"
  light_red: "#f44336"
  light_yellow: "#ffeb3b"
  light_teal: "#009688"

## Copyright Settings --------------------------------------------------------------

cr_year: 2024
cr_entity: *name
cr_lisense: "MIT"

## Sitemap Settings --------------------------------------------------------------

# sitemap_include: A list of file extensions that should be included in the sitemap. By default, HTML files and any files with sitemap: true in their front matter are included.
# sitemap_exclude: A list of files or directories that should be excluded from the sitemap.

sitemap_include: ["html", "xml"]
sitemap_exclude: ["secret.html", "private"]