Merge pull request #194 from radinamatic/404-for-0.7

Add 404 page to 0.7 branch

docs/404.rst

@@ -0,0 +1,17 @@
+:orphan:
+
+Page not found
+==============
+
+It seems you are searching for a topic that has been moved elsewhere in our documentation. Please try the following to find what you were looking for:
+
+* Browse the table of content in the sidebar 
+* Use the search box
+
+
+*Use |menu| button to open the table of contents if you are on the mobile device.*
+
+.. tip:: Make sure you are browsing the user guide for the `latest release of Kolibri <https://kolibri.readthedocs.io/en/latest/>`_.
+
+
+We apologize for the inconvenience!

docs/_static/theme_overrides.css

@@ -1,4 +1,9 @@
 
+/* push down the RTD banner so it's not confused with menu */
+.keep-us-sustainable {
+  margin-top: 20em !important;
+}
+
  .wy-table-responsive table td {
     /* !important prevents the common CSS stylesheets from overriding
        this as on RTD they are loaded after this stylesheet */

docs/access.rst

@@ -9,7 +9,7 @@ Starting Kolibri on Windows
 
 To start **Kolibri** on Windows, just double-click the desktop shortcut. You will see the notification message *Kolibri is starting, please wait...*.
 
-When you see the notification *Kolibri is running...*, **Kolibri** will open in the browser with the URL http://127.0.0.1:8080.
+When you see the notification *Kolibri is running...*, **Kolibri** will open in the browser with the URL ``http://127.0.0.1:8080``.
 
 
 Kolibri Taskbar Options
@@ -25,7 +25,7 @@ While it is running, **Kolibri** will display an icon in the Windows taskbar (us
 
 * Use the **Load in browser** option to open Kolibri in the browser.
 * By default **Kolibri** will start running every time you start the computer where it is installed. Uncheck the **Run Kolibri at system startup** option if you prefer to start it manually from the desktop shortcut.
-* When installed, **Kolibri** will open in the browser every time it is started. Uncheck the option **Open browser when Kolibri starts** if you prefer to have it running in the background, and to open it manually in the browser by typing the URL http://127.0.0.1:8080 in the address bar.
+* When installed, **Kolibri** will open in the browser every time it is started. Uncheck the option **Open browser when Kolibri starts** if you prefer to have it running in the background, and to open it manually in the browser by typing the URL ``http://127.0.0.1:8080`` in the address bar.
 * Select **Exit** to stop **Kolibri**. You will be prompted to confirm the selection, after which **Kolibri** will stop. You will have to close the browser (or the tab) manually.
 
 .. note::
@@ -44,7 +44,7 @@ Starting Kolibri on Linux
 
     kolibri start
 
-2. Open the default browser at http://127.0.0.1:8080 displaying the **Kolibri** start page.
+2. Open the default browser at ``http://127.0.0.1:8080`` displaying the **Kolibri** start page.
 
 .. note::
   Remember to :ref:`configure other computers <access_LAN>` in the network to access **Kolibri** content.
@@ -77,9 +77,9 @@ Accessing Kolibri from Other Devices in the Network
 
 While **Kolibri** is up and running on the device where you installed it, other computers, tablets, even mobile phones in the same **Local Area Network (LAN)** can access its learning contents.
 
-* To access the content on the same device/computer where **Kolibri** is running, open the browser at the address http://127.0.0.1:8080/.
+* To access the content on the same device/computer where **Kolibri** is running, open the browser at the address ``http://127.0.0.1:8080``/.
 
-* To access the content from other devices in the same network, you need to know the IP address of one where where **Kolibri** is running. For example, if **Kolibri** is on a device/computer with IP address **192.168.0.104**, you can access it from others in the same network by opening the browser and typing the address http://192.168.0.104:8080.
+* To access the content from other devices in the same network, you need to know the IP address of one where where **Kolibri** is running. For example, if **Kolibri** is on a device/computer with IP address **192.168.0.104**, you can access it from others in the same network by opening the browser and typing the address ``http://192.168.0.104:8080``.
 
 * You can check the IP (**Server URL**) of the device where Kolibri is running by going to **Info** tab in the **Device** dashboard, .
 

docs/conf.py

@@ -14,7 +14,7 @@
 # FOR! DO NOT LET THEM BE TARGETTED AT MORE THAN ONE MINOR SERIES!
 # I.E.: 0.1.x -- important to add 'dev' suffix for docs targetting development
 # series.
-DISPLAY_VERSION = "0.7.x"
+DISPLAY_VERSION = "0.7"
 
 
 # If extensions (or modules to document with autodoc) are in another directory,
@@ -24,12 +24,18 @@
 parent = os.path.dirname(cwd)
 sys.path.insert(0, os.path.abspath(parent))
 
+extensions = [
+    'sphinx_rtd_theme',
+    'notfound.extension',
+]
+
 builddir = os.path.join(cwd, '_build')
 
 # -- General configuration -----------------------------------------------------
 
 linkcheck_ignore = [
     'https://groups.google.com/a/learningequality.org/forum/#!forum/dev',
+    'https://blog.learningequality.org/',
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -158,6 +164,7 @@ def setup(app):
 .. |pencil| replace:: :raw-html:`<span class="fa fa-pencil" aria-hidden="true"></span><span class="visuallyhidden">Edit</span>`
 .. |arrow-right| replace:: :raw-html:`<span class="fa fa-arrow-right" aria-hidden="true"></span><span class="visuallyhidden">See next</span>`
 .. |arrow-left| replace:: :raw-html:`<span class="fa fa-arrow-left" aria-hidden="true"></span><span class="visuallyhidden">See previous</span>`
+.. |menu| replace:: :raw-html:`<span class="fa fa-bars" aria-hidden="true"></span><span class="visuallyhidden">Menu</span>`
 
 """
 

docs/install/_linux.rst

@@ -38,7 +38,7 @@ Install from PPA repository
 
     kolibri start
 	
-6. When command finishes, open the default browser at http://127.0.0.1:8080 and proceed with the :ref:`setup_initial` of your facility. 
+6. When command finishes, open the default browser at ``http://127.0.0.1:8080`` and proceed with the :ref:`setup_initial` of your facility. 
 
 
 Uninstall

docs/install/_osx.rst

@@ -18,7 +18,7 @@ Install
     chmod +x kolibri-installer-filename.pex
     ./kolibri-installer-filename.pex start
 
-#. Once the command finishes, open the default browser at http://127.0.0.1:8080 and proceed with the :ref:`setup_initial` of your facility. 
+#. Once the command finishes, open the default browser at ``http://127.0.0.1:8080`` and proceed with the :ref:`setup_initial` of your facility. 
 
 
 Uninstall

requirements.txt

@@ -2,3 +2,4 @@
 sphinx
 sphinx_rtd_theme
 sphinx-intl
+sphinx-notfound-page