Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
howto:desktop:install-zim-0-70-or-later-in-windows [2019-07-17 00:25] brendan [4. Installing Zim from Source] |
howto:desktop:install-zim-0-70-or-later-in-windows [2020-08-13 06:17] (current) |
||
---|---|---|---|
Line 1: | Line 1: | ||
~~META: | ~~META: | ||
creator = Brendan Kidwell | creator = Brendan Kidwell | ||
- | &date created = 2019-07-16 | + | &date created = 2019-07-17 |
- | &date updated = 2019-07-16 | + | &date updated = 2019-07-17 |
~~ | ~~ | ||
{{tag> | {{tag> | ||
~~DISCUSSION~~ | ~~DISCUSSION~~ | ||
====== Install Zim Desktop Wiki 0.70 or Later in Windows ====== | ====== Install Zim Desktop Wiki 0.70 or Later in Windows ====== | ||
- | |||
- | 16 July 2019\\ | ||
- | Brendan Kidwell | ||
As of the time I'm writing this howto, there is no complete self-installing package of Zim Desktop Wiki 0.70 or later, for Windows. This is due to the Zim project migrating from Python 2 to Python 3 and from GTK 2 to GTK 3. I was the maintainer of the old Zim packages for Windows, and I have not been able to come up with a packaging workflow that works for GTK 3. | As of the time I'm writing this howto, there is no complete self-installing package of Zim Desktop Wiki 0.70 or later, for Windows. This is due to the Zim project migrating from Python 2 to Python 3 and from GTK 2 to GTK 3. I was the maintainer of the old Zim packages for Windows, and I have not been able to come up with a packaging workflow that works for GTK 3. | ||
Line 18: | Line 15: | ||
**Caution: You will need approximately 1GB of disk space** to store the MSYS2 environment and all of Zim's dependencies, | **Caution: You will need approximately 1GB of disk space** to store the MSYS2 environment and all of Zim's dependencies, | ||
+ | |||
+ | ===== 0. Upgrading From a Previous Version ===== | ||
+ | |||
+ | **Are you upgrading from a version before 0.69?** You should uninstall Zim completely using the appropriate item in your Add / Remove Programs screen or by deleting application folder -- depending on how you installed it originally. | ||
+ | |||
+ | **Are you upgrading from version 0.70 or later?** If you have already installed 0.70 or later using the procedure in **this howto document**, you just need to repeat step 4 below; you can skip the other steps. | ||
===== 1. Install MSYS2 ===== | ===== 1. Install MSYS2 ===== | ||
Line 93: | Line 96: | ||
{{:: | {{:: | ||
+ | It will take another few minutes for those packages and all their depenencies to install. | ||
===== 4. Installing Zim from Source ===== | ===== 4. Installing Zim from Source ===== | ||
Line 113: | Line 117: | ||
===== 5. Creating Launcher Files ===== | ===== 5. Creating Launcher Files ===== | ||
- | You will need to create two launcher files. One will be a Windows Shortcut file which you can copy into your Start Menu, and the other will be a .cmd script for the Open With command, since a Shortcut will not work correctly for " | + | You will need to create two launcher files. One will be a Windows Shortcut file which you can copy into your Start Menu, and the other will be a .cmd script for the Open With command, since a Shortcut will not work correctly for " |
==== Windows Shortcut ==== | ==== Windows Shortcut ==== | ||
Line 124: | Line 128: | ||
Don't forget to fill in the correct path where you extracted Zim in the previous step. Also, did you edit your <wrap sym> | Don't forget to fill in the correct path where you extracted Zim in the previous step. Also, did you edit your <wrap sym> | ||
- | {{:: | + | {{:: |
- | {{:: | + | {{:: |
Next, right-click on the shortcut you created, click Properties, and then <wrap nav> | Next, right-click on the shortcut you created, click Properties, and then <wrap nav> | ||
- | {{:: | + | {{:: |
- | {{:: | + | {{:: |
Navigate to and select <wrap file> | Navigate to and select <wrap file> | ||
- | {{:: | + | {{:: |
+ | For convenience, | ||
==== CMD Script ==== | ==== CMD Script ==== | ||
Line 156: | Line 161: | ||
Right-click on <wrap file> | Right-click on <wrap file> | ||
- | {{:: | + | {{:: |
- | Make sure <wrap nav> | + | Make sure <wrap nav> |
- | {{:: | + | {{:: |
Navigate to the <wrap file> | Navigate to the <wrap file> | ||
Line 166: | Line 171: | ||
If Zim opened, close it now. Double-click on the <wrap file> | If Zim opened, close it now. Double-click on the <wrap file> | ||
- | {{:: | + | {{:: |
+ | |||
+ | **Zim should be ready to use now!** | ||
===== 6. Installing Dependencies of Zim Plugins ===== | ===== 6. Installing Dependencies of Zim Plugins ===== | ||
Line 172: | Line 179: | ||
When you try to enable Plugins in Preferences in Zim, you may find a red message saying that a dependency was not found. This is normal; Zim doesn' | When you try to enable Plugins in Preferences in Zim, you may find a red message saying that a dependency was not found. This is normal; Zim doesn' | ||
- | {{:: | + | {{:: |
To resolve this, you might first try searching in the MSYS2 software catalog, since you already have MSYS2 installed. For the GraphViz example, we would try this: | To resolve this, you might first try searching in the MSYS2 software catalog, since you already have MSYS2 installed. For the GraphViz example, we would try this: | ||
Line 183: | Line 190: | ||
Note that we searched for the name of the dependency in all lowercase letters. | Note that we searched for the name of the dependency in all lowercase letters. | ||
- | {{:: | + | {{:: |
Pacman reports that two candidate packages are found. (On 32-bit Windows it will probably only find one.) If Pacman did not find any package matches, you can try again with different search terms. **If you still do not find anything, you will need to find a Windows build of the tool you need somewhere else**, and install it — this is beyond the scope of this howto document. | Pacman reports that two candidate packages are found. (On 32-bit Windows it will probably only find one.) If Pacman did not find any package matches, you can try again with different search terms. **If you still do not find anything, you will need to find a Windows build of the tool you need somewhere else**, and install it — this is beyond the scope of this howto document. | ||
Line 194: | Line 201: | ||
Fill in the exact name of the package you saw in the search results. Include everything between the "''/''" | Fill in the exact name of the package you saw in the search results. Include everything between the "''/''" | ||
- | {{:: | + | {{:: |
After Pacman is done installing the package, you can close Preferences in Zim and re-open Preferences. Navigate to the plugin you were trying to use, and it should now say that the Dependencies are satisfied. | After Pacman is done installing the package, you can close Preferences in Zim and re-open Preferences. Navigate to the plugin you were trying to use, and it should now say that the Dependencies are satisfied. | ||
- | {{:: | + | {{:: |
Now you are ready to use the plugin. | Now you are ready to use the plugin. | ||