feat(initial): Initial commit of v2

.editorconfig

@@ -1,10 +1,14 @@
-; See http://EditorConfig.org for supported IDEs
+; https://editorconfig.org
 
-root = true  ; top-most EditorConfig file
+root = true
 
 [*]
-indent_style = tab
-indent_size = 4
 charset = utf-8
+end_of_line = lf
+indent_size = 2
+indent_style = space
 trim_trailing_whitespace = true
 insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false

.gitattributes

@@ -1,24 +1 @@
-# Set default behaviour, in case users don't have core.autocrlf set.
-* text=auto
-
-# These files are text and should be normalized (convert crlf => lf)
-*.js      text
-*.css     text
-*.scss    text
-*.html    text
-*.php     text
-*.inc     text
-*.xml     text
-*.txt     text
-*.md      text
-*.properties  text
-*.rb      text
-*.yml     text
-
-
-# Images should be treated as binary
-# (binary is a macro for -text -diff)
-*.png     binary
-*.jpeg    binary
-*.gif     binary
-*.jar     binary
+* text=auto eol=lf

.github/workflows/gh-pages.yml

@@ -2,11 +2,11 @@ name: github pages
 on:
   push:
     branches:
-      - master
+      - main
 
 jobs:
   deploy:
-    runs-on: ubuntu-18.04
+    runs-on: ubuntu-22.04
     steps:
       - uses: actions/checkout@v2
         with:
@@ -16,20 +16,24 @@ jobs:
       - name: Setup Hugo
         uses: peaceiris/actions-hugo@v2
         with:
-          hugo-version: '0.78.2'
+          hugo-version: '0.115.2'
           extended: true
 
       - name: Setup Node
         uses: actions/setup-node@v1
         with:
-          node-version: '12.x'
+          node-version: '16.x'
+
+      - name: Cache dependencies
+        uses: actions/cache@v1
+        with:
+          path: ~/.npm
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-
+
+      - run: npm install
 
-      - run: |
-          cd themes
-          git clone https://github.com/MunifTanjim/minimo.git minimo
-          cd minimo
-          git checkout v2.9.0
-          cd ../..
       - name: Build
         run: hugo --minify
 

.gitignore

