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

No Bibliography #21

Open
jannesklee opened this issue Jan 10, 2017 · 2 comments
Open

No Bibliography #21

jannesklee opened this issue Jan 10, 2017 · 2 comments

Comments

@jannesklee
Copy link

If I use the theme my whole Bibliography vanishes. The references are fine and linking to the empty Bibliography. If I remove header, footer, extra_stylesheet and extra_files the Bibliography is available.
Doxygen-version: 1.8.11

@fredRos
Copy link

fredRos commented Apr 6, 2017

Same problem here with doxygen 1.8.8. The bibliography in pdf via latex is fine and also worked fine before I used this bootstrap theme.
Here is some output from doxygen that may help but I couldn't figure out how to pinpoint the problem, I looked into customdoxygen.css but saw nothing related to bibliography.

...
Generating docs for page citelist...
citelist:12: warning: Unexpected new line character
citelist:13: warning: Unexpected new line character
citelist:24: warning: Unexpected new line character
citelist:39: warning: Unexpected new line character
citelist:51: warning: Unexpected new line character
citelist:53: warning: Unexpected new line character
citelist:54: warning: Unexpected new line character
citelist:63: warning: Unexpected new line character
citelist:64: warning: Unexpected new line character
citelist:65: warning: Unexpected new line character
citelist:66: warning: Unexpected new line character
citelist:67: warning: Unexpected new line character
citelist:80: warning: Unexpected new line character
citelist:81: warning: Unexpected new line character
citelist:82: warning: Unexpected new line character
citelist:83: warning: Unexpected new line character
Generating group documentation...
...

A similar problem is that certain sections like @see ... are also missing from html but displayed correctly in pdf

@fredRos
Copy link

fredRos commented Apr 12, 2017

I have very little experience with css and basically no clue of
javascript but looking into the source code of citelist.html, all
the entries are there. They are simply not rendered. Usually a browser
would apply default markup to an unknown class, so I thought I should
peek into doxyboot.js. I saw that it replaces a lot of elements to
give it the bootstrap look. The non-rendering is caused by
removing the description list <dl> which includes citelist,
todo, and others. The offending line is

$('.contents > .textblock > dl').remove();

After commenting it out, I get back the bibliography, todo, see also... sections. Perhaps the rendering it not as it should be with bootstrap but it at least it is rendered and it looks ok to me.

I found this workaround, the clean but tedious way would be to expand doxy-boot.js and rewrite classes for all these doxygen sections, and in particular to fix this code https://github.com/Velron/doxygen-bootstrapped/blob/master/doxy-boot.js#L225 that doesn't render todos but removes all such sections mapped to <div class="textblock"><dl class="todo">

  /* todo list */
  var todoelements = $('.contents > .textblock > dl.reflist > dt, .contents > .textblock > dl.reflist > dd');
  for (var i = 0; i < todoelements.length; i += 2) {
    $('.contents > .textblock').append(
      '<div class="panel panel-default active">'
        + "<div class=\"panel-heading todoname\">" + $(todoelements[i]).html() + "</div>"
        + "<div class=\"panel-body\">" + $(todoelements[i+1]).html() + "</div>"
      + '</div>');
  }
  $('.contents > .textblock > dl').remove();

fredRos pushed a commit to bat/bat that referenced this issue Apr 12, 2017
fredRos pushed a commit to bat/bat that referenced this issue Jun 21, 2017
fredRos pushed a commit to fredRos/bat that referenced this issue Mar 21, 2018
fredRos pushed a commit to bat/bat that referenced this issue Apr 18, 2018
fredRos pushed a commit to bat/bat that referenced this issue Apr 20, 2018
fredRos pushed a commit to bat/bat that referenced this issue Apr 20, 2018
fredRos pushed a commit to bat/bat that referenced this issue Apr 24, 2018
fredRos pushed a commit to bat/bat that referenced this issue May 7, 2018
fredRos pushed a commit to bat/bat that referenced this issue May 7, 2018
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

2 participants