Skip to content

Commit 3397e7b

Browse files
committed
2 parents 41276ba + a9981a6 commit 3397e7b

File tree

1 file changed

+14
-11
lines changed

1 file changed

+14
-11
lines changed

README.md

Lines changed: 14 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
[![A splash image for installation script](images/OpenVnmrJ_WSL_header.png)](https://github.com/JessiBaughman/OpenVnmrJ_WSL){width="640px" height="240px" style="margin:0 auto;display:block;"}
1+
<p align="center"><a href="https://github.com/JessiBaughman/OpenVnmrJ_WSL"><img width="640px" height="240px" style="margin:0 auto;display:block;" alt="A splash image for installation script" src="images/OpenVnmrJ_WSL_header.png"></a></p>
22

33
<div align="center">
44
<a href="https://github.com/JessiBaughman/OpenVnmrJ_WSL/issues/new?assignees=&labels=bug&template=01_BUG_REPORT.md&title=bug%3A+">Report a Bug</a>
@@ -19,7 +19,9 @@
1919
- [Running OpenVnmrJ](#running-openvnmrj)
2020
- [Launching OpenVnmrJ](#launching-openvnmrj)
2121
- [Printing / Plotting](#printing--plotting)
22+
- [Default PDF Reader](#default-pdf-reader)
2223
- [Closing OpenVnmrJ](#closing-openvnmrj)
24+
- [Updating OpenVnmrJ](#updating-openvnmrj)
2325
- [License](#license)
2426

2527
</details>
@@ -52,7 +54,7 @@ To find your version of Windows, open the Settings panel (`Windows + I`) and nav
5254
You will need to enable virtualization in your system BIOS. Entering the BIOS configuration at boot and the label of the virtualization setting itself varies between motherboard manufacturers. You may be able to find detailed instructions by searching your computer model number or manufacturer's name.
5355

5456
#### Windows Features
55-
![The Windows Features panel](images/OpenVnmrJ_WSL_Windows_Features.png){width="415px" height="368px" style="margin:0 auto;display:block;"}
57+
<p align="center""><img alt="The Windows Features panel" src="images/OpenVnmrJ_WSL_Windows_Features.png" width="415px" height="368px"></p>
5658
Two features need to be installed and activated within Windows. These are the "Virtual Machine Platform" and "Windows Subsystem for Linux" features. You can access this panel by searching, "Turn Windows features on or off" from the Start Menu. You will need to reboot your computer after enabling these features.
5759

5860
<p>
@@ -73,7 +75,7 @@ Two features need to be installed and activated within Windows. These are the "V
7375
- Open PowerShell and enter: `Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser`
7476
- Enter `y` at the prompt.
7577
- Rerun the script.
76-
![The initial installation dialog panel](images/OpenVnmrJ_WSL_GUI.png){width="324px" height="482px" style="margin:0 auto;display:block;"}
78+
<p align="center""><img alt="The initial installation dialog panel" src="images/OpenVnmrJ_WSL_GUI.png" width="324px" height="482px"></p>
7779

7880
3. **Fill out the form and click Install**
7981
- Install from file supports .zip, .tar, and .tar.gz archive files. Archives should decompress to a directory named dvdimageOVJ.
@@ -86,10 +88,10 @@ Two features need to be installed and activated within Windows. These are the "V
8688
- The first step will install the <a href="https://sourceforge.net/projects/vcxsrv/">VcXsrv display server</a> if not already present on your system.
8789
- This will require elevated privileges first for the install, which will prompt immediately following installer download
8890
- After installation, you will be notified of an additional elevated prompt request to create a firewall rule for VcXsrv
89-
5. Main installation
91+
5. **Main installation**
9092
- The script will proceed unattended until the OpenVnmrJ graphical installer runs, as pictured below.
91-
![The initial OpenVnmrJ installation dialog panel](images/OpenVnmrJ_WSL_install_01.png){width="406px" height="383px" style="margin:0 auto;display:block;"}
92-
![The OpenVnmrJ installation dialog panel after clicking the DDR2 tab](images/OpenVnmrJ_WSL_install_02.png){width="406px" height="383px" style="margin:0 auto;display:block;"}
93+
<p align="center""><img alt="The initial OpenVnmrJ installation dialog panel" src="images/OpenVnmrJ_WSL_install_01.png" width="406px" height="383px"></p>
94+
<p align="center""><img alt="The OpenVnmrJ installation dialog panel after clicking the DDR2 tab" src="images/OpenVnmrJ_WSL_install_02.png" width="406px" height="383px"></p>
9395

9496

9597
6. **Install OpenVnmrJ**
@@ -98,12 +100,12 @@ Two features need to be installed and activated within Windows. These are the "V
98100
- Click Install.
99101
- Note: The dialog may appear slightly off screen. Clicking the window's edge, or resizing the window, will snap it back within the visible desktop space.
100102
- A second popup will appear with the installation status followed by the OpenVnmrJ Admin panel.
101-
![The OpenVnmrJ Admin panel](images/OpenVnmrJ_WSL_install_03.png){width="586px" height="395px" style="margin:0 auto;display:block;"}
103+
<p align="center""><img alt="The OpenVnmrJ Admin panel" src="images/OpenVnmrJ_WSL_install_03.png" width="586px" height="395px"></p>
102104

103105
7. **Close the OpenVnmrJ Admin window**
104106
- You do not need to follow the instructions. Just close the window and everything will be setup automatically later in the script.
105107

106-
![The completed OpenVnmrJ installation status panel](images/OpenVnmrJ_WSL_install_04.png){width="491px" height="425px" style="margin:0 auto;display:block;"}
108+
<p align="center""><img alt="The completed OpenVnmrJ installation status panel" src="images/OpenVnmrJ_WSL_install_04.png" width="491px" height="425px"></p>
107109

108110
8. **Click Done**
109111
9. **Answer the 5 prompts within the PowerShell window**
@@ -117,7 +119,8 @@ Two features need to be installed and activated within Windows. These are the "V
117119
</p>
118120

119121
## Running OpenVnmrJ
120-
![OpenVnmrJ application running on Windows 11 via WSL](images/OpenVnmrJ_WSL_Running.png){style="margin:0 auto;display:block;"}
122+
<p align="center""><img alt="OpenVnmrJ application running on Windows 11 via WSL" src="images/OpenVnmrJ_WSL_Running.png"></p>
123+
121124
### Launching OpenVnmrJ
122125
* The easiest way to launch OpenVnmrJ is to used the created shortcuts. To launch manually:
123126
* Windows 10 (20H1-21H2): Launch VcXsrv using the "VcXsrv with Xauthority" shortcut in the Start Menu or Run:
@@ -129,7 +132,7 @@ Two features need to be installed and activated within Windows. These are the "V
129132
- If you need to mount other Windows drives within Linux, the `winmount` script [[source](https://pastebin.com/4pjbQmBN)] has been included. Run `winmount x`, where x is the Windows drive letter you wish to mount or unmount. Drives will appear in `/mnt`.
130133
* Output created using the `plot` command will be sent to the PDF printer and saved to the directory selected during install.
131134

132-
![Printer selection within the Plot panel of OpenVnmrJ](images/OpenVnmrJ_WSL_Plotting.png){width="373px" height="248px" style="margin:0 auto;display:block;"}
135+
<p align="center""><img alt="Printer selection within the Plot panel of OpenVnmrJ" src="images/OpenVnmrJ_WSL_Plotting.png" width="373px" height="248px"></p>
133136

134137
* You can toggle between color and grayscale plots by selecting the corresponding version of the PDF printer either from the File->Printers... window or the "Send to" drop-down menu within the Processing->Plot panel.
135138

@@ -146,7 +149,7 @@ Two features need to be installed and activated within Windows. These are the "V
146149
* Open from the distro shortcut in the Start Menu
147150
* _OR_ run `wsl -d <distro_name> -u vnmr1` from the Command Prompt or PowerShell
148151
* If needed, `su vnmr1`. If you used this script, the vnmr1 password was set to the same as the default WSL account. Use the PowerShell command in the previous step if you have forgotten your vnmr1 password.
149-
* Copy the OpenVnmrJ\*.zip or OVJdvd\*.tar.gz archive to `/tmp/`, `cd` to `/tmp/`, and then expand the file with `unzip` or `tar -xzvf`.
152+
* Copy the OpenVnmrJ\*.zip or OVJdvd\*.tar.gz archive of the new OpenVnmrJ release/build to `/tmp/`, `cd` to `/tmp/`, and then expand the file with `unzip` or `tar -xzvf`.
150153
* Run `cd dvdimageOVJ` followed by `./upgrade.nmr`.
151154
* All replaced OpenVnmrJ system files will be located in `/vnmr/adm/upgrade/<current_date>`
152155

0 commit comments

Comments
 (0)