This very large commit switches to using Docsy theme for site,

as well as also reorganizing the site content to fit the structure from the system defined by https://documentation.divio.com/ Signed-off-by: deadprogram <ron@hybridgroup.com>

Author: deadprogram

.gitignore

@@ -1,2 +1,4 @@
 public
-build
+build
+node_modules
+npm-debug.log

.gitmodules

@@ -1,3 +1,3 @@
-[submodule "themes/learn"]
-path = themes/learn
-url = https://github.com/matcornic/hugo-theme-learn.git
+[submodule "themes/docsy"]
+path = themes/docsy
+url = https://github.com/google/docsy.git

README.md

@@ -8,13 +8,17 @@ Built using Hugo:
 
 http://gohugo.io/
 
-and the Hugo "Learn" theme:
+and the Hugo "Docsy" theme:
 
-https://github.com/matcornic/hugo-theme-learn
+https://github.com/google/docsy
 
-## Installation
+## Prerequisites
+
+Install Hugo command line tool for your operating system with the "extended" option, along with the needed NodeJS modules for processing the site CSS:
 
-Install Hugo command line tool for your operating system.
+https://www.docsy.dev/docs/getting-started/#prerequisites-and-installation
+
+## Installation
 
 Clone this repo using:
 
@@ -24,9 +28,9 @@ Change directories into the tinygo-site directory:
 
  cd tinygo-site
 
-Install the "Learn" theme:
+Install the "Docsy" theme:
 
- git submodule update --init
+ git submodule update --init --recursive
 
 Now you should be able to run the site locally:
 
@@ -42,7 +46,4 @@ That's it.
 
 ## TODO:
 
-- Generate custom godocs for all tinygo build tags, add to "Documentation" section, and point Godocs links there.
-- Activate search.
-- Custom domain for all packages
 - ?

assets/icons/logo.svg

@@ -0,0 +1,12 @@
+$gunmetal: #022f40ff;
+$pacific-blue: #38aeccff;
+$blue-ncs: #0090c1ff;
+$gunmetal-2: #183446ff;
+$blue-sapphire: #046e8fff;
+$alice-blue: #edf9fcff;
+
+$primary: $blue-sapphire;
+$primary-light: $blue-ncs;
+$secondary: $gunmetal;
+$light: $pacific-blue;
+$dark: $gunmetal-2;

assets/scss/_variables_project.scss

@@ -1,35 +1,72 @@
 baseURL = "https://tinygo.org/"
-title = "TinyGo - Go on Microcontrollers and WASM"
+title = "TinyGo"
 languageCode = "en-us"
-theme = "learn"
+theme = "docsy"
+
+enableGitInfo = true
+
+## Configuration for BlackFriday markdown parser: https://github.com/russross/blackfriday
+[blackfriday]
+plainIDAnchors = true
+hrefTargetBlank = true
+angledQuotes = false
+latexDashes = true
+
+# Image processing configuration.
+[imaging]
+resampleFilter = "CatmullRom"
+quality = 75
+anchor = "smart"
 
 [markup.goldmark.renderer]
 unsafe = true
 
+# Everything below this are Site Params
+
 [params]
-# Change default color scheme with a variant one. Can be "red", "blue", "green".
-themeVariant = "blue"
-# Disable search function. It will hide search bar
-disableSearch = true
-editURL = "https://github.com/tinygo-org/tinygo-site/edit/release/content/"
-disableInlineCopyToClipBoard = true
-
-[[menu.shortcuts]] 
-name = "<i class='fab fa-github'></i> Github repo"
-url = "https://github.com/tinygo-org/tinygo"
-weight = 10
-
-[[menu.shortcuts]] 
-name = "<i class='fa fa-book'></i> Godoc"
-url = "https://pkg.go.dev/github.com/tinygo-org/tinygo?tab=doc"
-weight = 20
-
-[[menu.shortcuts]] 
-name = "<i class='fab fa-twitter'></i> Twitter"
-url = "https://twitter.com/TinyGolang"
-weight = 30
-
-[[menu.shortcuts]] 
-name = "<i class='fab fa-slack'></i> Slack"
-url = "https://gophers.slack.com/messages/CDJD3SUP6/"
-weight = 40
+copyright = "The TinyGo Authors"
+
+
+# Repository configuration (URLs for in-page links to opening issues and suggesting changes)
+github_repo = "https://github.com/google/tinygo-site"
+# An optional link to a related project repo. For example, the sibling repository where your product code lives.
+github_project_repo = "https://github.com/tinygo-org/tinygo"
+github_branch= "release"
+
+
+# User interface configuration
+[params.ui]
+# Enable to show the side bar menu in its compact state.
+sidebar_menu_compact = true
+# Set to true to disable breadcrumb navigation.
+breadcrumb_disable = false
+# Set to true to hide the sidebar search box (the top nav search box will still be displayed if search is enabled)
+sidebar_search_disable = false
+# Set to false if you don't want to display a logo (/assets/icons/logo.svg) in the top nav bar
+navbar_logo = true
+# Set to true to disable the About link in the site footer
+footer_about_disable = false
+
+[params.links]
+# End user relevant links. These will show up on left side of footer and in the community page if you have one.
+[[params.links.user]]
+name ="Twitter"
+url = "https://twitter.com/TinyGolang"
+icon = "fab fa-twitter"
+ desc = "Follow us on Twitter to get the latest news!"
+[[params.links.user]]
+name ="Go Pkg Docs"
+url = "https://pkg.go.dev/github.com/tinygo-org/tinygo?tab=doc"
+icon = "fa fa-book"
+ desc = "Package Documentation"
+# Developer relevant links. These will show up on right side of footer and in the community page if you have one.
+[[params.links.developer]]
+name = "GitHub"
+url = "https://github.com/tinygo-org/tinygo"
+icon = "fab fa-github"
+ desc = "Development takes place here!"
+[[params.links.developer]]
+name = "Slack"
+url = "https://gophers.slack.com/messages/CDJD3SUP6/"
+icon = "fab fa-slack"
+ desc = "Chat with other project developers"

