Nadeau Innovations Site

Nadeau Innovations site built using the Jamstack and other web/AI tech stacks:

• Netlify CI/CD, CDN, and hosting
• Hugo static site framework
• Markdown content
• Namecheap domain name provider
• Wowchemy Hugo theme

Item	Badges
Social
Build
Activity
Deploy

Development

Installation

• Install Hugo
  • .deb installation is easiest

# e.g., download binary from
sudo dpkg -i hugo_extended_0.97.1_Linux-64bit.deb

• Install golang

Build

make build

Creating Content

• See the Makefile for entrypoints, e.g.:

# add post
make post

# add publication
make publication

# format publications
make format-publications

Updating Theme

• Use only released versions
• See the Wowchemy docs for details
• TLDR, update the pinned versions in go.mod with:

module my-website

go 1.15

require (
  github.com/wowchemy/wowchemy-hugo-themes/modules/wowchemy-plugin-netlify main
  github.com/wowchemy/wowchemy-hugo-themes/modules/wowchemy/v5 main
)

• The build process will then change main to a specific pinned version (tag + hash)

Tips

YouTube/Vimeo

{{< youtube abcxyz >}}

{{< vimeo 123456 >}}

Twitter Tweet

{{< tweet user="xxx" id="yyy" >}}

Limit Summary

<!--more-->

Logos

Logos for experience widget are located in static/logos

Figures and Captions

• Figures can be created with captions for screen readers and accessibility

![screen reader text](image.jpg "caption")

Custom Footer

Custom footer in site folder at layouts/partials/hooks/footer.html

CSV Table

CSV Table shortcode: {{< table path="results.csv" header="true" caption="Table 1: My results" >}}

Template Theme Documentation

• Page features
• Page elements

Linking Internal Pages

{{< ref "publication/nadeau-2018-evolutionary" >}}

CI/CD and Releases

• master branch is automatically released using semantic-release and GitHub Actions
  • See .github/workflows/release.yml
  • Requires a personal token with the public_repo scope
• The site is deployed using Netlify
  • Build images are defined in the Netlify web UI