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

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

Author: bigbes

.gitignore

@@ -2,8 +2,10 @@ 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

www/content/.nojekyll renamed to .nojekyll

@@ -1,8 +1,20 @@
 language: generic # don't install any environment
+sudo: false
+
+addons:
+  apt:
+    sources:
+      - george-edison55-precise-backports
+    packages:
+      - cmake
+      - cmake-data
+
 install:
-    - pip install sphinx==1.4.4 pelican BeautifulSoup sphinx-intl PyYAML --user
+  - cmake --version
+  - pip install sphinx sphinx-intl --user
+
 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,112 @@ 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(sphinx-html ALL
+    COMMAND "${SPHINX_EXECUTABLE}"
+        -b html
+        -d "${SPHINX_BUILD_HTML_DIR}"
+        -a
+        -c html/
+        "${CMAKE_CURRENT_SOURCE_DIR}"
+        "${SPHINX_EN_HTML_DIR}"
+    COMMENT "Building HTML documentation with Sphinx"
+)
+
+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"
+)
+
+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"
+)
+
+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"
+)
+
+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 COMMENT "Copy static files" ALL)
+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,7 @@
+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/

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"; */

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

@@ -0,0 +1,89 @@
+@import (reference) "mixins";
+
+@dropdown-open : data-uri('data:image/png;base64', 'icons/dropdown-open.png');
+@dropdown-close: data-uri('data:image/png;base64', 'icons/dropdown-close.png');
+
+// dropdown-list:
+//   * dropdown-list-item ->
+//     -> dropdown-list-item-url
+//     -> dropdown-list-item-content
+//   * ...
+
+.dropdown-list-item-content {
+    .transition-ease();
+}
+
+.dropdown-list {
+    margin:     0;
+    padding:    0;
+    display:    block;
+    list-style: none;
+    border-top: 1px solid #e5e5e5;
+
+    .dropdown-list-item {
+        color:         #404040;
+        padding:       14px 0;
+        font-size:     18px;
+        border-bottom: 1px solid #e5e5e5;
+        .b-example-code {
+            margin-left: 14px;
+        }
+    }
+}
+
+.dropdown-list-item-content {
+    color:         #404040;
+    filter:        alpha(opacity=0);
+    height:        0px;
+    opacity:       0;
+    overflow:      hidden;
+    font-size:     14px;
+    padding-left:  17px;
+    padding-right: 40px;
+    .transition-ease();
+    a {
+        text-decoration: none;
+    }
+    a:hover {
+        text-decoration: underline;
+    }
+    ul {
+        padding-left: 18px;
+    }
+    &.dropdown-open {
+        filter:         alpha(opacity=100);
+        height:         auto;
+        opacity:        1;
+        padding-top:    17px;
+        padding-bottom: 12px;
+    }
+}
+
+.dropdown-list-item-url {
+    color:           inherit;
+    display:         block;
+    text-decoration: none;
+    &.dropdown-close {
+        background-image: @dropdown-close;
+    }
+    &.dropdown-open {
+        color:            #168de2;
+        background-image: @dropdown-open;
+    }
+    &.dropdown-close,
+    &.dropdown-open {
+        padding-right:       40px;
+        background-repeat:   no-repeat;
+        background-position: 100% 50%;
+    }
+}
+
+@media screen and (max-width: 992px) {
+    .dropdown-list-item {
+        font-size: 16px;
+        padding: 11px 0;
+    }
+    .dropdown-list-item-content.dropdown-open {
+        padding: 25px 0 15px;
+    }
+}

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

@@ -0,0 +1,14 @@
+.transition-ease() {
+    -webkit-transition: all 0.2s ease-in-out;
+    -moz-transition: all 0.2s ease-in-out;
+    -o-transition: all 0.2s ease-in-out;
+    -ms-transition: all 0.2s ease-in-out;
+    transition: all 0.2s ease-in-out;
+}
+
+.block-list() {
+    margin:     0;
+    padding:    0;
+    display:    block;
+    list-style: none;
+}