On Tue, Jul 14, 2009 at 9:39 AM, Justin C. Walker<jus...@mac.com> wrote:
<SNIP> >> Ah... I think I see what has been causing you and everyone (including >> me) problems. The HTML version of the standard documentation has a >> main page that links to all the individual documents (tutorial, >> reference manual, etc.). Clicking on any link, say the link to the >> tutorial, brings you to the directory containing the HTML version of >> the tutorial. It should in fact load the index.html page of that >> directory. If you have a web server on your machine, then the server >> should automatically load the index page. For example, the online >> version at >> >> http://www.sagemath.org/doc/ >> >> assumes that there is a web server in place to serve pages and >> automatically load index pages. >> >> What I think should happen is that each link should point to an >> index.html page, not to the directory. That way, you don't need a web >> server running on your local machine. I think this should be fixed in >> Sage 4.1.1. > > Thanks for digging into this. Good to know the cause. Indeed, on the Sage website it's no big deal because pages are served by a web server. But when people build the HTML version of the documentation locally or download the provided pre-built tarball at http://www.sagemath.org/help.html then it can be frustrating and at times confusing why things don't work. If anyone is interested in helping out with making the standard documentation better, the following tickets already have patches. It's just a matter of take one ticket and review it. http://trac.sagemath.org/sage_trac/ticket/6187 http://trac.sagemath.org/sage_trac/ticket/4460 Also, here are open tickets to make the documentation even better. Currently, there are no patches for these tickets. http://trac.sagemath.org/sage_trac/ticket/6488 http://trac.sagemath.org/sage_trac/ticket/4714 http://trac.sagemath.org/sage_trac/ticket/6255 -- Regards Minh Van Nguyen --~--~---------~--~----~------------~-------~--~----~ To post to this group, send email to sage-devel@googlegroups.com To unsubscribe from this group, send email to sage-devel-unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/sage-devel URLs: http://www.sagemath.org -~----------~----~----~----~------~----~------~--~---
