first try at jekyll site - copied from faq.arc42.org site.

NO REAL CONTENT so far!!

404.html

@@ -0,0 +1,16 @@
+---
+layout: page
+title: 404 Not Found
+permalink: 404.html
+hide: true
+share: false
+---
+
+<h1>Sorry...</h1>
+
+the page you requested wasn't found.
+
+Please let us know what you did, via
+<a href="xmxaxixlxtxo:[email protected]" onmouseover="this.href=this.href.replace(/x/g,'');">email (protected)</a> or in the comment below:
+
+{% include disqus.html %}

Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+gem 'github-pages'
+gem 'jemoji'

_config.yml

@@ -0,0 +1,117 @@
+#
+# URL settings
+#
+# these need to be adjusted depending on target platform,
+# local Jekyll tests need different settings than github-pages :-(
+
+# local development
+# -----------------------------------------------------
+#url: http://localhost:4000
+baseurl:
+
+# temporary deployment on arc42.github.io/faq
+# -----------------------------------------------------
+#url: http://arc42.github.io
+#baseurl: "/faq"
+
+# "real" deployment with github-pages but custom domain
+# -----------------------------------------------------
+url: http://docs.arc42.org
+#baseurl:
+#######################################################
+
+## imageurl set to url + baseurl, easier than the complex
+## {{ url }}{{ url }}{{ '<filename>' | prepend: site.baseurl }}
+#imageurl: http://localhost:4000
+#imageurl: http://arc42.github.io/faq
+imageurl: http://docs.arc42.org
+
+
+
+#
+# basic settings
+#
+title: arc42 Documentation
+description: how to use the arc42 template.
+avatar: /assets/img/arc42logosquare.png
+favicon: /assets/img/arc42logosquare.png
+language: en
+
+#
+# want (disqus) comments?
+#
+disqus: true
+
+#
+# Icons
+#
+icons:
+  rss: false
+  email: false
+  github: arc42
+  twitter: gernotstarke
+  google_plus: 105917203908419102125
+  stack_overflow: arc42
+
+#
+# Prettify url.
+#
+permalink: pretty
+
+
+#
+# Localizations.
+#
+str_next: Next
+str_prev: Prev
+str_read_more: Read more...
+str_search: Search
+str_recent_posts: Recent answers
+str_show_all_posts: Show all questions/answers
+
+#
+# Recent posts.
+#
+recent_posts_num: 10
+
+#
+# Pagination.
+#
+paginate: 10
+paginate_path: page/:num
+
+
+#
+# Gems.
+#
+gems:
+  - jekyll-paginate
+  - jemoji
+
+#
+# Styles: see "_sass/base/_variables.scss"
+#
+
+#
+# !! Danger zone !!
+#
+
+include: ["_pages"]
+
+markdown: kramdown
+kramdown:
+  input: GFM
+  syntax_highlighter: rouge
+
+excerpt_separator: <!--more-->
+
+sass:
+  sass_dir: _sass
+  style: :compressed # or :expanded
+
+exclude:
+  - Gemfile
+  - Gemfile.lock
+  - LICENSE
+  - README.md
+  - vendor

_includes/article-footer.html

@@ -0,0 +1,4 @@
+<footer>
+    {% if site.share_buttons and include.share != false %}
+    {% endif %}
+</footer>

_includes/article-header.html

@@ -0,0 +1,49 @@
+{% assign page = include.page %}
+
+<header>
+    <div class="panel">
+        <h1>
+            {% if include.link %}
+            <a class="post-link" href="{{ page.url | prepend: site.baseurl }}">{{ page.title }}</a>
+            {% else %}
+            {{ page.title }}
+            {% endif %}
+        </h1>
+
+        <ul class="tags">
+            {% assign tags_num = (page.tags | size) %}
+            {% if tags_num > 0 %}
+            <li><i class="fa fa-tags"></i></li>
+            {% endif %}
+            {% for tag in page.tags %}
+            <li>
+                <a class="tag" href="{{ '/search/?t=' | append: tag | prepend: site.baseurl }}">#{{ tag }}</a>
+            </li>
+            {% endfor %}
+        </ul>
+
+        <div class="clearfix">
+            <ul class="meta">
+
+
+                {% if page.author %}
+                <li>
+                    <a href="{{ '/search/?a=' | append: page.author | prepend: site.baseurl }}">
+                        <i class="fa fa-user"></i>
+                        {{ page.author }}
+                    </a>
+                </li>
+                {% if page.icons %}
+                <li>
+                    <ul class="icons">
+                        {% include icons.html icons=page.icons %}
+                    </ul>
+                </li>
+                {% endif %}
+                {% endif %}
+            </ul>
+        </div>
+    </div>
+
+
+</header>

_includes/category_C-9_preface.md

@@ -0,0 +1,5 @@
+
+In software engineering literature you find both
+**architecture decision** and **architectural decision**.
+
+Both mean the same thing...

_includes/category_E_preface.md

@@ -0,0 +1,7 @@
+
+### You're working agile...
+
+> The Agile Manifesto says: "Working software over comprehensive documentation".
+It does **not** say "no documentation".  
+
+Even in lean, agile and iterative development approaches, an appropriate amount of documentation will help numerous stakeholders doing a better job.

