Docs: Add complete bilingual demo documentation content (EN/FR)

Author: Ezar101

.gitignore

@@ -1,5 +1,6 @@
 /vendor
 /site
+/assets
 .idea
 .vscode
 litedocs.phar

config/nav.yaml

@@ -1,2 +1,17 @@
 en:
-  - Home: index.md
+  - Introduction: index.md
+  - Getting Started:
+    - Installation: guide/installation.md
+    - Configuration: guide/configuration.md
+    - Plugins: guide/plugins.md
+  - Advanced:
+    - Custom Theme: advanced/theming.md
+
+fr:
+  - Introduction: index.md
+  - Commencer:
+    - Installation: guide/installation.md
+    - Configuration: guide/configuration.md
+    - Plugins: guide/plugins.md
+  - Avancé:
+    - Thèmes: advanced/theming.md

config/plugins.yaml

@@ -1,7 +1,11 @@
+# Displays reading time
 LiteDocs\Plugin\ReadingTimePlugin: ~
 
+# Automatic Table of Contents
 LiteDocs\Plugin\TableOfContentsPlugin: ~
 
+# Syntax highlighting
 LiteDocs\Plugin\SyntaxHighlightPlugin: ~
 
+# JS Search Engine
 LiteDocs\Plugin\SearchPlugin: ~

docs/en/advanced/theming.md

@@ -0,0 +1,29 @@
+# Theming
+
+LiteDocs uses **Twig** as a templating engine. You can easily customize the look and feel.
+
+## Creating a Theme
+
+1. Create a folder in `themes/` (e.g., `themes/my-theme`).
+2. Create a `base.html.twig` file inside.
+3. Create an `assets/` folder for your CSS and JS.
+
+## Available Variables
+
+In your Twig templates, you have access to:
+
+* `content`: The HTML content of the page.
+* `nav`: The navigation tree.
+* `page_title`: The current page title.
+* `config`: The full configuration array.
+* `trans`: Translations (based on current language).
+
+## Overriding Translations
+
+You can override any text by creating a `translations/en.yaml` file at the root of your project:
+
+```yaml
+core:
+    ui:
+        navigation: "Main Menu"
+```

docs/en/guide/configuration.md

@@ -0,0 +1,40 @@
+# Configuration
+
+LiteDocs uses a single YAML file named `litedocs.yml` at the root of your project.
+
+## Basic Structure
+
+Here is a complete example of a configuration file:
+
+```yaml
+site_name: "My Documentation"
+site_url: "[https://example.com](https://example.com)"
+
+# Directories
+docs_dir: "docs"
+site_dir: "site"
+
+# Branding
+logo: "assets/logo.png"
+favicon: "assets/favicon.ico"
+
+# Theme
+theme:
+    name: lite
+
+# Imports (Recommended for large projects)
+nav: "config/nav.yml"
+plugins: "config/plugins.yml"
+```
+
+## Navigation Configuration
+
+You can separate your navigation logic into `config/nav.yml`:
+
+
+```yaml
+en:
+    - Home: index.md
+    - Guide:
+        - Setup: guide/installation.md
+```

docs/en/guide/installation.md

@@ -0,0 +1,31 @@
+# Installation
+
+## Requirements
+
+Before using LiteDocs, ensure your environment meets these requirements:
+
+* **PHP:** 8.4 or higher
+* **Composer:** installed globally (optional if using PHAR)
+* **Extensions:** `php-xml`, `php-mbstring`
+
+## Option 1: Using the PHAR (Recommended)
+
+You can download the standalone executable directly. This is the easiest way to get started.
+
+```bash
+# Download the latest release
+wget [https://github.com/ezar101/litedocs/releases/latest/download/litedocs.phar](https://github.com/ezar101/litedocs/releases/latest/download/litedocs.phar)
+
+# Make it executable
+chmod +x litedocs.phar
+
+# Move to bin (optional)
+sudo mv litedocs.phar /usr/local/bin/litedocs
+```
+## Option 2: Using Composer
+
+You can also install it as a global dependency:
+
+```bash
+composer global require ezar101/litedocs
+```

docs/en/guide/plugins.md

