Set up infrastructure for localized man pages

PR #19515.

dist/unix/CMakeLists.txt

@@ -18,17 +18,20 @@ if (SYSTEMD)
     )
 endif()
 
-if (GUI)
+set(manPageLanguages
-    list(APPEND MAN_FILES ${PROJECT_SOURCE_DIR}/doc/qbittorrent.1)
+    en
-else()
+    ru
-    list(APPEND MAN_FILES ${PROJECT_SOURCE_DIR}/doc/qbittorrent-nox.1)
-endif()
-
-install(FILES ${MAN_FILES}
-    DESTINATION ${CMAKE_INSTALL_MANDIR}/man1
-    COMPONENT doc
 )
 
+foreach(manPageLanguage ${manPageLanguages})
+    install(FILES ${PROJECT_SOURCE_DIR}/doc/${manPageLanguage}/$<IF:$<BOOL:${GUI}>,qbittorrent.1,qbittorrent-nox.1>
+        # English man pages are installed into ${CMAKE_INSTALL_MANDIR}/man1, while man pages
+        # in other languages are installed into ${CMAKE_INSTALL_MANDIR}/${manPageLanguage}/man1.
+        DESTINATION ${CMAKE_INSTALL_MANDIR}/$<$<NOT:$<STREQUAL:${manPageLanguage},en>>:${manPageLanguage}/>man1
+        COMPONENT doc
+    )
+endforeach()
+
 if (GUI)
     install(FILES org.qbittorrent.qBittorrent.desktop
         DESTINATION ${CMAKE_INSTALL_DATAROOTDIR}/applications/

doc/README.md

@@ -18,3 +18,9 @@ You'll need to be careful when you copy the output to file as some headers will
 Careful not to overwrite the existing leading headers or trim off the trailing headers.
 
 Remember to commit Markdown files (\*.md) and the generated man pages (\*.1 files) after editing!
+
+### Translation
+
+To translate the man pages into a new language, create a new subdirectory here
+with the translated files and add it to the `manPageLanguages` list in
+[`dist/unix/CMakeLists.txt`](../dist/unix/CMakeLists.txt).

doc/ru/qbittorrent-nox.1

@@ -0,0 +1,6 @@
+.TH "QBITTORRENT-NOX" "1" "16 января 2010" "Клиент сети БитТоррент для командной строки" ""
+.SH НАЗВАНИЕ
+.PP
+qBittorrent-nox \[em] клиент сети БитТоррент для командной строки.
+.SH АВТОРЫ
+Christophe Dumez <chris@qbittorrent.org>

doc/ru/qbittorrent-nox.1.md

@@ -0,0 +1,6 @@
+% QBITTORRENT-NOX(1) Клиент сети БитТоррент для командной строки
+% Christophe Dumez <chris@qbittorrent.org>
+% 16 января 2010
+
+# НАЗВАНИЕ
+qBittorrent-nox — клиент сети БитТоррент для командной строки.

doc/ru/qbittorrent.1

@@ -0,0 +1,6 @@
+.TH "QBITTORRENT" "1" "16 января 2010" "Клиент сети БитТоррент" ""
+.SH НАЗВАНИЕ
+.PP
+qBittorrent \[em] клиент сети БитТоррент.
+.SH АВТОРЫ
+Christophe Dumez <chris@qbittorrent.org>

doc/ru/qbittorrent.1.md

@@ -0,0 +1,6 @@
+% QBITTORRENT(1) Клиент сети БитТоррент
+% Christophe Dumez <chris@qbittorrent.org>
+% 16 января 2010
+
+# НАЗВАНИЕ
+qBittorrent — клиент сети БитТоррент.