[gen] Add community section

Gemfile

@@ -9,4 +9,5 @@ group :jekyll_plugins do
    gem "jekyll-polyglot"
 end
 gem "jekyll-minifier"
+gem "jekyll-paginate-v2"
 # gem "rails"

Gemfile.lock

@@ -38,6 +38,8 @@ GEM
       jekyll (>= 3.5)
       json-minify (~> 0.0.3)
       uglifier (~> 4.1)
+    jekyll-paginate-v2 (3.0.0)
+      jekyll (>= 3.0, < 5.0)
     jekyll-polyglot (1.3.3)
       jekyll (>= 3.0)
     jekyll-sass-converter (2.1.0)
@@ -79,6 +81,7 @@ PLATFORMS
 DEPENDENCIES
   jekyll
   jekyll-minifier
+  jekyll-paginate-v2
   jekyll-polyglot
 
 BUNDLED WITH

_config.yml

@@ -1,4 +1,5 @@
 plugins:
+  - jekyll-paginate-v2
   - jekyll-polyglot
   - jekyll-minifier
 languages:                   ["en", "es", "de", "it", "fr"]
@@ -7,10 +8,38 @@ exclude_from_localization:   ["assets", "images", "css", "README.md", "manifest.
 parallel_localization:       true
 a_rootpage:                  "https://jamulus.io"
 githubrepoeditbase:          "https://github.com/jamulussoftware/jamulussoftware.github.io/edit/changes"
+kbnewpage:                   'https://github.com/jamulussoftware/jamuluswebsite/new/changes/_posts/?value=---%0Alayout%3A%20post%0Atitle%3A%20%22Your%20Title%22%0Alang%3A%20%22en%22%0Aauthor%3A%20%22YourName%22%0Aheading%3A%20%22Heading%22%0A---%0AName%20This%20File%20and%20edit%20the%20parameters%20above%21&message=New%20post'
 exclude:                     ["README.md", "Gemfile.lock", "Gemfile", "CONTRIBUTING.md"]
 jekyll-minifier:
   remove_intertag_spaces:    true
   remove_spaces_inside_tags: true
   remove_multi_spaces:       true
   compress_json:             true
   exclude:                   "sitemap.xml"
+excerpt_separator: <!--more-->
+permalink: /kb/:categories/:year/:month/:day/:title:output_ext
+pagination:
+  enabled: true
+  # Set to 'true' to enable pagination debugging. This can be enabled in the site config or only for individual pagination pages
+  debug: false
+  # The default document collection to paginate if nothing is specified ('posts' is default)
+  collection: 'posts'
+  # How many objects per paginated page, used to be `paginate` (default: 0, means all)
+  per_page: 4
+  # The permalink structure for the paginated pages (this can be any level deep)
+  permalink: '/:num/index.html'
+
+  title: ':title / :num'
+  # Limit how many pagenated pages to create (default: 0, means all)
+  limit: 0
+
+  # Optional, defines the field that the posts should be sorted on (omit to default to 'date')
+  sort_field: 'date'
+
+  # Optional, sorts the posts in reverse order (omit to default decending or sort_reverse: true)
+  sort_reverse: true
+ # Optional,omit or set both before and after to zero to disable.
+ # Controls how the pagination trail for the paginated pages look like.
+  trail:
+    before: 2
+    after: 3

_data/en/authors.yml

@@ -0,0 +1,10 @@
+corrados:
+    name: Volker Fischer
+    url:  https://github.com/corrados
+niebert:
+    name: Engelbert Niehaus
+    url:  https://github.com/niebert
+ann0see:
+    url:  https://github.com/ann0see
+gilgongo:
+    url:  https://github.com/gilgongo

_data/en/general.yml

@@ -1,5 +1,5 @@
 footer:
-  copyright: Software by <a href="https://github.com/corrados" target="_blank" rel="noreferrer">Volker Fischer</a> and <a href="https://github.com/corrados/jamulus/graphs/contributors" target="_blank" rel="noreferrer">contributors</a>
+  copyright:         Software by <a href="https://github.com/corrados" target="_blank" rel="noreferrer">Volker Fischer</a> and <a href="https://github.com/corrados/jamulus/graphs/contributors" target="_blank" rel="noreferrer">contributors</a>
   alt:
     github:          "Jamulus GitHub Repo"
     facebook:        "Jamulus Facebook Group"
@@ -10,4 +10,15 @@ nav:
   btnOpenNavigation: "Open navigation"
   altJamulusIcon:    "Jamulus Icon. Links to Wiki homepage"
 wiki:
-  titleAdd: "– Jamulus Wiki"
+  titleAdd:          "– Jamulus Wiki"
+kb:
+  titleAdd:          "– Jamulus Knowledge Base"
+  by:                "by"
+  kbintro:           "<strong>Community knowledge base</strong><br /> Feel free to add your own article!"
+  mainpage:          "KB overview"
+  newpage:           "Add a new page via GitHub"
+  readmore:          "Read more..."
+  navpages:          "More pages"
+  discuss:
+    title:           "Comments"
+    linktitle:       "Discuss this content"

_data/en/navigation.yml

@@ -24,6 +24,9 @@ nav:
       url:               /wiki/Command-Line-Options
     - page:              Tips & Tricks
       url:               /wiki/Tips-Tricks-More
+    - page:              Community Knowledge Base
+      url:               /kb/index.html
+      selectOnLayout:    "post"
     - page:              Demos
       url:               /wiki/Demos
     - page:              Privacy Statement

_drafts/Jamulus-With-Zoom.md

@@ -0,0 +1,14 @@
+---
+layout: post
+title: "Jamulus with Zoom"
+heading: "Using Jamulus with Zoom"
+lang: "en"
+---
+
+Jamulus doesn't support video streaming yet. This guide will show you how to get video using a video conferencing tool like Zoom.
+<!--more-->
+Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+
+Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+
+Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

_includes/general/nav.html

@@ -6,19 +6,19 @@
       {% for item in site.data.navigation.nav %}
       {% if item.url %}
       <li>
-        <h3><a href="{{ item.url | relative_url }}" class="{% if subentry.url == page.url %}selected{% endif %}">{{ item.title }}</a></h3>
+        <h3><a href="{{ item.url | relative_url }}" class="{% if subentry.url == page.url or subentry.selectOnLayout == page.layout %}selected{% endif %}">{{ item.title }}</a></h3>
       {% else %}
       <li>
         <h3>{{ item.title }}</h3>
       {% endif %}
       {% if item.subfolderitems[0] %}
         <ul>
           {% for entry in item.subfolderitems %}
-          <li><a href="{{ entry.url }}" class="{% if entry.url == page.url %}selected{% endif %}">{{ entry.page }}</a>
+          <li><a href="{{ entry.url }}" class="{% if entry.url == page.url or entry.selectOnLayout == page.layout %}selected{% endif %}">{{ entry.page }}</a>
             {% if entry.subsubfolderitems[0] %}
             <ul>
               {% for subentry in entry.subsubfolderitems %}
-              <li><a href="{{ subentry.url }}" class="{% if subentry.url == page.url %}selected{% endif %}">{{ subentry.page }}</a></li>
+              <li><a href="{{ subentry.url }}" class="{% if subentry.url == page.url or subentry.selectOnLayout == page.layout %}selected{% endif %}">{{ subentry.page }}</a></li>
               {% endfor %}
             </ul>
             {% endif %}

_includes/headtags.html

@@ -13,6 +13,7 @@
 <noscript>
   <link rel="stylesheet" href="/assets/css/noscript.css" />
 </noscript>
+<meta name="description" content="{{ page.metadescription }}">
 <link rel="apple-touch-icon" sizes="57x57" href="/apple-icon-57x57.png" />
 <link rel="apple-touch-icon" sizes="60x60" href="/apple-icon-60x60.png" />
 <link rel="apple-touch-icon" sizes="72x72" href="/apple-icon-72x72.png" />

_layouts/kblist.html

@@ -0,0 +1,76 @@
+---
+pagination:
+  enabled: true
+---
+<!DOCTYPE html>
+<!--[if IE 9]> <html class="ie9"> <![endif]-->
+<html lang="{{ site.active_lang }}">
+
+<head>
+  <title>{{ page.title }} {{ site.data.general.kb.titleAdd }}</title>
+  {% include headtags.html %}
+  <link rel="stylesheet" href="/assets/css/kb.css">
+</head>
+
+<body class="kb kblist">
+  <header class="fx-row fx-row-between-xs fx-text-center">
+    <div class="fx-col fx-text-center"><a href="/{% if site.active_lang != site.default_lang %}{{ site.active_lang }}/{% endif %}">
+        <img alt="{{ site.data.general.nav.altJamulusIcon }}" width="40" height="40" src="{{ 'assets/img/jamulus-icon-2020.svg'| relative_url }}" /></a>
+    </div>
+    <div class="fx-col-center-xs fx-txt-right hide-on-dt">
+      <a href="#mnv" onclick="showNav();return false;">{% include general/navbtn.html %}</a>
+    </div>
+    <div class="fx-col-100-xs fx-txt-center">
+      <h1>{{ page.title }}</h1>
+    </div>
+  </header>
+  <div class="fx-row fx-row-center-xs">
+    {% include general/nav.html %}
+    <div id="maincontainer" class="fx-col-100-xs fx-col-50-m">
+      <noscript class="red"><strong>{{ site.data.general.tNoJSEnabled }}</strong></noscript>
+      <main lang="{{ page.lang }}">
+        {{ content }}
+        {% for post in paginator.posts %}
+          <article>
+            <h2><a href="{{ post.url }}">{{ post.title }}</a></h2>
+            <div>{{ post.date | date_to_string }}
+              {% if post.author %}
+                {{ site.data.general.kb.by }}
+                {% if site.data.authors[post.author].url %}<a href="{{ site.data.authors[post.author].url }}" rel="nofollow">{% endif %}
+                {% if site.data.authors[post.author].name %}
+                  {{ site.data.authors[post.author].name }}
+                {% else %}
+                  {{ post.author }}
+                {% endif %}
+                {% if site.data.authors[post.author].url %}</a>{% endif %}
+              {% endif %}
+            </div>
+            {{ post.excerpt }}
+            <a href="{{ post.url }}">{{ site.data.general.kb.readmore }}</a>
+          </article>
+          <hr />
+        {% endfor %}
+        {% if paginator.page_trail %}
+          <ul id="paginator">
+          {% for trail in paginator.page_trail %}
+            <li {% if page.url == trail.path %}class="selected"{% endif %}>
+                <a href="{{ trail.path | prepend: site.baseurl }}" title="{{ trail.title }}">{{ trail.num }}</a>
+            </li>
+          {% endfor %}
+          </ul>
+        {% endif %}
+      </main>
+    </div>
+    <aside class="fx-col-begin-xs fx-col-100-xs fx-col-10-m">
+      <p id="kbintro">
+        {{ site.data.general.kb.kbintro }}
+      </p>
+      <ul id="kbside">
+        <li><a href="{{ site.kbnewpage }}">{{ site.data.general.kb.newpage }}</a></li>
+      </ul>
+    </aside>
+  </div>
+  {% include footer.html %}
+</body>
+
+</html>

_layouts/mainhomepage.html

@@ -30,7 +30,6 @@
       }
     }
   </script>
