[sage-support] Re: How to refer to the reference manual when writing a tutorial?

2013-02-12 Thread Jason Grout

On 2/9/13 7:57 AM, kcrisman wrote:


 >> Maybe #6495 would make this possible? Just a guess.
 >>
 >
 > Yes, I just check this. With #6495 in place, I added this to some
random
 > file in the developer's guide, rebuilt it, and the link worked:

Great! I hope the same holds for thematic tutorials...


Huh, I didn't expect that, but that is great news.


I think intersphinx is the key thing added in #6495 to enable this:

http://sphinx-doc.org/latest/ext/intersphinx.html

Thanks,

Jason



--
You received this message because you are subscribed to the Google Groups 
"sage-support" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sage-support+unsubscr...@googlegroups.com.
To post to this group, send email to sage-support@googlegroups.com.
Visit this group at http://groups.google.com/group/sage-support?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.




[sage-support] Re: How to refer to the reference manual when writing a tutorial?

2013-02-09 Thread kcrisman

>
>
> >> Maybe #6495 would make this possible? Just a guess. 
> >> 
> > 
> > Yes, I just check this. With #6495 in place, I added this to some random 
> > file in the developer's guide, rebuilt it, and the link worked: 
>
> Great! I hope the same holds for thematic tutorials... 
>

Huh, I didn't expect that, but that is great news. 

-- 
You received this message because you are subscribed to the Google Groups 
"sage-support" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sage-support+unsubscr...@googlegroups.com.
To post to this group, send email to sage-support@googlegroups.com.
Visit this group at http://groups.google.com/group/sage-support?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.




[sage-support] Re: How to refer to the reference manual when writing a tutorial?

2013-02-08 Thread Simon King
Hi John, hi Jeroen,

On 2013-02-08, John H Palmieri  wrote:
> On Friday, February 8, 2013 11:25:15 AM UTC-8, Jeroen Demeyer wrote:
>>
>> Maybe #6495 would make this possible? Just a guess. 
>>
>
> Yes, I just check this. With #6495 in place, I added this to some random 
> file in the developer's guide, rebuilt it, and the link worked:

Great! I hope the same holds for thematic tutorials...

Best regards,
Simon

-- 
You received this message because you are subscribed to the Google Groups 
"sage-support" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sage-support+unsubscr...@googlegroups.com.
To post to this group, send email to sage-support@googlegroups.com.
Visit this group at http://groups.google.com/group/sage-support?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.




Re: [sage-support] Re: How to refer to the reference manual when writing a tutorial?

2013-02-08 Thread John H Palmieri


On Friday, February 8, 2013 11:25:15 AM UTC-8, Jeroen Demeyer wrote:
>
> Maybe #6495 would make this possible? Just a guess. 
>

Yes, I just check this. With #6495 in place, I added this to some random 
file in the developer's guide, rebuilt it, and the link worked:

  Testing a link :class:`sage.structure.parent.Parent` ...

-- 
John

-- 
You received this message because you are subscribed to the Google Groups 
"sage-support" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sage-support+unsubscr...@googlegroups.com.
To post to this group, send email to sage-support@googlegroups.com.
Visit this group at http://groups.google.com/group/sage-support?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.




Re: [sage-support] Re: How to refer to the reference manual when writing a tutorial?

2013-02-08 Thread Jeroen Demeyer
Maybe #6495 would make this possible? Just a guess.

-- 
You received this message because you are subscribed to the Google Groups 
"sage-support" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sage-support+unsubscr...@googlegroups.com.
To post to this group, send email to sage-support@googlegroups.com.
Visit this group at http://groups.google.com/group/sage-support?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.




[sage-support] Re: How to refer to the reference manual when writing a tutorial?

2013-02-08 Thread kcrisman

>
>
> >> Is it possible to get such cross-document link? How? 
> > 
> > I don't think we support that currently. 
>
> Would it be difficult to implement? Sorry, I am no sphinx expert. 
>

Nor am I, I just tried the same thing that you said a year or so ago and 
was told that it wasn't really possible since these are all separate 
projects (watch the doc build to see what I mean).  We'd have to compile 
the entire documentation as one project to allow that, if I'm not mistaken. 
 That said, you could probably put in a link to (say) 
http://www.sagemath.org/doc/installation/source.html in the "global Sage" 
doc to refer to that part of a different document - you'd just have to 
monitor it very closely for change in URL, as a reviewer of your tutorial 
would no doubt say.

- kcrisman

-- 
You received this message because you are subscribed to the Google Groups 
"sage-support" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sage-support+unsubscr...@googlegroups.com.
To post to this group, send email to sage-support@googlegroups.com.
Visit this group at http://groups.google.com/group/sage-support?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.




[sage-support] Re: How to refer to the reference manual when writing a tutorial?

2013-02-08 Thread Simon King
Hi Karl-Dieter,

On 2013-02-08, kcrisman  wrote:
>> Is it possible to get such cross-document link? How? 
>
> I don't think we support that currently. 

Would it be difficult to implement? Sorry, I am no sphinx expert.

Cheers,
Simon

-- 
You received this message because you are subscribed to the Google Groups 
"sage-support" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sage-support+unsubscr...@googlegroups.com.
To post to this group, send email to sage-support@googlegroups.com.
Visit this group at http://groups.google.com/group/sage-support?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.




[sage-support] Re: How to refer to the reference manual when writing a tutorial?

2013-02-08 Thread kcrisman


On Friday, February 8, 2013 6:45:28 AM UTC-5, Simon King wrote:
>
> Hi! 
>
> I'm writing a thematic tutorial on coercion and category framework. In 
> some cases, I wish to have links to pages in the reference manual, such 
> as :class:`sage.structure.parent.Parent`. But since the thematic 
> tutorials and the reference manual are separate documents, it doesn't 
> work so easily. 
>
> Is it possible to get such cross-document link? How? 
>

I don't think we support that currently. 

-- 
You received this message because you are subscribed to the Google Groups 
"sage-support" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sage-support+unsubscr...@googlegroups.com.
To post to this group, send email to sage-support@googlegroups.com.
Visit this group at http://groups.google.com/group/sage-support?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.