On Sun, Sep 22, 2024 at 08:40:18AM +0800, Qian Yun wrote: > > > On 9/22/24 12:00 AM, Waldek Hebisch wrote: > > On Sat, Sep 21, 2024 at 07:24:37PM +0800, Qian Yun wrote: > > > Hi Ralf, > > > > > > 1. This site is still for 1.3.10 version. I guess you are > > > too busy to update it? > > > > > > I can give it a try to update for 1.3.11. I'll open a PR > > > for you to review. > > > > > > 2. The main reason is that I want the new reference book > > > to show in the documentation site. > > > > I have put book pdf at: > > > > http://wiki.fricas.org/public/book.pdf > > > > and linked result of API build at > > > > http://fricas.org/ > > I didn't noticed that this site has the updated version of API doc. > > I think fricas.github.io and fricas.org/api should not diverge.
I just put the pages there. One reason was to check how well the process works, as I wrote I had to build documentation 2 times, first time documentation build failed. But together it was few minutes of CPU time and maybe 30 seconds of manual work. Concerning "diverge", IIUC github.io is limited to static pages. At fricas.org we can install a generator for dynamic content, so potentially we can have more things. But this depends on what people doing work want to do. Anyway, installing update on fricas.org is trivial. I assumed that the same holds for fricas.github.io, at least for people doing this (for me it is impossible task due to github security nonsense). > I take a look into the source file, seems that the links are all > internal, meaning that the same set of static files can be > deployed to both sites without modification. Except for the toplevel page (which is written by hand) other pages at fricas.org are result of documentation build. To say the truth, there is also some experimental stuff at fricas.org, but there are no external links to it, so it is hidden from normal visitors. > > (this also contains copy of the book). > > > > > I suggest to change the link from > > > https://fricas.github.io/book.pdf > > > to > > > https://github.com/fricas/fricas/releases/download/1.3.11/fricas-1.3.11-reference-book.pdf > > > > > > So that the download statistics can be collected. > > What do you think of this proposal? Removing the pdf from the site, > and putting a link to GitHub release page instead. > > Currently the pdf files are bloating the repo > https://github.com/fricas/fricas.github.io > to over 77MB. It is not clear to me what download statistics really mean. Namely, for moderately used site most downloads is from robots. High profile sites tends to deploy various anti-robot means. But IMO anti-robot means are major inconvenience for normal users. For source code archive one can hope that most robots will ignore it. OTOH .pdf is much more likely to be downloaded by a robot. -- Waldek Hebisch -- 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 [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/fricas-devel/Zu_3WPjwM-Y6pZ8c%40fricas.org.
