Skip to content

Conversation

@PDavid
Copy link
Contributor

@PDavid PDavid commented Oct 14, 2025

Replace reflow-default-webdeps with separate webjar dependencies because reflow-default-webdeps causes a Maven ERROR in the build log and Yetus build considers the site build to be broken.

Turned off these features in the site skin which we don't need and would require to add more JavaScript:

  • highlight.js,
  • lightbox.js,
  • smooth scrolling.

Improved code blocks style to look good without highlight.js.

Also extracted MathJax.js and fontawesome (needed for RefGuide) versions to Maven properties.

…eflow-default-webdeps

Reason: reflow-default-webdeps causes a Maven ERROR and Yetus build considers the site build to be broken.

Turned off these features in the site skin which we don't need and would require to add more JavaScript:
- highlight.js,
- lightbox.js,
- smooth scrolling.

Improved code blocks style to look good without highlight.js.

Also extracted MathJax.js and fontawesome (needed for RefGuide) versions to Maven properties.
@PDavid PDavid self-assigned this Oct 14, 2025
@PDavid PDavid added the bug label Oct 14, 2025
@PDavid
Copy link
Contributor Author

PDavid commented Oct 14, 2025

Implemented this based on how reflow-default-webdeps pom.xml gathers these dependencies except the problematic hightlight.js:
https://repo1.maven.org/maven2/io/github/devacfr/maven/skins/reflow-default-webdeps/2.3.3/reflow-default-webdeps-2.3.3.pom

Tested this the following way:

Built the site locally by executing the command which yetus runs, then server the site locally via HTTP server:

mvn --batch-mode  clean site -pl . -Dtest=NoUnitTests -DHBasePatchProcess -Prelease -Dmaven.javadoc.skip=true -Dcheckstyle.skip=true -Dspotbugs.skip=true

...

cd target/site

python3 -m http.server

The Maven build log does not contain [ERROR] - OK ✔️

site-build.log

The website is functional - no missing JS, CSS, webfont, no error on browser developer console - OK ✔️

image image

RefGuide looks good - fontawesome icons and mathematical formulas are displayed - OK ✔️

image

@PDavid PDavid marked this pull request as ready for review October 14, 2025 15:35
@PDavid PDavid requested review from Apache9, ndimiduk and stoty October 14, 2025 15:35
@Apache-HBase

This comment has been minimized.

@Apache-HBase

This comment has been minimized.

instead of downloading it from a URL. We prefer maven resource as it can be cached locally.
Comment on lines +33 to +36
background-color: #f5f5f5;
border-radius: 6px;
border: 1px solid rgba(0, 0, 0, 0.15);
padding: 10px;
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Improved code blocks style to look good without highlight.js.

@PDavid PDavid changed the title HBASE-29659 Use separate webjar dependencies for website instead of reflow-default-webdeps HBASE-29659 Replace reflow-default-webdeps to fix site build failure Oct 15, 2025
@PDavid PDavid requested a review from ndimiduk October 15, 2025 08:01
Copy link
Member

@ndimiduk ndimiduk left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice, thanks @PDavid

Copy link
Contributor

@Apache9 Apache9 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tried to build site locally with this PR in, no problem.

Thanks @PDavid !

@Apache-HBase
Copy link

🎊 +1 overall

Vote Subsystem Runtime Logfile Comment
+0 🆗 reexec 0m 30s Docker mode activated.
_ Prechecks _
+1 💚 dupname 0m 0s No case conflicting files found.
+0 🆗 codespell 0m 1s codespell was not available.
+0 🆗 detsecrets 0m 1s detect-secrets was not available.
+1 💚 @author 0m 0s The patch does not contain any @author tags.
_ master Compile Tests _
+1 💚 mvninstall 3m 49s master passed
+1 💚 compile 8m 25s master passed
+1 💚 mvnsite 7m 41s master passed
+1 💚 spotless 0m 57s branch has no errors when running spotless:check.
_ Patch Compile Tests _
+1 💚 mvninstall 3m 7s the patch passed
+1 💚 compile 8m 26s the patch passed
+1 💚 javac 8m 26s the patch passed
+1 💚 blanks 0m 1s The patch has no blanks issues.
+1 💚 mvnsite 7m 14s the patch passed
+1 💚 xmllint 0m 0s No new issues.
+1 💚 hadoopcheck 12m 16s Patch does not cause any errors with Hadoop 3.3.6 3.4.1.
+1 💚 spotless 0m 46s patch has no errors when running spotless:check.
_ Other Tests _
+1 💚 asflicense 0m 13s The patch does not generate ASF License warnings.
61m 30s
Subsystem Report/Notes
Docker ClientAPI=1.43 ServerAPI=1.43 base: https://ci-hbase.apache.org/job/HBase-PreCommit-GitHub-PR/job/PR-7386/2/artifact/yetus-general-check/output/Dockerfile
GITHUB PR #7386
Optional Tests dupname asflicense javac codespell detsecrets xmllint hadoopcheck spotless compile mvnsite
uname Linux ae503b5af1f3 5.4.0-1103-aws #111~18.04.1-Ubuntu SMP Tue May 23 20:04:10 UTC 2023 x86_64 x86_64 x86_64 GNU/Linux
Build tool maven
Personality dev-support/hbase-personality.sh
git revision master / 7befc9c
Default Java Eclipse Adoptium-17.0.11+9
Max. process+thread count 188 (vs. ulimit of 30000)
modules C: . U: .
Console output https://ci-hbase.apache.org/job/HBase-PreCommit-GitHub-PR/job/PR-7386/2/console
versions git=2.34.1 maven=3.9.8 xmllint=20913
Powered by Apache Yetus 0.15.0 https://yetus.apache.org

This message was automatically generated.

@PDavid
Copy link
Contributor Author

PDavid commented Oct 16, 2025

The PR build timed out. I'm merging this now to fix the RefGuide build on master. If we see any issues there we can still fix them.

@PDavid PDavid merged commit fafa03c into apache:master Oct 16, 2025
1 check failed
@PDavid PDavid deleted the HBASE-29659-fix-refguide-build-error branch October 16, 2025 07:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants