Auto-update year and package version

Author: bash

.github/workflows/build.yml

@@ -0,0 +1,42 @@
+name: Build Documentation
+
+on:
+  pull_request:
+    branches: [ main ]
+  push:
+    branches: [ main ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    defaults:
+      run:
+        shell: bash
+        working-directory: ./Documentation
+
+    steps:
+      - uses: actions/checkout@v1
+      - uses: actions/setup-dotnet@v1
+      - name: Build
+        run: dotnet fsi build.fsx
+      - name: Upload GitHub Pages Artifact
+        uses: actions/upload-pages-artifact@v1
+
+  deploy_pages:
+    needs: build
+    if: github.ref_name == 'main'
+
+    permissions:
+      pages: write
+      id-token: write
+
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    runs-on: ubuntu-latest
+    steps:
+    - name: Deploy to GitHub Pages
+      id: deployment
+      uses: actions/deploy-pages@v1

.gitignore

@@ -0,0 +1 @@
+/_site

build.fsx

@@ -0,0 +1,50 @@
+open System.IO
+open System.Net.Http
+open System.Net.Http.Json
+open System.Text.Json
+open System
+
+let outputDirectory = "_site"
+let indexHtml = "index.html"
+
+let getLatestPackageVersion package =
+    async {
+        use httpClient = new HttpClient()
+        let! document = httpClient.GetFromJsonAsync<JsonDocument>($"https://api-v2v3search-0.nuget.org/query?q={package}&skip=0&take=1&prerelease=false&semVerLevel=2.0.0") |> Async.AwaitTask
+        return (document.RootElement.GetProperty("data")[0]).GetProperty("version").GetString()
+    }
+
+let getLatestFunckyVersion() = getLatestPackageVersion "Funcky"
+
+let renderIndexHtml (template: string, packageVersion, year) =
+    template
+        .Replace("{{PackageVersion}}", packageVersion)
+        .Replace("{{Year}}", year.ToString())
+
+let writeIndexHtml() =
+    let version = getLatestFunckyVersion() |> Async.RunSynchronously
+    let indexHtmlContents = renderIndexHtml(File.ReadAllText(indexHtml), version, DateTime.Today.Year)
+    File.WriteAllText(Path.Combine(outputDirectory, indexHtml), contents = indexHtmlContents)
+
+let copyFileToOutput source =
+    let relativePath = Path.GetRelativePath(relativeTo = Environment.CurrentDirectory, path = source)
+    let target = Path.Combine(outputDirectory, relativePath)
+    Directory.CreateDirectory(Path.GetDirectoryName(target)) |> ignore
+    File.Copy(source, target, overwrite = true)
+
+let isFileInOutputDirectory path =
+    let absoluteTargetPath = Path.GetFullPath(outputDirectory) + Path.DirectorySeparatorChar.ToString()
+    let absolutePath = Path.GetFullPath(path)
+    absolutePath.StartsWith(absoluteTargetPath)
+
+let copyToOutput (pattern) =
+    Directory.GetFiles(Environment.CurrentDirectory, searchPattern = pattern, searchOption = SearchOption.AllDirectories)
+        |> Seq.where (fun p -> not (isFileInOutputDirectory p))
+        |> Seq.iter copyFileToOutput
+
+Directory.CreateDirectory(outputDirectory)
+writeIndexHtml()
+copyToOutput("fonts/*.woff2")
+copyToOutput("icons/*.svg")
+copyToOutput("*.css")
+copyToOutput("*.js")

global.json

@@ -0,0 +1,6 @@
+{
+  "sdk": {
+    "version": "7.0.100-preview.6.22352.1",
+    "rollForward": "feature"
+  }
+}

index.html

@@ -86,18 +86,18 @@ <h2>Getting started</h2>
                     </ul>
 
                     <div id="panel-dotnet-cli" role="tabpanel" aria-labelledby="tab-dotnet-cli" class="panel">
-                        <code>dotnet add package Funcky --version 2.7.1</code>
+                        <code>dotnet add package Funcky --version {{PackageVersion}}</code>
                     </div>
 
                     <div id="panel-package-refererence" role="tabpanel" aria-labelledby="tab-package-refererence" class="panel">
-                        <code>&lt;PackageReference Include="Funcky" Version="2.7.1" /&gt;</code>
+                        <code>&lt;PackageReference Include="Funcky" Version="{{PackageVersion}}" /&gt;</code>
                     </div>
                 </div>
             </div>
         </section>
     </main>
     <footer>
-        <div class="_container">© 2022 Polyadic.</div>
+        <div class="_container">© {{Year}} Polyadic.</div>
     </footer>
     <script type="module" src="tabs.js"></script>
 </body>