sagemath.org/doc/

[Ralf Stephan]

Hi,

with all the fine changes to docs in 6.2, the web docs are still at 6.1.1.

Can you please update the pages?

Regards,

[leif]

(weekly?) ping


-leif

--
() The ASCII Ribbon Campaign
/\ Help Cure HTML E-Mail

[kcrisman]

On Monday, May 26, 2014 8:47:36 PM UTC-4, leif wrote:

Ralf Stephan wrote:
> Hi,
> with all the fine changes to docs in 6.2, the web docs are still at 6.1.1.
>
> Can you please update the pages?

(weekly?) ping

I think that one has to cc: the webmaster, who (very understandably!) does not read every sage-devel post.

[Vincent Delecroix]

2014-05-27 17:08 UTC+02:00, kcrisman <kcri...@gmail.com>:

Hi Harald,

Could you confirm/infirm that you are in charge of updating the docs
of Sage on sagemath.org? http://www.sagemath.org/doc is still pointing
to the 6.1.1 version of the documentation.

Best,
Vincent

[Harald Schilly]

Well, I don't know if my really in charge - there is no formal
assignment of tasks. I've attended a conference the last few days and
barely had time to sleep. I'm aware that this is still one of several
open tasks.

Harald


On Mon, Jun 2, 2014 at 9:46 AM, Vincent Delecroix

[Nathann Cohen]

I sent an email to Minh yesterday. I thought that he was in charge of that ?...

Nathann

[Harald Schilly]

On Monday, June 2, 2014 1:31:37 PM UTC+2, Nathann Cohen wrote:

I sent an email to Minh yesterday. I thought that he was in charge of that ?...

He was, but AFAIK he is busy with other projects/things/life ...

To give you an impression why this takes so long: I have to build sage to compile the documentation. This is inside this new VM. So, first, m4 was not installed -- that's easy to fix. Then, atlas did tune itself to hell -> re-discovered and already forgot again the flag to teach it not to do this. Ok. Now I checked back, and it didn't finish to compile. The reason is, pynac complains about some python paths when you try compiling it as root.
Besides that, I think about just using the binary distribution, but I remember Minh once told me that one has to do this from source to get all the necessary files for the documentation. Maybe that's not true any more, IDK...

H

[Volker Braun]

Whats the command to build the documentation for the web page? Maybe it would be easy to simply add that to the release workflow.

[Harald Schilly]

On Mon, Jun 2, 2014 at 8:28 PM, Volker Braun <vbrau...@gmail.com> wrote:
> Whats the command to build the documentation for the web page? Maybe it
> would be easy to simply add that to the release workflow.

It uses the files directly from the /doc subdirectory. I.e. there is a
script from Minh which creates the zip files, and other packages.
Then, it uses this to replace parts on the website. It should still
work, but all the paths to the directories are wrong and so the script
needs some intense hand-holding while hopefully not destroying too
much ;-)
(there is zfs snapshotting underneath, but i have no idea how to rollback)

Harald

[Harald Schilly]

On Mon, Jun 2, 2014 at 8:28 PM, Volker Braun <vbrau...@gmail.com> wrote:

> Whats the command to build the documentation for the web page? Maybe it
> would be easy to simply add that to the release workflow.

Basically, it is building the pdf files with an additional switch.

However, things look brigther now. Latex was not installed, and I
didn't know what packages are required (e.g. cyrillic font support is
necessary, but not part of the standard install). Then, after that
worked, it turned out that "zip" was not installed.

Without more complaints:
http://sagemath.org/doc/index.html

;-)

[Nathann Cohen]

Great ! Thanks ! :-)

http://sagemath.org/doc/reference/combinat/index.html

Quite a sight... It can acually be read, for the first time ever :-P

Nathann

> --
> You received this message because you are subscribed to a topic in the Google Groups "sage-devel" group.
> To unsubscribe from this topic, visit https://groups.google.com/d/topic/sage-devel/AYXzlkiLbdQ/unsubscribe.
> To unsubscribe from this group and all its topics, send an email to sage-devel+...@googlegroups.com.
> To post to this group, send email to sage-...@googlegroups.com.
> Visit this group at http://groups.google.com/group/sage-devel.
> For more options, visit https://groups.google.com/d/optout.

[Harald Schilly]

On Tue, Jun 3, 2014 at 1:01 PM, Nathann Cohen <nathan...@gmail.com> wrote:
> Quite a sight... It can acually be read, for the first time ever :-P

ah cool, i haven't checked out all of the files so far. (I hope no
silent error is still out there). looks really great!!

(for me, what would be missing are 1-2 sentences for each topic as a
short introduction. I don't know if that makes much sense, though, but
would clarify terms like "word" which might be used different in other
contexts?)

h

[Nathann Cohen]

Yo !

> ah cool, i haven't checked out all of the files so far. (I hope no
> silent error is still out there). looks really great!!
>
> (for me, what would be missing are 1-2 sentences for each topic as a
> short introduction. I don't know if that makes much sense, though, but
> would clarify terms like "word" which might be used different in other
> contexts?)

Well.... This has been modified as a
"first-step-that-is-actually-carried-out-and-not-in-needs_work-forever".
The "here-is-what-we-will-do-someday" ticket is there :
http://trac.sagemath.org/ticket/16256

:-P

Nathann

[TB]

On 03/06/2014 14:01, Nathann Cohen wrote:
> Great ! Thanks ! :-)
>
> http://sagemath.org/doc/reference/combinat/index.html
>
> Quite a sight... It can acually be read, for the first time ever :-P
>

It is much nicer. Thanks for all involved.

I noticed that for "q-Analogues" the 'q' is not LaTeX-ised, but for
"q-Bernoulli Numbers" it is. Do we have some kind of decision if page
titles should/shouldn't contain LaTeX-ised expressions?

Regards,
TB