Initial commit: First version of LiteDocs

Author: Ezar101

.gitignore

@@ -0,0 +1,6 @@
+/vendor
+/site
+.idea
+.vscode
+litedocs.phar
+composer.lock

bin/litedocs

@@ -0,0 +1,15 @@
+#!/usr/bin/env php
+<?php
+
+declare(strict_types=1);
+
+require dirname(__DIR__) . '/vendor/autoload.php';
+
+use LiteDocs\Command\BuildCommand;
+use Symfony\Component\Console\Application;
+
+$application = new Application('LiteDocs', '1.0.0');
+
+$application->addCommand(new BuildCommand());
+
+$application->run();

composer.json

@@ -0,0 +1,35 @@
+{
+    "name": "ezar101/litedocs",
+    "description": "A lightweight static site generator.",
+    "version": "1.0.0",
+    "license": "MIT",
+    "type": "project",
+    "autoload": {
+        "psr-4": {
+            "LiteDocs\\": "src/"
+        }
+    },
+    "authors": [
+        {
+            "name": "Ezar Affandi",
+            "email": "salez.ea@gmail.com"
+        }
+    ],
+    "require": {
+       "php": ">=8.4",
+        "symfony/console": "^8.0",
+        "symfony/yaml": "^8.0",
+        "symfony/filesystem": "^8.0",
+        "symfony/event-dispatcher": "^8.0",
+        "symfony/options-resolver": "^8.0",
+        "twig/twig": "^3.22",
+        "league/commonmark": "^2.8",
+        "symfony/finder": "^8.0"
+    },
+    "bin": [
+        "bin/litedocs"
+    ],
+    "config": {
+        "sort-packages": true
+    }
+}

config/nav.yaml

@@ -0,0 +1,2 @@
+en:
+  - Home: index.md

config/plugins.yaml

@@ -0,0 +1,7 @@
+LiteDocs\Plugin\ReadingTimePlugin: ~
+
+LiteDocs\Plugin\TableOfContentsPlugin: ~
+
+LiteDocs\Plugin\SyntaxHighlightPlugin: ~
+
+LiteDocs\Plugin\SearchPlugin: ~

docs/en/index.md

@@ -0,0 +1,3 @@
+# Welcome to LiteDocs
+
+This is a static site generator made in **PHP**.

litedocs.yaml

@@ -0,0 +1,8 @@
+site_name: 'My Docs'
+theme: 'lite'
+
+languages:
+  en: English
+
+nav: 'config/nav.yaml'
+plugins: 'config/plugins.yaml'

src/Command/BuildCommand.php

@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+namespace LiteDocs\Command;
+
+use LiteDocs\Core\Kernel;
+use Symfony\Component\Console\Attribute\AsCommand;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Output\OutputInterface;
+use Symfony\Component\Console\Style\SymfonyStyle;
+use Symfony\Component\EventDispatcher\EventDispatcher;
+
+#[AsCommand(
+    name: 'build',
+    description: 'Build the documentation as a static HTML site.',
+)]
+class BuildCommand extends Command
+{
+    protected function execute(InputInterface $input, OutputInterface $output): int
+    {
+        $io = new SymfonyStyle($input, $output);
+        $projectDir = getcwd(); // User's current directory
+
+        $dispatcher = new EventDispatcher();
+
+        try {
+            $kernel = new Kernel($projectDir, $dispatcher);
+            $kernel->boot();
+
+            $io->title('LiteDocs Builder');
+            $io->text('Configuration loaded.');
+
+            $kernel->build();
+
+            $io->success('Build complete!');
+
+            return Command::SUCCESS;
+        } catch (\Exception $e) {
+            $io->error($e->getMessage());
+
+            return Command::FAILURE;
+        }
+    }
+}

src/Config/Configuration.php

@@ -0,0 +1,50 @@
+<?php
+
+declare(strict_types=1);
+
+namespace LiteDocs\Config;
+
+use Symfony\Component\OptionsResolver\Options;
+use Symfony\Component\OptionsResolver\OptionsResolver;
+
+class Configuration
+{
+    public function resolve(array $config): array
+    {
+        $resolver = new OptionsResolver();
+
+        $resolver->setDefaults([
+            'site_name' => 'My LiteDocs',
+            'site_url'  => null,
+            'docs_dir'  => 'docs',
+            'site_dir'  => 'site',
+            'theme'     => ['name' => 'lite'],
+            'plugins'   => [],
+            'nav'       => null,
+            'languages' => [],
+            'logo'      => null,
+            'favicon'   => null,
+        ]);
+
+        $resolver->setAllowedTypes('site_name', 'string');
+        $resolver->setAllowedTypes('site_url', ['null', 'string']);
+        $resolver->setAllowedTypes('docs_dir', 'string');
+        $resolver->setAllowedTypes('site_dir', 'string');
+        $resolver->setAllowedTypes('theme', ['string', 'array']);
+        $resolver->setAllowedTypes('plugins', 'array');
+        $resolver->setAllowedTypes('nav', ['null', 'array']);
+        $resolver->setAllowedTypes('languages', 'array');
+        $resolver->setAllowedTypes('logo', ['null', 'string']);
+        $resolver->setAllowedTypes('favicon', ['null', 'string']);
+
+        $resolver->setNormalizer('theme', function (Options $options, string | array $value): array {
+            if (is_string($value)) {
+                return ['name' => $value];
+            }
+
+            return $value;
+        });
+
+        return $resolver->resolve($config);
+    }
+}