Revision history [back]

Dear Roland, you are right, the instructions are not up to date.

While we go to great lengths to ensure every piece of the code is properly documented, we sometimes lag behind when it comes to usage instructions.

I have made https://wiki.sagemath.org/SageAppliance an index page linking to different instructions pages for different versions of SageMath.

The 7.0 version still needs the appropriate updates but at least now it warns that the instructions are not up to date. I hope someone can figure out how to update the instructions. I myself don't have access to Windows.

I hope this gets settled soon, and thank you for alerting us to this situation.

Dear Roland, you are right, the instructions are not up to date.

While we go to great lengths to ensure every piece of the code is properly documented, we sometimes lag behind when it comes to usage instructions.instructions for the system as a whole.

I have made changed the wiki so that https://wiki.sagemath.org/SageAppliance is now an index page linking to different instructions pages for different versions of SageMath.

SageMath. The 7.0 version page you referred to above is now https://wiki.sagemath.org/SageAppliance/Sage-5-x-or-6-x

I will now comment on the 5-step instructions you suggest.

Are these the steps for Sage-7.0 for Windows / VM Virtualbox?

1. load sage-7.0.ova as normal in VM Virtualbox
2. Go to http://localhost:8000/tree within your browser
3. On the top right select New and than SageMath 7.0
4. You see at the top Jupyter Notebook Untitled
5. You have to select Run instead of pressing Enter to perform a command

Yes, these are valid steps. In 5., to evaluate a cell, you can either select Run or press shift-Enter.

This should help to update the instructions page.

For new users, that is all. For users who have existing SageNotebook worksheets (.sws files) and want to use them with Sage 7.0, there is more to say.

There are basically two approaches, either

1. either run the (legacy) Sage Notebook in Sage 7.0 (it is still needs the appropriate updates but present) and keep using your .sws worksheets,
2. or convert your worksheets to Jupyter notebook worksheets.

We need to document how to run the legacy Sage Notebook. Possibly, lauching the command "notebook()" in a Jupyter notebook worksheet might launch the Sage Notebook and you could go from there. I haven't tried.

Converting the worksheets from .sws to .ipynb also needs to be documented. There is a sws2sagews script at least now it warns that the instructions are not up to date. I hope someone can figure out how to update the instructions. I myself don't have access to Windows.

I hope this gets settled soon, and thank you for alerting us to this situation.

Dear Roland, you are right, the instructions are not up to date.

While we go to great lengths to ensure every piece of the code is properly documented, we sometimes lag behind when it comes to usage instructions for the system as a whole.

I changed the wiki so that https://wiki.sagemath.org/SageAppliance is https://wiki.sagemath.org/SageAppliance now an index page linking to different points to instructions pages for different versions of SageMath. The page you referred to above is now https://wiki.sagemath.org/SageAppliance/Sage-5-x-or-6-xhttps://wiki.sagemath.org/SageAppliance/Sage-5-x-or-6-x and I added one for Sage 7.0 and later.

I will now comment on the 5-step instructions you suggest.

Are these the steps for Sage-7.0 for Windows / VM Virtualbox?

1. load sage-7.0.ova as normal in VM Virtualbox
2. Go to http://localhost:8000/tree within your browser
3. On the top right select New and than SageMath 7.0
4. You see at the top Jupyter Notebook Untitled
5. You have to select Run instead of pressing Enter to perform a command

Yes, these are valid steps. In 5., step 5, to evaluate a cell, you can either select Run or press shift-Enter.

This should help to update the instructions page.

For new users, that is all. For users who have existing SageNotebook worksheets (.sws files) and want to use them with Sage 7.0, there is more to say.

There are basically two approaches, either

1. either run the (legacy) Sage Notebook in Sage 7.0 (it is still present) and keep using your .sws worksheets,
2. or convert your worksheets to Jupyter notebook worksheets.

We need to document how to run the legacy Sage Notebook. Possibly, lauching the command "notebook()" in a Jupyter notebook worksheet might launch the Sage Notebook and you could go from there. I haven't tried.

Converting the worksheets from .sws to .ipynb also needs to be documented. There is a sws2sagews script at SageMathCloud which goes from .sws to .sagews SageMathCloud worksheets, and a sagews2ipynb script to go from .sagews to .ipynb.

So to convert your worksheets to .ipynb, you could upload them to SageMathCloud, and run sws2sagews followed by sagews2ipynb on them, then download them and use them with your Sage virtual machine.

Dear Roland, you are right, the instructions are not up to date.

While we go to great lengths to ensure every piece of the code is properly documented, we sometimes lag behind when it comes to usage instructions for the system as a whole.

I changed the wiki so that https://wiki.sagemath.org/SageAppliance now points to instructions pages for different versions of SageMath. The page you referred to above is now https://wiki.sagemath.org/SageAppliance/Sage-5-x-or-6-x and I added one for Sage 7.0 and later.

I will now comment on the 5-step instructions you suggest.

Are these the steps for Sage-7.0 for Windows / VM Virtualbox?

1. load sage-7.0.ova as normal in VM Virtualbox
2. Go to http://localhost:8000/tree within your browser
3. On the top right select New and than SageMath 7.0
4. You see at the top Jupyter Notebook Untitled
5. You have to select Run instead of pressing Enter to perform a command

Yes, these are valid steps. In step 5, to evaluate a cell, you can either select Run or press shift-Enter.

This should help to update the instructions page.

For new users, that is all. For users who have existing SageNotebook worksheets (.sws files) and want to use them with Sage 7.0, there is more to say.

There are basically two approaches, either

1. either run the (legacy) Sage Notebook legacy Sage Notebook, still present in Sage 7.0 (it is still present) and keep using 7.0, and uplad your .sws worksheets,worksheets to it,
2. or convert your worksheets to Jupyter notebook worksheets.

We need to document how to run the legacy Sage Notebook. Possibly, lauching the command "notebook()" in a Jupyter notebook worksheet might launch the Sage Notebook and you could go from there. I haven't tried.

Converting the worksheets from .sws to .ipynb also needs to be documented. There is a sws2sagews script at SageMathCloud which goes from .sws to .sagews SageMathCloud worksheets, and a sagews2ipynb script to go from .sagews to .ipynb.

So to convert your worksheets to .ipynb, you could upload them to SageMathCloud, and run sws2sagews followed by sagews2ipynb on them, then download them and use them with your Sage virtual machine.