From: gggeek <giunta.gaetano@gmail.com>
Date: Thu, 9 Feb 2023 22:00:24 +0000 (+0000)
Subject: improve api docs
X-Git-Tag: 4.10.0~3
X-Git-Url: http://git.onelab.eu/?a=commitdiff_plain;h=1149eeca5dae513b51fc521252e8c36803dbbf80;p=plcapi.git

improve api docs
---

diff --git a/doc/build/taskfile b/doc/build/taskfile
index cb1317b7..a9e3e1c8 100755
--- a/doc/build/taskfile
+++ b/doc/build/taskfile
@@ -79,7 +79,17 @@ function build_api() {
 
     $PHPDOC run --cache-folder 'build/.phpdoc' -d "$(realpath ../src/)" -t 'api' --title PHPXMLRPC --defaultpackagename PHPXMLRPC
 
-    # @todo manually mangle the index.html file to add generation date, lib version, etc...
+    # manually mangle the index.html file to add generation date, lib version, etc...
+    TAG=$(grep 'public \+static \+$xmlrpcVersion *=' ../src/PhpXmlRpc.php | sed 's/public \+static \+$xmlrpcVersion *= *//' | tr -d ' ' | tr -d \" | tr -d ';' | tr -d "'")
+    sed -r -i -e "s|<h2>Documentation</h2>|<h2>Documentation for the <a href=\"https://gggeek.github.io/phpxmlrpc/\">PHPXMLRPC</a> library, ver. ${TAG}</h2><p>Built on $(date +%Y/%m/%d)</p>|g" ./api/index.html
+    find api -name '*.html' xargs sed -r -i -e 's|<a href="" class="phpdocumentor-title__link">|<a href="index.html" class="phpdocumentor-title__link">|g'
+    find api -name '*.html' | xargs sed -r -i -e "s|>PHPXMLRPC</a></h1>|>PHPXMLRPC ${TAG}</a></h1>|g"
+    #find api -name '*.html' | fgrep -v 'api/index.html' | xargs sed -r -i -e "s|...|...|g"
+
+    if [ ! -d api/images ]; then
+        mkdir api/images
+    fi
+    cp ../debugger/favicon.ico api/images
 }
 
 function build_manual() {