Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
43 changes: 31 additions & 12 deletions src/doc/en/installation/index.rst
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
.. _installation-guide:

==================================
Welcome to Sage Installation Guide
==================================
=======================
Sage Installation Guide
=======================

This is the installation guide for SageMath, a free open-source mathematics software system.
It is designed to help you install SageMath on your computer.
Expand All @@ -16,9 +16,20 @@ obtaining the source code and building SageMath.

.. tab:: Conda

Install SageMath from
the `conda-forge <https://conda-forge.org/>`_ project, as described in section
:ref:`sec-installation-conda`.
To install SageMath from
the `conda-forge <https://conda-forge.org/>`_ project
you can use the following command:

.. code-block:: console

$ conda create -n sage sage python=3.11

This will create a new conda environment named ``sage``
containing SageMath and Python 3.11.
You can then activate this environment with the command
``conda activate sage`` and start SageMath by typing ``sage``.

For more details, see section :ref:`sec-installation-conda`.

.. tab:: Arch Linux/Manjaro

Expand Down Expand Up @@ -122,10 +133,17 @@ obtaining the source code and building SageMath.
$ conda activate sage
$ sage

This way of starting Sage gives you the most basic way of using
Sage in the terminal. See :ref:`sec-launching` for recommended next steps,
in particular for setting up the Jupyter notebook, which is required if
you want to use graphics.

After installation, you can start SageMath in a terminal as follows:

.. code-block:: console

$ sage

This way of starting Sage gives you the most basic way of using
Sage in the terminal. See :ref:`sec-launching` for recommended next steps,
in particular for setting up the Jupyter notebook, which is required if
you want to use graphics.

.. _sec-cloud:

Expand All @@ -145,13 +163,14 @@ In the cloud
<https://hub.docker.com/r/sagemathinc/cocalc>`_ can be used on any system with Docker to run CoCalc locally.


More information:
More information
================

.. toctree::
:maxdepth: 2

conda
source
meson
source-distro
launching
troubles
2 changes: 1 addition & 1 deletion src/doc/en/installation/meson.build
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,9 @@ doc_sources = [
'conf.py',
'index.rst',
'launching.rst',
'meson.rst',
'source.rst',
'troubles.rst',
'source-distro.rst',
]

foreach file : doc_sources
Expand Down
Loading
Loading