Skip to content

Setup an interim README.md #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 2 commits into
base: main
Choose a base branch
from
Draft
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
13 changes: 13 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1 +1,14 @@
# Welcome to the SageMath Windows installation

![work in progress](screenshots/working_site.webp)

This repository is a work in progress. It is intended to provide [SageMath](https://www.sagemath.org/) installers for Windows. The previous repository of the same name, which provided such installers up to Sage version 9.3, has been moved to [sage-windows-cygwin](https://github.com/sagemath/sage-windows-cygwin). It has been discontinued because the technique used was increasingly maintenance intensive.

Here we plan a new start. We follow four approaches:

* A) is developed in connection with the [sage-flatsurf](https://github.com/flatsurf/sage-flatsurf) project. Currently, it installs a flatsurf release as a custom WSL distribution which includes Sage along with functionality of this downstream package. This approach will also provide pure Sage installers in future. To figure out how it works, follow [these instructions](https://github.com/flatsurf/sage-flatsurf#installation).
* B) is developed in connection with the [sage-binder](https://github.com/sagemath/sage-binder-env/) project. It installs a Sage release as a custom WSL distribution. To figure out how it works, follow [these instructions](https://github.com/sagemath/sage-binder-env/releases/tag/v10.5).
* C) is developed as an example for a [projects docker guide](https://github.com/soehms/projects_docker_guide/). It installs Sage via Docker in a custom WSL distribution which is independent of the Sage release. To figure out how it works, follow [these instructions](https://github.com/soehms/projects_docker_guide/#1.).
* D) is developed as a native Windows build of Sage using meson (see sagemath/sage#38872). There is no installer for testing yet.

Any help with our project is welcome. Feel free to open issues in this repo to document your testing experiences or post your suggestions and criticism.
Binary file added screenshots/working_site.webp
Binary file not shown.