Add Jinja cheatsheet (#1688)

Co-authored-by: Rico Sta. Cruz <rstacruz@users.noreply.github.com>
2021-09-27 03:14:30 +02:00 · 2021-09-27 03:14:30 +02:00 · f0f4f05c92
parent ede185bf27
commit f0f4f05c92
2 changed files with 106 additions and 0 deletions
--- a/jinja.md
+++ b/jinja.md
@ -0,0 +1,101 @@
+---
+title: jinja
+category: python
+layout: 2017/sheet
+---
+
+{% raw %}
+### Basic usage
+
+```
+- variable x has content: {{ x }}
+- expression: {{ x + 1 }}
+- escaped for HTML: {{ x | e }}
+```
+
+### Control structures
+
+```
+{% for x in range(5) %}
+    {% if x % 2 == 0 %}
+        {{ x }} is even!
+    {% else %}
+        {{ x }} is odd!
+    {% endif %}
+{% endfor %}
+```
+
+### Whitespace trimming
+
+```
+these are
+{{ "three" }}
+lines.
+
+this is conc
+{{- "at" -}}
+enated.
+```
+
+### Special blocks
+
+```
+{% filter e %}{% endraw %}
+{ {%- if 0 -%}{%- endif -%} % raw %}
+{%- raw -%}
+    This is a raw block where {{nothing is evaluated}}
+    {% not even this %}
+    and <html is escaped> too with "e" filter
+{% endraw %}
+{ {%- if 0 -%}{%- endif -%} % endraw %}{% raw %}
+{% endfilter %}
+
+{% macro myfunc(x) %}
+    this is a reusable macro, with arguments: {{x}}
+{% endmacro %}
+
+{{ myfunc(42) }}
+
+{#
+this is a comment
+#}
+```
+
+
+### Inheritance
+
+#### shared.html
+
+```
+<html>
+  <head>
+    <title>{%block title %}{% endblock %}</title>
+  </head>
+  <body>
+    <header><h1>{% block title %}{% endblock %}</h1></header>
+    <main>{% block content %}{% endblock %}</main>
+  </body>
+</html>
+```
+
+#### home.html
+
+```
+{% extends "shared.html" %}
+{% block title %}Welcome to my site{% endblock %}
+{% block content %}
+This is the body
+{% endblock %}
+```
+
+## Library
+
+### Basic usage
+
+```python
+from jinja2 import Template
+template = Template('Hello {{ name }}!')
+template.render(name='John Doe') == u'Hello John Doe!'
+```
+
+{% endraw %}
--- a/jinja2.md
+++ b/jinja2.md
@ -0,0 +1,5 @@
+---
+title: jinja
+category: python
+redirect_to: /jinja
+---