Merge branch 'release/TestDocSteamWare.IO'

.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,97 @@ 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
+      - develop
+  script:  
+    - docfx $env:APP_NAME/docfx.json
+    - mv $env:APP_NAME/_site "docfx"
+    - *DocReplica
+
+SteamWare.Logger:docfx:
+  stage: docfx
+  needs: ["SteamWare.Logger:build"]
+  tags:
+    - win
+  variables:
+    CONFIG: Release
+    APP_NAME: SteamWare.Logger
+  only:
+    refs:
+      - main
+      - master
+      - develop
+  script:  
+    - docfx $env:APP_NAME/docfx.json
+    - mv $env:APP_NAME/_site "docfx"
+    - *DocReplica
+
+SteamWare.Reports:docfx:
+  stage: docfx
+  needs: ["SteamWare.Reports:build"]
+  tags:
+    - win
+  variables:
+    CONFIG: Release
+    APP_NAME: SteamWare.Reports
+  only:
+    refs:
+      - main
+      - master
+      - develop
+  script:  
+    - docfx $env:APP_NAME/docfx.json
+    - mv $env:APP_NAME/_site "docfx"
+    - *DocReplica
+
+SteamWare.Scheduler:docfx:
+  stage: docfx
+  needs: ["SteamWare.Scheduler:build"]
+  tags:
+    - win
+  variables:
+    CONFIG: Release
+    APP_NAME: SteamWare.Scheduler
+  only:
+    refs:
+      - main
+      - master
+      - develop
+  script:  
+    - docfx $env:APP_NAME/docfx.json
+    - mv $env:APP_NAME/_site "docfx"
+    - *DocReplica
+
+SteamWare:docfx:
+  stage: docfx
+  needs: ["SteamWare:build"]
+  tags:
+    - win
+  variables:
+    CONFIG: Release
+    APP_NAME: SteamWare
+  only:
+    refs:
+      - main
+      - master
+      - develop
+  script:  
+    - docfx $env:APP_NAME/docfx.json
+    - mv $env:APP_NAME/_site "docfx"
+    - *DocReplica

SteamWare.IO/api/index.md

@@ -0,0 +1,3 @@
+# SteamWare.IO
+
+Impiegare il menù laterale per navigare nel codice del progetto.

SteamWare.IO/articles/intro.md

@@ -0,0 +1,3 @@
+# SteamWare.IO:
+
+Libreria x accesso filesystem / IO in genere

SteamWare.IO/articles/toc.md

@@ -0,0 +1 @@
+#[Introduction](intro.md)

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"
+    ]
+  }
+}

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

SteamWare.IO/toc.yml

@@ -0,0 +1,6 @@
+
+- name: Articles
+  href: articles/
+- name: API Documentation
+  href: obj/api/
+  homepage: api/index.md

SteamWare.Logger/api/index.md

@@ -0,0 +1,4 @@
+
+# SteamWare.Logger
+
+Impiegare il menù laterale per navigare nel codice del progetto.

SteamWare.Logger/articles/intro.md

@@ -0,0 +1,3 @@
+# SteamWare.Logger:
+
+Libreria x gestione Logging

SteamWare.Logger/articles/toc.md

@@ -0,0 +1 @@
+#[Introduction](intro.md)

SteamWare.Logger/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"
+    ]
+  }
+}

SteamWare.Logger/index.md

@@ -0,0 +1,13 @@
+# SteamWare.Logger
+
+Documentazione relativa alla libreria SteamWare.Logger.
+
+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

SteamWare.Logger/toc.yml

@@ -0,0 +1,6 @@
+
+- name: Articles
+  href: articles/
+- name: API Documentation
+  href: obj/api/
+  homepage: api/index.md

SteamWare.Reports/api/index.md

@@ -0,0 +1,3 @@
+# SteamWare.Reports
+
+Impiegare il menù laterale per navigare nel codice del progetto.

SteamWare.Reports/articles/intro.md

@@ -0,0 +1,3 @@
+# SteamWare.Reports:
+
+Libreria x gestione export/salvataggio/stampaReport con viewer di Reporting Services

SteamWare.Reports/articles/toc.md

@@ -0,0 +1 @@
+#[Introduction](intro.md)

SteamWare.Reports/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"
+    ]
+  }
+}

SteamWare.Reports/index.md

@@ -0,0 +1,13 @@
+# SteamWare.Reports
+
+Documentazione relativa alla libreria SteamWare.Reports.
+
+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

SteamWare.Reports/toc.yml

@@ -0,0 +1,6 @@
+
+- name: Articles
+  href: articles/
+- name: API Documentation
+  href: obj/api/
+  homepage: api/index.md

SteamWare/api/index.md

@@ -0,0 +1,3 @@
+# SteamWare
+
+Impiegare il menù laterale per navigare nel codice del progetto.

SteamWare/articles/intro.md

@@ -0,0 +1,3 @@
+# SteamWare:
+
+Libreria principale

SteamWare/articles/toc.md

@@ -0,0 +1 @@
+#[Introduction](intro.md)

SteamWare/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"
+    ]
+  }
+}

SteamWare/index.md

@@ -0,0 +1,13 @@
+# SteamWare
+
+Documentazione relativa alla libreria SteamWare principale.
+
+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

SteamWare/toc.yml

@@ -0,0 +1,6 @@
+
+- name: Articles
+  href: articles/
+- name: API Documentation
+  href: obj/api/
+  homepage: api/index.md

Steamware.Scheduler/api/index.md

@@ -0,0 +1,3 @@
+# SteamWare.Scheduler
+
+Impiegare il menù laterale per navigare nel codice del progetto.

Steamware.Scheduler/articles/intro.md

@@ -0,0 +1,3 @@
+# SteamWare.Scheduler:
+
+Libreria x gestione funzionalità sachedulazione temporale x esecuzione tasks.

Steamware.Scheduler/articles/toc.md

@@ -0,0 +1 @@
+#[Introduction](intro.md)

Steamware.Scheduler/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"
+    ]
+  }
+}

Steamware.Scheduler/index.md

@@ -0,0 +1,13 @@
+# SteamWare.Scheduler
+
+Documentazione relativa alla libreria SteamWare.Scheduler.
+
+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

Steamware.Scheduler/toc.yml

@@ -0,0 +1,6 @@
+
+- name: Articles
+  href: articles/
+- name: API Documentation
+  href: obj/api/
+  homepage: api/index.md