-  <meta name="description" content="{{ page.metadescription }}">
 </head>
 
 <body class="mainsite">

_layouts/post.html

@@ -0,0 +1,104 @@
+---
+pagination:
+  enabled: true
+---
+<!DOCTYPE html>
+<!--[if IE 9]> <html class="ie9"> <![endif]-->
+<html lang="{{ site.active_lang }}">
+
+<head>
+  <title>{{ page.title }} {{ site.data.general.kb.titleAdd }}</title>
+  {% include headtags.html %}
+  <link rel="stylesheet" href="/assets/css/kb.css">
+  <script type="application/ld+json">
+  {
+    "@context":"https://schema.org",
+    "@type":"BlogPosting",
+    "headline": "{{ page.heading }}",
+    {% if page.discussionurl %}
+    "discussionUrl": "{{ page.discussionurl }}",
+    {% endif %}
+    {% if page.author %}
+    "publisher": {
+      "@type": "Person",
+      "name": "{% if site.data.authors[page.author].name %}{{ site.data.authors[page.author].name }}{% else %}{{ page.author }}{% endif %}",
+      {% if site.data.authors[page.author].url %}"url": "{{ site.data.authors[page.author].url }}"{% endif %}
+    },
+    "author": {
+      "@type": "Person",
+      "name": "{% if site.data.authors[page.author].name %}{{ site.data.authors[page.author].name }}{% else %}{{ page.author }}{% endif %}",
+      {% if site.data.authors[page.author].url %}"url": "{{ site.data.authors[page.author].url }}"{% endif %}
+    },
+    {% endif %}
+    "datePublished": "{{ page.date | date_to_xmlschema }}"
+  }
+  </script>
+</head>
+
+<body class="kb kbsite">
+  <header class="fx-row fx-row-between-xs fx-text-center">
+    <div class="fx-col fx-text-center"><a href="/{% if site.active_lang != site.default_lang %}{{ site.active_lang }}/{% endif %}">
+        <img alt="{{ site.data.general.nav.altJamulusIcon }}" width="40" height="40" src="{{ 'assets/img/jamulus-icon-2020.svg'| relative_url }}" /></a>
+    </div>
+    <div class="fx-col-center-xs fx-txt-right hide-on-dt">
+      <a href="#mnv" onclick="showNav();return false;">{% include general/navbtn.html %}</a>
+    </div>
+    <div class="fx-col-100-xs fx-txt-center">
+      <h1>{{ page.heading }}</h1>
+      {% if page.author %}
+        {{ site.data.general.kb.by }}
+        {% if site.data.authors[page.author].url %}<a href="{{ site.data.authors[page.author].url }}" rel="nofollow">{% endif %}
+        {% if site.data.authors[page.author].name %}
+          {{ site.data.authors[page.author].name }}
+        {% else %}
+          {{ page.author }}
+        {% endif %}
+        {% if site.data.authors[page.author].url %}</a>{% endif %}
+      {% endif %}
+      {% if page.date %}
+       (<time datetime="{{ page.date | date: '%Y-%m-%d' }}">{{ page.date | date_to_string }}</time>)
+      {% endif %}
+    </div>
+  </header>
+  <div class="fx-row fx-row-center-xs">
+    {% include general/nav.html %}
+    <div id="maincontainer" class="fx-col-100-xs fx-col-50-m">
+      <noscript class="red"><strong>{{ site.data.general.tNoJSEnabled }}</strong></noscript>
+      <main lang="{{ page.lang }}">
+        {{ content }}
+      </main>
+      <div class="fx-row-100-xs">
+        {% if page.discussionurl %}
+          <h2>{{ site.data.general.kb.discuss.title }}</h2>
+          <a href="{{ page.discussionurl }}">{{ site.data.general.kb.discuss.linktitle }}</a>
+        {% endif %}
+        <h2>{{ site.data.general.kb.navpages }}</h2>
+      </div>
+      <div class="fx-row fx-row-between-xs">
+        <div class="fx-col fx-txt-left">
+        {% if page.previous.url %}
+        <a href="{{ page.previous.url }}">&laquo; {{ page.previous.title }}</a>
+        {% endif %}
+        </div>
+        <div class="fx-col fx-txt-right">
+          {% if page.next.url %}
+          <a href="{{ page.next.url }}">{{ page.next.title }} &raquo;</a>
+          {% endif %}
+        </div>
+      </div>
+    </div>
+    <aside class="fx-col-begin-xs fx-col-100-xs fx-col-10-m">
+      <p id="kbintro">
+        {{ site.data.general.kb.kbintro }}
+      </p>
+      <ul id="kbside">
+        <li><a href="/kb">{{ site.data.general.kb.mainpage }}</a></li>
+        <li><a href="{{ site.kbnewpage }}">{{ site.data.general.kb.newpage }}</a>
+        </li>
+      </ul>
+    </aside>
+  </div>
+  {% include footer.html %}
+</body>
+
+</html>

