chore: update packages

Updates everything reported as out-of-date with `yarn outdated`.

Done with:

    yarn add --dev prettier@latest --exact
    yarn add --dev ajv@latest --exact

refactor: get rid of explicit resolutions

Blow away lockfile, regenerate, confirm that `yarn audit` is still
clean.

chore: bump minimist from 1.2.5 to 1.2.6

For:

    https://www.npmjs.com/advisories/1179

I don't think this one matters for my scenario, but I like to keep `yarn
audit` clean if I can.

chore: update prettier 2.5.0 → 2.5.1

docs: update "Programming Languages" and "Tools"

As these were both somewhat stale.

refactor: apply one more tweak to silence ajv

Drop the problematic "date" format which only leads ajv to complain
about the input document not conforming, if we follow it's advice to set
the type to "number,string".

Now we have only one remaining warning:

    strict mode: missing type "number,string" for keyword "format" at "#/properties/version" (strictTypes)

chore: fix most of the new strict mode warnings produced by ajv

Before:

    strict mode: missing type "object" for keyword "properties" at "#" (strictTypes)
    strict mode: missing type "number,string" for keyword "format" at "#/properties/version" (strictTypes)
    strict mode: missing type "number,string" for keyword "format" at "#/properties/identity/properties/email" (strictTypes)
    strict mode: missing type "number,string" for keyword "format" at "#/properties/presence/properties/facebook" (strictTypes)
    strict mode: missing type "number,string" for keyword "format" at "#/properties/presence/properties/github" (strictTypes)
    strict mode: missing type "number,string" for keyword "format" at "#/properties/presence/properties/keybase" (strictTypes)
    strict mode: missing type "number,string" for keyword "format" at "#/properties/presence/properties/linkedin" (strictTypes)
    strict mode: missing type "number,string" for keyword "format" at "#/properties/presence/properties/stackoverflow" (strictTypes)
    strict mode: missing type "number,string" for keyword "format" at "#/properties/presence/properties/twitter" (strictTypes)
    strict mode: missing type "number,string" for keyword "format" at "#/properties/presence/properties/website" (strictTypes)
    strict mode: missing type "number,string" for keyword "format" at "#dateish/anyOf/0" (strictTypes)
    strict mode: missing type "string" for keyword "pattern" at "#dateish/anyOf/1" (strictTypes)
    strict mode: missing type "number,string" for keyword "format" at "#dateish/anyOf/0" (strictTypes)
    strict mode: missing type "string" for keyword "pattern" at "#dateish/anyOf/1" (strictTypes)
    strict mode: missing type "number,string" for keyword "format" at "#dateish/anyOf/0" (strictTypes)
    strict mode: missing type "string" for keyword "pattern" at "#dateish/anyOf/1" (strictTypes)
    strict mode: missing type "number,string" for keyword "format" at "#/properties/publications/properties/items/items/properties/link" (strictTypes)
    strict mode: missing type "number,string" for keyword "format" at "#dateish/anyOf/0" (strictTypes)
    strict mode: missing type "string" for keyword "pattern" at "#dateish/anyOf/1" (strictTypes)
    strict mode: missing type "object" for keyword "required" at "#" (strictTypes)
    strict mode: missing type "object" for keyword "additionalProperties" at "#" (strictTypes)
    strict mode: missing type "object" for keyword "properties" at "#" (strictTypes)

After:

    strict mode: missing type "number,string" for keyword "format" at "#/properties/version" (strictTypes)
    strict mode: missing type "number,string" for keyword "format" at "#dateish/anyOf/0" (strictTypes)
    strict mode: missing type "number,string" for keyword "format" at "#dateish/anyOf/0" (strictTypes)
    strict mode: missing type "number,string" for keyword "format" at "#dateish/anyOf/0" (strictTypes)
    strict mode: missing type "number,string" for keyword "format" at "#dateish/anyOf/0" (strictTypes)

I'm not going to fix the last ones because doing so would definitely
make my life worse. In my YAML I have date-ish items like:

    version: 2021-05-07
    from: 2021-06
    to: 2011

ajv says these aren't strings but numbers (and fair enough for the last
one, but the first two look like they could be strings). So, I can say
that version must always be `"type": "string"` and that works fine if I
enclose it in quotes in the YAML file (although it seems needlessly
ugly), but otherwise causes a runtime error with:

    Input YAML does not conform to the schema

Further trouble starts if I say the date-ish things should be numbers or
strings; then I get a litany of warnings that I can't be bothered sorting
through right now:

    strict mode: use allowUnionTypes to allow union type keyword at "#dateish/anyOf/0" (strictTypes)
    ... repeated once for each place that I use date-ish ...

And I certainly don't want to go sprinkling quotes all through the YAML
to force them all to be strings (for reference, Ruby's YAML parses
things like `2021-05-07` as a string automatically, and my JS is already
calling `toString()` on these things).

So, I'm just going to tolerate the noise. I will turn off strict mode if
the complaining annoys me. I usually don't mind strictness (I am using
JSON Schema, after all), but here it just seems uselessly bothersome. Oh
well.

fix: make JSON schema validation work again

OK, so I lied a couple of commits ago (97ecf43) when I said I didn't
think I would be affected by breaking changes in the ajv package.

According to the docs here:

    https://ajv.js.org/guide/formats.html

you now need to install a separate package.

> From version 7 Ajv does not include formats defined by JSON Schema
> specification - these and several other formats are provided by
> ajv-formats plugin.

Another glorious triumph of modularization! My life is better for this
change.

With this change, all my `"format": "date"` and `"format": "email"`
(etc) schema elements work again, and we don't see this error during
build:

    Error: unknown format "date" ignored in schema at path "#/properties/version"

Still spewing out a bunch of warnings because "strict mode" is on by
default now, but the build still works, and I can deal with the errors
in a separate commit.

chore: update pdfkit 0.11.0 → 0.13.0

As far as I can tell, no breaking changes:

    https://github.com/foliojs/pdfkit/blob/master/CHANGELOG.md

chore: update ajv 6.12.2 → 8.8.2

As far as I can tell from the releases listing:

    https://github.com/ajv-validator/ajv/releases

No breaking changes that would affect me, paying specific attention to
the v7.0.0 and v8.0.0 releases:

- https://github.com/ajv-validator/ajv/releases/tag/v8.0.0
- https://github.com/ajv-validator/ajv/releases/tag/v7.0.0

chore: update js-yaml 3.13.1 → 4.1.0

Following the migration guide:

    https://github.com/nodeca/js-yaml/blob/master/migrate_v3_to_v4.md

chore: update Prettier 2.0.5 → 2.5.0

Note that we now have access to a version of Prettier that allows us to
turn off the unwanted formatting:

    https://github.com/prettier/prettier/pull/7875

This is necessary to stop Prettier from mangling template literals, as
described in a24373d5f05419c3.

chore: pin path-parse to 1.0.7

To deal with this output from `yarn audit`:

```
┌───────────────┬──────────────────────────────────────────────────────────────┐
│ moderate      │ Regular Expression Denial of Service in path-parse           │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Package       │ path-parse                                                   │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Patched in    │ >=1.0.7                                                      │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Dependency of │ pdfkit                                                       │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Path          │ pdfkit > fontkit > brfs > resolve > path-parse               │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ More info     │ https://www.npmjs.com/advisories/1005072                     │
└───────────────┴──────────────────────────────────────────────────────────────┘
1 vulnerabilities found - Packages audited: 107
Severity: 1 Moderate
✨
```

docs: update URLs

These won't work for a while yet (pending DNS changes).

feat: teach scripts/publish about GitHub pages custom domains

docs: use less generic job title

Matching what I have on LinkedIn.

docs: leaving Liferay, joining GitHub

docs(README): use yarn, not npm

docs: add VimConf 2020 to list of publications

chore: update residency details

chore: make address more precise

D -> DR

D could be part of a sequence (A, B, C, D etc) but DR is obviously
"derecha".

style: format

Note: I am not accepting all the changes the new version of Prettier
because it wants to mess with my template literals:

    https://github.com/prettier/prettier/issues/5588

and a version with `--embedded-language-formatting` doesn't seem to have
been released yet:

    https://github.com/prettier/prettier/pull/7875

Example of an unwanted change:

```
@@ -187,9 +193,9 @@
         .trim()
         .replace(/^\s+/gm, '') + '\n</header>\n';
   }

   heading(text, _options) {
-    this._content += html`<h1>${text.toUpperCase()}</h1>\n`;
+    this._content += html`<h1>${text.toUpperCase()}</h1> `;
   }

   subHeading(text) {
```

chore: bump version

refactor: attempt fix for unstable PDF identity

Seems to be stable (two consecutive runs):

  sha1sum public/*.pdf
  ede8b91928c86d63865db35731df1878da5499ae  public/cv-full.en.pdf
  6b4f4d3a236cfe6d01f15a25b28ed03867b3061d  public/cv-full.es.pdf
  f4c95b8d6cd231fd2e7a097f1330fd0b66bc4aa8  public/cv.en.pdf
  6008f58ddcf608a34689d5d9f4e9c1ce5e64a1b8  public/cv.es.pdf

  sha1sum public/*.pdf
  ede8b91928c86d63865db35731df1878da5499ae  public/cv-full.en.pdf
  6b4f4d3a236cfe6d01f15a25b28ed03867b3061d  public/cv-full.es.pdf
  f4c95b8d6cd231fd2e7a097f1330fd0b66bc4aa8  public/cv.en.pdf
  6008f58ddcf608a34689d5d9f4e9c1ce5e64a1b8  public/cv.es.pdf

refactor: remove unnecessary hack

As it is apparently not needed any more:

https://github.com/foliojs/pdfkit/issues/868

Still need to test this though, because note that I am setting the
`ModDate` after construction, but I may need to do it in the
constructor.

chore: pin minimist to 1.2.5

To deal with this output from `yarn audit`:

```
yarn audit v1.22.4
┌───────────────┬──────────────────────────────────────────────────────────────┐
│ low           │ Prototype Pollution                                          │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Package       │ minimist                                                     │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Patched in    │ >=0.2.1 <1.0.0 || >=1.2.3                                    │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Dependency of │ pdfkit                                                       │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Path          │ pdfkit > fontkit > brfs > quote-stream > minimist            │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ More info     │ https://www.npmjs.com/advisories/1179                        │
└───────────────┴──────────────────────────────────────────────────────────────┘
┌───────────────┬──────────────────────────────────────────────────────────────┐
│ low           │ Prototype Pollution                                          │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Package       │ minimist                                                     │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Patched in    │ >=0.2.1 <1.0.0 || >=1.2.3                                    │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Dependency of │ pdfkit                                                       │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ Path          │ pdfkit > linebreak > brfs > quote-stream > minimist          │
├───────────────┼──────────────────────────────────────────────────────────────┤
│ More info     │ https://www.npmjs.com/advisories/1179                        │
└───────────────┴──────────────────────────────────────────────────────────────┘
2 vulnerabilities found - Packages audited: 107
Severity: 2 Low
✨  Done in 0.50s.
```

chore: deduplicate yarn.lock

With `npx yarn-deduplicate yarn.lock`.

chore: update dependencies

Add link to "Scalable Frontend Development" talk

Use <link> tags instead of CSS imports

Because for some reason Chrome is 404-ing on one of the imports (weird,
Firefox does not, and Chrome makes a second request that is HTTP OK).

Make fonts a wee bit smaller to fit on one page

Format more things with Prettier

Localize "skills" items

Pleasantly surprised by how easy this it: "anyOf" in the JSON schema
allows us to have uniform or localized items, and our `localize()`
helper transforms the data structure for us so that we only have to
worry about strings.

Add new position at Liferay

Add legal status to profile section

Add AWS to list of tools

Consistently denote ignored arguments with _foo form

Remove unnecessary escape character

Remove unused seed() function

Correct a code comment

Move progress printing down into main build loop

This keeps the printing calls closer to each other, and makes the
`build()` function have a single purpose (writing built output) instead
of two (writing built output and printing progress).

Shorten main build list

Was very procedural. As a bonus, we're not redundantly copying the
English version over to the index twice.

Remove an unnecessary toString() call

Unnecessary since e729896.

Restore "Skills" section

Temporarily gone since 9af5b29.

Replace an inline comment with a docblock

Make object returned by `raw()` more String-like

The object returned by the old version was somewhat String-like:

```
const s1 = raw('foo');
const s2 = `string: ${s1}`; // "string: foo"
```

But not very:

```
typeof s1; // object
s1 instanceof String; // false
```

This new version is a bit more String-like:

```
typeof s1; // object
s1 instanceof String; // true
```

Add `html()` tagged template literal function

Does the same kind of escaping as our `markdown()` function does, except
it additionally provides an escape hatch via `raw()`.

Get rid of a ternary for readability

Fix comment syntax

Use double-leading asterisks for "docblock"-style comments.

Use tagged template literal function for escaping Markdown interpolation

Gets rid of repeated calls to `_escape` when generating Markdown.

Use "items" more uniformly in YAML source

DRY up handling of presence URLs and links a little bit

Add internet profile and site links

Rough cut because I have to run off before DRY-ing and tidying this up.
Will come back to it later and polish it up.

Closes: https://github.com/wincent/cv/issues/5

Fix mangled display in "Awards" section

The extra positional argument to the `forEach` function evidently was
changing the behavior of the underlying  `text` function when it got
passed through as options.

Add "Publications" section to extended output

Closes: https://github.com/wincent/cv/issues/4

README: Add links to expanded format

Closes: https://github.com/wincent/cv/issues/16

Allow empty sections

Prefer page breaks before headings

Not sure if this is going to do the right thing in all edge cases, but a
quick test shows it works with the current input YAML.

Remove manual "collapse" hack

In writing the code to rollback unwanted pagebreaks (which involves
keeping a journal of all "commands" issued to build up the document), I
noticed I could get rid of the ugly manual "collapse" hack.

Whenever we emit a subheading, we can now automatically slurp up
preceding whitespace if the previous item was a heading.

The `args` property in the command journal isn't used in this
commit, but it will be in the future, when we use it to replay commands
after "rewinding" the output and inserting a page break in a better
place.

Mark "private" members in PDF class as private

Add "full" output variants

This one includes, for now, a new "Awards" section. I'm not going to
link to this from anywhere because I don't think the section is very
useful, and it also pushes the PDF version onto two pages (in the
"private" variants, which have a taller header, and also in the Spanhish
"public" variant), which I'll need to address.

Print progress

Will be useful because we're going to grow the number of output
formats shortly.

Rejig award word ordering

Add some awards I had forgotten about

Note: awards don't show up in the output yet, or perhaps ever.

Add missing </head> tag to HTML output

Add favicon

Closes: https://github.com/wincent/cv/issues/15

Remove stray word from Spanish translation

publish: use short commit hashes in output

Just makes it a little easier on the eye.

publish: warn if publishing an empty commit

As noted in the parent commit, there *may* be reasons why you would want
to do this, but it is more likely a mistake, so print a big red warning
out along with instructions on how to undo the commit if desired.

publish: properly show empty commits

When you create an empty commit on the gh-pages branch (for example, by
running `npm run publish` twice in a row, or by forgetting to run `npm
run build`), `git whatchanged` misbehaves (maybe, depending on your
point of view) compared to `git log`: the former skips the empty commit
and shows the parent commit instead, but `git log` will dutifully show
the empty commit.

Swap out `git whatchanged` for `git log --raw`, which has basically the
same output but doesn't skip empty commits. It's important that we show
empty commits because to give the user a chance to see and correct their
mistake (if it is a mistake; I can imagine you might want to push an
empty gh-pages commit to force a rebuild on the GitHub side). Ideally,
we would explode loudly for empty commits (the user could always just do
`git commit --allow-empty` if they really wanted), but I don't think
there is a built-in way to do that with `git-commit-tree`; to add such a
check I think I'd need to construct an explicit `git diff --quiet` test,
but I am not sure I can be bothered with that for now.

(Discovered this issue while testing changes to the `publish` script.)

gh-pages: note source commit hash probably* used to build

Only "probably" used, because there are no guarantees that the person
who invokes `npm run publish` didn't change the work-tree and checked
out revision after running `npm run build`. Still, the odds are pretty
good.

Will output a message like:

    From cb70cc5-dirty.

if you have been naughty and are publishing without committing first.
Otherwise it will just output a hash (because there are no tags in this
repo for `git describe` to find).

Finish Spanish translation

Make sure languages from cv.yml have precedence over pii.yml, if any

Want the former to be the definitive source.

Validate pii.yml against schema as well

Note one bit of trickiness here: the file doesn't define "languages"
like the cv.yml file does; we copy that over at runtime, and we rely on
it in the schema to ensure that we are validating against the same set
of languages in both files.

Prepare to validate "PII" too

Extract validation into a separate function (with some sneaky
shadowing... sorry!) and move the existing schema down under a "cv"
property.

Validate input file using JSON Schema

Fulfilling the promise of pointless overengineering...

Closes: https://github.com/wincent/cv/issues/8
See:

  https://github.com/epoberezkin/ajv/blob/master/KEYWORDS.md

For details on the keywords used in the schema definition.

Prettier

Some initial responsive design tweaks

Make sure PDFs don't change unless input changes

Works around: https://github.com/foliojs/pdfkit/issues/868

As described in that issue, if you generate the same PDF twice in a row
you'll get two different docs, and in my use case here (writing PDFs to
the "gh-pages" branch) that can produce noisy diffs.

The cause of the randomness can be found here:

https://github.com/foliojs/pdfkit/blob/2567227a92a10c0d88407dde232c4a3c3bc23d1a/lib/font/embedded.coffee#L103-L104

Work around it by (gasp) replacing `Math.random` with something
deterministic.

Now, we'll only get a different output when I change something that
affects the output. This means that to bump the "release version" of the
PDF (ie. the `ModDate`), I have to update the `version` property in the
YAML. I'm ok with that.

Lock CreationDate, let ModDate float

Let the CreationDate always be the date I produced the first version,
and the ModDate be the date I made each build.

doc: document `npm run publish` script

Remove debugging comment

Add a default index page to gh-pages branch

Closes: https://github.com/wincent/cv/issues/10

Work around UTF-8 encoding issues in Markdown on gh-pages

Closes: https://github.com/wincent/cv/issues/11

doc: Add links to built output

Closes: https://github.com/wincent/cv/issues/7

Add npm script for running publish command

Add script for publishing to gh-pages branch

Style HTML output to resemble PDF output

Make header() method non-destructive in all renderers

Calling it more than once, or calling it in the HTML renderer after
emitting something else, would still be a bad idea, but the mistake
would be easily noticed in the output.

This brings the remaining renderers into line with the behavior of the
PDF renderer.

Make date() a top-level function to avoid redefining it multiple times

Drop capitalize() function

Don't need it any more, as we are pulling in the localized text from the
YAML file instead.

DRY up a ternary

Update README to note current output variants

Fix unwanted visible commas in HTML output

Set lang attribute on html element

Add HTML renderer

Need to add some styles, but this is a start.

Strip off stray trailing comma in YAML file

Add simplistic wrapping for plaintext output

Use a more literal method name (_heading -> _underline)

DRY up Plaintext underlining