On 9/22/24 6:54 PM, Waldek Hebisch wrote:
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,
Yes, I meant fricas.github.io and fricas.org/api should have the
same content. I noticed that you have fricas.org/index0.html.
Except for the toplevel page (which is written by hand) other
pages at fricas.org are result of documentation build.
That's good to know. So I'll try to update fricas.github.io.
And in the future, if https://github.com/fricas/fricas.github.io
gets updated timely, you can simply copy its content instead of
building the site yourself.
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.
There's download statistics in sourceforge. There's also download
statistics for github:
curl https://api.github.com/repos/fricas/fricas/releases/tags/1.3.11
| grep -E 'name|download_count'
"name": "Release 1.3.11",
"name": "fricas-1.3.11-full.tar.bz2",
"download_count": 115,
"name": "fricas-1.3.11-macOS-arm64-unsigned.dmg",
"download_count": 22,
"name": "fricas-1.3.11-macOS-x86-64-unsigned.dmg",
"download_count": 8,
"name": "fricas-1.3.11-reference-book.pdf",
"download_count": 77,
"name": "fricas-1.3.11-windows-x64.zip",
"download_count": 139,
"name": "fricas-1.3.11.amd64.tar.bz2",
"download_count": 32,
"name": "Notes-1.3.11.txt",
"download_count": 26,
"name": "sha256sum-1.3.11.txt",
"download_count": 8,
If we host the reference book in one location, then we can get a
more accurate statistics on how many people have downloaded the book.
- Qian
--
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/a088f312-58e3-41d1-9aa3-1d8f5fab4643%40gmail.com.