@@ -1,33 +1,9 @@
-# Project
-nbproject/*
-.sass-cache/
+node_modules/
+public/
+resources/
 .DS_Store
-jruby*.jar
-dist/*
-build/lib/vendors*
-build/lib/jruby-compiled
-_notes/
-
-# OS generated files
-.DS_Store
-.DS_Store?
-._*
-.Spotlight-V100
-.Trashes
-ethumbs.db
-Thumbs.db
-/.project
-jshint.out.xml
-csslint.out.xml
-*.orig
-*.tmp
-*.log
-_site/*
-vendor/
-
-# Hugo
-Hugo
-public
-themes/minimo
-static/lib
-static/video
+.hugo_build.lock
+_vendor
+hugo_stats.json
+package-lock.json
+go.sum

.jshintrc

@@ -0,0 +1,59 @@
+{
+  "maxerr": 50,
+  "bitwise": true,
+  "camelcase": false,
+  "curly": true,
+  "eqeqeq": true,
+  "forin": true,
+  "freeze": true,
+  "immed": true,
+  "indent": 2,
+  "latedef": true,
+  "newcap": false,
+  "noarg": true,
+  "noempty": true,
+  "nonbsp": true,
+  "nonew": true,
+  "plusplus": false,
+  "undef": true,
+  "unused": false,
+  "strict": true,
+  "maxparams": false,
+  "maxdepth": 4,
+  "maxstatements": false,
+  "maxcomplexity": false,
+  "maxlen": 400,
+  "browser": true,
+  "devel": true,
+  "asi": false,
+  "boss": false,
+  "debug": false,
+  "eqnull": false,
+  "es3": false,
+  "es5": false,
+  "esversion": 12,
+  "moz": false,
+  "evil": true,
+  "expr": true,
+  "funcscope": false,
+  "globalstrict": false,
+  "iterator": false,
+  "lastsemic": false,
+  "laxbreak": false,
+  "laxcomma": false,
+  "loopfunc": true,
+  "multistr": true,
+  "noyield": false,
+  "notypeof": false,
+  "proto": false,
+  "scripturl": false,
+  "shadow": false,
+  "sub": false,
+  "supernew": false,
+  "validthis": false,
+  "globals": {
+    "jQuery": false,
+    "google": false,
+    "$": false
+  }
+}

.markdownlint.json

@@ -0,0 +1,11 @@
+{
+  "MD001": false,
+  "MD003": false,
+  "MD013": false,
+  "MD024": false,
+  "MD025": false,
+  "MD029": false,
+  "MD033": false,
+  "MD034": false,
+  "MD036": false
+}

.nvmrc

@@ -0,0 +1 @@
+lts/*

.prettierrc

@@ -0,0 +1,12 @@
+{
+  "overrides": [
+    {
+      "files": ["*.html"],
+      "options": {
+        "parser": "go-template",
+        "goTemplateBracketSpacing": true,
+        "bracketSameLine": true
+      }
+    }
+  ]
+}

.vscode/extensions.json

@@ -0,0 +1,7 @@
+{
+  "recommendations": [
+    "bradlc.vscode-tailwindcss",
+    "budparr.language-hugo-vscode",
+    "tamasfe.even-better-toml"
+  ]
+}

CODE_OF_CONDUCT.md

@@ -0,0 +1,15 @@
+([Français](#code-de-conduite))
+
+## Code of Conduct
+
+I follow the [CNCF Code of Conduct](https://github.com/cncf/foundation/blob/main/code-of-conduct.md).
+
+Please review before contributing issues, pull requests, or joining the GitHub organization.
+
+______________________
+
+## Code de conduite
+
+Je suit le [Code de conduite de la CNCF](https://github.com/cncf/foundation/blob/main/code-of-conduct-languages/fr.md).
+
+Veuillez passer en revue avant de contribuer à des problèmes, des demandes d'extraction ou de rejoindre l'organisation GitHub.

CONTRIBUTING.md

@@ -0,0 +1,27 @@
+# Contributing
+
+([Français](#comment-contribuer))
+
+## How to Contribute
+
+Feel free to propose changes by creating Pull Requests. If you don't have write access, editing a file will create a Fork of this project for you to save your proposed changes to. Submitting a change to a file will write it to a new Branch in your Fork, so you can send a Pull Request.
+
+If this is your first time contributing on GitHub, don't worry! Let us know if you have any questions.
+
+### Security
+
+**Do not post any security issues on the public repository!** See [SECURITY.md](SECURITY.md)
+
+______________________
+
+## Comment contribuer
+
+Lorsque vous contribuez, veuillez également publier des commentaires et discuter des modifications que vous souhaitez apporter par l'entremise des enjeux (Issues).
+
+N'hésitez pas à proposer des modifications en créant des demandes de tirage (Pull Requests). Si vous n'avez pas accès au mode de rédaction, la modification d'un fichier créera une copie (Fork) de ce projet afin que vous puissiez enregistrer les modifications que vous proposez. Le fait de proposer une modification à un fichier l'écrira dans une nouvelle branche dans votre copie (Fork), de sorte que vous puissiez envoyer une demande de tirage (Pull Request).
+
+Si c'est la première fois que vous contribuez à GitHub, ne vous en faites pas! Faites-nous part de vos questions.
+
+### Sécurité
+
+**Ne publiez aucun problème de sécurité sur le dépôt publique!** Voir [SECURITY.md](SECURITY.md)

Dockerfile

@@ -0,0 +1,4 @@
+FROM klakegg/hugo:ext-alpine
+
+RUN apk add git && \
+  git config --global --add safe.directory /src

LICENSE.md

@@ -0,0 +1,19 @@
+Copyright (c) 2023 William Hearn using Hugoplate template built by Zeon Studio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,16 +1,76 @@
-Dev Ops
-=======
+# Website
 
-[![Build Status][ci-badge]][ci]
-
-Personal website built using Hugo.
+Personal website built using [Hugo].
 
 ## Configuration
 
-Please consult the Minimo theme [README.md][readme] file for further instructions.
+Please consult the Minimo theme documentation for further instructions.
+
+## Installing Hugo
+
+This repository is presently using the Hugo extended 0.101.0 version.
+
+## Cloning
+
+The following will give you a project that is set up and ready to use.
+
+The `hugo server` command builds and serves the site.
+
+If you just want to build the site, run `hugo` instead.
+
+```sh
+git clone https://github.com/sylus/website
+cd website
+./dev.sh
+```
+
+The theme is included as part of a Hugo module:
+
+```sh
+▶ hugo mod graph
+project github.com/zeon-studio/[email protected]+vendor
+project github.com/gethugothemes/hugo-modules/[email protected]+vendor
+project github.com/gethugothemes/hugo-modules/[email protected]+vendor
+project github.com/gethugothemes/hugo-modules/[email protected]+vendor
+project github.com/gethugothemes/hugo-modules/[email protected]+vendor
+project github.com/gethugothemes/hugo-modules/icons/[email protected]+vendor
+project github.com/gethugothemes/hugo-modules/[email protected]+vendor
+project github.com/gethugothemes/hugo-modules/[email protected]+vendor
+project github.com/gethugothemes/hugo-modules/[email protected]+vendor
+project github.com/gethugothemes/hugo-modules/[email protected]+vendor
+project github.com/gethugothemes/hugo-modules/[email protected]+vendor
+project github.com/gethugothemes/hugo-modules/[email protected]+vendor
+project github.com/gethugothemes/hugo-modules/[email protected]+vendor
+project github.com/gethugothemes/hugo-modules/components/[email protected]+vendor
+project github.com/gethugothemes/hugo-modules/components/[email protected]+vendor
+project github.com/gethugothemes/hugo-modules/components/[email protected]+vendor
+project github.com/gethugothemes/hugo-modules/components/[email protected]+vendor
+project github.com/gethugothemes/hugo-modules/components/[email protected]+vendor
+project github.com/gethugothemes/hugo-modules/shortcodes/[email protected]+vendor
+project github.com/gethugothemes/hugo-modules/shortcodes/[email protected]+vendor
+project github.com/gethugothemes/hugo-modules/seo-tools/[email protected]+vendor
+project github.com/gethugothemes/hugo-modules/seo-tools/[email protected]+vendor
+project github.com/gethugothemes/hugo-modules/seo-tools/[email protected]+vendor
+```
+
+If you want to do SCSS edits and want to publish these, you need to install `PostCSS` (not needed for `hugo server`):
+
+```sh
+npm install
+```
+
+## Running the website locally
+
+Once you've cloned the site repo, from the repo root folder, run:
+
+```sh
+./dev.sh
+```
+
+## Linting
 
-<!-- Links Referenced -->
+To lint all Markdown files in a Node.js project (excluding dependencies), the following commands might be used:
 
-[readme]:       https://github.com/MunifTanjim/minimo/blob/master/README.md
-[ci]:           https://travis-ci.org/sylus/website
-[ci-badge]:     https://travis-ci.org/sylus/website.svg?branch=master
+```sh
+markdownlint 'content/**/*.md' --ignore node_modules --fix
+```