Create Hugo documentation directory

Author: rjeberhard

Diff for: .github/workflows/publish-github-pages.yml

@@ -0,0 +1,66 @@
+# Copyright (c) 2021, Oracle and/or its affiliates.
+# Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl.
+#
+# Description
+#  Use Hugo to build static site and publish to gh-pages
+#
+name: "PublishGitHubPages"
+
+on:
+  push:
+    branches: [ main ]
+  schedule:
+    - cron: '15 3 * * 1'
+
+defaults:
+  run:
+    shell: bash
+
+jobs:
+  publish:
+    name: Publish
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout main
+        uses: actions/checkout@v2.3.4
+        with:
+          ref: main
+          fetch-depth: 32
+          path: main
+
+      - name: Checkout gh-pages
+        uses: actions/checkout@v2.3.4
+        with:
+          ref: gh-pages
+          path: gh-pages
+          token: ${{ secrets.PUBLISH_SECRET }}
+
+      - name: Verify changes to documentation present
+        id: change-check
+        run: |
+          cd $GITHUB_WORKSPACE/main
+          X=`git diff HEAD~1 --name-only | { grep "^documentation" || test $? = 1; } | wc -l`
+          if [ $X == "0" ]; then
+            echo 'No changes to the documenation'
+          else
+            echo '::set-output name=DOCUMENTATION_CHANGED::true'
+          fi
+
+      - name: Build and publish site
+        if: ${{ steps.change-check.outputs.DOCUMENTATION_CHANGED == 'true' }}
+        run: |
+          curl -fL -o hugo.tar.gz "https://github.com/gohugoio/hugo/releases/download/v0.82.0/hugo_0.82.0_Linux-64bit.tar.gz"
+          tar -xf hugo.tar.gz
+          export PATH="$PWD:$PATH"
+          mkdir $GITHUB_WORKSPACE/WORK
+          cd $GITHUB_WORKSPACE/main/documentation
+          ./publish.sh -o $GITHUB_WORKSPACE/WORK
+          cd $GITHUB_WORKSPACE/gh-pages
+          rm -Rf *
+          cp -R $GITHUB_WORKSPACE/WORK/* .
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add --all
+          git commit -m "Documentation update from publish GitHub Action"
+          git push origin gh-pages

Diff for: documentation/1.9/.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+    "git.ignoreLimitWarning": true
+}

Diff for: documentation/1.9/archetypes/default.md

@@ -0,0 +1,19 @@
+# analytics
+googleAnalytics = "UA-129126578-2"
+
+baseURL = "/weblogic-kubernetes-operator/"
+languageCode = "en-us"
+title = "WebLogic Kubernetes Operator"
+
+# Change the default theme to be use when building the site with Hugo
+theme = "hugo-theme-learn"
+
+publishDir = "docs"
+
+# For search functionality
+[outputs]
+  home = [ "HTML", "RSS", "JSON"]
+
+[params]
+  # disable the copy to clipboard links
+  disableInlineCopyToClipBoard = true

Diff for: documentation/1.9/config.toml

@@ -0,0 +1 @@
+<img src="{{ .Get 1 | absURL }}" alt="{{ .Get 0 }}">

Diff for: KnownIssues.md renamed to documentation/1.9/content/KnownIssues.md

@@ -0,0 +1,2 @@
+<!-- raw html -->
+{{.Inner}}

Diff for: ReleaseProcess.md renamed to documentation/1.9/content/ReleaseProcess.md

@@ -0,0 +1,2 @@
+{{ $toRead := .Get "file" }}
+{{ readFile $toRead | markdownify }}

Diff for: documentation/1.9/content/_index.md

@@ -0,0 +1,9 @@
+#!/bin/bash
+
+# Copyright (c) 2019, 2021, Oracle and/or its affiliates.
+# Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl.
+
+# 1313 is the hugo default port
+port=${1:-1313}
+
+hugo server -b http://localhost:$port/weblogic-kubernetes-operator -D -p $port

Diff for: site/archive.md renamed to documentation/1.9/content/archive.md

@@ -0,0 +1,9 @@
+#!/bin/bash
+
+# Copyright (c) 2019, 2021, Oracle and/or its affiliates.
+# Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl.
+
+# 1313 is the hugo default port
+port=${1:-1313}
+
+hugo server -b http://$(hostname).$(dnsdomainname):$port/weblogic-kubernetes-operator -D --bind=$(hostname).$(dnsdomainname) -p $port

Diff for: site/compare.md renamed to documentation/1.9/content/compare.md

@@ -0,0 +1,16 @@
+# https://editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 2
+indent_style = space
+trim_trailing_whitespace = true
+
+[*.js]
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false

Diff for: site/config/target_env.md renamed to documentation/1.9/content/config/target_env.md

@@ -0,0 +1,3 @@
+.DS_Store
+public/
+exampleSite/public

Diff for: site/create.md renamed to documentation/1.9/content/create.md

@@ -0,0 +1,25 @@
+---
+  dataSource: "prs"
+  prefix: "v"
+  onlyMilestones: false
+  changelogFilename: "CHANGELOG.md"
+  includeMessages: "all"
+  ignoreIssuesWith:
+    - "support"
+  ignoreLabels:
+    - "duplicate"
+    - "invalid"
+    - "wontfix"
+  groupBy:
+    New features:
+      - "feature"
+    Bug Fixes:
+      - "bug"
+    Enhancements:
+      - "enhancement"
+    Internationalisation:
+      - "i18n"
+    Theme Meta:
+      - "meta"
+    Uncategorised:
+      - "closed"