Skip to content

Default CSS for pldoc needs a little change #42

@dtonhofer

Description

@dtonhofer

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>

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions