Math symbols not displayed correctly in debian package documentation for deal.ii

[Gerald Marewo]

Dear all,

I have noticed that unlike the online documentation (deal.ii 8.4.2) which behaves well, the documentation that comes with the Debian package (libdeal.ii-doc) on Debian stretch does not display the math symbols correctly. Instead it displays the LaTeX code as it is. Once in a while I need to read the documentation offline.

Could you please assist me with solving this problem?

Regards.

Gerald.

[Gerald Marewo]

PS: I use Firefox.

Regards.

Gerald.

[David Wells]

Hi Gerald,

I am not sure how to fix this, but a good workaround would be to just
download the offline documentation tarball from here

https://github.com/dealii/dealii/releases/tag/v8.4.2

(its under assets at the bottom of the page) and use that directly
instead of the Debian package. Our generic offline documentation does
not use MathJax so it should always work.

Thanks,
David

> --
> The deal.II project is located at http://www.dealii.org/
> For mailing list/forum options, see https://groups.google.com/d/forum/dealii?hl=en
> ---
> You received this message because you are subscribed to the Google Groups "deal.II User Group" group.
> To unsubscribe from this group and stop receiving emails from it, send an email to dealii+un...@googlegroups.com.
> To view this discussion on the web visit https://groups.google.com/d/msgid/dealii/53bbac30-9df4-441d-90bf-52c9faf18b5e%40googlegroups.com.

[Matthias Maier]

Dear Gerald,

Thanks a lot for pointing out this issue. I will have a look into it.

Best,
Matthias

[Matthias Maier]

Now I understand what happend.

The Debian package downloads the current offline documentation tarball
in which we use mathjax for formula rendering. Unfortunately, all
external links/resources in the documentation are getting removed in the
debian package (otherwise the package QA system detects a "privacy
breach" in the documentation and the package gets rejected).

This hasn't been a problem with the older tarballs in which we still
used latex to directly generate images.

I will try to resolve this in the near future by specifically creating
an "offline" documentation tarball. (You will need that one for reading
the documentation offline without internet anyway.)

I will keep you posted.

Best,
Matthias

[Gerald Marewo]

Dear David,

Thank you for the advice. It sounds like a plan. 

Regards. 

Gerald. 

To view this discussion on the web visit https://groups.google.com/d/msgid/dealii/CABrTbYS5f-MAcLEOS4pr7PgbPEye8YXCzGq1FSJNxK%2B8E0TdXQ%40mail.gmail.com.

[Gerald Marewo]

You are welcome. 

--
The deal.II project is located at http://www.dealii.org/
For mailing list/forum options, see https://groups.google.com/d/forum/dealii?hl=en
---
You received this message because you are subscribed to the Google Groups "deal.II User Group" group.
To unsubscribe from this group and stop receiving emails from it, send an email to dealii+un...@googlegroups.com.

To view this discussion on the web visit https://groups.google.com/d/msgid/dealii/87zhexlxpv.fsf%4043-1.org.

[Gerald Marewo]

Dear Matthias,

Thank you for the advice.

As per David's advice I download the offiline documentation for my personal laptop. Sorted.

Best wishes with a future version of the docs.

Regards.

Gerald.