config.toml

@@ -1,16 +1,51 @@
 ---
-title: "Home"
+title: "TinyGo Home"
 ---
-# TinyGo - A Go Compiler For Small Places
 
-TinyGo is a project to bring the [Go programming language](https://golang.org) to microcontrollers and modern web browsers by creating a new compiler based on [LLVM](https://llvm.org/).
+{{< blocks/cover title="TinyGo - A Go Compiler For Small Places" image_anchor="top" height="full" color="primary" >}}
+
+![TinyGo Logo](images/tinygo-logo.png)
+
+<div class="mx-auto">
+<a class="btn btn-lg btn-primary mr-3 mb-4" href="{{< relref "/getting-started" >}}">
+Get Started <i class="fas fa-arrow-alt-circle-right ml-2"></i>
+</a>
+<a class="btn btn-lg btn-secondary mr-3 mb-4" href="https://github.com/tinygo-org/tinygo">
+See the code <i class="fab fa-github ml-2 "></i>
+</a>
+<p class="lead mt-5">Go on embedded systems and WebAssembly</p>
+{{< blocks/link-down color="info" >}}
+</div>
+{{< /blocks/cover >}}
+
+{{% blocks/lead color="secondary" %}}
+TinyGo is a project to bring the [Go programming language](https://golang.org) to embedded systems and the modern web by creating a new compiler based on [LLVM](https://llvm.org/).
 
 You can compile and run TinyGo programs on many different microcontroller boards such as the [BBC micro:bit](https://www.microbit.co.uk/) and the [Arduino Uno](https://store.arduino.cc/usa/arduino-uno-rev3/).
 
 TinyGo can also be used to produce [WebAssembly (WASM)](https://webassembly.org/) code which is very compact in size.
+{{% /blocks/lead %}}
+
+{{< blocks/section color="primary-light" >}}
+{{% blocks/feature icon="fa-lightbulb" title="TinyGo Playground" url="https://play.tinygo.org/" %}}
+Try the TinyGo Playground online
+{{% /blocks/feature %}}
+
+{{% blocks/feature icon="fab fa-github" title="Show me the code!" url="https://github.com/tinygo-org/tinygo" %}}
+Just want to see the code?
+{{% /blocks/feature %}}
 
-Just want to see the code? Go to the Github repository at [https://github.com/tinygo-org/tinygo](https://github.com/tinygo-org/tinygo).
 
+{{% blocks/feature icon="fab fa-twitter" title="Follow us on Twitter!" url="https://twitter.com/tinygolang" %}}
+For all the latest and greatest
+{{% /blocks/feature %}}
+
+{{< /blocks/section >}}
+
+
+{{< blocks/section color="secondary">}}
 TinyGo also has support for several different devices such as accelerometers and magnetometers. Check out the Github repository at [https://github.com/tinygo-org/drivers](https://github.com/tinygo-org/drivers) for more information.
 
 Ready to get started? [Click here](getting-started).
+
+{{< /blocks/section >}}

content/_index.md

@@ -0,0 +1,10 @@
+---
+title: "Documentation"
+linkTitle: "Documentation"
+weight: 20
+menu:
+ main:
+ weight: 20
+---
+
+The TinyGo documentation is organized into specific sections to help you locate the information that you need.