On Apr 16, 9:44 am, John Cremona <john.crem...@gmail.com> wrote:
> Now I am getting the hang of this ReST/Sphinx stuff (this is very
> useful: http://docutils.sourceforge.net/docs/user/rst/quickref.htm)
> I have some questions:
>
> * Sometimes stuff in between `...` does not get put into math mode.
>
> * When it does, not everything gets rendered properly (e.g. Greek
> letters), but that might just be the fault of my browser's setup.
Do you have examples (e.g., from the Sage library)? I'd like to take a
look.
> * When I add a nde file into a table of contents and rebuild, the
> cross-references are not all correct. Specifically "Previous Topic"
> is updated but not "Next Topic". I think.
>
> Also, discussion around the review
> ofhttp://trac.sagemath.org/sage_trac/ticket/5734led us to the
> conclusion that we need to have a clear style guide somewhere for
> reference. Does this exist? If so, where? If not, where should we
> put it?
Some of this is in the Developer's Guide:
<http://sagemath.org/doc/developer/conventions.html#documentation-
strings>
Is that the sort of thing you are asking about? If you have ideas
about other things to add, we can open a ticket, or add to #5588.
> John
John
--~--~---------~--~----~------------~-------~--~----~
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
-~----------~----~----~----~------~----~------~--~---
