[[howto:desktop:install-zim-0-70-or-later-in-windows]]

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

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>zim windows}} {{tag>zim windows}}
 ~~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, and a further 8MB for Zim itself. (This figure is for 64-bit Windows systems. 32-bit installations may use a little less for MSYS2 and Zim's dependencies.) **Caution: You will need approximately 1GB of disk space** to store the MSYS2 environment and all of Zim's dependencies, and a further 8MB for Zim itself. (This figure is for 64-bit Windows systems. 32-bit installations may use a little less for MSYS2 and 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:
 {{::pacman-install-py.png?direct&600|}} {{::pacman-install-py.png?direct&600|}}
  
 +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 "Open \_\_\_ with ..." a Python program.+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 "Open [...] with ..." a Python program.
  
 ==== 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>PATH</wrap> environment variable? (See earlier in this howto document.) Don't forget to fill in the correct path where you extracted Zim in the previous step. Also, did you edit your <wrap sym>PATH</wrap> environment variable? (See earlier in this howto document.)
  
-{{::new-shortcut.png}}+{{::new-shortcut.png?direct&600|}}
  
-{{::new-shortcut-target.png}}+{{::new-shortcut-target.png?direct&600|}}
  
 Next, right-click on the shortcut you created, click Properties, and then <wrap nav>Change Icon...</wrap>. Next, right-click on the shortcut you created, click Properties, and then <wrap nav>Change Icon...</wrap>.
  
-{{::edit-shortcut-prop.png}}+{{::edit-shortcut-prop.png?direct&600|}}
  
-{{::change-icon.png}}+{{::change-icon.png?direct&600|}}
  
 Navigate to and select <wrap file>zim.ico</wrap> in the Zim source package's <wrap file>icons</wrap> folder, and click OK. Now the Shortcut should have the correct icon. Navigate to and select <wrap file>zim.ico</wrap> in the Zim source package's <wrap file>icons</wrap> folder, and click OK. Now the Shortcut should have the correct icon.
  
-{{::change-icon-done.png}}+{{::change-icon-done.png?direct&600|}}
  
 +For convenience, you can now copy this <wrap file>Zim Desktop Wiki.lnk</wrap> file into your Start Menu so you can launch it from there.
 ==== CMD Script ==== ==== CMD Script ====
  
Line 156: Line 161:
 Right-click on <wrap file>notebook.zim</wrap> and select <wrap nav>Open With</wrap>, then <wrap nav>Choose another App</wrap>. Right-click on <wrap file>notebook.zim</wrap> and select <wrap nav>Open With</wrap>, then <wrap nav>Choose another App</wrap>.
  
-{{::open-with-choose.png}}+{{::open-with-choose.png?direct&600|}}
  
-Make sure <wrap nav>Always use this app to open .zim files</wrap> is selected, then click <wrap nav>More apps</wrap> and scroll down to <wrap nav>Look for another app on this PC</wrap nav>.+Make sure <wrap nav>Always use this app to open .zim files</wrap> is selected, then click <wrap nav>More apps</wrap> and scroll down to <wrap nav>Look for another app on this PC</wrap>.
  
-{{::open-with-always.png}}+{{::open-with-always.png?direct&600|}}
  
 Navigate to the <wrap file>launch-zim.cmd</wrap> script you created earlier, and select it. Navigate to the <wrap file>launch-zim.cmd</wrap> script you created earlier, and select it.
Line 166: Line 171:
 If Zim opened, close it now. Double-click on the <wrap file>notebook.zim</wrap> file to be sure that you setup Open With correctly. It should open the chosen Notebook in Zim. If Zim opened, close it now. Double-click on the <wrap file>notebook.zim</wrap> file to be sure that you setup Open With correctly. It should open the chosen Notebook in Zim.
  
-{{::open-with-done.png}}+{{::open-with-done.png?direct&600|}} 
 + 
 +**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't ship with all the binaries needed for all of its plugins. 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't ship with all the binaries needed for all of its plugins.
  
-{{::dep-failed.png}}+{{::dep-failed.png?direct&600|}}
  
 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-search.png}}+{{::pacman-search.png?direct&600|}}
  
 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 "''/''" and the version number. Fill in the exact name of the package you saw in the search results. Include everything between the "''/''" and the version number.
  
-{{::install-dep.png}}+{{::install-dep.png?direct&600|}}
  
 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.
  
-{{::dep-ok.png}}+{{::dep-ok.png?direct&600|}}
  
 Now you are ready to use the plugin. Now you are ready to use the plugin.