upgrade postcss plugins

upgrade gulp plugins

upgrade stylelint

upgrade handlebars

upgrade eslint

update dependency lock file

use #with instead of #if to retrieve Antora version

put comparison value second in eq condition

use .. instead of ../this in template

only remove background color from active link, not whole background

don't allow the toc sidebar to grow beyond the bounds of the content column

merge !56

resolves #107 add JavaScript that generates the "on this page" sidebar

add styles for TOC and integrate TOC into page layout

- use flexbox to layout TOC
- add scroll spy behavior to sidebar TOC
- introduce additional breakpoint for sidebar TOC width (desktop and widescreen)
- activate last entry in toc if scroll has reached bottom of page
- introduce variables for toc (top, width, etc)
- add utility class to hide element when in TOC
- look for -toc class on body; rename before-toc class to is-before-toc
- use article top as threshold for activating entry in TOC
- disable scrollbar on toc in Firefox
- scroll list instead of menu
- hide scrollbar on TOC
- don't add embedded toc if element is found with ID "toc"

add JavaScript that generates the "on this page" sidebar

This script was originally developed for Couchbase by OpenDevise. This
commit contributes the script to the Antora project on behalf of
Couchbase. The script will now be licensed under the terms of the MPL
2.0 license to match the license of the Antora project itself.

correction: disable link background on active

disable background on link focus

merge !105

resolves #121 preallocate space for scrollbar on nav menu

preallocate space for scrollbar on nav menu

- set overflow: scroll
- configure scrollbar on Firefox to only show when there's scrollable content
- move scrollbar thumb color to a variable

use em instead of rem to align conum in colist

fix alignment of conums and description text in conum list

add article class to main element

merge !104

resolves #118 select nav item on hash change (and initial page load)

select nav item on hash change (and initial page load)

- select nav item that points to anchor when hash in window.location changes (or present at initial page load)
- if nav item is not found, but points to a parent of the fragment, select that nav item

merge !92

document source maps in README

rework description of source maps and move to section about bundle

format source

resolves #117 fix order of statements in relativize helper to avoid dropping fragment

merge !102

resolves #116 honor environment variable to force edit page link to be shown

honor environment variable (FORCE_SHOW_EDIT_PAGE_LINK) to force edit page link to be shown

merge !103

resolves #115 register built-in helpers (resolvePage and resolvePageURL) with stub implementation in preview site

register built-in helpers (resolvePage and resolvePageURL) with stub implementation in preview site

improve implementation for #99 and add example to preview site

merge !101

resolves #99 decode anchor hash string to support Unicode characters

fix: decode anchor hash string to support Chinese characters

(cherry picked from commit 810652e445545efbf20a6a3e93ce4365ed534516)

modify implementation of relativize helper

- consolidate logic
- return to if not root-relative
- return to prefixed with site path if from is undefined
- export unnamed function

add blank line after regexp constant in helper

document the page.displayVersion UI model property

add warning that using a backslash in front of a mustache expression disables it

make the reference table of UI variables clearer

upgrade eslint and update configuration for comma-dangle

update dependencies

resolves #103 style part heading and partintro block

don't use fileUri for edit link if CI env var is set

merge !97

resolves #102 use fileUri for edit page link if available

use fileUri for edit page link if available

update handlebars to address vuln

Add information about page.editUrl as this functionnality is limited for the moment to 4 hosts.

rename table role spread to stretch to be compliant with Asciidoctor output

document the env and antoraVersion template variables

document the siteRootPath template variable

merge !94

resolves #100 add support for line-through role

add support for line-through role

add .doc namespace to CSS selectors for doc where missing

remove redundant role from main element

minor rewording in docs

correctly document how to disable the editUrl (and hence Edit this Page link)

mention in README that Node.js provides npm

refresh dependencies

clarify how page attributes are defined and used

- mention that they can be defined in the playbook
- show an example that contains a hyphen in the name
- correct the terminology

resolves #98 ignore image optimizer if not available

update dependencies

update dependency lock file

use fallback function when image optimizer isn't available

copy any gif images under src/img

Update README.adoc

update dependencies; fix newly detected lint error

merge !91

resolves #95 prepend site path when resolving relative URL if from is undefined or empty

related to https://gitlab.com/antora/antora/issues/258

prepend site path when resolving relative URL if from is undefined or empty

minor rewording in docs for site.url and site.path template vars

use single-quoted strings in Handlebars expressions

color unresolved link

clarify docs for site.path property in UI model

document the site.path property in the UI model

merge !90

resolves #94 make current page URL argument to relativize helper optional

make current page URL argument to relativize helper optional

explain page attributes more clearly in docs

merge !89

Add example to clarify page.attributes usage.

Update templates.adoc to clarify page.attributes usage.  This might be obvious to everyone else, but it took me about a day to figure out the syntax.

add helper to return current year as a string

add hint about how to disable the page.editUrl property

disable hyphens for bare URLs

clarify info about canonical URL [skip ci]

format source

activate syntax highlighting immediately instead of deferring until load

add syntax highlighting for Go

enable strict mode for highlight.js script

only thicken bottom border of th inside thead

remove redundant property assignment in toolbar CSS

fix typo in README [skip ci]

merge !87

- recalibrate font sizes
- use rem calc function to compute font sizes from desired (desktop) pixel value
- introduce variables to control font sizes, font weights, and line heights

use CSS var for doc margin

use desktop media qualifier instead of mobile media qualifier for CSS vars

update variable convention

* use underscore for state modifier (e.g., _hover)
* use double hyphen for media modifier (e.g. --mobile)

use variables for line heights

extract font families and bold font weight into variables

recalibrate font sizes

- reduce scaling on body
- don't scale font size of paragraphs in document
- extract body font sizes as variables
- use rem calc to reverse compute rem value from desired pixel value
- adjust font sizes in nav
- slightly reduce width of nav
- fix position of component versions in explore menu

merge !88

resolves #86 drop nav state functionality

put global click listener on document element instead of window to ignore secondary clicks

drop nav state functionality

- don't attempt to remember expanded state or scroll offset
- scroll current page in nav to midpoint
- scroll current page in nav to midpoint when nav is initially hidden
- rename 01-navigation.js to 01-nav.js for consistency

fix stylelint error