CMake now works with Russian documentation

cmake/FindSphinx.cmake

@@ -6,5 +6,11 @@ find_program(SPHINX_EXECUTABLE NAMES sphinx-build
     PATH_SUFFIXES bin
 )
 
-find_package_handle_standard_args(Sphinx DEFAULT_MSG SPHINX_EXECUTABLE)
-mark_as_advanced(SPHINX_EXECUTABLE)
+find_program(SPHINX_INTL_EXECUTABLE NAMES sphinx-intl
+    HINTS
+    $ENV{SPHINX_INTL_DIR}
+    PATH_SUFFIXES bin
+)
+
+find_package_handle_standard_args(Sphinx DEFAULT_MSG SPHINX_EXECUTABLE SPHINX_INTL_EXECUTABLE)
+mark_as_advanced(SPHINX_EXECUTABLE SPHINX_INTL_EXECUTABLE)

doc/sphinx/.gitignore

@@ -2,3 +2,5 @@
 *.pyc
 _html_build
 _single_build
+_locale_build
+conf.py

doc/sphinx/CMakeLists.txt

@@ -5,15 +5,20 @@ find_package(Doxygen REQUIRED)
 configure_file("${PROJECT_SOURCE_DIR}/Doxyfile.API.in"
     "${PROJECT_BINARY_DIR}/Doxyfile.API")
 
+configure_file("${CMAKE_CURRENT_SOURCE_DIR}/conf.py.in"
+    "${CMAKE_CURRENT_SOURCE_DIR}/conf.py")
+
 add_custom_target(api-doc
     COMMAND ${DOXYGEN_EXECUTABLE} "${PROJECT_BINARY_DIR}/Doxyfile.API"
     WORKING_DIRECTORY "${PROJECT_BINARY_DIR}"
     DEPENDS api
     COMMENT "Generating API documentation" VERBATIM)
 
-set(SPHINX_BUILD_SINGLE_DIR "${PROJECT_BINARY_DIR}/doc/sphinx/_single_build/")
+set(SPHINX_BUILD_SINGLEHTML_DIR "${PROJECT_BINARY_DIR}/doc/sphinx/_single_build/")
 set(SPHINX_BUILD_HTML_DIR   "${PROJECT_BINARY_DIR}/doc/sphinx/_html_build/")
+set(SPHINX_BUILD_LOCALE_DIR "${PROJECT_BINARY_DIR}/doc/sphinx/_locale_build/")
 set(SPHINX_HTML_DIR  "${PROJECT_BINARY_DIR}/doc/www/output/doc/")
+set(SPHINX_RU_HTML_DIR  "${PROJECT_BINARY_DIR}/doc/www/output/doc/ru/")
 
 #add_custom_command(OUTPUT
 #    ${MKDIR} -p ${SPHINX_BUILD_DIR})
@@ -24,7 +29,7 @@ add_custom_target(sphinx-html ALL
 #    DEPENDS ${SPHINX_BUILD_DIR} ${SPHINX_HTML_DIR}
     COMMAND "${SPHINX_EXECUTABLE}"
         -b html
-        -d "${SPHINX_BUILD_SINGLE_DIR}"
+        -d "${SPHINX_BUILD_HTML_DIR}"
         -c html/
         "${PROJECT_SOURCE_DIR}/doc/sphinx"
         "${SPHINX_HTML_DIR}"
@@ -35,7 +40,7 @@ add_custom_target(sphinx-html ALL
 add_custom_target(sphinx-singlehtml ALL
     COMMAND "${SPHINX_EXECUTABLE}"
         -b singlehtml
-        -d "${SPHINX_BUILD_HTML_DIR}"
+        -d "${SPHINX_BUILD_SINGLEHTML_DIR}"
         -c singlehtml/
         "${PROJECT_SOURCE_DIR}/doc/sphinx"
         "${SPHINX_HTML_DIR}"
@@ -43,3 +48,49 @@ add_custom_target(sphinx-singlehtml ALL
     COMMENT "Building HTML documentation with Sphinx"
     DEPENDS api-doc
 )
+
+add_custom_target(sphinx-html-ru ALL
+#    DEPENDS ${SPHINX_BUILD_DIR} ${SPHINX_HTML_DIR}
+    COMMAND "${SPHINX_EXECUTABLE}"
+        -b html
+        -d "${SPHINX_BUILD_HTML_DIR}"
+        -c html/
+        "${PROJECT_SOURCE_DIR}/doc/sphinx"
+        "${SPHINX_RU_HTML_DIR}"
+        -Dlanguage=ru
+    COMMENT "Building HTML documentation with Sphinx"
+    DEPENDS api-doc
+)
+
+add_custom_target(sphinx-singlehtml-ru ALL
+    COMMAND "${SPHINX_EXECUTABLE}"
+        -b singlehtml
+        -d "${SPHINX_BUILD_SINGLEHTML_DIR}"
+        -c singlehtml/
+        "${PROJECT_SOURCE_DIR}/doc/sphinx"
+        "${SPHINX_RU_HTML_DIR}"
+        singlehtml.rst
+        -Dlanguage=ru
+    COMMENT "Building HTML documentation with Sphinx"
+    DEPENDS api-doc
+)
+
+add_custom_target(sphinx-update-pot
+    COMMAND "${SPHINX_EXECUTABLE}"
+        -b gettext
+        -d "${SPHINX_BUILD_LOCALE_DIR}"
+        -c locale/
+        "${PROJECT_SOURCE_DIR}/doc/sphinx"
+        "${PROJECT_SOURCE_DIR}/doc/sphinx/locale"
+    COMMENT "Generate localization templates"
+    DEPENDS api-doc
+)
+
+add_custom_target(sphinx-update-po
+    COMMAND "${SPHINX_INTL_EXECUTABLE}"
+        update
+        -p ${PROJECT_SOURCE_DIR}/doc/sphinx/locale
+    WORKING_DIRECTORY ${PROJECT_SOURCE_DIR}/doc/sphinx/locale
+    COMMENT "Regenerate localization files from templates"
+    DEPENDS sphinx-update-pot
+)

doc/sphinx/conf.py → doc/sphinx/conf.py.in

@@ -11,8 +11,6 @@ master_doc = 'index'
 extensions = [
     'sphinx.ext.todo',
     'sphinx.ext.ifconfig',
-    #'sphinx.ext.autodoc',
-    #'sphinx.ext.autosummary',
     'ext.custom',
     'ext.LuaDomain',
     'ext.LuaLexer',
@@ -30,7 +28,7 @@ breathe_projects = {
 }
 
 # |release| The full version, including alpha/beta/rc tags.
-release = open('../../../VERSION').read().strip()
+release = open('@CMAKE_SOURCE_DIR@/VERSION').read().strip()
 # |version| The short X.Y version.
 version = '.'.join(release.split('.')[0:2])
 
@@ -94,11 +92,7 @@ rst_epilog = """
     <br />
 """
 
-# def setup(sphinx):
-#     sys.path.insert(0, os.path.abspath('./ext'))
-#     from LuaLexer import LuaLexer
-#     sphinx.add_lexer("lua_tarantool", LuaLexer())
-#     from TarantoolSessionLexer import TarantoolSessionLexer
-#     sphinx.add_lexer("tarantoolsession", TarantoolSessionLexer())
-#     from TapLexer import TAPLexer
-#     sphinx.add_lexer('tap', TAPLexer())
+# Localization options
+language = 'en'
+locale_dirs = ['./locale']
+gettext_additional_targets = ['literal-block']

doc/sphinx/locale/conf.py

+# -*- coding: utf-8 -*-
+execfile('../conf.py')