22940dev / port-robertlloyd

paulrobertlloyd.com

My personal website. There are many like it, but this is mine.

Installation

1. git clone [e-mail]:paulrobertlloyd/paulrobertlloyd-v4.git
2. cd paulrobertlloyd-v4
3. npm install
4. npm run build

Generated files are written to the www directory.

Then, ensure the WEBMENTION_IO_TOKEN environment variable is set, which should be populated with your API key from webmention.io.

Development

When developing the site, you may want files automatically compiled and the browser to refresh automatically. To do this, run npm run watch.

Running locally with HTTPS

To run with HTTPS locally on macOS first follow the setup steps described here. To create the required SSL certificates, follow these steps:

1. Change into the correct directory: cd etc

2. Create the certificate files:

   openssl req \
   -new \
   -newkey rsa:2048 \
   -sha256 \
   -days 3650 \
   -nodes \
   -x509 \
   -keyout etc/test.key \
   -out etc/test.crt \
   -subj /CN=v4.paulrobertlloyd.test \
   -reqexts SAN \
   -extensions SAN \
   -config <(cat /System/Library/OpenSSL/openssl.cnf \
   <(printf '[SAN]\nsubjectAltName=DNS:v4.paulrobertlloyd.test'))
   

Deployment

This site is deployed automatically by Netlify whenever files are pushed to the master branch.

Repo structure

paulrobertlloyd.com
├── etc
│   ├── browser-sync.config.js   # BrowserSync configuration
│   ├── postcss.config.js        # PostCSS configuration
│   ├── rollup.config.js         # Rollup configuration
│   └── test.conf                # Local nginx server configuration
│
├── lib
│   ├── collections              # Eleventy collections
│   ├── filters                  # Eleventy template filters
│   ├── libraries                # Eleventy template libraries
│   ├── shortcodes               # Eleventy template shortcodes
│   └── utils                    # Utility scripts
│
├── src
│   ├── assets                   # Assets (CSS, JavaScript, WOFF2, SVG)
│   ├── content                  # Content (Markdown)
│   ├── data                     # Global website data (JSON)
│   ├── images                   # Content images
│   ├── includes                 # Components (Liquid)
│   ├── layouts                  # Layout templates (Liquid)
│   ├── app.webmanifest.liquid   # Web App Manifest template
│   ├── feed.jf2.liquid          # JF2 Feed template
│   ├── feed.json.liquid         # RSS (JSON Feed) template
│   ├── feed.xml.liquid          # RSS (Atom) template
│   ├── key.txt                  # Public PGP key
│   ├── robots.txt.liquid        # robots.txt template
│   ├── serviceworker.js.liquid  # Service worker template
│   └── sitemap.xml.liquid       # Sitemap template
│
├── .editorconfig                # Text editor configuration
├── .eleventy.js                 # Eleventy configuration
├── .gitattributes               # Files tracked by Git LFS
├── .gitignore                   # Files not tracked by Git
├── .markdownlintrc              # markdownlint configuration
├── .nvmrc                       # NVM configuration
├── .stylelintrc                 # Stylelint configuration
├── netlify.toml                 # Netlify configuration
├── package.json                 # Node.js package manifest
├── package-lock.json            # Node.js package lock
└── README.md                    # This file

© Paul Robert Lloyd