CoFH · sustained · Jul 3, 2019 · Jul 3, 2019 · Jul 3, 2019 · Jul 4, 2019
diff --git a/.gitignore b/.gitignore
@@ -1,4 +1,6 @@
 _site/
+vendor/
 Thumbs.db
 .jekyll-metadata
 Gemfile.lock
+.bundle/config
diff --git a/_config.yml b/_config.yml
@@ -17,19 +17,25 @@ defaults:
     values:
       layout: docs
 
+collections:
+  - world_examples
+
 exclude:
   - README.md
   - /*.pdn
   - /*.xcf
   - /Thumbs.db
   - /.unused
+  - vendor
 
 plugins:
   - jekyll-paginate
   - jekyll-sitemap
   - jekyll-feed
   - jekyll-redirect-from
 
+highlighter: rouge
+
 permalink: '/posts/:year/:month/:day/:title/'
 paginate: 5
 paginate_path: "/posts/page-:num/"

diff --git a/_data/docnav.yml b/_data/docnav.yml
@@ -137,6 +137,8 @@ cofh-world:
           items:
             - title: Commands
               url: commands/
+            - title: Examples
+              url: examples/
 
 thermal-foundation:
   title: Thermal Foundation 2

diff --git a/_includes/example.md b/_includes/example.md
@@ -0,0 +1,60 @@
+{% if include.primary %}
+  {% assign classes="uk-panel uk-panel-box-primary uk-panel-box" %}
+{% else %}
+  {% assign classes="uk-panel uk-panel-box" %}
+{% endif %}
+
+### {{ include.title }}
+
+<div class="uk-grid">
+  <div class="uk-width-1">
+    <div class="{{ classes }}">
+      {{ include.content | markdownify }}
+
+      {% if include.link.code.embed %}
+        <script src="{{ include.link.code.embed }}"></script>
+      {% endif %}
+
+      {% if include.images.size == 0 %}
+        {% include notice.html notice="There are no images for this example!" %}
+      {% endif %}
+
+      <div class="uk-grid uk-margin-top">
+      {% for image in include.images %}
+        <div class="uk-width-medium-1-3 uk-margin-bottom">
+          <a
+            href="/assets/images/examples/{{ image.href }}"
+            data-uk-lightbox="{group: '{{ include.title | slugify }}'}"
+            title="{{ image.title }}">
+            <img class="uk-thumbnail" src="/assets/images/examples/{{ image.href }}">
+          </a>
+        </div>
+      {% endfor %}
+      </div>
+
+      <div class="uk-flex uk-flex-right">
+        {% if include.showDocs %}
+        <a
+          class="uk-button uk-button-primary uk-button-small uk-border-rounded uk-margin-left"
+          href="{{ include.link.docs }}">
+          View documentation
+        </a>
+        {% endif %}
+
+        <!-- <a
+          class="cofh-js-required uk-button uk-button-success uk-button-small uk-border-rounded uk-margin-right"
+          href="#">
+          Show/hide code
+        </a> -->
+
+        {% if include.link.code.download %}
+        <a
+          class="uk-button uk-button-success uk-button-small uk-border-rounded uk-margin-left"
+          href="{{ include.link.code.download }}">
+          Download code
+        </a>
+        {% endif %}
+      </div>
+    </div>
+  </div>
+</div>
diff --git a/_includes/examples.html b/_includes/examples.html
@@ -0,0 +1,38 @@
+
+
+{% if include.group %}
+
+  {% assign examples = site.world_examples
+    | where: "group", include.group
+  %}
+
+{% else if include.type %}
+
+  {% assign examples = site.world_examples
+    | where: "type", include.type
+  %}
+
+{% endif %}
+
+{% assign examples = examples
+  | where: "primary", include.primary
+%}
+
+{% if examples.size == 0 %}
+
+  {% include notice.html notice="There are currently no examples!" %}
+
+{% endif %}
+
+{% for example in examples %}
+
+  {% include example.md
+    type=example.type
+    link=example.link
+    title=example.title
+    images=example.images
+    primary=example.primary
+    showDocs=include.showDocs
+    content=example.content %}
+
+{% endfor %}
diff --git a/_includes/notice.html b/_includes/notice.html
@@ -0,0 +1,3 @@
+<div class="uk-alert uk-margin-bottom">
+  <p><i class="uk-icon-info-circle"></i> {{ include.notice }}</p>
+</div>
diff --git a/_layouts/default.html b/_layouts/default.html
@@ -33,17 +33,26 @@
         <link rel="stylesheet" href="/assets/css/uikit/components/progress.min.css" />
         <link rel="stylesheet" href="/assets/css/uikit/components/sticky.min.css" />
         <link rel="stylesheet" href="/assets/css/uikit/components/tooltip.min.css" />
+        <link rel="stylesheet" href="/assets/css/highlight/vs.css" />
         <link rel="stylesheet" href="/assets/css/cofh.css{{cache_buster}}" />
 
+        {% for style in layout.styles %}
+        <link rel="stylesheet" href="{{ style }}" />
+        {% endfor %}
+
         <script src="/assets/js/jquery.min.js"></script>
         <script src="/assets/js/uikit/uikit.min.js"></script>
         <script src="/assets/js/uikit/components/autocomplete.min.js"></script>
         <script src="/assets/js/uikit/components/sticky.min.js"></script>
         <script src="/assets/js/uikit/components/tooltip.min.js"></script>
         <script src="/assets/js/cofh.js{{cache_buster}}"></script>
+
+        {% for script in layout.scripts %}
+        <script src="{{ script }}"></script>
+        {% endfor %}
     </head>
 
-    <body>
+    <body class="cofh-no-js">
         {% if page.show_banner %}
         <div class="cofh-banner uk-hidden-small">
             <div class="uk-container uk-container-center">

diff --git a/_layouts/docs.html b/_layouts/docs.html
@@ -1,5 +1,12 @@
 ---
 layout: default
+styles:
+    - /assets/css/highlight/vs.css
+    - /assets/css/uikit/components/slidenav.min.css
+    - /assets/css/uikit/components/slider.min.css
+scripts:
+    - /assets/js/uikit/components/lightbox.min.js
+    - /assets/js/uikit/components/slider.min.js
 ---
 
 <div id="cofh-docs-content" class="uk-width-1-1 uk-width-medium-3-4 uk-container-center">

diff --git a/_world_examples/README.md b/_world_examples/README.md
@@ -0,0 +1,34 @@
+---
+link:
+  # An absolute internal link to the corresponding documentation page.
+  docs: /foo/bar/baz/
+  # An absolute (internal or external) link to the example JSON file.
+  file: https://gist.github/user/f83og0247gh078h0327hgs30972th087
+# Can be either distribution or feature.
+type: feature
+# The group is important since we can't group things by directory/Jekyll doesn't
+# support "sub-collections". The group allows us to use the groupBy Liquid filter
+# on the examples collection. TL;DR: EVERY example for each INDIVIDUAL 
+# distribution and feature type all belong to the same group.
+group: my-group
+# Self-explanatory.
+title: My lovely title.
+# Can be either true or false. If true, this is regarded as the primary example 
+# which for now just means that it shows up on the big examples page. Otherwise
+# it will show up on the actual documentation page for the feature/distribution type.
+primary: true | false
+# Self-explanatory. Note that for now the images must be in assetse/examples/ and
+# external images are not supported.
+images:
+  -
+    href: example1.png
+    title: I am the first example.
+  -
+    href: example2.png
+    title: I am the second title.
+  -
+    href: example3.png
+    title: I am the third title.
+---
+
+The description goes here. You can use arbitrary markdown, should you desire.
diff --git a/_world_examples/common-formats/block-id/block-id.md b/_world_examples/common-formats/block-id/block-id.md
@@ -0,0 +1,14 @@
+---
+link:
+  docs: docs/cofh-world/world-generator-configuration/common-formats/block-id/
+  code:
+    embed: 
+    download: 
+type: common-format
+group: block-id
+title: Block ID
+primary: true
+images: []
+---
+
+This is an example for the Block ID common format.
diff --git a/_world_examples/common-formats/number-provider/number-provider.md b/_world_examples/common-formats/number-provider/number-provider.md
@@ -0,0 +1,14 @@
+---
+link:
+  docs: docs/cofh-world/world-generator-configuration/common-formats/number-provider/
+  code:
+    embed: 
+    download: 
+type: common-format
+group: number-provider
+title: Number Provider
+primary: true
+images: []
+---
+
+This is an example for the Number Provider common format.
diff --git a/_world_examples/common-formats/weighted-string/weighted-string.md b/_world_examples/common-formats/weighted-string/weighted-string.md
@@ -0,0 +1,17 @@
+---
+link:
+  docs: docs/cofh-world/world-generator-configuration/common-formats/weighted-string
+type: common-format
+group: weighted-string
+title: Weighted String
+primary: true
+images: []
+---
+
+This is an example for the Weighted String common format.
+
+```json
+{
+  "enabled": true
+}
+```
diff --git a/_world_examples/distribution-types/cave/cave.md b/_world_examples/distribution-types/cave/cave.md
@@ -0,0 +1,14 @@
+---
+link:
+  docs: /docs/cofh-world/world-generator-configuration/distribution-types/cave/
+  code:
+    embed: https://gist.github.com/sustained/fd95551c9e89d06c3d7678ad5240a98f.js
+    download: https://gist.github.com/sustained/fd95551c9e89d06c3d7678ad5240a98f/archive/f18a680038d5d89cbbe3bd048fd7cea095912af8.zip
+type: distribution
+group: cave
+title: Cave
+primary: true
+images: []
+---
+
+This is an example of distributing in caves.
diff --git a/_world_examples/distribution-types/custom/custom.md b/_world_examples/distribution-types/custom/custom.md
@@ -0,0 +1,14 @@
+---
+link:
+  docs: /docs/cofh-world/world-generator-configuration/distribution-types/custom/
+  code:
+    embed: https://gist.github.com/sustained/20c67f174a3bd1902f9f13d40cc93098.js
+    download: https://gist.github.com/sustained/20c67f174a3bd1902f9f13d40cc93098/archive/7bfbc131a87411c3ff81c91ccb9a5ef702526d0e.zip
+type: distribution
+group: custom
+title: Custom
+primary: true
+images: []
+---
+
+This is an example of distributing in a custom manner.
diff --git a/_world_examples/distribution-types/fractal/fractal.md b/_world_examples/distribution-types/fractal/fractal.md
@@ -0,0 +1,13 @@
+---
+link:
+  docs: /docs/cofh-world/world-generator-configuration/distribution-types/fractal/
+  code:
+    embed: https://gist.github.com/sustained/e8d231aca94d14a68892eddfb5d94d7e.js
+    download: https://gist.github.com/sustained/e8d231aca94d14a68892eddfb5d94d7e/archive/5be68cc6df9135e27edab94f802c5e062b53de99.zip
+type: distribution
+group: fractal
+title: Fractal
+images: []
+---
+
+This is an example of distributing fractally.
diff --git a/_world_examples/distribution-types/gaussian/gaussian.md b/_world_examples/distribution-types/gaussian/gaussian.md
@@ -0,0 +1,14 @@
+---
+link:
+  docs: /docs/cofh-world/world-generator-configuration/distribution-types/gaussian/
+  code:
+    embed: https://gist.github.com/sustained/51e74927ca127d40b6aa6648eeb44a4b.js
+    download: https://gist.github.com/sustained/51e74927ca127d40b6aa6648eeb44a4b/archive/d9ceaa413c6569590db1a0f8749a81f5f1405682.zip
+type: distribution
+group: gaussian
+title: Gaussian
+primary: true
+images: []
+---
+
+This is an example of distributing via a gaussian method.
diff --git a/_world_examples/distribution-types/sequential/sequential.md b/_world_examples/distribution-types/sequential/sequential.md
@@ -0,0 +1,14 @@
+---
+link:
+  docs: /docs/cofh-world/world-generator-configuration/distribution-types/sequential/
+  code:
+    embed: https://gist.github.com/sustained/32b76d4c171e484b2e6343ed02e812c6.js
+    download: https://gist.github.com/sustained/32b76d4c171e484b2e6343ed02e812c6/archive/6997ab96fc5e176a7d68aa185d32eff09c2b3407.zip
+type: distribution
+group: sequential
+title: Sequential
+primary: true
+images: []
+---
+
+This is an example of distributing sequentially.
diff --git a/_world_examples/distribution-types/surface/surface.md b/_world_examples/distribution-types/surface/surface.md
@@ -0,0 +1,14 @@
+---
+link:
+  docs: /docs/cofh-world/world-generator-configuration/distribution-types/surface/
+  code:
+    embed: https://gist.github.com/sustained/3b00a7c9dc3743d59da6948006badc4d.js
+    download: https://gist.github.com/sustained/3b00a7c9dc3743d59da6948006badc4d/archive/fa185bd33ab859e498860c8323dc3c60ee8109b7.zip
+type: distribution
+group: surface
+title: Surface
+primary: true
+images: []
+---
+
+This is an example of distributing on the surface.
diff --git a/_world_examples/distribution-types/underfluid/underfluid.md b/_world_examples/distribution-types/underfluid/underfluid.md
@@ -0,0 +1,14 @@
+---
+link:
+  docs: /docs/cofh-world/world-generator-configuration/distribution-types/underfluid/
+  code:
+    embed: https://gist.github.com/sustained/ed670beea25c122c37c7e75cf73c8172.js
+    download: https://gist.github.com/sustained/ed670beea25c122c37c7e75cf73c8172/archive/2b59874cb68979e33c55a2c029a90edad5c0088f.zip
+type: distribution
+group: underfluid
+title: Underfluid
+primary: true
+images: []
+---
+
+This is an example of distributing underfluid.
diff --git a/_world_examples/distribution-types/underwater/underwater.md b/_world_examples/distribution-types/underwater/underwater.md
@@ -0,0 +1,14 @@
+---
+link:
+  docs: /docs/cofh-world/world-generator-configuration/distribution-types/underwater/
+  code:
+    embed: https://gist.github.com/sustained/ffcb2b9ee40925d52c06ff2ec301de05.js
+    download: https://gist.github.com/sustained/ffcb2b9ee40925d52c06ff2ec301de05/archive/4bc6b18052b66452e41e9a5a830ee75e98ed000c.zip
+type: distribution
+group: underwater
+title: Underwater
+primary: true
+images: []
+---
+
+This is an example of distributing underwater.