gudhi-devel icon indicating copy to clipboard operation
gudhi-devel copied to clipboard

Strange-looking bibtex entry

Open mglisse opened this issue 2 years ago • 7 comments

biblio

The entry for Garland Heckbert in the bibliography currently looks strange.

Reported to doxygen at https://github.com/doxygen/doxygen/issues/9344

mglisse avatar Mar 22 '22 19:03 mglisse

I've just pushed a proposed patch, pull request doxygen/doxygen#9345

albert-github avatar May 18 '22 10:05 albert-github

a bit off-topic for this issue:

Based on this issue I was interested in building the GUDHI documentation and see what kind of problems there are, on the doxygen side, in the GUDHI documentation. Looking at e.g. https://gudhi.inria.fr/doc/latest/dir_d44c64559bbebec7f509842c48db8b23.html I saw:

image

which is probably due to an old version of the used footer for the HTML Page.

I forked and cloned the repository gudhi-devel and I also did the git submodule update --init and tried to run CMake but this failed as I don't have Boost (and I'm only interested in the documentation, so no intention of installing Boost).

  • What is the best way to generate the documentation

(Note: In the CGAL project there is e.g the possibility cmake ../Documentation/doc so that just the documentation can be build and afterward I can run make doc && make doc or even just one manual with some special targets).

albert-github avatar May 18 '22 11:05 albert-github

I think if you edit src/cmake/modules/GUDHI_third_party_libraries.cmake and remove the word FATAL_ERROR on line 7, then it is likely to work (after running cmake, you want make doxygen).

mglisse avatar May 18 '22 12:05 mglisse

Thanks, I'll give it a try.

Now the process gets a bit further, but stops at a problem with QT, but I will look into it (as I have a QT version lying around at a non default place).

albert-github avatar May 18 '22 12:05 albert-github

Thanks Marc. I now succeeded in finishing the CMake step, in src/GudhUI/CMakeLists.txt I rep[laced on line 6 if (OPENGL_FOUND) by if (OPENGL_FOUND1). I can now run make doxygen (well in my case nmake doxygen).

So now I can start to do some tests and suggest some improvements etc.

albert-github avatar May 18 '22 12:05 albert-github

a bit off-topic for this issue:

Based on this issue I was interested in building the GUDHI documentation and see what kind of problems there are, on the doxygen side, in the GUDHI documentation. Looking at e.g. https://gudhi.inria.fr/doc/latest/dir_d44c64559bbebec7f509842c48db8b23.html I saw:

image

which is probably due to an old version of the used footer for the HTML Page.

I created #613 for not to miss this point.

VincentRouvreau avatar May 20 '22 08:05 VincentRouvreau

Code of doxygen/doxygen#9345 has been integrated in master version of doxygen on GitHub.

albert-github avatar May 21 '22 07:05 albert-github

Tested with conda package doxygen 1.9.5 and I can confirm it is fixed by https://github.com/doxygen/doxygen/pull/9345 Screenshot from 2022-09-16 16-15-49. As #699 advises to use doxygen 1.9.5, I close the issue.

VincentRouvreau avatar Sep 16 '22 14:09 VincentRouvreau