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()

CMakeLists.txt

@@ -0,0 +1,12 @@
+all:
+	lessc --source-map --source-map-less-inline --strict-imports \
+		  --autoprefix="last 3 versions" \
+		  design.less design.css
+	cleancss --s1 design.css > design.min.css
+	mv design.min.css design.css
+	mv design.css** ../static/
+
+debug:
+	lessc --source-map --source-map-less-inline --strict-imports \
+		  --autoprefix="last 3 versions" \
+		  design.less ../static/design.css

www/content/CNAME renamed to CNAME

@@ -0,0 +1,78 @@
+html {
+    height:100%;
+    font-size:100%;
+    overflow-y: scroll;
+    -webkit-text-size-adjust:100%;
+    -ms-text-size-adjust:100%;
+    -webkit-font-smoothing:antialiased;
+}
+body {
+    font-family: "Helvetica Neue", Arial, Tahoma, Verdana;
+    font-size:1em;
+    font-style:normal;
+    font-weight: 300;
+    color: #262626;
+    position:relative;
+    height:100%;
+    background:#FFF;
+    margin:0;
+}
+a, img, input, textarea, select {
+    outline:none;
+}
+label {
+    cursor:pointer;
+}
+img {
+    border:0;
+    vertical-align:bottom;
+}
+form {
+    margin:0;
+}
+header, nav, section, article, aside, footer {
+    display:block;
+}
+a {
+    color: #168de2;
+    text-decoration: underline;
+}
+a:hover {
+    color:#168de2;
+    text-decoration: none;
+}
+textarea, input {
+    font: inherit;
+    resize:none;
+}
+p {
+    margin:0;
+    padding:0 0 20px 0;
+}
+table {
+    border-collapse: collapse;
+}
+h1, h2, h3, h4, h5 {
+    margin-top:0;
+    font-weight:normal;
+}
+@font-face {
+    font-family: 'helvetica-r';
+    src: url('fonts/HelveticaNeue.eot');
+    src: url('fonts/HelveticaNeue.eot?#iefix')                format('embedded-opentype'),
+         url('fonts/HelveticaNeue.woff')                      format('woff'),
+         url('fonts/HelveticaNeue.ttf')                       format('truetype'),
+         url('fonts/HelveticaNeue.svg#helveticaneuecyrroman') format('svg');
+    font-weight: normal;
+    font-style: normal;
+}
+@font-face {
+    font-family: 'helvetica-b';
+    src: url('fonts/HelveticaNeue-Bold.eot');
+    src: url('fonts/HelveticaNeue-Bold.eot?#iefix')                  format('embedded-opentype'),
+         url('fonts/HelveticaNeue-Bold.woff')                        format('woff'),
+         url('fonts/HelveticaNeue-Bold.ttf')                         format('truetype'),
+         url('fonts/HelveticaNeue-Bold.svg#helioscompressedregular') format('svg');
+    font-weight: normal;
+    font-style: normal;
+}

www/content/license.docx renamed to _downloads/license.docx

@@ -0,0 +1,21 @@
+// @import (less, once) "font-awesome/font-awesome.less";
+@import (inline) "font-awesome.min.css";
+
+@import (less, once) "base.less";
+@import (less, once) "page-base.less";
+@import (less, once) "page-index.less";
+@import (less, once) "page-download.less";
+@import (less, once) "page-job.less";
+@import (less, once) "page-rocks.less";
+@import (less, once) "page-try.less";
+@import (less, once) "page-doc.less";
+@import (less, once) "page-benchmark.less";
+
+@import (less, once) "pygmentize.less";
+@import (less, once) "dropdown.less";
+
+/* TODO: port them too */
+@import (inline) "old_design.css";
+@import (inline) "sphinx_design.css";
+
+/* @import "obsolete.less"; */