From 142f1230527eddb865ff8fa3e0e05d492f5eaf79 Mon Sep 17 00:00:00 2001
From: Samuele Locatelli <samuele@steamware.net>
Date: Tue, 17 May 2022 19:25:22 +0200
Subject: [PATCH] Test Aggiunta SteamWare.IO nella catena di pubblicazione
 documentazione

---
 .gitlab-ci.yml                 | 32 ++++++++++++++++
 SteamWare.IO/api/index.md      |  4 ++
 SteamWare.IO/articles/intro.md |  3 ++
 SteamWare.IO/articles/toc.md   |  1 +
 SteamWare.IO/docfx.json        | 68 ++++++++++++++++++++++++++++++++++
 SteamWare.IO/index.md          | 13 +++++++
 SteamWare.IO/toc.yml           |  6 +++
 7 files changed, 127 insertions(+)
 create mode 100644 SteamWare.IO/api/index.md
 create mode 100644 SteamWare.IO/articles/intro.md
 create mode 100644 SteamWare.IO/articles/toc.md
 create mode 100644 SteamWare.IO/docfx.json
 create mode 100644 SteamWare.IO/index.md
 create mode 100644 SteamWare.IO/toc.yml

diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index a10599e..dede629 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -8,6 +8,16 @@ variables:
  CONFIG: ''
  VERS_MAIN: '5.2'
  NEW_COPYRIGHT: 'Egalware @'
+ NET_SHARE_X: '\\codedoc.egalware.com\library'
+ NET_USER_X: 'gitlab'
+
+.DocReplica: &DocReplica
+  - |
+    net use X: /delete
+    net use X: $env:NET_SHARE_X /u:$env:NET_USER_X $XDRIVE_PASSWD
+    ROBOCOPY docfx X:\$env:APP_NAME /MIR /XF .git* /XD .git
+    SLEEP 2
+    net use X: /delete
 
 # helper x fix pacchetti nuget da repo locale nexus.steamware.net
 .nuget-fix: &nuget-fix
@@ -41,6 +51,7 @@ stages:
  - build
  - staging
  - release
+ - docfx
  
  
 # --------------------------------
@@ -342,3 +353,24 @@ SteamWare.Scheduler:release:
     - '& "$env:NUGET_PATH" pack "$env:APP_NAME\$env:APP_NAME.csproj" -properties Configuration=$env:CONFIG -Version $env:NUM_REL'
     - '& "$env:NUGET_PATH" setapikey fe387daa-d07c-3207-877e-96c8be1be91b -source http://nexus.steamware.net/repository/nuget-hosted'
     - '& "$env:NUGET_PATH" push *$env:NUM_REL.nupkg -Source http://nexus.steamware.net/repository/nuget-hosted'
+
+
+# --------------------------------
+# DocFx
+# --------------------------------
+SteamWare.IO:docfx:
+  stage: docfx
+  needs: ["SteamWare.IO:build"]
+  tags:
+    - win
+  variables:
+    CONFIG: Release
+    APP_NAME: SteamWare.IO
+  only:
+    refs:
+      - main
+      - master
+  script:  
+    - docfx $env:APP_NAME/docfx.json
+    - mv $env:APP_NAME/_site "docfx"
+    - *DocReplica
\ No newline at end of file
diff --git a/SteamWare.IO/api/index.md b/SteamWare.IO/api/index.md
new file mode 100644
index 0000000..5d4cc63
--- /dev/null
+++ b/SteamWare.IO/api/index.md
@@ -0,0 +1,4 @@
+
+# Icoel.Soap
+
+Impiegare il men&ugrave; laterale per navigare nel codice del progetto.
\ No newline at end of file
diff --git a/SteamWare.IO/articles/intro.md b/SteamWare.IO/articles/intro.md
new file mode 100644
index 0000000..644b000
--- /dev/null
+++ b/SteamWare.IO/articles/intro.md
@@ -0,0 +1,3 @@
+# SteamWare.IO:
+
+Libreria x accesso filesystem / IO in genere
diff --git a/SteamWare.IO/articles/toc.md b/SteamWare.IO/articles/toc.md
new file mode 100644
index 0000000..89dec33
--- /dev/null
+++ b/SteamWare.IO/articles/toc.md
@@ -0,0 +1 @@
+#[Introduction](intro.md)
diff --git a/SteamWare.IO/docfx.json b/SteamWare.IO/docfx.json
new file mode 100644
index 0000000..bacb80c
--- /dev/null
+++ b/SteamWare.IO/docfx.json
@@ -0,0 +1,68 @@
+{
+  "metadata": [
+    {
+      "src": [
+        {
+          "files": [
+            "*.csproj"
+          ],
+          "cwd": ".",
+          "exclude": [
+            "**/obj/**",
+            "**/bin/**",
+            "_site/**"
+          ]
+        }
+      ],
+      "dest": "obj/api"
+    }
+  ],
+  "build": {
+    "content": [
+      {
+        "files": [
+          "api/**.yml"
+        ],
+        "cwd": "obj"
+      },
+      {
+        "files": [
+          "api/*.md",
+          "articles/**.md",
+          "toc.yml",
+          "*.md"
+        ],
+        "exclude": [
+          "obj/**",
+          "_site/**"
+        ]
+      }
+    ],
+    "resource": [
+      {
+        "files": [
+          "images/**"
+        ],
+        "exclude": [
+          "obj/**",
+          "_site/**"
+        ]
+      }
+    ],
+    "overwrite": [
+      {
+        "files": [
+          "apidoc/**.md"
+        ],
+        "exclude": [
+          "obj/**",
+          "_site/**"
+        ]
+      }
+    ],
+    "dest": "_site",
+    "template": [
+      "default"
+    ]
+  }
+}
\ No newline at end of file
diff --git a/SteamWare.IO/index.md b/SteamWare.IO/index.md
new file mode 100644
index 0000000..9749910
--- /dev/null
+++ b/SteamWare.IO/index.md
@@ -0,0 +1,13 @@
+# SteamWare.IO
+
+Documentazione relativa alla libreria SteamWare.IO.
+
+Vedere la sezione Articles per maggiori informazioni sulle definizioni, l'impiego ed esempi.
+
+## Articles
+
+Per maggiori dettagli, definizioni e demo funzionamento si rimanda alla sezione Articles
+
+## Api
+
+Per ogni dettaglio e riferimento alla libreria si rimanda alla sezione Api Documentation
\ No newline at end of file
diff --git a/SteamWare.IO/toc.yml b/SteamWare.IO/toc.yml
new file mode 100644
index 0000000..7eee9ff
--- /dev/null
+++ b/SteamWare.IO/toc.yml
@@ -0,0 +1,6 @@
+
+- name: Articles
+  href: articles/
+- name: API Documentation
+  href: obj/api/
+  homepage: api/index.md