_includes/category_F_preface.md

@@ -0,0 +1,9 @@
+
+> We do not endorse or advertise specific tools here.
+> We have **no** relations whatsoever to a tool vendor.
+>
+> All tool and product names mentioned here are trademarked and/or copyrighted by the corresponding tool creators or vendors.
+
+As authors, we reserve the right to explain our personal experience and opinion.
+You should not base your tool selection solely on the information given here! There might be awesome tools
+available which we failed to mention...

_includes/contact-include.md

@@ -0,0 +1,9 @@
+
+## Your question has not been answered?
+
+Please let us know - we're listening:
+
+* via [email](mailto:[email protected]) to [email protected] or
+* on our [github issue tracker](https://github.com/arc42/arc42-template/issues) at https://github.com/arc42/arc42-template/issues.
+* or on [Twitter (@arc42Tipps)](https://twitter.com/arc42Tipps), or
+* on [Stackoverflow](http://stackoverflow.com/questions/tagged/arc42)

_includes/disqus.html

@@ -0,0 +1,14 @@
+<div id="disqus_thread"></div>
+<script>
+var disqus_config=function(){
+  this.page.url = '{{site.url}}{{page.url }}';
+  this.page.identifier = '{{ page.permalink }}';
+  this.page.title = '{{ page.title }}';};
+(function() { // DON'T EDIT BELOW THIS LINE
+var d = document, s = d.createElement('script');
+s.src = '//faq-arc42-org.disqus.com/embed.js';
+s.setAttribute('data-timestamp', +new Date());
+(d.head || d.body).appendChild(s);
+})();
+</script>
+<noscript>Please enable JavaScript to view the <a href="https://disqus.com/?ref_noscript">comments by Disqus.</a></noscript>

_includes/icons.html

@@ -0,0 +1,45 @@
+{% assign icons = include.icons %}
+
+
+{% if icons.email %}
+<li>
+    <a href="mailto:{{ icons.email }}">
+        <i class="fa fa-fw fa-envelope"></i>
+    </a>
+</li>
+{% endif %}
+
+{% if icons.github %}
+<li>
+    <a href="https://github.com/{{ icons.github }}">
+        <i class="fa fa-fw fa-github"></i>
+    </a>
+</li>
+{% endif %}
+
+
+{% if icons.twitter %}
+<li>
+    <a href="https://twitter.com/{{ icons.twitter }}">
+        <i class="fa fa-fw fa-twitter"></i>
+    </a>
+</li>
+{% endif %}
+
+
+{% if icons.stack_overflow %}
+<li>
+    <a href="https://stackoverflow.com/tags/{{ icons.stack_overflow }}">
+        <i class="fa fa-fw fa-stack-overflow"></i>
+    </a>
+</li>
+{% endif %}
+
+
+{% if icons.google_plus %}
+<li>
+    <a href="https://plus.google.com/{{ icons.google_plus }}">
+        <i class="fa fa-fw fa-google-plus"></i>
+    </a>
+</li>
+{% endif %}

_includes/muut.html

@@ -0,0 +1,2 @@
+<a href="https://muut.com/i/arc42/comments" class="muut" type="dynamic">Comments</a>
+<script src="//cdn.muut.com/1/moot.min.js"></script>

_includes/page-url-resolver.html

@@ -0,0 +1,7 @@
+{% assign page = include.page %}
+
+{% if page.canonical %}
+{% assign url = page.canonical | prepend: site.baseurl | prepend: site.url %}
+{% else %}
+{% assign url = page.url | replace: 'index.html', '' | prepend: site.baseurl | prepend: site.url %}
+{% endif %}

_includes/paginator.html

@@ -0,0 +1,29 @@
+{% if paginator.total_pages > 1 %}
+<div class="pagination">
+
+    {% if paginator.previous_page %}
+    <a class="btn" href="{{ paginator.previous_page_path | prepend: site.baseurl }}">
+        <i class="fa fa-chevron-left"></i>
+        {{ site.str_prev }}
+    </a>
+    {% else %}
+    <span class="btn disabled">
+        <i class="fa fa-chevron-left"></i>
+        {{ site.str_prev }}
+    </span>
+    {% endif %}
+
+    {% if paginator.next_page %}
+    <a class="btn" href="{{ paginator.next_page_path | prepend: site.baseurl }}">
+        {{ site.str_next }}
+        <i class="fa fa-chevron-right"></i>
+    </a>
+    {% else %}
+    <span class="btn disabled">
+        {{ site.str_next }}
+        <i class="fa fa-chevron-right"></i>
+    </span>
+    {% endif %}
+
+</div>
+{% endif %}

_includes/share-buttons.html

@@ -0,0 +1,13 @@
+{% include page-url-resolver.html page=include.page %}
+{% assign title = include.page.title | append: ' | ' | append: site.title %}
+<div class="clearfix">
+    <div style="float: right !important;">
+        {% if site.share_buttons.twitter %}
+        <div style="margin-right: 5px !important; float: left !important;">
+            <a href="https://twitter.com/share" class="twitter-share-button"{count} data-url="{{ url }}" data-text="{{ title }}">Tweet</a>
+            <script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script>
+        </div>
+        {% endif %}
+
+    </div>
+</div>