@@ -0,0 +1,25 @@
+# Plugins System
+
+LiteDocs comes with a robust plugin system based on Symfony EventDispatcher.
+
+## Built-in Plugins
+
+We include several powerful plugins out of the box:
+
+| Plugin Name | Description |
+| :--- | :--- |
+| **SearchPlugin** | Adds a client-side search engine (JS). |
+| **ReadingTimePlugin** | Displays estimated reading time. |
+| **TableOfContentsPlugin** | Generates a table of contents on the right side. |
+| **SyntaxHighlightPlugin** | Adds colors to your code blocks using Highlight.js. |
+
+## Activation
+
+To activate a plugin, add it to your `config/plugins.yml` file:
+
+```yaml
+LiteDocs\Plugin\ReadingTimePlugin: ~
+
+LiteDocs\Plugin\SyntaxHighlightPlugin:
+    custom_script: "my-custom-js.js"
+```

docs/en/index.md

@@ -1,3 +1,33 @@
 # Welcome to LiteDocs
 
-This is a static site generator made in **PHP**.
+**LiteDocs** is a lightweight, modern static site generator written in PHP. It is designed to be fast, extensible, and easy to use for technical documentation.
+
+## Why LiteDocs?
+
+* **⚡ Fast:** Generates static HTML files in seconds.
+* **🔌 Extensible:** Plugin system to add features easily.
+* **🎨 Theming:** Modern default theme (Sylius/GitBook style).
+* **🌍 Multilingual:** Native support for multiple languages.
+* **🔍 Search:** Built-in client-side search engine.
+
+## Quick Start
+
+Run the following command to build your documentation:
+
+```bash
+php bin/litedocs build
+```
+
+## Quick Example
+
+Here is how you initialize the kernel in PHP:
+
+```php
+use LiteDocs\Core\Kernel;
+
+$kernel = new Kernel(__DIR__);
+$kernel->boot();
+$kernel->build();
+
+<div data-search-ignore style="background: #e0f7fa; color: #006064; padding: 15px; border-radius: 4px; margin-top: 20px;"> <strong>Tip:</strong> This block uses the <code>data-search-ignore</code> attribute. It will be visible to the user but ignored by the search bar indexer. </div>
+```

docs/fr/advanced/theming.md

@@ -0,0 +1,29 @@
+# Thèmes
+
+LiteDocs utilise **Twig** comme moteur de template. Vous pouvez facilement personnaliser l'apparence.
+
+## Créer un Thème
+
+1. Créez un dossier dans `themes/` (ex: `themes/mon-theme`).
+2. Créez un fichier `base.html.twig` à l'intérieur.
+3. Créez un dossier `assets/` pour vos CSS et JS.
+
+## Variables Disponibles
+
+Dans vos templates Twig, vous avez accès à :
+
+* `content` : Le contenu HTML de la page.
+* `nav` : L'arbre de navigation.
+* `page_title` : Le titre de la page courante.
+* `config` : Le tableau complet de configuration.
+* `trans` : Les traductions (basées sur la langue actuelle).
+
+## Surcharger les Traductions
+
+Vous pouvez surcharger n'importe quel texte en créant un fichier `translations/fr.yaml` à la racine de votre projet :
+
+```yaml
+core:
+    ui:
+        navigation: "Menu Principal"
+```

docs/fr/guide/configuration.md

@@ -0,0 +1,40 @@
+# Configuration
+
+LiteDocs utilise un seul fichier YAML nommé `litedocs.yml` à la racine de votre projet.
+
+## Structure de Base
+
+Voici un exemple complet de fichier de configuration :
+
+```yaml
+site_name: "Ma Documentation"
+site_url: "[https://exemple.com](https://exemple.com)"
+
+# Dossiers
+docs_dir: "docs"
+site_dir: "site"
+
+# Branding
+logo: "assets/logo.png"
+favicon: "assets/favicon.ico"
+
+# Thème
+theme:
+    name: lite
+
+# Imports (Recommandé pour les gros projets)
+nav: "config/nav.yml"
+plugins: "config/plugins.yml"
+```
+
+## Configuration de la Navigation
+
+Vous pouvez séparer votre logique de navigation dans `config/nav.yml`:
+
+
+```yaml
+fr:
+    - Accueil: index.md
+    - Guide:
+        - Installation: guide/installation.md
+```