Initial import of TripleO docs

.gitignore

@@ -0,0 +1,13 @@
+*.swp
+*~
+*.qcow2
+
+.DS_Store
+
+*.egg
+*.egg-info
+*.pyc
+
+.tox
+doc/build
+build

README.md

@@ -0,0 +1,4 @@
+TripleO Documentation
+=====================
+
+TripleO documentation.

doc/source/_custom/admonition_selector.js

@@ -0,0 +1,58 @@
+/*
+  This function will search for all classes matching all IDs which are under
+  #admonition_selector element and display/hide their content.
+
+  State is saved in cookies so user doesn't lose his settings after page
+  reload or changing pages.
+
+  To make this feature work, you need to:
+  - add checkbox to _templates/layout.html file with proper ID
+  - in admonitions use proper class which matches above mentioned ID
+*/
+
+
+
+// after document is loaded
+$(document).ready(function() {
+
+    // for each checkbox in #admonition_selector do
+    $('#admonition_selector :checkbox').each(function() {
+
+      // check value of cookies and set state to the related element
+      if ($.cookie($(this).attr("id")) == "true") {
+        $(this).prop("checked", true);
+      } else if (($.cookie($(this).attr("id")) == "false")) {
+        $(this).prop("checked", false);
+      }
+
+      // show/hide elements after page loaded
+      toggle_admonition($(this).attr("id"));
+    });
+
+    // when user clicks on the checkbox, react
+    $('#admonition_selector :checkbox').change(function() {
+
+        // show/hide related elements
+        toggle_admonition($(this).attr("id"));
+
+        // save the state in the cookies
+        $.cookie($(this).attr("id"), $(this).is(':checked'), { path: '/' });
+    });
+});
+
+
+// function to show/hide elements based on checkbox state
+// checkbox has ID and it toggles elements having class named same way as the ID
+function toggle_admonition(admonition) {
+
+  // for each element having class as the checkbox's ID
+  $(".admonition." + admonition).each(function() {
+
+    // set show/hide
+    if($("#" + admonition).is(':checked')) {
+      $(this).show();
+    } else {
+      $(this).hide();
+    }
+  });
+}

doc/source/_custom/cookies.js

