Switch to using two pages

.editorconfig

@@ -8,3 +8,6 @@ indent_style = space
 indent_size = 2
 insert_final_newline = true
 trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false

.eslintrc.js

@@ -3,7 +3,6 @@ npm install --save-dev \
 eslint \
 eslint-config-airbnb-base \
 eslint-config-airbnb-typescript \
-eslint-plugin-import \
 @typescript-eslint/eslint-plugin \
 @typescript-eslint/parser
 */
@@ -57,6 +56,9 @@ module.exports = {
         { blankLine: 'always', prev: 'break', next: '*' },
         { blankLine: 'always', prev: 'directive', next: '*' },
         { blankLine: 'any', prev: 'directive', next: 'directive' },
+        { blankLine: 'always', prev: '*', next: 'function' },
+        { blankLine: 'always', prev: 'function', next: '*' },
+        { blankLine: 'always', prev: 'multiline-expression', next: '*' },
       ],
       'padded-blocks': ['warn', { blocks: 'never', switches: 'never', classes: 'always' }],
       'object-curly-newline': ['warn', {
@@ -109,7 +111,8 @@ module.exports = {
       'quote-props': ['warn', 'consistent-as-needed'],
       'semi': 'off',
       '@typescript-eslint/semi': ['warn', 'never'],
-      '@typescript-eslint/strict-boolean-expressions': ['warn'],
+      '@typescript-eslint/strict-boolean-expressions': ['warn', { allowString: false }],
+      'yoda': 'off',
     },
     ...{
       // code smells
@@ -122,6 +125,7 @@ module.exports = {
       '@typescript-eslint/no-empty-function': ['error'],
       '@typescript-eslint/no-floating-promises': ['error', { ignoreVoid: true, ignoreIIFE: true }],
       '@typescript-eslint/no-non-null-assertion': 'off',
+      '@typescript-eslint/no-unnecessary-condition': ['error'],
       'no-unused-private-class-members': ['error'],
       'no-unused-vars': 'off',
       '@typescript-eslint/no-unused-vars': ['error', { vars: 'all', args: 'all', argsIgnorePattern: '^_' }],

.github/workflows/build-deploy.yml

@@ -5,31 +5,37 @@ on:
     types: published
 
 env:
-  resume-file: ccjmne-resume.pdf
-  artifact-id: ccjmne-resume
+  resume-file: resume.pdf
+  artifact-id: resume
 
 jobs:
   build:
     runs-on: ubuntu-latest
     env:
-      node-version: 16.x
+      node-version: 22
 
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
 
-    - uses: actions/setup-node@v3
+    - uses: actions/setup-node@v4
       with:
         node-version: ${{ env.node-version }}
-        cache: npm
-        cache-dependency-path: package-lock.json
+        cache: yarn
 
-    - name: Webpack build
+    - name: Verify manual hyphenation
       run: |
-        npm install
-        npx webpack --mode production
+        yarn install
+        npx webpack --mode production --env HYPHENATE=yes --env OUTPUT=l.png && mv dist/l.png .
+        npx webpack --mode production --env HYPHENATE=no  --env OUTPUT=r.png && mv dist/r.png .
+        diff --brief l.png r.png
+
+    - name: Compile PDF
+      run: |
+        yarn install
+        npx webpack --mode production --env HYPHENATE=no --env OUTPUT=${{ env.resume-file }}
 
     - name: Upload resume artifact
-      uses: actions/upload-artifact@v3
+      uses: actions/upload-artifact@v4
       with:
         name: ${{ env.artifact-id }}
         path: dist/${{ env.resume-file }}
@@ -40,7 +46,7 @@ jobs:
 
     steps:
     - name: Download resume artifact
-      uses: actions/download-artifact@v3
+      uses: actions/download-artifact@v4
       with:
         name: ${{ env.artifact-id }}
 
@@ -53,7 +59,8 @@ jobs:
     - name: Compute short SHA
       run: echo SHORT_SHA=`echo ${GITHUB_SHA::7}` >> $GITHUB_ENV
 
-    - name: Deploy
+    - name: Deploy to GitHub Pages
+      # TODO: Consider using the official `deploy-pages` and `upload-pages-artifact` GitHub Actions
       uses: peaceiris/actions-gh-pages@v3
       with:
         publish_dir: .

.gitignore

@@ -1,104 +1,2 @@
-# Logs
-logs
-*.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-lerna-debug.log*
-
-# Diagnostic reports (https://nodejs.org/api/report.html)
-report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
-
-# Runtime data
-pids
-*.pid
-*.seed
-*.pid.lock
-
-# Directory for instrumented libs generated by jscoverage/JSCover
-lib-cov
-
-# Coverage directory used by tools like istanbul
-coverage
-*.lcov
-
-# nyc test coverage
-.nyc_output
-
-# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
-.grunt
-
-# Bower dependency directory (https://bower.io/)
-bower_components
-
-# node-waf configuration
-.lock-wscript
-
-# Compiled binary addons (https://nodejs.org/api/addons.html)
-build/Release
-
-# Dependency directories
-node_modules/
-jspm_packages/
-
-# TypeScript v1 declaration files
-typings/
-
-# TypeScript cache
-*.tsbuildinfo
-
-# Optional npm cache directory
-.npm
-
-# Optional eslint cache
-.eslintcache
-
-# Microbundle cache
-.rpt2_cache/
-.rts2_cache_cjs/
-.rts2_cache_es/
-.rts2_cache_umd/
-
-# Optional REPL history
-.node_repl_history
-
-# Output of 'npm pack'
-*.tgz
-
-# Yarn Integrity file
-.yarn-integrity
-
-# dotenv environment variables file
-.env
-.env.test
-
-# parcel-bundler cache (https://parceljs.org/)
-.cache
-
-# Next.js build output
-.next
-
-# Nuxt.js build / generate output
-.nuxt
 dist
-
-# Gatsby files
-.cache/
-# Comment in the public line in if your project uses Gatsby and *not* Next.js
-# https://nextjs.org/blog/next-9-1#public-directory-support
-# public
-
-# vuepress build output
-.vuepress/dist
-
-# Serverless directories
-.serverless/
-
-# FuseBox cache
-.fusebox/
-
-# DynamoDB Local files
-.dynamodb/
-
-# TernJS port file
-.tern-port
+node_modules

README.md

@@ -2,13 +2,12 @@
 
 [![Compile and Publish Resume](https://github.com/ccjmne/ccjmne-resume/actions/workflows/build-deploy.yml/badge.svg)](https://github.com/ccjmne/ccjmne-resume/actions/workflows/build-deploy.yml)
 
-This project lets me build my current static one-page resume.
-
+This project lets me build my current static resume.  
 Take a look at it [here](https://ccjmne.github.io/ccjmne-resume).
 
 ## Inside the Box
 
-This generates a simple HTML page, printed out to PDF with [Puppeteer](https://github.com/GoogleChrome/puppeteer).
+This generates some HTML pages, printed out to PDF with [Puppeteer](https://github.com/GoogleChrome/puppeteer).
 
 Technologies used:
 
@@ -21,39 +20,70 @@ Technologies used:
 
 ## How-To
 
-Development merely uses the standard [NodeJS](https://nodejs.org/en/) process (using `npm`);<br />
+Development merely uses the standard [NodeJS](https://nodejs.org/en/) process (using `yarn`);  
 Publication is automated through [Continuous Deployment](https://www.atlassian.com/continuous-delivery/continuous-deployment), leverating [GitHub Actions](https://docs.github.com/en/actions).
 
 ### Set up
 
-Install with `npm install`.
+Install with `yarn install`.
 
 ### Build
 
-Continuously watch-rebuild with `npm start` (or `webpack serve --mode development`) during development;<br />
-Perform a one-off compilation with `npm run build` (or `webpack --mode production`).
+Continuously watch-rebuild with `yarn start` (or `npx webpack serve --mode
+development`) during development;  
+Perform a one-off compilation with `yarn build` (or `npx webpack --mode
+production`).
+
+The output (and the pre-compiled HTML-CSS-JS assets in `development` mode) will
+be generated under `dist/`.
+
+#### Build Options
 
-The PDF output (and the pre-compiled HTML-CSS-JS assets in dev. mode) will be generated under `dist/`.
+1. `HYPHENATE`
+   - whether to automatically insert
+     [soft-hyphens](https://en.wikipedia.org/wiki/Soft_hyphen) wherever
+     applicable
+   - enabled with any value starting with `y`; defaults to `no`
+   - disabled by default with `production` builds, for having `&shy;` littered
+     throughout each and every word isn't quite SEO-friendly, and might even
+     throw off [ATS](https://en.wikipedia.org/wiki/Applicant_tracking_system)es
+
+2. `OUTPUT`
+   - the name of the output file, defaults to `ccjmne-resume.pdf`
+   - generate screenshot if output ends in `.png`; otherwise coerce extension to
+     `.pdf`
 
 ### Deploy
 
 There is nothing to do, this process is automated.
 
 With each newly published release on GitHub,
-1. a [GitHub Action](https://docs.github.com/en/actions) will use [Webpack](https://webpack.js.org/) to:
+
+1. a [GitHub Action](https://docs.github.com/en/actions) will use
+   [Webpack](https://webpack.js.org/) to:
    - compile and generate the static HTML webpage,
-   - print it out to PDF through my own [PDF-Printer Webpack Plugin](./tooling/pdf-printer-plugin.ts) (using [Puppeteer](https://github.com/GoogleChrome/puppeteer)),
-   - create and upload the generated resume as as [GitHub Artifact](https://docs.github.com/en/actions/using-workflows/storing-workflow-data-as-artifacts)
+   - print it out to PDF through my own [PDF-Printer Webpack
+     Plugin](./tooling/pdf-printer-plugin.ts),
+   - ensure accurate manual hyphenation by comparing w/ automatically hyphenated version,
+   - create and upload the generated resume as as [GitHub
+     Artifact](https://docs.github.com/en/actions/using-workflows/storing-workflow-data-as-artifacts)
 2. a subsequent job will:
    - retrieve the compiled artifact,
-   - generate a stripped-down `index.html` that merely sets up an [HTML Meta Refresh](https://en.wikipedia.org/wiki/Meta_refresh) to the PDF resume,
-   - push a new commit to the `gh-pages` branch, referencing the original commit to `master` that triggered the rebuild-redeploy
-3. this commit to `gh-pages` triggers another GitHub Action that publishes my resume [here](https://ccjmne.github.io/ccjmne-resume), with [GitHub Pages](https://pages.github.com/)
+   - generate a stripped-down `index.html` that merely sets up an [HTML Meta
+     Refresh](https://en.wikipedia.org/wiki/Meta_refresh) to the PDF resume,
+   - push a new commit to the `gh-pages` branch, referencing the original commit
+     to `master` that triggered the rebuild-redeploy
+3. this commit to `gh-pages` triggers another GitHub Action that publishes
+   my resume [here](https://ccjmne.github.io/ccjmne-resume), with [GitHub
+   Pages](https://pages.github.com/)
 
 ## Licensing
 
 **GPL-3.0**
 
-You may copy, distribute and modify the software as long as you track changes/dates in source files. Any modifications to or software including (via compiler) GPL-licensed code must also be made available under the GPL along with build & install instructions.
+You may copy, distribute and modify the software as long as you track
+changes/dates in source files. Any modifications to or software including (via
+compiler) GPL-licensed code must also be made available under the GPL along with
+build & install instructions.
 
 Refer to the [LICENSE](./LICENSE) file for more details.