Merge lp:~purejava/zim/docker-zim into lp:~jaap.karssenberg/zim/master

[Ralph Plawetzki]

I love zim and use it a lot on Linux, macOS and Windows.
While it's easy to install and run zim on Linux and Windows, it's quite a hassle on macOS.

So I created a Docker image, that hopefully makes things easier for macOS.

Unmerged revisions

924. By Ralph Plawetzki on 2017-06-18

Add a hint for the zim Docker image.

=== modified file 'website/pages/install.txt'
--- website/pages/install.txt	2015-10-11 17:57:54 +0000
+++ website/pages/install.txt	2017-06-18 15:07:02 +0000
@@ -61,6 +61,15 @@
 
 An alternative that is reported to work is to install [[http://sourceforge.net/projects/macpkg/files/PyGTK/2.24.0/PyGTK.pkg/download|PyGTK for Mac]]. This will make your zim window look nicer compared to using the Mac Ports option. With PyGTK for Mac installed, you can just run zim directly from the source package.
 
+There is also a [[https://hub.docker.com/r/purejava/docker-zim/|Docker image]] available that makes it easy to start zim on macOS. To display the application window from within Docker, Homebrew is required:
+'''
+brew install socat
+brew cask install xquartz
+open -a XQuartz (ignore the xterm that opens or close it)
+socat TCP-LISTEN:6000,reuseaddr,fork UNIX-CLIENT:\"$DISPLAY\" &
+docker run -e DISPLAY=<your_IPv4_address>:0 -v ~/Documents/Notebooks/book:/home/developer/Notebooks/book --name zim purejava/docker-zim
+'''
+
 ==== Testing ====
 To verify zim is working properly on your system you can call the test suite using `''./test.py''`. Failures do not have to be critical, but in theory all tests should pass.