Update installation documentation

jim-easterbrook · Sep 27, 2022 · 5e79c26 · 5e79c26
1 parent db95841
commit 5e79c26
Show file tree

Hide file tree

Showing 37 changed files with 896 additions and 435 deletions.
diff --git a/src/doc/other/installation.rst b/src/doc/other/installation.rst
diff --git a/src/lang/ca/LC_MESSAGES/index.po b/src/lang/ca/LC_MESSAGES/index.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Photini 2022.6.0\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2022-09-27 11:58+0100\n"
+"POT-Creation-Date: 2022-09-27 17:39+0100\n"
 "PO-Revision-Date: 2022-06-30 12:10+0000\n"
 "Last-Translator: Joan <[email protected]>, 2022\n"
 "Language: ca\n"

diff --git a/src/lang/ca/LC_MESSAGES/manual.po b/src/lang/ca/LC_MESSAGES/manual.po
@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Photini 2022.6.0\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2022-09-27 11:58+0100\n"
+"POT-Creation-Date: 2022-09-27 17:39+0100\n"
 "PO-Revision-Date: 2022-06-28 09:10+0000\n"
 "Last-Translator: Joan <[email protected]>, 2022\n"
 "Language: ca\n"

diff --git a/src/lang/ca/LC_MESSAGES/misc.po b/src/lang/ca/LC_MESSAGES/misc.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Photini 2022.6.0\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2022-09-27 11:58+0100\n"
+"POT-Creation-Date: 2022-09-27 17:39+0100\n"
 "PO-Revision-Date: 2022-06-28 09:10+0000\n"
 "Last-Translator: Joan <[email protected]>, 2022\n"
 "Language: ca\n"

diff --git a/src/lang/ca/LC_MESSAGES/other.po b/src/lang/ca/LC_MESSAGES/other.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version:  Photini\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2022-09-27 11:58+0100\n"
+"POT-Creation-Date: 2022-09-27 17:39+0100\n"
 "PO-Revision-Date: 2021-06-14 10:52+0000\n"
 "Last-Translator: Jim Easterbrook <[email protected]>\n"
 "Language: ca\n"
@@ -136,21 +136,29 @@ msgstr ""
 
 msgid ""
 "Note that pip may need to be updated again from within the virtual "
-"environment. The ``--system-site-packages`` option makes packages installed "
-"with the Linux or MacOS package manager (e.g. PySide2) available within the "
-"virtual environment. You should stay in this virtual environment while "
-"installing and testing Photini."
+"environment. The Linux/MacOS option ``--system-site-packages`` makes "
+"packages installed with the system package manager (e.g. PySide2) available "
+"within the virtual environment. You should stay in this virtual environment "
+"while installing and testing Photini."
 msgstr ""
 
-msgid "Minimal installation"
+msgid "Initial installation"
 msgstr ""
 
-msgid "Photini and a set of essential dependencies can all be installed with pip_:"
+msgid ""
+"The ``photini-configure`` post installation script can be used to install "
+"most dependencies and configure Photini to use them."
+msgstr ""
+
+msgid "Firstly install Photini with pip_:"
+msgstr ""
+
+msgid "Now run the ``photini-configure`` command to choose which Qt package to use:"
 msgstr ""
 
 msgid ""
-"Instead of listing the dependencies individually you can install them as a "
-"set with ``pip3 install photini[basic]``."
+"The command asks a series of questions, then runs pip_ to install any extra "
+"dependencies that are needed, then updates your Photini configuration file."
 msgstr ""
 
 msgid "Test the installation"
@@ -183,19 +191,7 @@ msgstr ""
 
 msgid ""
 "Most of the dependencies required for Photini's optional features can also "
-"be installed with pip_. Many are specified as one or more \"extras\" in "
-"square brackets:"
-msgstr ""
-
-msgid ""
-"You can install all the extra dependencies in one go with ``pip3 install "
-"photini[extras]``."
-msgstr ""
-
-msgid ""
-"Other optional dependencies (Pillow_, gpxpy_) can also be installed with "
-"pip_, but may not be available for all Python and operating system "
-"combinations:"
+"be installed with ``photini-configure``:"
 msgstr ""
 
 msgid ""
