]> git.phdru.name Git - m_librarian.git/blobdiff - docs/install.rst
Docs: Update TODO
[m_librarian.git] / docs / install.rst
index 93151ce0e03ec82f16da8feba0693bbcb22fd111..d7ac13d032b736e5515323ebeb46182625971de5 100644 (file)
@@ -6,16 +6,46 @@ System-wide
 
 ::
 
-    sudo pip install --find-links=http://phdru.name/Software/Python/ --no-index --install-option='-O2' m_librarian
+    sudo pip install m_librarian
 
 User mode
 ---------
 
 ::
 
-    pip install --find-links=http://phdru.name/Software/Python/ --no-index --install-option='-O2' --user m_librarian
+    pip install --user m_librarian
 
-For Python 2.6 the command is easy_install.
+Virtual envs
+------------
+
+::
+
+    pip install m_librarian
+
+Progress bar
+============
+
+To allow ``ml-import.py`` to display progress bar the program requires
+library ``m_lib``. You can install the library separately using, e.g.,
+command ``pip install m_lib``. Or you can install the library with
+``m_librarian``: ``pip install m_librarian[pbar]``.
+
+Other extras
+============
+
+``pip install m_librarian[web]`` installs libraries needed for web-ui.
+
+``pip install m_librarian[wx]`` installs a library needed for wx GUI
+(``wxPython``). Should work for non-Linux platforms, but for Linux
+``wxPython`` should be installed separately either using system package
+manager, or from https://extras.wxpython.org/wxPython4/extras/linux/gtk3/ ,
+or using ``conda``::
+
+    conda create -n wx27 python=2.7 wxpython
+    conda activate wx27
+
+Python 2.7 is used here just an example, the librarin works with any
+Python version, 2.7 and 3.4+.
 
 Installation from sources
 =========================
@@ -25,14 +55,14 @@ command:
 
 ::
 
-    sudo python setup.py install -O2
+    sudo python setup.py install
 
 If you don't want to install it system-wide you can install it in your
 home directory; run run the following command:
 
 ::
 
-    python setup.py install -O2 --user
+    python setup.py install --user
 
 Option '--user' installs m_librarian into
 $HOME/.local/lib/python$MAJOR.$MINOR/site-packages/ where python finds it