WIP: Grand site structure refactoring

* Getting rid of Pelican
  - merge codebases (css, js). removed a lot of garbage
  - ported pages from pelican to sphinx
  - /en and /ru now, rules must be configurated in nginx
  - Create plugins for dropdown menus and sections ()
* Extract theme to separate directory (for reuse in other projects)
* Add Less for CSS preprocessing
* A lot of little style refactoring and fixes
* Embed try page into site (using iframe)
* Embed rocks page into site (using custom python gen + lupa extension)

TODO:
* Review mobile and tablet design, again

A lot of style fixes. sphinx-webserver, sphinx-linkcheck. becnhmarks/careers/doc pages. page buttons.

closes gh-78
closes gh-55
closes gh-82
closes gh-81
closes gh-66
closes gh-68
closes gh-2

Author: bigbes

.gitignore

@@ -2,8 +2,11 @@ CMakeCache.txt
 CMakeFiles
 Makefile
 cmake_install.cmake
-sphinx/locale/ru/LC_MESSAGES/*.mo
+locale/ru/LC_MESSAGES/*.mo
 .DS_Store
-sphinx/_html_ru_build/
-sphinx/_single_ru_build/
+_*_build/
 deploy_key
+.venv
+output
+*.pyc
+_theme/tarantool/static/design.css.map

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "rocks"]
+	path = rocks
+	url = https://github.com/tarantool/rocks

www/content/.nojekyll renamed to .nojekyll

@@ -1,8 +1,21 @@
 language: generic # don't install any environment
+sudo: true
+
+addons:
+  apt:
+    sources:
+      - george-edison55-precise-backports
+    packages:
+      - cmake
+      - cmake-data
+      - lua5.1
+
 install:
-    - pip install sphinx==1.4.4 pelican BeautifulSoup sphinx-intl PyYAML --user
+  - cmake --version
+  - pip install -r requirements.txt --upgrade
+
 script: bash ./documentation.sh
+
 env:
   global:
     - ENCRYPTION_LABEL: "cc37864fc395"
-

.travis.yml

@@ -1,6 +1,6 @@
-cmake_minimum_required(VERSION 2.8)
+cmake_minimum_required(VERSION 2.8.12)
 
-project(tarantoold-doc)
+project(tarantool-doc)
 
 set(CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake" ${CMAKE_MODULE_PATH})
 set(CMAKE_INCLUDE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake" ${CMAKE_INCLUDE_PATH})
@@ -9,11 +9,9 @@ include(FindOptionalPackage)
 include(FindPackageMessage)
 
 include(cmake/FindSphinx.cmake)
+find_package(Sphinx REQUIRED)
 
-#
 # Get version
-#
-
 set (PACKAGE_VERSION "")
 set (TARANTOOL_VERSION "")
 
@@ -30,9 +28,7 @@ if (NOT TARANTOOL_VERSION)
     message (FATAL_ERROR "Unable to retrive version from git or ${VERSION_FILE} file.")
 endif()
 
-#
 # Split full version (git describe --long) to get components
-#
 string(REPLACE "-" "." TARANTOOL_VERSION_LIST ${TARANTOOL_VERSION})
 string(REPLACE "." ";" TARANTOOL_VERSION_LIST ${TARANTOOL_VERSION_LIST})
 LIST(GET TARANTOOL_VERSION_LIST 0 CPACK_PACKAGE_VERSION_MAJOR)
@@ -47,5 +43,120 @@ find_package_message(TARANTOOL_VERSION
     "Tarantool version is ${TARANTOOL_VERSION} (${PACKAGE_VERSION})"
     "${PACKAGE_VERSION}")
 
-add_subdirectory(sphinx)
-add_subdirectory(www)
+set(SPHINX_BUILD_SINGLEHTML_DIR    "${CMAKE_CURRENT_BINARY_DIR}/_single_build/")
+set(SPHINX_BUILD_HTML_DIR          "${CMAKE_CURRENT_BINARY_DIR}/_html_build/")
+set(SPHINX_BUILD_LOCALE_DIR        "${CMAKE_CURRENT_BINARY_DIR}/_locale_build/")
+set(SPHINX_BUILD_SINGLEHTML_RU_DIR "${CMAKE_CURRENT_BINARY_DIR}/_single_ru_build/")
+set(SPHINX_BUILD_HTML_RU_DIR       "${CMAKE_CURRENT_BINARY_DIR}/_html_ru_build/")
+set(SPHINX_OUTPUT_DIR              "${CMAKE_CURRENT_BINARY_DIR}/output")
+set(SPHINX_EN_HTML_DIR             "${SPHINX_OUTPUT_DIR}/en/")
+set(SPHINX_RU_HTML_DIR             "${SPHINX_OUTPUT_DIR}/ru/")
+
+add_custom_target(update-submodules ALL
+    COMMAND git submodule update --init --recursive
+    COMMENT "Update submodules before building docs"
+)
+add_custom_target(sphinx-html ALL
+    COMMAND "${SPHINX_EXECUTABLE}"
+        -b html
+        -d "${SPHINX_BUILD_HTML_DIR}"
+        -c html/
+        "${CMAKE_CURRENT_SOURCE_DIR}"
+        "${SPHINX_EN_HTML_DIR}"
+    COMMENT "Building HTML documentation with Sphinx"
+    DEPENDS update-submodules
+)
+
+add_custom_target(sphinx-singlehtml ALL
+    COMMAND "${SPHINX_EXECUTABLE}"
+        -b singlehtml
+        -d "${SPHINX_BUILD_SINGLEHTML_DIR}"
+        -c singlehtml/
+        "${CMAKE_CURRENT_SOURCE_DIR}"
+        "${SPHINX_EN_HTML_DIR}/doc"
+        doc/singlehtml.rst
+    COMMENT "Building HTML documentation with Sphinx"
+    DEPENDS update-submodules
+)
+
+add_custom_target(sphinx-html-ru ALL
+    COMMAND "${SPHINX_EXECUTABLE}"
+        -b html
+        -d "${SPHINX_BUILD_HTML_RU_DIR}"
+        -c html/
+        "${CMAKE_CURRENT_SOURCE_DIR}"
+        "${SPHINX_RU_HTML_DIR}"
+        -Dlanguage=ru
+    COMMENT "Building HTML documentation with Sphinx"
+    DEPENDS update-submodules
+)
+
+add_custom_target(sphinx-singlehtml-ru ALL
+    COMMAND "${SPHINX_EXECUTABLE}"
+        -b singlehtml
+        -d "${SPHINX_BUILD_SINGLEHTML_RU_DIR}"
+        -c singlehtml/
+        "${CMAKE_CURRENT_SOURCE_DIR}"
+        "${SPHINX_RU_HTML_DIR}/doc"
+        doc/singlehtml.rst
+        -Dlanguage=ru
+    COMMENT "Building HTML documentation with Sphinx"
+    DEPENDS update-submodules
+)
+
+add_custom_target(sphinx-update-pot
+    COMMAND "${SPHINX_EXECUTABLE}"
+        -b gettext
+        -d "${SPHINX_BUILD_LOCALE_DIR}"
+        -c locale/
+        "${CMAKE_CURRENT_SOURCE_DIR}"
+        "${CMAKE_CURRENT_SOURCE_DIR}/locale"
+    COMMENT "Generate localization templates"
+)
+
+add_custom_target(sphinx-update-po
+    COMMAND "${SPHINX_INTL_EXECUTABLE}"
+        update
+        -p ${CMAKE_CURRENT_SOURCE_DIR}/locale
+    WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
+    COMMENT "Regenerate localization files from templates"
+    DEPENDS sphinx-update-pot
+)
+
+add_custom_target(sphinx-linkcheck
+    COMMAND "${SPHINX_EXECUTABLE}"
+        -b linkcheck
+        -d "${SPHINX_BUILD_LOCALE_DIR}"
+        -c html
+        "${CMAKE_CURRENT_SOURCE_DIR}"
+        "${SPHINX_BUILD_HTML_DIR}"
+    COMMENT "Linkcheck filter"
+)
+
+add_custom_target(sphinx-webserver
+    COMMAND screen -dmS sphinx-webserver python -m SimpleHTTPServer 8000
+    WORKING_DIRECTORY ${SPHINX_OUTPUT_DIR})
+
+set(STATIC_FILES
+    .nojekyll
+    CNAME
+    robots.txt
+    _downloads/license.docx
+    _downloads/license_eng.docx
+    _downloads/terms.docx
+    _downloads/terms_eng.docx
+)
+
+add_custom_target(copy-static ALL
+    COMMENT "Copy static files")
+foreach(FILE_PATH ${STATIC_FILES})
+    get_filename_component(FILE_DIR ${FILE_PATH} DIRECTORY)
+    add_custom_command(TARGET copy-static PRE_BUILD
+        COMMAND ${CMAKE_COMMAND} -E make_directory
+                                 ${SPHINX_OUTPUT_DIR}/${FILE_DIR})
+    add_custom_command(TARGET copy-static PRE_BUILD
+        COMMAND ${CMAKE_COMMAND} -E copy
+                                 ${CMAKE_CURRENT_SOURCE_DIR}/${FILE_PATH}
+                                 ${SPHINX_OUTPUT_DIR}/${FILE_PATH}
+    )
+endforeach()