@@ -204,10 +200,10 @@ msgid ""
 msgstr ""
 
 msgid ""
-"One optional dependency that cannot be installed with pip_ is FFmpeg_. This "
-"is used to read metadata from video files. Linux & MacOS users can install "
-"it with the system package manager, but installing it on Windows is non-"
-"trivial."
+"One optional dependency that cannot be installed with pip_ or ``photini-"
+"configure`` is FFmpeg_. This is used to read metadata from video files. "
+"Linux & MacOS users can install it with the system package manager, but "
+"installing it on Windows is non-trivial."
 msgstr ""
 
 msgid "Start menu / application menu"
@@ -2814,3 +2810,61 @@ msgstr ""
 #~ msgid "Polish translation by \"itdawid\""
 #~ msgstr ""
 
+#~ msgid ""
+#~ "Note that pip may need to be "
+#~ "updated again from within the virtual "
+#~ "environment. The ``--system-site-packages`` "
+#~ "option makes packages installed with the"
+#~ " Linux or MacOS package manager (e.g."
+#~ " PySide2) available within the virtual "
+#~ "environment. You should stay in this "
+#~ "virtual environment while installing and "
+#~ "testing Photini."
+#~ msgstr ""
+
+#~ msgid "Minimal installation"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Photini and a set of essential "
+#~ "dependencies can all be installed with "
+#~ "pip_:"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Instead of listing the dependencies "
+#~ "individually you can install them as "
+#~ "a set with ``pip3 install photini[basic]``."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Most of the dependencies required for "
+#~ "Photini's optional features can also be "
+#~ "installed with pip_. Many are specified "
+#~ "as one or more \"extras\" in square"
+#~ " brackets:"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "You can install all the extra "
+#~ "dependencies in one go with ``pip3 "
+#~ "install photini[extras]``."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Other optional dependencies (Pillow_, gpxpy_) "
+#~ "can also be installed with pip_, but"
+#~ " may not be available for all "
+#~ "Python and operating system combinations:"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "One optional dependency that cannot be "
+#~ "installed with pip_ is FFmpeg_. This "
+#~ "is used to read metadata from video"
+#~ " files. Linux & MacOS users can "
+#~ "install it with the system package "
+#~ "manager, but installing it on Windows "
+#~ "is non-trivial."
+#~ msgstr ""
+
diff --git a/src/lang/cs/LC_MESSAGES/index.po b/src/lang/cs/LC_MESSAGES/index.po
@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Photini 2022.7.0\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2022-09-27 11:58+0100\n"
+"POT-Creation-Date: 2022-09-27 17:39+0100\n"
 "PO-Revision-Date: 2022-07-02 10:41+0000\n"
 "Last-Translator: fri, 2022\n"
 "Language: cs\n"

diff --git a/src/lang/cs/LC_MESSAGES/manual.po b/src/lang/cs/LC_MESSAGES/manual.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Photini 2022.6.0\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2022-09-27 11:58+0100\n"
+"POT-Creation-Date: 2022-09-27 17:39+0100\n"
 "PO-Revision-Date: 2022-06-28 09:10+0000\n"
 "Last-Translator: Jim Easterbrook <[email protected]>, 2022\n"
 "Language: cs\n"

diff --git a/src/lang/cs/LC_MESSAGES/misc.po b/src/lang/cs/LC_MESSAGES/misc.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Photini 2022.6.0\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2022-09-27 11:58+0100\n"
+"POT-Creation-Date: 2022-09-27 17:39+0100\n"
 "PO-Revision-Date: 2022-06-28 09:10+0000\n"
 "Last-Translator: Jim Easterbrook <[email protected]>, 2022\n"
 "Language: cs\n"

diff --git a/src/lang/cs/LC_MESSAGES/other.po b/src/lang/cs/LC_MESSAGES/other.po
@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Photini 2022.7.1\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2022-09-27 11:58+0100\n"
+"POT-Creation-Date: 2022-09-27 17:39+0100\n"
 "PO-Revision-Date: 2022-07-02 10:40+0000\n"
 "Last-Translator: fri, 2022\n"
 "Language: cs\n"
@@ -186,24 +186,30 @@ msgstr ""
 
 msgid ""
 "Note that pip may need to be updated again from within the virtual "
-"environment. The ``--system-site-packages`` option makes packages installed "
-"with the Linux or MacOS package manager (e.g. PySide2) available within the "
-"virtual environment. You should stay in this virtual environment while "
-"installing and testing Photini."
+"environment. The Linux/MacOS option ``--system-site-packages`` makes "
+"packages installed with the system package manager (e.g. PySide2) available "
+"within the virtual environment. You should stay in this virtual environment "
+"while installing and testing Photini."
 msgstr ""
 
-msgid "Minimal installation"
-msgstr "Minimální instalace"
+msgid "Initial installation"
+msgstr ""
+
+msgid ""
+"The ``photini-configure`` post installation script can be used to install "
+"most dependencies and configure Photini to use them."
+msgstr ""
+
+msgid "Firstly install Photini with pip_:"
+msgstr ""
 
-msgid "Photini and a set of essential dependencies can all be installed with pip_:"
-msgstr "Photini a sadu základních závislostí lze nainstalovat pomocí pip_:"
+msgid "Now run the ``photini-configure`` command to choose which Qt package to use:"
+msgstr ""
 
 msgid ""
-"Instead of listing the dependencies individually you can install them as a "
-"set with ``pip3 install photini[basic]``."
+"The command asks a series of questions, then runs pip_ to install any extra "
+"dependencies that are needed, then updates your Photini configuration file."
 msgstr ""
-"Místo výpisu závislostí jednotlivě je můžete nainstalovat jako sadu pomocí "
-"příkazu ``pip3 install photini[basic]```."
 
 msgid "Test the installation"
 msgstr "Přezkoušejte instalaci"
@@ -237,28 +243,8 @@ msgstr "Volitelné závislosti"
 
 msgid ""
 "Most of the dependencies required for Photini's optional features can also "
-"be installed with pip_. Many are specified as one or more \"extras\" in "
-"square brackets:"
-msgstr ""
-"Většinu závislostí potřebných pro volitelné funkce Photini lze také "
-"nainstalovat pomocí pip_. Mnohé z nich jsou uvedeny jako jeden nebo více "
-"\"doplňků\" v hranatých závorkách:"
-
-msgid ""
-"You can install all the extra dependencies in one go with ``pip3 install "
-"photini[extras]``."
+"be installed with ``photini-configure``:"
 msgstr ""
-"Všechny další závislosti můžete nainstalovat najednou pomocí ``pip3 install "
-"photini[extras]``."
-
-msgid ""
-"Other optional dependencies (Pillow_, gpxpy_) can also be installed with "
-"pip_, but may not be available for all Python and operating system "
-"combinations:"
-msgstr ""
-"Další volitelné závislosti (Pillow_, gpxpy_) lze také nainstalovat pomocí "
-"pip_, ale nemusí být k dispozici pro všechny kombinace jazyka Python a "
-"operačního systému:"
 
 msgid ""
 "Photini's spelling checker may require some other files to be installed. See"
@@ -269,15 +255,11 @@ msgstr ""
 "`pyenchant`_."
 
 msgid ""
-"One optional dependency that cannot be installed with pip_ is FFmpeg_. This "
-"is used to read metadata from video files. Linux & MacOS users can install "
-"it with the system package manager, but installing it on Windows is non-"
-"trivial."
+"One optional dependency that cannot be installed with pip_ or ``photini-"
+"configure`` is FFmpeg_. This is used to read metadata from video files. "
+"Linux & MacOS users can install it with the system package manager, but "
+"installing it on Windows is non-trivial."
 msgstr ""
-"Jednou z volitelných závislostí, kterou nelze nainstalovat pomocí pip_, je "
-"FFmpeg_. Ten se používá ke čtení metadat z video souborů. Uživatelé Linuxu a"
-" MacOS jej mohou nainstalovat pomocí správce systémových balíčků, ale jeho "
-"instalace v systému Windows není triviální."
 
 msgid "Start menu / application menu"
 msgstr "Nabídka Start / nabídka aplikací"
