summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorelijah <elijah@riseup.net>2016-08-29 23:59:51 -0700
committerelijah <elijah@riseup.net>2016-08-29 23:59:51 -0700
commite4938d4fbe03caa3779be67b70fd346246a7af75 (patch)
tree4dda1c0f52f23a18d4225c03c961980636abaa98 /docs
parent0ee63f658230533a7b5645e104b012c665e1a962 (diff)
added 'docs' folder, for creating portable static mirrors of parts of leap_se
Diffstat (limited to 'docs')
-rw-r--r--docs/README.md15
-rw-r--r--docs/platform/amber/config.rb4
-rw-r--r--docs/platform/amber/layouts/default.html.haml74
-rw-r--r--docs/platform/amber/menu.txt35
l---------docs/platform/pages1
5 files changed, 129 insertions, 0 deletions
diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 0000000..dd8efa4
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,15 @@
+The primary source of platform documentation lives in:
+
+ pages/docs/platform
+
+However, we would like to also include a static render of this in the
+leap_platform source code.
+
+So, this is a separate amber site just for the platform documentation.
+
+To generate portable static pages:
+
+ cd docs/platform
+ amber server
+ cd /tmp
+ wget --mirror --convert-links --adjust-extension --page-requisites http://localhost:8000 \ No newline at end of file
diff --git a/docs/platform/amber/config.rb b/docs/platform/amber/config.rb
new file mode 100644
index 0000000..95df336
--- /dev/null
+++ b/docs/platform/amber/config.rb
@@ -0,0 +1,4 @@
+@title = "LEAP Platform Documentation"
+@default_locale = :en
+@locales = [:en]
+@short_paths = false
diff --git a/docs/platform/amber/layouts/default.html.haml b/docs/platform/amber/layouts/default.html.haml
new file mode 100644
index 0000000..db44f9e
--- /dev/null
+++ b/docs/platform/amber/layouts/default.html.haml
@@ -0,0 +1,74 @@
+!!!
+%html{:lang => @locals[:locale].to_s}
+ %head
+ %title
+ = @page.nav_title + ' - ' + @site.title
+ %meta(name="viewport" content="width=device-width, initial-scale=1.0")
+ %meta(charset="UTF-8")
+ = html_head_base
+ :css
+ body {
+ background: #444;
+ display: flex;
+ flex-direction: row;
+ padding: 10px;
+ margin: 0px;
+ }
+ #sidebar {
+ flex: 0 0 250px;
+ background: white;
+ margin-right: 10px;
+ padding: 20px;
+ }
+ #sidebar ul {
+ list-style-type: none;
+ padding-left: 0px;
+ margin: 0;
+ }
+ #sidebar li { padding: 4px }
+ #sidebar li a { text-decoration: none }
+ #sidebar li.active { background: #444 }
+ #sidebar li.active a { color: white }
+ #sidebar li.level1 { padding-left: 20px }
+ #sidebar li.level2 { padding-left: 40px }
+ #main {
+ flex: 1 1 auto;
+ background: white;
+ padding: 20px;
+ }
+ #title-box {
+ padding-bottom: 20px;
+ border-bottom: 5px solid #eee;
+ }
+ #title-box h1 {
+ margin-top: 0px;
+ }
+ pre {
+ padding: 10px;
+ background: #eef;
+ }
+ code {
+ background: #eef;
+ }
+ table {border-collapse: collapse}
+ table td {
+ border: 1px solid #ccc;
+ padding: 4px;
+ vertical-align: top;
+ }
+
+ %body
+ #sidebar
+ %ul
+ - home = @page.path.empty? ? 'active' : ''
+ %li{:class => home}
+ %a{:href => '/'} Home
+ - navigation_items(@site.menu, 0) do |item|
+ %li{:class => "#{item[:active]} level#{item[:level]}"}
+ %a{:href => item[:href], :class => ''}= item[:label]
+ #main
+ #title-box
+ = yield :title
+ #summary= @page.props.summary
+ #content-box
+ = yield :content
diff --git a/docs/platform/amber/menu.txt b/docs/platform/amber/menu.txt
new file mode 100644
index 0000000..819600a
--- /dev/null
+++ b/docs/platform/amber/menu.txt
@@ -0,0 +1,35 @@
+guide
+ getting-started
+ config
+ nodes
+ keys-and-certificates
+ domains
+ provider-configuration
+ environments
+ virtual-machines
+ miscellaneous
+ commands
+tutorials
+ quick-start
+ single-node-vpn
+ single-node-email
+ vagrant
+services
+ couchdb
+ openvpn
+ monitor
+ mx
+ soledad
+ tor
+ webapp
+upgrading
+ upgrade-0-8
+troubleshooting
+ tests
+ known-issues
+ where-to-look
+details
+ faq
+ development
+ ports
+ under-the-hood
diff --git a/docs/platform/pages b/docs/platform/pages
new file mode 120000
index 0000000..5ecfaa3
--- /dev/null
+++ b/docs/platform/pages
@@ -0,0 +1 @@
+../../pages/docs/platform \ No newline at end of file