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

Incorrect representation of master overnight documentation build #8645

Open
albert-github opened this issue Dec 5, 2024 · 0 comments
Open
Assignees
Labels

Comments

@albert-github
Copy link
Contributor

albert-github commented Dec 5, 2024

When looking at the overnight documentation builds through https://cgal.geometryfactory.com/CGAL/Manual_doxygen_test/ we see when:

  • for each of the available builds (1.8.13, 1.9.6, master)
    • click the version
    • click in the left hand tree "Package Overview"
    • select the "User Manual" of the first package ("Algebraic Foundations")

We see for:

1.8.13

Image

1.9.6

Image

master

Image

My analysis:

In he HTML source of the 1.8.13 and 1.9.6 versions we see:

<!-- This should probably be an extrastylesheet instead of hardcoded. -->
<link href="../Manual/cgal_stylesheet.css rel="stylesheet" type="text/css">

and later on

<link href="cgal_stylesheet.css" rel="stylesheet" type="text/css">

Though in the master version we only see:

<link href="cgal_stylesheet.css" rel="stylesheet" type="text/css">

This setting is due to the, correct, setting, in BaseDoxyfile.in, of

HTML_EXTRA_STYLESHEET  = ${CGAL_DOC_RESOURCE_DIR}/cgal_stylesheet.css

but the file is not copied to the relevant package directories when copying the files from the build directories to the "display" directories (https://cgal.geometryfactory.com/CGAL/Manual_doxygen_test).
That the 1.8.13 and 1.9.6 versions do work is probably due to the double setting and the fact that the the css file(s) of the Manual directory is(are) copied.

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

No branches or pull requests

3 participants