@@ -0,0 +1,117 @@
+/*!
+ * jQuery Cookie Plugin v1.4.1
+ * https://github.com/carhartl/jquery-cookie
+ *
+ * Copyright 2013 Klaus Hartl
+ * Released under the MIT license
+ */
+(function (factory) {
+  if (typeof define === 'function' && define.amd) {
+    // AMD
+    define(['jquery'], factory);
+  } else if (typeof exports === 'object') {
+    // CommonJS
+    factory(require('jquery'));
+  } else {
+    // Browser globals
+    factory(jQuery);
+  }
+}(function ($) {
+
+  var pluses = /\+/g;
+
+  function encode(s) {
+    return config.raw ? s : encodeURIComponent(s);
+  }
+
+  function decode(s) {
+    return config.raw ? s : decodeURIComponent(s);
+  }
+
+  function stringifyCookieValue(value) {
+    return encode(config.json ? JSON.stringify(value) : String(value));
+  }
+
+  function parseCookieValue(s) {
+    if (s.indexOf('"') === 0) {
+      // This is a quoted cookie as according to RFC2068, unescape...
+      s = s.slice(1, -1).replace(/\\"/g, '"').replace(/\\\\/g, '\\');
+    }
+
+    try {
+      // Replace server-side written pluses with spaces.
+      // If we can't decode the cookie, ignore it, it's unusable.
+      // If we can't parse the cookie, ignore it, it's unusable.
+      s = decodeURIComponent(s.replace(pluses, ' '));
+      return config.json ? JSON.parse(s) : s;
+    } catch(e) {}
+  }
+
+  function read(s, converter) {
+    var value = config.raw ? s : parseCookieValue(s);
+    return $.isFunction(converter) ? converter(value) : value;
+  }
+
+  var config = $.cookie = function (key, value, options) {
+
+    // Write
+
+    if (value !== undefined && !$.isFunction(value)) {
+      options = $.extend({}, config.defaults, options);
+
+      if (typeof options.expires === 'number') {
+        var days = options.expires, t = options.expires = new Date();
+        t.setTime(+t + days * 864e+5);
+      }
+
+      return (document.cookie = [
+        encode(key), '=', stringifyCookieValue(value),
+        options.expires ? '; expires=' + options.expires.toUTCString() : '', // use expires attribute, max-age is not supported by IE
+        options.path    ? '; path=' + options.path : '',
+        options.domain  ? '; domain=' + options.domain : '',
+        options.secure  ? '; secure' : ''
+      ].join(''));
+    }
+
+    // Read
+
+    var result = key ? undefined : {};
+
+    // To prevent the for loop in the first place assign an empty array
+    // in case there are no cookies at all. Also prevents odd result when
+    // calling $.cookie().
+    var cookies = document.cookie ? document.cookie.split('; ') : [];
+
+    for (var i = 0, l = cookies.length; i < l; i++) {
+      var parts = cookies[i].split('=');
+      var name = decode(parts.shift());
+      var cookie = parts.join('=');
+
+      if (key && key === name) {
+        // If second argument (value) is a function it's a converter...
+        result = read(cookie, value);
+        break;
+      }
+
+      // Prevent storing a cookie that we couldn't decode.
+      if (!key && (cookie = read(cookie)) !== undefined) {
+        result[name] = cookie;
+      }
+    }
+
+    return result;
+  };
+
+  config.defaults = {};
+
+  $.removeCookie = function (key, options) {
+    if ($.cookie(key) === undefined) {
+      return false;
+    }
+
+    // Must not alter options, thus extending a fresh object...
+    $.cookie(key, '', $.extend({}, options, { expires: -1 }));
+    return !$.cookie(key);
+  };
+
+}));

doc/source/_custom/custom.css

@@ -0,0 +1,129 @@
+/* CUSTOM CSS OVERRIDES GO HERE */
+/* ============================ */
+
+/* remove backgrounds */
+#admonition_selector {
+  background: none !important;
+  color: black !important;
+}
+
+/* admonition selector */
+#admonition_selector {
+  border-top: 0 none !important;
+}
+
+#admonition_selector .title {
+  color: rgba(0, 0, 0, 0.6) !important;
+}
+
+.trigger {
+  color: rgba(0, 0, 0, 0.7) !important;
+  border-top: 1px solid rgba(0, 0, 0, 0.2);
+  border-bottom: 1px solid rgba(0, 0, 0, 0.2);
+  background: rgba(0, 0, 0, 0.05);
+}
+
+.trigger:hover {
+  color: rgba(0, 0, 0, 0.9) !important;
+}
+
+/* NOTES, ADMONITTIONS AND TAGS */
+.admonition {
+  font-size: 85%; /* match code size */
+  background: rgb(240, 240, 240);
+  color: rgba(0, 0, 0, 0.55);
+  border: 1px solid rgba(0, 0, 0, 0.1);
+  padding: 0.5em 1em 0.75em 1em;
+  margin-bottom: 24px;
+}
+
+.admonition p {
+  font-size: inherit;
+}
+
+.admonition p.last {
+  margin-bottom: 0;
+}
+
+.admonition p.first.admonition-title {
+  display: inline;
+  background: none;
+  font-weight: bold;
+  color: rgba(0, 0, 0, 0.75);
+}
+
+/* notes */
+.rst-content .note {
+  background: rgb(240, 240, 240);
+}
+
+/* tags */
+.rhel {background: #fee;}
+.portal {background-color: #ded;}
+.satellite {background-color: #dee;}
+.centos {background: #fef;}
+.baremetal {background: #eef;}
+.virtual {background: #efe;}
+.ceph {background: #eff;}
+
+/* admonition selector */
+#admonition_selector {
+  color: white;
+  font-size: 85%;
+  line-height: 1.4;
+  background: #2980b9;
+  border-top: 1px solid rgba(255, 255, 255, 0.4);
+}
+
+.trigger {
+  display: block;
+  font-size: 110%;
+  color: rgba(255, 255, 255, 0.75);
+  line-height: 2.5;
+  position: relative;
+  cursor: pointer;
+  padding: 0 1.618em;
+}
+
+.trigger:after {
+  content: '▾';
+  display: block;
+  font-family: FontAwesome;
+  font-size: 70%;
+  position: absolute;
+  right: 1.618em;
+  top: 6px;
+}
+
+.trigger:hover {
+  color: white;
+}
+
+.content {
+  display: none;
+  border-top: 1px solid rgba(255, 255, 255, 0.1);
+  background: rgba(255, 255, 255, 0.1);
+  padding: 0.5em 1.618em;
+}
+
+.displayed .trigger:after {
+  content: '▴';
+}
+
+#admonition_selector .title {
+  color: rgba(255, 255, 255, 0.45);
+}
+
+#admonition_selector ul {
+  margin-bottom: 0.75em;
+}
+
+#admonition_selector ul li {
+  display: block;
+}
+
+#admonition_selector label {
+  display: inline;
+  color: inherit;
+  text-decoration: underline dotted;
+}

doc/source/_custom/expandable.js

@@ -0,0 +1,32 @@
+$(document).ready(function() {
+
+  // for each trigger
+  $('.trigger').each(function() {
+
+    // check if cookie has value on true
+    if ($.cookie($(this).parent().prop('id')) == "true") {
+      // add displayed class and show the content
+      $(this).parent().addClass("displayed");
+      $(this).next('.content').show();
+
+    } else {
+      // remove displayed class and hide the content
+      $(this).parent().removeClass("displayed");
+      $(this).next('.content').hide();
+    }
+  });
+
+  // if user clicked trigger element
+  $('.trigger').click(function() {
+
+    // toggle parent's class and animate the content
+    $(this).parent().toggleClass('displayed');
+    $(this).next('.content').slideToggle("fast");
+
+    // save the state to cookies
+    var parent_id =
+    $.cookie($(this).parent().prop('id'),
+             $(this).parent().hasClass('displayed'),
+             { path: '/' });
+  });
+});