Skip to content

Build instructions and documentation don’t work with current WSL Ubuntu #38820

Open
@G4DCP

Description

Steps To Reproduce

  1. Install SageMath in a Conda environment on WSL (Ubuntu 22.04).
  2. Run sage and follow the instructions provided by the initial help message, which suggest running tutorial() to access the tutorial.
    3.When running tutorial(), Sage throws an error, stating that the documentation doesn’t exist and that it needs to be built.
  3. Attempting to build the documentation using sage -docbuild tutorial html or sage -docbuild all html results in errors about missing directories and an undefined SAGE_ROOT.

Expected Behavior

I expect the tutorial and documentation to be accessible as indicated by Sage's help message. Running sage -docbuild tutorial html should successfully build the documentation.

Actual Behavior

The tutorial doesn’t run, and Sage throws errors about missing documentation files.
Building the documentation manually with sage -docbuild results in errors like FileNotFoundError or SAGE_ROOT undefined.
Even after manually downloading the documentation files and setting appropriate environment variables, the process still fails.

Additional Information

No response

Environment

Operating System: WSL (Windows Subsystem for Linux)
Ubuntu 22.04 (and similar issues on Debian)
SageMath Version: 10.4 (Conda version from conda-forge)
Python Version: 3.11 (managed via Conda)

Checklist

  • I have searched the existing issues for a bug report that matches the one I want to file, without success.
  • I have read the documentation and troubleshoot guide

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions