Ask Your Question
0

Offline docset for SageMath

asked 6 years ago

petRUShka gravatar image

updated 6 years ago

There are plenty of offline documentation tools like Zeal (Linux, MacOS, Windows), Dash (MacOS) and dasht (for terminal and with Vim integration). Most of them support Dash format of offline docs. There are hundreds of pre-generated docsets (including Python) and even more but Sage docset is missing.

There is a tool for generating python docset: doc2dash. It supports two doc formats: Sphinx and pydoctor. Unfortunately I'm not familiar with either of them neither with Sage docs.

So my question is: how to create SageMath docset with doc2dash? My goal is to have Sage offline documentation with editor integration.

Preview: (hide)

Comments

1

Sage offline documentation is already available as html and optionally pdf. It is produced with Sphinx, so if you are looking for the "Dash" format, maybe https://pypi.org/project/doc2dash/ is the right tool. What exactly are you looking for? What does "editor integration" mean?

John Palmieri gravatar imageJohn Palmieri ( 6 years ago )

@john-palmieri, by editor integration I meant something like vim-integration mentioned in first paragraph.

Possible doc2dash is a good tool, but I couldn't make some good of it with sage. Could you please give some hints?

petRUShka gravatar imagepetRUShka ( 6 years ago )

1 Answer

Sort by » oldest newest most voted
2

answered 6 years ago

updated 6 years ago

From the main Sage directory: running doc2dash local/share/doc/sage/html/en/reference with appropriate other arguments (like -A on a Mac, maybe --name Sage, etc.) produces a usable Dash docset.

You could presumably also change "reference" at the end to "tutorial" or various other directories for other parts of the Sage documentation.

Preview: (hide)
link

Comments

Thanks! For me it works with command doc2dash /usr/share/doc/sage/html/en/reference -n Sage -i /usr/share/sage/ext/images/sagelogo.png -d docsets

petRUShka gravatar imagepetRUShka ( 5 years ago )

Your Answer

Please start posting anonymously - your entry will be published after you log in or create a new account.

Add Answer

Question Tools

1 follower

Stats

Asked: 6 years ago

Seen: 1,314 times

Last updated: Feb 26 '19