TeX utils needed for make webdoc

6 views
Skip to first unread message

Grégory Vanuxem

unread,
Apr 6, 2026, 7:52:53 AM (5 days ago) Apr 6
to fricas...@googlegroups.com
Hello,

Any idea why some TeX utilities are needed for 'make webdoc'?

I added texlive-font-utils for a Debian based Linux distribution for
'epstopdf' but later tensor.sty is also needed. I do not want to add
texlive-science and I do not see the point to add La(TeX) and other
utilities to build the html documentation. I wonder why. Personally I
use a quick (and dirty hack) in the main Makefile.in:

# Ugly (and temporary) hack
# src/doc/Makefile.in should be modified instead
htmldoc: all-src
cd src/doc; ${MAKE} stamp-html; \
cp -rf tmp/sphinx/build/html/* $(fricas_target_datadir)/doc/html/

I don't think (La)TeX things are necessary for pure HTML documentation
but I may be wrong, am I missing something here?

In fact I would like to remove this ugly hack, at least the "cd
src/doc; ${MAKE} stamp-html;" part.

Greg

Ralf Hemmecke

unread,
Apr 6, 2026, 9:28:22 AM (5 days ago) Apr 6
to fricas...@googlegroups.com
Hi Greg,

as far as I remember, you actually do not need LaTeX and friends.
The actual reason why webdoc depends on LaTeX is that webdoc creates a
website that links to the Book. So if the book is not compiled then
there would potentially be a broken link.

I think this is the stanza you should modify.

stamp-doc: book stamp-html
-rm -rf html
cp -R tmp/sphinx/build/html .
cp book.pdf html
${STAMP} $@

Simply remove everything connected to book and it should work. (Hopefully.)

Ralf

Grégory Vanuxem

unread,
Apr 7, 2026, 2:53:19 AM (4 days ago) Apr 7
to fricas...@googlegroups.com
Hello Ralf,

I better understand thanks, the webdoc target is for the official
FriCAS GitHub web site. Since 'make htmldoc' is intended to install
the HTML documentation locally I will keep it as it is, I added to the
':install' target of the main Makefile.in its installation. It is
intended to be available through fricas-vscode or manually. The link
to the book.pdf in my settings points to the official FriCAS user
guide so this is not a problem.

Greg

Le lun. 6 avr. 2026 à 15:28, 'Ralf Hemmecke' via FriCAS - computer
algebra system <fricas...@googlegroups.com> a écrit :
> --
> You received this message because you are subscribed to the Google Groups "FriCAS - computer algebra system" group.
> To unsubscribe from this group and stop receiving emails from it, send an email to fricas-devel...@googlegroups.com.
> To view this discussion visit https://groups.google.com/d/msgid/fricas-devel/7b5f01dd-8bfa-4540-96c9-c281af864286%40hemmecke.org.
Reply all
Reply to author
Forward
0 new messages