picknik.ai — Jekyll Website

Jekyll 4.2 static site for https://picknik.ai. Deployed via GitHub Pages from master.

Build & Run

# Local development (Ubuntu)
./build_locally.sh              # Install deps + serve at localhost:4000
./build_locally.sh noinstall    # Skip dependency install
./build_locally.sh check        # Run CI tests locally

# Manual
bundle exec jekyll serve        # Dev server
bundle exec jekyll build        # Build to _site/

Ruby 3.2.3 required (see .ruby-version). For macOS setup see https://jekyllrb.com/docs/installation/macos/.

CI Checks

All PRs run these via GitHub Actions:

ROS™ trademark validation — scripts/validate_ros_trademark.py. Rule: exactly one ROS™ per page (in title OR first body occurrence, not both).
HTML proofer — validates all links and images after build (--strict_front_matter).
Pre-commit — YAML formatting, spelling (codespell), line endings, merge markers.
Jest tests — npm test (jsdom environment, tests in tests/).

Directory Structure

Directory	Purpose
`_posts/`	Blog posts (`YYYY-MM-DD-Title.md`)
`_case-studies/`	Case studies (sorted by `cs_order`)
`_white-papers/`	White papers (`YYYY-MM-DD-Title.md`)
`_news-releases/`	Press releases — do not modify (historical content)
`_news-links/`	External news links — do not modify
`_webinars/`	Webinar pages
`_video-posts/`	Video content
`_ecosystem/`	Partner/ecosystem entries
`_events-links/`	Event links
`_data/`	Data files (`variables.yml`, `behaviors.json`)
`_layouts/`	Liquid templates
`_includes/`	Reusable components (head, footer, menu, forms)
`_sass/`	SCSS modules (`_component-name.scss`)
`assets/`	Static assets (images, JS, CSS, fonts)
`pages/`	Standalone pages
`products/`	Product pages (MoveIt Pro, etc.)
`docs/`	PDFs and documentation

Content Conventions

Front Matter — Blog Posts

---
date: YYYY-MM-DD
author: "Name, Title"
layout: post
title: "Post Title"           # 30-60 chars for SEO
media_type: image              # image | video | htmlVideo
media_link: /assets/images/blog_posts/image.png
description: "Unique meta description"
comments: false
---

Layouts

post — blog posts, white papers
caseStudy — case studies (requires company, cs_order, permalink)
newsRelease — press releases
marketingPage — full-width marketing pages
webinar — webinar pages
page / singlePage — standard pages

Naming

Posts: YYYY-MM-DD-Title-With-Hyphens.md
Case studies: case-study-company-name.md
SCSS: _component-name.scss

Content Rules

Images: Compress with TinyPNG before committing. Always include alt text.
External links: Use target="_blank".
YouTube embeds: Use youtube-nocookie.com (not youtube.com).
Vimeo embeds: Use iframe tags (direct links break html-proofer).
Redirects: Create a markdown file in root with redirect_to: URL front matter (e.g., meetus.md).
Site variables: Use _data/variables.yml for stats (employees, years, etc.) — accessed via ``.

Frontend

Bootstrap grid (container, row, col-*) and utilities.
SCSS compiled with style: compressed.
Behaviors marketplace powered by assets/js/behaviors.js + _data/behaviors.json.

Git Workflow

Default branch: master (auto-deploys to GitHub Pages).
Squash into a single commit per PR.
Beta testing: push to beta01 remote for preview at beta01.picknik.ai.

Team

Laco — GitHub: l4co77

Since 2015, PickNik has developed our production-grade MoveIt Pro platform to propel the robotics industry forward, while also contributing back to ROS™, MoveIt, and many other open source projects.