Cloud Temple Documentation

Welcome to the official documentation repository for Cloud Temple. Here, you’ll find guides and resources to help you better understand and utilize Cloud Temple’s services and solutions.

A PROD version of this documentation is available here. This repository and the website are synchronized to ensure up-to-date content.

A DEV version of this documentation is available here.

This project is continuously updated with new guides and improvements.

Contributing

We value your contributions! Whether it’s improving an existing guide or creating a new one, your input helps us make this repository better.

How to Contribute

1. Fork this repository: Clone your fork to your local environment.
2. Make your changes: Update or create guides.
3. Submit a Pull Request (PR): Propose your changes to the develop branch.

Our team will review your contribution, provide feedback if needed, and integrate approved changes.

Guidelines for Contributions

• Ensure your contributions are accurate, tested, and well-documented. • Include a brief explanation of your changes in the PR comments. • Follow the structure and style of existing guides for consistency.

Licensing

By contributing to this repository, you agree to the terms outlined in the LICENSE file.

Working Locally with Docker

To get started, follow these simple steps:

1. Navigate to the Docker directory:

cd docker/local

2. Launch the services with Docker Compose:

docker-compose up

3. Access the documentation locally:

Open your browser and go to: http://localhost:3000/docs/

Base url is set to "/docs" when running on non production build (locally or deployed on github pages)

🎉 Your local environment is ready!

Working Locally without Docker

Prerequisites

• Node.js (version 18.0 or higher)
• yarn package manager

Installation Steps

1. Install dependencies

   yarn install

2. Start the development server

   yarn start

   This command will start the Docusaurus development server with hot reloading enabled.

3. Access the documentation locally

   Open your browser and go to: http://localhost:3000/docs/

   Base url is set to "/docs" when running on non production build (locally or deployed on github pages)

Multi-language Development

The documentation supports 5 languages: French (default), English, Spanish, Italian, and German.

Working with Multiple Languages

1. Default Language (French)

   • All content is written in French in the /docs/ directory
   • This is the source language for all translations

2. Start with a specific language

   # Start in English
   yarn start --locale en
   
   # Start in Spanish
   yarn start --locale es
   
   # Start in Italian
   yarn start --locale it
   
   # Start in German
   yarn start --locale de

🎉 Your local environment is ready!

Build and run locally in production mode

To get started, follow these simple steps:

1. Build the docker image:

docker build -t docs:v3 . -f docker/production/Dockerfile

2. Launch the services with Docker Compose:

docker run -it --rm -p 8080:80 --name docs docs:v3

3. Access the documentation locally (all pages and all langages should work):

Open your browser and go to: http://localhost:8080

Base url is set to "/" on production build

Docker Image Labels

The production image (nginx:stable-alpine stage) embeds the following OCI standard labels:

Label	Value
org.opencontainers.image.title	Cloud Temple Documentation
org.opencontainers.image.description	Cloud Temple official documentation site (Docusaurus static build served by nginx)
org.opencontainers.image.vendor	Cloud Temple
org.opencontainers.image.source	https://github.com/Cloud-Temple/docs
org.opencontainers.image.licenses	proprietary

You can inspect the labels of a built image with:

docker inspect docs:v3 --format '{{ json .Config.Labels }}' | jq

Security note: Alpine packages in the final stage are upgraded at build time (apk upgrade --no-cache) to ensure all OS-level CVEs are patched. Rebuild the image regularly to pick up new security fixes.

Scripts for Automation

This project includes several scripts to automate documentation and translation tasks. For complete technical details on all scripts, please refer to the Scripts README.

📜 LLMaaS Model Documentation Generator

This Python script automatically generates the models.md page from a YAML configuration file.

• Source: memory-bank/models_config.yaml
• Output: docs/llmaas/models.md

Usage

To update the model documentation, run the following command from the project root:

yarn generate:models
# or directly:
python scripts/generate_models_doc/generate_models_doc.py

🌍 Translation System

The documentation supports 5 languages: French (source), English, German, Spanish, and Italian. The French content in /docs/ is the source — translations are generated automatically via the Cloud Temple LLMaaS API, with SHA-256 change detection so only modified files are re-translated. The API token is passed via the --token CLI flag (recommended) or environment variables.

⚠️ Never edit files in i18n/ manually — they are overwritten on each translation run. Always edit the French source in /docs/.

➡️ Full setup (venv, install, token, usage, rules and troubleshooting): see the Scripts Documentation.

For a complete list of commands, advanced features, and troubleshooting, please see the detailed Scripts Documentation.