@@ -1528,3 +1510,83 @@ msgstr ""
 #~ msgid "python3-pyqt5.qtwebkit"
 #~ msgstr "python3-pyqt5.qtwebkit"
 
+#~ msgid ""
+#~ "Note that pip may need to be "
+#~ "updated again from within the virtual "
+#~ "environment. The ``--system-site-packages`` "
+#~ "option makes packages installed with the"
+#~ " Linux or MacOS package manager (e.g."
+#~ " PySide2) available within the virtual "
+#~ "environment. You should stay in this "
+#~ "virtual environment while installing and "
+#~ "testing Photini."
+#~ msgstr ""
+
+#~ msgid "Minimal installation"
+#~ msgstr "Minimální instalace"
+
+#~ msgid ""
+#~ "Photini and a set of essential "
+#~ "dependencies can all be installed with "
+#~ "pip_:"
+#~ msgstr "Photini a sadu základních závislostí lze nainstalovat pomocí pip_:"
+
+#~ msgid ""
+#~ "Instead of listing the dependencies "
+#~ "individually you can install them as "
+#~ "a set with ``pip3 install photini[basic]``."
+#~ msgstr ""
+#~ "Místo výpisu závislostí jednotlivě je "
+#~ "můžete nainstalovat jako sadu pomocí "
+#~ "příkazu ``pip3 install photini[basic]```."
+
+#~ msgid ""
+#~ "Most of the dependencies required for "
+#~ "Photini's optional features can also be "
+#~ "installed with pip_. Many are specified "
+#~ "as one or more \"extras\" in square"
+#~ " brackets:"
+#~ msgstr ""
+#~ "Většinu závislostí potřebných pro volitelné "
+#~ "funkce Photini lze také nainstalovat pomocí"
+#~ " pip_. Mnohé z nich jsou uvedeny "
+#~ "jako jeden nebo více \"doplňků\" v "
+#~ "hranatých závorkách:"
+
+#~ msgid ""
+#~ "You can install all the extra "
+#~ "dependencies in one go with ``pip3 "
+#~ "install photini[extras]``."
+#~ msgstr ""
+#~ "Všechny další závislosti můžete nainstalovat "
+#~ "najednou pomocí ``pip3 install photini[extras]``."
+
+#~ msgid ""
+#~ "Other optional dependencies (Pillow_, gpxpy_) "
+#~ "can also be installed with pip_, but"
+#~ " may not be available for all "
+#~ "Python and operating system combinations:"
+#~ msgstr ""
+#~ "Další volitelné závislosti (Pillow_, gpxpy_) "
+#~ "lze také nainstalovat pomocí pip_, ale "
+#~ "nemusí být k dispozici pro všechny "
+#~ "kombinace jazyka Python a operačního "
+#~ "systému:"
+
+#~ msgid ""
+#~ "One optional dependency that cannot be "
+#~ "installed with pip_ is FFmpeg_. This "
+#~ "is used to read metadata from video"
+#~ " files. Linux & MacOS users can "
+#~ "install it with the system package "
+#~ "manager, but installing it on Windows "
+#~ "is non-trivial."
+#~ msgstr ""
+#~ "Jednou z volitelných závislostí, kterou "
+#~ "nelze nainstalovat pomocí pip_, je FFmpeg_."
+#~ " Ten se používá ke čtení metadat z"
+#~ " video souborů. Uživatelé Linuxu a MacOS"
+#~ " jej mohou nainstalovat pomocí správce "
+#~ "systémových balíčků, ale jeho instalace v"
+#~ " systému Windows není triviální."
+
diff --git a/src/lang/de/LC_MESSAGES/index.po b/src/lang/de/LC_MESSAGES/index.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Photini 2022.6.0\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2022-09-27 11:58+0100\n"
+"POT-Creation-Date: 2022-09-27 17:39+0100\n"
 "PO-Revision-Date: 2022-06-30 12:10+0000\n"
 "Last-Translator: Jim Easterbrook <[email protected]>, 2022\n"
 "Language: de\n"