docs: build Dolibarr *.0 versions

Author: williamdes

.github/api-docs/doctum-php-Dolibarr.php

@@ -0,0 +1,35 @@
+<?php
+
+use Doctum\Doctum;
+use Doctum\RemoteRepository\GitHubRemoteRepository;
+use Symfony\Component\Finder\Finder;
+use Doctum\Version\GitVersionCollection;
+
+$rootDir = __DIR__ . '/';
+$sourceRootDir = $rootDir . 'sources/Dolibarr';
+
+$iterator = Finder::create()
+    ->files()
+    ->name('*.php')
+    ->path('htdocs')
+    ->in($sourceRootDir);
+
+$versions = GitVersionCollection::create(__DIR__)
+    ->addFromBranches('*.0');
+
+return new Doctum($iterator, [
+    'title'                => 'Dolibarr',
+    'build_dir'            => $rootDir . '/Dolibarr',
+    'cache_dir'            => $rootDir . '/cache',
+    'source_dir'           => $rootDir,
+    'versions'             => $versions,
+    'remote_repository'    => new GitHubRemoteRepository('dolibarr/dolibarr', $sourceRootDir),
+    'footer_link'          => [
+        'href'        => 'https://github.com/Dolibarr/dolibarr',
+        'rel'         => 'noreferrer noopener',
+        'target'      => '_blank',
+        'before_text' => 'This documentation is built for the',
+        'link_text'   => 'Dolibarr',
+        'after_text'  => 'project.',
+    ],
+]);

scripts/update-built-docs.sh

@@ -44,6 +44,7 @@ doDocsUpdate() {
 
     FOLDER_NAME="$1"
     SOURCE_URL="$2"
+    MODE="${3:-}"
     BUILD_DIR="./api-docs/$FOLDER_NAME"
     SOURCE_DIR="./api-docs/sources/$FOLDER_NAME"
 
@@ -64,15 +65,17 @@ doDocsUpdate() {
 
     rm -rfd "$SOURCE_DIR"
 
-    if [ ! -d "$SOURCE_DIR" ]; then
-        mkdir "$SOURCE_DIR"
+    if [ "$MODE" != "git" ]; then
+        if [ ! -d "$SOURCE_DIR" ]; then
+            mkdir "$SOURCE_DIR"
+        fi
+        # Download, extract and move
+        curl -# -L -o $FOLDER_NAME.tar.gz "$SOURCE_URL"
+        tar xzvf $FOLDER_NAME.tar.gz --strip-components=1 -C "$SOURCE_DIR" && rm $FOLDER_NAME.tar.gz
+    else
+        git clone "$SOURCE_URL" "$SOURCE_DIR"
     fi
 
-    # Download, extract and move
-    curl -# -L -o $FOLDER_NAME.tar.gz "$SOURCE_URL"
-
-    tar xzvf $FOLDER_NAME.tar.gz --strip-components=1 -C "$SOURCE_DIR" && rm $FOLDER_NAME.tar.gz
-
     du -sh "$SOURCE_DIR"
 
     # Try as hard as possible to cleanup the dir
@@ -110,3 +113,4 @@ doDocsUpdate "mangopay2-php-sdk" "https://github.com/Mangopay/mangopay2-php-sdk/
 doDocsUpdate "tcpdf" "https://github.com/tecnickcom/TCPDF/archive/refs/heads/main.tar.gz"
 doDocsUpdate "DirectoryTree-ImapEngine" "https://github.com/DirectoryTree/ImapEngine/archive/refs/heads/master.tar.gz"
 doDocsUpdate "phpunit" "https://github.com/sebastianbergmann/phpunit/archive/refs/heads/main.tar.gz"
+doDocsUpdate "Dolibarr" "https://github.com/Dolibarr/dolibarr.git"