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
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions