You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@datafusion.apache.org by ti...@apache.org on 2024/12/05 21:52:37 UTC
(datafusion-site) branch main updated: feat/publish blog site using CI via ASF pelican workflow (#40)
This is an automated email from the ASF dual-hosted git repository.
timsaucer pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/datafusion-site.git
The following commit(s) were added to refs/heads/main by this push:
new dd131a2 feat/publish blog site using CI via ASF pelican workflow (#40)
dd131a2 is described below
commit dd131a2ea5f3e6677d46cf4d911d9661859ee03f
Author: Tim Saucer <ti...@gmail.com>
AuthorDate: Thu Dec 5 16:52:31 2024 -0500
feat/publish blog site using CI via ASF pelican workflow (#40)
* Move _posts to content/blog
* Add theme from infra team example
* Adjust metadata format
* Move images to one location
* Small theme tweaks
* Adding pelican config and a few other required files
* Updating image paths
* Add CSS content
* Enable rss feed
* Add missing libraries from infra site
* Correct rss feed link
* Clean up article header
* Add RSS link to men
* Remove jekyll
* Add github action to publish site and add staging
* Update readme for instructions on publishing via pelican
* Attempt to build all branches to verify it is safe to merge to main
* Separate workflow for building vs publishing
* Set in github action
* bool value needs no quote
* Testing CI build
* Add documentation to workflow
* Update bootstrap and highlight
* Update highlight html code to current recommended
* Remove unused files
* Adjust font sizing on blog index page
* Update readme to explain how to update dependencies
* Switch to using paths generated in the same way as the current blog site so urls do not break
* Build site and output to a staging branch
* Add documentation for how staging should work in the github workflow
* Remove stale staging branches after 21 days
* We are not currently using gfm
* Checkout current branch, not main
* Add description
* Switch to a single staging site
* Disable publishing
---
.asf.yaml | 7 +
.github/workflows/publish-site.yml | 21 +
.github/workflows/stage-site.yml | 29 +
.gitignore | 4 +-
404.html | 25 -
Gemfile | 33 -
Gemfile.lock | 111 -
README.md | 106 +-
_config.yml | 57 -
about.markdown | 13 -
.../blog}/2019-02-04-datafusion-donation.md | 4 +-
.../blog}/2021-04-12-ballista-donation.md | 4 +-
.../blog}/2021-08-18-ballista-0.5.0.md | 2 +-
.../blog}/2021-08-18-datafusion-5.0.0.md | 4 +-
.../blog}/2021-11-8-datafusion-6.0.0.md | 2 +-
.../blog}/2022-02-28-datafusion-7.0.0.md | 2 +-
.../blog}/2022-03-21-datafusion-contrib.md | 2 +-
.../blog}/2022-05-16-datafusion-8.0.0.md | 2 +-
.../blog}/2022-10-25-datafusion-13.0.0.md | 4 +-
.../blog}/2022-10-28-ballista-0.9.0.md | 4 +-
.../blog}/2023-01-19-datafusion-16.0.0.md | 4 +-
.../blog}/2023-06-24-datafusion-25.0.0.md | 4 +-
.../blog}/2023-08-05-datafusion_fast_grouping.md | 8 +-
.../blog}/2024-01-19-datafusion-34.0.0.md | 8 +-
.../blog}/2024-03-06-comet-donation.md | 6 +-
.../blog}/2024-05-07-datafusion-tlp.md | 4 +-
.../blog}/2024-07-20-datafusion-comet-0.1.0.md | 8 +-
.../blog}/2024-07-24-datafusion-40.0.0.md | 6 +-
.../blog}/2024-08-20-python-datafusion-40.0.0.md | 8 +-
.../blog}/2024-08-28-datafusion-comet-0.2.0.md | 8 +-
...9-13-string-view-german-style-strings-part-1.md | 18 +-
...9-13-string-view-german-style-strings-part-2.md | 10 +-
.../blog}/2024-09-27-datafusion-comet-0.3.0.md | 4 +-
...usion-fastest-single-node-parquet-clickbench.md | 18 +-
...2024-11-19-datafusion-python-udf-comparisons.md | 5 +-
.../blog}/2024-11-20-datafusion-comet-0.4.0.md | 4 +-
content/css/app.css | 0
content/css/blog_index.css | 16 +
content/css/bootstrap.min.css | 6 +
content/css/font-awesome.min.css | 4 +
content/css/fontawesome.all.min.css | 6 +
content/css/headerlink.css | 16 +
content/css/webfonts/fa-brands-400.ttf | Bin 0 -> 186112 bytes
content/css/webfonts/fa-brands-400.woff2 | Bin 0 -> 107460 bytes
content/css/webfonts/fa-regular-400.ttf | Bin 0 -> 62048 bytes
content/css/webfonts/fa-regular-400.woff2 | Bin 0 -> 25096 bytes
content/css/webfonts/fa-solid-900.ttf | Bin 0 -> 397728 bytes
content/css/webfonts/fa-solid-900.woff2 | Bin 0 -> 150472 bytes
content/css/webfonts/fa-v4compatibility.ttf | Bin 0 -> 10136 bytes
content/css/webfonts/fa-v4compatibility.woff2 | Bin 0 -> 4584 bytes
content/favicon.ico | Bin 0 -> 8894 bytes
content/highlight/default.min.css | 9 +
content/highlight/highlight.js | 17194 +++++++++++++++++++
.../images}/2021-08-18-datafusion500perf.png | Bin
{img => content/images}/2x_bgwhite_original.png | Bin
.../column-based-storage.png | Bin
.../clickbench-datafusion-43/perf-over-time.png | Bin
.../images}/clickbench-datafusion-43/perf.png | Bin
.../clickbench-datafusion-43/row-based-storage.png | Bin
.../skipping-partial-aggregation.png | Bin
.../clickbench-datafusion-43/string-view-take.png | Bin
.../images}/comet-0.1.0/tpch_allqueries.png | Bin
.../images}/comet-0.1.0/tpch_queries_compare.png | Bin
.../images}/comet-0.1.0/tpch_queries_speedup.png | Bin
.../images}/comet-0.2.0/tpcds_allqueries.png | Bin
.../images}/comet-0.2.0/tpch_allqueries.png | Bin
.../images}/datafusion-34.0.0/compare-new.png | Bin
.../images}/datafusion-34.0.0/compare.png | Bin
.../datafusion-40.0.0/improved-planning-time.png | Bin
.../datafusion-comet/comet-architecture.png | Bin
.../images}/datafusion_fast_grouping/full.png | Bin
.../images}/datafusion_fast_grouping/summary.png | Bin
content/images/logo_original4x.png | Bin 0 -> 119116 bytes
.../pylance_error_checking.png | Bin
.../vscode_hover_tooltip.png | Bin
.../images}/string-view-1/figure1-performance.png | Bin
.../images}/string-view-1/figure2-string-view.png | Bin
.../images}/string-view-1/figure4-copying.png | Bin
.../string-view-1/figure5-loading-strings.png | Bin
.../string-view-1/figure6-utf8-validation.png | Bin
.../images}/string-view-1/figure7-end-to-end.png | Bin
.../string-view-2/figure1-zero-copy-take.png | Bin
.../images}/string-view-2/figure2-filter-time.png | Bin
content/js/bootstrap.bundle.min.js | 7 +
content/js/bootstrap.bundle.min.js.map | 1 +
content/pages/about.md | 6 +
content/pages/index.md | 3 +
content/theme/templates/article.html | 21 +
content/theme/templates/blog.html | 26 +
content/theme/templates/blogindex.html | 36 +
content/theme/templates/footer.html | 10 +
content/theme/templates/frontpage.html | 149 +
content/theme/templates/generic.html | 22 +
content/theme/templates/index.html | 31 +
content/theme/templates/menu.html | 20 +
content/theme/templates/page.html | 24 +
content/theme/templates/styles.html | 6 +
index.markdown | 6 -
pelicanconf.py | 73 +
plugins/extract_date_from_filename.py | 20 +
100 files changed, 17882 insertions(+), 389 deletions(-)
diff --git a/.asf.yaml b/.asf.yaml
index 9a36170..7ee5b83 100644
--- a/.asf.yaml
+++ b/.asf.yaml
@@ -44,3 +44,10 @@ github:
publish:
whoami: asf-site
subdir: blog
+
+# Publishes the content of `asf-staging` branch to
+# http://datafusion.staged.apache.org
+staging:
+ whoami: asf-staging
+ profile: ~
+ autostage: site/*
diff --git a/.github/workflows/publish-site.yml b/.github/workflows/publish-site.yml
new file mode 100644
index 0000000..a8f9752
--- /dev/null
+++ b/.github/workflows/publish-site.yml
@@ -0,0 +1,21 @@
+# This workflow runs the pelican build process after any branch has merged
+# into main and pushes the result to the branch `asf-site`.
+#
+# Publishing is currently disabled until the staging branch process has been validated
+# To enable, remove the publish: false and uncomment the following lines
+name: Publish main
+on:
+ push:
+ branches: [ "main" ]
+ workflow_dispatch:
+jobs:
+ build-pelican:
+ runs-on: ubuntu-latest
+ continue-on-error: true
+ steps:
+ - uses: actions/checkout@v4
+ - uses: apache/infrastructure-actions/pelican@main
+ with:
+ publish: 'false'
+ # destination: 'asf-site'
+ # gfm: 'false'
diff --git a/.github/workflows/stage-site.yml b/.github/workflows/stage-site.yml
new file mode 100644
index 0000000..ffd264d
--- /dev/null
+++ b/.github/workflows/stage-site.yml
@@ -0,0 +1,29 @@
+# This workflow ensures that any PR targeted at main will build properly.
+# A failure in this workflow should prevent any merging into main. This will
+# build a new branch similar to the PR head branch but with "-staging"
+# appended to the end. If only runs for head branches that match "site/".
+#
+# If you wish to stage your site changes, then you simply need to open
+# a PR with a head branch of `site/` that targets `main`.
+#
+# For example, if you open a PR to merge `site/awesome-update` then this
+# workflow will create a branch `site/awesome-update-staging` that will
+# contain the built contents of the site. A separate ASF process will
+# identify that branch and stage your preview as
+# datafusion-awesome-update.staged.apache.org
+
+name: Stage Site
+on:
+ pull_request:
+ branches: ["main"]
+jobs:
+ build-pelican:
+ if: startsWith(github.head_ref, 'site/')
+ runs-on: ubuntu-latest
+ continue-on-error: true
+ steps:
+ - uses: actions/checkout@v4
+ - uses: apache/infrastructure-actions/pelican@main
+ with:
+ destination: 'asf-staging'
+ gfm: 'false'
diff --git a/.gitignore b/.gitignore
index 347cc2f..d8d5172 100644
--- a/.gitignore
+++ b/.gitignore
@@ -4,4 +4,6 @@ _site
.jekyll-cache
.jekyll-metadata
vendor
-.DS_Store
\ No newline at end of file
+.DS_Store
+output
+
diff --git a/404.html b/404.html
deleted file mode 100644
index 086a5c9..0000000
--- a/404.html
+++ /dev/null
@@ -1,25 +0,0 @@
----
-permalink: /404.html
-layout: default
----
-
-<style type="text/css" media="screen">
- .container {
- margin: 10px auto;
- max-width: 600px;
- text-align: center;
- }
- h1 {
- margin: 30px 0;
- font-size: 4em;
- line-height: 1;
- letter-spacing: -1px;
- }
-</style>
-
-<div class="container">
- <h1>404</h1>
-
- <p><strong>Page not found :(</strong></p>
- <p>The requested page could not be found.</p>
-</div>
diff --git a/Gemfile b/Gemfile
deleted file mode 100644
index f01211b..0000000
--- a/Gemfile
+++ /dev/null
@@ -1,33 +0,0 @@
-source "https://rubygems.org"
-# Hello! This is where you manage which Jekyll version is used to run.
-# When you want to use a different version, change it below, save the
-# file and run `bundle install`. Run Jekyll with `bundle exec`, like so:
-#
-# bundle exec jekyll serve
-#
-# This will help ensure the proper Jekyll version is running.
-# Happy Jekylling!
-gem "jekyll", "~> 4.3.3"
-# This is the default theme for new Jekyll sites. You may change this to anything you like.
-gem "minima", "~> 2.5"
-# If you want to use GitHub Pages, remove the "gem "jekyll"" above and
-# uncomment the line below. To upgrade, run `bundle update github-pages`.
-# gem "github-pages", group: :jekyll_plugins
-# If you have any plugins, put them here!
-group :jekyll_plugins do
- gem "jekyll-feed", "~> 0.12"
-end
-
-# Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
-# and associated library.
-platforms :mingw, :x64_mingw, :mswin, :jruby do
- gem "tzinfo", ">= 1", "< 3"
- gem "tzinfo-data"
-end
-
-# Performance-booster for watching directories on Windows
-gem "wdm", "~> 0.1.1", :platforms => [:mingw, :x64_mingw, :mswin]
-
-# Lock `http_parser.rb` gem to `v0.6.x` on JRuby builds since newer versions of the gem
-# do not have a Java counterpart.
-gem "http_parser.rb", "~> 0.6.0", :platforms => [:jruby]
diff --git a/Gemfile.lock b/Gemfile.lock
deleted file mode 100644
index 9db07d1..0000000
--- a/Gemfile.lock
+++ /dev/null
@@ -1,111 +0,0 @@
-GEM
- remote: https://rubygems.org/
- specs:
- addressable (2.8.6)
- public_suffix (>= 2.0.2, < 6.0)
- colorator (1.1.0)
- concurrent-ruby (1.2.3)
- em-websocket (0.5.3)
- eventmachine (>= 0.12.9)
- http_parser.rb (~> 0)
- eventmachine (1.2.7)
- ffi (1.16.3)
- forwardable-extended (2.6.0)
- google-protobuf (4.26.1)
- rake (>= 13)
- google-protobuf (4.26.1-arm64-darwin)
- rake (>= 13)
- google-protobuf (4.26.1-x86_64-darwin)
- rake (>= 13)
- http_parser.rb (0.8.0)
- i18n (1.14.5)
- concurrent-ruby (~> 1.0)
- jekyll (4.3.3)
- addressable (~> 2.4)
- colorator (~> 1.0)
- em-websocket (~> 0.5)
- i18n (~> 1.0)
- jekyll-sass-converter (>= 2.0, < 4.0)
- jekyll-watch (~> 2.0)
- kramdown (~> 2.3, >= 2.3.1)
- kramdown-parser-gfm (~> 1.0)
- liquid (~> 4.0)
- mercenary (>= 0.3.6, < 0.5)
- pathutil (~> 0.9)
- rouge (>= 3.0, < 5.0)
- safe_yaml (~> 1.0)
- terminal-table (>= 1.8, < 4.0)
- webrick (~> 1.7)
- jekyll-feed (0.17.0)
- jekyll (>= 3.7, < 5.0)
- jekyll-sass-converter (3.0.0)
- sass-embedded (~> 1.54)
- jekyll-seo-tag (2.8.0)
- jekyll (>= 3.8, < 5.0)
- jekyll-watch (2.2.1)
- listen (~> 3.0)
- kramdown (2.4.0)
- rexml
- kramdown-parser-gfm (1.1.0)
- kramdown (~> 2.0)
- liquid (4.0.4)
- listen (3.9.0)
- rb-fsevent (~> 0.10, >= 0.10.3)
- rb-inotify (~> 0.9, >= 0.9.10)
- mercenary (0.4.0)
- minima (2.5.1)
- jekyll (>= 3.5, < 5.0)
- jekyll-feed (~> 0.9)
- jekyll-seo-tag (~> 2.1)
- pathutil (0.16.2)
- forwardable-extended (~> 2.6)
- public_suffix (5.0.5)
- rake (13.2.1)
- rb-fsevent (0.11.2)
- rb-inotify (0.10.1)
- ffi (~> 1.0)
- rexml (3.2.8)
- strscan (>= 3.0.9)
- rouge (4.2.1)
- safe_yaml (1.0.5)
- sass-embedded (1.77.1)
- google-protobuf (>= 3.25, < 5.0)
- rake (>= 13.0.0)
- sass-embedded (1.77.1-aarch64-mingw-ucrt)
- google-protobuf (>= 3.25, < 5.0)
- sass-embedded (1.77.1-arm64-darwin)
- google-protobuf (>= 3.25, < 5.0)
- sass-embedded (1.77.1-x86-cygwin)
- google-protobuf (>= 3.25, < 5.0)
- sass-embedded (1.77.1-x86-mingw-ucrt)
- google-protobuf (>= 3.25, < 5.0)
- sass-embedded (1.77.1-x86_64-cygwin)
- google-protobuf (>= 3.25, < 5.0)
- sass-embedded (1.77.1-x86_64-darwin)
- google-protobuf (>= 3.25, < 5.0)
- strscan (3.1.0)
- terminal-table (3.0.2)
- unicode-display_width (>= 1.1.1, < 3)
- unicode-display_width (2.5.0)
- webrick (1.8.1)
-
-PLATFORMS
- aarch64-mingw-ucrt
- arm64-darwin
- ruby
- x86-cygwin
- x86-mingw-ucrt
- x86_64-cygwin
- x86_64-darwin
-
-DEPENDENCIES
- http_parser.rb (~> 0.6.0)
- jekyll (~> 4.3.3)
- jekyll-feed (~> 0.12)
- minima (~> 2.5)
- tzinfo (>= 1, < 3)
- tzinfo-data
- wdm (~> 0.1.1)
-
-BUNDLED WITH
- 2.5.10
diff --git a/README.md b/README.md
index 17f4395..7c4882b 100644
--- a/README.md
+++ b/README.md
@@ -2,87 +2,61 @@
This repository contains the Apache DataFusion blog at https://datafusion.apache.org/blog/
-## Setup for Mac
-
-Based on instructions at https://jekyllrb.com/docs/installation/macos/
-
-```shell
-brew install chruby ruby-install xz
-ruby-install ruby 3.1.3
-```
-
-Note: I did not have a `~/.zshrc` file so had to create one first.
-
-```
-echo "source $(brew --prefix)/opt/chruby/share/chruby/chruby.sh" >> ~/.zshrc
-echo "source $(brew --prefix)/opt/chruby/share/chruby/auto.sh" >> ~/.zshrc
-echo "chruby ruby-3.1.3" >> ~/.zshrc # run 'chruby' to see actual version
-```
-
-Quit and restart terminal.
-
-```shell
-ruby -v
-```
-Should be `ruby 3.1.3p185 (2022-11-24 revision 1a6b16756e) [arm64-darwin23]` or similar.
-
-```shell
-gem install jekyll bundler
-```
-
-### Preview site locally
+## Setup for Docker
```shell
-bundle exec jekyll serve
+git clone https://github.com/apache/infrastructure-actions.git
+cd infrastructure-actions
+docker build -t df-site-build pelican
```
-## Setup for Docker
-
-If you don't wish to change or install ruby and nodejs locally, you can use docker to build and preview the site with a command like:
+Then within the directory that contains `datafusion-site` you can build and test
+the site using:
```shell
-docker run -v `pwd`:/datafusion-site -p 4000:4000 -it ruby bash
-cd datafusion-site
-gem install jekyll bundler
-bundle install
-# Serve using local container address
-bundle exec jekyll serve --host 0.0.0.0
+docker run --rm -it -p8000:8000 -v $PWD:/site df-site-build:latest
```
-Then open http://localhost:4000/blog/ to see the blog locally
+Navigate in your web browser to [http://localhost:8000] to view the live website.
+This page will monitor and rebuild the site when you make any changes to the file
+structure, so you can edit and see the results by just refreshing your browser.
## Publish site
-This is currently a manual process. Basic steps are:
+The site publishes using a GitHub action provided by the ASF Infrastructure team.
+See the [ASF-Pelican](https://infra.apache.org/asf-pelican.html) site for most details
+on how this process works.
-#### Check out `main` and build site
-```shell
-# Check out latest code
-git checkout main
-git pull
-# build site (html is left in _site directory)
-bundle exec jekyll build
-```
+To preview your site live, create a branch named `site/my-feature-x`. This should
+auto-publish to https://datafusion.staged.apache.org/blog
-#### Check out `asf-site` and copy content
-Checkout a separate copy of `datafusion-site`
-
-```shell
-git checkout asf-site
-git pull
-# create a branch for the publishing
-git checkout -b publish_blog
-# copy content built from _site directory
-cp -R ../datafusion-site/_site/* .
-git commit -a -m 'Publish blog content'
-# push code upstream
-git push
-```
-
-#### Make PR, targeting the `asf-site` branch
-For example, see https://github.com/apache/datafusion-site/pull/9
+When you are satisfied with the staged branch, merging into `main` should cause
+the site to build via github actions and publish.
#### Check site status
The website is updated from the `asf-site` branch. You can check the status at
[ASF Infra sitesource](https://infra-reports.apache.org/#sitesource)
+
+## Updating Dependencies
+
+The JavaScript and CSS files included in this repository are based on the
+example from the [ASF Infra](https://github.com/apache/infrastructure-website)
+and modified slightly for our purposes. If you need to update these, the core
+libraries to use are
+
+- [bootstrap](https://getbootstrap.com/) you can simply download the latest
+ bundled minified version and css file. You will want to also include the
+ associated `.map` file. This is an common library used to provide a host
+ of useful JavaScript functions for websites.
+- [highlight.js](https://highlightjs.org/) provides the code colorization
+ for the blog posts, making them more readable. To generate a new highlight
+ package, you can use the [generator tool](https://highlightjs.org/download).
+ When you download this package, you will want to extract the full js file,
+ not the minified file or you will not get all of the functionality you
+ need.
+- [font awesome](https://fontawesome.com/) provides a variety of improved
+ fonts for readability. You can simply update the provided css files.
+- In addition to these dependencies, we have some custom CSS files to improve
+ the site layout. You can edit these files directly.
+
diff --git a/_config.yml b/_config.yml
deleted file mode 100644
index 7fea9e2..0000000
--- a/_config.yml
+++ /dev/null
@@ -1,57 +0,0 @@
-# Welcome to Jekyll!
-#
-# This config file is meant for settings that affect your whole blog, values
-# which you are expected to set up once and rarely edit after that. If you find
-# yourself editing this file very often, consider using Jekyll's data files
-# feature for the data you need to update frequently.
-#
-# For technical reasons, this file is *NOT* reloaded automatically when you use
-# 'bundle exec jekyll serve'. If you change this file, please restart the server process.
-#
-# If you need help with YAML syntax, here are some quick references for you:
-# https://learn-the-web.algonquindesign.ca/topics/markdown-yaml-cheat-sheet/#yaml
-# https://learnxinyminutes.com/docs/yaml/
-#
-# Site settings
-# These are used to personalize your new site. If you look in the HTML files,
-# you will see them accessed via {{ site.title }}, {{ site.email }}, and so on.
-# You can create any custom variable you would like, and they will be accessible
-# in the templates via {{ site.myvariable }}.
-
-title: Apache DataFusion Project News & Blog
-email: dev@datafusion.apache.org
-description: >- # this means to ignore newlines until "baseurl:"
- Apache DataFusion is a very fast, extensible query engine for building high-quality
- data-centric systems in Rust, using the Apache Arrow in-memory format.
-baseurl: "/blog" # the subpath of your site, e.g. /blog
-url: "https://datafusion.apache.org" # the base hostname & protocol for your site, e.g. http://example.com
-logo: img/2x_bgwhite_original.png
-twitter_username: ApacheDataFusio
-markdown: kramdown
-permalink: /:year/:month/:day/:title/
-timezone: UTC
-
-# Build settings
-theme: minima
-plugins:
- - jekyll-feed
-
-# Exclude from processing.
-# The following items will not be processed, by default.
-# Any item listed under the `exclude:` key here will be automatically added to
-# the internal "default list".
-#
-# Excluded items can be processed by explicitly listing the directories or
-# their entries' file path in the `include:` list.
-#
-# exclude:
-# - .sass-cache/
-# - .jekyll-cache/
-# - gemfiles/
-# - Gemfile
-# - Gemfile.lock
-# - node_modules/
-# - vendor/bundle/
-# - vendor/cache/
-# - vendor/gems/
-# - vendor/ruby/
diff --git a/about.markdown b/about.markdown
deleted file mode 100644
index 2b55aaa..0000000
--- a/about.markdown
+++ /dev/null
@@ -1,13 +0,0 @@
----
-layout: page
-title: About
-permalink: /about/
----
-
-[Apache DataFusion] is a very fast, extensible query engine for building high-quality
-data-centric systems in Rust, using the Apache Arrow in-memory format.
-
-To update this site, please propose a change to the [source code].
-
-[Apache DataFusion]: https://datafusion.apache.org/
-[source code]: https://github.com/apache/datafusion-site
diff --git a/_posts/2019-02-04-datafusion-donation.md b/content/blog/2019-02-04-datafusion-donation.md
similarity index 98%
rename from _posts/2019-02-04-datafusion-donation.md
rename to content/blog/2019-02-04-datafusion-donation.md
index 4d7c820..0ea5d30 100644
--- a/_posts/2019-02-04-datafusion-donation.md
+++ b/content/blog/2019-02-04-datafusion-donation.md
@@ -1,8 +1,8 @@
---
layout: post
-title: "DataFusion: A Rust-native Query Engine for Apache Arrow"
+title: DataFusion: A Rust-native Query Engine for Apache Arrow
description: "We are excited to announce that DataFusion has been donated to the Apache Arrow project. DataFusion is an in-memory query engine for the Rust implementation of Apache Arrow."
-date: "2019-02-04 00:00:00 -0600"
+date: 2019-02-04
author: agrove
categories: [application]
---
diff --git a/_posts/2021-04-12-ballista-donation.md b/content/blog/2021-04-12-ballista-donation.md
similarity index 97%
rename from _posts/2021-04-12-ballista-donation.md
rename to content/blog/2021-04-12-ballista-donation.md
index 63b6b4f..cdc0359 100644
--- a/_posts/2021-04-12-ballista-donation.md
+++ b/content/blog/2021-04-12-ballista-donation.md
@@ -1,8 +1,8 @@
---
layout: post
-title: "Ballista: A Distributed Scheduler for Apache Arrow"
+title: Ballista: A Distributed Scheduler for Apache Arrow
description: "We are excited to announce that Ballista has been donated to the Apache Arrow project. Ballista is a distributed scheduler for the Rust implementation of Apache Arrow."
-date: "2021-04-12 00:00:00 -0600"
+date: 2021-04-12
author: agrove
categories: [application]
---
diff --git a/_posts/2021-08-18-ballista-0.5.0.md b/content/blog/2021-08-18-ballista-0.5.0.md
similarity index 98%
rename from _posts/2021-08-18-ballista-0.5.0.md
rename to content/blog/2021-08-18-ballista-0.5.0.md
index b131086..28382bb 100644
--- a/_posts/2021-08-18-ballista-0.5.0.md
+++ b/content/blog/2021-08-18-ballista-0.5.0.md
@@ -1,7 +1,7 @@
---
layout: post
title: Apache Arrow Ballista 0.5.0 Release
-date: "2021-08-18 00:00:00"
+date: 2021-08-18
author: pmc
categories: [release]
---
diff --git a/_posts/2021-08-18-datafusion-5.0.0.md b/content/blog/2021-08-18-datafusion-5.0.0.md
similarity index 97%
rename from _posts/2021-08-18-datafusion-5.0.0.md
rename to content/blog/2021-08-18-datafusion-5.0.0.md
index 53c8f58..f1280b3 100644
--- a/_posts/2021-08-18-datafusion-5.0.0.md
+++ b/content/blog/2021-08-18-datafusion-5.0.0.md
@@ -1,7 +1,7 @@
---
layout: post
title: Apache Arrow DataFusion 5.0.0 Release
-date: "2021-08-18 00:00:00"
+date: 2021-08-18
author: pmc
categories: [release]
---
@@ -78,7 +78,7 @@ performance of individual TPC-H queries compared to the previous release.
<i>TPC-H @ scale factor 100, in parquet format. Concurrency 24.</i>
-<img src="{{ site.baseurl }}/img/2021-08-18-datafusion500perf.png" />
+<img src="../images/2021-08-18-datafusion500perf.png" />
We also extended support for more TPC-H queries: q7, q8, q9 and q13 are running successfully in DataFusion 5.0.
diff --git a/_posts/2021-11-8-datafusion-6.0.0.md b/content/blog/2021-11-8-datafusion-6.0.0.md
similarity index 99%
rename from _posts/2021-11-8-datafusion-6.0.0.md
rename to content/blog/2021-11-8-datafusion-6.0.0.md
index 49da4ae..b7d8166 100644
--- a/_posts/2021-11-8-datafusion-6.0.0.md
+++ b/content/blog/2021-11-8-datafusion-6.0.0.md
@@ -1,7 +1,7 @@
---
layout: post
title: Apache Arrow DataFusion 6.0.0 Release
-date: "2021-11-19 00:00:00"
+date: 2021-11-19
author: pmc
categories: [release]
---
diff --git a/_posts/2022-02-28-datafusion-7.0.0.md b/content/blog/2022-02-28-datafusion-7.0.0.md
similarity index 99%
rename from _posts/2022-02-28-datafusion-7.0.0.md
rename to content/blog/2022-02-28-datafusion-7.0.0.md
index 3ddd721..860351a 100644
--- a/_posts/2022-02-28-datafusion-7.0.0.md
+++ b/content/blog/2022-02-28-datafusion-7.0.0.md
@@ -1,7 +1,7 @@
---
layout: post
title: Apache Arrow DataFusion 7.0.0 Release
-date: "2022-02-28 00:00:00"
+date: 2022-02-28
author: pmc
categories: [release]
---
diff --git a/_posts/2022-03-21-datafusion-contrib.md b/content/blog/2022-03-21-datafusion-contrib.md
similarity index 99%
rename from _posts/2022-03-21-datafusion-contrib.md
rename to content/blog/2022-03-21-datafusion-contrib.md
index 877a224..425da93 100644
--- a/_posts/2022-03-21-datafusion-contrib.md
+++ b/content/blog/2022-03-21-datafusion-contrib.md
@@ -1,7 +1,7 @@
---
layout: post
title: Introducing Apache Arrow DataFusion Contrib
-date: "2022-03-21 00:00:00"
+date: 2022-03-21
author: pmc
categories: [release]
---
diff --git a/_posts/2022-05-16-datafusion-8.0.0.md b/content/blog/2022-05-16-datafusion-8.0.0.md
similarity index 99%
rename from _posts/2022-05-16-datafusion-8.0.0.md
rename to content/blog/2022-05-16-datafusion-8.0.0.md
index e20a418..9277a67 100644
--- a/_posts/2022-05-16-datafusion-8.0.0.md
+++ b/content/blog/2022-05-16-datafusion-8.0.0.md
@@ -1,7 +1,7 @@
---
layout: post
title: Apache Arrow DataFusion 8.0.0 Release
-date: "2022-05-16 00:00:00"
+date: 2022-05-16
author: pmc
categories: [release]
---
diff --git a/_posts/2022-10-25-datafusion-13.0.0.md b/content/blog/2022-10-25-datafusion-13.0.0.md
similarity index 99%
rename from _posts/2022-10-25-datafusion-13.0.0.md
rename to content/blog/2022-10-25-datafusion-13.0.0.md
index 800e14e..04a8c2d 100644
--- a/_posts/2022-10-25-datafusion-13.0.0.md
+++ b/content/blog/2022-10-25-datafusion-13.0.0.md
@@ -1,7 +1,7 @@
---
layout: post
-title: "Apache Arrow DataFusion 13.0.0 Project Update"
-date: "2022-10-25 00:00:00"
+title: Apache Arrow DataFusion 13.0.0 Project Update
+date: 2022-10-25
author: pmc
categories: [release]
---
diff --git a/_posts/2022-10-28-ballista-0.9.0.md b/content/blog/2022-10-28-ballista-0.9.0.md
similarity index 97%
rename from _posts/2022-10-28-ballista-0.9.0.md
rename to content/blog/2022-10-28-ballista-0.9.0.md
index d441c1f..55f9e4c 100644
--- a/_posts/2022-10-28-ballista-0.9.0.md
+++ b/content/blog/2022-10-28-ballista-0.9.0.md
@@ -1,7 +1,7 @@
---
layout: post
title: Apache Arrow Ballista 0.9.0 Release
-date: "2022-10-28 00:00:00"
+date: 2022-10-28
author: pmc
categories: [release]
---
@@ -79,7 +79,7 @@ interfaces.
The scheduler now has a web user interface for monitoring queries. It is also possible to view graphical query plans
that show how the query was executed, along with metrics.
-<img src="{{ site.baseurl }}/img/2022-10-28-ballista-web-ui.png" width="800"/>
+<img src="../images/2022-10-28-ballista-web-ui.png" width="800"/>
The REST API that powers the user interface can also be accessed directly.
diff --git a/_posts/2023-01-19-datafusion-16.0.0.md b/content/blog/2023-01-19-datafusion-16.0.0.md
similarity index 99%
rename from _posts/2023-01-19-datafusion-16.0.0.md
rename to content/blog/2023-01-19-datafusion-16.0.0.md
index 5be9cd0..0bbc33f 100644
--- a/_posts/2023-01-19-datafusion-16.0.0.md
+++ b/content/blog/2023-01-19-datafusion-16.0.0.md
@@ -1,7 +1,7 @@
---
layout: post
-title: "Apache Arrow DataFusion 16.0.0 Project Update"
-date: "2023-01-19 00:00:00"
+title: Apache Arrow DataFusion 16.0.0 Project Update
+date: 2023-01-19
author: pmc
categories: [release]
---
diff --git a/_posts/2023-06-24-datafusion-25.0.0.md b/content/blog/2023-06-24-datafusion-25.0.0.md
similarity index 99%
rename from _posts/2023-06-24-datafusion-25.0.0.md
rename to content/blog/2023-06-24-datafusion-25.0.0.md
index 7027f61..060abf0 100644
--- a/_posts/2023-06-24-datafusion-25.0.0.md
+++ b/content/blog/2023-06-24-datafusion-25.0.0.md
@@ -1,7 +1,7 @@
---
layout: post
-title: "Apache Arrow DataFusion 26.0.0"
-date: "2023-06-24 00:00:00"
+title: Apache Arrow DataFusion 26.0.0
+date: 2023-06-24
author: pmc
categories: [release]
---
diff --git a/_posts/2023-08-05-datafusion_fast_grouping.md b/content/blog/2023-08-05-datafusion_fast_grouping.md
similarity index 99%
rename from _posts/2023-08-05-datafusion_fast_grouping.md
rename to content/blog/2023-08-05-datafusion_fast_grouping.md
index 57fc1b7..1208e03 100644
--- a/_posts/2023-08-05-datafusion_fast_grouping.md
+++ b/content/blog/2023-08-05-datafusion_fast_grouping.md
@@ -1,7 +1,7 @@
---
layout: post
-title: "Aggregating Millions of Groups Fast in Apache Arrow DataFusion 28.0.0"
-date: "2023-08-05 00:00:00"
+title: Aggregating Millions of Groups Fast in Apache Arrow DataFusion 28.0.0
+date: 2023-08-05
author: alamb, Dandandan, tustvold
categories: [release]
---
@@ -42,7 +42,7 @@ Improving aggregation performance matters to all users of DataFusion. For exampl
With the new optimizations, DataFusion’s grouping speed is now close to DuckDB, a system that regularly reports [great](https://duckdblabs.github.io/db-benchmark/) [grouping](https://duckdb.org/2022/03/07/aggregate-hashtable.html#experiments) benchmark performance numbers. Figure 1 contains a representative sample of [ClickBench](https://github.com/ClickHouse/ClickBench/tree/main) on a single Parquet file, and the full results are at the end of this article.
-<img src="{{ site.baseurl }}/assets/datafusion_fast_grouping/summary.png" width="700">
+<img src="../images/datafusion_fast_grouping/summary.png" width="700">
**Figure 1**: Query performance for ClickBench queries on queries 16, 17, 18 and 19 on a single Parquet file for DataFusion `27.0.0`, DataFusion `28.0.0` and DuckDB `0.8.1`.
@@ -362,7 +362,7 @@ As the industry moves towards data systems assembled from components, it is incr
DataFusion now reaches near-DuckDB-speeds querying Parquet data. While we don’t plan to engage in a benchmarking shootout with a team that literally wrote [Fair Benchmarking Considered Difficult](https://dl.acm.org/doi/abs/10.1145/3209950.3209955), hopefully everyone can agree that DataFusion `28.0.0` is a significant improvement.
-<img src="{{ site.baseurl }}/assets/datafusion_fast_grouping/full.png" width="700">
+<img src="../images/datafusion_fast_grouping/full.png" width="700">
**Figure 6**: Performance of DataFusion `27.0.0`, DataFusion `28.0.0`, and DuckDB `0.8.1` on all 43 ClickBench queries against a single `hits.parquet` file. Lower is better.
diff --git a/_posts/2024-01-19-datafusion-34.0.0.md b/content/blog/2024-01-19-datafusion-34.0.0.md
similarity index 97%
rename from _posts/2024-01-19-datafusion-34.0.0.md
rename to content/blog/2024-01-19-datafusion-34.0.0.md
index b444c9f..f980a05 100644
--- a/_posts/2024-01-19-datafusion-34.0.0.md
+++ b/content/blog/2024-01-19-datafusion-34.0.0.md
@@ -1,7 +1,7 @@
---
layout: post
-title: "Apache Arrow DataFusion 34.0.0 Released, Looking Forward to 2024"
-date: "2024-01-19 00:00:00"
+title: Apache Arrow DataFusion 34.0.0 Released, Looking Forward to 2024
+date: 2024-01-19
author: pmc
categories: [release]
---
@@ -111,7 +111,7 @@ more than 2x faster on [ClickBench] compared to version `25.0.0`, as shown below
[ClickBench]: https://benchmark.clickhouse.com/
<figure style="text-align: center;">
- <img src="{{ site.baseurl }}/img/datafusion-34.0.0/compare-new.png" width="100%" class="img-responsive" alt="Fig 1: Adaptive Arrow schema architecture overview.">
+ <img src="../images/datafusion-34.0.0/compare-new.png" width="100%" class="img-responsive" alt="Fig 1: Adaptive Arrow schema architecture overview.">
<figcaption>
<b>Figure 1</b>: Performance improvement between <code>25.0.0</code> and <code>34.0.0</code> on ClickBench.
Note that DataFusion <code>25.0.0</code>, could not run several queries due to
@@ -120,7 +120,7 @@ more than 2x faster on [ClickBench] compared to version `25.0.0`, as shown below
</figure>
<figure style="text-align: center;">
- <img src="{{ site.baseurl }}/img/datafusion-34.0.0/compare.png" width="100%" class="img-responsive" alt="Fig 1: Adaptive Arrow schema architecture overview.">
+ <img src="../images/datafusion-34.0.0/compare.png" width="100%" class="img-responsive" alt="Fig 1: Adaptive Arrow schema architecture overview.">
<figcaption>
<b>Figure 2</b>: Total query runtime for DataFusion <code>34.0.0</code> and DataFusion <code>25.0.0</code>.
</figcaption>
diff --git a/_posts/2024-03-06-comet-donation.md b/content/blog/2024-03-06-comet-donation.md
similarity index 95%
rename from _posts/2024-03-06-comet-donation.md
rename to content/blog/2024-03-06-comet-donation.md
index 138ae2c..c2b90dd 100644
--- a/_posts/2024-03-06-comet-donation.md
+++ b/content/blog/2024-03-06-comet-donation.md
@@ -1,7 +1,7 @@
---
layout: post
-title: "Announcing Apache Arrow DataFusion Comet"
-date: "2024-03-06 00:00:00"
+title: Announcing Apache Arrow DataFusion Comet
+date: 2024-03-06
author: pmc
categories: [release]
---
@@ -35,7 +35,7 @@ performance improvements for some workloads as shown below.
<figure style="text-align: center;">
<img
- src="{{ site.baseurl }}/img/datafusion-comet/comet-architecture.png"
+ src="../images/datafusion-comet/comet-architecture.png"
width="100%"
class="img-responsive"
alt="Fig 1: Adaptive Arrow schema architecture overview."
diff --git a/_posts/2024-05-07-datafusion-tlp.md b/content/blog/2024-05-07-datafusion-tlp.md
similarity index 97%
rename from _posts/2024-05-07-datafusion-tlp.md
rename to content/blog/2024-05-07-datafusion-tlp.md
index 5aaac5e..3702252 100644
--- a/_posts/2024-05-07-datafusion-tlp.md
+++ b/content/blog/2024-05-07-datafusion-tlp.md
@@ -1,7 +1,7 @@
---
layout: post
-title: "Announcing Apache Arrow DataFusion is now Apache DataFusion"
-date: "2024-05-07 00:00:00"
+title: Announcing Apache Arrow DataFusion is now Apache DataFusion
+date: 2024-05-07
author: pmc
categories: [subprojects]
---
diff --git a/_posts/2024-07-20-datafusion-comet-0.1.0.md b/content/blog/2024-07-20-datafusion-comet-0.1.0.md
similarity index 97%
rename from _posts/2024-07-20-datafusion-comet-0.1.0.md
rename to content/blog/2024-07-20-datafusion-comet-0.1.0.md
index b3da9ca..e7786aa 100644
--- a/_posts/2024-07-20-datafusion-comet-0.1.0.md
+++ b/content/blog/2024-07-20-datafusion-comet-0.1.0.md
@@ -1,7 +1,7 @@
---
layout: post
-title: "Apache DataFusion Comet 0.1.0 Release"
-date: "2024-07-20 00:00:00"
+title: Apache DataFusion Comet 0.1.0 Release
+date: 2024-07-20
author: pmc
categories: [subprojects]
---
@@ -84,7 +84,7 @@ Parquet format using a single executor with eight cores. See the [Comet Benchmar
for details of the environment used for these benchmarks.
<img
-src="{{ site.baseurl }}/img/comet-0.1.0/tpch_allqueries.png"
+src="../images/comet-0.1.0/tpch_allqueries.png"
width="100%"
class="img-responsive"
alt="Chart showing TPC-H benchmark results for Comet 0.1.0"
@@ -101,7 +101,7 @@ can run natively.
The following chart shows how much Comet currently accelerates each query from the benchmark.
<img
- src="{{ site.baseurl }}/img/comet-0.1.0/tpch_queries_speedup.png"
+ src="../images/comet-0.1.0/tpch_queries_speedup.png"
width="100%"
class="img-responsive"
alt="Chart showing TPC-H benchmark results for Comet 0.1.0"
diff --git a/_posts/2024-07-24-datafusion-40.0.0.md b/content/blog/2024-07-24-datafusion-40.0.0.md
similarity index 99%
rename from _posts/2024-07-24-datafusion-40.0.0.md
rename to content/blog/2024-07-24-datafusion-40.0.0.md
index 957673d..61ca1e5 100644
--- a/_posts/2024-07-24-datafusion-40.0.0.md
+++ b/content/blog/2024-07-24-datafusion-40.0.0.md
@@ -1,7 +1,7 @@
---
layout: post
-title: "Apache DataFusion 40.0.0 Released"
-date: "2024-07-24 00:00:00"
+title: Apache DataFusion 40.0.0 Released
+date: 2024-07-24
author: pmc
categories: [release]
---
@@ -159,7 +159,7 @@ contributors including [@jackwener], [@alamb], [@Lordworms], [@dmitrybugakov],
[@appletreeisyellow], [@ClSlaid], [@rohitrastogi], [@emgeee], [@kevinmingtarja],
and [@peter-toth] over several months (see [ticket] for more details)
-<img src="{{ site.baseurl }}/assets/datafusion-40.0.0/improved-planning-time.png" width="700">
+<img src="../images/datafusion-40.0.0/improved-planning-time.png" width="700">
[ticket]: https://github.com/apache/datafusion/issues/9637
diff --git a/_posts/2024-08-20-python-datafusion-40.0.0.md b/content/blog/2024-08-20-python-datafusion-40.0.0.md
similarity index 97%
rename from _posts/2024-08-20-python-datafusion-40.0.0.md
rename to content/blog/2024-08-20-python-datafusion-40.0.0.md
index f5913b2..ca570be 100644
--- a/_posts/2024-08-20-python-datafusion-40.0.0.md
+++ b/content/blog/2024-08-20-python-datafusion-40.0.0.md
@@ -1,7 +1,7 @@
---
layout: post
-title: "Apache DataFusion Python 40.1.0 Released, Significant usability updates"
-date: "2024-08-20 00:00:00"
+title: Apache DataFusion Python 40.1.0 Released, Significant usability updates
+date: 2024-08-20
author: timsaucer
categories: [release]
---
@@ -68,7 +68,7 @@ release, users can fully use these tools in their workflow.
<figure style="text-align: center;">
<img
- src="{{ site.baseurl }}/img/python-datafusion-40.0.0/vscode_hover_tooltip.png"
+ src="../images/python-datafusion-40.0.0/vscode_hover_tooltip.png"
width="100%"
class="img-responsive"
alt="Fig 1: Enhanced tooltips in an IDE."
@@ -84,7 +84,7 @@ used a function's arguments as shown in Figure 2.
<figure style="text-align: center;">
<img
- src="{{ site.baseurl }}/img/python-datafusion-40.0.0/pylance_error_checking.png"
+ src="../images/python-datafusion-40.0.0/pylance_error_checking.png"
width="100%"
class="img-responsive"
alt="Fig 2: Error checking in static analysis"
diff --git a/_posts/2024-08-28-datafusion-comet-0.2.0.md b/content/blog/2024-08-28-datafusion-comet-0.2.0.md
similarity index 95%
rename from _posts/2024-08-28-datafusion-comet-0.2.0.md
rename to content/blog/2024-08-28-datafusion-comet-0.2.0.md
index 8f33b18..6f10079 100644
--- a/_posts/2024-08-28-datafusion-comet-0.2.0.md
+++ b/content/blog/2024-08-28-datafusion-comet-0.2.0.md
@@ -1,7 +1,7 @@
---
layout: post
-title: "Apache DataFusion Comet 0.2.0 Release"
-date: "2024-08-28 00:00:00"
+title: Apache DataFusion Comet 0.2.0 Release
+date: 2024-08-28
author: pmc
categories: [subprojects]
---
@@ -82,7 +82,7 @@ for details of the environment used for these benchmarks.
Comet 0.2.0 provides a 62% speedup compared to Spark. This is slightly better than the Comet 0.1.0 release.
<img
-src="{{ site.baseurl }}/img/comet-0.2.0/tpch_allqueries.png"
+src="../images/comet-0.2.0/tpch_allqueries.png"
width="100%"
class="img-responsive"
alt="Chart showing TPC-H benchmark results for Comet 0.2.0"
@@ -94,7 +94,7 @@ Comet 0.2.0 provides a 21% speedup compared to Spark, which is a significant imp
Comet 0.1.0, which did not provide any speedup for this benchmark.
<img
-src="{{ site.baseurl }}/img/comet-0.2.0/tpcds_allqueries.png"
+src="../images/comet-0.2.0/tpcds_allqueries.png"
width="100%"
class="img-responsive"
alt="Chart showing TPC-DS benchmark results for Comet 0.2.0"
diff --git a/_posts/2024-09-13-string-view-german-style-strings-part-1.md b/content/blog/2024-09-13-string-view-german-style-strings-part-1.md
similarity index 96%
rename from _posts/2024-09-13-string-view-german-style-strings-part-1.md
rename to content/blog/2024-09-13-string-view-german-style-strings-part-1.md
index 46b8645..6788515 100644
--- a/_posts/2024-09-13-string-view-german-style-strings-part-1.md
+++ b/content/blog/2024-09-13-string-view-german-style-strings-part-1.md
@@ -1,7 +1,7 @@
---
layout: post
-title: "Using StringView / German Style Strings to Make Queries Faster: Part 1- Reading Parquet"
-date: "2024-09-13 00:00:00"
+title: Using StringView / German Style Strings to Make Queries Faster: Part 1- Reading Parquet
+date: 2024-09-13
author: Xiangpeng Hao, Andrew Lamb
categories: [performance]
---
@@ -41,11 +41,11 @@ StringView support was released as part of [arrow-rs v52.2.0](https://crates.io/
[Xiangpeng Hao]: https://haoxp.xyz/
[InfluxData blog]: https://www.influxdata.com/blog/faster-queries-with-stringview-part-one-influxdb/
-[two part]: {{ site.baseurl }}/2024/09/13/string-view-german-style-strings-part-2/
+[two part]: ../2024/09/13/string-view-german-style-strings-part-2/
<img
-src="{{ site.baseurl }}/img/string-view-1/figure1-performance.png"
+src="../images/string-view-1/figure1-performance.png"
width="100%"
class="img-responsive"
alt="End to end performance improvements for ClickBench queries"
@@ -59,7 +59,7 @@ Figure 1: StringView improves string-intensive ClickBench query performance by 2
<img
-src="{{ site.baseurl }}/img/string-view-1/figure2-string-view.png"
+src="../images/string-view-1/figure2-string-view.png"
width="100%"
class="img-responsive"
alt="Diagram of using StringArray and StringViewArray to represent the same string content"
@@ -119,7 +119,7 @@ On the other hand, reading Parquet data as a StringViewArray can re-use the same
<img
-src="{{ site.baseurl }}/img/string-view-1/figure4-copying.png"
+src="../images/string-view-1/figure4-copying.png"
width="100%"
class="img-responsive"
alt="Diagram showing how StringViewArray can avoid copying by reusing decoded Parquet pages."
@@ -145,7 +145,7 @@ You may wonder why we reported performance for BinaryViewArray when this post is
Strings are stored as byte sequences. When reading data from (potentially untrusted) Parquet files, a Parquet decoder must ensure those byte sequences are valid UTF-8 strings, and most programming languages, including Rust, include highly[ optimized routines](https://doc.rust-lang.org/std/str/fn.from_utf8.html) for doing so.
<img
-src="{{ site.baseurl }}/img/string-view-1/figure5-loading-strings.png"
+src="../images/string-view-1/figure5-loading-strings.png"
width="100%"
class="img-responsive"
alt="Figure showing time to load strings from Parquet and the effect of optimized UTF-8 validation."
@@ -160,7 +160,7 @@ However, validating an arbitrary StringViewArray requires validating each string
UTF-8 validation in Rust is highly optimized and favors longer strings (as shown in Figure 6), likely because it leverages SIMD instructions to perform parallel validation. The benefit of a single function call to validate UTF-8 over a function call for each string more than eliminates the advantage of avoiding the copy for StringViewArray.
<img
-src="{{ site.baseurl }}/img/string-view-1/figure6-utf8-validation.png"
+src="../images/string-view-1/figure6-utf8-validation.png"
width="100%"
class="img-responsive"
alt="Figure showing UTF-8 validation throughput vs string length."
@@ -210,7 +210,7 @@ We ran the benchmark in the DataFusion repo like this:
With StringViewArray we saw a 24% end-to-end performance improvement, as shown in Figure 7. With the `--string-view` argument, the end-to-end query time is `944.3 ms, 869.6 ms, 861.9 ms` (three iterations). Without `--string-view`, the end-to-end query time is `1186.1 ms, 1126.1 ms, 1138.3 ms`.
<img
-src="{{ site.baseurl }}/img/string-view-1/figure7-end-to-end.png"
+src="../images/string-view-1/figure7-end-to-end.png"
width="100%"
class="img-responsive"
alt="Figure showing StringView improves end to end performance by 24 percent."
diff --git a/_posts/2024-09-13-string-view-german-style-strings-part-2.md b/content/blog/2024-09-13-string-view-german-style-strings-part-2.md
similarity index 98%
rename from _posts/2024-09-13-string-view-german-style-strings-part-2.md
rename to content/blog/2024-09-13-string-view-german-style-strings-part-2.md
index 44b08b1..f64fde0 100644
--- a/_posts/2024-09-13-string-view-german-style-strings-part-2.md
+++ b/content/blog/2024-09-13-string-view-german-style-strings-part-2.md
@@ -1,7 +1,7 @@
---
layout: post
-title: "Using StringView / German Style Strings to make Queries Faster: Part 2 - String Operations"
-date: "2024-09-13 00:00:00"
+title: Using StringView / German Style Strings to make Queries Faster: Part 2 - String Operations
+date: 2024-09-13
author: Xiangpeng Hao, Andrew Lamb
categories: [performance]
---
@@ -33,7 +33,7 @@ In this second part of the post, we describe the rest of the journey: implementi
[Xiangpeng Hao]: https://haoxp.xyz/
[InfluxData blog]: https://www.influxdata.com/blog/faster-queries-with-stringview-part-two-influxdb/
-[first post]: {{ site.baseurl }}/2024/09/13/string-view-german-style-strings-part-1/
+[first post]: {filename}./2024-09-13-string-view-german-style-strings-part-1.md
## Faster String Operations
@@ -63,7 +63,7 @@ Figure 1 illustrates the difference between the output of both string representa
<img
-src="{{ site.baseurl }}/img/string-view-2/figure1-zero-copy-take.png"
+src="../images/string-view-2/figure1-zero-copy-take.png"
width="100%"
class="img-responsive"
alt="Diagram showing Zero-copy `take`/`filter` for StringViewArray"
@@ -118,7 +118,7 @@ To eliminate the impact of the faster Parquet reading using StringViewArray (see
<img
-src="{{ site.baseurl }}/img/string-view-2/figure2-filter-time.png"
+src="../images/string-view-2/figure2-filter-time.png"
width="100%"
class="img-responsive"
alt="Figure showing StringViewArray reduces the filter time by 32% on ClickBench query 22."
diff --git a/_posts/2024-09-27-datafusion-comet-0.3.0.md b/content/blog/2024-09-27-datafusion-comet-0.3.0.md
similarity index 98%
rename from _posts/2024-09-27-datafusion-comet-0.3.0.md
rename to content/blog/2024-09-27-datafusion-comet-0.3.0.md
index 2633d55..a54e931 100644
--- a/_posts/2024-09-27-datafusion-comet-0.3.0.md
+++ b/content/blog/2024-09-27-datafusion-comet-0.3.0.md
@@ -1,7 +1,7 @@
---
layout: post
-title: "Apache DataFusion Comet 0.3.0 Release"
-date: "2024-09-27 00:00:00"
+title: Apache DataFusion Comet 0.3.0 Release
+date: 2024-09-27
author: pmc
categories: [subprojects]
---
diff --git a/_posts/2024-11-18-datafusion-fastest-single-node-parquet-clickbench.md b/content/blog/2024-11-18-datafusion-fastest-single-node-parquet-clickbench.md
similarity index 97%
rename from _posts/2024-11-18-datafusion-fastest-single-node-parquet-clickbench.md
rename to content/blog/2024-11-18-datafusion-fastest-single-node-parquet-clickbench.md
index 77e0921..80d00c5 100644
--- a/_posts/2024-11-18-datafusion-fastest-single-node-parquet-clickbench.md
+++ b/content/blog/2024-11-18-datafusion-fastest-single-node-parquet-clickbench.md
@@ -1,7 +1,7 @@
---
layout: post
-title: "Apache DataFusion is now the fastest single node engine for querying Apache Parquet files"
-date: "2024-11-18 00:00:00"
+title: Apache DataFusion is now the fastest single node engine for querying Apache Parquet files
+date: 2024-11-18
author: Andrew Lamb, Staff Engineer at InfluxData
categories: [core, performance]
---
@@ -41,14 +41,14 @@ been held by traditional C/C++-based engines.
<img
-src="{{ site.baseurl }}/img/2x_bgwhite_original.png"
+src="../images/2x_bgwhite_original.png"
width="80%"
class="img-responsive"
alt="Apache DataFusion Logo"
/>
<img
-src="{{ site.baseurl }}/img/clickbench-datafusion-43/perf.png"
+src="../images/clickbench-datafusion-43/perf.png"
width="100%"
class="img-responsive"
alt="ClickBench performance for DataFusion 43.0.0"
@@ -93,7 +93,7 @@ Figure 2.
[suggested focusing on performance]: https://github.com/apache/datafusion/issues/11442#issuecomment-2226834443
<img
-src="{{ site.baseurl }}/img/clickbench-datafusion-43/perf-over-time.png"
+src="../images/clickbench-datafusion-43/perf-over-time.png"
width="100%"
class="img-responsive"
alt="ClickBench performance results over time for DataFusion"
@@ -130,7 +130,7 @@ occur in many of the hottest loops during query processing, so optimizing them
resulted in measurable performance improvements.
<img
-src="{{ site.baseurl }}/img/clickbench-datafusion-43/string-view-take.png"
+src="../images/clickbench-datafusion-43/string-view-take.png"
width="80%"
class="img-responsive"
alt="Illustration of how take works with StringView"
@@ -212,7 +212,7 @@ bypass the first phase when it is not working efficiently, shown in Figure 4.
[dynamic strategy]: https://github.com/apache/datafusion/pull/11627
<img
-src="{{ site.baseurl }}/img/clickbench-datafusion-43/skipping-partial-aggregation.png"
+src="../images/clickbench-datafusion-43/skipping-partial-aggregation.png"
width="100%"
class="img-responsive"
alt="Two phase aggregation diagram from DataFusion API docs annotated to show first phase not helping"
@@ -249,7 +249,7 @@ length strings and binary data].
[is especially high for variable length strings and binary data]: https://github.com/apache/datafusion/issues/9403
<img
-src="{{ site.baseurl }}/img/clickbench-datafusion-43/row-based-storage.png"
+src="../images/clickbench-datafusion-43/row-based-storage.png"
width="100%"
class="img-responsive"
alt="Row based storage for multiple group columns"
@@ -272,7 +272,7 @@ at the [one shipped in DataFusion `43.0.0`], shown in Figure 6.
[one shipped in DataFusion `43.0.0`]: https://github.com/apache/datafusion/pull/12269
<img
-src="{{ site.baseurl }}/img/clickbench-datafusion-43/column-based-storage.png"
+src="../images/clickbench-datafusion-43/column-based-storage.png"
width="100%"
class="img-responsive"
alt="Column based storage for multiple group columns"
diff --git a/_posts/2024-11-19-datafusion-python-udf-comparisons.md b/content/blog/2024-11-19-datafusion-python-udf-comparisons.md
similarity index 99%
rename from _posts/2024-11-19-datafusion-python-udf-comparisons.md
rename to content/blog/2024-11-19-datafusion-python-udf-comparisons.md
index 7420116..315d91f 100644
--- a/_posts/2024-11-19-datafusion-python-udf-comparisons.md
+++ b/content/blog/2024-11-19-datafusion-python-udf-comparisons.md
@@ -1,7 +1,7 @@
---
layout: post
-title: "Comparing approaches to User Defined Functions in Apache DataFusion using Python"
-date: "2024-11-19 00:00:00"
+title: Comparing approaches to User Defined Functions in Apache DataFusion using Python
+date: 2024-11-19
author: timsaucer
categories: [tutorial]
---
@@ -24,7 +24,6 @@ See the License for the specific language governing permissions and
limitations under the License.
{% endcomment %}
-->
-# Writing User Defined Functions in Apache DataFusion using Python
## Personal Context
diff --git a/_posts/2024-11-20-datafusion-comet-0.4.0.md b/content/blog/2024-11-20-datafusion-comet-0.4.0.md
similarity index 98%
rename from _posts/2024-11-20-datafusion-comet-0.4.0.md
rename to content/blog/2024-11-20-datafusion-comet-0.4.0.md
index 8dfe841..2818120 100644
--- a/_posts/2024-11-20-datafusion-comet-0.4.0.md
+++ b/content/blog/2024-11-20-datafusion-comet-0.4.0.md
@@ -1,7 +1,7 @@
---
layout: post
-title: "Apache DataFusion Comet 0.4.0 Release"
-date: "2024-11-20 00:00:00"
+title: Apache DataFusion Comet 0.4.0 Release
+date: 2024-11-20
author: pmc
categories: [subprojects]
---
diff --git a/content/css/app.css b/content/css/app.css
new file mode 100644
index 0000000..e69de29
diff --git a/content/css/blog_index.css b/content/css/blog_index.css
new file mode 100644
index 0000000..cc36581
--- /dev/null
+++ b/content/css/blog_index.css
@@ -0,0 +1,16 @@
+/*
+These adjustments override bootstrap.min.css to give smaller headers in the blog index page.
+Otherwise the headers appear too large.
+*/
+
+h1 {
+ font-size: calc(1.325rem + .9vw); /* Article title */
+}
+
+h2 {
+ font-size: calc(1.3rem + .6vw); /* Main headers within article */
+}
+
+h3 {
+ font-size: calc(1.275rem + .3vw);
+}
diff --git a/content/css/bootstrap.min.css b/content/css/bootstrap.min.css
new file mode 100644
index 0000000..3993414
--- /dev/null
+++ b/content/css/bootstrap.min.css
@@ -0,0 +1,6 @@
+@charset "UTF-8";/*!
+ * Bootstrap v5.3.3 (https://getbootstrap.com/)
+ * Copyright 2011-2024 The Bootstrap Authors
+ * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)
+ */:root,[data-bs-theme=light]{--bs-blue:#0d6efd;--bs-indigo:#6610f2;--bs-purple:#6f42c1;--bs-pink:#d63384;--bs-red:#dc3545;--bs-orange:#fd7e14;--bs-yellow:#ffc107;--bs-green:#198754;--bs-teal:#20c997;--bs-cyan:#0dcaf0;--bs-black:#000;--bs-white:#fff;--bs-gray:#6c757d;--bs-gray-dark:#343a40;--bs-gray-100:#f8f9fa;--bs-gray-200:#e9ecef;--bs-gray-300:#dee2e6;--bs-gray-400:#ced4da;--bs-gray-500:#adb5bd;--bs-gray-600:#6c757d;--bs-gray-700:#495057;--bs-gray-800:#343a40;--bs-gray-900:#212529;-- [...]
+/*# sourceMappingURL=bootstrap.min.css.map */
\ No newline at end of file
diff --git a/content/css/font-awesome.min.css b/content/css/font-awesome.min.css
new file mode 100644
index 0000000..540440c
--- /dev/null
+++ b/content/css/font-awesome.min.css
@@ -0,0 +1,4 @@
+/*!
+ * Font Awesome 4.7.0 by @davegandy - http://fontawesome.io - @fontawesome
+ * License - http://fontawesome.io/license (Font: SIL OFL 1.1, CSS: MIT License)
+ */@font-face{font-family:'FontAwesome';src:url('../fonts/fontawesome-webfont.eot?v=4.7.0');src:url('../fonts/fontawesome-webfont.eot?#iefix&v=4.7.0') format('embedded-opentype'),url('../fonts/fontawesome-webfont.woff2?v=4.7.0') format('woff2'),url('../fonts/fontawesome-webfont.woff?v=4.7.0') format('woff'),url('../fonts/fontawesome-webfont.ttf?v=4.7.0') format('truetype'),url('../fonts/fontawesome-webfont.svg?v=4.7.0#fontawesomeregular') format('svg');font-weight:normal;font-style:norma [...]
diff --git a/content/css/fontawesome.all.min.css b/content/css/fontawesome.all.min.css
new file mode 100644
index 0000000..d278768
--- /dev/null
+++ b/content/css/fontawesome.all.min.css
@@ -0,0 +1,6 @@
+/*!
+ * Font Awesome Free 6.2.0 by @fontawesome - https://fontawesome.com
+ * License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License)
+ * Copyright 2022 Fonticons, Inc.
+ */
+.fa{font-family:var(--fa-style-family,"Font Awesome 6 Free");font-weight:var(--fa-style,900)}.fa,.fa-brands,.fa-classic,.fa-regular,.fa-sharp,.fa-solid,.fab,.far,.fas{-moz-osx-font-smoothing:grayscale;-webkit-font-smoothing:antialiased;display:var(--fa-display,inline-block);font-style:normal;font-variant:normal;line-height:1;text-rendering:auto}.fa-classic,.fa-regular,.fa-solid,.far,.fas{font-family:"Font Awesome 6 Free"}.fa-brands,.fab{font-family:"Font Awesome 6 Brands"}.fa-1x{font-siz [...]
diff --git a/content/css/headerlink.css b/content/css/headerlink.css
new file mode 100644
index 0000000..ed25829
--- /dev/null
+++ b/content/css/headerlink.css
@@ -0,0 +1,16 @@
+/*
+* Hide class="elementid-permalink", except when an enclosing heading
+* has the :hover property.
+*/
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h1:hover > .headerlink,
+h2:hover > .headerlink,
+h3:hover > .headerlink,
+h4:hover > .headerlink,
+h5:hover > .headerlink,
+h6:hover > .headerlink,
+dt:hover > .elementid-permalink {
+ visibility: visible
+}
diff --git a/content/css/webfonts/fa-brands-400.ttf b/content/css/webfonts/fa-brands-400.ttf
new file mode 100644
index 0000000..502f362
Binary files /dev/null and b/content/css/webfonts/fa-brands-400.ttf differ
diff --git a/content/css/webfonts/fa-brands-400.woff2 b/content/css/webfonts/fa-brands-400.woff2
new file mode 100644
index 0000000..d801b51
Binary files /dev/null and b/content/css/webfonts/fa-brands-400.woff2 differ
diff --git a/content/css/webfonts/fa-regular-400.ttf b/content/css/webfonts/fa-regular-400.ttf
new file mode 100644
index 0000000..e0abe27
Binary files /dev/null and b/content/css/webfonts/fa-regular-400.ttf differ
diff --git a/content/css/webfonts/fa-regular-400.woff2 b/content/css/webfonts/fa-regular-400.woff2
new file mode 100644
index 0000000..d736e4b
Binary files /dev/null and b/content/css/webfonts/fa-regular-400.woff2 differ
diff --git a/content/css/webfonts/fa-solid-900.ttf b/content/css/webfonts/fa-solid-900.ttf
new file mode 100644
index 0000000..13c9489
Binary files /dev/null and b/content/css/webfonts/fa-solid-900.ttf differ
diff --git a/content/css/webfonts/fa-solid-900.woff2 b/content/css/webfonts/fa-solid-900.woff2
new file mode 100644
index 0000000..3516fdb
Binary files /dev/null and b/content/css/webfonts/fa-solid-900.woff2 differ
diff --git a/content/css/webfonts/fa-v4compatibility.ttf b/content/css/webfonts/fa-v4compatibility.ttf
new file mode 100644
index 0000000..dc29819
Binary files /dev/null and b/content/css/webfonts/fa-v4compatibility.ttf differ
diff --git a/content/css/webfonts/fa-v4compatibility.woff2 b/content/css/webfonts/fa-v4compatibility.woff2
new file mode 100644
index 0000000..28d46b1
Binary files /dev/null and b/content/css/webfonts/fa-v4compatibility.woff2 differ
diff --git a/content/favicon.ico b/content/favicon.ico
new file mode 100644
index 0000000..fa733f2
Binary files /dev/null and b/content/favicon.ico differ
diff --git a/content/highlight/default.min.css b/content/highlight/default.min.css
new file mode 100644
index 0000000..a75ea91
--- /dev/null
+++ b/content/highlight/default.min.css
@@ -0,0 +1,9 @@
+/*!
+ Theme: Default
+ Description: Original highlight.js style
+ Author: (c) Ivan Sagalaev <ma...@softwaremaniacs.org>
+ Maintainer: @highlightjs/core-team
+ Website: https://highlightjs.org/
+ License: see project LICENSE
+ Touched: 2021
+*/pre code.hljs{display:block;overflow-x:auto;padding:1em}code.hljs{padding:3px 5px}.hljs{background:#f3f3f3;color:#444}.hljs-comment{color:#697070}.hljs-punctuation,.hljs-tag{color:#444a}.hljs-tag .hljs-attr,.hljs-tag .hljs-name{color:#444}.hljs-attribute,.hljs-doctag,.hljs-keyword,.hljs-meta .hljs-keyword,.hljs-name,.hljs-selector-tag{font-weight:700}.hljs-deletion,.hljs-number,.hljs-quote,.hljs-selector-class,.hljs-selector-id,.hljs-string,.hljs-template-tag,.hljs-type{color:#800}.hlj [...]
\ No newline at end of file
diff --git a/content/highlight/highlight.js b/content/highlight/highlight.js
new file mode 100644
index 0000000..b017717
--- /dev/null
+++ b/content/highlight/highlight.js
@@ -0,0 +1,17194 @@
+/*!
+ Highlight.js v11.10.0 (git: 366a8bd012)
+ (c) 2006-2024 Josh Goebel <he...@joshgoebel.com> and other contributors
+ License: BSD-3-Clause
+ */
+var hljs = (function () {
+ 'use strict';
+
+ /* eslint-disable no-multi-assign */
+
+ function deepFreeze(obj) {
+ if (obj instanceof Map) {
+ obj.clear =
+ obj.delete =
+ obj.set =
+ function () {
+ throw new Error('map is read-only');
+ };
+ } else if (obj instanceof Set) {
+ obj.add =
+ obj.clear =
+ obj.delete =
+ function () {
+ throw new Error('set is read-only');
+ };
+ }
+
+ // Freeze self
+ Object.freeze(obj);
+
+ Object.getOwnPropertyNames(obj).forEach((name) => {
+ const prop = obj[name];
+ const type = typeof prop;
+
+ // Freeze prop if it is an object or function and also not already frozen
+ if ((type === 'object' || type === 'function') && !Object.isFrozen(prop)) {
+ deepFreeze(prop);
+ }
+ });
+
+ return obj;
+ }
+
+ /** @typedef {import('highlight.js').CallbackResponse} CallbackResponse */
+ /** @typedef {import('highlight.js').CompiledMode} CompiledMode */
+ /** @implements CallbackResponse */
+
+ class Response {
+ /**
+ * @param {CompiledMode} mode
+ */
+ constructor(mode) {
+ // eslint-disable-next-line no-undefined
+ if (mode.data === undefined) mode.data = {};
+
+ this.data = mode.data;
+ this.isMatchIgnored = false;
+ }
+
+ ignoreMatch() {
+ this.isMatchIgnored = true;
+ }
+ }
+
+ /**
+ * @param {string} value
+ * @returns {string}
+ */
+ function escapeHTML(value) {
+ return value
+ .replace(/&/g, '&')
+ .replace(/</g, '<')
+ .replace(/>/g, '>')
+ .replace(/"/g, '"')
+ .replace(/'/g, ''');
+ }
+
+ /**
+ * performs a shallow merge of multiple objects into one
+ *
+ * @template T
+ * @param {T} original
+ * @param {Record<string,any>[]} objects
+ * @returns {T} a single new object
+ */
+ function inherit$1(original, ...objects) {
+ /** @type Record<string,any> */
+ const result = Object.create(null);
+
+ for (const key in original) {
+ result[key] = original[key];
+ }
+ objects.forEach(function(obj) {
+ for (const key in obj) {
+ result[key] = obj[key];
+ }
+ });
+ return /** @type {T} */ (result);
+ }
+
+ /**
+ * @typedef {object} Renderer
+ * @property {(text: string) => void} addText
+ * @property {(node: Node) => void} openNode
+ * @property {(node: Node) => void} closeNode
+ * @property {() => string} value
+ */
+
+ /** @typedef {{scope?: string, language?: string, sublanguage?: boolean}} Node */
+ /** @typedef {{walk: (r: Renderer) => void}} Tree */
+ /** */
+
+ const SPAN_CLOSE = '</span>';
+
+ /**
+ * Determines if a node needs to be wrapped in <span>
+ *
+ * @param {Node} node */
+ const emitsWrappingTags = (node) => {
+ // rarely we can have a sublanguage where language is undefined
+ // TODO: track down why
+ return !!node.scope;
+ };
+
+ /**
+ *
+ * @param {string} name
+ * @param {{prefix:string}} options
+ */
+ const scopeToCSSClass = (name, { prefix }) => {
+ // sub-language
+ if (name.startsWith("language:")) {
+ return name.replace("language:", "language-");
+ }
+ // tiered scope: comment.line
+ if (name.includes(".")) {
+ const pieces = name.split(".");
+ return [
+ `${prefix}${pieces.shift()}`,
+ ...(pieces.map((x, i) => `${x}${"_".repeat(i + 1)}`))
+ ].join(" ");
+ }
+ // simple scope
+ return `${prefix}${name}`;
+ };
+
+ /** @type {Renderer} */
+ class HTMLRenderer {
+ /**
+ * Creates a new HTMLRenderer
+ *
+ * @param {Tree} parseTree - the parse tree (must support `walk` API)
+ * @param {{classPrefix: string}} options
+ */
+ constructor(parseTree, options) {
+ this.buffer = "";
+ this.classPrefix = options.classPrefix;
+ parseTree.walk(this);
+ }
+
+ /**
+ * Adds texts to the output stream
+ *
+ * @param {string} text */
+ addText(text) {
+ this.buffer += escapeHTML(text);
+ }
+
+ /**
+ * Adds a node open to the output stream (if needed)
+ *
+ * @param {Node} node */
+ openNode(node) {
+ if (!emitsWrappingTags(node)) return;
+
+ const className = scopeToCSSClass(node.scope,
+ { prefix: this.classPrefix });
+ this.span(className);
+ }
+
+ /**
+ * Adds a node close to the output stream (if needed)
+ *
+ * @param {Node} node */
+ closeNode(node) {
+ if (!emitsWrappingTags(node)) return;
+
+ this.buffer += SPAN_CLOSE;
+ }
+
+ /**
+ * returns the accumulated buffer
+ */
+ value() {
+ return this.buffer;
+ }
+
+ // helpers
+
+ /**
+ * Builds a span element
+ *
+ * @param {string} className */
+ span(className) {
+ this.buffer += `<span class="${className}">`;
+ }
+ }
+
+ /** @typedef {{scope?: string, language?: string, children: Node[]} | string} Node */
+ /** @typedef {{scope?: string, language?: string, children: Node[]} } DataNode */
+ /** @typedef {import('highlight.js').Emitter} Emitter */
+ /** */
+
+ /** @returns {DataNode} */
+ const newNode = (opts = {}) => {
+ /** @type DataNode */
+ const result = { children: [] };
+ Object.assign(result, opts);
+ return result;
+ };
+
+ class TokenTree {
+ constructor() {
+ /** @type DataNode */
+ this.rootNode = newNode();
+ this.stack = [this.rootNode];
+ }
+
+ get top() {
+ return this.stack[this.stack.length - 1];
+ }
+
+ get root() { return this.rootNode; }
+
+ /** @param {Node} node */
+ add(node) {
+ this.top.children.push(node);
+ }
+
+ /** @param {string} scope */
+ openNode(scope) {
+ /** @type Node */
+ const node = newNode({ scope });
+ this.add(node);
+ this.stack.push(node);
+ }
+
+ closeNode() {
+ if (this.stack.length > 1) {
+ return this.stack.pop();
+ }
+ // eslint-disable-next-line no-undefined
+ return undefined;
+ }
+
+ closeAllNodes() {
+ while (this.closeNode());
+ }
+
+ toJSON() {
+ return JSON.stringify(this.rootNode, null, 4);
+ }
+
+ /**
+ * @typedef { import("./html_renderer").Renderer } Renderer
+ * @param {Renderer} builder
+ */
+ walk(builder) {
+ // this does not
+ return this.constructor._walk(builder, this.rootNode);
+ // this works
+ // return TokenTree._walk(builder, this.rootNode);
+ }
+
+ /**
+ * @param {Renderer} builder
+ * @param {Node} node
+ */
+ static _walk(builder, node) {
+ if (typeof node === "string") {
+ builder.addText(node);
+ } else if (node.children) {
+ builder.openNode(node);
+ node.children.forEach((child) => this._walk(builder, child));
+ builder.closeNode(node);
+ }
+ return builder;
+ }
+
+ /**
+ * @param {Node} node
+ */
+ static _collapse(node) {
+ if (typeof node === "string") return;
+ if (!node.children) return;
+
+ if (node.children.every(el => typeof el === "string")) {
+ // node.text = node.children.join("");
+ // delete node.children;
+ node.children = [node.children.join("")];
+ } else {
+ node.children.forEach((child) => {
+ TokenTree._collapse(child);
+ });
+ }
+ }
+ }
+
+ /**
+ Currently this is all private API, but this is the minimal API necessary
+ that an Emitter must implement to fully support the parser.
+
+ Minimal interface:
+
+ - addText(text)
+ - __addSublanguage(emitter, subLanguageName)
+ - startScope(scope)
+ - endScope()
+ - finalize()
+ - toHTML()
+
+ */
+
+ /**
+ * @implements {Emitter}
+ */
+ class TokenTreeEmitter extends TokenTree {
+ /**
+ * @param {*} options
+ */
+ constructor(options) {
+ super();
+ this.options = options;
+ }
+
+ /**
+ * @param {string} text
+ */
+ addText(text) {
+ if (text === "") { return; }
+
+ this.add(text);
+ }
+
+ /** @param {string} scope */
+ startScope(scope) {
+ this.openNode(scope);
+ }
+
+ endScope() {
+ this.closeNode();
+ }
+
+ /**
+ * @param {Emitter & {root: DataNode}} emitter
+ * @param {string} name
+ */
+ __addSublanguage(emitter, name) {
+ /** @type DataNode */
+ const node = emitter.root;
+ if (name) node.scope = `language:${name}`;
+
+ this.add(node);
+ }
+
+ toHTML() {
+ const renderer = new HTMLRenderer(this, this.options);
+ return renderer.value();
+ }
+
+ finalize() {
+ this.closeAllNodes();
+ return true;
+ }
+ }
+
+ /**
+ * @param {string} value
+ * @returns {RegExp}
+ * */
+
+ /**
+ * @param {RegExp | string } re
+ * @returns {string}
+ */
+ function source(re) {
+ if (!re) return null;
+ if (typeof re === "string") return re;
+
+ return re.source;
+ }
+
+ /**
+ * @param {RegExp | string } re
+ * @returns {string}
+ */
+ function lookahead(re) {
+ return concat('(?=', re, ')');
+ }
+
+ /**
+ * @param {RegExp | string } re
+ * @returns {string}
+ */
+ function anyNumberOfTimes(re) {
+ return concat('(?:', re, ')*');
+ }
+
+ /**
+ * @param {RegExp | string } re
+ * @returns {string}
+ */
+ function optional(re) {
+ return concat('(?:', re, ')?');
+ }
+
+ /**
+ * @param {...(RegExp | string) } args
+ * @returns {string}
+ */
+ function concat(...args) {
+ const joined = args.map((x) => source(x)).join("");
+ return joined;
+ }
+
+ /**
+ * @param { Array<string | RegExp | Object> } args
+ * @returns {object}
+ */
+ function stripOptionsFromArgs(args) {
+ const opts = args[args.length - 1];
+
+ if (typeof opts === 'object' && opts.constructor === Object) {
+ args.splice(args.length - 1, 1);
+ return opts;
+ } else {
+ return {};
+ }
+ }
+
+ /** @typedef { {capture?: boolean} } RegexEitherOptions */
+
+ /**
+ * Any of the passed expresssions may match
+ *
+ * Creates a huge this | this | that | that match
+ * @param {(RegExp | string)[] | [...(RegExp | string)[], RegexEitherOptions]} args
+ * @returns {string}
+ */
+ function either(...args) {
+ /** @type { object & {capture?: boolean} } */
+ const opts = stripOptionsFromArgs(args);
+ const joined = '('
+ + (opts.capture ? "" : "?:")
+ + args.map((x) => source(x)).join("|") + ")";
+ return joined;
+ }
+
+ /**
+ * @param {RegExp | string} re
+ * @returns {number}
+ */
+ function countMatchGroups(re) {
+ return (new RegExp(re.toString() + '|')).exec('').length - 1;
+ }
+
+ /**
+ * Does lexeme start with a regular expression match at the beginning
+ * @param {RegExp} re
+ * @param {string} lexeme
+ */
+ function startsWith(re, lexeme) {
+ const match = re && re.exec(lexeme);
+ return match && match.index === 0;
+ }
+
+ // BACKREF_RE matches an open parenthesis or backreference. To avoid
+ // an incorrect parse, it additionally matches the following:
+ // - [...] elements, where the meaning of parentheses and escapes change
+ // - other escape sequences, so we do not misparse escape sequences as
+ // interesting elements
+ // - non-matching or lookahead parentheses, which do not capture. These
+ // follow the '(' with a '?'.
+ const BACKREF_RE = /\[(?:[^\\\]]|\\.)*\]|\(\??|\\([1-9][0-9]*)|\\./;
+
+ // **INTERNAL** Not intended for outside usage
+ // join logically computes regexps.join(separator), but fixes the
+ // backreferences so they continue to match.
+ // it also places each individual regular expression into it's own
+ // match group, keeping track of the sequencing of those match groups
+ // is currently an exercise for the caller. :-)
+ /**
+ * @param {(string | RegExp)[]} regexps
+ * @param {{joinWith: string}} opts
+ * @returns {string}
+ */
+ function _rewriteBackreferences(regexps, { joinWith }) {
+ let numCaptures = 0;
+
+ return regexps.map((regex) => {
+ numCaptures += 1;
+ const offset = numCaptures;
+ let re = source(regex);
+ let out = '';
+
+ while (re.length > 0) {
+ const match = BACKREF_RE.exec(re);
+ if (!match) {
+ out += re;
+ break;
+ }
+ out += re.substring(0, match.index);
+ re = re.substring(match.index + match[0].length);
+ if (match[0][0] === '\\' && match[1]) {
+ // Adjust the backreference.
+ out += '\\' + String(Number(match[1]) + offset);
+ } else {
+ out += match[0];
+ if (match[0] === '(') {
+ numCaptures++;
+ }
+ }
+ }
+ return out;
+ }).map(re => `(${re})`).join(joinWith);
+ }
+
+ /** @typedef {import('highlight.js').Mode} Mode */
+ /** @typedef {import('highlight.js').ModeCallback} ModeCallback */
+
+ // Common regexps
+ const MATCH_NOTHING_RE = /\b\B/;
+ const IDENT_RE = '[a-zA-Z]\\w*';
+ const UNDERSCORE_IDENT_RE = '[a-zA-Z_]\\w*';
+ const NUMBER_RE = '\\b\\d+(\\.\\d+)?';
+ const C_NUMBER_RE = '(-?)(\\b0[xX][a-fA-F0-9]+|(\\b\\d+(\\.\\d*)?|\\.\\d+)([eE][-+]?\\d+)?)'; // 0x..., 0..., decimal, float
+ const BINARY_NUMBER_RE = '\\b(0b[01]+)'; // 0b...
+ const RE_STARTERS_RE = '!|!=|!==|%|%=|&|&&|&=|\\*|\\*=|\\+|\\+=|,|-|-=|/=|/|:|;|<<|<<=|<=|<|===|==|=|>>>=|>>=|>=|>>>|>>|>|\\?|\\[|\\{|\\(|\\^|\\^=|\\||\\|=|\\|\\||~';
+
+ /**
+ * @param { Partial<Mode> & {binary?: string | RegExp} } opts
+ */
+ const SHEBANG = (opts = {}) => {
+ const beginShebang = /^#![ ]*\//;
+ if (opts.binary) {
+ opts.begin = concat(
+ beginShebang,
+ /.*\b/,
+ opts.binary,
+ /\b.*/);
+ }
+ return inherit$1({
+ scope: 'meta',
+ begin: beginShebang,
+ end: /$/,
+ relevance: 0,
+ /** @type {ModeCallback} */
+ "on:begin": (m, resp) => {
+ if (m.index !== 0) resp.ignoreMatch();
+ }
+ }, opts);
+ };
+
+ // Common modes
+ const BACKSLASH_ESCAPE = {
+ begin: '\\\\[\\s\\S]', relevance: 0
+ };
+ const APOS_STRING_MODE = {
+ scope: 'string',
+ begin: '\'',
+ end: '\'',
+ illegal: '\\n',
+ contains: [BACKSLASH_ESCAPE]
+ };
+ const QUOTE_STRING_MODE = {
+ scope: 'string',
+ begin: '"',
+ end: '"',
+ illegal: '\\n',
+ contains: [BACKSLASH_ESCAPE]
+ };
+ const PHRASAL_WORDS_MODE = {
+ begin: /\b(a|an|the|are|I'm|isn't|don't|doesn't|won't|but|just|should|pretty|simply|enough|gonna|going|wtf|so|such|will|you|your|they|like|more)\b/
+ };
+ /**
+ * Creates a comment mode
+ *
+ * @param {string | RegExp} begin
+ * @param {string | RegExp} end
+ * @param {Mode | {}} [modeOptions]
+ * @returns {Partial<Mode>}
+ */
+ const COMMENT = function(begin, end, modeOptions = {}) {
+ const mode = inherit$1(
+ {
+ scope: 'comment',
+ begin,
+ end,
+ contains: []
+ },
+ modeOptions
+ );
+ mode.contains.push({
+ scope: 'doctag',
+ // hack to avoid the space from being included. the space is necessary to
+ // match here to prevent the plain text rule below from gobbling up doctags
+ begin: '[ ]*(?=(TODO|FIXME|NOTE|BUG|OPTIMIZE|HACK|XXX):)',
+ end: /(TODO|FIXME|NOTE|BUG|OPTIMIZE|HACK|XXX):/,
+ excludeBegin: true,
+ relevance: 0
+ });
+ const ENGLISH_WORD = either(
+ // list of common 1 and 2 letter words in English
+ "I",
+ "a",
+ "is",
+ "so",
+ "us",
+ "to",
+ "at",
+ "if",
+ "in",
+ "it",
+ "on",
+ // note: this is not an exhaustive list of contractions, just popular ones
+ /[A-Za-z]+['](d|ve|re|ll|t|s|n)/, // contractions - can't we'd they're let's, etc
+ /[A-Za-z]+[-][a-z]+/, // `no-way`, etc.
+ /[A-Za-z][a-z]{2,}/ // allow capitalized words at beginning of sentences
+ );
+ // looking like plain text, more likely to be a comment
+ mode.contains.push(
+ {
+ // TODO: how to include ", (, ) without breaking grammars that use these for
+ // comment delimiters?
+ // begin: /[ ]+([()"]?([A-Za-z'-]{3,}|is|a|I|so|us|[tT][oO]|at|if|in|it|on)[.]?[()":]?([.][ ]|[ ]|\))){3}/
+ // ---
+
+ // this tries to find sequences of 3 english words in a row (without any
+ // "programming" type syntax) this gives us a strong signal that we've
+ // TRULY found a comment - vs perhaps scanning with the wrong language.
+ // It's possible to find something that LOOKS like the start of the
+ // comment - but then if there is no readable text - good chance it is a
+ // false match and not a comment.
+ //
+ // for a visual example please see:
+ // https://github.com/highlightjs/highlight.js/issues/2827
+
+ begin: concat(
+ /[ ]+/, // necessary to prevent us gobbling up doctags like /* @author Bob Mcgill */
+ '(',
+ ENGLISH_WORD,
+ /[.]?[:]?([.][ ]|[ ])/,
+ '){3}') // look for 3 words in a row
+ }
+ );
+ return mode;
+ };
+ const C_LINE_COMMENT_MODE = COMMENT('//', '$');
+ const C_BLOCK_COMMENT_MODE = COMMENT('/\\*', '\\*/');
+ const HASH_COMMENT_MODE = COMMENT('#', '$');
+ const NUMBER_MODE = {
+ scope: 'number',
+ begin: NUMBER_RE,
+ relevance: 0
+ };
+ const C_NUMBER_MODE = {
+ scope: 'number',
+ begin: C_NUMBER_RE,
+ relevance: 0
+ };
+ const BINARY_NUMBER_MODE = {
+ scope: 'number',
+ begin: BINARY_NUMBER_RE,
+ relevance: 0
+ };
+ const REGEXP_MODE = {
+ scope: "regexp",
+ begin: /\/(?=[^/\n]*\/)/,
+ end: /\/[gimuy]*/,
+ contains: [
+ BACKSLASH_ESCAPE,
+ {
+ begin: /\[/,
+ end: /\]/,
+ relevance: 0,
+ contains: [BACKSLASH_ESCAPE]
+ }
+ ]
+ };
+ const TITLE_MODE = {
+ scope: 'title',
+ begin: IDENT_RE,
+ relevance: 0
+ };
+ const UNDERSCORE_TITLE_MODE = {
+ scope: 'title',
+ begin: UNDERSCORE_IDENT_RE,
+ relevance: 0
+ };
+ const METHOD_GUARD = {
+ // excludes method names from keyword processing
+ begin: '\\.\\s*' + UNDERSCORE_IDENT_RE,
+ relevance: 0
+ };
+
+ /**
+ * Adds end same as begin mechanics to a mode
+ *
+ * Your mode must include at least a single () match group as that first match
+ * group is what is used for comparison
+ * @param {Partial<Mode>} mode
+ */
+ const END_SAME_AS_BEGIN = function(mode) {
+ return Object.assign(mode,
+ {
+ /** @type {ModeCallback} */
+ 'on:begin': (m, resp) => { resp.data._beginMatch = m[1]; },
+ /** @type {ModeCallback} */
+ 'on:end': (m, resp) => { if (resp.data._beginMatch !== m[1]) resp.ignoreMatch(); }
+ });
+ };
+
+ var MODES = /*#__PURE__*/Object.freeze({
+ __proto__: null,
+ APOS_STRING_MODE: APOS_STRING_MODE,
+ BACKSLASH_ESCAPE: BACKSLASH_ESCAPE,
+ BINARY_NUMBER_MODE: BINARY_NUMBER_MODE,
+ BINARY_NUMBER_RE: BINARY_NUMBER_RE,
+ COMMENT: COMMENT,
+ C_BLOCK_COMMENT_MODE: C_BLOCK_COMMENT_MODE,
+ C_LINE_COMMENT_MODE: C_LINE_COMMENT_MODE,
+ C_NUMBER_MODE: C_NUMBER_MODE,
+ C_NUMBER_RE: C_NUMBER_RE,
+ END_SAME_AS_BEGIN: END_SAME_AS_BEGIN,
+ HASH_COMMENT_MODE: HASH_COMMENT_MODE,
+ IDENT_RE: IDENT_RE,
+ MATCH_NOTHING_RE: MATCH_NOTHING_RE,
+ METHOD_GUARD: METHOD_GUARD,
+ NUMBER_MODE: NUMBER_MODE,
+ NUMBER_RE: NUMBER_RE,
+ PHRASAL_WORDS_MODE: PHRASAL_WORDS_MODE,
+ QUOTE_STRING_MODE: QUOTE_STRING_MODE,
+ REGEXP_MODE: REGEXP_MODE,
+ RE_STARTERS_RE: RE_STARTERS_RE,
+ SHEBANG: SHEBANG,
+ TITLE_MODE: TITLE_MODE,
+ UNDERSCORE_IDENT_RE: UNDERSCORE_IDENT_RE,
+ UNDERSCORE_TITLE_MODE: UNDERSCORE_TITLE_MODE
+ });
+
+ /**
+ @typedef {import('highlight.js').CallbackResponse} CallbackResponse
+ @typedef {import('highlight.js').CompilerExt} CompilerExt
+ */
+
+ // Grammar extensions / plugins
+ // See: https://github.com/highlightjs/highlight.js/issues/2833
+
+ // Grammar extensions allow "syntactic sugar" to be added to the grammar modes
+ // without requiring any underlying changes to the compiler internals.
+
+ // `compileMatch` being the perfect small example of now allowing a grammar
+ // author to write `match` when they desire to match a single expression rather
+ // than being forced to use `begin`. The extension then just moves `match` into
+ // `begin` when it runs. Ie, no features have been added, but we've just made
+ // the experience of writing (and reading grammars) a little bit nicer.
+
+ // ------
+
+ // TODO: We need negative look-behind support to do this properly
+ /**
+ * Skip a match if it has a preceding dot
+ *
+ * This is used for `beginKeywords` to prevent matching expressions such as
+ * `bob.keyword.do()`. The mode compiler automatically wires this up as a
+ * special _internal_ 'on:begin' callback for modes with `beginKeywords`
+ * @param {RegExpMatchArray} match
+ * @param {CallbackResponse} response
+ */
+ function skipIfHasPrecedingDot(match, response) {
+ const before = match.input[match.index - 1];
+ if (before === ".") {
+ response.ignoreMatch();
+ }
+ }
+
+ /**
+ *
+ * @type {CompilerExt}
+ */
+ function scopeClassName(mode, _parent) {
+ // eslint-disable-next-line no-undefined
+ if (mode.className !== undefined) {
+ mode.scope = mode.className;
+ delete mode.className;
+ }
+ }
+
+ /**
+ * `beginKeywords` syntactic sugar
+ * @type {CompilerExt}
+ */
+ function beginKeywords(mode, parent) {
+ if (!parent) return;
+ if (!mode.beginKeywords) return;
+
+ // for languages with keywords that include non-word characters checking for
+ // a word boundary is not sufficient, so instead we check for a word boundary
+ // or whitespace - this does no harm in any case since our keyword engine
+ // doesn't allow spaces in keywords anyways and we still check for the boundary
+ // first
+ mode.begin = '\\b(' + mode.beginKeywords.split(' ').join('|') + ')(?!\\.)(?=\\b|\\s)';
+ mode.__beforeBegin = skipIfHasPrecedingDot;
+ mode.keywords = mode.keywords || mode.beginKeywords;
+ delete mode.beginKeywords;
+
+ // prevents double relevance, the keywords themselves provide
+ // relevance, the mode doesn't need to double it
+ // eslint-disable-next-line no-undefined
+ if (mode.relevance === undefined) mode.relevance = 0;
+ }
+
+ /**
+ * Allow `illegal` to contain an array of illegal values
+ * @type {CompilerExt}
+ */
+ function compileIllegal(mode, _parent) {
+ if (!Array.isArray(mode.illegal)) return;
+
+ mode.illegal = either(...mode.illegal);
+ }
+
+ /**
+ * `match` to match a single expression for readability
+ * @type {CompilerExt}
+ */
+ function compileMatch(mode, _parent) {
+ if (!mode.match) return;
+ if (mode.begin || mode.end) throw new Error("begin & end are not supported with match");
+
+ mode.begin = mode.match;
+ delete mode.match;
+ }
+
+ /**
+ * provides the default 1 relevance to all modes
+ * @type {CompilerExt}
+ */
+ function compileRelevance(mode, _parent) {
+ // eslint-disable-next-line no-undefined
+ if (mode.relevance === undefined) mode.relevance = 1;
+ }
+
+ // allow beforeMatch to act as a "qualifier" for the match
+ // the full match begin must be [beforeMatch][begin]
+ const beforeMatchExt = (mode, parent) => {
+ if (!mode.beforeMatch) return;
+ // starts conflicts with endsParent which we need to make sure the child
+ // rule is not matched multiple times
+ if (mode.starts) throw new Error("beforeMatch cannot be used with starts");
+
+ const originalMode = Object.assign({}, mode);
+ Object.keys(mode).forEach((key) => { delete mode[key]; });
+
+ mode.keywords = originalMode.keywords;
+ mode.begin = concat(originalMode.beforeMatch, lookahead(originalMode.begin));
+ mode.starts = {
+ relevance: 0,
+ contains: [
+ Object.assign(originalMode, { endsParent: true })
+ ]
+ };
+ mode.relevance = 0;
+
+ delete originalMode.beforeMatch;
+ };
+
+ // keywords that should have no default relevance value
+ const COMMON_KEYWORDS = [
+ 'of',
+ 'and',
+ 'for',
+ 'in',
+ 'not',
+ 'or',
+ 'if',
+ 'then',
+ 'parent', // common variable name
+ 'list', // common variable name
+ 'value' // common variable name
+ ];
+
+ const DEFAULT_KEYWORD_SCOPE = "keyword";
+
+ /**
+ * Given raw keywords from a language definition, compile them.
+ *
+ * @param {string | Record<string,string|string[]> | Array<string>} rawKeywords
+ * @param {boolean} caseInsensitive
+ */
+ function compileKeywords(rawKeywords, caseInsensitive, scopeName = DEFAULT_KEYWORD_SCOPE) {
+ /** @type {import("highlight.js/private").KeywordDict} */
+ const compiledKeywords = Object.create(null);
+
+ // input can be a string of keywords, an array of keywords, or a object with
+ // named keys representing scopeName (which can then point to a string or array)
+ if (typeof rawKeywords === 'string') {
+ compileList(scopeName, rawKeywords.split(" "));
+ } else if (Array.isArray(rawKeywords)) {
+ compileList(scopeName, rawKeywords);
+ } else {
+ Object.keys(rawKeywords).forEach(function(scopeName) {
+ // collapse all our objects back into the parent object
+ Object.assign(
+ compiledKeywords,
+ compileKeywords(rawKeywords[scopeName], caseInsensitive, scopeName)
+ );
+ });
+ }
+ return compiledKeywords;
+
+ // ---
+
+ /**
+ * Compiles an individual list of keywords
+ *
+ * Ex: "for if when while|5"
+ *
+ * @param {string} scopeName
+ * @param {Array<string>} keywordList
+ */
+ function compileList(scopeName, keywordList) {
+ if (caseInsensitive) {
+ keywordList = keywordList.map(x => x.toLowerCase());
+ }
+ keywordList.forEach(function(keyword) {
+ const pair = keyword.split('|');
+ compiledKeywords[pair[0]] = [scopeName, scoreForKeyword(pair[0], pair[1])];
+ });
+ }
+ }
+
+ /**
+ * Returns the proper score for a given keyword
+ *
+ * Also takes into account comment keywords, which will be scored 0 UNLESS
+ * another score has been manually assigned.
+ * @param {string} keyword
+ * @param {string} [providedScore]
+ */
+ function scoreForKeyword(keyword, providedScore) {
+ // manual scores always win over common keywords
+ // so you can force a score of 1 if you really insist
+ if (providedScore) {
+ return Number(providedScore);
+ }
+
+ return commonKeyword(keyword) ? 0 : 1;
+ }
+
+ /**
+ * Determines if a given keyword is common or not
+ *
+ * @param {string} keyword */
+ function commonKeyword(keyword) {
+ return COMMON_KEYWORDS.includes(keyword.toLowerCase());
+ }
+
+ /*
+
+ For the reasoning behind this please see:
+ https://github.com/highlightjs/highlight.js/issues/2880#issuecomment-747275419
+
+ */
+
+ /**
+ * @type {Record<string, boolean>}
+ */
+ const seenDeprecations = {};
+
+ /**
+ * @param {string} message
+ */
+ const error = (message) => {
+ console.error(message);
+ };
+
+ /**
+ * @param {string} message
+ * @param {any} args
+ */
+ const warn = (message, ...args) => {
+ console.log(`WARN: ${message}`, ...args);
+ };
+
+ /**
+ * @param {string} version
+ * @param {string} message
+ */
+ const deprecated = (version, message) => {
+ if (seenDeprecations[`${version}/${message}`]) return;
+
+ console.log(`Deprecated as of ${version}. ${message}`);
+ seenDeprecations[`${version}/${message}`] = true;
+ };
+
+ /* eslint-disable no-throw-literal */
+
+ /**
+ @typedef {import('highlight.js').CompiledMode} CompiledMode
+ */
+
+ const MultiClassError = new Error();
+
+ /**
+ * Renumbers labeled scope names to account for additional inner match
+ * groups that otherwise would break everything.
+ *
+ * Lets say we 3 match scopes:
+ *
+ * { 1 => ..., 2 => ..., 3 => ... }
+ *
+ * So what we need is a clean match like this:
+ *
+ * (a)(b)(c) => [ "a", "b", "c" ]
+ *
+ * But this falls apart with inner match groups:
+ *
+ * (a)(((b)))(c) => ["a", "b", "b", "b", "c" ]
+ *
+ * Our scopes are now "out of alignment" and we're repeating `b` 3 times.
+ * What needs to happen is the numbers are remapped:
+ *
+ * { 1 => ..., 2 => ..., 5 => ... }
+ *
+ * We also need to know that the ONLY groups that should be output
+ * are 1, 2, and 5. This function handles this behavior.
+ *
+ * @param {CompiledMode} mode
+ * @param {Array<RegExp | string>} regexes
+ * @param {{key: "beginScope"|"endScope"}} opts
+ */
+ function remapScopeNames(mode, regexes, { key }) {
+ let offset = 0;
+ const scopeNames = mode[key];
+ /** @type Record<number,boolean> */
+ const emit = {};
+ /** @type Record<number,string> */
+ const positions = {};
+
+ for (let i = 1; i <= regexes.length; i++) {
+ positions[i + offset] = scopeNames[i];
+ emit[i + offset] = true;
+ offset += countMatchGroups(regexes[i - 1]);
+ }
+ // we use _emit to keep track of which match groups are "top-level" to avoid double
+ // output from inside match groups
+ mode[key] = positions;
+ mode[key]._emit = emit;
+ mode[key]._multi = true;
+ }
+
+ /**
+ * @param {CompiledMode} mode
+ */
+ function beginMultiClass(mode) {
+ if (!Array.isArray(mode.begin)) return;
+
+ if (mode.skip || mode.excludeBegin || mode.returnBegin) {
+ error("skip, excludeBegin, returnBegin not compatible with beginScope: {}");
+ throw MultiClassError;
+ }
+
+ if (typeof mode.beginScope !== "object" || mode.beginScope === null) {
+ error("beginScope must be object");
+ throw MultiClassError;
+ }
+
+ remapScopeNames(mode, mode.begin, { key: "beginScope" });
+ mode.begin = _rewriteBackreferences(mode.begin, { joinWith: "" });
+ }
+
+ /**
+ * @param {CompiledMode} mode
+ */
+ function endMultiClass(mode) {
+ if (!Array.isArray(mode.end)) return;
+
+ if (mode.skip || mode.excludeEnd || mode.returnEnd) {
+ error("skip, excludeEnd, returnEnd not compatible with endScope: {}");
+ throw MultiClassError;
+ }
+
+ if (typeof mode.endScope !== "object" || mode.endScope === null) {
+ error("endScope must be object");
+ throw MultiClassError;
+ }
+
+ remapScopeNames(mode, mode.end, { key: "endScope" });
+ mode.end = _rewriteBackreferences(mode.end, { joinWith: "" });
+ }
+
+ /**
+ * this exists only to allow `scope: {}` to be used beside `match:`
+ * Otherwise `beginScope` would necessary and that would look weird
+
+ {
+ match: [ /def/, /\w+/ ]
+ scope: { 1: "keyword" , 2: "title" }
+ }
+
+ * @param {CompiledMode} mode
+ */
+ function scopeSugar(mode) {
+ if (mode.scope && typeof mode.scope === "object" && mode.scope !== null) {
+ mode.beginScope = mode.scope;
+ delete mode.scope;
+ }
+ }
+
+ /**
+ * @param {CompiledMode} mode
+ */
+ function MultiClass(mode) {
+ scopeSugar(mode);
+
+ if (typeof mode.beginScope === "string") {
+ mode.beginScope = { _wrap: mode.beginScope };
+ }
+ if (typeof mode.endScope === "string") {
+ mode.endScope = { _wrap: mode.endScope };
+ }
+
+ beginMultiClass(mode);
+ endMultiClass(mode);
+ }
+
+ /**
+ @typedef {import('highlight.js').Mode} Mode
+ @typedef {import('highlight.js').CompiledMode} CompiledMode
+ @typedef {import('highlight.js').Language} Language
+ @typedef {import('highlight.js').HLJSPlugin} HLJSPlugin
+ @typedef {import('highlight.js').CompiledLanguage} CompiledLanguage
+ */
+
+ // compilation
+
+ /**
+ * Compiles a language definition result
+ *
+ * Given the raw result of a language definition (Language), compiles this so
+ * that it is ready for highlighting code.
+ * @param {Language} language
+ * @returns {CompiledLanguage}
+ */
+ function compileLanguage(language) {
+ /**
+ * Builds a regex with the case sensitivity of the current language
+ *
+ * @param {RegExp | string} value
+ * @param {boolean} [global]
+ */
+ function langRe(value, global) {
+ return new RegExp(
+ source(value),
+ 'm'
+ + (language.case_insensitive ? 'i' : '')
+ + (language.unicodeRegex ? 'u' : '')
+ + (global ? 'g' : '')
+ );
+ }
+
+ /**
+ Stores multiple regular expressions and allows you to quickly search for
+ them all in a string simultaneously - returning the first match. It does
+ this by creating a huge (a|b|c) regex - each individual item wrapped with ()
+ and joined by `|` - using match groups to track position. When a match is
+ found checking which position in the array has content allows us to figure
+ out which of the original regexes / match groups triggered the match.
+
+ The match object itself (the result of `Regex.exec`) is returned but also
+ enhanced by merging in any meta-data that was registered with the regex.
+ This is how we keep track of which mode matched, and what type of rule
+ (`illegal`, `begin`, end, etc).
+ */
+ class MultiRegex {
+ constructor() {
+ this.matchIndexes = {};
+ // @ts-ignore
+ this.regexes = [];
+ this.matchAt = 1;
+ this.position = 0;
+ }
+
+ // @ts-ignore
+ addRule(re, opts) {
+ opts.position = this.position++;
+ // @ts-ignore
+ this.matchIndexes[this.matchAt] = opts;
+ this.regexes.push([opts, re]);
+ this.matchAt += countMatchGroups(re) + 1;
+ }
+
+ compile() {
+ if (this.regexes.length === 0) {
+ // avoids the need to check length every time exec is called
+ // @ts-ignore
+ this.exec = () => null;
+ }
+ const terminators = this.regexes.map(el => el[1]);
+ this.matcherRe = langRe(_rewriteBackreferences(terminators, { joinWith: '|' }), true);
+ this.lastIndex = 0;
+ }
+
+ /** @param {string} s */
+ exec(s) {
+ this.matcherRe.lastIndex = this.lastIndex;
+ const match = this.matcherRe.exec(s);
+ if (!match) { return null; }
+
+ // eslint-disable-next-line no-undefined
+ const i = match.findIndex((el, i) => i > 0 && el !== undefined);
+ // @ts-ignore
+ const matchData = this.matchIndexes[i];
+ // trim off any earlier non-relevant match groups (ie, the other regex
+ // match groups that make up the multi-matcher)
+ match.splice(0, i);
+
+ return Object.assign(match, matchData);
+ }
+ }
+
+ /*
+ Created to solve the key deficiently with MultiRegex - there is no way to
+ test for multiple matches at a single location. Why would we need to do
+ that? In the future a more dynamic engine will allow certain matches to be
+ ignored. An example: if we matched say the 3rd regex in a large group but
+ decided to ignore it - we'd need to started testing again at the 4th
+ regex... but MultiRegex itself gives us no real way to do that.
+
+ So what this class creates MultiRegexs on the fly for whatever search
+ position they are needed.
+
+ NOTE: These additional MultiRegex objects are created dynamically. For most
+ grammars most of the time we will never actually need anything more than the
+ first MultiRegex - so this shouldn't have too much overhead.
+
+ Say this is our search group, and we match regex3, but wish to ignore it.
+
+ regex1 | regex2 | regex3 | regex4 | regex5 ' ie, startAt = 0
+
+ What we need is a new MultiRegex that only includes the remaining
+ possibilities:
+
+ regex4 | regex5 ' ie, startAt = 3
+
+ This class wraps all that complexity up in a simple API... `startAt` decides
+ where in the array of expressions to start doing the matching. It
+ auto-increments, so if a match is found at position 2, then startAt will be
+ set to 3. If the end is reached startAt will return to 0.
+
+ MOST of the time the parser will be setting startAt manually to 0.
+ */
+ class ResumableMultiRegex {
+ constructor() {
+ // @ts-ignore
+ this.rules = [];
+ // @ts-ignore
+ this.multiRegexes = [];
+ this.count = 0;
+
+ this.lastIndex = 0;
+ this.regexIndex = 0;
+ }
+
+ // @ts-ignore
+ getMatcher(index) {
+ if (this.multiRegexes[index]) return this.multiRegexes[index];
+
+ const matcher = new MultiRegex();
+ this.rules.slice(index).forEach(([re, opts]) => matcher.addRule(re, opts));
+ matcher.compile();
+ this.multiRegexes[index] = matcher;
+ return matcher;
+ }
+
+ resumingScanAtSamePosition() {
+ return this.regexIndex !== 0;
+ }
+
+ considerAll() {
+ this.regexIndex = 0;
+ }
+
+ // @ts-ignore
+ addRule(re, opts) {
+ this.rules.push([re, opts]);
+ if (opts.type === "begin") this.count++;
+ }
+
+ /** @param {string} s */
+ exec(s) {
+ const m = this.getMatcher(this.regexIndex);
+ m.lastIndex = this.lastIndex;
+ let result = m.exec(s);
+
+ // The following is because we have no easy way to say "resume scanning at the
+ // existing position but also skip the current rule ONLY". What happens is
+ // all prior rules are also skipped which can result in matching the wrong
+ // thing. Example of matching "booger":
+
+ // our matcher is [string, "booger", number]
+ //
+ // ....booger....
+
+ // if "booger" is ignored then we'd really need a regex to scan from the
+ // SAME position for only: [string, number] but ignoring "booger" (if it
+ // was the first match), a simple resume would scan ahead who knows how
+ // far looking only for "number", ignoring potential string matches (or
+ // future "booger" matches that might be valid.)
+
+ // So what we do: We execute two matchers, one resuming at the same
+ // position, but the second full matcher starting at the position after:
+
+ // /--- resume first regex match here (for [number])
+ // |/---- full match here for [string, "booger", number]
+ // vv
+ // ....booger....
+
+ // Which ever results in a match first is then used. So this 3-4 step
+ // process essentially allows us to say "match at this position, excluding
+ // a prior rule that was ignored".
+ //
+ // 1. Match "booger" first, ignore. Also proves that [string] does non match.
+ // 2. Resume matching for [number]
+ // 3. Match at index + 1 for [string, "booger", number]
+ // 4. If #2 and #3 result in matches, which came first?
+ if (this.resumingScanAtSamePosition()) {
+ if (result && result.index === this.lastIndex) ; else { // use the second matcher result
+ const m2 = this.getMatcher(0);
+ m2.lastIndex = this.lastIndex + 1;
+ result = m2.exec(s);
+ }
+ }
+
+ if (result) {
+ this.regexIndex += result.position + 1;
+ if (this.regexIndex === this.count) {
+ // wrap-around to considering all matches again
+ this.considerAll();
+ }
+ }
+
+ return result;
+ }
+ }
+
+ /**
+ * Given a mode, builds a huge ResumableMultiRegex that can be used to walk
+ * the content and find matches.
+ *
+ * @param {CompiledMode} mode
+ * @returns {ResumableMultiRegex}
+ */
+ function buildModeRegex(mode) {
+ const mm = new ResumableMultiRegex();
+
+ mode.contains.forEach(term => mm.addRule(term.begin, { rule: term, type: "begin" }));
+
+ if (mode.terminatorEnd) {
+ mm.addRule(mode.terminatorEnd, { type: "end" });
+ }
+ if (mode.illegal) {
+ mm.addRule(mode.illegal, { type: "illegal" });
+ }
+
+ return mm;
+ }
+
+ /** skip vs abort vs ignore
+ *
+ * @skip - The mode is still entered and exited normally (and contains rules apply),
+ * but all content is held and added to the parent buffer rather than being
+ * output when the mode ends. Mostly used with `sublanguage` to build up
+ * a single large buffer than can be parsed by sublanguage.
+ *
+ * - The mode begin ands ends normally.
+ * - Content matched is added to the parent mode buffer.
+ * - The parser cursor is moved forward normally.
+ *
+ * @abort - A hack placeholder until we have ignore. Aborts the mode (as if it
+ * never matched) but DOES NOT continue to match subsequent `contains`
+ * modes. Abort is bad/suboptimal because it can result in modes
+ * farther down not getting applied because an earlier rule eats the
+ * content but then aborts.
+ *
+ * - The mode does not begin.
+ * - Content matched by `begin` is added to the mode buffer.
+ * - The parser cursor is moved forward accordingly.
+ *
+ * @ignore - Ignores the mode (as if it never matched) and continues to match any
+ * subsequent `contains` modes. Ignore isn't technically possible with
+ * the current parser implementation.
+ *
+ * - The mode does not begin.
+ * - Content matched by `begin` is ignored.
+ * - The parser cursor is not moved forward.
+ */
+
+ /**
+ * Compiles an individual mode
+ *
+ * This can raise an error if the mode contains certain detectable known logic
+ * issues.
+ * @param {Mode} mode
+ * @param {CompiledMode | null} [parent]
+ * @returns {CompiledMode | never}
+ */
+ function compileMode(mode, parent) {
+ const cmode = /** @type CompiledMode */ (mode);
+ if (mode.isCompiled) return cmode;
+
+ [
+ scopeClassName,
+ // do this early so compiler extensions generally don't have to worry about
+ // the distinction between match/begin
+ compileMatch,
+ MultiClass,
+ beforeMatchExt
+ ].forEach(ext => ext(mode, parent));
+
+ language.compilerExtensions.forEach(ext => ext(mode, parent));
+
+ // __beforeBegin is considered private API, internal use only
+ mode.__beforeBegin = null;
+
+ [
+ beginKeywords,
+ // do this later so compiler extensions that come earlier have access to the
+ // raw array if they wanted to perhaps manipulate it, etc.
+ compileIllegal,
+ // default to 1 relevance if not specified
+ compileRelevance
+ ].forEach(ext => ext(mode, parent));
+
+ mode.isCompiled = true;
+
+ let keywordPattern = null;
+ if (typeof mode.keywords === "object" && mode.keywords.$pattern) {
+ // we need a copy because keywords might be compiled multiple times
+ // so we can't go deleting $pattern from the original on the first
+ // pass
+ mode.keywords = Object.assign({}, mode.keywords);
+ keywordPattern = mode.keywords.$pattern;
+ delete mode.keywords.$pattern;
+ }
+ keywordPattern = keywordPattern || /\w+/;
+
+ if (mode.keywords) {
+ mode.keywords = compileKeywords(mode.keywords, language.case_insensitive);
+ }
+
+ cmode.keywordPatternRe = langRe(keywordPattern, true);
+
+ if (parent) {
+ if (!mode.begin) mode.begin = /\B|\b/;
+ cmode.beginRe = langRe(cmode.begin);
+ if (!mode.end && !mode.endsWithParent) mode.end = /\B|\b/;
+ if (mode.end) cmode.endRe = langRe(cmode.end);
+ cmode.terminatorEnd = source(cmode.end) || '';
+ if (mode.endsWithParent && parent.terminatorEnd) {
+ cmode.terminatorEnd += (mode.end ? '|' : '') + parent.terminatorEnd;
+ }
+ }
+ if (mode.illegal) cmode.illegalRe = langRe(/** @type {RegExp | string} */ (mode.illegal));
+ if (!mode.contains) mode.contains = [];
+
+ mode.contains = [].concat(...mode.contains.map(function(c) {
+ return expandOrCloneMode(c === 'self' ? mode : c);
+ }));
+ mode.contains.forEach(function(c) { compileMode(/** @type Mode */ (c), cmode); });
+
+ if (mode.starts) {
+ compileMode(mode.starts, parent);
+ }
+
+ cmode.matcher = buildModeRegex(cmode);
+ return cmode;
+ }
+
+ if (!language.compilerExtensions) language.compilerExtensions = [];
+
+ // self is not valid at the top-level
+ if (language.contains && language.contains.includes('self')) {
+ throw new Error("ERR: contains `self` is not supported at the top-level of a language. See documentation.");
+ }
+
+ // we need a null object, which inherit will guarantee
+ language.classNameAliases = inherit$1(language.classNameAliases || {});
+
+ return compileMode(/** @type Mode */ (language));
+ }
+
+ /**
+ * Determines if a mode has a dependency on it's parent or not
+ *
+ * If a mode does have a parent dependency then often we need to clone it if
+ * it's used in multiple places so that each copy points to the correct parent,
+ * where-as modes without a parent can often safely be re-used at the bottom of
+ * a mode chain.
+ *
+ * @param {Mode | null} mode
+ * @returns {boolean} - is there a dependency on the parent?
+ * */
+ function dependencyOnParent(mode) {
+ if (!mode) return false;
+
+ return mode.endsWithParent || dependencyOnParent(mode.starts);
+ }
+
+ /**
+ * Expands a mode or clones it if necessary
+ *
+ * This is necessary for modes with parental dependenceis (see notes on
+ * `dependencyOnParent`) and for nodes that have `variants` - which must then be
+ * exploded into their own individual modes at compile time.
+ *
+ * @param {Mode} mode
+ * @returns {Mode | Mode[]}
+ * */
+ function expandOrCloneMode(mode) {
+ if (mode.variants && !mode.cachedVariants) {
+ mode.cachedVariants = mode.variants.map(function(variant) {
+ return inherit$1(mode, { variants: null }, variant);
+ });
+ }
+
+ // EXPAND
+ // if we have variants then essentially "replace" the mode with the variants
+ // this happens in compileMode, where this function is called from
+ if (mode.cachedVariants) {
+ return mode.cachedVariants;
+ }
+
+ // CLONE
+ // if we have dependencies on parents then we need a unique
+ // instance of ourselves, so we can be reused with many
+ // different parents without issue
+ if (dependencyOnParent(mode)) {
+ return inherit$1(mode, { starts: mode.starts ? inherit$1(mode.starts) : null });
+ }
+
+ if (Object.isFrozen(mode)) {
+ return inherit$1(mode);
+ }
+
+ // no special dependency issues, just return ourselves
+ return mode;
+ }
+
+ var version = "11.10.0";
+
+ class HTMLInjectionError extends Error {
+ constructor(reason, html) {
+ super(reason);
+ this.name = "HTMLInjectionError";
+ this.html = html;
+ }
+ }
+
+ /*
+ Syntax highlighting with language autodetection.
+ https://highlightjs.org/
+ */
+
+
+
+ /**
+ @typedef {import('highlight.js').Mode} Mode
+ @typedef {import('highlight.js').CompiledMode} CompiledMode
+ @typedef {import('highlight.js').CompiledScope} CompiledScope
+ @typedef {import('highlight.js').Language} Language
+ @typedef {import('highlight.js').HLJSApi} HLJSApi
+ @typedef {import('highlight.js').HLJSPlugin} HLJSPlugin
+ @typedef {import('highlight.js').PluginEvent} PluginEvent
+ @typedef {import('highlight.js').HLJSOptions} HLJSOptions
+ @typedef {import('highlight.js').LanguageFn} LanguageFn
+ @typedef {import('highlight.js').HighlightedHTMLElement} HighlightedHTMLElement
+ @typedef {import('highlight.js').BeforeHighlightContext} BeforeHighlightContext
+ @typedef {import('highlight.js/private').MatchType} MatchType
+ @typedef {import('highlight.js/private').KeywordData} KeywordData
+ @typedef {import('highlight.js/private').EnhancedMatch} EnhancedMatch
+ @typedef {import('highlight.js/private').AnnotatedError} AnnotatedError
+ @typedef {import('highlight.js').AutoHighlightResult} AutoHighlightResult
+ @typedef {import('highlight.js').HighlightOptions} HighlightOptions
+ @typedef {import('highlight.js').HighlightResult} HighlightResult
+ */
+
+
+ const escape = escapeHTML;
+ const inherit = inherit$1;
+ const NO_MATCH = Symbol("nomatch");
+ const MAX_KEYWORD_HITS = 7;
+
+ /**
+ * @param {any} hljs - object that is extended (legacy)
+ * @returns {HLJSApi}
+ */
+ const HLJS = function(hljs) {
+ // Global internal variables used within the highlight.js library.
+ /** @type {Record<string, Language>} */
+ const languages = Object.create(null);
+ /** @type {Record<string, string>} */
+ const aliases = Object.create(null);
+ /** @type {HLJSPlugin[]} */
+ const plugins = [];
+
+ // safe/production mode - swallows more errors, tries to keep running
+ // even if a single syntax or parse hits a fatal error
+ let SAFE_MODE = true;
+ const LANGUAGE_NOT_FOUND = "Could not find the language '{}', did you forget to load/include a language module?";
+ /** @type {Language} */
+ const PLAINTEXT_LANGUAGE = { disableAutodetect: true, name: 'Plain text', contains: [] };
+
+ // Global options used when within external APIs. This is modified when
+ // calling the `hljs.configure` function.
+ /** @type HLJSOptions */
+ let options = {
+ ignoreUnescapedHTML: false,
+ throwUnescapedHTML: false,
+ noHighlightRe: /^(no-?highlight)$/i,
+ languageDetectRe: /\blang(?:uage)?-([\w-]+)\b/i,
+ classPrefix: 'hljs-',
+ cssSelector: 'pre code',
+ languages: null,
+ // beta configuration options, subject to change, welcome to discuss
+ // https://github.com/highlightjs/highlight.js/issues/1086
+ __emitter: TokenTreeEmitter
+ };
+
+ /* Utility functions */
+
+ /**
+ * Tests a language name to see if highlighting should be skipped
+ * @param {string} languageName
+ */
+ function shouldNotHighlight(languageName) {
+ return options.noHighlightRe.test(languageName);
+ }
+
+ /**
+ * @param {HighlightedHTMLElement} block - the HTML element to determine language for
+ */
+ function blockLanguage(block) {
+ let classes = block.className + ' ';
+
+ classes += block.parentNode ? block.parentNode.className : '';
+
+ // language-* takes precedence over non-prefixed class names.
+ const match = options.languageDetectRe.exec(classes);
+ if (match) {
+ const language = getLanguage(match[1]);
+ if (!language) {
+ warn(LANGUAGE_NOT_FOUND.replace("{}", match[1]));
+ warn("Falling back to no-highlight mode for this block.", block);
+ }
+ return language ? match[1] : 'no-highlight';
+ }
+
+ return classes
+ .split(/\s+/)
+ .find((_class) => shouldNotHighlight(_class) || getLanguage(_class));
+ }
+
+ /**
+ * Core highlighting function.
+ *
+ * OLD API
+ * highlight(lang, code, ignoreIllegals, continuation)
+ *
+ * NEW API
+ * highlight(code, {lang, ignoreIllegals})
+ *
+ * @param {string} codeOrLanguageName - the language to use for highlighting
+ * @param {string | HighlightOptions} optionsOrCode - the code to highlight
+ * @param {boolean} [ignoreIllegals] - whether to ignore illegal matches, default is to bail
+ *
+ * @returns {HighlightResult} Result - an object that represents the result
+ * @property {string} language - the language name
+ * @property {number} relevance - the relevance score
+ * @property {string} value - the highlighted HTML code
+ * @property {string} code - the original raw code
+ * @property {CompiledMode} top - top of the current mode stack
+ * @property {boolean} illegal - indicates whether any illegal matches were found
+ */
+ function highlight(codeOrLanguageName, optionsOrCode, ignoreIllegals) {
+ let code = "";
+ let languageName = "";
+ if (typeof optionsOrCode === "object") {
+ code = codeOrLanguageName;
+ ignoreIllegals = optionsOrCode.ignoreIllegals;
+ languageName = optionsOrCode.language;
+ } else {
+ // old API
+ deprecated("10.7.0", "highlight(lang, code, ...args) has been deprecated.");
+ deprecated("10.7.0", "Please use highlight(code, options) instead.\nhttps://github.com/highlightjs/highlight.js/issues/2277");
+ languageName = codeOrLanguageName;
+ code = optionsOrCode;
+ }
+
+ // https://github.com/highlightjs/highlight.js/issues/3149
+ // eslint-disable-next-line no-undefined
+ if (ignoreIllegals === undefined) { ignoreIllegals = true; }
+
+ /** @type {BeforeHighlightContext} */
+ const context = {
+ code,
+ language: languageName
+ };
+ // the plugin can change the desired language or the code to be highlighted
+ // just be changing the object it was passed
+ fire("before:highlight", context);
+
+ // a before plugin can usurp the result completely by providing it's own
+ // in which case we don't even need to call highlight
+ const result = context.result
+ ? context.result
+ : _highlight(context.language, context.code, ignoreIllegals);
+
+ result.code = context.code;
+ // the plugin can change anything in result to suite it
+ fire("after:highlight", result);
+
+ return result;
+ }
+
+ /**
+ * private highlight that's used internally and does not fire callbacks
+ *
+ * @param {string} languageName - the language to use for highlighting
+ * @param {string} codeToHighlight - the code to highlight
+ * @param {boolean?} [ignoreIllegals] - whether to ignore illegal matches, default is to bail
+ * @param {CompiledMode?} [continuation] - current continuation mode, if any
+ * @returns {HighlightResult} - result of the highlight operation
+ */
+ function _highlight(languageName, codeToHighlight, ignoreIllegals, continuation) {
+ const keywordHits = Object.create(null);
+
+ /**
+ * Return keyword data if a match is a keyword
+ * @param {CompiledMode} mode - current mode
+ * @param {string} matchText - the textual match
+ * @returns {KeywordData | false}
+ */
+ function keywordData(mode, matchText) {
+ return mode.keywords[matchText];
+ }
+
+ function processKeywords() {
+ if (!top.keywords) {
+ emitter.addText(modeBuffer);
+ return;
+ }
+
+ let lastIndex = 0;
+ top.keywordPatternRe.lastIndex = 0;
+ let match = top.keywordPatternRe.exec(modeBuffer);
+ let buf = "";
+
+ while (match) {
+ buf += modeBuffer.substring(lastIndex, match.index);
+ const word = language.case_insensitive ? match[0].toLowerCase() : match[0];
+ const data = keywordData(top, word);
+ if (data) {
+ const [kind, keywordRelevance] = data;
+ emitter.addText(buf);
+ buf = "";
+
+ keywordHits[word] = (keywordHits[word] || 0) + 1;
+ if (keywordHits[word] <= MAX_KEYWORD_HITS) relevance += keywordRelevance;
+ if (kind.startsWith("_")) {
+ // _ implied for relevance only, do not highlight
+ // by applying a class name
+ buf += match[0];
+ } else {
+ const cssClass = language.classNameAliases[kind] || kind;
+ emitKeyword(match[0], cssClass);
+ }
+ } else {
+ buf += match[0];
+ }
+ lastIndex = top.keywordPatternRe.lastIndex;
+ match = top.keywordPatternRe.exec(modeBuffer);
+ }
+ buf += modeBuffer.substring(lastIndex);
+ emitter.addText(buf);
+ }
+
+ function processSubLanguage() {
+ if (modeBuffer === "") return;
+ /** @type HighlightResult */
+ let result = null;
+
+ if (typeof top.subLanguage === 'string') {
+ if (!languages[top.subLanguage]) {
+ emitter.addText(modeBuffer);
+ return;
+ }
+ result = _highlight(top.subLanguage, modeBuffer, true, continuations[top.subLanguage]);
+ continuations[top.subLanguage] = /** @type {CompiledMode} */ (result._top);
+ } else {
+ result = highlightAuto(modeBuffer, top.subLanguage.length ? top.subLanguage : null);
+ }
+
+ // Counting embedded language score towards the host language may be disabled
+ // with zeroing the containing mode relevance. Use case in point is Markdown that
+ // allows XML everywhere and makes every XML snippet to have a much larger Markdown
+ // score.
+ if (top.relevance > 0) {
+ relevance += result.relevance;
+ }
+ emitter.__addSublanguage(result._emitter, result.language);
+ }
+
+ function processBuffer() {
+ if (top.subLanguage != null) {
+ processSubLanguage();
+ } else {
+ processKeywords();
+ }
+ modeBuffer = '';
+ }
+
+ /**
+ * @param {string} text
+ * @param {string} scope
+ */
+ function emitKeyword(keyword, scope) {
+ if (keyword === "") return;
+
+ emitter.startScope(scope);
+ emitter.addText(keyword);
+ emitter.endScope();
+ }
+
+ /**
+ * @param {CompiledScope} scope
+ * @param {RegExpMatchArray} match
+ */
+ function emitMultiClass(scope, match) {
+ let i = 1;
+ const max = match.length - 1;
+ while (i <= max) {
+ if (!scope._emit[i]) { i++; continue; }
+ const klass = language.classNameAliases[scope[i]] || scope[i];
+ const text = match[i];
+ if (klass) {
+ emitKeyword(text, klass);
+ } else {
+ modeBuffer = text;
+ processKeywords();
+ modeBuffer = "";
+ }
+ i++;
+ }
+ }
+
+ /**
+ * @param {CompiledMode} mode - new mode to start
+ * @param {RegExpMatchArray} match
+ */
+ function startNewMode(mode, match) {
+ if (mode.scope && typeof mode.scope === "string") {
+ emitter.openNode(language.classNameAliases[mode.scope] || mode.scope);
+ }
+ if (mode.beginScope) {
+ // beginScope just wraps the begin match itself in a scope
+ if (mode.beginScope._wrap) {
+ emitKeyword(modeBuffer, language.classNameAliases[mode.beginScope._wrap] || mode.beginScope._wrap);
+ modeBuffer = "";
+ } else if (mode.beginScope._multi) {
+ // at this point modeBuffer should just be the match
+ emitMultiClass(mode.beginScope, match);
+ modeBuffer = "";
+ }
+ }
+
+ top = Object.create(mode, { parent: { value: top } });
+ return top;
+ }
+
+ /**
+ * @param {CompiledMode } mode - the mode to potentially end
+ * @param {RegExpMatchArray} match - the latest match
+ * @param {string} matchPlusRemainder - match plus remainder of content
+ * @returns {CompiledMode | void} - the next mode, or if void continue on in current mode
+ */
+ function endOfMode(mode, match, matchPlusRemainder) {
+ let matched = startsWith(mode.endRe, matchPlusRemainder);
+
+ if (matched) {
+ if (mode["on:end"]) {
+ const resp = new Response(mode);
+ mode["on:end"](match, resp);
+ if (resp.isMatchIgnored) matched = false;
+ }
+
+ if (matched) {
+ while (mode.endsParent && mode.parent) {
+ mode = mode.parent;
+ }
+ return mode;
+ }
+ }
+ // even if on:end fires an `ignore` it's still possible
+ // that we might trigger the end node because of a parent mode
+ if (mode.endsWithParent) {
+ return endOfMode(mode.parent, match, matchPlusRemainder);
+ }
+ }
+
+ /**
+ * Handle matching but then ignoring a sequence of text
+ *
+ * @param {string} lexeme - string containing full match text
+ */
+ function doIgnore(lexeme) {
+ if (top.matcher.regexIndex === 0) {
+ // no more regexes to potentially match here, so we move the cursor forward one
+ // space
+ modeBuffer += lexeme[0];
+ return 1;
+ } else {
+ // no need to move the cursor, we still have additional regexes to try and
+ // match at this very spot
+ resumeScanAtSamePosition = true;
+ return 0;
+ }
+ }
+
+ /**
+ * Handle the start of a new potential mode match
+ *
+ * @param {EnhancedMatch} match - the current match
+ * @returns {number} how far to advance the parse cursor
+ */
+ function doBeginMatch(match) {
+ const lexeme = match[0];
+ const newMode = match.rule;
+
+ const resp = new Response(newMode);
+ // first internal before callbacks, then the public ones
+ const beforeCallbacks = [newMode.__beforeBegin, newMode["on:begin"]];
+ for (const cb of beforeCallbacks) {
+ if (!cb) continue;
+ cb(match, resp);
+ if (resp.isMatchIgnored) return doIgnore(lexeme);
+ }
+
+ if (newMode.skip) {
+ modeBuffer += lexeme;
+ } else {
+ if (newMode.excludeBegin) {
+ modeBuffer += lexeme;
+ }
+ processBuffer();
+ if (!newMode.returnBegin && !newMode.excludeBegin) {
+ modeBuffer = lexeme;
+ }
+ }
+ startNewMode(newMode, match);
+ return newMode.returnBegin ? 0 : lexeme.length;
+ }
+
+ /**
+ * Handle the potential end of mode
+ *
+ * @param {RegExpMatchArray} match - the current match
+ */
+ function doEndMatch(match) {
+ const lexeme = match[0];
+ const matchPlusRemainder = codeToHighlight.substring(match.index);
+
+ const endMode = endOfMode(top, match, matchPlusRemainder);
+ if (!endMode) { return NO_MATCH; }
+
+ const origin = top;
+ if (top.endScope && top.endScope._wrap) {
+ processBuffer();
+ emitKeyword(lexeme, top.endScope._wrap);
+ } else if (top.endScope && top.endScope._multi) {
+ processBuffer();
+ emitMultiClass(top.endScope, match);
+ } else if (origin.skip) {
+ modeBuffer += lexeme;
+ } else {
+ if (!(origin.returnEnd || origin.excludeEnd)) {
+ modeBuffer += lexeme;
+ }
+ processBuffer();
+ if (origin.excludeEnd) {
+ modeBuffer = lexeme;
+ }
+ }
+ do {
+ if (top.scope) {
+ emitter.closeNode();
+ }
+ if (!top.skip && !top.subLanguage) {
+ relevance += top.relevance;
+ }
+ top = top.parent;
+ } while (top !== endMode.parent);
+ if (endMode.starts) {
+ startNewMode(endMode.starts, match);
+ }
+ return origin.returnEnd ? 0 : lexeme.length;
+ }
+
+ function processContinuations() {
+ const list = [];
+ for (let current = top; current !== language; current = current.parent) {
+ if (current.scope) {
+ list.unshift(current.scope);
+ }
+ }
+ list.forEach(item => emitter.openNode(item));
+ }
+
+ /** @type {{type?: MatchType, index?: number, rule?: Mode}}} */
+ let lastMatch = {};
+
+ /**
+ * Process an individual match
+ *
+ * @param {string} textBeforeMatch - text preceding the match (since the last match)
+ * @param {EnhancedMatch} [match] - the match itself
+ */
+ function processLexeme(textBeforeMatch, match) {
+ const lexeme = match && match[0];
+
+ // add non-matched text to the current mode buffer
+ modeBuffer += textBeforeMatch;
+
+ if (lexeme == null) {
+ processBuffer();
+ return 0;
+ }
+
+ // we've found a 0 width match and we're stuck, so we need to advance
+ // this happens when we have badly behaved rules that have optional matchers to the degree that
+ // sometimes they can end up matching nothing at all
+ // Ref: https://github.com/highlightjs/highlight.js/issues/2140
+ if (lastMatch.type === "begin" && match.type === "end" && lastMatch.index === match.index && lexeme === "") {
+ // spit the "skipped" character that our regex choked on back into the output sequence
+ modeBuffer += codeToHighlight.slice(match.index, match.index + 1);
+ if (!SAFE_MODE) {
+ /** @type {AnnotatedError} */
+ const err = new Error(`0 width match regex (${languageName})`);
+ err.languageName = languageName;
+ err.badRule = lastMatch.rule;
+ throw err;
+ }
+ return 1;
+ }
+ lastMatch = match;
+
+ if (match.type === "begin") {
+ return doBeginMatch(match);
+ } else if (match.type === "illegal" && !ignoreIllegals) {
+ // illegal match, we do not continue processing
+ /** @type {AnnotatedError} */
+ const err = new Error('Illegal lexeme "' + lexeme + '" for mode "' + (top.scope || '<unnamed>') + '"');
+ err.mode = top;
+ throw err;
+ } else if (match.type === "end") {
+ const processed = doEndMatch(match);
+ if (processed !== NO_MATCH) {
+ return processed;
+ }
+ }
+
+ // edge case for when illegal matches $ (end of line) which is technically
+ // a 0 width match but not a begin/end match so it's not caught by the
+ // first handler (when ignoreIllegals is true)
+ if (match.type === "illegal" && lexeme === "") {
+ // advance so we aren't stuck in an infinite loop
+ return 1;
+ }
+
+ // infinite loops are BAD, this is a last ditch catch all. if we have a
+ // decent number of iterations yet our index (cursor position in our
+ // parsing) still 3x behind our index then something is very wrong
+ // so we bail
+ if (iterations > 100000 && iterations > match.index * 3) {
+ const err = new Error('potential infinite loop, way more iterations than matches');
+ throw err;
+ }
+
+ /*
+ Why might be find ourselves here? An potential end match that was
+ triggered but could not be completed. IE, `doEndMatch` returned NO_MATCH.
+ (this could be because a callback requests the match be ignored, etc)
+
+ This causes no real harm other than stopping a few times too many.
+ */
+
+ modeBuffer += lexeme;
+ return lexeme.length;
+ }
+
+ const language = getLanguage(languageName);
+ if (!language) {
+ error(LANGUAGE_NOT_FOUND.replace("{}", languageName));
+ throw new Error('Unknown language: "' + languageName + '"');
+ }
+
+ const md = compileLanguage(language);
+ let result = '';
+ /** @type {CompiledMode} */
+ let top = continuation || md;
+ /** @type Record<string,CompiledMode> */
+ const continuations = {}; // keep continuations for sub-languages
+ const emitter = new options.__emitter(options);
+ processContinuations();
+ let modeBuffer = '';
+ let relevance = 0;
+ let index = 0;
+ let iterations = 0;
+ let resumeScanAtSamePosition = false;
+
+ try {
+ if (!language.__emitTokens) {
+ top.matcher.considerAll();
+
+ for (;;) {
+ iterations++;
+ if (resumeScanAtSamePosition) {
+ // only regexes not matched previously will now be
+ // considered for a potential match
+ resumeScanAtSamePosition = false;
+ } else {
+ top.matcher.considerAll();
+ }
+ top.matcher.lastIndex = index;
+
+ const match = top.matcher.exec(codeToHighlight);
+ // console.log("match", match[0], match.rule && match.rule.begin)
+
+ if (!match) break;
+
+ const beforeMatch = codeToHighlight.substring(index, match.index);
+ const processedCount = processLexeme(beforeMatch, match);
+ index = match.index + processedCount;
+ }
+ processLexeme(codeToHighlight.substring(index));
+ } else {
+ language.__emitTokens(codeToHighlight, emitter);
+ }
+
+ emitter.finalize();
+ result = emitter.toHTML();
+
+ return {
+ language: languageName,
+ value: result,
+ relevance,
+ illegal: false,
+ _emitter: emitter,
+ _top: top
+ };
+ } catch (err) {
+ if (err.message && err.message.includes('Illegal')) {
+ return {
+ language: languageName,
+ value: escape(codeToHighlight),
+ illegal: true,
+ relevance: 0,
+ _illegalBy: {
+ message: err.message,
+ index,
+ context: codeToHighlight.slice(index - 100, index + 100),
+ mode: err.mode,
+ resultSoFar: result
+ },
+ _emitter: emitter
+ };
+ } else if (SAFE_MODE) {
+ return {
+ language: languageName,
+ value: escape(codeToHighlight),
+ illegal: false,
+ relevance: 0,
+ errorRaised: err,
+ _emitter: emitter,
+ _top: top
+ };
+ } else {
+ throw err;
+ }
+ }
+ }
+
+ /**
+ * returns a valid highlight result, without actually doing any actual work,
+ * auto highlight starts with this and it's possible for small snippets that
+ * auto-detection may not find a better match
+ * @param {string} code
+ * @returns {HighlightResult}
+ */
+ function justTextHighlightResult(code) {
+ const result = {
+ value: escape(code),
+ illegal: false,
+ relevance: 0,
+ _top: PLAINTEXT_LANGUAGE,
+ _emitter: new options.__emitter(options)
+ };
+ result._emitter.addText(code);
+ return result;
+ }
+
+ /**
+ Highlighting with language detection. Accepts a string with the code to
+ highlight. Returns an object with the following properties:
+
+ - language (detected language)
+ - relevance (int)
+ - value (an HTML string with highlighting markup)
+ - secondBest (object with the same structure for second-best heuristically
+ detected language, may be absent)
+
+ @param {string} code
+ @param {Array<string>} [languageSubset]
+ @returns {AutoHighlightResult}
+ */
+ function highlightAuto(code, languageSubset) {
+ languageSubset = languageSubset || options.languages || Object.keys(languages);
+ const plaintext = justTextHighlightResult(code);
+
+ const results = languageSubset.filter(getLanguage).filter(autoDetection).map(name =>
+ _highlight(name, code, false)
+ );
+ results.unshift(plaintext); // plaintext is always an option
+
+ const sorted = results.sort((a, b) => {
+ // sort base on relevance
+ if (a.relevance !== b.relevance) return b.relevance - a.relevance;
+
+ // always award the tie to the base language
+ // ie if C++ and Arduino are tied, it's more likely to be C++
+ if (a.language && b.language) {
+ if (getLanguage(a.language).supersetOf === b.language) {
+ return 1;
+ } else if (getLanguage(b.language).supersetOf === a.language) {
+ return -1;
+ }
+ }
+
+ // otherwise say they are equal, which has the effect of sorting on
+ // relevance while preserving the original ordering - which is how ties
+ // have historically been settled, ie the language that comes first always
+ // wins in the case of a tie
+ return 0;
+ });
+
+ const [best, secondBest] = sorted;
+
+ /** @type {AutoHighlightResult} */
+ const result = best;
+ result.secondBest = secondBest;
+
+ return result;
+ }
+
+ /**
+ * Builds new class name for block given the language name
+ *
+ * @param {HTMLElement} element
+ * @param {string} [currentLang]
+ * @param {string} [resultLang]
+ */
+ function updateClassName(element, currentLang, resultLang) {
+ const language = (currentLang && aliases[currentLang]) || resultLang;
+
+ element.classList.add("hljs");
+ element.classList.add(`language-${language}`);
+ }
+
+ /**
+ * Applies highlighting to a DOM node containing code.
+ *
+ * @param {HighlightedHTMLElement} element - the HTML element to highlight
+ */
+ function highlightElement(element) {
+ /** @type HTMLElement */
+ let node = null;
+ const language = blockLanguage(element);
+
+ if (shouldNotHighlight(language)) return;
+
+ fire("before:highlightElement",
+ { el: element, language });
+
+ if (element.dataset.highlighted) {
+ console.log("Element previously highlighted. To highlight again, first unset `dataset.highlighted`.", element);
+ return;
+ }
+
+ // we should be all text, no child nodes (unescaped HTML) - this is possibly
+ // an HTML injection attack - it's likely too late if this is already in
+ // production (the code has likely already done its damage by the time
+ // we're seeing it)... but we yell loudly about this so that hopefully it's
+ // more likely to be caught in development before making it to production
+ if (element.children.length > 0) {
+ if (!options.ignoreUnescapedHTML) {
+ console.warn("One of your code blocks includes unescaped HTML. This is a potentially serious security risk.");
+ console.warn("https://github.com/highlightjs/highlight.js/wiki/security");
+ console.warn("The element with unescaped HTML:");
+ console.warn(element);
+ }
+ if (options.throwUnescapedHTML) {
+ const err = new HTMLInjectionError(
+ "One of your code blocks includes unescaped HTML.",
+ element.innerHTML
+ );
+ throw err;
+ }
+ }
+
+ node = element;
+ const text = node.textContent;
+ const result = language ? highlight(text, { language, ignoreIllegals: true }) : highlightAuto(text);
+
+ element.innerHTML = result.value;
+ element.dataset.highlighted = "yes";
+ updateClassName(element, language, result.language);
+ element.result = {
+ language: result.language,
+ // TODO: remove with version 11.0
+ re: result.relevance,
+ relevance: result.relevance
+ };
+ if (result.secondBest) {
+ element.secondBest = {
+ language: result.secondBest.language,
+ relevance: result.secondBest.relevance
+ };
+ }
+
+ fire("after:highlightElement", { el: element, result, text });
+ }
+
+ /**
+ * Updates highlight.js global options with the passed options
+ *
+ * @param {Partial<HLJSOptions>} userOptions
+ */
+ function configure(userOptions) {
+ options = inherit(options, userOptions);
+ }
+
+ // TODO: remove v12, deprecated
+ const initHighlighting = () => {
+ highlightAll();
+ deprecated("10.6.0", "initHighlighting() deprecated. Use highlightAll() now.");
+ };
+
+ // TODO: remove v12, deprecated
+ function initHighlightingOnLoad() {
+ highlightAll();
+ deprecated("10.6.0", "initHighlightingOnLoad() deprecated. Use highlightAll() now.");
+ }
+
+ let wantsHighlight = false;
+
+ /**
+ * auto-highlights all pre>code elements on the page
+ */
+ function highlightAll() {
+ // if we are called too early in the loading process
+ if (document.readyState === "loading") {
+ wantsHighlight = true;
+ return;
+ }
+
+ const blocks = document.querySelectorAll(options.cssSelector);
+ blocks.forEach(highlightElement);
+ }
+
+ function boot() {
+ // if a highlight was requested before DOM was loaded, do now
+ if (wantsHighlight) highlightAll();
+ }
+
+ // make sure we are in the browser environment
+ if (typeof window !== 'undefined' && window.addEventListener) {
+ window.addEventListener('DOMContentLoaded', boot, false);
+ }
+
+ /**
+ * Register a language grammar module
+ *
+ * @param {string} languageName
+ * @param {LanguageFn} languageDefinition
+ */
+ function registerLanguage(languageName, languageDefinition) {
+ let lang = null;
+ try {
+ lang = languageDefinition(hljs);
+ } catch (error$1) {
+ error("Language definition for '{}' could not be registered.".replace("{}", languageName));
+ // hard or soft error
+ if (!SAFE_MODE) { throw error$1; } else { error(error$1); }
+ // languages that have serious errors are replaced with essentially a
+ // "plaintext" stand-in so that the code blocks will still get normal
+ // css classes applied to them - and one bad language won't break the
+ // entire highlighter
+ lang = PLAINTEXT_LANGUAGE;
+ }
+ // give it a temporary name if it doesn't have one in the meta-data
+ if (!lang.name) lang.name = languageName;
+ languages[languageName] = lang;
+ lang.rawDefinition = languageDefinition.bind(null, hljs);
+
+ if (lang.aliases) {
+ registerAliases(lang.aliases, { languageName });
+ }
+ }
+
+ /**
+ * Remove a language grammar module
+ *
+ * @param {string} languageName
+ */
+ function unregisterLanguage(languageName) {
+ delete languages[languageName];
+ for (const alias of Object.keys(aliases)) {
+ if (aliases[alias] === languageName) {
+ delete aliases[alias];
+ }
+ }
+ }
+
+ /**
+ * @returns {string[]} List of language internal names
+ */
+ function listLanguages() {
+ return Object.keys(languages);
+ }
+
+ /**
+ * @param {string} name - name of the language to retrieve
+ * @returns {Language | undefined}
+ */
+ function getLanguage(name) {
+ name = (name || '').toLowerCase();
+ return languages[name] || languages[aliases[name]];
+ }
+
+ /**
+ *
+ * @param {string|string[]} aliasList - single alias or list of aliases
+ * @param {{languageName: string}} opts
+ */
+ function registerAliases(aliasList, { languageName }) {
+ if (typeof aliasList === 'string') {
+ aliasList = [aliasList];
+ }
+ aliasList.forEach(alias => { aliases[alias.toLowerCase()] = languageName; });
+ }
+
+ /**
+ * Determines if a given language has auto-detection enabled
+ * @param {string} name - name of the language
+ */
+ function autoDetection(name) {
+ const lang = getLanguage(name);
+ return lang && !lang.disableAutodetect;
+ }
+
+ /**
+ * Upgrades the old highlightBlock plugins to the new
+ * highlightElement API
+ * @param {HLJSPlugin} plugin
+ */
+ function upgradePluginAPI(plugin) {
+ // TODO: remove with v12
+ if (plugin["before:highlightBlock"] && !plugin["before:highlightElement"]) {
+ plugin["before:highlightElement"] = (data) => {
+ plugin["before:highlightBlock"](
+ Object.assign({ block: data.el }, data)
+ );
+ };
+ }
+ if (plugin["after:highlightBlock"] && !plugin["after:highlightElement"]) {
+ plugin["after:highlightElement"] = (data) => {
+ plugin["after:highlightBlock"](
+ Object.assign({ block: data.el }, data)
+ );
+ };
+ }
+ }
+
+ /**
+ * @param {HLJSPlugin} plugin
+ */
+ function addPlugin(plugin) {
+ upgradePluginAPI(plugin);
+ plugins.push(plugin);
+ }
+
+ /**
+ * @param {HLJSPlugin} plugin
+ */
+ function removePlugin(plugin) {
+ const index = plugins.indexOf(plugin);
+ if (index !== -1) {
+ plugins.splice(index, 1);
+ }
+ }
+
+ /**
+ *
+ * @param {PluginEvent} event
+ * @param {any} args
+ */
+ function fire(event, args) {
+ const cb = event;
+ plugins.forEach(function(plugin) {
+ if (plugin[cb]) {
+ plugin[cb](args);
+ }
+ });
+ }
+
+ /**
+ * DEPRECATED
+ * @param {HighlightedHTMLElement} el
+ */
+ function deprecateHighlightBlock(el) {
+ deprecated("10.7.0", "highlightBlock will be removed entirely in v12.0");
+ deprecated("10.7.0", "Please use highlightElement now.");
+
+ return highlightElement(el);
+ }
+
+ /* Interface definition */
+ Object.assign(hljs, {
+ highlight,
+ highlightAuto,
+ highlightAll,
+ highlightElement,
+ // TODO: Remove with v12 API
+ highlightBlock: deprecateHighlightBlock,
+ configure,
+ initHighlighting,
+ initHighlightingOnLoad,
+ registerLanguage,
+ unregisterLanguage,
+ listLanguages,
+ getLanguage,
+ registerAliases,
+ autoDetection,
+ inherit,
+ addPlugin,
+ removePlugin
+ });
+
+ hljs.debugMode = function() { SAFE_MODE = false; };
+ hljs.safeMode = function() { SAFE_MODE = true; };
+ hljs.versionString = version;
+
+ hljs.regex = {
+ concat: concat,
+ lookahead: lookahead,
+ either: either,
+ optional: optional,
+ anyNumberOfTimes: anyNumberOfTimes
+ };
+
+ for (const key in MODES) {
+ // @ts-ignore
+ if (typeof MODES[key] === "object") {
+ // @ts-ignore
+ deepFreeze(MODES[key]);
+ }
+ }
+
+ // merge all the modes/regexes into our main object
+ Object.assign(hljs, MODES);
+
+ return hljs;
+ };
+
+ // Other names for the variable may break build script
+ const highlight = HLJS({});
+
+ // returns a new instance of the highlighter to be used for extensions
+ // check https://github.com/wooorm/lowlight/issues/47
+ highlight.newInstance = () => HLJS({});
+
+ return highlight;
+
+})();
+if (typeof exports === 'object' && typeof module !== 'undefined') { module.exports = hljs; }
+/*! `bash` grammar compiled for Highlight.js 11.10.0 */
+ (function(){
+ var hljsGrammar = (function () {
+ 'use strict';
+
+ /*
+ Language: Bash
+ Author: vah <va...@gmail.com>
+ Contributrors: Benjamin Pannell <co...@sierrasoftworks.com>
+ Website: https://www.gnu.org/software/bash/
+ Category: common, scripting
+ */
+
+ /** @type LanguageFn */
+ function bash(hljs) {
+ const regex = hljs.regex;
+ const VAR = {};
+ const BRACED_VAR = {
+ begin: /\$\{/,
+ end: /\}/,
+ contains: [
+ "self",
+ {
+ begin: /:-/,
+ contains: [ VAR ]
+ } // default values
+ ]
+ };
+ Object.assign(VAR, {
+ className: 'variable',
+ variants: [
+ { begin: regex.concat(/\$[\w\d#@][\w\d_]*/,
+ // negative look-ahead tries to avoid matching patterns that are not
+ // Perl at all like $ident$, @ident@, etc.
+ `(?![\\w\\d])(?![$])`) },
+ BRACED_VAR
+ ]
+ });
+
+ const SUBST = {
+ className: 'subst',
+ begin: /\$\(/,
+ end: /\)/,
+ contains: [ hljs.BACKSLASH_ESCAPE ]
+ };
+ const COMMENT = hljs.inherit(
+ hljs.COMMENT(),
+ {
+ match: [
+ /(^|\s)/,
+ /#.*$/
+ ],
+ scope: {
+ 2: 'comment'
+ }
+ }
+ );
+ const HERE_DOC = {
+ begin: /<<-?\s*(?=\w+)/,
+ starts: { contains: [
+ hljs.END_SAME_AS_BEGIN({
+ begin: /(\w+)/,
+ end: /(\w+)/,
+ className: 'string'
+ })
+ ] }
+ };
+ const QUOTE_STRING = {
+ className: 'string',
+ begin: /"/,
+ end: /"/,
+ contains: [
+ hljs.BACKSLASH_ESCAPE,
+ VAR,
+ SUBST
+ ]
+ };
+ SUBST.contains.push(QUOTE_STRING);
+ const ESCAPED_QUOTE = {
+ match: /\\"/
+ };
+ const APOS_STRING = {
+ className: 'string',
+ begin: /'/,
+ end: /'/
+ };
+ const ESCAPED_APOS = {
+ match: /\\'/
+ };
+ const ARITHMETIC = {
+ begin: /\$?\(\(/,
+ end: /\)\)/,
+ contains: [
+ {
+ begin: /\d+#[0-9a-f]+/,
+ className: "number"
+ },
+ hljs.NUMBER_MODE,
+ VAR
+ ]
+ };
+ const SH_LIKE_SHELLS = [
+ "fish",
+ "bash",
+ "zsh",
+ "sh",
+ "csh",
+ "ksh",
+ "tcsh",
+ "dash",
+ "scsh",
+ ];
+ const KNOWN_SHEBANG = hljs.SHEBANG({
+ binary: `(${SH_LIKE_SHELLS.join("|")})`,
+ relevance: 10
+ });
+ const FUNCTION = {
+ className: 'function',
+ begin: /\w[\w\d_]*\s*\(\s*\)\s*\{/,
+ returnBegin: true,
+ contains: [ hljs.inherit(hljs.TITLE_MODE, { begin: /\w[\w\d_]*/ }) ],
+ relevance: 0
+ };
+
+ const KEYWORDS = [
+ "if",
+ "then",
+ "else",
+ "elif",
+ "fi",
+ "for",
+ "while",
+ "until",
+ "in",
+ "do",
+ "done",
+ "case",
+ "esac",
+ "function",
+ "select"
+ ];
+
+ const LITERALS = [
+ "true",
+ "false"
+ ];
+
+ // to consume paths to prevent keyword matches inside them
+ const PATH_MODE = { match: /(\/[a-z._-]+)+/ };
+
+ // http://www.gnu.org/software/bash/manual/html_node/Shell-Builtin-Commands.html
+ const SHELL_BUILT_INS = [
+ "break",
+ "cd",
+ "continue",
+ "eval",
+ "exec",
+ "exit",
+ "export",
+ "getopts",
+ "hash",
+ "pwd",
+ "readonly",
+ "return",
+ "shift",
+ "test",
+ "times",
+ "trap",
+ "umask",
+ "unset"
+ ];
+
+ const BASH_BUILT_INS = [
+ "alias",
+ "bind",
+ "builtin",
+ "caller",
+ "command",
+ "declare",
+ "echo",
+ "enable",
+ "help",
+ "let",
+ "local",
+ "logout",
+ "mapfile",
+ "printf",
+ "read",
+ "readarray",
+ "source",
+ "sudo",
+ "type",
+ "typeset",
+ "ulimit",
+ "unalias"
+ ];
+
+ const ZSH_BUILT_INS = [
+ "autoload",
+ "bg",
+ "bindkey",
+ "bye",
+ "cap",
+ "chdir",
+ "clone",
+ "comparguments",
+ "compcall",
+ "compctl",
+ "compdescribe",
+ "compfiles",
+ "compgroups",
+ "compquote",
+ "comptags",
+ "comptry",
+ "compvalues",
+ "dirs",
+ "disable",
+ "disown",
+ "echotc",
+ "echoti",
+ "emulate",
+ "fc",
+ "fg",
+ "float",
+ "functions",
+ "getcap",
+ "getln",
+ "history",
+ "integer",
+ "jobs",
+ "kill",
+ "limit",
+ "log",
+ "noglob",
+ "popd",
+ "print",
+ "pushd",
+ "pushln",
+ "rehash",
+ "sched",
+ "setcap",
+ "setopt",
+ "stat",
+ "suspend",
+ "ttyctl",
+ "unfunction",
+ "unhash",
+ "unlimit",
+ "unsetopt",
+ "vared",
+ "wait",
+ "whence",
+ "where",
+ "which",
+ "zcompile",
+ "zformat",
+ "zftp",
+ "zle",
+ "zmodload",
+ "zparseopts",
+ "zprof",
+ "zpty",
+ "zregexparse",
+ "zsocket",
+ "zstyle",
+ "ztcp"
+ ];
+
+ const GNU_CORE_UTILS = [
+ "chcon",
+ "chgrp",
+ "chown",
+ "chmod",
+ "cp",
+ "dd",
+ "df",
+ "dir",
+ "dircolors",
+ "ln",
+ "ls",
+ "mkdir",
+ "mkfifo",
+ "mknod",
+ "mktemp",
+ "mv",
+ "realpath",
+ "rm",
+ "rmdir",
+ "shred",
+ "sync",
+ "touch",
+ "truncate",
+ "vdir",
+ "b2sum",
+ "base32",
+ "base64",
+ "cat",
+ "cksum",
+ "comm",
+ "csplit",
+ "cut",
+ "expand",
+ "fmt",
+ "fold",
+ "head",
+ "join",
+ "md5sum",
+ "nl",
+ "numfmt",
+ "od",
+ "paste",
+ "ptx",
+ "pr",
+ "sha1sum",
+ "sha224sum",
+ "sha256sum",
+ "sha384sum",
+ "sha512sum",
+ "shuf",
+ "sort",
+ "split",
+ "sum",
+ "tac",
+ "tail",
+ "tr",
+ "tsort",
+ "unexpand",
+ "uniq",
+ "wc",
+ "arch",
+ "basename",
+ "chroot",
+ "date",
+ "dirname",
+ "du",
+ "echo",
+ "env",
+ "expr",
+ "factor",
+ // "false", // keyword literal already
+ "groups",
+ "hostid",
+ "id",
+ "link",
+ "logname",
+ "nice",
+ "nohup",
+ "nproc",
+ "pathchk",
+ "pinky",
+ "printenv",
+ "printf",
+ "pwd",
+ "readlink",
+ "runcon",
+ "seq",
+ "sleep",
+ "stat",
+ "stdbuf",
+ "stty",
+ "tee",
+ "test",
+ "timeout",
+ // "true", // keyword literal already
+ "tty",
+ "uname",
+ "unlink",
+ "uptime",
+ "users",
+ "who",
+ "whoami",
+ "yes"
+ ];
+
+ return {
+ name: 'Bash',
+ aliases: [
+ 'sh',
+ 'zsh'
+ ],
+ keywords: {
+ $pattern: /\b[a-z][a-z0-9._-]+\b/,
+ keyword: KEYWORDS,
+ literal: LITERALS,
+ built_in: [
+ ...SHELL_BUILT_INS,
+ ...BASH_BUILT_INS,
+ // Shell modifiers
+ "set",
+ "shopt",
+ ...ZSH_BUILT_INS,
+ ...GNU_CORE_UTILS
+ ]
+ },
+ contains: [
+ KNOWN_SHEBANG, // to catch known shells and boost relevancy
+ hljs.SHEBANG(), // to catch unknown shells but still highlight the shebang
+ FUNCTION,
+ ARITHMETIC,
+ COMMENT,
+ HERE_DOC,
+ PATH_MODE,
+ QUOTE_STRING,
+ ESCAPED_QUOTE,
+ APOS_STRING,
+ ESCAPED_APOS,
+ VAR
+ ]
+ };
+ }
+
+ return bash;
+
+})();
+
+ hljs.registerLanguage('bash', hljsGrammar);
+ })();/*! `c` grammar compiled for Highlight.js 11.10.0 */
+ (function(){
+ var hljsGrammar = (function () {
+ 'use strict';
+
+ /*
+ Language: C
+ Category: common, system
+ Website: https://en.wikipedia.org/wiki/C_(programming_language)
+ */
+
+ /** @type LanguageFn */
+ function c(hljs) {
+ const regex = hljs.regex;
+ // added for historic reasons because `hljs.C_LINE_COMMENT_MODE` does
+ // not include such support nor can we be sure all the grammars depending
+ // on it would desire this behavior
+ const C_LINE_COMMENT_MODE = hljs.COMMENT('//', '$', { contains: [ { begin: /\\\n/ } ] });
+ const DECLTYPE_AUTO_RE = 'decltype\\(auto\\)';
+ const NAMESPACE_RE = '[a-zA-Z_]\\w*::';
+ const TEMPLATE_ARGUMENT_RE = '<[^<>]+>';
+ const FUNCTION_TYPE_RE = '('
+ + DECLTYPE_AUTO_RE + '|'
+ + regex.optional(NAMESPACE_RE)
+ + '[a-zA-Z_]\\w*' + regex.optional(TEMPLATE_ARGUMENT_RE)
+ + ')';
+
+
+ const TYPES = {
+ className: 'type',
+ variants: [
+ { begin: '\\b[a-z\\d_]*_t\\b' },
+ { match: /\batomic_[a-z]{3,6}\b/ }
+ ]
+
+ };
+
+ // https://en.cppreference.com/w/cpp/language/escape
+ // \\ \x \xFF \u2837 \u00323747 \374
+ const CHARACTER_ESCAPES = '\\\\(x[0-9A-Fa-f]{2}|u[0-9A-Fa-f]{4,8}|[0-7]{3}|\\S)';
+ const STRINGS = {
+ className: 'string',
+ variants: [
+ {
+ begin: '(u8?|U|L)?"',
+ end: '"',
+ illegal: '\\n',
+ contains: [ hljs.BACKSLASH_ESCAPE ]
+ },
+ {
+ begin: '(u8?|U|L)?\'(' + CHARACTER_ESCAPES + "|.)",
+ end: '\'',
+ illegal: '.'
+ },
+ hljs.END_SAME_AS_BEGIN({
+ begin: /(?:u8?|U|L)?R"([^()\\ ]{0,16})\(/,
+ end: /\)([^()\\ ]{0,16})"/
+ })
+ ]
+ };
+
+ const NUMBERS = {
+ className: 'number',
+ variants: [
+ { begin: '\\b(0b[01\']+)' },
+ { begin: '(-?)\\b([\\d\']+(\\.[\\d\']*)?|\\.[\\d\']+)((ll|LL|l|L)(u|U)?|(u|U)(ll|LL|l|L)?|f|F|b|B)' },
+ { begin: '(-?)(\\b0[xX][a-fA-F0-9\']+|(\\b[\\d\']+(\\.[\\d\']*)?|\\.[\\d\']+)([eE][-+]?[\\d\']+)?)' }
+ ],
+ relevance: 0
+ };
+
+ const PREPROCESSOR = {
+ className: 'meta',
+ begin: /#\s*[a-z]+\b/,
+ end: /$/,
+ keywords: { keyword:
+ 'if else elif endif define undef warning error line '
+ + 'pragma _Pragma ifdef ifndef elifdef elifndef include' },
+ contains: [
+ {
+ begin: /\\\n/,
+ relevance: 0
+ },
+ hljs.inherit(STRINGS, { className: 'string' }),
+ {
+ className: 'string',
+ begin: /<.*?>/
+ },
+ C_LINE_COMMENT_MODE,
+ hljs.C_BLOCK_COMMENT_MODE
+ ]
+ };
+
+ const TITLE_MODE = {
+ className: 'title',
+ begin: regex.optional(NAMESPACE_RE) + hljs.IDENT_RE,
+ relevance: 0
+ };
+
+ const FUNCTION_TITLE = regex.optional(NAMESPACE_RE) + hljs.IDENT_RE + '\\s*\\(';
+
+ const C_KEYWORDS = [
+ "asm",
+ "auto",
+ "break",
+ "case",
+ "continue",
+ "default",
+ "do",
+ "else",
+ "enum",
+ "extern",
+ "for",
+ "fortran",
+ "goto",
+ "if",
+ "inline",
+ "register",
+ "restrict",
+ "return",
+ "sizeof",
+ "typeof",
+ "typeof_unqual",
+ "struct",
+ "switch",
+ "typedef",
+ "union",
+ "volatile",
+ "while",
+ "_Alignas",
+ "_Alignof",
+ "_Atomic",
+ "_Generic",
+ "_Noreturn",
+ "_Static_assert",
+ "_Thread_local",
+ // aliases
+ "alignas",
+ "alignof",
+ "noreturn",
+ "static_assert",
+ "thread_local",
+ // not a C keyword but is, for all intents and purposes, treated exactly like one.
+ "_Pragma"
+ ];
+
+ const C_TYPES = [
+ "float",
+ "double",
+ "signed",
+ "unsigned",
+ "int",
+ "short",
+ "long",
+ "char",
+ "void",
+ "_Bool",
+ "_BitInt",
+ "_Complex",
+ "_Imaginary",
+ "_Decimal32",
+ "_Decimal64",
+ "_Decimal96",
+ "_Decimal128",
+ "_Decimal64x",
+ "_Decimal128x",
+ "_Float16",
+ "_Float32",
+ "_Float64",
+ "_Float128",
+ "_Float32x",
+ "_Float64x",
+ "_Float128x",
+ // modifiers
+ "const",
+ "static",
+ "constexpr",
+ // aliases
+ "complex",
+ "bool",
+ "imaginary"
+ ];
+
+ const KEYWORDS = {
+ keyword: C_KEYWORDS,
+ type: C_TYPES,
+ literal: 'true false NULL',
+ // TODO: apply hinting work similar to what was done in cpp.js
+ built_in: 'std string wstring cin cout cerr clog stdin stdout stderr stringstream istringstream ostringstream '
+ + 'auto_ptr deque list queue stack vector map set pair bitset multiset multimap unordered_set '
+ + 'unordered_map unordered_multiset unordered_multimap priority_queue make_pair array shared_ptr abort terminate abs acos '
+ + 'asin atan2 atan calloc ceil cosh cos exit exp fabs floor fmod fprintf fputs free frexp '
+ + 'fscanf future isalnum isalpha iscntrl isdigit isgraph islower isprint ispunct isspace isupper '
+ + 'isxdigit tolower toupper labs ldexp log10 log malloc realloc memchr memcmp memcpy memset modf pow '
+ + 'printf putchar puts scanf sinh sin snprintf sprintf sqrt sscanf strcat strchr strcmp '
+ + 'strcpy strcspn strlen strncat strncmp strncpy strpbrk strrchr strspn strstr tanh tan '
+ + 'vfprintf vprintf vsprintf endl initializer_list unique_ptr',
+ };
+
+ const EXPRESSION_CONTAINS = [
+ PREPROCESSOR,
+ TYPES,
+ C_LINE_COMMENT_MODE,
+ hljs.C_BLOCK_COMMENT_MODE,
+ NUMBERS,
+ STRINGS
+ ];
+
+ const EXPRESSION_CONTEXT = {
+ // This mode covers expression context where we can't expect a function
+ // definition and shouldn't highlight anything that looks like one:
+ // `return some()`, `else if()`, `(x*sum(1, 2))`
+ variants: [
+ {
+ begin: /=/,
+ end: /;/
+ },
+ {
+ begin: /\(/,
+ end: /\)/
+ },
+ {
+ beginKeywords: 'new throw return else',
+ end: /;/
+ }
+ ],
+ keywords: KEYWORDS,
+ contains: EXPRESSION_CONTAINS.concat([
+ {
+ begin: /\(/,
+ end: /\)/,
+ keywords: KEYWORDS,
+ contains: EXPRESSION_CONTAINS.concat([ 'self' ]),
+ relevance: 0
+ }
+ ]),
+ relevance: 0
+ };
+
+ const FUNCTION_DECLARATION = {
+ begin: '(' + FUNCTION_TYPE_RE + '[\\*&\\s]+)+' + FUNCTION_TITLE,
+ returnBegin: true,
+ end: /[{;=]/,
+ excludeEnd: true,
+ keywords: KEYWORDS,
+ illegal: /[^\w\s\*&:<>.]/,
+ contains: [
+ { // to prevent it from being confused as the function title
+ begin: DECLTYPE_AUTO_RE,
+ keywords: KEYWORDS,
+ relevance: 0
+ },
+ {
+ begin: FUNCTION_TITLE,
+ returnBegin: true,
+ contains: [ hljs.inherit(TITLE_MODE, { className: "title.function" }) ],
+ relevance: 0
+ },
+ // allow for multiple declarations, e.g.:
+ // extern void f(int), g(char);
+ {
+ relevance: 0,
+ match: /,/
+ },
+ {
+ className: 'params',
+ begin: /\(/,
+ end: /\)/,
+ keywords: KEYWORDS,
+ relevance: 0,
+ contains: [
+ C_LINE_COMMENT_MODE,
+ hljs.C_BLOCK_COMMENT_MODE,
+ STRINGS,
+ NUMBERS,
+ TYPES,
+ // Count matching parentheses.
+ {
+ begin: /\(/,
+ end: /\)/,
+ keywords: KEYWORDS,
+ relevance: 0,
+ contains: [
+ 'self',
+ C_LINE_COMMENT_MODE,
+ hljs.C_BLOCK_COMMENT_MODE,
+ STRINGS,
+ NUMBERS,
+ TYPES
+ ]
+ }
+ ]
+ },
+ TYPES,
+ C_LINE_COMMENT_MODE,
+ hljs.C_BLOCK_COMMENT_MODE,
+ PREPROCESSOR
+ ]
+ };
+
+ return {
+ name: "C",
+ aliases: [ 'h' ],
+ keywords: KEYWORDS,
+ // Until differentiations are added between `c` and `cpp`, `c` will
+ // not be auto-detected to avoid auto-detect conflicts between C and C++
+ disableAutodetect: true,
+ illegal: '</',
+ contains: [].concat(
+ EXPRESSION_CONTEXT,
+ FUNCTION_DECLARATION,
+ EXPRESSION_CONTAINS,
+ [
+ PREPROCESSOR,
+ {
+ begin: hljs.IDENT_RE + '::',
+ keywords: KEYWORDS
+ },
+ {
+ className: 'class',
+ beginKeywords: 'enum class struct union',
+ end: /[{;:<>=]/,
+ contains: [
+ { beginKeywords: "final class struct" },
+ hljs.TITLE_MODE
+ ]
+ }
+ ]),
+ exports: {
+ preprocessor: PREPROCESSOR,
+ strings: STRINGS,
+ keywords: KEYWORDS
+ }
+ };
+ }
+
+ return c;
+
+})();
+
+ hljs.registerLanguage('c', hljsGrammar);
+ })();/*! `cpp` grammar compiled for Highlight.js 11.10.0 */
+ (function(){
+ var hljsGrammar = (function () {
+ 'use strict';
+
+ /*
+ Language: C++
+ Category: common, system
+ Website: https://isocpp.org
+ */
+
+ /** @type LanguageFn */
+ function cpp(hljs) {
+ const regex = hljs.regex;
+ // added for historic reasons because `hljs.C_LINE_COMMENT_MODE` does
+ // not include such support nor can we be sure all the grammars depending
+ // on it would desire this behavior
+ const C_LINE_COMMENT_MODE = hljs.COMMENT('//', '$', { contains: [ { begin: /\\\n/ } ] });
+ const DECLTYPE_AUTO_RE = 'decltype\\(auto\\)';
+ const NAMESPACE_RE = '[a-zA-Z_]\\w*::';
+ const TEMPLATE_ARGUMENT_RE = '<[^<>]+>';
+ const FUNCTION_TYPE_RE = '(?!struct)('
+ + DECLTYPE_AUTO_RE + '|'
+ + regex.optional(NAMESPACE_RE)
+ + '[a-zA-Z_]\\w*' + regex.optional(TEMPLATE_ARGUMENT_RE)
+ + ')';
+
+ const CPP_PRIMITIVE_TYPES = {
+ className: 'type',
+ begin: '\\b[a-z\\d_]*_t\\b'
+ };
+
+ // https://en.cppreference.com/w/cpp/language/escape
+ // \\ \x \xFF \u2837 \u00323747 \374
+ const CHARACTER_ESCAPES = '\\\\(x[0-9A-Fa-f]{2}|u[0-9A-Fa-f]{4,8}|[0-7]{3}|\\S)';
+ const STRINGS = {
+ className: 'string',
+ variants: [
+ {
+ begin: '(u8?|U|L)?"',
+ end: '"',
+ illegal: '\\n',
+ contains: [ hljs.BACKSLASH_ESCAPE ]
+ },
+ {
+ begin: '(u8?|U|L)?\'(' + CHARACTER_ESCAPES + '|.)',
+ end: '\'',
+ illegal: '.'
+ },
+ hljs.END_SAME_AS_BEGIN({
+ begin: /(?:u8?|U|L)?R"([^()\\ ]{0,16})\(/,
+ end: /\)([^()\\ ]{0,16})"/
+ })
+ ]
+ };
+
+ const NUMBERS = {
+ className: 'number',
+ variants: [
+ // Floating-point literal.
+ { begin:
+ "[+-]?(?:" // Leading sign.
+ // Decimal.
+ + "(?:"
+ +"[0-9](?:'?[0-9])*\\.(?:[0-9](?:'?[0-9])*)?"
+ + "|\\.[0-9](?:'?[0-9])*"
+ + ")(?:[Ee][+-]?[0-9](?:'?[0-9])*)?"
+ + "|[0-9](?:'?[0-9])*[Ee][+-]?[0-9](?:'?[0-9])*"
+ // Hexadecimal.
+ + "|0[Xx](?:"
+ +"[0-9A-Fa-f](?:'?[0-9A-Fa-f])*(?:\\.(?:[0-9A-Fa-f](?:'?[0-9A-Fa-f])*)?)?"
+ + "|\\.[0-9A-Fa-f](?:'?[0-9A-Fa-f])*"
+ + ")[Pp][+-]?[0-9](?:'?[0-9])*"
+ + ")(?:" // Literal suffixes.
+ + "[Ff](?:16|32|64|128)?"
+ + "|(BF|bf)16"
+ + "|[Ll]"
+ + "|" // Literal suffix is optional.
+ + ")"
+ },
+ // Integer literal.
+ { begin:
+ "[+-]?\\b(?:" // Leading sign.
+ + "0[Bb][01](?:'?[01])*" // Binary.
+ + "|0[Xx][0-9A-Fa-f](?:'?[0-9A-Fa-f])*" // Hexadecimal.
+ + "|0(?:'?[0-7])*" // Octal or just a lone zero.
+ + "|[1-9](?:'?[0-9])*" // Decimal.
+ + ")(?:" // Literal suffixes.
+ + "[Uu](?:LL?|ll?)"
+ + "|[Uu][Zz]?"
+ + "|(?:LL?|ll?)[Uu]?"
+ + "|[Zz][Uu]"
+ + "|" // Literal suffix is optional.
+ + ")"
+ // Note: there are user-defined literal suffixes too, but perhaps having the custom suffix not part of the
+ // literal highlight actually makes it stand out more.
+ }
+ ],
+ relevance: 0
+ };
+
+ const PREPROCESSOR = {
+ className: 'meta',
+ begin: /#\s*[a-z]+\b/,
+ end: /$/,
+ keywords: { keyword:
+ 'if else elif endif define undef warning error line '
+ + 'pragma _Pragma ifdef ifndef include' },
+ contains: [
+ {
+ begin: /\\\n/,
+ relevance: 0
+ },
+ hljs.inherit(STRINGS, { className: 'string' }),
+ {
+ className: 'string',
+ begin: /<.*?>/
+ },
+ C_LINE_COMMENT_MODE,
+ hljs.C_BLOCK_COMMENT_MODE
+ ]
+ };
+
+ const TITLE_MODE = {
+ className: 'title',
+ begin: regex.optional(NAMESPACE_RE) + hljs.IDENT_RE,
+ relevance: 0
+ };
+
+ const FUNCTION_TITLE = regex.optional(NAMESPACE_RE) + hljs.IDENT_RE + '\\s*\\(';
+
+ // https://en.cppreference.com/w/cpp/keyword
+ const RESERVED_KEYWORDS = [
+ 'alignas',
+ 'alignof',
+ 'and',
+ 'and_eq',
+ 'asm',
+ 'atomic_cancel',
+ 'atomic_commit',
+ 'atomic_noexcept',
+ 'auto',
+ 'bitand',
+ 'bitor',
+ 'break',
+ 'case',
+ 'catch',
+ 'class',
+ 'co_await',
+ 'co_return',
+ 'co_yield',
+ 'compl',
+ 'concept',
+ 'const_cast|10',
+ 'consteval',
+ 'constexpr',
+ 'constinit',
+ 'continue',
+ 'decltype',
+ 'default',
+ 'delete',
+ 'do',
+ 'dynamic_cast|10',
+ 'else',
+ 'enum',
+ 'explicit',
+ 'export',
+ 'extern',
+ 'false',
+ 'final',
+ 'for',
+ 'friend',
+ 'goto',
+ 'if',
+ 'import',
+ 'inline',
+ 'module',
+ 'mutable',
+ 'namespace',
+ 'new',
+ 'noexcept',
+ 'not',
+ 'not_eq',
+ 'nullptr',
+ 'operator',
+ 'or',
+ 'or_eq',
+ 'override',
+ 'private',
+ 'protected',
+ 'public',
+ 'reflexpr',
+ 'register',
+ 'reinterpret_cast|10',
+ 'requires',
+ 'return',
+ 'sizeof',
+ 'static_assert',
+ 'static_cast|10',
+ 'struct',
+ 'switch',
+ 'synchronized',
+ 'template',
+ 'this',
+ 'thread_local',
+ 'throw',
+ 'transaction_safe',
+ 'transaction_safe_dynamic',
+ 'true',
+ 'try',
+ 'typedef',
+ 'typeid',
+ 'typename',
+ 'union',
+ 'using',
+ 'virtual',
+ 'volatile',
+ 'while',
+ 'xor',
+ 'xor_eq'
+ ];
+
+ // https://en.cppreference.com/w/cpp/keyword
+ const RESERVED_TYPES = [
+ 'bool',
+ 'char',
+ 'char16_t',
+ 'char32_t',
+ 'char8_t',
+ 'double',
+ 'float',
+ 'int',
+ 'long',
+ 'short',
+ 'void',
+ 'wchar_t',
+ 'unsigned',
+ 'signed',
+ 'const',
+ 'static'
+ ];
+
+ const TYPE_HINTS = [
+ 'any',
+ 'auto_ptr',
+ 'barrier',
+ 'binary_semaphore',
+ 'bitset',
+ 'complex',
+ 'condition_variable',
+ 'condition_variable_any',
+ 'counting_semaphore',
+ 'deque',
+ 'false_type',
+ 'future',
+ 'imaginary',
+ 'initializer_list',
+ 'istringstream',
+ 'jthread',
+ 'latch',
+ 'lock_guard',
+ 'multimap',
+ 'multiset',
+ 'mutex',
+ 'optional',
+ 'ostringstream',
+ 'packaged_task',
+ 'pair',
+ 'promise',
+ 'priority_queue',
+ 'queue',
+ 'recursive_mutex',
+ 'recursive_timed_mutex',
+ 'scoped_lock',
+ 'set',
+ 'shared_future',
+ 'shared_lock',
+ 'shared_mutex',
+ 'shared_timed_mutex',
+ 'shared_ptr',
+ 'stack',
+ 'string_view',
+ 'stringstream',
+ 'timed_mutex',
+ 'thread',
+ 'true_type',
+ 'tuple',
+ 'unique_lock',
+ 'unique_ptr',
+ 'unordered_map',
+ 'unordered_multimap',
+ 'unordered_multiset',
+ 'unordered_set',
+ 'variant',
+ 'vector',
+ 'weak_ptr',
+ 'wstring',
+ 'wstring_view'
+ ];
+
+ const FUNCTION_HINTS = [
+ 'abort',
+ 'abs',
+ 'acos',
+ 'apply',
+ 'as_const',
+ 'asin',
+ 'atan',
+ 'atan2',
+ 'calloc',
+ 'ceil',
+ 'cerr',
+ 'cin',
+ 'clog',
+ 'cos',
+ 'cosh',
+ 'cout',
+ 'declval',
+ 'endl',
+ 'exchange',
+ 'exit',
+ 'exp',
+ 'fabs',
+ 'floor',
+ 'fmod',
+ 'forward',
+ 'fprintf',
+ 'fputs',
+ 'free',
+ 'frexp',
+ 'fscanf',
+ 'future',
+ 'invoke',
+ 'isalnum',
+ 'isalpha',
+ 'iscntrl',
+ 'isdigit',
+ 'isgraph',
+ 'islower',
+ 'isprint',
+ 'ispunct',
+ 'isspace',
+ 'isupper',
+ 'isxdigit',
+ 'labs',
+ 'launder',
+ 'ldexp',
+ 'log',
+ 'log10',
+ 'make_pair',
+ 'make_shared',
+ 'make_shared_for_overwrite',
+ 'make_tuple',
+ 'make_unique',
+ 'malloc',
+ 'memchr',
+ 'memcmp',
+ 'memcpy',
+ 'memset',
+ 'modf',
+ 'move',
+ 'pow',
+ 'printf',
+ 'putchar',
+ 'puts',
+ 'realloc',
+ 'scanf',
+ 'sin',
+ 'sinh',
+ 'snprintf',
+ 'sprintf',
+ 'sqrt',
+ 'sscanf',
+ 'std',
+ 'stderr',
+ 'stdin',
+ 'stdout',
+ 'strcat',
+ 'strchr',
+ 'strcmp',
+ 'strcpy',
+ 'strcspn',
+ 'strlen',
+ 'strncat',
+ 'strncmp',
+ 'strncpy',
+ 'strpbrk',
+ 'strrchr',
+ 'strspn',
+ 'strstr',
+ 'swap',
+ 'tan',
+ 'tanh',
+ 'terminate',
+ 'to_underlying',
+ 'tolower',
+ 'toupper',
+ 'vfprintf',
+ 'visit',
+ 'vprintf',
+ 'vsprintf'
+ ];
+
+ const LITERALS = [
+ 'NULL',
+ 'false',
+ 'nullopt',
+ 'nullptr',
+ 'true'
+ ];
+
+ // https://en.cppreference.com/w/cpp/keyword
+ const BUILT_IN = [ '_Pragma' ];
+
+ const CPP_KEYWORDS = {
+ type: RESERVED_TYPES,
+ keyword: RESERVED_KEYWORDS,
+ literal: LITERALS,
+ built_in: BUILT_IN,
+ _type_hints: TYPE_HINTS
+ };
+
+ const FUNCTION_DISPATCH = {
+ className: 'function.dispatch',
+ relevance: 0,
+ keywords: {
+ // Only for relevance, not highlighting.
+ _hint: FUNCTION_HINTS },
+ begin: regex.concat(
+ /\b/,
+ /(?!decltype)/,
+ /(?!if)/,
+ /(?!for)/,
+ /(?!switch)/,
+ /(?!while)/,
+ hljs.IDENT_RE,
+ regex.lookahead(/(<[^<>]+>|)\s*\(/))
+ };
+
+ const EXPRESSION_CONTAINS = [
+ FUNCTION_DISPATCH,
+ PREPROCESSOR,
+ CPP_PRIMITIVE_TYPES,
+ C_LINE_COMMENT_MODE,
+ hljs.C_BLOCK_COMMENT_MODE,
+ NUMBERS,
+ STRINGS
+ ];
+
+ const EXPRESSION_CONTEXT = {
+ // This mode covers expression context where we can't expect a function
+ // definition and shouldn't highlight anything that looks like one:
+ // `return some()`, `else if()`, `(x*sum(1, 2))`
+ variants: [
+ {
+ begin: /=/,
+ end: /;/
+ },
+ {
+ begin: /\(/,
+ end: /\)/
+ },
+ {
+ beginKeywords: 'new throw return else',
+ end: /;/
+ }
+ ],
+ keywords: CPP_KEYWORDS,
+ contains: EXPRESSION_CONTAINS.concat([
+ {
+ begin: /\(/,
+ end: /\)/,
+ keywords: CPP_KEYWORDS,
+ contains: EXPRESSION_CONTAINS.concat([ 'self' ]),
+ relevance: 0
+ }
+ ]),
+ relevance: 0
+ };
+
+ const FUNCTION_DECLARATION = {
+ className: 'function',
+ begin: '(' + FUNCTION_TYPE_RE + '[\\*&\\s]+)+' + FUNCTION_TITLE,
+ returnBegin: true,
+ end: /[{;=]/,
+ excludeEnd: true,
+ keywords: CPP_KEYWORDS,
+ illegal: /[^\w\s\*&:<>.]/,
+ contains: [
+ { // to prevent it from being confused as the function title
+ begin: DECLTYPE_AUTO_RE,
+ keywords: CPP_KEYWORDS,
+ relevance: 0
+ },
+ {
+ begin: FUNCTION_TITLE,
+ returnBegin: true,
+ contains: [ TITLE_MODE ],
+ relevance: 0
+ },
+ // needed because we do not have look-behind on the below rule
+ // to prevent it from grabbing the final : in a :: pair
+ {
+ begin: /::/,
+ relevance: 0
+ },
+ // initializers
+ {
+ begin: /:/,
+ endsWithParent: true,
+ contains: [
+ STRINGS,
+ NUMBERS
+ ]
+ },
+ // allow for multiple declarations, e.g.:
+ // extern void f(int), g(char);
+ {
+ relevance: 0,
+ match: /,/
+ },
+ {
+ className: 'params',
+ begin: /\(/,
+ end: /\)/,
+ keywords: CPP_KEYWORDS,
+ relevance: 0,
+ contains: [
+ C_LINE_COMMENT_MODE,
+ hljs.C_BLOCK_COMMENT_MODE,
+ STRINGS,
+ NUMBERS,
+ CPP_PRIMITIVE_TYPES,
+ // Count matching parentheses.
+ {
+ begin: /\(/,
+ end: /\)/,
+ keywords: CPP_KEYWORDS,
+ relevance: 0,
+ contains: [
+ 'self',
+ C_LINE_COMMENT_MODE,
+ hljs.C_BLOCK_COMMENT_MODE,
+ STRINGS,
+ NUMBERS,
+ CPP_PRIMITIVE_TYPES
+ ]
+ }
+ ]
+ },
+ CPP_PRIMITIVE_TYPES,
+ C_LINE_COMMENT_MODE,
+ hljs.C_BLOCK_COMMENT_MODE,
+ PREPROCESSOR
+ ]
+ };
+
+ return {
+ name: 'C++',
+ aliases: [
+ 'cc',
+ 'c++',
+ 'h++',
+ 'hpp',
+ 'hh',
+ 'hxx',
+ 'cxx'
+ ],
+ keywords: CPP_KEYWORDS,
+ illegal: '</',
+ classNameAliases: { 'function.dispatch': 'built_in' },
+ contains: [].concat(
+ EXPRESSION_CONTEXT,
+ FUNCTION_DECLARATION,
+ FUNCTION_DISPATCH,
+ EXPRESSION_CONTAINS,
+ [
+ PREPROCESSOR,
+ { // containers: ie, `vector <int> rooms (9);`
+ begin: '\\b(deque|list|queue|priority_queue|pair|stack|vector|map|set|bitset|multiset|multimap|unordered_map|unordered_set|unordered_multiset|unordered_multimap|array|tuple|optional|variant|function)\\s*<(?!<)',
+ end: '>',
+ keywords: CPP_KEYWORDS,
+ contains: [
+ 'self',
+ CPP_PRIMITIVE_TYPES
+ ]
+ },
+ {
+ begin: hljs.IDENT_RE + '::',
+ keywords: CPP_KEYWORDS
+ },
+ {
+ match: [
+ // extra complexity to deal with `enum class` and `enum struct`
+ /\b(?:enum(?:\s+(?:class|struct))?|class|struct|union)/,
+ /\s+/,
+ /\w+/
+ ],
+ className: {
+ 1: 'keyword',
+ 3: 'title.class'
+ }
+ }
+ ])
+ };
+ }
+
+ return cpp;
+
+})();
+
+ hljs.registerLanguage('cpp', hljsGrammar);
+ })();/*! `csharp` grammar compiled for Highlight.js 11.10.0 */
+ (function(){
+ var hljsGrammar = (function () {
+ 'use strict';
+
+ /*
+ Language: C#
+ Author: Jason Diamond <ja...@diamond.name>
+ Contributor: Nicolas LLOBERA <nl...@gmail.com>, Pieter Vantorre <pi...@gmail.com>, David Pine <da...@microsoft.com>
+ Website: https://docs.microsoft.com/dotnet/csharp/
+ Category: common
+ */
+
+ /** @type LanguageFn */
+ function csharp(hljs) {
+ const BUILT_IN_KEYWORDS = [
+ 'bool',
+ 'byte',
+ 'char',
+ 'decimal',
+ 'delegate',
+ 'double',
+ 'dynamic',
+ 'enum',
+ 'float',
+ 'int',
+ 'long',
+ 'nint',
+ 'nuint',
+ 'object',
+ 'sbyte',
+ 'short',
+ 'string',
+ 'ulong',
+ 'uint',
+ 'ushort'
+ ];
+ const FUNCTION_MODIFIERS = [
+ 'public',
+ 'private',
+ 'protected',
+ 'static',
+ 'internal',
+ 'protected',
+ 'abstract',
+ 'async',
+ 'extern',
+ 'override',
+ 'unsafe',
+ 'virtual',
+ 'new',
+ 'sealed',
+ 'partial'
+ ];
+ const LITERAL_KEYWORDS = [
+ 'default',
+ 'false',
+ 'null',
+ 'true'
+ ];
+ const NORMAL_KEYWORDS = [
+ 'abstract',
+ 'as',
+ 'base',
+ 'break',
+ 'case',
+ 'catch',
+ 'class',
+ 'const',
+ 'continue',
+ 'do',
+ 'else',
+ 'event',
+ 'explicit',
+ 'extern',
+ 'finally',
+ 'fixed',
+ 'for',
+ 'foreach',
+ 'goto',
+ 'if',
+ 'implicit',
+ 'in',
+ 'interface',
+ 'internal',
+ 'is',
+ 'lock',
+ 'namespace',
+ 'new',
+ 'operator',
+ 'out',
+ 'override',
+ 'params',
+ 'private',
+ 'protected',
+ 'public',
+ 'readonly',
+ 'record',
+ 'ref',
+ 'return',
+ 'scoped',
+ 'sealed',
+ 'sizeof',
+ 'stackalloc',
+ 'static',
+ 'struct',
+ 'switch',
+ 'this',
+ 'throw',
+ 'try',
+ 'typeof',
+ 'unchecked',
+ 'unsafe',
+ 'using',
+ 'virtual',
+ 'void',
+ 'volatile',
+ 'while'
+ ];
+ const CONTEXTUAL_KEYWORDS = [
+ 'add',
+ 'alias',
+ 'and',
+ 'ascending',
+ 'async',
+ 'await',
+ 'by',
+ 'descending',
+ 'equals',
+ 'from',
+ 'get',
+ 'global',
+ 'group',
+ 'init',
+ 'into',
+ 'join',
+ 'let',
+ 'nameof',
+ 'not',
+ 'notnull',
+ 'on',
+ 'or',
+ 'orderby',
+ 'partial',
+ 'remove',
+ 'select',
+ 'set',
+ 'unmanaged',
+ 'value|0',
+ 'var',
+ 'when',
+ 'where',
+ 'with',
+ 'yield'
+ ];
+
+ const KEYWORDS = {
+ keyword: NORMAL_KEYWORDS.concat(CONTEXTUAL_KEYWORDS),
+ built_in: BUILT_IN_KEYWORDS,
+ literal: LITERAL_KEYWORDS
+ };
+ const TITLE_MODE = hljs.inherit(hljs.TITLE_MODE, { begin: '[a-zA-Z](\\.?\\w)*' });
+ const NUMBERS = {
+ className: 'number',
+ variants: [
+ { begin: '\\b(0b[01\']+)' },
+ { begin: '(-?)\\b([\\d\']+(\\.[\\d\']*)?|\\.[\\d\']+)(u|U|l|L|ul|UL|f|F|b|B)' },
+ { begin: '(-?)(\\b0[xX][a-fA-F0-9\']+|(\\b[\\d\']+(\\.[\\d\']*)?|\\.[\\d\']+)([eE][-+]?[\\d\']+)?)' }
+ ],
+ relevance: 0
+ };
+ const RAW_STRING = {
+ className: 'string',
+ begin: /"""("*)(?!")(.|\n)*?"""\1/,
+ relevance: 1
+ };
+ const VERBATIM_STRING = {
+ className: 'string',
+ begin: '@"',
+ end: '"',
+ contains: [ { begin: '""' } ]
+ };
+ const VERBATIM_STRING_NO_LF = hljs.inherit(VERBATIM_STRING, { illegal: /\n/ });
+ const SUBST = {
+ className: 'subst',
+ begin: /\{/,
+ end: /\}/,
+ keywords: KEYWORDS
+ };
+ const SUBST_NO_LF = hljs.inherit(SUBST, { illegal: /\n/ });
+ const INTERPOLATED_STRING = {
+ className: 'string',
+ begin: /\$"/,
+ end: '"',
+ illegal: /\n/,
+ contains: [
+ { begin: /\{\{/ },
+ { begin: /\}\}/ },
+ hljs.BACKSLASH_ESCAPE,
+ SUBST_NO_LF
+ ]
+ };
+ const INTERPOLATED_VERBATIM_STRING = {
+ className: 'string',
+ begin: /\$@"/,
+ end: '"',
+ contains: [
+ { begin: /\{\{/ },
+ { begin: /\}\}/ },
+ { begin: '""' },
+ SUBST
+ ]
+ };
+ const INTERPOLATED_VERBATIM_STRING_NO_LF = hljs.inherit(INTERPOLATED_VERBATIM_STRING, {
+ illegal: /\n/,
+ contains: [
+ { begin: /\{\{/ },
+ { begin: /\}\}/ },
+ { begin: '""' },
+ SUBST_NO_LF
+ ]
+ });
+ SUBST.contains = [
+ INTERPOLATED_VERBATIM_STRING,
+ INTERPOLATED_STRING,
+ VERBATIM_STRING,
+ hljs.APOS_STRING_MODE,
+ hljs.QUOTE_STRING_MODE,
+ NUMBERS,
+ hljs.C_BLOCK_COMMENT_MODE
+ ];
+ SUBST_NO_LF.contains = [
+ INTERPOLATED_VERBATIM_STRING_NO_LF,
+ INTERPOLATED_STRING,
+ VERBATIM_STRING_NO_LF,
+ hljs.APOS_STRING_MODE,
+ hljs.QUOTE_STRING_MODE,
+ NUMBERS,
+ hljs.inherit(hljs.C_BLOCK_COMMENT_MODE, { illegal: /\n/ })
+ ];
+ const STRING = { variants: [
+ RAW_STRING,
+ INTERPOLATED_VERBATIM_STRING,
+ INTERPOLATED_STRING,
+ VERBATIM_STRING,
+ hljs.APOS_STRING_MODE,
+ hljs.QUOTE_STRING_MODE
+ ] };
+
+ const GENERIC_MODIFIER = {
+ begin: "<",
+ end: ">",
+ contains: [
+ { beginKeywords: "in out" },
+ TITLE_MODE
+ ]
+ };
+ const TYPE_IDENT_RE = hljs.IDENT_RE + '(<' + hljs.IDENT_RE + '(\\s*,\\s*' + hljs.IDENT_RE + ')*>)?(\\[\\])?';
+ const AT_IDENTIFIER = {
+ // prevents expressions like `@class` from incorrect flagging
+ // `class` as a keyword
+ begin: "@" + hljs.IDENT_RE,
+ relevance: 0
+ };
+
+ return {
+ name: 'C#',
+ aliases: [
+ 'cs',
+ 'c#'
+ ],
+ keywords: KEYWORDS,
+ illegal: /::/,
+ contains: [
+ hljs.COMMENT(
+ '///',
+ '$',
+ {
+ returnBegin: true,
+ contains: [
+ {
+ className: 'doctag',
+ variants: [
+ {
+ begin: '///',
+ relevance: 0
+ },
+ { begin: '<!--|-->' },
+ {
+ begin: '</?',
+ end: '>'
+ }
+ ]
+ }
+ ]
+ }
+ ),
+ hljs.C_LINE_COMMENT_MODE,
+ hljs.C_BLOCK_COMMENT_MODE,
+ {
+ className: 'meta',
+ begin: '#',
+ end: '$',
+ keywords: { keyword: 'if else elif endif define undef warning error line region endregion pragma checksum' }
+ },
+ STRING,
+ NUMBERS,
+ {
+ beginKeywords: 'class interface',
+ relevance: 0,
+ end: /[{;=]/,
+ illegal: /[^\s:,]/,
+ contains: [
+ { beginKeywords: "where class" },
+ TITLE_MODE,
+ GENERIC_MODIFIER,
+ hljs.C_LINE_COMMENT_MODE,
+ hljs.C_BLOCK_COMMENT_MODE
+ ]
+ },
+ {
+ beginKeywords: 'namespace',
+ relevance: 0,
+ end: /[{;=]/,
+ illegal: /[^\s:]/,
+ contains: [
+ TITLE_MODE,
+ hljs.C_LINE_COMMENT_MODE,
+ hljs.C_BLOCK_COMMENT_MODE
+ ]
+ },
+ {
+ beginKeywords: 'record',
+ relevance: 0,
+ end: /[{;=]/,
+ illegal: /[^\s:]/,
+ contains: [
+ TITLE_MODE,
+ GENERIC_MODIFIER,
+ hljs.C_LINE_COMMENT_MODE,
+ hljs.C_BLOCK_COMMENT_MODE
+ ]
+ },
+ {
+ // [Attributes("")]
+ className: 'meta',
+ begin: '^\\s*\\[(?=[\\w])',
+ excludeBegin: true,
+ end: '\\]',
+ excludeEnd: true,
+ contains: [
+ {
+ className: 'string',
+ begin: /"/,
+ end: /"/
+ }
+ ]
+ },
+ {
+ // Expression keywords prevent 'keyword Name(...)' from being
+ // recognized as a function definition
+ beginKeywords: 'new return throw await else',
+ relevance: 0
+ },
+ {
+ className: 'function',
+ begin: '(' + TYPE_IDENT_RE + '\\s+)+' + hljs.IDENT_RE + '\\s*(<[^=]+>\\s*)?\\(',
+ returnBegin: true,
+ end: /\s*[{;=]/,
+ excludeEnd: true,
+ keywords: KEYWORDS,
+ contains: [
+ // prevents these from being highlighted `title`
+ {
+ beginKeywords: FUNCTION_MODIFIERS.join(" "),
+ relevance: 0
+ },
+ {
+ begin: hljs.IDENT_RE + '\\s*(<[^=]+>\\s*)?\\(',
+ returnBegin: true,
+ contains: [
+ hljs.TITLE_MODE,
+ GENERIC_MODIFIER
+ ],
+ relevance: 0
+ },
+ { match: /\(\)/ },
+ {
+ className: 'params',
+ begin: /\(/,
+ end: /\)/,
+ excludeBegin: true,
+ excludeEnd: true,
+ keywords: KEYWORDS,
+ relevance: 0,
+ contains: [
+ STRING,
+ NUMBERS,
+ hljs.C_BLOCK_COMMENT_MODE
+ ]
+ },
+ hljs.C_LINE_COMMENT_MODE,
+ hljs.C_BLOCK_COMMENT_MODE
+ ]
+ },
+ AT_IDENTIFIER
+ ]
+ };
+ }
+
+ return csharp;
+
+})();
+
+ hljs.registerLanguage('csharp', hljsGrammar);
+ })();/*! `css` grammar compiled for Highlight.js 11.10.0 */
+ (function(){
+ var hljsGrammar = (function () {
+ 'use strict';
+
+ const MODES = (hljs) => {
+ return {
+ IMPORTANT: {
+ scope: 'meta',
+ begin: '!important'
+ },
+ BLOCK_COMMENT: hljs.C_BLOCK_COMMENT_MODE,
+ HEXCOLOR: {
+ scope: 'number',
+ begin: /#(([0-9a-fA-F]{3,4})|(([0-9a-fA-F]{2}){3,4}))\b/
+ },
+ FUNCTION_DISPATCH: {
+ className: "built_in",
+ begin: /[\w-]+(?=\()/
+ },
+ ATTRIBUTE_SELECTOR_MODE: {
+ scope: 'selector-attr',
+ begin: /\[/,
+ end: /\]/,
+ illegal: '$',
+ contains: [
+ hljs.APOS_STRING_MODE,
+ hljs.QUOTE_STRING_MODE
+ ]
+ },
+ CSS_NUMBER_MODE: {
+ scope: 'number',
+ begin: hljs.NUMBER_RE + '(' +
+ '%|em|ex|ch|rem' +
+ '|vw|vh|vmin|vmax' +
+ '|cm|mm|in|pt|pc|px' +
+ '|deg|grad|rad|turn' +
+ '|s|ms' +
+ '|Hz|kHz' +
+ '|dpi|dpcm|dppx' +
+ ')?',
+ relevance: 0
+ },
+ CSS_VARIABLE: {
+ className: "attr",
+ begin: /--[A-Za-z_][A-Za-z0-9_-]*/
+ }
+ };
+ };
+
+ const HTML_TAGS = [
+ 'a',
+ 'abbr',
+ 'address',
+ 'article',
+ 'aside',
+ 'audio',
+ 'b',
+ 'blockquote',
+ 'body',
+ 'button',
+ 'canvas',
+ 'caption',
+ 'cite',
+ 'code',
+ 'dd',
+ 'del',
+ 'details',
+ 'dfn',
+ 'div',
+ 'dl',
+ 'dt',
+ 'em',
+ 'fieldset',
+ 'figcaption',
+ 'figure',
+ 'footer',
+ 'form',
+ 'h1',
+ 'h2',
+ 'h3',
+ 'h4',
+ 'h5',
+ 'h6',
+ 'header',
+ 'hgroup',
+ 'html',
+ 'i',
+ 'iframe',
+ 'img',
+ 'input',
+ 'ins',
+ 'kbd',
+ 'label',
+ 'legend',
+ 'li',
+ 'main',
+ 'mark',
+ 'menu',
+ 'nav',
+ 'object',
+ 'ol',
+ 'optgroup',
+ 'option',
+ 'p',
+ 'picture',
+ 'q',
+ 'quote',
+ 'samp',
+ 'section',
+ 'select',
+ 'source',
+ 'span',
+ 'strong',
+ 'summary',
+ 'sup',
+ 'table',
+ 'tbody',
+ 'td',
+ 'textarea',
+ 'tfoot',
+ 'th',
+ 'thead',
+ 'time',
+ 'tr',
+ 'ul',
+ 'var',
+ 'video'
+ ];
+
+ const SVG_TAGS = [
+ 'defs',
+ 'g',
+ 'marker',
+ 'mask',
+ 'pattern',
+ 'svg',
+ 'switch',
+ 'symbol',
+ 'feBlend',
+ 'feColorMatrix',
+ 'feComponentTransfer',
+ 'feComposite',
+ 'feConvolveMatrix',
+ 'feDiffuseLighting',
+ 'feDisplacementMap',
+ 'feFlood',
+ 'feGaussianBlur',
+ 'feImage',
+ 'feMerge',
+ 'feMorphology',
+ 'feOffset',
+ 'feSpecularLighting',
+ 'feTile',
+ 'feTurbulence',
+ 'linearGradient',
+ 'radialGradient',
+ 'stop',
+ 'circle',
+ 'ellipse',
+ 'image',
+ 'line',
+ 'path',
+ 'polygon',
+ 'polyline',
+ 'rect',
+ 'text',
+ 'use',
+ 'textPath',
+ 'tspan',
+ 'foreignObject',
+ 'clipPath'
+ ];
+
+ const TAGS = [
+ ...HTML_TAGS,
+ ...SVG_TAGS,
+ ];
+
+ // Sorting, then reversing makes sure longer attributes/elements like
+ // `font-weight` are matched fully instead of getting false positives on say `font`
+
+ const MEDIA_FEATURES = [
+ 'any-hover',
+ 'any-pointer',
+ 'aspect-ratio',
+ 'color',
+ 'color-gamut',
+ 'color-index',
+ 'device-aspect-ratio',
+ 'device-height',
+ 'device-width',
+ 'display-mode',
+ 'forced-colors',
+ 'grid',
+ 'height',
+ 'hover',
+ 'inverted-colors',
+ 'monochrome',
+ 'orientation',
+ 'overflow-block',
+ 'overflow-inline',
+ 'pointer',
+ 'prefers-color-scheme',
+ 'prefers-contrast',
+ 'prefers-reduced-motion',
+ 'prefers-reduced-transparency',
+ 'resolution',
+ 'scan',
+ 'scripting',
+ 'update',
+ 'width',
+ // TODO: find a better solution?
+ 'min-width',
+ 'max-width',
+ 'min-height',
+ 'max-height'
+ ].sort().reverse();
+
+ // https://developer.mozilla.org/en-US/docs/Web/CSS/Pseudo-classes
+ const PSEUDO_CLASSES = [
+ 'active',
+ 'any-link',
+ 'blank',
+ 'checked',
+ 'current',
+ 'default',
+ 'defined',
+ 'dir', // dir()
+ 'disabled',
+ 'drop',
+ 'empty',
+ 'enabled',
+ 'first',
+ 'first-child',
+ 'first-of-type',
+ 'fullscreen',
+ 'future',
+ 'focus',
+ 'focus-visible',
+ 'focus-within',
+ 'has', // has()
+ 'host', // host or host()
+ 'host-context', // host-context()
+ 'hover',
+ 'indeterminate',
+ 'in-range',
+ 'invalid',
+ 'is', // is()
+ 'lang', // lang()
+ 'last-child',
+ 'last-of-type',
+ 'left',
+ 'link',
+ 'local-link',
+ 'not', // not()
+ 'nth-child', // nth-child()
+ 'nth-col', // nth-col()
+ 'nth-last-child', // nth-last-child()
+ 'nth-last-col', // nth-last-col()
+ 'nth-last-of-type', //nth-last-of-type()
+ 'nth-of-type', //nth-of-type()
+ 'only-child',
+ 'only-of-type',
+ 'optional',
+ 'out-of-range',
+ 'past',
+ 'placeholder-shown',
+ 'read-only',
+ 'read-write',
+ 'required',
+ 'right',
+ 'root',
+ 'scope',
+ 'target',
+ 'target-within',
+ 'user-invalid',
+ 'valid',
+ 'visited',
+ 'where' // where()
+ ].sort().reverse();
+
+ // https://developer.mozilla.org/en-US/docs/Web/CSS/Pseudo-elements
+ const PSEUDO_ELEMENTS = [
+ 'after',
+ 'backdrop',
+ 'before',
+ 'cue',
+ 'cue-region',
+ 'first-letter',
+ 'first-line',
+ 'grammar-error',
+ 'marker',
+ 'part',
+ 'placeholder',
+ 'selection',
+ 'slotted',
+ 'spelling-error'
+ ].sort().reverse();
+
+ const ATTRIBUTES = [
+ 'accent-color',
+ 'align-content',
+ 'align-items',
+ 'align-self',
+ 'alignment-baseline',
+ 'all',
+ 'animation',
+ 'animation-delay',
+ 'animation-direction',
+ 'animation-duration',
+ 'animation-fill-mode',
+ 'animation-iteration-count',
+ 'animation-name',
+ 'animation-play-state',
+ 'animation-timing-function',
+ 'appearance',
+ 'backface-visibility',
+ 'background',
+ 'background-attachment',
+ 'background-blend-mode',
+ 'background-clip',
+ 'background-color',
+ 'background-image',
+ 'background-origin',
+ 'background-position',
+ 'background-repeat',
+ 'background-size',
+ 'baseline-shift',
+ 'block-size',
+ 'border',
+ 'border-block',
+ 'border-block-color',
+ 'border-block-end',
+ 'border-block-end-color',
+ 'border-block-end-style',
+ 'border-block-end-width',
+ 'border-block-start',
+ 'border-block-start-color',
+ 'border-block-start-style',
+ 'border-block-start-width',
+ 'border-block-style',
+ 'border-block-width',
+ 'border-bottom',
+ 'border-bottom-color',
+ 'border-bottom-left-radius',
+ 'border-bottom-right-radius',
+ 'border-bottom-style',
+ 'border-bottom-width',
+ 'border-collapse',
+ 'border-color',
+ 'border-image',
+ 'border-image-outset',
+ 'border-image-repeat',
+ 'border-image-slice',
+ 'border-image-source',
+ 'border-image-width',
+ 'border-inline',
+ 'border-inline-color',
+ 'border-inline-end',
+ 'border-inline-end-color',
+ 'border-inline-end-style',
+ 'border-inline-end-width',
+ 'border-inline-start',
+ 'border-inline-start-color',
+ 'border-inline-start-style',
+ 'border-inline-start-width',
+ 'border-inline-style',
+ 'border-inline-width',
+ 'border-left',
+ 'border-left-color',
+ 'border-left-style',
+ 'border-left-width',
+ 'border-radius',
+ 'border-right',
+ 'border-end-end-radius',
+ 'border-end-start-radius',
+ 'border-right-color',
+ 'border-right-style',
+ 'border-right-width',
+ 'border-spacing',
+ 'border-start-end-radius',
+ 'border-start-start-radius',
+ 'border-style',
+ 'border-top',
+ 'border-top-color',
+ 'border-top-left-radius',
+ 'border-top-right-radius',
+ 'border-top-style',
+ 'border-top-width',
+ 'border-width',
+ 'bottom',
+ 'box-decoration-break',
+ 'box-shadow',
+ 'box-sizing',
+ 'break-after',
+ 'break-before',
+ 'break-inside',
+ 'cx',
+ 'cy',
+ 'caption-side',
+ 'caret-color',
+ 'clear',
+ 'clip',
+ 'clip-path',
+ 'clip-rule',
+ 'color',
+ 'color-interpolation',
+ 'color-interpolation-filters',
+ 'color-profile',
+ 'color-rendering',
+ 'color-scheme',
+ 'column-count',
+ 'column-fill',
+ 'column-gap',
+ 'column-rule',
+ 'column-rule-color',
+ 'column-rule-style',
+ 'column-rule-width',
+ 'column-span',
+ 'column-width',
+ 'columns',
+ 'contain',
+ 'content',
+ 'content-visibility',
+ 'counter-increment',
+ 'counter-reset',
+ 'cue',
+ 'cue-after',
+ 'cue-before',
+ 'cursor',
+ 'direction',
+ 'display',
+ 'dominant-baseline',
+ 'empty-cells',
+ 'enable-background',
+ 'fill',
+ 'fill-opacity',
+ 'fill-rule',
+ 'filter',
+ 'flex',
+ 'flex-basis',
+ 'flex-direction',
+ 'flex-flow',
+ 'flex-grow',
+ 'flex-shrink',
+ 'flex-wrap',
+ 'float',
+ 'flow',
+ 'flood-color',
+ 'flood-opacity',
+ 'font',
+ 'font-display',
+ 'font-family',
+ 'font-feature-settings',
+ 'font-kerning',
+ 'font-language-override',
+ 'font-size',
+ 'font-size-adjust',
+ 'font-smoothing',
+ 'font-stretch',
+ 'font-style',
+ 'font-synthesis',
+ 'font-variant',
+ 'font-variant-caps',
+ 'font-variant-east-asian',
+ 'font-variant-ligatures',
+ 'font-variant-numeric',
+ 'font-variant-position',
+ 'font-variation-settings',
+ 'font-weight',
+ 'gap',
+ 'glyph-orientation-horizontal',
+ 'glyph-orientation-vertical',
+ 'grid',
+ 'grid-area',
+ 'grid-auto-columns',
+ 'grid-auto-flow',
+ 'grid-auto-rows',
+ 'grid-column',
+ 'grid-column-end',
+ 'grid-column-start',
+ 'grid-gap',
+ 'grid-row',
+ 'grid-row-end',
+ 'grid-row-start',
+ 'grid-template',
+ 'grid-template-areas',
+ 'grid-template-columns',
+ 'grid-template-rows',
+ 'hanging-punctuation',
+ 'height',
+ 'hyphens',
+ 'icon',
+ 'image-orientation',
+ 'image-rendering',
+ 'image-resolution',
+ 'ime-mode',
+ 'inline-size',
+ 'inset',
+ 'inset-block',
+ 'inset-block-end',
+ 'inset-block-start',
+ 'inset-inline',
+ 'inset-inline-end',
+ 'inset-inline-start',
+ 'isolation',
+ 'kerning',
+ 'justify-content',
+ 'justify-items',
+ 'justify-self',
+ 'left',
+ 'letter-spacing',
+ 'lighting-color',
+ 'line-break',
+ 'line-height',
+ 'list-style',
+ 'list-style-image',
+ 'list-style-position',
+ 'list-style-type',
+ 'marker',
+ 'marker-end',
+ 'marker-mid',
+ 'marker-start',
+ 'mask',
+ 'margin',
+ 'margin-block',
+ 'margin-block-end',
+ 'margin-block-start',
+ 'margin-bottom',
+ 'margin-inline',
+ 'margin-inline-end',
+ 'margin-inline-start',
+ 'margin-left',
+ 'margin-right',
+ 'margin-top',
+ 'marks',
+ 'mask',
+ 'mask-border',
+ 'mask-border-mode',
+ 'mask-border-outset',
+ 'mask-border-repeat',
+ 'mask-border-slice',
+ 'mask-border-source',
+ 'mask-border-width',
+ 'mask-clip',
+ 'mask-composite',
+ 'mask-image',
+ 'mask-mode',
+ 'mask-origin',
+ 'mask-position',
+ 'mask-repeat',
+ 'mask-size',
+ 'mask-type',
+ 'max-block-size',
+ 'max-height',
+ 'max-inline-size',
+ 'max-width',
+ 'min-block-size',
+ 'min-height',
+ 'min-inline-size',
+ 'min-width',
+ 'mix-blend-mode',
+ 'nav-down',
+ 'nav-index',
+ 'nav-left',
+ 'nav-right',
+ 'nav-up',
+ 'none',
+ 'normal',
+ 'object-fit',
+ 'object-position',
+ 'opacity',
+ 'order',
+ 'orphans',
+ 'outline',
+ 'outline-color',
+ 'outline-offset',
+ 'outline-style',
+ 'outline-width',
+ 'overflow',
+ 'overflow-wrap',
+ 'overflow-x',
+ 'overflow-y',
+ 'padding',
+ 'padding-block',
+ 'padding-block-end',
+ 'padding-block-start',
+ 'padding-bottom',
+ 'padding-inline',
+ 'padding-inline-end',
+ 'padding-inline-start',
+ 'padding-left',
+ 'padding-right',
+ 'padding-top',
+ 'page-break-after',
+ 'page-break-before',
+ 'page-break-inside',
+ 'pause',
+ 'pause-after',
+ 'pause-before',
+ 'perspective',
+ 'perspective-origin',
+ 'pointer-events',
+ 'position',
+ 'quotes',
+ 'r',
+ 'resize',
+ 'rest',
+ 'rest-after',
+ 'rest-before',
+ 'right',
+ 'rotate',
+ 'row-gap',
+ 'scale',
+ 'scroll-margin',
+ 'scroll-margin-block',
+ 'scroll-margin-block-end',
+ 'scroll-margin-block-start',
+ 'scroll-margin-bottom',
+ 'scroll-margin-inline',
+ 'scroll-margin-inline-end',
+ 'scroll-margin-inline-start',
+ 'scroll-margin-left',
+ 'scroll-margin-right',
+ 'scroll-margin-top',
+ 'scroll-padding',
+ 'scroll-padding-block',
+ 'scroll-padding-block-end',
+ 'scroll-padding-block-start',
+ 'scroll-padding-bottom',
+ 'scroll-padding-inline',
+ 'scroll-padding-inline-end',
+ 'scroll-padding-inline-start',
+ 'scroll-padding-left',
+ 'scroll-padding-right',
+ 'scroll-padding-top',
+ 'scroll-snap-align',
+ 'scroll-snap-stop',
+ 'scroll-snap-type',
+ 'scrollbar-color',
+ 'scrollbar-gutter',
+ 'scrollbar-width',
+ 'shape-image-threshold',
+ 'shape-margin',
+ 'shape-outside',
+ 'shape-rendering',
+ 'stop-color',
+ 'stop-opacity',
+ 'stroke',
+ 'stroke-dasharray',
+ 'stroke-dashoffset',
+ 'stroke-linecap',
+ 'stroke-linejoin',
+ 'stroke-miterlimit',
+ 'stroke-opacity',
+ 'stroke-width',
+ 'speak',
+ 'speak-as',
+ 'src', // @font-face
+ 'tab-size',
+ 'table-layout',
+ 'text-anchor',
+ 'text-align',
+ 'text-align-all',
+ 'text-align-last',
+ 'text-combine-upright',
+ 'text-decoration',
+ 'text-decoration-color',
+ 'text-decoration-line',
+ 'text-decoration-skip-ink',
+ 'text-decoration-style',
+ 'text-decoration-thickness',
+ 'text-emphasis',
+ 'text-emphasis-color',
+ 'text-emphasis-position',
+ 'text-emphasis-style',
+ 'text-indent',
+ 'text-justify',
+ 'text-orientation',
+ 'text-overflow',
+ 'text-rendering',
+ 'text-shadow',
+ 'text-transform',
+ 'text-underline-offset',
+ 'text-underline-position',
+ 'top',
+ 'transform',
+ 'transform-box',
+ 'transform-origin',
+ 'transform-style',
+ 'transition',
+ 'transition-delay',
+ 'transition-duration',
+ 'transition-property',
+ 'transition-timing-function',
+ 'translate',
+ 'unicode-bidi',
+ 'vector-effect',
+ 'vertical-align',
+ 'visibility',
+ 'voice-balance',
+ 'voice-duration',
+ 'voice-family',
+ 'voice-pitch',
+ 'voice-range',
+ 'voice-rate',
+ 'voice-stress',
+ 'voice-volume',
+ 'white-space',
+ 'widows',
+ 'width',
+ 'will-change',
+ 'word-break',
+ 'word-spacing',
+ 'word-wrap',
+ 'writing-mode',
+ 'x',
+ 'y',
+ 'z-index'
+ ].sort().reverse();
+
+ /*
+ Language: CSS
+ Category: common, css, web
+ Website: https://developer.mozilla.org/en-US/docs/Web/CSS
+ */
+
+
+ /** @type LanguageFn */
+ function css(hljs) {
+ const regex = hljs.regex;
+ const modes = MODES(hljs);
+ const VENDOR_PREFIX = { begin: /-(webkit|moz|ms|o)-(?=[a-z])/ };
+ const AT_MODIFIERS = "and or not only";
+ const AT_PROPERTY_RE = /@-?\w[\w]*(-\w+)*/; // @-webkit-keyframes
+ const IDENT_RE = '[a-zA-Z-][a-zA-Z0-9_-]*';
+ const STRINGS = [
+ hljs.APOS_STRING_MODE,
+ hljs.QUOTE_STRING_MODE
+ ];
+
+ return {
+ name: 'CSS',
+ case_insensitive: true,
+ illegal: /[=|'\$]/,
+ keywords: { keyframePosition: "from to" },
+ classNameAliases: {
+ // for visual continuity with `tag {}` and because we
+ // don't have a great class for this?
+ keyframePosition: "selector-tag" },
+ contains: [
+ modes.BLOCK_COMMENT,
+ VENDOR_PREFIX,
+ // to recognize keyframe 40% etc which are outside the scope of our
+ // attribute value mode
+ modes.CSS_NUMBER_MODE,
+ {
+ className: 'selector-id',
+ begin: /#[A-Za-z0-9_-]+/,
+ relevance: 0
+ },
+ {
+ className: 'selector-class',
+ begin: '\\.' + IDENT_RE,
+ relevance: 0
+ },
+ modes.ATTRIBUTE_SELECTOR_MODE,
+ {
+ className: 'selector-pseudo',
+ variants: [
+ { begin: ':(' + PSEUDO_CLASSES.join('|') + ')' },
+ { begin: ':(:)?(' + PSEUDO_ELEMENTS.join('|') + ')' }
+ ]
+ },
+ // we may actually need this (12/2020)
+ // { // pseudo-selector params
+ // begin: /\(/,
+ // end: /\)/,
+ // contains: [ hljs.CSS_NUMBER_MODE ]
+ // },
+ modes.CSS_VARIABLE,
+ {
+ className: 'attribute',
+ begin: '\\b(' + ATTRIBUTES.join('|') + ')\\b'
+ },
+ // attribute values
+ {
+ begin: /:/,
+ end: /[;}{]/,
+ contains: [
+ modes.BLOCK_COMMENT,
+ modes.HEXCOLOR,
+ modes.IMPORTANT,
+ modes.CSS_NUMBER_MODE,
+ ...STRINGS,
+ // needed to highlight these as strings and to avoid issues with
+ // illegal characters that might be inside urls that would tigger the
+ // languages illegal stack
+ {
+ begin: /(url|data-uri)\(/,
+ end: /\)/,
+ relevance: 0, // from keywords
+ keywords: { built_in: "url data-uri" },
+ contains: [
+ ...STRINGS,
+ {
+ className: "string",
+ // any character other than `)` as in `url()` will be the start
+ // of a string, which ends with `)` (from the parent mode)
+ begin: /[^)]/,
+ endsWithParent: true,
+ excludeEnd: true
+ }
+ ]
+ },
+ modes.FUNCTION_DISPATCH
+ ]
+ },
+ {
+ begin: regex.lookahead(/@/),
+ end: '[{;]',
+ relevance: 0,
+ illegal: /:/, // break on Less variables @var: ...
+ contains: [
+ {
+ className: 'keyword',
+ begin: AT_PROPERTY_RE
+ },
+ {
+ begin: /\s/,
+ endsWithParent: true,
+ excludeEnd: true,
+ relevance: 0,
+ keywords: {
+ $pattern: /[a-z-]+/,
+ keyword: AT_MODIFIERS,
+ attribute: MEDIA_FEATURES.join(" ")
+ },
+ contains: [
+ {
+ begin: /[a-z-]+(?=:)/,
+ className: "attribute"
+ },
+ ...STRINGS,
+ modes.CSS_NUMBER_MODE
+ ]
+ }
+ ]
+ },
+ {
+ className: 'selector-tag',
+ begin: '\\b(' + TAGS.join('|') + ')\\b'
+ }
+ ]
+ };
+ }
+
+ return css;
+
+})();
+
+ hljs.registerLanguage('css', hljsGrammar);
+ })();/*! `diff` grammar compiled for Highlight.js 11.10.0 */
+ (function(){
+ var hljsGrammar = (function () {
+ 'use strict';
+
+ /*
+ Language: Diff
+ Description: Unified and context diff
+ Author: Vasily Polovnyov <va...@whiteants.net>
+ Website: https://www.gnu.org/software/diffutils/
+ Category: common
+ */
+
+ /** @type LanguageFn */
+ function diff(hljs) {
+ const regex = hljs.regex;
+ return {
+ name: 'Diff',
+ aliases: [ 'patch' ],
+ contains: [
+ {
+ className: 'meta',
+ relevance: 10,
+ match: regex.either(
+ /^@@ +-\d+,\d+ +\+\d+,\d+ +@@/,
+ /^\*\*\* +\d+,\d+ +\*\*\*\*$/,
+ /^--- +\d+,\d+ +----$/
+ )
+ },
+ {
+ className: 'comment',
+ variants: [
+ {
+ begin: regex.either(
+ /Index: /,
+ /^index/,
+ /={3,}/,
+ /^-{3}/,
+ /^\*{3} /,
+ /^\+{3}/,
+ /^diff --git/
+ ),
+ end: /$/
+ },
+ { match: /^\*{15}$/ }
+ ]
+ },
+ {
+ className: 'addition',
+ begin: /^\+/,
+ end: /$/
+ },
+ {
+ className: 'deletion',
+ begin: /^-/,
+ end: /$/
+ },
+ {
+ className: 'addition',
+ begin: /^!/,
+ end: /$/
+ }
+ ]
+ };
+ }
+
+ return diff;
+
+})();
+
+ hljs.registerLanguage('diff', hljsGrammar);
+ })();/*! `dockerfile` grammar compiled for Highlight.js 11.10.0 */
+ (function(){
+ var hljsGrammar = (function () {
+ 'use strict';
+
+ /*
+ Language: Dockerfile
+ Requires: bash.js
+ Author: Alexis Hénaut <al...@henaut.net>
+ Description: language definition for Dockerfile files
+ Website: https://docs.docker.com/engine/reference/builder/
+ Category: config
+ */
+
+ /** @type LanguageFn */
+ function dockerfile(hljs) {
+ const KEYWORDS = [
+ "from",
+ "maintainer",
+ "expose",
+ "env",
+ "arg",
+ "user",
+ "onbuild",
+ "stopsignal"
+ ];
+ return {
+ name: 'Dockerfile',
+ aliases: [ 'docker' ],
+ case_insensitive: true,
+ keywords: KEYWORDS,
+ contains: [
+ hljs.HASH_COMMENT_MODE,
+ hljs.APOS_STRING_MODE,
+ hljs.QUOTE_STRING_MODE,
+ hljs.NUMBER_MODE,
+ {
+ beginKeywords: 'run cmd entrypoint volume add copy workdir label healthcheck shell',
+ starts: {
+ end: /[^\\]$/,
+ subLanguage: 'bash'
+ }
+ }
+ ],
+ illegal: '</'
+ };
+ }
+
+ return dockerfile;
+
+})();
+
+ hljs.registerLanguage('dockerfile', hljsGrammar);
+ })();/*! `go` grammar compiled for Highlight.js 11.10.0 */
+ (function(){
+ var hljsGrammar = (function () {
+ 'use strict';
+
+ /*
+ Language: Go
+ Author: Stephan Kountso aka StepLg <st...@gmail.com>
+ Contributors: Evgeny Stepanischev <im...@gmail.com>
+ Description: Google go language (golang). For info about language
+ Website: http://golang.org/
+ Category: common, system
+ */
+
+ function go(hljs) {
+ const LITERALS = [
+ "true",
+ "false",
+ "iota",
+ "nil"
+ ];
+ const BUILT_INS = [
+ "append",
+ "cap",
+ "close",
+ "complex",
+ "copy",
+ "imag",
+ "len",
+ "make",
+ "new",
+ "panic",
+ "print",
+ "println",
+ "real",
+ "recover",
+ "delete"
+ ];
+ const TYPES = [
+ "bool",
+ "byte",
+ "complex64",
+ "complex128",
+ "error",
+ "float32",
+ "float64",
+ "int8",
+ "int16",
+ "int32",
+ "int64",
+ "string",
+ "uint8",
+ "uint16",
+ "uint32",
+ "uint64",
+ "int",
+ "uint",
+ "uintptr",
+ "rune"
+ ];
+ const KWS = [
+ "break",
+ "case",
+ "chan",
+ "const",
+ "continue",
+ "default",
+ "defer",
+ "else",
+ "fallthrough",
+ "for",
+ "func",
+ "go",
+ "goto",
+ "if",
+ "import",
+ "interface",
+ "map",
+ "package",
+ "range",
+ "return",
+ "select",
+ "struct",
+ "switch",
+ "type",
+ "var",
+ ];
+ const KEYWORDS = {
+ keyword: KWS,
+ type: TYPES,
+ literal: LITERALS,
+ built_in: BUILT_INS
+ };
+ return {
+ name: 'Go',
+ aliases: [ 'golang' ],
+ keywords: KEYWORDS,
+ illegal: '</',
+ contains: [
+ hljs.C_LINE_COMMENT_MODE,
+ hljs.C_BLOCK_COMMENT_MODE,
+ {
+ className: 'string',
+ variants: [
+ hljs.QUOTE_STRING_MODE,
+ hljs.APOS_STRING_MODE,
+ {
+ begin: '`',
+ end: '`'
+ }
+ ]
+ },
+ {
+ className: 'number',
+ variants: [
+ {
+ match: /-?\b0[xX]\.[a-fA-F0-9](_?[a-fA-F0-9])*[pP][+-]?\d(_?\d)*i?/, // hex without a present digit before . (making a digit afterwards required)
+ relevance: 0
+ },
+ {
+ match: /-?\b0[xX](_?[a-fA-F0-9])+((\.([a-fA-F0-9](_?[a-fA-F0-9])*)?)?[pP][+-]?\d(_?\d)*)?i?/, // hex with a present digit before . (making a digit afterwards optional)
+ relevance: 0
+ },
+ {
+ match: /-?\b0[oO](_?[0-7])*i?/, // leading 0o octal
+ relevance: 0
+ },
+ {
+ match: /-?\.\d(_?\d)*([eE][+-]?\d(_?\d)*)?i?/, // decimal without a present digit before . (making a digit afterwards required)
+ relevance: 0
+ },
+ {
+ match: /-?\b\d(_?\d)*(\.(\d(_?\d)*)?)?([eE][+-]?\d(_?\d)*)?i?/, // decimal with a present digit before . (making a digit afterwards optional)
+ relevance: 0
+ }
+ ]
+ },
+ { begin: /:=/ // relevance booster
+ },
+ {
+ className: 'function',
+ beginKeywords: 'func',
+ end: '\\s*(\\{|$)',
+ excludeEnd: true,
+ contains: [
+ hljs.TITLE_MODE,
+ {
+ className: 'params',
+ begin: /\(/,
+ end: /\)/,
+ endsParent: true,
+ keywords: KEYWORDS,
+ illegal: /["']/
+ }
+ ]
+ }
+ ]
+ };
+ }
+
+ return go;
+
+})();
+
+ hljs.registerLanguage('go', hljsGrammar);
+ })();/*! `graphql` grammar compiled for Highlight.js 11.10.0 */
+ (function(){
+ var hljsGrammar = (function () {
+ 'use strict';
+
+ /*
+ Language: GraphQL
+ Author: John Foster (GH jf990), and others
+ Description: GraphQL is a query language for APIs
+ Category: web, common
+ */
+
+ /** @type LanguageFn */
+ function graphql(hljs) {
+ const regex = hljs.regex;
+ const GQL_NAME = /[_A-Za-z][_0-9A-Za-z]*/;
+ return {
+ name: "GraphQL",
+ aliases: [ "gql" ],
+ case_insensitive: true,
+ disableAutodetect: false,
+ keywords: {
+ keyword: [
+ "query",
+ "mutation",
+ "subscription",
+ "type",
+ "input",
+ "schema",
+ "directive",
+ "interface",
+ "union",
+ "scalar",
+ "fragment",
+ "enum",
+ "on"
+ ],
+ literal: [
+ "true",
+ "false",
+ "null"
+ ]
+ },
+ contains: [
+ hljs.HASH_COMMENT_MODE,
+ hljs.QUOTE_STRING_MODE,
+ hljs.NUMBER_MODE,
+ {
+ scope: "punctuation",
+ match: /[.]{3}/,
+ relevance: 0
+ },
+ {
+ scope: "punctuation",
+ begin: /[\!\(\)\:\=\[\]\{\|\}]{1}/,
+ relevance: 0
+ },
+ {
+ scope: "variable",
+ begin: /\$/,
+ end: /\W/,
+ excludeEnd: true,
+ relevance: 0
+ },
+ {
+ scope: "meta",
+ match: /@\w+/,
+ excludeEnd: true
+ },
+ {
+ scope: "symbol",
+ begin: regex.concat(GQL_NAME, regex.lookahead(/\s*:/)),
+ relevance: 0
+ }
+ ],
+ illegal: [
+ /[;<']/,
+ /BEGIN/
+ ]
+ };
+ }
+
+ return graphql;
+
+})();
+
+ hljs.registerLanguage('graphql', hljsGrammar);
+ })();/*! `haskell` grammar compiled for Highlight.js 11.10.0 */
+ (function(){
+ var hljsGrammar = (function () {
+ 'use strict';
+
+ /*
+ Language: Haskell
+ Author: Jeremy Hull <so...@gmail.com>
+ Contributors: Zena Treep <ze...@gmail.com>
+ Website: https://www.haskell.org
+ Category: functional
+ */
+
+ function haskell(hljs) {
+
+ /* See:
+ - https://www.haskell.org/onlinereport/lexemes.html
+ - https://downloads.haskell.org/ghc/9.0.1/docs/html/users_guide/exts/binary_literals.html
+ - https://downloads.haskell.org/ghc/9.0.1/docs/html/users_guide/exts/numeric_underscores.html
+ - https://downloads.haskell.org/ghc/9.0.1/docs/html/users_guide/exts/hex_float_literals.html
+ */
+ const decimalDigits = '([0-9]_*)+';
+ const hexDigits = '([0-9a-fA-F]_*)+';
+ const binaryDigits = '([01]_*)+';
+ const octalDigits = '([0-7]_*)+';
+ const ascSymbol = '[!#$%&*+.\\/<=>?@\\\\^~-]';
+ const uniSymbol = '(\\p{S}|\\p{P})'; // Symbol or Punctuation
+ const special = '[(),;\\[\\]`|{}]';
+ const symbol = `(${ascSymbol}|(?!(${special}|[_:"']))${uniSymbol})`;
+
+ const COMMENT = { variants: [
+ // Double dash forms a valid comment only if it's not part of legal lexeme.
+ // See: Haskell 98 report: https://www.haskell.org/onlinereport/lexemes.html
+ //
+ // The commented code does the job, but we can't use negative lookbehind,
+ // due to poor support by Safari browser.
+ // > hljs.COMMENT(`(?<!${symbol})--+(?!${symbol})`, '$'),
+ // So instead, we'll add a no-markup rule before the COMMENT rule in the rules list
+ // to match the problematic infix operators that contain double dash.
+ hljs.COMMENT('--+', '$'),
+ hljs.COMMENT(
+ /\{-/,
+ /-\}/,
+ { contains: [ 'self' ] }
+ )
+ ] };
+
+ const PRAGMA = {
+ className: 'meta',
+ begin: /\{-#/,
+ end: /#-\}/
+ };
+
+ const PREPROCESSOR = {
+ className: 'meta',
+ begin: '^#',
+ end: '$'
+ };
+
+ const CONSTRUCTOR = {
+ className: 'type',
+ begin: '\\b[A-Z][\\w\']*', // TODO: other constructors (build-in, infix).
+ relevance: 0
+ };
+
+ const LIST = {
+ begin: '\\(',
+ end: '\\)',
+ illegal: '"',
+ contains: [
+ PRAGMA,
+ PREPROCESSOR,
+ {
+ className: 'type',
+ begin: '\\b[A-Z][\\w]*(\\((\\.\\.|,|\\w+)\\))?'
+ },
+ hljs.inherit(hljs.TITLE_MODE, { begin: '[_a-z][\\w\']*' }),
+ COMMENT
+ ]
+ };
+
+ const RECORD = {
+ begin: /\{/,
+ end: /\}/,
+ contains: LIST.contains
+ };
+
+ const NUMBER = {
+ className: 'number',
+ relevance: 0,
+ variants: [
+ // decimal floating-point-literal (subsumes decimal-literal)
+ { match: `\\b(${decimalDigits})(\\.(${decimalDigits}))?` + `([eE][+-]?(${decimalDigits}))?\\b` },
+ // hexadecimal floating-point-literal (subsumes hexadecimal-literal)
+ { match: `\\b0[xX]_*(${hexDigits})(\\.(${hexDigits}))?` + `([pP][+-]?(${decimalDigits}))?\\b` },
+ // octal-literal
+ { match: `\\b0[oO](${octalDigits})\\b` },
+ // binary-literal
+ { match: `\\b0[bB](${binaryDigits})\\b` }
+ ]
+ };
+
+ return {
+ name: 'Haskell',
+ aliases: [ 'hs' ],
+ keywords:
+ 'let in if then else case of where do module import hiding '
+ + 'qualified type data newtype deriving class instance as default '
+ + 'infix infixl infixr foreign export ccall stdcall cplusplus '
+ + 'jvm dotnet safe unsafe family forall mdo proc rec',
+ unicodeRegex: true,
+ contains: [
+ // Top-level constructions.
+ {
+ beginKeywords: 'module',
+ end: 'where',
+ keywords: 'module where',
+ contains: [
+ LIST,
+ COMMENT
+ ],
+ illegal: '\\W\\.|;'
+ },
+ {
+ begin: '\\bimport\\b',
+ end: '$',
+ keywords: 'import qualified as hiding',
+ contains: [
+ LIST,
+ COMMENT
+ ],
+ illegal: '\\W\\.|;'
+ },
+ {
+ className: 'class',
+ begin: '^(\\s*)?(class|instance)\\b',
+ end: 'where',
+ keywords: 'class family instance where',
+ contains: [
+ CONSTRUCTOR,
+ LIST,
+ COMMENT
+ ]
+ },
+ {
+ className: 'class',
+ begin: '\\b(data|(new)?type)\\b',
+ end: '$',
+ keywords: 'data family type newtype deriving',
+ contains: [
+ PRAGMA,
+ CONSTRUCTOR,
+ LIST,
+ RECORD,
+ COMMENT
+ ]
+ },
+ {
+ beginKeywords: 'default',
+ end: '$',
+ contains: [
+ CONSTRUCTOR,
+ LIST,
+ COMMENT
+ ]
+ },
+ {
+ beginKeywords: 'infix infixl infixr',
+ end: '$',
+ contains: [
+ hljs.C_NUMBER_MODE,
+ COMMENT
+ ]
+ },
+ {
+ begin: '\\bforeign\\b',
+ end: '$',
+ keywords: 'foreign import export ccall stdcall cplusplus jvm '
+ + 'dotnet safe unsafe',
+ contains: [
+ CONSTRUCTOR,
+ hljs.QUOTE_STRING_MODE,
+ COMMENT
+ ]
+ },
+ {
+ className: 'meta',
+ begin: '#!\\/usr\\/bin\\/env\ runhaskell',
+ end: '$'
+ },
+ // "Whitespaces".
+ PRAGMA,
+ PREPROCESSOR,
+
+ // Literals and names.
+
+ // Single characters.
+ {
+ scope: 'string',
+ begin: /'(?=\\?.')/,
+ end: /'/,
+ contains: [
+ {
+ scope: 'char.escape',
+ match: /\\./,
+ },
+ ]
+ },
+ hljs.QUOTE_STRING_MODE,
+ NUMBER,
+ CONSTRUCTOR,
+ hljs.inherit(hljs.TITLE_MODE, { begin: '^[_a-z][\\w\']*' }),
+ // No markup, prevents infix operators from being recognized as comments.
+ { begin: `(?!-)${symbol}--+|--+(?!-)${symbol}`},
+ COMMENT,
+ { // No markup, relevance booster
+ begin: '->|<-' }
+ ]
+ };
+ }
+
+ return haskell;
+
+})();
+
+ hljs.registerLanguage('haskell', hljsGrammar);
+ })();/*! `ini` grammar compiled for Highlight.js 11.10.0 */
+ (function(){
+ var hljsGrammar = (function () {
+ 'use strict';
+
+ /*
+ Language: TOML, also INI
+ Description: TOML aims to be a minimal configuration file format that's easy to read due to obvious semantics.
+ Contributors: Guillaume Gomez <gu...@gmail.com>
+ Category: common, config
+ Website: https://github.com/toml-lang/toml
+ */
+
+ function ini(hljs) {
+ const regex = hljs.regex;
+ const NUMBERS = {
+ className: 'number',
+ relevance: 0,
+ variants: [
+ { begin: /([+-]+)?[\d]+_[\d_]+/ },
+ { begin: hljs.NUMBER_RE }
+ ]
+ };
+ const COMMENTS = hljs.COMMENT();
+ COMMENTS.variants = [
+ {
+ begin: /;/,
+ end: /$/
+ },
+ {
+ begin: /#/,
+ end: /$/
+ }
+ ];
+ const VARIABLES = {
+ className: 'variable',
+ variants: [
+ { begin: /\$[\w\d"][\w\d_]*/ },
+ { begin: /\$\{(.*?)\}/ }
+ ]
+ };
+ const LITERALS = {
+ className: 'literal',
+ begin: /\bon|off|true|false|yes|no\b/
+ };
+ const STRINGS = {
+ className: "string",
+ contains: [ hljs.BACKSLASH_ESCAPE ],
+ variants: [
+ {
+ begin: "'''",
+ end: "'''",
+ relevance: 10
+ },
+ {
+ begin: '"""',
+ end: '"""',
+ relevance: 10
+ },
+ {
+ begin: '"',
+ end: '"'
+ },
+ {
+ begin: "'",
+ end: "'"
+ }
+ ]
+ };
+ const ARRAY = {
+ begin: /\[/,
+ end: /\]/,
+ contains: [
+ COMMENTS,
+ LITERALS,
+ VARIABLES,
+ STRINGS,
+ NUMBERS,
+ 'self'
+ ],
+ relevance: 0
+ };
+
+ const BARE_KEY = /[A-Za-z0-9_-]+/;
+ const QUOTED_KEY_DOUBLE_QUOTE = /"(\\"|[^"])*"/;
+ const QUOTED_KEY_SINGLE_QUOTE = /'[^']*'/;
+ const ANY_KEY = regex.either(
+ BARE_KEY, QUOTED_KEY_DOUBLE_QUOTE, QUOTED_KEY_SINGLE_QUOTE
+ );
+ const DOTTED_KEY = regex.concat(
+ ANY_KEY, '(\\s*\\.\\s*', ANY_KEY, ')*',
+ regex.lookahead(/\s*=\s*[^#\s]/)
+ );
+
+ return {
+ name: 'TOML, also INI',
+ aliases: [ 'toml' ],
+ case_insensitive: true,
+ illegal: /\S/,
+ contains: [
+ COMMENTS,
+ {
+ className: 'section',
+ begin: /\[+/,
+ end: /\]+/
+ },
+ {
+ begin: DOTTED_KEY,
+ className: 'attr',
+ starts: {
+ end: /$/,
+ contains: [
+ COMMENTS,
+ ARRAY,
+ LITERALS,
+ VARIABLES,
+ STRINGS,
+ NUMBERS
+ ]
+ }
+ }
+ ]
+ };
+ }
+
+ return ini;
+
+})();
+
+ hljs.registerLanguage('ini', hljsGrammar);
+ })();/*! `java` grammar compiled for Highlight.js 11.10.0 */
+ (function(){
+ var hljsGrammar = (function () {
+ 'use strict';
+
+ // https://docs.oracle.com/javase/specs/jls/se15/html/jls-3.html#jls-3.10
+ var decimalDigits = '[0-9](_*[0-9])*';
+ var frac = `\\.(${decimalDigits})`;
+ var hexDigits = '[0-9a-fA-F](_*[0-9a-fA-F])*';
+ var NUMERIC = {
+ className: 'number',
+ variants: [
+ // DecimalFloatingPointLiteral
+ // including ExponentPart
+ { begin: `(\\b(${decimalDigits})((${frac})|\\.)?|(${frac}))` +
+ `[eE][+-]?(${decimalDigits})[fFdD]?\\b` },
+ // excluding ExponentPart
+ { begin: `\\b(${decimalDigits})((${frac})[fFdD]?\\b|\\.([fFdD]\\b)?)` },
+ { begin: `(${frac})[fFdD]?\\b` },
+ { begin: `\\b(${decimalDigits})[fFdD]\\b` },
+
+ // HexadecimalFloatingPointLiteral
+ { begin: `\\b0[xX]((${hexDigits})\\.?|(${hexDigits})?\\.(${hexDigits}))` +
+ `[pP][+-]?(${decimalDigits})[fFdD]?\\b` },
+
+ // DecimalIntegerLiteral
+ { begin: '\\b(0|[1-9](_*[0-9])*)[lL]?\\b' },
+
+ // HexIntegerLiteral
+ { begin: `\\b0[xX](${hexDigits})[lL]?\\b` },
+
+ // OctalIntegerLiteral
+ { begin: '\\b0(_*[0-7])*[lL]?\\b' },
+
+ // BinaryIntegerLiteral
+ { begin: '\\b0[bB][01](_*[01])*[lL]?\\b' },
+ ],
+ relevance: 0
+ };
+
+ /*
+ Language: Java
+ Author: Vsevolod Solovyov <vs...@gmail.com>
+ Category: common, enterprise
+ Website: https://www.java.com/
+ */
+
+
+ /**
+ * Allows recursive regex expressions to a given depth
+ *
+ * ie: recurRegex("(abc~~~)", /~~~/g, 2) becomes:
+ * (abc(abc(abc)))
+ *
+ * @param {string} re
+ * @param {RegExp} substitution (should be a g mode regex)
+ * @param {number} depth
+ * @returns {string}``
+ */
+ function recurRegex(re, substitution, depth) {
+ if (depth === -1) return "";
+
+ return re.replace(substitution, _ => {
+ return recurRegex(re, substitution, depth - 1);
+ });
+ }
+
+ /** @type LanguageFn */
+ function java(hljs) {
+ const regex = hljs.regex;
+ const JAVA_IDENT_RE = '[\u00C0-\u02B8a-zA-Z_$][\u00C0-\u02B8a-zA-Z_$0-9]*';
+ const GENERIC_IDENT_RE = JAVA_IDENT_RE
+ + recurRegex('(?:<' + JAVA_IDENT_RE + '~~~(?:\\s*,\\s*' + JAVA_IDENT_RE + '~~~)*>)?', /~~~/g, 2);
+ const MAIN_KEYWORDS = [
+ 'synchronized',
+ 'abstract',
+ 'private',
+ 'var',
+ 'static',
+ 'if',
+ 'const ',
+ 'for',
+ 'while',
+ 'strictfp',
+ 'finally',
+ 'protected',
+ 'import',
+ 'native',
+ 'final',
+ 'void',
+ 'enum',
+ 'else',
+ 'break',
+ 'transient',
+ 'catch',
+ 'instanceof',
+ 'volatile',
+ 'case',
+ 'assert',
+ 'package',
+ 'default',
+ 'public',
+ 'try',
+ 'switch',
+ 'continue',
+ 'throws',
+ 'protected',
+ 'public',
+ 'private',
+ 'module',
+ 'requires',
+ 'exports',
+ 'do',
+ 'sealed',
+ 'yield',
+ 'permits',
+ 'goto'
+ ];
+
+ const BUILT_INS = [
+ 'super',
+ 'this'
+ ];
+
+ const LITERALS = [
+ 'false',
+ 'true',
+ 'null'
+ ];
+
+ const TYPES = [
+ 'char',
+ 'boolean',
+ 'long',
+ 'float',
+ 'int',
+ 'byte',
+ 'short',
+ 'double'
+ ];
+
+ const KEYWORDS = {
+ keyword: MAIN_KEYWORDS,
+ literal: LITERALS,
+ type: TYPES,
+ built_in: BUILT_INS
+ };
+
+ const ANNOTATION = {
+ className: 'meta',
+ begin: '@' + JAVA_IDENT_RE,
+ contains: [
+ {
+ begin: /\(/,
+ end: /\)/,
+ contains: [ "self" ] // allow nested () inside our annotation
+ }
+ ]
+ };
+ const PARAMS = {
+ className: 'params',
+ begin: /\(/,
+ end: /\)/,
+ keywords: KEYWORDS,
+ relevance: 0,
+ contains: [ hljs.C_BLOCK_COMMENT_MODE ],
+ endsParent: true
+ };
+
+ return {
+ name: 'Java',
+ aliases: [ 'jsp' ],
+ keywords: KEYWORDS,
+ illegal: /<\/|#/,
+ contains: [
+ hljs.COMMENT(
+ '/\\*\\*',
+ '\\*/',
+ {
+ relevance: 0,
+ contains: [
+ {
+ // eat up @'s in emails to prevent them to be recognized as doctags
+ begin: /\w+@/,
+ relevance: 0
+ },
+ {
+ className: 'doctag',
+ begin: '@[A-Za-z]+'
+ }
+ ]
+ }
+ ),
+ // relevance boost
+ {
+ begin: /import java\.[a-z]+\./,
+ keywords: "import",
+ relevance: 2
+ },
+ hljs.C_LINE_COMMENT_MODE,
+ hljs.C_BLOCK_COMMENT_MODE,
+ {
+ begin: /"""/,
+ end: /"""/,
+ className: "string",
+ contains: [ hljs.BACKSLASH_ESCAPE ]
+ },
+ hljs.APOS_STRING_MODE,
+ hljs.QUOTE_STRING_MODE,
+ {
+ match: [
+ /\b(?:class|interface|enum|extends|implements|new)/,
+ /\s+/,
+ JAVA_IDENT_RE
+ ],
+ className: {
+ 1: "keyword",
+ 3: "title.class"
+ }
+ },
+ {
+ // Exceptions for hyphenated keywords
+ match: /non-sealed/,
+ scope: "keyword"
+ },
+ {
+ begin: [
+ regex.concat(/(?!else)/, JAVA_IDENT_RE),
+ /\s+/,
+ JAVA_IDENT_RE,
+ /\s+/,
+ /=(?!=)/
+ ],
+ className: {
+ 1: "type",
+ 3: "variable",
+ 5: "operator"
+ }
+ },
+ {
+ begin: [
+ /record/,
+ /\s+/,
+ JAVA_IDENT_RE
+ ],
+ className: {
+ 1: "keyword",
+ 3: "title.class"
+ },
+ contains: [
+ PARAMS,
+ hljs.C_LINE_COMMENT_MODE,
+ hljs.C_BLOCK_COMMENT_MODE
+ ]
+ },
+ {
+ // Expression keywords prevent 'keyword Name(...)' from being
+ // recognized as a function definition
+ beginKeywords: 'new throw return else',
+ relevance: 0
+ },
+ {
+ begin: [
+ '(?:' + GENERIC_IDENT_RE + '\\s+)',
+ hljs.UNDERSCORE_IDENT_RE,
+ /\s*(?=\()/
+ ],
+ className: { 2: "title.function" },
+ keywords: KEYWORDS,
+ contains: [
+ {
+ className: 'params',
+ begin: /\(/,
+ end: /\)/,
+ keywords: KEYWORDS,
+ relevance: 0,
+ contains: [
+ ANNOTATION,
+ hljs.APOS_STRING_MODE,
+ hljs.QUOTE_STRING_MODE,
+ NUMERIC,
+ hljs.C_BLOCK_COMMENT_MODE
+ ]
+ },
+ hljs.C_LINE_COMMENT_MODE,
+ hljs.C_BLOCK_COMMENT_MODE
+ ]
+ },
+ NUMERIC,
+ ANNOTATION
+ ]
+ };
+ }
+
+ return java;
+
+})();
+
+ hljs.registerLanguage('java', hljsGrammar);
+ })();/*! `javascript` grammar compiled for Highlight.js 11.10.0 */
+ (function(){
+ var hljsGrammar = (function () {
+ 'use strict';
+
+ const IDENT_RE = '[A-Za-z$_][0-9A-Za-z$_]*';
+ const KEYWORDS = [
+ "as", // for exports
+ "in",
+ "of",
+ "if",
+ "for",
+ "while",
+ "finally",
+ "var",
+ "new",
+ "function",
+ "do",
+ "return",
+ "void",
+ "else",
+ "break",
+ "catch",
+ "instanceof",
+ "with",
+ "throw",
+ "case",
+ "default",
+ "try",
+ "switch",
+ "continue",
+ "typeof",
+ "delete",
+ "let",
+ "yield",
+ "const",
+ "class",
+ // JS handles these with a special rule
+ // "get",
+ // "set",
+ "debugger",
+ "async",
+ "await",
+ "static",
+ "import",
+ "from",
+ "export",
+ "extends"
+ ];
+ const LITERALS = [
+ "true",
+ "false",
+ "null",
+ "undefined",
+ "NaN",
+ "Infinity"
+ ];
+
+ // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects
+ const TYPES = [
+ // Fundamental objects
+ "Object",
+ "Function",
+ "Boolean",
+ "Symbol",
+ // numbers and dates
+ "Math",
+ "Date",
+ "Number",
+ "BigInt",
+ // text
+ "String",
+ "RegExp",
+ // Indexed collections
+ "Array",
+ "Float32Array",
+ "Float64Array",
+ "Int8Array",
+ "Uint8Array",
+ "Uint8ClampedArray",
+ "Int16Array",
+ "Int32Array",
+ "Uint16Array",
+ "Uint32Array",
+ "BigInt64Array",
+ "BigUint64Array",
+ // Keyed collections
+ "Set",
+ "Map",
+ "WeakSet",
+ "WeakMap",
+ // Structured data
+ "ArrayBuffer",
+ "SharedArrayBuffer",
+ "Atomics",
+ "DataView",
+ "JSON",
+ // Control abstraction objects
+ "Promise",
+ "Generator",
+ "GeneratorFunction",
+ "AsyncFunction",
+ // Reflection
+ "Reflect",
+ "Proxy",
+ // Internationalization
+ "Intl",
+ // WebAssembly
+ "WebAssembly"
+ ];
+
+ const ERROR_TYPES = [
+ "Error",
+ "EvalError",
+ "InternalError",
+ "RangeError",
+ "ReferenceError",
+ "SyntaxError",
+ "TypeError",
+ "URIError"
+ ];
+
+ const BUILT_IN_GLOBALS = [
+ "setInterval",
+ "setTimeout",
+ "clearInterval",
+ "clearTimeout",
+
+ "require",
+ "exports",
+
+ "eval",
+ "isFinite",
+ "isNaN",
+ "parseFloat",
+ "parseInt",
+ "decodeURI",
+ "decodeURIComponent",
+ "encodeURI",
+ "encodeURIComponent",
+ "escape",
+ "unescape"
+ ];
+
+ const BUILT_IN_VARIABLES = [
+ "arguments",
+ "this",
+ "super",
+ "console",
+ "window",
+ "document",
+ "localStorage",
+ "sessionStorage",
+ "module",
+ "global" // Node.js
+ ];
+
+ const BUILT_INS = [].concat(
+ BUILT_IN_GLOBALS,
+ TYPES,
+ ERROR_TYPES
+ );
+
+ /*
+ Language: JavaScript
+ Description: JavaScript (JS) is a lightweight, interpreted, or just-in-time compiled programming language with first-class functions.
+ Category: common, scripting, web
+ Website: https://developer.mozilla.org/en-US/docs/Web/JavaScript
+ */
+
+
+ /** @type LanguageFn */
+ function javascript(hljs) {
+ const regex = hljs.regex;
+ /**
+ * Takes a string like "<Booger" and checks to see
+ * if we can find a matching "</Booger" later in the
+ * content.
+ * @param {RegExpMatchArray} match
+ * @param {{after:number}} param1
+ */
+ const hasClosingTag = (match, { after }) => {
+ const tag = "</" + match[0].slice(1);
+ const pos = match.input.indexOf(tag, after);
+ return pos !== -1;
+ };
+
+ const IDENT_RE$1 = IDENT_RE;
+ const FRAGMENT = {
+ begin: '<>',
+ end: '</>'
+ };
+ // to avoid some special cases inside isTrulyOpeningTag
+ const XML_SELF_CLOSING = /<[A-Za-z0-9\\._:-]+\s*\/>/;
+ const XML_TAG = {
+ begin: /<[A-Za-z0-9\\._:-]+/,
+ end: /\/[A-Za-z0-9\\._:-]+>|\/>/,
+ /**
+ * @param {RegExpMatchArray} match
+ * @param {CallbackResponse} response
+ */
+ isTrulyOpeningTag: (match, response) => {
+ const afterMatchIndex = match[0].length + match.index;
+ const nextChar = match.input[afterMatchIndex];
+ if (
+ // HTML should not include another raw `<` inside a tag
+ // nested type?
+ // `<Array<Array<number>>`, etc.
+ nextChar === "<" ||
+ // the , gives away that this is not HTML
+ // `<T, A extends keyof T, V>`
+ nextChar === ","
+ ) {
+ response.ignoreMatch();
+ return;
+ }
+
+ // `<something>`
+ // Quite possibly a tag, lets look for a matching closing tag...
+ if (nextChar === ">") {
+ // if we cannot find a matching closing tag, then we
+ // will ignore it
+ if (!hasClosingTag(match, { after: afterMatchIndex })) {
+ response.ignoreMatch();
+ }
+ }
+
+ // `<blah />` (self-closing)
+ // handled by simpleSelfClosing rule
+
+ let m;
+ const afterMatch = match.input.substring(afterMatchIndex);
+
+ // some more template typing stuff
+ // <T = any>(key?: string) => Modify<
+ if ((m = afterMatch.match(/^\s*=/))) {
+ response.ignoreMatch();
+ return;
+ }
+
+ // `<From extends string>`
+ // technically this could be HTML, but it smells like a type
+ // NOTE: This is ugh, but added specifically for https://github.com/highlightjs/highlight.js/issues/3276
+ if ((m = afterMatch.match(/^\s+extends\s+/))) {
+ if (m.index === 0) {
+ response.ignoreMatch();
+ // eslint-disable-next-line no-useless-return
+ return;
+ }
+ }
+ }
+ };
+ const KEYWORDS$1 = {
+ $pattern: IDENT_RE,
+ keyword: KEYWORDS,
+ literal: LITERALS,
+ built_in: BUILT_INS,
+ "variable.language": BUILT_IN_VARIABLES
+ };
+
+ // https://tc39.es/ecma262/#sec-literals-numeric-literals
+ const decimalDigits = '[0-9](_?[0-9])*';
+ const frac = `\\.(${decimalDigits})`;
+ // DecimalIntegerLiteral, including Annex B NonOctalDecimalIntegerLiteral
+ // https://tc39.es/ecma262/#sec-additional-syntax-numeric-literals
+ const decimalInteger = `0|[1-9](_?[0-9])*|0[0-7]*[89][0-9]*`;
+ const NUMBER = {
+ className: 'number',
+ variants: [
+ // DecimalLiteral
+ { begin: `(\\b(${decimalInteger})((${frac})|\\.)?|(${frac}))` +
+ `[eE][+-]?(${decimalDigits})\\b` },
+ { begin: `\\b(${decimalInteger})\\b((${frac})\\b|\\.)?|(${frac})\\b` },
+
+ // DecimalBigIntegerLiteral
+ { begin: `\\b(0|[1-9](_?[0-9])*)n\\b` },
+
+ // NonDecimalIntegerLiteral
+ { begin: "\\b0[xX][0-9a-fA-F](_?[0-9a-fA-F])*n?\\b" },
+ { begin: "\\b0[bB][0-1](_?[0-1])*n?\\b" },
+ { begin: "\\b0[oO][0-7](_?[0-7])*n?\\b" },
+
+ // LegacyOctalIntegerLiteral (does not include underscore separators)
+ // https://tc39.es/ecma262/#sec-additional-syntax-numeric-literals
+ { begin: "\\b0[0-7]+n?\\b" },
+ ],
+ relevance: 0
+ };
+
+ const SUBST = {
+ className: 'subst',
+ begin: '\\$\\{',
+ end: '\\}',
+ keywords: KEYWORDS$1,
+ contains: [] // defined later
+ };
+ const HTML_TEMPLATE = {
+ begin: '\.?html`',
+ end: '',
+ starts: {
+ end: '`',
+ returnEnd: false,
+ contains: [
+ hljs.BACKSLASH_ESCAPE,
+ SUBST
+ ],
+ subLanguage: 'xml'
+ }
+ };
+ const CSS_TEMPLATE = {
+ begin: '\.?css`',
+ end: '',
+ starts: {
+ end: '`',
+ returnEnd: false,
+ contains: [
+ hljs.BACKSLASH_ESCAPE,
+ SUBST
+ ],
+ subLanguage: 'css'
+ }
+ };
+ const GRAPHQL_TEMPLATE = {
+ begin: '\.?gql`',
+ end: '',
+ starts: {
+ end: '`',
+ returnEnd: false,
+ contains: [
+ hljs.BACKSLASH_ESCAPE,
+ SUBST
+ ],
+ subLanguage: 'graphql'
+ }
+ };
+ const TEMPLATE_STRING = {
+ className: 'string',
+ begin: '`',
+ end: '`',
+ contains: [
+ hljs.BACKSLASH_ESCAPE,
+ SUBST
+ ]
+ };
+ const JSDOC_COMMENT = hljs.COMMENT(
+ /\/\*\*(?!\/)/,
+ '\\*/',
+ {
+ relevance: 0,
+ contains: [
+ {
+ begin: '(?=@[A-Za-z]+)',
+ relevance: 0,
+ contains: [
+ {
+ className: 'doctag',
+ begin: '@[A-Za-z]+'
+ },
+ {
+ className: 'type',
+ begin: '\\{',
+ end: '\\}',
+ excludeEnd: true,
+ excludeBegin: true,
+ relevance: 0
+ },
+ {
+ className: 'variable',
+ begin: IDENT_RE$1 + '(?=\\s*(-)|$)',
+ endsParent: true,
+ relevance: 0
+ },
+ // eat spaces (not newlines) so we can find
+ // types or variables
+ {
+ begin: /(?=[^\n])\s/,
+ relevance: 0
+ }
+ ]
+ }
+ ]
+ }
+ );
+ const COMMENT = {
+ className: "comment",
+ variants: [
+ JSDOC_COMMENT,
+ hljs.C_BLOCK_COMMENT_MODE,
+ hljs.C_LINE_COMMENT_MODE
+ ]
+ };
+ const SUBST_INTERNALS = [
+ hljs.APOS_STRING_MODE,
+ hljs.QUOTE_STRING_MODE,
+ HTML_TEMPLATE,
+ CSS_TEMPLATE,
+ GRAPHQL_TEMPLATE,
+ TEMPLATE_STRING,
+ // Skip numbers when they are part of a variable name
+ { match: /\$\d+/ },
+ NUMBER,
+ // This is intentional:
+ // See https://github.com/highlightjs/highlight.js/issues/3288
+ // hljs.REGEXP_MODE
+ ];
+ SUBST.contains = SUBST_INTERNALS
+ .concat({
+ // we need to pair up {} inside our subst to prevent
+ // it from ending too early by matching another }
+ begin: /\{/,
+ end: /\}/,
+ keywords: KEYWORDS$1,
+ contains: [
+ "self"
+ ].concat(SUBST_INTERNALS)
+ });
+ const SUBST_AND_COMMENTS = [].concat(COMMENT, SUBST.contains);
+ const PARAMS_CONTAINS = SUBST_AND_COMMENTS.concat([
+ // eat recursive parens in sub expressions
+ {
+ begin: /(\s*)\(/,
+ end: /\)/,
+ keywords: KEYWORDS$1,
+ contains: ["self"].concat(SUBST_AND_COMMENTS)
+ }
+ ]);
+ const PARAMS = {
+ className: 'params',
+ // convert this to negative lookbehind in v12
+ begin: /(\s*)\(/, // to match the parms with
+ end: /\)/,
+ excludeBegin: true,
+ excludeEnd: true,
+ keywords: KEYWORDS$1,
+ contains: PARAMS_CONTAINS
+ };
+
+ // ES6 classes
+ const CLASS_OR_EXTENDS = {
+ variants: [
+ // class Car extends vehicle
+ {
+ match: [
+ /class/,
+ /\s+/,
+ IDENT_RE$1,
+ /\s+/,
+ /extends/,
+ /\s+/,
+ regex.concat(IDENT_RE$1, "(", regex.concat(/\./, IDENT_RE$1), ")*")
+ ],
+ scope: {
+ 1: "keyword",
+ 3: "title.class",
+ 5: "keyword",
+ 7: "title.class.inherited"
+ }
+ },
+ // class Car
+ {
+ match: [
+ /class/,
+ /\s+/,
+ IDENT_RE$1
+ ],
+ scope: {
+ 1: "keyword",
+ 3: "title.class"
+ }
+ },
+
+ ]
+ };
+
+ const CLASS_REFERENCE = {
+ relevance: 0,
+ match:
+ regex.either(
+ // Hard coded exceptions
+ /\bJSON/,
+ // Float32Array, OutT
+ /\b[A-Z][a-z]+([A-Z][a-z]*|\d)*/,
+ // CSSFactory, CSSFactoryT
+ /\b[A-Z]{2,}([A-Z][a-z]+|\d)+([A-Z][a-z]*)*/,
+ // FPs, FPsT
+ /\b[A-Z]{2,}[a-z]+([A-Z][a-z]+|\d)*([A-Z][a-z]*)*/,
+ // P
+ // single letters are not highlighted
+ // BLAH
+ // this will be flagged as a UPPER_CASE_CONSTANT instead
+ ),
+ className: "title.class",
+ keywords: {
+ _: [
+ // se we still get relevance credit for JS library classes
+ ...TYPES,
+ ...ERROR_TYPES
+ ]
+ }
+ };
+
+ const USE_STRICT = {
+ label: "use_strict",
+ className: 'meta',
+ relevance: 10,
+ begin: /^\s*['"]use (strict|asm)['"]/
+ };
+
+ const FUNCTION_DEFINITION = {
+ variants: [
+ {
+ match: [
+ /function/,
+ /\s+/,
+ IDENT_RE$1,
+ /(?=\s*\()/
+ ]
+ },
+ // anonymous function
+ {
+ match: [
+ /function/,
+ /\s*(?=\()/
+ ]
+ }
+ ],
+ className: {
+ 1: "keyword",
+ 3: "title.function"
+ },
+ label: "func.def",
+ contains: [ PARAMS ],
+ illegal: /%/
+ };
+
+ const UPPER_CASE_CONSTANT = {
+ relevance: 0,
+ match: /\b[A-Z][A-Z_0-9]+\b/,
+ className: "variable.constant"
+ };
+
+ function noneOf(list) {
+ return regex.concat("(?!", list.join("|"), ")");
+ }
+
+ const FUNCTION_CALL = {
+ match: regex.concat(
+ /\b/,
+ noneOf([
+ ...BUILT_IN_GLOBALS,
+ "super",
+ "import"
+ ].map(x => `${x}\\s*\\(`)),
+ IDENT_RE$1, regex.lookahead(/\s*\(/)),
+ className: "title.function",
+ relevance: 0
+ };
+
+ const PROPERTY_ACCESS = {
+ begin: regex.concat(/\./, regex.lookahead(
+ regex.concat(IDENT_RE$1, /(?![0-9A-Za-z$_(])/)
+ )),
+ end: IDENT_RE$1,
+ excludeBegin: true,
+ keywords: "prototype",
+ className: "property",
+ relevance: 0
+ };
+
+ const GETTER_OR_SETTER = {
+ match: [
+ /get|set/,
+ /\s+/,
+ IDENT_RE$1,
+ /(?=\()/
+ ],
+ className: {
+ 1: "keyword",
+ 3: "title.function"
+ },
+ contains: [
+ { // eat to avoid empty params
+ begin: /\(\)/
+ },
+ PARAMS
+ ]
+ };
+
+ const FUNC_LEAD_IN_RE = '(\\(' +
+ '[^()]*(\\(' +
+ '[^()]*(\\(' +
+ '[^()]*' +
+ '\\)[^()]*)*' +
+ '\\)[^()]*)*' +
+ '\\)|' + hljs.UNDERSCORE_IDENT_RE + ')\\s*=>';
+
+ const FUNCTION_VARIABLE = {
+ match: [
+ /const|var|let/, /\s+/,
+ IDENT_RE$1, /\s*/,
+ /=\s*/,
+ /(async\s*)?/, // async is optional
+ regex.lookahead(FUNC_LEAD_IN_RE)
+ ],
+ keywords: "async",
+ className: {
+ 1: "keyword",
+ 3: "title.function"
+ },
+ contains: [
+ PARAMS
+ ]
+ };
+
+ return {
+ name: 'JavaScript',
+ aliases: ['js', 'jsx', 'mjs', 'cjs'],
+ keywords: KEYWORDS$1,
+ // this will be extended by TypeScript
+ exports: { PARAMS_CONTAINS, CLASS_REFERENCE },
+ illegal: /#(?![$_A-z])/,
+ contains: [
+ hljs.SHEBANG({
+ label: "shebang",
+ binary: "node",
+ relevance: 5
+ }),
+ USE_STRICT,
+ hljs.APOS_STRING_MODE,
+ hljs.QUOTE_STRING_MODE,
+ HTML_TEMPLATE,
+ CSS_TEMPLATE,
+ GRAPHQL_TEMPLATE,
+ TEMPLATE_STRING,
+ COMMENT,
+ // Skip numbers when they are part of a variable name
+ { match: /\$\d+/ },
+ NUMBER,
+ CLASS_REFERENCE,
+ {
+ className: 'attr',
+ begin: IDENT_RE$1 + regex.lookahead(':'),
+ relevance: 0
+ },
+ FUNCTION_VARIABLE,
+ { // "value" container
+ begin: '(' + hljs.RE_STARTERS_RE + '|\\b(case|return|throw)\\b)\\s*',
+ keywords: 'return throw case',
+ relevance: 0,
+ contains: [
+ COMMENT,
+ hljs.REGEXP_MODE,
+ {
+ className: 'function',
+ // we have to count the parens to make sure we actually have the
+ // correct bounding ( ) before the =>. There could be any number of
+ // sub-expressions inside also surrounded by parens.
+ begin: FUNC_LEAD_IN_RE,
+ returnBegin: true,
+ end: '\\s*=>',
+ contains: [
+ {
+ className: 'params',
+ variants: [
+ {
+ begin: hljs.UNDERSCORE_IDENT_RE,
+ relevance: 0
+ },
+ {
+ className: null,
+ begin: /\(\s*\)/,
+ skip: true
+ },
+ {
+ begin: /(\s*)\(/,
+ end: /\)/,
+ excludeBegin: true,
+ excludeEnd: true,
+ keywords: KEYWORDS$1,
+ contains: PARAMS_CONTAINS
+ }
+ ]
+ }
+ ]
+ },
+ { // could be a comma delimited list of params to a function call
+ begin: /,/,
+ relevance: 0
+ },
+ {
+ match: /\s+/,
+ relevance: 0
+ },
+ { // JSX
+ variants: [
+ { begin: FRAGMENT.begin, end: FRAGMENT.end },
+ { match: XML_SELF_CLOSING },
+ {
+ begin: XML_TAG.begin,
+ // we carefully check the opening tag to see if it truly
+ // is a tag and not a false positive
+ 'on:begin': XML_TAG.isTrulyOpeningTag,
+ end: XML_TAG.end
+ }
+ ],
+ subLanguage: 'xml',
+ contains: [
+ {
+ begin: XML_TAG.begin,
+ end: XML_TAG.end,
+ skip: true,
+ contains: ['self']
+ }
+ ]
+ }
+ ],
+ },
+ FUNCTION_DEFINITION,
+ {
+ // prevent this from getting swallowed up by function
+ // since they appear "function like"
+ beginKeywords: "while if switch catch for"
+ },
+ {
+ // we have to count the parens to make sure we actually have the correct
+ // bounding ( ). There could be any number of sub-expressions inside
+ // also surrounded by parens.
+ begin: '\\b(?!function)' + hljs.UNDERSCORE_IDENT_RE +
+ '\\(' + // first parens
+ '[^()]*(\\(' +
+ '[^()]*(\\(' +
+ '[^()]*' +
+ '\\)[^()]*)*' +
+ '\\)[^()]*)*' +
+ '\\)\\s*\\{', // end parens
+ returnBegin:true,
+ label: "func.def",
+ contains: [
+ PARAMS,
+ hljs.inherit(hljs.TITLE_MODE, { begin: IDENT_RE$1, className: "title.function" })
+ ]
+ },
+ // catch ... so it won't trigger the property rule below
+ {
+ match: /\.\.\./,
+ relevance: 0
+ },
+ PROPERTY_ACCESS,
+ // hack: prevents detection of keywords in some circumstances
+ // .keyword()
+ // $keyword = x
+ {
+ match: '\\$' + IDENT_RE$1,
+ relevance: 0
+ },
+ {
+ match: [ /\bconstructor(?=\s*\()/ ],
+ className: { 1: "title.function" },
+ contains: [ PARAMS ]
+ },
+ FUNCTION_CALL,
+ UPPER_CASE_CONSTANT,
+ CLASS_OR_EXTENDS,
+ GETTER_OR_SETTER,
+ {
+ match: /\$[(.]/ // relevance booster for a pattern common to JS libs: `$(something)` and `$.something`
+ }
+ ]
+ };
+ }
+
+ return javascript;
+
+})();
+
+ hljs.registerLanguage('javascript', hljsGrammar);
+ })();/*! `json` grammar compiled for Highlight.js 11.10.0 */
+ (function(){
+ var hljsGrammar = (function () {
+ 'use strict';
+
+ /*
+ Language: JSON
+ Description: JSON (JavaScript Object Notation) is a lightweight data-interchange format.
+ Author: Ivan Sagalaev <ma...@softwaremaniacs.org>
+ Website: http://www.json.org
+ Category: common, protocols, web
+ */
+
+ function json(hljs) {
+ const ATTRIBUTE = {
+ className: 'attr',
+ begin: /"(\\.|[^\\"\r\n])*"(?=\s*:)/,
+ relevance: 1.01
+ };
+ const PUNCTUATION = {
+ match: /[{}[\],:]/,
+ className: "punctuation",
+ relevance: 0
+ };
+ const LITERALS = [
+ "true",
+ "false",
+ "null"
+ ];
+ // NOTE: normally we would rely on `keywords` for this but using a mode here allows us
+ // - to use the very tight `illegal: \S` rule later to flag any other character
+ // - as illegal indicating that despite looking like JSON we do not truly have
+ // - JSON and thus improve false-positively greatly since JSON will try and claim
+ // - all sorts of JSON looking stuff
+ const LITERALS_MODE = {
+ scope: "literal",
+ beginKeywords: LITERALS.join(" "),
+ };
+
+ return {
+ name: 'JSON',
+ aliases: ['jsonc'],
+ keywords:{
+ literal: LITERALS,
+ },
+ contains: [
+ ATTRIBUTE,
+ PUNCTUATION,
+ hljs.QUOTE_STRING_MODE,
+ LITERALS_MODE,
+ hljs.C_NUMBER_MODE,
+ hljs.C_LINE_COMMENT_MODE,
+ hljs.C_BLOCK_COMMENT_MODE
+ ],
+ illegal: '\\S'
+ };
+ }
+
+ return json;
+
+})();
+
+ hljs.registerLanguage('json', hljsGrammar);
+ })();/*! `kotlin` grammar compiled for Highlight.js 11.10.0 */
+ (function(){
+ var hljsGrammar = (function () {
+ 'use strict';
+
+ // https://docs.oracle.com/javase/specs/jls/se15/html/jls-3.html#jls-3.10
+ var decimalDigits = '[0-9](_*[0-9])*';
+ var frac = `\\.(${decimalDigits})`;
+ var hexDigits = '[0-9a-fA-F](_*[0-9a-fA-F])*';
+ var NUMERIC = {
+ className: 'number',
+ variants: [
+ // DecimalFloatingPointLiteral
+ // including ExponentPart
+ { begin: `(\\b(${decimalDigits})((${frac})|\\.)?|(${frac}))` +
+ `[eE][+-]?(${decimalDigits})[fFdD]?\\b` },
+ // excluding ExponentPart
+ { begin: `\\b(${decimalDigits})((${frac})[fFdD]?\\b|\\.([fFdD]\\b)?)` },
+ { begin: `(${frac})[fFdD]?\\b` },
+ { begin: `\\b(${decimalDigits})[fFdD]\\b` },
+
+ // HexadecimalFloatingPointLiteral
+ { begin: `\\b0[xX]((${hexDigits})\\.?|(${hexDigits})?\\.(${hexDigits}))` +
+ `[pP][+-]?(${decimalDigits})[fFdD]?\\b` },
+
+ // DecimalIntegerLiteral
+ { begin: '\\b(0|[1-9](_*[0-9])*)[lL]?\\b' },
+
+ // HexIntegerLiteral
+ { begin: `\\b0[xX](${hexDigits})[lL]?\\b` },
+
+ // OctalIntegerLiteral
+ { begin: '\\b0(_*[0-7])*[lL]?\\b' },
+
+ // BinaryIntegerLiteral
+ { begin: '\\b0[bB][01](_*[01])*[lL]?\\b' },
+ ],
+ relevance: 0
+ };
+
+ /*
+ Language: Kotlin
+ Description: Kotlin is an OSS statically typed programming language that targets the JVM, Android, JavaScript and Native.
+ Author: Sergey Mashkov <cy...@gmail.com>
+ Website: https://kotlinlang.org
+ Category: common
+ */
+
+
+ function kotlin(hljs) {
+ const KEYWORDS = {
+ keyword:
+ 'abstract as val var vararg get set class object open private protected public noinline '
+ + 'crossinline dynamic final enum if else do while for when throw try catch finally '
+ + 'import package is in fun override companion reified inline lateinit init '
+ + 'interface annotation data sealed internal infix operator out by constructor super '
+ + 'tailrec where const inner suspend typealias external expect actual',
+ built_in:
+ 'Byte Short Char Int Long Boolean Float Double Void Unit Nothing',
+ literal:
+ 'true false null'
+ };
+ const KEYWORDS_WITH_LABEL = {
+ className: 'keyword',
+ begin: /\b(break|continue|return|this)\b/,
+ starts: { contains: [
+ {
+ className: 'symbol',
+ begin: /@\w+/
+ }
+ ] }
+ };
+ const LABEL = {
+ className: 'symbol',
+ begin: hljs.UNDERSCORE_IDENT_RE + '@'
+ };
+
+ // for string templates
+ const SUBST = {
+ className: 'subst',
+ begin: /\$\{/,
+ end: /\}/,
+ contains: [ hljs.C_NUMBER_MODE ]
+ };
+ const VARIABLE = {
+ className: 'variable',
+ begin: '\\$' + hljs.UNDERSCORE_IDENT_RE
+ };
+ const STRING = {
+ className: 'string',
+ variants: [
+ {
+ begin: '"""',
+ end: '"""(?=[^"])',
+ contains: [
+ VARIABLE,
+ SUBST
+ ]
+ },
+ // Can't use built-in modes easily, as we want to use STRING in the meta
+ // context as 'meta-string' and there's no syntax to remove explicitly set
+ // classNames in built-in modes.
+ {
+ begin: '\'',
+ end: '\'',
+ illegal: /\n/,
+ contains: [ hljs.BACKSLASH_ESCAPE ]
+ },
+ {
+ begin: '"',
+ end: '"',
+ illegal: /\n/,
+ contains: [
+ hljs.BACKSLASH_ESCAPE,
+ VARIABLE,
+ SUBST
+ ]
+ }
+ ]
+ };
+ SUBST.contains.push(STRING);
+
+ const ANNOTATION_USE_SITE = {
+ className: 'meta',
+ begin: '@(?:file|property|field|get|set|receiver|param|setparam|delegate)\\s*:(?:\\s*' + hljs.UNDERSCORE_IDENT_RE + ')?'
+ };
+ const ANNOTATION = {
+ className: 'meta',
+ begin: '@' + hljs.UNDERSCORE_IDENT_RE,
+ contains: [
+ {
+ begin: /\(/,
+ end: /\)/,
+ contains: [
+ hljs.inherit(STRING, { className: 'string' }),
+ "self"
+ ]
+ }
+ ]
+ };
+
+ // https://kotlinlang.org/docs/reference/whatsnew11.html#underscores-in-numeric-literals
+ // According to the doc above, the number mode of kotlin is the same as java 8,
+ // so the code below is copied from java.js
+ const KOTLIN_NUMBER_MODE = NUMERIC;
+ const KOTLIN_NESTED_COMMENT = hljs.COMMENT(
+ '/\\*', '\\*/',
+ { contains: [ hljs.C_BLOCK_COMMENT_MODE ] }
+ );
+ const KOTLIN_PAREN_TYPE = { variants: [
+ {
+ className: 'type',
+ begin: hljs.UNDERSCORE_IDENT_RE
+ },
+ {
+ begin: /\(/,
+ end: /\)/,
+ contains: [] // defined later
+ }
+ ] };
+ const KOTLIN_PAREN_TYPE2 = KOTLIN_PAREN_TYPE;
+ KOTLIN_PAREN_TYPE2.variants[1].contains = [ KOTLIN_PAREN_TYPE ];
+ KOTLIN_PAREN_TYPE.variants[1].contains = [ KOTLIN_PAREN_TYPE2 ];
+
+ return {
+ name: 'Kotlin',
+ aliases: [
+ 'kt',
+ 'kts'
+ ],
+ keywords: KEYWORDS,
+ contains: [
+ hljs.COMMENT(
+ '/\\*\\*',
+ '\\*/',
+ {
+ relevance: 0,
+ contains: [
+ {
+ className: 'doctag',
+ begin: '@[A-Za-z]+'
+ }
+ ]
+ }
+ ),
+ hljs.C_LINE_COMMENT_MODE,
+ KOTLIN_NESTED_COMMENT,
+ KEYWORDS_WITH_LABEL,
+ LABEL,
+ ANNOTATION_USE_SITE,
+ ANNOTATION,
+ {
+ className: 'function',
+ beginKeywords: 'fun',
+ end: '[(]|$',
+ returnBegin: true,
+ excludeEnd: true,
+ keywords: KEYWORDS,
+ relevance: 5,
+ contains: [
+ {
+ begin: hljs.UNDERSCORE_IDENT_RE + '\\s*\\(',
+ returnBegin: true,
+ relevance: 0,
+ contains: [ hljs.UNDERSCORE_TITLE_MODE ]
+ },
+ {
+ className: 'type',
+ begin: /</,
+ end: />/,
+ keywords: 'reified',
+ relevance: 0
+ },
+ {
+ className: 'params',
+ begin: /\(/,
+ end: /\)/,
+ endsParent: true,
+ keywords: KEYWORDS,
+ relevance: 0,
+ contains: [
+ {
+ begin: /:/,
+ end: /[=,\/]/,
+ endsWithParent: true,
+ contains: [
+ KOTLIN_PAREN_TYPE,
+ hljs.C_LINE_COMMENT_MODE,
+ KOTLIN_NESTED_COMMENT
+ ],
+ relevance: 0
+ },
+ hljs.C_LINE_COMMENT_MODE,
+ KOTLIN_NESTED_COMMENT,
+ ANNOTATION_USE_SITE,
+ ANNOTATION,
+ STRING,
+ hljs.C_NUMBER_MODE
+ ]
+ },
+ KOTLIN_NESTED_COMMENT
+ ]
+ },
+ {
+ begin: [
+ /class|interface|trait/,
+ /\s+/,
+ hljs.UNDERSCORE_IDENT_RE
+ ],
+ beginScope: {
+ 3: "title.class"
+ },
+ keywords: 'class interface trait',
+ end: /[:\{(]|$/,
+ excludeEnd: true,
+ illegal: 'extends implements',
+ contains: [
+ { beginKeywords: 'public protected internal private constructor' },
+ hljs.UNDERSCORE_TITLE_MODE,
+ {
+ className: 'type',
+ begin: /</,
+ end: />/,
+ excludeBegin: true,
+ excludeEnd: true,
+ relevance: 0
+ },
+ {
+ className: 'type',
+ begin: /[,:]\s*/,
+ end: /[<\(,){\s]|$/,
+ excludeBegin: true,
+ returnEnd: true
+ },
+ ANNOTATION_USE_SITE,
+ ANNOTATION
+ ]
+ },
+ STRING,
+ {
+ className: 'meta',
+ begin: "^#!/usr/bin/env",
+ end: '$',
+ illegal: '\n'
+ },
+ KOTLIN_NUMBER_MODE
+ ]
+ };
+ }
+
+ return kotlin;
+
+})();
+
+ hljs.registerLanguage('kotlin', hljsGrammar);
+ })();/*! `latex` grammar compiled for Highlight.js 11.10.0 */
+ (function(){
+ var hljsGrammar = (function () {
+ 'use strict';
+
+ /*
+ Language: LaTeX
+ Author: Benedikt Wilde <bw...@posteo.de>
+ Website: https://www.latex-project.org
+ Category: markup
+ */
+
+ /** @type LanguageFn */
+ function latex(hljs) {
+ const regex = hljs.regex;
+ const KNOWN_CONTROL_WORDS = regex.either(...[
+ '(?:NeedsTeXFormat|RequirePackage|GetIdInfo)',
+ 'Provides(?:Expl)?(?:Package|Class|File)',
+ '(?:DeclareOption|ProcessOptions)',
+ '(?:documentclass|usepackage|input|include)',
+ 'makeat(?:letter|other)',
+ 'ExplSyntax(?:On|Off)',
+ '(?:new|renew|provide)?command',
+ '(?:re)newenvironment',
+ '(?:New|Renew|Provide|Declare)(?:Expandable)?DocumentCommand',
+ '(?:New|Renew|Provide|Declare)DocumentEnvironment',
+ '(?:(?:e|g|x)?def|let)',
+ '(?:begin|end)',
+ '(?:part|chapter|(?:sub){0,2}section|(?:sub)?paragraph)',
+ 'caption',
+ '(?:label|(?:eq|page|name)?ref|(?:paren|foot|super)?cite)',
+ '(?:alpha|beta|[Gg]amma|[Dd]elta|(?:var)?epsilon|zeta|eta|[Tt]heta|vartheta)',
+ '(?:iota|(?:var)?kappa|[Ll]ambda|mu|nu|[Xx]i|[Pp]i|varpi|(?:var)rho)',
+ '(?:[Ss]igma|varsigma|tau|[Uu]psilon|[Pp]hi|varphi|chi|[Pp]si|[Oo]mega)',
+ '(?:frac|sum|prod|lim|infty|times|sqrt|leq|geq|left|right|middle|[bB]igg?)',
+ '(?:[lr]angle|q?quad|[lcvdi]?dots|d?dot|hat|tilde|bar)'
+ ].map(word => word + '(?![a-zA-Z@:_])'));
+ const L3_REGEX = new RegExp([
+ // A function \module_function_name:signature or \__module_function_name:signature,
+ // where both module and function_name need at least two characters and
+ // function_name may contain single underscores.
+ '(?:__)?[a-zA-Z]{2,}_[a-zA-Z](?:_?[a-zA-Z])+:[a-zA-Z]*',
+ // A variable \scope_module_and_name_type or \scope__module_ane_name_type,
+ // where scope is one of l, g or c, type needs at least two characters
+ // and module_and_name may contain single underscores.
+ '[lgc]__?[a-zA-Z](?:_?[a-zA-Z])*_[a-zA-Z]{2,}',
+ // A quark \q_the_name or \q__the_name or
+ // scan mark \s_the_name or \s__vthe_name,
+ // where variable_name needs at least two characters and
+ // may contain single underscores.
+ '[qs]__?[a-zA-Z](?:_?[a-zA-Z])+',
+ // Other LaTeX3 macro names that are not covered by the three rules above.
+ 'use(?:_i)?:[a-zA-Z]*',
+ '(?:else|fi|or):',
+ '(?:if|cs|exp):w',
+ '(?:hbox|vbox):n',
+ '::[a-zA-Z]_unbraced',
+ '::[a-zA-Z:]'
+ ].map(pattern => pattern + '(?![a-zA-Z:_])').join('|'));
+ const L2_VARIANTS = [
+ { begin: /[a-zA-Z@]+/ }, // control word
+ { begin: /[^a-zA-Z@]?/ } // control symbol
+ ];
+ const DOUBLE_CARET_VARIANTS = [
+ { begin: /\^{6}[0-9a-f]{6}/ },
+ { begin: /\^{5}[0-9a-f]{5}/ },
+ { begin: /\^{4}[0-9a-f]{4}/ },
+ { begin: /\^{3}[0-9a-f]{3}/ },
+ { begin: /\^{2}[0-9a-f]{2}/ },
+ { begin: /\^{2}[\u0000-\u007f]/ }
+ ];
+ const CONTROL_SEQUENCE = {
+ className: 'keyword',
+ begin: /\\/,
+ relevance: 0,
+ contains: [
+ {
+ endsParent: true,
+ begin: KNOWN_CONTROL_WORDS
+ },
+ {
+ endsParent: true,
+ begin: L3_REGEX
+ },
+ {
+ endsParent: true,
+ variants: DOUBLE_CARET_VARIANTS
+ },
+ {
+ endsParent: true,
+ relevance: 0,
+ variants: L2_VARIANTS
+ }
+ ]
+ };
+ const MACRO_PARAM = {
+ className: 'params',
+ relevance: 0,
+ begin: /#+\d?/
+ };
+ const DOUBLE_CARET_CHAR = {
+ // relevance: 1
+ variants: DOUBLE_CARET_VARIANTS };
+ const SPECIAL_CATCODE = {
+ className: 'built_in',
+ relevance: 0,
+ begin: /[$&^_]/
+ };
+ const MAGIC_COMMENT = {
+ className: 'meta',
+ begin: /% ?!(T[eE]X|tex|BIB|bib)/,
+ end: '$',
+ relevance: 10
+ };
+ const COMMENT = hljs.COMMENT(
+ '%',
+ '$',
+ { relevance: 0 }
+ );
+ const EVERYTHING_BUT_VERBATIM = [
+ CONTROL_SEQUENCE,
+ MACRO_PARAM,
+ DOUBLE_CARET_CHAR,
+ SPECIAL_CATCODE,
+ MAGIC_COMMENT,
+ COMMENT
+ ];
+ const BRACE_GROUP_NO_VERBATIM = {
+ begin: /\{/,
+ end: /\}/,
+ relevance: 0,
+ contains: [
+ 'self',
+ ...EVERYTHING_BUT_VERBATIM
+ ]
+ };
+ const ARGUMENT_BRACES = hljs.inherit(
+ BRACE_GROUP_NO_VERBATIM,
+ {
+ relevance: 0,
+ endsParent: true,
+ contains: [
+ BRACE_GROUP_NO_VERBATIM,
+ ...EVERYTHING_BUT_VERBATIM
+ ]
+ }
+ );
+ const ARGUMENT_BRACKETS = {
+ begin: /\[/,
+ end: /\]/,
+ endsParent: true,
+ relevance: 0,
+ contains: [
+ BRACE_GROUP_NO_VERBATIM,
+ ...EVERYTHING_BUT_VERBATIM
+ ]
+ };
+ const SPACE_GOBBLER = {
+ begin: /\s+/,
+ relevance: 0
+ };
+ const ARGUMENT_M = [ ARGUMENT_BRACES ];
+ const ARGUMENT_O = [ ARGUMENT_BRACKETS ];
+ const ARGUMENT_AND_THEN = function(arg, starts_mode) {
+ return {
+ contains: [ SPACE_GOBBLER ],
+ starts: {
+ relevance: 0,
+ contains: arg,
+ starts: starts_mode
+ }
+ };
+ };
+ const CSNAME = function(csname, starts_mode) {
+ return {
+ begin: '\\\\' + csname + '(?![a-zA-Z@:_])',
+ keywords: {
+ $pattern: /\\[a-zA-Z]+/,
+ keyword: '\\' + csname
+ },
+ relevance: 0,
+ contains: [ SPACE_GOBBLER ],
+ starts: starts_mode
+ };
+ };
+ const BEGIN_ENV = function(envname, starts_mode) {
+ return hljs.inherit(
+ {
+ begin: '\\\\begin(?=[ \t]*(\\r?\\n[ \t]*)?\\{' + envname + '\\})',
+ keywords: {
+ $pattern: /\\[a-zA-Z]+/,
+ keyword: '\\begin'
+ },
+ relevance: 0,
+ },
+ ARGUMENT_AND_THEN(ARGUMENT_M, starts_mode)
+ );
+ };
+ const VERBATIM_DELIMITED_EQUAL = (innerName = "string") => {
+ return hljs.END_SAME_AS_BEGIN({
+ className: innerName,
+ begin: /(.|\r?\n)/,
+ end: /(.|\r?\n)/,
+ excludeBegin: true,
+ excludeEnd: true,
+ endsParent: true
+ });
+ };
+ const VERBATIM_DELIMITED_ENV = function(envname) {
+ return {
+ className: 'string',
+ end: '(?=\\\\end\\{' + envname + '\\})'
+ };
+ };
+
+ const VERBATIM_DELIMITED_BRACES = (innerName = "string") => {
+ return {
+ relevance: 0,
+ begin: /\{/,
+ starts: {
+ endsParent: true,
+ contains: [
+ {
+ className: innerName,
+ end: /(?=\})/,
+ endsParent: true,
+ contains: [
+ {
+ begin: /\{/,
+ end: /\}/,
+ relevance: 0,
+ contains: [ "self" ]
+ }
+ ],
+ }
+ ]
+ }
+ };
+ };
+ const VERBATIM = [
+ ...[
+ 'verb',
+ 'lstinline'
+ ].map(csname => CSNAME(csname, { contains: [ VERBATIM_DELIMITED_EQUAL() ] })),
+ CSNAME('mint', ARGUMENT_AND_THEN(ARGUMENT_M, { contains: [ VERBATIM_DELIMITED_EQUAL() ] })),
+ CSNAME('mintinline', ARGUMENT_AND_THEN(ARGUMENT_M, { contains: [
+ VERBATIM_DELIMITED_BRACES(),
+ VERBATIM_DELIMITED_EQUAL()
+ ] })),
+ CSNAME('url', { contains: [
+ VERBATIM_DELIMITED_BRACES("link"),
+ VERBATIM_DELIMITED_BRACES("link")
+ ] }),
+ CSNAME('hyperref', { contains: [ VERBATIM_DELIMITED_BRACES("link") ] }),
+ CSNAME('href', ARGUMENT_AND_THEN(ARGUMENT_O, { contains: [ VERBATIM_DELIMITED_BRACES("link") ] })),
+ ...[].concat(...[
+ '',
+ '\\*'
+ ].map(suffix => [
+ BEGIN_ENV('verbatim' + suffix, VERBATIM_DELIMITED_ENV('verbatim' + suffix)),
+ BEGIN_ENV('filecontents' + suffix, ARGUMENT_AND_THEN(ARGUMENT_M, VERBATIM_DELIMITED_ENV('filecontents' + suffix))),
+ ...[
+ '',
+ 'B',
+ 'L'
+ ].map(prefix =>
+ BEGIN_ENV(prefix + 'Verbatim' + suffix, ARGUMENT_AND_THEN(ARGUMENT_O, VERBATIM_DELIMITED_ENV(prefix + 'Verbatim' + suffix)))
+ )
+ ])),
+ BEGIN_ENV('minted', ARGUMENT_AND_THEN(ARGUMENT_O, ARGUMENT_AND_THEN(ARGUMENT_M, VERBATIM_DELIMITED_ENV('minted')))),
+ ];
+
+ return {
+ name: 'LaTeX',
+ aliases: [ 'tex' ],
+ contains: [
+ ...VERBATIM,
+ ...EVERYTHING_BUT_VERBATIM
+ ]
+ };
+ }
+
+ return latex;
+
+})();
+
+ hljs.registerLanguage('latex', hljsGrammar);
+ })();/*! `less` grammar compiled for Highlight.js 11.10.0 */
+ (function(){
+ var hljsGrammar = (function () {
+ 'use strict';
+
+ const MODES = (hljs) => {
+ return {
+ IMPORTANT: {
+ scope: 'meta',
+ begin: '!important'
+ },
+ BLOCK_COMMENT: hljs.C_BLOCK_COMMENT_MODE,
+ HEXCOLOR: {
+ scope: 'number',
+ begin: /#(([0-9a-fA-F]{3,4})|(([0-9a-fA-F]{2}){3,4}))\b/
+ },
+ FUNCTION_DISPATCH: {
+ className: "built_in",
+ begin: /[\w-]+(?=\()/
+ },
+ ATTRIBUTE_SELECTOR_MODE: {
+ scope: 'selector-attr',
+ begin: /\[/,
+ end: /\]/,
+ illegal: '$',
+ contains: [
+ hljs.APOS_STRING_MODE,
+ hljs.QUOTE_STRING_MODE
+ ]
+ },
+ CSS_NUMBER_MODE: {
+ scope: 'number',
+ begin: hljs.NUMBER_RE + '(' +
+ '%|em|ex|ch|rem' +
+ '|vw|vh|vmin|vmax' +
+ '|cm|mm|in|pt|pc|px' +
+ '|deg|grad|rad|turn' +
+ '|s|ms' +
+ '|Hz|kHz' +
+ '|dpi|dpcm|dppx' +
+ ')?',
+ relevance: 0
+ },
+ CSS_VARIABLE: {
+ className: "attr",
+ begin: /--[A-Za-z_][A-Za-z0-9_-]*/
+ }
+ };
+ };
+
+ const HTML_TAGS = [
+ 'a',
+ 'abbr',
+ 'address',
+ 'article',
+ 'aside',
+ 'audio',
+ 'b',
+ 'blockquote',
+ 'body',
+ 'button',
+ 'canvas',
+ 'caption',
+ 'cite',
+ 'code',
+ 'dd',
+ 'del',
+ 'details',
+ 'dfn',
+ 'div',
+ 'dl',
+ 'dt',
+ 'em',
+ 'fieldset',
+ 'figcaption',
+ 'figure',
+ 'footer',
+ 'form',
+ 'h1',
+ 'h2',
+ 'h3',
+ 'h4',
+ 'h5',
+ 'h6',
+ 'header',
+ 'hgroup',
+ 'html',
+ 'i',
+ 'iframe',
+ 'img',
+ 'input',
+ 'ins',
+ 'kbd',
+ 'label',
+ 'legend',
+ 'li',
+ 'main',
+ 'mark',
+ 'menu',
+ 'nav',
+ 'object',
+ 'ol',
+ 'optgroup',
+ 'option',
+ 'p',
+ 'picture',
+ 'q',
+ 'quote',
+ 'samp',
+ 'section',
+ 'select',
+ 'source',
+ 'span',
+ 'strong',
+ 'summary',
+ 'sup',
+ 'table',
+ 'tbody',
+ 'td',
+ 'textarea',
+ 'tfoot',
+ 'th',
+ 'thead',
+ 'time',
+ 'tr',
+ 'ul',
+ 'var',
+ 'video'
+ ];
+
+ const SVG_TAGS = [
+ 'defs',
+ 'g',
+ 'marker',
+ 'mask',
+ 'pattern',
+ 'svg',
+ 'switch',
+ 'symbol',
+ 'feBlend',
+ 'feColorMatrix',
+ 'feComponentTransfer',
+ 'feComposite',
+ 'feConvolveMatrix',
+ 'feDiffuseLighting',
+ 'feDisplacementMap',
+ 'feFlood',
+ 'feGaussianBlur',
+ 'feImage',
+ 'feMerge',
+ 'feMorphology',
+ 'feOffset',
+ 'feSpecularLighting',
+ 'feTile',
+ 'feTurbulence',
+ 'linearGradient',
+ 'radialGradient',
+ 'stop',
+ 'circle',
+ 'ellipse',
+ 'image',
+ 'line',
+ 'path',
+ 'polygon',
+ 'polyline',
+ 'rect',
+ 'text',
+ 'use',
+ 'textPath',
+ 'tspan',
+ 'foreignObject',
+ 'clipPath'
+ ];
+
+ const TAGS = [
+ ...HTML_TAGS,
+ ...SVG_TAGS,
+ ];
+
+ // Sorting, then reversing makes sure longer attributes/elements like
+ // `font-weight` are matched fully instead of getting false positives on say `font`
+
+ const MEDIA_FEATURES = [
+ 'any-hover',
+ 'any-pointer',
+ 'aspect-ratio',
+ 'color',
+ 'color-gamut',
+ 'color-index',
+ 'device-aspect-ratio',
+ 'device-height',
+ 'device-width',
+ 'display-mode',
+ 'forced-colors',
+ 'grid',
+ 'height',
+ 'hover',
+ 'inverted-colors',
+ 'monochrome',
+ 'orientation',
+ 'overflow-block',
+ 'overflow-inline',
+ 'pointer',
+ 'prefers-color-scheme',
+ 'prefers-contrast',
+ 'prefers-reduced-motion',
+ 'prefers-reduced-transparency',
+ 'resolution',
+ 'scan',
+ 'scripting',
+ 'update',
+ 'width',
+ // TODO: find a better solution?
+ 'min-width',
+ 'max-width',
+ 'min-height',
+ 'max-height'
+ ].sort().reverse();
+
+ // https://developer.mozilla.org/en-US/docs/Web/CSS/Pseudo-classes
+ const PSEUDO_CLASSES = [
+ 'active',
+ 'any-link',
+ 'blank',
+ 'checked',
+ 'current',
+ 'default',
+ 'defined',
+ 'dir', // dir()
+ 'disabled',
+ 'drop',
+ 'empty',
+ 'enabled',
+ 'first',
+ 'first-child',
+ 'first-of-type',
+ 'fullscreen',
+ 'future',
+ 'focus',
+ 'focus-visible',
+ 'focus-within',
+ 'has', // has()
+ 'host', // host or host()
+ 'host-context', // host-context()
+ 'hover',
+ 'indeterminate',
+ 'in-range',
+ 'invalid',
+ 'is', // is()
+ 'lang', // lang()
+ 'last-child',
+ 'last-of-type',
+ 'left',
+ 'link',
+ 'local-link',
+ 'not', // not()
+ 'nth-child', // nth-child()
+ 'nth-col', // nth-col()
+ 'nth-last-child', // nth-last-child()
+ 'nth-last-col', // nth-last-col()
+ 'nth-last-of-type', //nth-last-of-type()
+ 'nth-of-type', //nth-of-type()
+ 'only-child',
+ 'only-of-type',
+ 'optional',
+ 'out-of-range',
+ 'past',
+ 'placeholder-shown',
+ 'read-only',
+ 'read-write',
+ 'required',
+ 'right',
+ 'root',
+ 'scope',
+ 'target',
+ 'target-within',
+ 'user-invalid',
+ 'valid',
+ 'visited',
+ 'where' // where()
+ ].sort().reverse();
+
+ // https://developer.mozilla.org/en-US/docs/Web/CSS/Pseudo-elements
+ const PSEUDO_ELEMENTS = [
+ 'after',
+ 'backdrop',
+ 'before',
+ 'cue',
+ 'cue-region',
+ 'first-letter',
+ 'first-line',
+ 'grammar-error',
+ 'marker',
+ 'part',
+ 'placeholder',
+ 'selection',
+ 'slotted',
+ 'spelling-error'
+ ].sort().reverse();
+
+ const ATTRIBUTES = [
+ 'accent-color',
+ 'align-content',
+ 'align-items',
+ 'align-self',
+ 'alignment-baseline',
+ 'all',
+ 'animation',
+ 'animation-delay',
+ 'animation-direction',
+ 'animation-duration',
+ 'animation-fill-mode',
+ 'animation-iteration-count',
+ 'animation-name',
+ 'animation-play-state',
+ 'animation-timing-function',
+ 'appearance',
+ 'backface-visibility',
+ 'background',
+ 'background-attachment',
+ 'background-blend-mode',
+ 'background-clip',
+ 'background-color',
+ 'background-image',
+ 'background-origin',
+ 'background-position',
+ 'background-repeat',
+ 'background-size',
+ 'baseline-shift',
+ 'block-size',
+ 'border',
+ 'border-block',
+ 'border-block-color',
+ 'border-block-end',
+ 'border-block-end-color',
+ 'border-block-end-style',
+ 'border-block-end-width',
+ 'border-block-start',
+ 'border-block-start-color',
+ 'border-block-start-style',
+ 'border-block-start-width',
+ 'border-block-style',
+ 'border-block-width',
+ 'border-bottom',
+ 'border-bottom-color',
+ 'border-bottom-left-radius',
+ 'border-bottom-right-radius',
+ 'border-bottom-style',
+ 'border-bottom-width',
+ 'border-collapse',
+ 'border-color',
+ 'border-image',
+ 'border-image-outset',
+ 'border-image-repeat',
+ 'border-image-slice',
+ 'border-image-source',
+ 'border-image-width',
+ 'border-inline',
+ 'border-inline-color',
+ 'border-inline-end',
+ 'border-inline-end-color',
+ 'border-inline-end-style',
+ 'border-inline-end-width',
+ 'border-inline-start',
+ 'border-inline-start-color',
+ 'border-inline-start-style',
+ 'border-inline-start-width',
+ 'border-inline-style',
+ 'border-inline-width',
+ 'border-left',
+ 'border-left-color',
+ 'border-left-style',
+ 'border-left-width',
+ 'border-radius',
+ 'border-right',
+ 'border-end-end-radius',
+ 'border-end-start-radius',
+ 'border-right-color',
+ 'border-right-style',
+ 'border-right-width',
+ 'border-spacing',
+ 'border-start-end-radius',
+ 'border-start-start-radius',
+ 'border-style',
+ 'border-top',
+ 'border-top-color',
+ 'border-top-left-radius',
+ 'border-top-right-radius',
+ 'border-top-style',
+ 'border-top-width',
+ 'border-width',
+ 'bottom',
+ 'box-decoration-break',
+ 'box-shadow',
+ 'box-sizing',
+ 'break-after',
+ 'break-before',
+ 'break-inside',
+ 'cx',
+ 'cy',
+ 'caption-side',
+ 'caret-color',
+ 'clear',
+ 'clip',
+ 'clip-path',
+ 'clip-rule',
+ 'color',
+ 'color-interpolation',
+ 'color-interpolation-filters',
+ 'color-profile',
+ 'color-rendering',
+ 'color-scheme',
+ 'column-count',
+ 'column-fill',
+ 'column-gap',
+ 'column-rule',
+ 'column-rule-color',
+ 'column-rule-style',
+ 'column-rule-width',
+ 'column-span',
+ 'column-width',
+ 'columns',
+ 'contain',
+ 'content',
+ 'content-visibility',
+ 'counter-increment',
+ 'counter-reset',
+ 'cue',
+ 'cue-after',
+ 'cue-before',
+ 'cursor',
+ 'direction',
+ 'display',
+ 'dominant-baseline',
+ 'empty-cells',
+ 'enable-background',
+ 'fill',
+ 'fill-opacity',
+ 'fill-rule',
+ 'filter',
+ 'flex',
+ 'flex-basis',
+ 'flex-direction',
+ 'flex-flow',
+ 'flex-grow',
+ 'flex-shrink',
+ 'flex-wrap',
+ 'float',
+ 'flow',
+ 'flood-color',
+ 'flood-opacity',
+ 'font',
+ 'font-display',
+ 'font-family',
+ 'font-feature-settings',
+ 'font-kerning',
+ 'font-language-override',
+ 'font-size',
+ 'font-size-adjust',
+ 'font-smoothing',
+ 'font-stretch',
+ 'font-style',
+ 'font-synthesis',
+ 'font-variant',
+ 'font-variant-caps',
+ 'font-variant-east-asian',
+ 'font-variant-ligatures',
+ 'font-variant-numeric',
+ 'font-variant-position',
+ 'font-variation-settings',
+ 'font-weight',
+ 'gap',
+ 'glyph-orientation-horizontal',
+ 'glyph-orientation-vertical',
+ 'grid',
+ 'grid-area',
+ 'grid-auto-columns',
+ 'grid-auto-flow',
+ 'grid-auto-rows',
+ 'grid-column',
+ 'grid-column-end',
+ 'grid-column-start',
+ 'grid-gap',
+ 'grid-row',
+ 'grid-row-end',
+ 'grid-row-start',
+ 'grid-template',
+ 'grid-template-areas',
+ 'grid-template-columns',
+ 'grid-template-rows',
+ 'hanging-punctuation',
+ 'height',
+ 'hyphens',
+ 'icon',
+ 'image-orientation',
+ 'image-rendering',
+ 'image-resolution',
+ 'ime-mode',
+ 'inline-size',
+ 'inset',
+ 'inset-block',
+ 'inset-block-end',
+ 'inset-block-start',
+ 'inset-inline',
+ 'inset-inline-end',
+ 'inset-inline-start',
+ 'isolation',
+ 'kerning',
+ 'justify-content',
+ 'justify-items',
+ 'justify-self',
+ 'left',
+ 'letter-spacing',
+ 'lighting-color',
+ 'line-break',
+ 'line-height',
+ 'list-style',
+ 'list-style-image',
+ 'list-style-position',
+ 'list-style-type',
+ 'marker',
+ 'marker-end',
+ 'marker-mid',
+ 'marker-start',
+ 'mask',
+ 'margin',
+ 'margin-block',
+ 'margin-block-end',
+ 'margin-block-start',
+ 'margin-bottom',
+ 'margin-inline',
+ 'margin-inline-end',
+ 'margin-inline-start',
+ 'margin-left',
+ 'margin-right',
+ 'margin-top',
+ 'marks',
+ 'mask',
+ 'mask-border',
+ 'mask-border-mode',
+ 'mask-border-outset',
+ 'mask-border-repeat',
+ 'mask-border-slice',
+ 'mask-border-source',
+ 'mask-border-width',
+ 'mask-clip',
+ 'mask-composite',
+ 'mask-image',
+ 'mask-mode',
+ 'mask-origin',
+ 'mask-position',
+ 'mask-repeat',
+ 'mask-size',
+ 'mask-type',
+ 'max-block-size',
+ 'max-height',
+ 'max-inline-size',
+ 'max-width',
+ 'min-block-size',
+ 'min-height',
+ 'min-inline-size',
+ 'min-width',
+ 'mix-blend-mode',
+ 'nav-down',
+ 'nav-index',
+ 'nav-left',
+ 'nav-right',
+ 'nav-up',
+ 'none',
+ 'normal',
+ 'object-fit',
+ 'object-position',
+ 'opacity',
+ 'order',
+ 'orphans',
+ 'outline',
+ 'outline-color',
+ 'outline-offset',
+ 'outline-style',
+ 'outline-width',
+ 'overflow',
+ 'overflow-wrap',
+ 'overflow-x',
+ 'overflow-y',
+ 'padding',
+ 'padding-block',
+ 'padding-block-end',
+ 'padding-block-start',
+ 'padding-bottom',
+ 'padding-inline',
+ 'padding-inline-end',
+ 'padding-inline-start',
+ 'padding-left',
+ 'padding-right',
+ 'padding-top',
+ 'page-break-after',
+ 'page-break-before',
+ 'page-break-inside',
+ 'pause',
+ 'pause-after',
+ 'pause-before',
+ 'perspective',
+ 'perspective-origin',
+ 'pointer-events',
+ 'position',
+ 'quotes',
+ 'r',
+ 'resize',
+ 'rest',
+ 'rest-after',
+ 'rest-before',
+ 'right',
+ 'rotate',
+ 'row-gap',
+ 'scale',
+ 'scroll-margin',
+ 'scroll-margin-block',
+ 'scroll-margin-block-end',
+ 'scroll-margin-block-start',
+ 'scroll-margin-bottom',
+ 'scroll-margin-inline',
+ 'scroll-margin-inline-end',
+ 'scroll-margin-inline-start',
+ 'scroll-margin-left',
+ 'scroll-margin-right',
+ 'scroll-margin-top',
+ 'scroll-padding',
+ 'scroll-padding-block',
+ 'scroll-padding-block-end',
+ 'scroll-padding-block-start',
+ 'scroll-padding-bottom',
+ 'scroll-padding-inline',
+ 'scroll-padding-inline-end',
+ 'scroll-padding-inline-start',
+ 'scroll-padding-left',
+ 'scroll-padding-right',
+ 'scroll-padding-top',
+ 'scroll-snap-align',
+ 'scroll-snap-stop',
+ 'scroll-snap-type',
+ 'scrollbar-color',
+ 'scrollbar-gutter',
+ 'scrollbar-width',
+ 'shape-image-threshold',
+ 'shape-margin',
+ 'shape-outside',
+ 'shape-rendering',
+ 'stop-color',
+ 'stop-opacity',
+ 'stroke',
+ 'stroke-dasharray',
+ 'stroke-dashoffset',
+ 'stroke-linecap',
+ 'stroke-linejoin',
+ 'stroke-miterlimit',
+ 'stroke-opacity',
+ 'stroke-width',
+ 'speak',
+ 'speak-as',
+ 'src', // @font-face
+ 'tab-size',
+ 'table-layout',
+ 'text-anchor',
+ 'text-align',
+ 'text-align-all',
+ 'text-align-last',
+ 'text-combine-upright',
+ 'text-decoration',
+ 'text-decoration-color',
+ 'text-decoration-line',
+ 'text-decoration-skip-ink',
+ 'text-decoration-style',
+ 'text-decoration-thickness',
+ 'text-emphasis',
+ 'text-emphasis-color',
+ 'text-emphasis-position',
+ 'text-emphasis-style',
+ 'text-indent',
+ 'text-justify',
+ 'text-orientation',
+ 'text-overflow',
+ 'text-rendering',
+ 'text-shadow',
+ 'text-transform',
+ 'text-underline-offset',
+ 'text-underline-position',
+ 'top',
+ 'transform',
+ 'transform-box',
+ 'transform-origin',
+ 'transform-style',
+ 'transition',
+ 'transition-delay',
+ 'transition-duration',
+ 'transition-property',
+ 'transition-timing-function',
+ 'translate',
+ 'unicode-bidi',
+ 'vector-effect',
+ 'vertical-align',
+ 'visibility',
+ 'voice-balance',
+ 'voice-duration',
+ 'voice-family',
+ 'voice-pitch',
+ 'voice-range',
+ 'voice-rate',
+ 'voice-stress',
+ 'voice-volume',
+ 'white-space',
+ 'widows',
+ 'width',
+ 'will-change',
+ 'word-break',
+ 'word-spacing',
+ 'word-wrap',
+ 'writing-mode',
+ 'x',
+ 'y',
+ 'z-index'
+ ].sort().reverse();
+
+ // some grammars use them all as a single group
+ const PSEUDO_SELECTORS = PSEUDO_CLASSES.concat(PSEUDO_ELEMENTS).sort().reverse();
+
+ /*
+ Language: Less
+ Description: It's CSS, with just a little more.
+ Author: Max Mikhailov <se...@gmail.com>
+ Website: http://lesscss.org
+ Category: common, css, web
+ */
+
+
+ /** @type LanguageFn */
+ function less(hljs) {
+ const modes = MODES(hljs);
+ const PSEUDO_SELECTORS$1 = PSEUDO_SELECTORS;
+
+ const AT_MODIFIERS = "and or not only";
+ const IDENT_RE = '[\\w-]+'; // yes, Less identifiers may begin with a digit
+ const INTERP_IDENT_RE = '(' + IDENT_RE + '|@\\{' + IDENT_RE + '\\})';
+
+ /* Generic Modes */
+
+ const RULES = []; const VALUE_MODES = []; // forward def. for recursive modes
+
+ const STRING_MODE = function(c) {
+ return {
+ // Less strings are not multiline (also include '~' for more consistent coloring of "escaped" strings)
+ className: 'string',
+ begin: '~?' + c + '.*?' + c
+ };
+ };
+
+ const IDENT_MODE = function(name, begin, relevance) {
+ return {
+ className: name,
+ begin: begin,
+ relevance: relevance
+ };
... 9416 lines suppressed ...
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@datafusion.apache.org
For additional commands, e-mail: commits-help@datafusion.apache.org