From 5f9e6f4863b6d92ec1f4dc0d45ad3aeadd27cd20 Mon Sep 17 00:00:00 2001 From: junior Date: Mon, 1 Apr 2024 22:15:10 -0500 Subject: [PATCH 01/10] partial update of the GHA for docs Signed-off-by: junior --- .github/workflows/docs.yml | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index 58cb537ce..23a3a35c8 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -12,20 +12,24 @@ jobs: runs-on: ubuntu-latest steps: - name: Checkout - uses: actions/checkout@v2 + uses: actions/checkout@v4 + - name: Setup Node - uses: actions/setup-node@v2 + uses: actions/setup-node@v4 with: - node-version: '14' + node-version: '' + - name: Setup Hugo uses: peaceiris/actions-hugo@v2 with: - hugo-version: '0.82.0' + hugo-version: '0.122.0' extended: true + - name: Build Hugo Docs run: | cd src/docs make build + - name: Publish to Github Pages uses: peaceiris/actions-gh-pages@v3 with: From 2c7c28f665cb0f45fddc844317bac9183e2408d2 Mon Sep 17 00:00:00 2001 From: junior Date: Mon, 1 Apr 2024 23:11:29 -0500 Subject: [PATCH 02/10] renewing docs Gha to not user 3rd-party actions Signed-off-by: junior --- .github/workflows/docs.yml | 37 ++++++++++++++++++++++--------------- 1 file changed, 22 insertions(+), 15 deletions(-) diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index 23a3a35c8..863441dee 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -2,37 +2,44 @@ name: Publish Docs on: push: - branches: + branches: - master - docs_update paths: - 'src/docs/**' jobs: - build-and-deploy: + build: runs-on: ubuntu-latest steps: - name: Checkout uses: actions/checkout@v4 - - name: Setup Node uses: actions/setup-node@v4 with: node-version: '' - - name: Setup Hugo - uses: peaceiris/actions-hugo@v2 - with: - hugo-version: '0.122.0' - extended: true - + run: | + sudo apt install -y hugo - name: Build Hugo Docs run: | cd src/docs make build - - - name: Publish to Github Pages - uses: peaceiris/actions-gh-pages@v3 + - name: Upload production artifact + uses: actions/upload-pages-artifact@v3 with: - github_token: ${{ secrets.GITHUB_TOKEN }} - publish_branch: gh-pages - publish_dir: src/docs/public + path: ./src/docs/public + + deploy: + needs: build + 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@v4 + From 409aecadaa140015fa9052924c2b9a2670b96ed1 Mon Sep 17 00:00:00 2001 From: junior Date: Mon, 1 Apr 2024 23:12:47 -0500 Subject: [PATCH 03/10] md fmt Signed-off-by: junior --- src/docs/content/usage.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/src/docs/content/usage.md b/src/docs/content/usage.md index d2e4e48e4..0ff3b97c3 100644 --- a/src/docs/content/usage.md +++ b/src/docs/content/usage.md @@ -342,6 +342,7 @@ Slideshow items must be `
  • ` type. Refer to [usage](https://getuikit.com/docs/ > Create a tabbed content switcher {{% grid col="1-2" y="top" %}} + ```markdown {{}} - Tab one content @@ -355,10 +356,13 @@ Slideshow items must be `
  • ` type. Refer to [usage](https://getuikit.com/docs/ {{% wrapper %}} {{< switcher left=true tabs="One|Two|Three" >}} + - Tab one content + ```ts const foo: string = 'bar'; ``` + - Tab two content - Tab three content {{< /switcher >}} From 87ff3b84954e7dd6fa4e8b3f96f8e57f4c3562c5 Mon Sep 17 00:00:00 2001 From: junior Date: Mon, 1 Apr 2024 23:24:54 -0500 Subject: [PATCH 04/10] gha docs updated Signed-off-by: junior --- .github/workflows/docs.yml | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index 863441dee..e0ba616d7 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -10,6 +10,8 @@ on: jobs: build: runs-on: ubuntu-latest + env: + HUGO_VERSION: 0.122.0 steps: - name: Checkout uses: actions/checkout@v4 @@ -19,7 +21,11 @@ jobs: node-version: '' - name: Setup Hugo run: | - sudo apt install -y hugo + wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb \ + && sudo dpkg -i ${{ runner.temp }}/hugo.deb + - name: Setup Pages + id: pages + uses: actions/configure-pages@v5 - name: Build Hugo Docs run: | cd src/docs @@ -42,4 +48,3 @@ jobs: - name: Deploy to GitHub Pages id: deployment uses: actions/deploy-pages@v4 - From e377d64ae16a310a47c4b2f61aa12c72a9425181 Mon Sep 17 00:00:00 2001 From: junior Date: Mon, 1 Apr 2024 23:26:29 -0500 Subject: [PATCH 05/10] md fmt Signed-off-by: junior --- src/docs/content/usage.md | 1 + 1 file changed, 1 insertion(+) diff --git a/src/docs/content/usage.md b/src/docs/content/usage.md index 0ff3b97c3..abd59a1d7 100644 --- a/src/docs/content/usage.md +++ b/src/docs/content/usage.md @@ -413,6 +413,7 @@ Slideshow items must be `
  • ` type. Refer to [usage](https://getuikit.com/docs/ > Wraps inner content with any `div` and specified classes. Useful for specifying markup with other UIkit features {{% grid col="1-2" y="top" %}} + ```markdown {{%/* wrapper "uk-light uk-background-primary uk-panel uk-padding" */%}} Light Panel From da86c717243524a82d223a319661bf86606bac15 Mon Sep 17 00:00:00 2001 From: junior Date: Mon, 1 Apr 2024 23:28:55 -0500 Subject: [PATCH 06/10] md fmt Signed-off-by: junior --- src/docs/content/usage.md | 1 + 1 file changed, 1 insertion(+) diff --git a/src/docs/content/usage.md b/src/docs/content/usage.md index abd59a1d7..040e585d6 100644 --- a/src/docs/content/usage.md +++ b/src/docs/content/usage.md @@ -185,6 +185,7 @@ Content with aspect ratio of `2-1` > Display content as cards - usually in a grid {{% grid col="1-2" y="top" %}} + ```markdown {{%/* grid col="1-2" */%}} {{%/* card style="primary" title="Primary" hover=true */%}} From cd80cb80a2c80ed5031ac3b03dc60c5d2d0cc129 Mon Sep 17 00:00:00 2001 From: junior Date: Mon, 1 Apr 2024 23:41:52 -0500 Subject: [PATCH 07/10] docs gha allowing dispatch Signed-off-by: junior --- .github/workflows/docs.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index e0ba616d7..d532849c6 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -7,6 +7,7 @@ on: - docs_update paths: - 'src/docs/**' + workflow_dispatch: jobs: build: runs-on: ubuntu-latest From 276e461fb29b169f76323b532affcb8f9ad4fa08 Mon Sep 17 00:00:00 2001 From: junior Date: Mon, 1 Apr 2024 23:43:24 -0500 Subject: [PATCH 08/10] md fmt Signed-off-by: junior --- src/docs/content/usage.md | 1 + 1 file changed, 1 insertion(+) diff --git a/src/docs/content/usage.md b/src/docs/content/usage.md index 040e585d6..7fe63621f 100644 --- a/src/docs/content/usage.md +++ b/src/docs/content/usage.md @@ -226,6 +226,7 @@ Card body > Add a grid of inner contents using [grid](https://getuikit.com/docs/grid) and [flex](https://getuikit.com/docs/flex) {{% grid col="1-2" y="top" %}} + ```markdown {{%/* grid col="1-3" */%}} - **Example** From 3f7d6af30c3e27ff35fa47b64ee121de047d621f Mon Sep 17 00:00:00 2001 From: junior Date: Tue, 2 Apr 2024 00:06:02 -0500 Subject: [PATCH 09/10] gha to test docs updated Signed-off-by: junior --- .github/workflows/test-docs.yml | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/.github/workflows/test-docs.yml b/.github/workflows/test-docs.yml index b11cf5084..53d011106 100644 --- a/.github/workflows/test-docs.yml +++ b/.github/workflows/test-docs.yml @@ -7,18 +7,19 @@ on: jobs: test-build: runs-on: ubuntu-latest + env: + HUGO_VERSION: 0.122.0 steps: - name: Checkout - uses: actions/checkout@v1 + uses: actions/checkout@v4 - name: Setup Node - uses: actions/setup-node@v1 + uses: actions/setup-node@v4 with: - node-version: '10.x' + node-version: '' - name: Setup Hugo - uses: peaceiris/actions-hugo@v2 - with: - hugo-version: '0.66.0' - extended: true + run: | + wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb \ + && sudo dpkg -i ${{ runner.temp }}/hugo.deb - name: Build Hugo Docs run: | cd src/docs From 5984d76f517ff8f10e6c0dd2e22cda55e24b967f Mon Sep 17 00:00:00 2001 From: junior Date: Tue, 2 Apr 2024 00:08:37 -0500 Subject: [PATCH 10/10] md fmt for gha Signed-off-by: junior --- src/docs/content/usage.md | 1 + 1 file changed, 1 insertion(+) diff --git a/src/docs/content/usage.md b/src/docs/content/usage.md index 7fe63621f..66fd90779 100644 --- a/src/docs/content/usage.md +++ b/src/docs/content/usage.md @@ -237,6 +237,7 @@ Card body {{% wrapper %}} {{% grid col="1-3" %}} + - **Example** - Item one - Item two