satwareai-mkdocs

A documentation website for satware.ai built with MkDocs and the Material for MkDocs theme.

Overview

This project contains the source files for the satware.ai documentation website. It uses MkDocs as the static site generator and the Material for MkDocs theme for styling and enhanced functionality.

Project Structure

satwareai-mkdocs/
├── .idea/ # IDE configuration files
├── docs/ # Documentation source files
│ ├── .icons/ # Custom icons
│ ├── assets/ # Static assets
│ │ ├── fonts/ # Custom fonts
│ │ ├── images/ # Images used in documentation
│ │ ├── stylesheets/ # Additional CSS stylesheets
│ │ └── javascripts/ # Custom JavaScript files
│ ├── ki-agenten/ # AI agents documentation
│ │ ├── amira.md # Amira Alesi agent profile
│ │ ├── bastian.md # Bastian Alesi agent profile
│ │ ├── bea.md # Bea Alesi agent profile
│ │ ├── index.md # AI agents overview page
│ │ ├── jane.md # Jane Alesi agent profile
│ │ ├── justus.md # Justus Alesi agent profile
│ │ ├── lara.md # Lara Alesi agent profile
│ │ ├── luna.md # Luna Alesi agent profile
│ │ ├── marco.md # Marco Alesi agent profile
│ │ ├── olu.md # Olu Alesi agent profile
│ │ └── theo.md # Theo Alesi agent profile
│ ├── overrides/ # Theme overrides
│ └── stylesheets/ # Additional stylesheets
│ ├── modules/ # CSS modules
│ ├── extra.scss # Extra SCSS styles
│ └── index.md # Stylesheets documentation
├── site/ # Built site (generated)
├── venv/ # Python virtual environment
├── .gitignore # Git ignore file
├── compile_scss.py # SCSS compilation script
├── dev.sh # Development script
├── mkdocs.yml # MkDocs configuration
└── requirements.txt # Python dependencies

Setup and Installation

1. Clone the repository:

   git clone https://github.com/satware-ag/satwareai-mkdocs.git
   cd satwareai-mkdocs
   

2. Create and activate a virtual environment:

    python -m venv venv
    source venv/bin/activate  # On Windows: venv\Scripts\activate
   

3. Install the dependencies:

  pip install -r requirements.txt

Development

To start the development server:

./dev.sh

Or manually:

mkdocs serve

This will start a local development server at http://127.0.0.1:8000/ that automatically reloads when you make changes to the documentation.

SCSS Compilation

The project uses SCSS for styling. To compile SCSS files to CSS:

python compile_scss.py

Building the Site

To build the static site:

mkdocs build

This will create a site directory with the built static site.

Theme Customization

The site uses the Material for MkDocs theme with custom overrides located in the docs/overrides directory. Additional styling is provided through SCSS files in the docs/stylesheets directory.

Documentation

For more information about MkDocs and the Material for MkDocs theme, refer to:

• MkDocs Documentation
• Material for MkDocs Documentation