Is there anywhere I can download the entire Sage documentation in HTML (ZIP) or PDF format?

144 views
Skip to first unread message

Brenton

unread,
May 14, 2015, 2:53:38 PM5/14/15
to sage-s...@googlegroups.com
Hi,

I do love Sage but it would be excellent if I could have the full Sage documentation (including all tutorials, thematic tutorials, reference manual, FAQ, developer's guide, installation guide, constructions, etc.) in HTML (zipped) and/or PDF format (if it is in a PDF I'd like a single PDF, not a set of >10 of them), without having to download smaller component of Sage in PDF format and combine them in Adobe Acrobat Professional. I was wondering if this may be available somewhere on the web for a recent release (i.e., Sage >6.5) for free. I realize any such PDF or zip directory of HTMLs will likely be >50 MB & >10,000 pages in size but I would still like it, if possible, for offline use. I already have a (partial, containing just the reference manual with 13,540 pages to it) solution, which I spent hours constructing from these smaller PDFs (which I'd lament doing for each new documentation release :( ), it's here in my Google Drive, if you're interested (http://goo.gl/E1PZ9p).

Thanks for your time,
Brenton

Dima Pasechnik

unread,
May 14, 2015, 3:16:34 PM5/14/15
to sage-s...@googlegroups.com


On Thursday, 14 May 2015 19:53:38 UTC+1, Brenton wrote:
Hi,

I do love Sage but it would be excellent if I could have the full Sage documentation (including all tutorials, thematic tutorials, reference manual, FAQ, developer's guide, installation guide, constructions, etc.) in HTML (zipped) and/or PDF format (if it is in a PDF I'd like a single PDF, not a set of >10 of them), without having to download smaller component of Sage in PDF format and combine them in Adobe Acrobat Professional. I was wondering if this may be available somewhere on the web for a recent release (i.e., Sage >6.5) for free. I realize any such PDF or zip directory of HTMLs will likely be >50 MB & >10,000 pages in size but I would still like it, if possible, for offline use. I already have a (partial, containing just the reference manual with 13,540 pages to it) solution, which I spent hours constructing from these smaller PDFs (which I'd lament doing for each new documentation release :( ), it's here in my Google Drive, if you're interested (http://goo.gl/E1PZ9p ).

most natural would be to build the pdf docs yourself; you'd need a Sage and TeX installation for this.


Brenton

unread,
May 14, 2015, 3:21:28 PM5/14/15
to sage-s...@googlegroups.com
Sounds good, I have both ready & waiting on my 32-bit Ubuntu 15.04 (mentioning in case it's relevant) installation if you could tell me how to do this, please. 

Dima Pasechnik

unread,
May 14, 2015, 3:28:20 PM5/14/15
to sage-s...@googlegroups.com


On Thursday, 14 May 2015 20:21:28 UTC+1, Brenton wrote:
Sounds good, I have both ready & waiting on my 32-bit Ubuntu 15.04 (mentioning in case it's relevant) installation if you could tell me how to do this, please. 

run

sage --docbuild all pdf


Brenton

unread,
May 14, 2015, 6:02:43 PM5/14/15
to sage-s...@googlegroups.com
That just creates a heap of smaller PDFs: I wanted a single large PDF containing the content from all these smaller ones with bookmarks. 

David Joyner

unread,
May 14, 2015, 6:15:41 PM5/14/15
to SAGE support
On Thu, May 14, 2015 at 6:02 PM, Brenton <mowan...@bigpond.com> wrote:
> That just creates a heap of smaller PDFs: I wanted a single large PDF
> containing the content from all these smaller ones with bookmarks.
>

I don't know why you would want such a file but if you really think it
is useful, there are lots of programs that merge pdfs. For example, on
a mac, preview does that (and can add bookmarks) but google I'm sure
will tell you others.
> --
> 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...@googlegroups.com.
> To post to this group, send email to sage-s...@googlegroups.com.
> Visit this group at http://groups.google.com/group/sage-support.
> For more options, visit https://groups.google.com/d/optout.

Brenton

unread,
May 14, 2015, 6:22:36 PM5/14/15
to sage-s...@googlegroups.com
I mostly want it because it can get irritating having to navigate between several smaller PDFs, plus it means that if I want to search for a keyword in the entire documentation I can. How about HTML files of the documentation can I get them using some sort of sage command line code? If they have a table of contents type of page that hyperlinks to the different HTMLs it may be fairly easy to navigate. 

William Stein

unread,
May 14, 2015, 6:23:40 PM5/14/15
to sage-support
On Thu, May 14, 2015 at 3:15 PM, David Joyner <wdjo...@gmail.com> wrote:
> On Thu, May 14, 2015 at 6:02 PM, Brenton <mowan...@bigpond.com> wrote:
>> That just creates a heap of smaller PDFs: I wanted a single large PDF
>> containing the content from all these smaller ones with bookmarks.
>>
>
> I don't know why you would want such a file but if you really think it
> is useful, there are lots of programs that merge pdfs. For example, on
> a mac, preview does that (and can add bookmarks) but google I'm sure
> will tell you others.

If you look at the latex source here you can see an example of how to
combine many pdf's using LaTeX itself, so you can make this automatic.
This uses the pdfpages package.

http://wstein.org/papers/works/
--
William (http://wstein.org)

John H Palmieri

unread,
May 14, 2015, 6:41:39 PM5/14/15
to sage-s...@googlegroups.com
Try opening the file

   SAGE_ROOT/src/doc/output/html/en/index.html

in your web browser (where "SAGE_ROOT" is the top directory in your Sage installation). Is that something like what you want? Note that if you've built the pdf documentation (by running "make doc-pdf", for example) then there should be little PDF symbols you can click on to load each individual PDF file.

Also, while running Sage, you can do   search_doc('string')   to search for a particular string in the documentation.

-- John

Vincent Delecroix

unread,
May 15, 2015, 2:45:28 AM5/15/15
to sage-s...@googlegroups.com
On 15/05/15 00:22, William Stein wrote:
> On Thu, May 14, 2015 at 3:15 PM, David Joyner <wdjo...@gmail.com> wrote:
>> On Thu, May 14, 2015 at 6:02 PM, Brenton <mowan...@bigpond.com> wrote:
>>> That just creates a heap of smaller PDFs: I wanted a single large PDF
>>> containing the content from all these smaller ones with bookmarks.
>>>
>>
>> I don't know why you would want such a file but if you really think it
>> is useful, there are lots of programs that merge pdfs. For example, on
>> a mac, preview does that (and can add bookmarks) but google I'm sure
>> will tell you others.
>
> If you look at the latex source here you can see an example of how to
> combine many pdf's using LaTeX itself, so you can make this automatic.
> This uses the pdfpages package.
>
> http://wstein.org/papers/works/

There are hyperlinks in Sage documentation. How does this get while
merging pdf? What about page numbering?

Vincent
Reply all
Reply to author
Forward
0 new messages