Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Generated reference HTML doc element color is black #373

Open
redboltz opened this issue Dec 7, 2024 · 3 comments
Open

Generated reference HTML doc element color is black #373

redboltz opened this issue Dec 7, 2024 · 3 comments

Comments

@redboltz
Copy link

redboltz commented Dec 7, 2024

Overview

I cloned this repository and generated the documentation using build_antora.sh in my local (Linux) environment.
The documentation was successfully generated, but I noticed an issue with the reference page (doc/build/site/url/reference.html). Specifically, the table elements (links to classes and functions) appear in bold black text. I believe these should be blue, as they used to be.
Other pages do not seem to have this issue.

Environment

  • node
    • v22.12.0
    • v16.20.2
  • Boost.URL
    • develop branch f93091350464891339c11a7a2e3c95f49e92404
  • Browser
    • Google Chrome 131.0.6778.108(Official Build) (64bit)
  • OS
    • Linux 6.12.1-arch1-1

Steps to reproduce

 git clone https://github.com/boostorg/url
cd url/doc
./build_antora.sh

Attached files

@alandefreitas alandefreitas transferred this issue from boostorg/url Dec 7, 2024
@vinniefalco
Copy link
Member

We made an editorial decision that when there are only hyperlinks in a table or list, they would not be rendered in blue. I am not sure this was the right choice. That said, I am not yet happy with this styling. The styles come from this repo FYI: https://github.com/boostorg/boostlook

Thanks

@redboltz
Copy link
Author

redboltz commented Dec 7, 2024

Thank you for your prompt response. I was curious about what caused this change, but now I understand it well.
I believe that while the color of the links is less important, it’s crucial to have a clear distinction between category items like Enums and Type Traits and the actual link elements within the table.

@vinniefalco
Copy link
Member

This is the direction they are going in
Image

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants