Skip to content

Tree

Site Structure Overview

This page displays the complete directory structure of the IT-Journey platform, automatically generated and updated via our CI/CD workflow.

Current Tree Structure

``` {% include_relative tree.txt %} ```

Structure Guidelines

Our directory organization follows these principles:

Core Directories

  • `pages/` - Main content pages organized by section
  • `_data/` - YAML data files for navigation and configuration
  • `assets/` - Static resources (CSS, JavaScript, images)
  • `_site/` - Generated site files (excluded from version control)

Content Organization

  • `_about/` - About pages and documentation
  • `_docs/` - Technical documentation and guides
  • `_posts/` - Blog posts and articles
  • `_notebooks/` - Jupyter notebooks and interactive content
  • `_quests/` - Learning challenges and exercises

Configuration Files

  • `_config.yml` - Main Jekyll configuration
  • `Gemfile` - Ruby dependencies
  • `package.json` - Node.js dependencies (if applicable)

Automation Features

  • Auto-generated: Updated automatically when repository structure changes
  • CI/CD Integration: Part of the update-settings workflow
  • Cross-platform: Works on Windows, macOS, and Linux
  • Gitignore Aware: Automatically excludes files and directories listed in `.gitignore`
  • Clean Output: Only shows relevant project files and structure

Gitignore Integration

This tree structure respects the project's `.gitignore` file, automatically excluding:

  • Build artifacts and generated files
  • IDE-specific directories (e.g., .obsidian, .vscode)
  • Dependency directories (e.g., node_modules, .venv)
  • Cache directories (e.g., .sass-cache, .jekyll-cache)
  • Sensitive files (e.g., .env, API keys)

This ensures the documentation shows only the meaningful project structure without clutter from temporary or generated files.

Common excluded patterns: - Build artifacts: _site/, .sass-cache/, .jekyll-cache/ - IDE configs: .obsidian/, .vscode/, .idea/ - Dependencies: node_modules/, .venv/, vendor/ - Temporary files: *.DS_Store, .env, .tmp

Last updated: {{ page.lastmod }} Generated by: update-settings.yml