[
https://issues.apache.org/jira/browse/CASSANDRA-21315?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=18088875#comment-18088875
]
Michael Semb Wever edited comment on CASSANDRA-21315 at 6/14/26 9:35 AM:
-------------------------------------------------------------------------
bq. the differences between a local build and a remote one don't match up.
they should match, 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://)
was (Author: michaelsembwever):
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]
