Static Websites

Generators

Signal (Image Gallery)

Sigal is a simple static gallery generator.

Getting started

Create the config file:

sigal init

Edit the config file...

Then run the build command

sigal build

thumbsup (Video and Image Gallery)

Thumbsup is a Video and Image Gallery but i prefer Signal for images. Thumbsup works great with videos. Read the documentation for details. To get started:

Requirements

Option 1: Install on machine

# Install Nodejs and NPM
# Install GraphicsMagick
npm install -g thumbsup

Option 2: Run Docker

docker run -t -v /Volumes/photos:/input:ro -v "$(pwd)/website:/output" -u $(id -u):$(id -g) ghcr.io/thumbsup/thumbsup thumbsup --input /input --output /output

New Gallery

Create a new Gallery in subfolder gallery from subfolder source:

thumbsup --input ./source --output ./gallery

MkDocs

MkDocs is a great way to host a simple, static website. This website uses Material for MkDocs. Material for MkDocs is a theme for MkDocs, a static site generator geared towards (technical) project documentation.

Use docker or python to quickly create and host a static website:

Host MkDocs locally with docker

git clone https://github.com/FullByte/FullByte.github.io.git # clone repo
cd FullByte.github.io # Go to main folder
docker run --rm -it -p 8000:8000 -v ${PWD}:/docs squidfunk/MkDocs-material # run the container

Serve MkDocs locally with python

Run this once to install all requirements:

choco install -y python
python -m pip install --upgrade pip
pip install MkDocs
pip install MkDocs-material

Run this in the folder of the MkDocs.yml file to host the MkDocs page:

MkDocs serve

Create page

Overriding template blocks: https://www.mkdocs.org/user-guide/customizing-your-theme/#using-the-theme-custom_dir

Extensions

MkDocs is a great way to host a simple, static website. This website uses Material for MkDocs. Material for MkDocs is a theme for MkDocs, a static site generator geared towards (technical) project documentation.

Further plugins:

• MkDocs-minify-plugin: pip install MkDocs-minify-plugin
• MkDocs-redirects: pip install MkDocs-redirects

Examples

Checkable List

markdown_extensions:
  - pymdownx.tasklist:
      custom_checkbox: true
  - pymdownx.tasklist:
      clickable_checkbox: true

Lazy load a picutre:

PHP based static page

Use PHP to create a static HTML website with this code.

Clone the repo and add content to content/, then run php portable.php > index.html

Deploy

Surge

Surge.sh is a simple, single-command web publishing service to publish HTML, CSS, and JS for free, without leaving the command line.

These are the steps I took to host my site mkdocs based site on surge.sh.

Install: npm install --global surge (requires Node.js) Deploy: surge E:\Website\0xfab1.net\site surge.0xfab1.net

Heroku

Heroku is not recommended for simple, static websites with HTML, CSS and JS. Heroku is there to host apps, not static websites.

These are the steps I took to host my site mkdocs based site on Heroku anyway:

Create the follwing files in your main mkdocs directory, then run the deploy process:

echo '{}' > composer.json
echo '{ "formation": { "web": { "size": "free" } } }' > app.json
echo '<?php include_once("index.html"); ?>' > index.php

Adding this breaks the build for other hosts as some assume this is a PHP site and interprete the build wrong. For this reason I create the files above in a seperate branch named "heroku" with this command mkdocs gh-deploy -b heroku. Below is the github action to deploy 0xfab1.net on github and also prepare a branch build for heroku:

jobs:
  build:
    name: Build and Deploy Website
    runs-on: ubuntu-latest
    steps:
      - name: Checkout Master
        uses: actions/checkout@v2

      - name: Set up Python 3.10
        uses: actions/setup-python@v2
        with:
          python-version: '3.10'

      - name: Install mkdocs dependencies
        run: |
          python -m pip install --upgrade pip          
          pip install mkdocs-material
          pip install mkdocs-minify-plugin
          pip install mkdocs-rss-plugin
          pip install mkdocs-video

      - name: Deploy Github Pages
        run: |
          git pull
          mkdocs gh-deploy
          mkdocs gh-deploy -b heroku

Now run the deploy on the correct branch and it should work :)

Layer0

These are the steps I took to host my site mkdocs based site on layer0. Here is the offical guide.

Add package.json and routes.js to you main mkdocs folder:

``` json title="package.json" { "name": "mkdocs", "version": "1.0.0", "scripts": { "build": "python3 -m mkdocs build", "server": "python3 -m mkdocs serve", "layer0:dev": "layer0 dev", "postinstall": "pip3 install mkdocs mkdocs-material mkdocs-minify-plugin mkdocs-rss-plugin mkdocs-video", "layer0:build": "npm run build && layer0 build", "layer0:deploy": "npm run build && layer0 deploy" }, "dependencies": {}, "devDependencies": { "@layer0/cli": "^4.8.5", "@layer0/core": "^4.8.5", "@layer0/devtools": "^4.8.5", "@layer0/prefetch": "^4.8.5" } }

``` js title="routes.js"
import { Router } from '@layer0/core'

const ONE_MINUTE = 60
const FAR_FUTURE = 60 * 60 * 24 * 365 * 10

const router = new Router()

router.match('/:path*', ({ serveStatic, cache }) => {
  cache({
    browser: false,
    edge: {
      maxAgeSeconds: FAR_FUTURE,
    },
  })
  serveStatic('site/:path*')
})

export default router

Init (run once) using Node.js npx and nvm:

nvm use 14
npx @layer0/cli@latest init --name layer0.0xfab1.net --environment production --origin layer0.0xfab1.net --deploy

Deploy page (run for every update) using Node.js npx and nvm:

nvm use 14
npm run build
npx @layer0/cli@latest deploy --site=layer0.0xfab1.net --environment=production

Azure Static Website

To build the static site for Azure, I build it on the worker, then use Azure/static-web-apps-deploy@v1 task to deploy the result.

name: Build and Deploy Website

on:
  push:
    branches: [master]
  pull_request:
    branches: [master]
  workflow_dispatch:

jobs:
  build:
    name: Build and Deploy Website
    runs-on: ubuntu-latest
    steps:
      - name: Checkout Master
        uses: actions/checkout@v2

      - name: Set up Python 3.10
        uses: actions/setup-python@v2
        with:
          python-version: '3.10'

      - name: Install mkdocs dependencies
        run: |
          pip install --upgrade pip          
          pip install mkdocs-material
          pip install mkdocs-minify-plugin
          pip install mkdocs-rss-plugin
          pip install mkdocs-video

      - name: Build 0xfab1.net for Azure
        run: |          
          mkdocs build

      - name: Deploy to Azure
        id: builddeploy
        uses: Azure/static-web-apps-deploy@v1
        with:
          azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_API_TOKEN_BLACK_FLOWER_0ADBF0903 }}
          repo_token: ${{ secrets.GITHUB_TOKEN }} 
          action: "upload"
          app_location: "site/"

  close_pull_request_job:
    if: github.event_name == 'pull_request' && github.event.action == 'closed'
    runs-on: ubuntu-latest
    name: Close Pull Request Job
    steps:
      - name: Close Pull Request
        id: closepullrequest
        uses: Azure/static-web-apps-deploy@v1
        with:
          azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_API_TOKEN_BLACK_FLOWER_0ADBF0903 }}
          action: "close"