_layouts/wiki.html

@@ -6,7 +6,6 @@
   <title>{{ page.title }} {{ site.data.general.wiki.titleAdd }}</title>
   {% include headtags.html %}
   <link rel="stylesheet" href="/assets/css/wiki.css">
-  <meta name="description" content="{{ page.metadescription }}">
 </head>
 
 <body class="wikisite">

_posts/2020-03-28-Example-Setup-Hardware.md

@@ -0,0 +1,36 @@
+---
+layout: post
+title: "Example setup audio hardware"
+heading: "Example setup UCA202 Windows"
+author: "corrados"
+lang: "en"
+---
+
+This is an example Windows client installation with a [Behringer U-CONTROL UCA202](https://www.amazon.com/Behringer-U-Phono-UFO202-Audiophile-Interface/dp/B002GHBYZ0){: target="_blank" rel="noopener noreferrer"} audio device.
+The following instructions might be similar with other audio devices.
+<!--more-->
+
+_**The exact method of connecting your instrument will of course vary depending on your hardware.**_
+
+## Windows: Audio interface connection - ASIO4All
+
+### 1. Plug the interface into a USB port on your computer
+
+In the future, always use the same USB port for the audio device.
+
+**Windows users**: If not already done: download and install the [free ASIO sound driver (ASIO4All)](https://www.asio4all.org){: target="_blank" rel="noopener noreferrer"}. Some people have also reported success using [this ASIO native driver](http://www.behringerdownload.de/_software/BEHRINGER_2902_X64_2.8.40.zip){: target="_blank" rel="noopener noreferrer"} __currently not available__, although it's not listed on Behringer's product pages as of April 2020.
+
+
+### 2. Start Jamulus
+
+Configure Jamulus to use the correct sound setup (see [this excellent guide](https://www.facebook.com/notes/jamulus-online-musicianssingers-jamming/idiots-guide-to-jamulus-app/510044532903831/) by [Simon Tomlinson](https://www.facebook.com/simon.james.tomlinson?eid=ARBQoY3KcZAtS3pGdLJuqvQTeRSOo4gHdQZT7nNzOt1oPMGgZ4_3GERe-rOyH5PxsSHVYYXjWwcqd71a) on Facebook).
+
+Make sure you have switched off the monitor button on your Behringer U-CONTROL UCA202 (otherwise you will hear both the original sound you are sending to the Jamulus server as well as the returning sound, and may get feedback).
+
+### 3. Plug in your instrument and headphones
+
+Connect your instrument to the input plugs of the Behringer U-CONTROL UCA202. Plug in your headphones into the Behringer U-CONTROL UCA202.
+
+### 4. Connect to a Jamulus server.
+
+You're done! Have fun!