[
https://issues.apache.org/jira/browse/CASSANDRA-21315?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=18088875#comment-18088875
]
Michael Semb Wever commented on CASSANDRA-21315:
------------------------------------------------
bq. the differences between a local build and a remote one don't match up.
they should, if you follow the same steps. the only difference is at runtime
with how ASF httpd server serves the contents (and if you're browsing local as
file:/// instead of https://)
> Upgrade cassandra-website antora version from 2 to 3
> ----------------------------------------------------
>
> Key: CASSANDRA-21315
> URL: https://issues.apache.org/jira/browse/CASSANDRA-21315
> Project: Apache Cassandra
> Issue Type: Improvement
> Components: Documentation/Website
> Reporter: Patrick McFadin
> Assignee: Patrick McFadin
> Priority: Normal
> Fix For: NA
>
> Time Spent: 1h 10m
> Remaining Estimate: 0h
>
> The `apache/cassandra-website` docs build pipeline runs Antora 2.3. Upgrading
> to the latest, v 3.1.14. This will require bumping versions on several
> projects.
> Changes required:
>
> `site-content/Dockerfile`
> - Node.js: `v20.16.0` → `v24.14.1` (current active LTS; SHA256 verified for
> linux/amd64 and linux/arm64)
> - Replace `@antora/[email protected]` and `@antora/[email protected]` with
> `@antora/[email protected]` and `@antora/[email protected]`
> - Replace `antora-lunr` and `antora-site-generator-lunr` with
> `@antora/lunr-extension`
> `site-content/docker-entrypoint.sh`
> - Remove `--generator antora-site-generator-lunr` flag from the Antora
> invocation
> - Remove `DOCSEARCH_ENABLED`, `DOCSEARCH_ENGINE=lunr`, `NODE_PATH`, and
> `DOCSEARCH_INDEX_VERSION` env exports (required only by the deprecated Antora
> 2 custom generator)
> `site-content/site.template.yaml`
> - Add `antora.extensions` block registering `@antora/lunr-extension` (Antora
> 3 extension registration model)
> - `asciidoc.extensions` (`tabs-block.js`, `@djencks/asciidoctor-openblock`)
> left unchanged
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
