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

Default CSS for pldoc needs a little change #42

Open
dtonhofer opened this issue Feb 17, 2021 · 0 comments
Open

Default CSS for pldoc needs a little change #42

dtonhofer opened this issue Feb 17, 2021 · 0 comments

Comments

@dtonhofer
Copy link
Contributor

dtonhofer commented Feb 17, 2021

I suppose this is the correct project to report this.

It's an issue that also exists on the SWI-Prolog manual website, when adding comments.

I'm currently trying to run doc-server on a dedicated machine.

When I take a look at documentation which contains headings that contain (automatically inserted) links to predicates, one sees (ore rather one fails to see):

Links in the header

The links are rendered in blue-on-blue.

Here, they are actually still visible, but in the SWI-Prolog manual comments they are the exact same blue (unless there is no predicate for a predicate indicator, in which case they are rendered in red)

The workaround is to use the mathematical dash ∕ (0x2215) instead of / to fool the link generator into not generating links for predicate indicators. But that's a bad solution.

This is the URL for the source (for the currently live docserver but for some reason, a lot of the links go haywire, not sure why yet or even how to report that, that's another problem):

https://repo.onepointfour.be/pldoc/pack/onepointfour_basics/prolog/safe_format.pl?show=src

The HTML reveals the selector to be module.builtin for the link to format/3 but sadly no specific class for the first link.

<h1 class="module">
Provides
<a href="/pldoc/doc/home/swipl/.local/share/swi-prolog/pack/onepointfour_basics/prolog/safe_format.pl#safe_format/3">safe_format/3</a>,
a safe version of 
<a class="builtin" href="/pldoc/man?predicate=format/3">format/3</a>
</h1>
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

1 participant