Merge branch 'hugo-relearn-theme' into 'main'

Moving documentation to Huge relearn theme

See merge request weblogic-cloud/weblogic-image-tool!511

Author: ddsharpe

.github/workflows/publish-github-pages.yml

@@ -41,7 +41,7 @@ jobs:
       - name: Build and publish site
         run: |
           echo "Downloading Hugo for generating HTML documentation from Markdown"
-          curl -fL -o hugo.tar.gz "https://github.com/gohugoio/hugo/releases/download/v0.108.0/hugo_0.108.0_Linux-64bit.tar.gz"
+          curl -fL -o hugo.tar.gz "https://github.com/gohugoio/hugo/releases/download/v0.152.2/hugo_0.152.2_Linux-64bit.tar.gz"
           tar -xf hugo.tar.gz
           export PATH="$PWD:$PATH"
           

.gitignore

@@ -7,3 +7,5 @@
 **/target
 **/.DS_Store
 .mvn/maven.config
+**/.hugo_build.lock
+documentation/**/docs

documentation/site/config.toml

@@ -6,14 +6,22 @@ languageCode = "en-us"
 title = "WebLogic Image Tool"
 
 # Change the default theme to be use when building the site with Hugo
-theme = "hugo-theme-learn"
+theme = "hugo-theme-relearn-8.3.0"
 
 publishDir = "docs"
 
 # For search functionality
 [outputs]
   home = [ "HTML", "RSS", "JSON"]
 
+[markup]
+  defaultMarkdownHandler = 'goldmark'
+  [markup.goldmark]
+    [markup.goldmark.renderer]
+      unsafe = true
+
 [params]
+  hideAuthorDate = true
   # disable the copy to clipboard links
   disableInlineCopyToClipBoard = true
+  themeVariant = "learn"

documentation/site/content/_index.md

@@ -1,3 +1,7 @@
+---
+hideHeader: true
+---
+
 # WebLogic Image Tool
 
 Oracle is finding ways for organizations using WebLogic Server to run important workloads, to move those workloads into
@@ -19,7 +23,7 @@ the JDK and Oracle Home as part of moving the domain.
 * Create a new container image by applying WebLogic patches to an existing image. In addition,
  if one did not exist previously, you can create a WebLogic domain, update an existing domain, or deploy an application.
 
-For detailed information, see [Image Tool]({{< relref "/userguide/tools/_index.md" >}}).
+For detailed information, see [Image Tool]({{% relref "/userguide/tools/_index.md" %}}).
 
 ***
 ### Current production release
@@ -29,16 +33,17 @@ WebLogic Image Tool version and release information can be found [here](https://
 ***
 ### Recent changes and known issues
 
-See the [Release Notes]({{< relref "/release-notes.md" >}}) for issues and important information.
+See the [Release Notes](https://github.com/oracle/weblogic-image-tool/releases/)
+for issues and important information.
 
 
 ### About this documentation
 
-* Use the [Quick Start]({{< relref "/quickstart/quickstart.md" >}}) guide to create a Linux based WebLogic container image.
-* The [User Guide]({{< relref "/userguide/" >}}) contains detailed usage information, including command options and usage scenarios.
-* The [Samples]({{< relref "/samples/" >}}) provide typical and informative use cases.
-* The [Developer Guide]({{< relref "/developer/" >}}) provides details for people who want to understand how WIT is built. Those
-who wish to contribute to the WebLogic Image Tool code will find useful information [here]({{< relref "/developer/contribute.md" >}}).
+* Use the [Quick Start]({{% relref "/quickstart/quickstart.md" %}}) guide to create a Linux based WebLogic container image.
+* The [User Guide]({{% relref "/userguide/" %}}) contains detailed usage information, including command options and usage scenarios.
+* The [Samples]({{% relref "/samples/" %}}) provide typical and informative use cases.
+* The [Developer Guide]({{% relref "/developer/" %}}) provides details for people who want to understand how WIT is built. Those
+who wish to contribute to the WebLogic Image Tool code will find useful information [here]({{% relref "/developer/contribute.md" %}}).
 
 
 ### Related projects
@@ -47,7 +52,6 @@ who wish to contribute to the WebLogic Image Tool code will find useful informat
 * [WebLogic Deploy Tooling](https://oracle.github.io/weblogic-deploy-tooling/)
 * [WebLogic Kubernetes Toolkit UI](https://oracle.github.io/weblogic-toolkit-ui/)
 * [WebLogic Monitoring Exporter](https://github.com/oracle/weblogic-monitoring-exporter)
-* [WebLogic Logging Exporter](https://github.com/oracle/weblogic-logging-exporter)
 * [WebLogic Remote Console](https://oracle.github.io/weblogic-remote-console/)
 
 ### Supported Fusion Middleware (FMW) products

documentation/site/content/developer/_index.md

@@ -6,6 +6,6 @@ chapter = true
 pre = "<b> </b>"
 +++
 
-# Developer Guide
-
 The Developer Guide provides information for developers who want to build the installer from source or contribute to the code.
+
+{{% children type="list" description="true" %}}

documentation/site/content/developer/contribute.md

@@ -3,6 +3,7 @@ title: "Contribute to WIT"
 date: 2019-02-23T17:19:24-05:00
 draft: false
 weight: 2
+description: "How to contribute to the development of the Image Tool."
 ---
 
 Oracle welcomes contributions to this repository from anyone.

documentation/site/content/developer/source.md

@@ -3,6 +3,7 @@ title: "Build from source"
 date: 2019-02-23T17:19:24-05:00
 draft: false
 weight: 1
+description: "How to build the Image Tool from source."
 ---
 
 

documentation/site/content/quickstart/_index.md

@@ -1,11 +1,11 @@
 +++
-title = "Quick Start"
+title = "Quick Start Guide"
 date = 2019-02-22T15:27:54-05:00
 weight = 1
 chapter = true
 pre = "<b> </b>"
 +++
 
-# Quick Start Guide
-
 Use this Quick Start guide to create a Linux based WebLogic container image.
+
+{{% children type="list" description="true" %}}

documentation/site/content/quickstart/quickstart.md

@@ -8,7 +8,7 @@ weight: 3
 
 #### Before you begin
 
-Make sure that you have fulfilled the [Prerequisites]({{< relref "/userguide/prerequisites.md" >}}) and [Setup]({{< relref "/userguide/setup.md" >}}) requirements.
+Make sure that you have fulfilled the [Prerequisites]({{% relref "/userguide/prerequisites.md" %}}) and [Setup]({{% relref "/userguide/setup.md" %}}) requirements.
 
 #### Overview
 
@@ -27,7 +27,7 @@ and save them in a directory of your choice, for example, `/home/acmeuser/wls-in
      `jdk-8u202-linux-x64.tar.gz`
 
 
-2. Use the [Cache Tool]({{< relref "/userguide/tools/cache.md" >}}) to add the installers:
+2. Use the [Cache Tool]({{% relref "/userguide/tools/cache.md" %}}) to add the installers:
 
     ```bash
     $ imagetool cache addInstaller --type jdk --version 8u202 --path /home/acmeuser/wls-installers/jdk-8u202-linux-x64.tar.gz
@@ -49,7 +49,7 @@ and save them in a directory of your choice, for example, `/home/acmeuser/wls-in
     wls_12.2.1.3.0=/home/acmeuser/wls-installers/fmw_12.2.1.3.0_wls_Disk1_1of1.zip
     ```
 
-3. Run the [`imagetool create`]({{< relref "/userguide/tools/create-image.md" >}}) command:
+3. Run the [`imagetool create`]({{% relref "/userguide/tools/create-image.md" %}}) command:
 
    ```bash
    $ imagetool create --tag wls:12.2.1.3.0