Update from upstream repo machinekit/machinekit-docs

.gitignore

@@ -0,0 +1,9 @@
+_site/
+test/
+.DS_Store
+*.adoc
+*.*~
+.jekyll-metadata
+docs/man/man1/index.asciidoc
+docs/man/man3/index.asciidoc
+docs/man/man9/index.asciidoc

Guardfile

@@ -0,0 +1,5 @@
+guard 'livereload' do
+  watch(%r{_site/.+})
+end
+
+

Makefile

@@ -0,0 +1,43 @@
+# see http://www.cmcrossroads.com/ask-mr-make/6535-tracing-rule-execution-in-gnu-make
+# to trace make execution of make in more detail:
+#     make VV=1
+ifeq ("$(origin VV)", "command line")
+    OLD_SHELL := $(SHELL)
+    SHELL = $(warning Building $@$(if $<, (from $<))$(if $?, ($? newer)))$(OLD_SHELL)
+endif
+# Delete the default suffix rules
+.SUFFIXES:
+.PHONY: all
+
+TEMPLATE:= $(shell pwd)/scripts/machinekit-docs.mustache
+
+all:	docs/man/man1/index.asciidoc \
+	docs/man/man3/index.asciidoc \
+	docs/man/man9/index.asciidoc \
+	docs/machinetalk/protobuf.asciidoc
+
+# this should be made minimal
+#	scripts/filenums
+
+
+# all asciidoc documents in this repo
+MAN1 := $(filter-out docs/man/man1/index.asciidoc, $(wildcard docs/man/man1/*.asciidoc))
+MAN3 := $(filter-out docs/man/man3/index.asciidoc, $(wildcard docs/man/man3/*.asciidoc))
+MAN9 := $(filter-out docs/man/man9/index.asciidoc, $(wildcard docs/man/man9/*.asciidoc))
+
+docs/man/man1/index.asciidoc: $(MAN1)
+	scripts/index-gen.sh man1 'HAL Utilities and GUIs'
+
+docs/man/man3/index.asciidoc: $(MAN3)
+	scripts/index-gen.sh man3 'RTAPI and HAL Functions'
+
+docs/man/man9/index.asciidoc: $(MAN9)
+	scripts/index-gen.sh man9 'HAL Components'
+
+docs/machinetalk/protobuf.asciidoc: \
+	machinetalk-protobuf/src/machinetalk/protobuf/*.proto \
+	$(TEMPLATE) \
+	machinetalk-protobuf/Makefile \
+	scripts/gen-proto-docs.sh
+	scripts/gen-proto-docs.sh  $(TEMPLATE)
+

README.md

@@ -0,0 +1,11 @@
+Website Build Status [![Website Build Status](https://jenkins.machinekit.io/buildStatus/icon?job=website-production)](https://jenkins.machinekit.io/view/machinekit/job/website-production/)
+
+Website PR Builder Status [![Website PR Build Status](https://jenkins.machinekit.io/buildStatus/icon?job=website-preview)](https://jenkins.machinekit.io/job/website-preview)
+
+Manpage Build Status: [![Manpage Build Status](https://jenkins.machinekit.io/buildStatus/icon?job=machinekit-manpages)](https://jenkins.machinekit.io/job/machinekit-manpages/)
+
+# Machinekit Documentation
+
+This repository contains the source for the Machinekit website and
+documentation which are available at [machinekit.io/docs](http://www.machinekit.io/docs/)
+

_config.yml

@@ -0,0 +1,68 @@
+name: Machinekit
+highlighter: pygments
+relative_permalinks: false
+permalink: /blog/:year/:month/:day/:title/
+markdown: kramdown
+repository: https://github.com/machinekit/machinekit
+
+gems:
+  - jekyll-asciidoc
+  - asciidoctor-diagram
+  - jekyll-sitemap
+  - jekyll-asciinema
+  - jekyll-youtube
+  - jekyll-toc
+  - jekyll-gist
+  - jekyll-seo-tag
+  - jekyll-mermaid
+  - jekyll-plantuml
+
+#url: http://machinekit.io
+baseurl: /
+
+asciidoc: asciidoctor
+asciidoc_ext: asciidoc,ad
+
+asciidoctor:
+  safe: 0
+  attributes:
+    - hardbreaks!
+    - source-highlighter=pygments
+    - pygments-css=pastie
+
+#incremental: yes
+
+defaults:
+  -
+    scope:
+      path: ""
+    values:
+      edit-repo: "https://github.com/machinekit/machinekit-docs/"
+      edit-branch: "master"
+  -
+    scope:
+# applies to all files under:
+      path: "docs"
+    values:
+      layout: "docs"
+      docs-dir: "docs"
+
+
+# stage manpage sources here for comparison
+exclude: [Makefile,
+	 Guardfile,
+	 staging,
+	 scripts,
+	 src,
+	 machinetalk-protobuf,
+	 README.md,
+	 '*/*.1',
+	 '*/*.1.in',
+	 '*/*.3hal',
+	 '*/*.3rtapi',
+	 '*/*.9' ]
+
+# for www.machinekit.io
+google_analytics:  UA-48383649-1
+
+

_config_devel.yml

@@ -0,0 +1,4 @@
+# this will include livereload support in the rendered HTML
+# see _includes/livreload.html
+
+environment: development

_data/community.yml

@@ -0,0 +1,7 @@
+- title: community
+  community:
+    - home
+    - channels
+    - c4
+    - contributing
+    - maintainers

_data/docs.yml

@@ -0,0 +1,26 @@
+- title: For starters
+  docs:
+    - site/about-this-site
+    - index-getting-started
+    - index-user
+    - index-HAL
+    - getting-help
+
+- title: Developing
+  docs:
+    - index-integrator
+    - index-developer
+    - index-documenting
+    - developing/develop-index
+    - developing/qtquickvcp
+
+- title: Manpages
+  docs:
+    - man/man1
+    - man/man3
+    - man/man9
+
+- title: Project Infrastructure
+  docs:
+    - infra/repositories
+

_includes/analytics.html

@@ -0,0 +1,17 @@
+{% if jekyll.environment == "production" %} 
+  {% if site.google_analytics_id %}
+    <!-- Google Analytics (http://google.com/analytics) -->
+    <script>
+      var _gaq = _gaq || [];
+      _gaq.push(['_setAccount', '{{ site.google_analytics_id }}']);
+      _gaq.push(['_setDomainName', '{{ site.url }}']); // Multiple sub-domains
+      _gaq.push(['_setAllowLinker', true]); // Multiple TLDs
+      _gaq.push(['_trackPageview']);
+      (function() {
+        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+      })();
+    </script>
+  {% endif %}
+{% endif %}

_includes/community_contents.html

@@ -0,0 +1,9 @@
+<div class="unit one-fifth hide-on-mobiles">
+  <aside>
+    {% for section in site.data.community %}
+    <h4>{{ section.title }}</h4>
+    {% include community_ul.html items=section.community %}
+    {% endfor %}
+    {% include edit-me.html %}
+  </aside>
+</div>

_includes/community_contents_mobile.html

@@ -0,0 +1,10 @@
+<div class="community-nav-mobile unit whole show-on-mobiles">
+  <select onchange="if (this.value) window.location.href=this.value">
+    <option value="">Navigate community…</option>
+    {% for section in site.data.community %}
+    <optgroup label="{{ section.title }}">
+      {% include community_option.html items=section.community %}
+    </optgroup>
+    {% endfor %}
+  </select>
+</div>

_includes/community_option.html

@@ -0,0 +1,11 @@
+{% assign items = include.items %}
+
+{% for item in items %}
+  {% assign item_url = item | prepend:"/community/" | append:"/" %}
+
+  {% for p in site.pages %}
+    {% if p.url == item_url %}
+      <option value="{{ site.url }}{{ p.url }}">{{ p.title }}</option>
+    {% endif %}
+  {% endfor %}
+{% endfor %}

_includes/community_ul.html

@@ -0,0 +1,21 @@
+{% assign items = include.items %}
+
+<ul>
+{% for item in items %}
+  {% assign item_url = item | prepend:"/community/" | append:"/" %}
+
+  {% if item_url == page.url %}
+    {% assign c = "current" %}
+  {% else %}
+    {% assign c = "" %}
+  {% endif %}
+
+  {% for p in site.pages %}
+    {% if p.url == item_url %}
+      <li class="{{ c }}"><a href="{{ site.url }}{{ p.url }}">
+	  {{ p.title }}</a></li>
+    {% endif %}
+  {% endfor %}
+
+{% endfor %}
+</ul>