diff --git a/src/murfey/templates/bootstrap.html b/src/murfey/templates/bootstrap.html index fcb7f05f7..6b5689b79 100644 --- a/src/murfey/templates/bootstrap.html +++ b/src/murfey/templates/bootstrap.html @@ -20,6 +20,21 @@

A. Installing MSYS2

C:\msys64 .

+

+ Some versions of Windows are too old to support the default MSYS2 installer. + In such cases, download this alternative + executable + and run it. It will unpack the + msys64 + folder into your Downloads folder. Copy this folder to the default MSYS2 + location, and run the UCRT64 executable within it to proceed with the + installation as normal. +

B. Setting Up MSYS2

i. Setting Up the MSYS2 Package Manager (If Network-Restricted)

@@ -39,7 +54,7 @@

i. Setting Up the MSYS2 Package Manager (If Network-Restricted)

-    C:\msys64\etc\pacman.d
+  C:\msys64\etc\pacman.d

ii. Installing Dependencies

@@ -51,11 +66,11 @@

ii. Installing Dependencies

-    $ pacman -Syu
-    $ pacman -S msys2-runtime
-    $ pacman -S rsync
-    $ pacman -S mingw-w64-ucrt-x86_64-python-pip
-    $ pacman -S mingw-w64-ucrt-x86_64-rust
+  $ pacman -Syu
+  $ pacman -S msys2-runtime
+  $ pacman -S rsync
+  $ pacman -S mingw-w64-ucrt-x86_64-python-pip
+  $ pacman -S mingw-w64-ucrt-x86_64-rust

Other utility packages such as @@ -74,6 +89,60 @@

ii. Installing Dependencies

>pacman -Ss <package-name>

+

Downgrading Python packages

+

+ MSYS2 current installs Python 3.14 by default, which we have not rigorously + tested Murfey with. For now, we downgrade to Python 3.12.12, which is known to + work with Murfey. To do so, download the following packages: +

+ +

+ These files will be placed in your account's Downloads folder by default, and + can then be installed using the following command: +

+
+  $ pacman -U /c/Users/<username>/Downloads/<package-name>
+

iii. Configuring the Rust Package Manager (If Network-Restricted)

Many newer Python packages now have dependencies written in Rust that allow @@ -119,13 +188,13 @@

iii. Configuring the Rust Package Manager (If Network-Restricted)

-    %USERPROFILE%\.cargo
+  %USERPROFILE%\.cargo

For a user named Murfey, for example, this would take the form:

-    C:\Users\Murfey\.cargo
+  C:\Users\Murfey\.cargo

With this file configured, @@ -154,9 +223,9 @@

A. (Optional) Setting Up a Virtual Environment

-    $ pip install virtualenv --index-url {{ request.url.scheme }}://{{ netloc }}{{ proxy_path }}/pypi --trusted-host {{ netloc }}
-    $ virtualenv your-env-name  # Create the virtual environment
-    $ source your-env-name/bin/activate  # Activate the virtual environment
+  $ pip install virtualenv --index-url {{ request.url.scheme }}://{{ netloc }}{{ proxy_path }}/pypi --trusted-host {{ netloc }}
+  $ virtualenv your-env-name  # Create the virtual environment
+  $ source your-env-name/bin/activate  # Activate the virtual environment

B. Installing Murfey

@@ -166,6 +235,40 @@

B. Installing Murfey

-    $ pip install murfey --index-url {{ request.url.scheme }}://{{ netloc }}{{ proxy_path }}/pypi/index --trusted-host {{ netloc }}
+  $ pip install murfey --index-url {{ request.url.scheme }}://{{ netloc }}{{ proxy_path }}/pypi/index --trusted-host {{ netloc }}
+ +

Installing Pillow

+

+ Python's Pillow package will be needed for certain instruments. This will + require the installation of additional image libraries in + pacman: +

+
+  $ pacman -S \
+    mingw-w64-ucrt-x86_64-freetype \
+    mingw-w64-ucrt-x86_64-giflib \
+    mingw-w64-ucrt-x86_64-lcms2 \
+    mingw-w64-ucrt-x86_64-libjpeg-turbo \
+    mingw-w64-ucrt-x86_64-libpng \
+    mingw-w64-ucrt-x86_64-libtiff \
+    mingw-w64-ucrt-x86_64-libwebp \
+    mingw-w64-ucrt-x86_64-openjpeg2 \
+    mingw-w64-ucrt-x86_64-zlib
+
+

+ Once the necessary libraries have been installed, Pillow can be installed by + running the following command: +

+
+  $ ZLIB_ROOT="/ucrt64" pip install pillow --index-url {{ request.url.scheme }}://{{ netloc }}{{ proxy_path }}/pypi/index --trusted-host {{ netloc }}
+
+ {% endblock %}