Merge pull request #13 from databio/dev

v1

Author: nsheff

demo/md_template.jinja

@@ -4,29 +4,3 @@ This is a jinja template. You can write plain markdown text into the template li
 
 ## YAML data
 
-You can also refer to variables in the yaml files, using syntax like this:
-
-{% raw %}
-{{ number_of_things }} 
-{{ name_of_person }}
-{% endraw %}
-
-Which renders like this:
-
-{{ number_of_things }} 
-{{ name_of_person }}
-
-## Markdown data
-
-You can refer to *content* in the markdown data with the `.content` attribute, using the name you put in the config file {% raw %}{{ some_text_data.content }}{% endraw %}, which renders like this:
-
-```
-{{ some_text_data.content }}
-```
-
-
-You can also refer to the yaml metadata in your markdown files, using {% raw %}{{ some_text_data.metadata.text_property }}{% endraw %}:
-
-```
-{{ some_text_data.metadata.text_property }}
-```

demo/rendered.md

@@ -7,8 +7,8 @@ This is a jinja template. You can write plain markdown text into the template li
 You can also refer to variables in the yaml files, using syntax like this:
 
 
-15 
-The sundance kid
+{{ number_of_things }} 
+{{ name_of_person }}
 
 
 Which renders like this:
@@ -18,9 +18,7 @@ The sundance kid
 
 ## Markdown data
 
-You can refer to *content* in the markdown data with the `.content` attribute, using the name you put in the config file # Text content
-
-Here is some text, which renders like this:
+You can refer to *content* in the markdown data with the `.content` attribute, using the name you put in the config file {{ some_text_data }}, which renders like this:
 
 ```
 # Text content
@@ -29,8 +27,8 @@ Here is some text
 ```
 
 
-You can also refer to the yaml metadata in your markdown files, using text_property_value:
+You can also refer to the yaml metadata in your markdown files, using {{ _local_frontmatter.some_text_data.text_property }}:
 
 ```
-text_property_value
+
 ```

demo_book/README.md

@@ -0,0 +1,29 @@
+# Variable variables for book demo
+
+This folder contains an example of how to write a generic jinja template, and encode the contents within data variables in the config file.
+
+There are three examples that produce the same output, which can be produced using these commands:
+
+```
+mm -c book_basic/_markmeld.yaml default -p 
+
+mm -c book_var1/_markmeld.yaml default -p 
+
+mm -c book_var2/_markmeld.yaml default -p 
+
+```
+
+
+## Book basic
+
+This encodes the chapters directly in the `jinja` template. It's simple, but it's not re-usable.
+
+## Book var1
+
+This method uses the `_md` array, and indexes into it with `data.variables` specified in the `_markmeld.yaml` file. This uses a jinja template that is reusable.
+
+## Book var2 (recommended)
+
+This way extracts the chapters out of the `_markmeld.yaml` config file into a standalone yaml file. This is the most flexible way, since both the `jinja` template can be reused, and the `target` could also be imported and re-used with a different `chapters.yaml` file.
+
+

demo_book/book_basic/_markmeld.yaml

@@ -0,0 +1,10 @@
+targets:
+  default:
+    jinja_template: book.jinja
+    output_file: "demo_output.txt"
+    command: cat > {output_file}
+    data:
+      md_files:
+        intro: ../md/01-intro.md
+        credit: ../md/02-credit.md
+        savings: ../md/03-savings.md

demo_book/book_basic/book.jinja

@@ -0,0 +1,3 @@
+{{ intro }}
+{{ credit }}
+{{ savings }}

demo_book/book_basic/demo_output.txt

@@ -0,0 +1,15 @@
+# Introduction
+
+This is my introduction chapter
+
+...
+# Credit
+
+This is chapter 2 on credit.
+
+...
+# Chapter 3: Savings
+
+This is chapter 3 on savings.
+
+...

demo_book/book_var1/_markmeld.yaml

@@ -0,0 +1,15 @@
+targets:
+  default:
+    jinja_template: book.jinja
+    output_file: "demo_output.txt"
+    command: cat > {output_file}
+    data:
+      md_files:
+        intro: ../md/01-intro.md
+        credit: ../md/02-credit.md
+        savings: ../md/03-savings.md
+      variables:
+        chapters:
+          - intro
+          - credit
+          - savings

demo_book/book_var1/book.jinja

@@ -0,0 +1,2 @@
+{% for chapter in chapters %}{{ _md[chapter] }}
+{% endfor %}

demo_book/book_var1/demo_output.txt

@@ -0,0 +1,15 @@
+# Introduction
+
+This is my introduction chapter
+
+...
+# Credit
+
+This is chapter 2 on credit.
+
+...
+# Chapter 3: Savings
+
+This is chapter 3 on savings.
+
+...

demo_book/book_var2/_markmeld.yaml

@@ -0,0 +1,10 @@
+targets:
+  default:
+    jinja_template: book.jinja
+    output_file: "demo_output.txt"
+    command: cat > {output_file}
+    data:
+      md_globs:
+        - ../md/*.md
+      yaml_files:
+        chapters: chapters.yaml