parent
61570bbf57
commit
a56e4248e1
@ -9,6 +9,7 @@ for breaking changes with libsass: look for "beginning in Dart Sass"
|
|||||||
- Merge settings for the default language set in the root of `config.toml` and in the `[languages.{default_lang}]` section.
|
- Merge settings for the default language set in the root of `config.toml` and in the `[languages.{default_lang}]` section.
|
||||||
This will error if 2 values are set
|
This will error if 2 values are set
|
||||||
- Code blocks content are no longer included in the search index
|
- Code blocks content are no longer included in the search index
|
||||||
|
- Remove built-ins shortcodes
|
||||||
|
|
||||||
|
|
||||||
### Other
|
### Other
|
||||||
|
|||||||
@ -1,3 +0,0 @@
|
|||||||
<div {% if class %}class="{{class}}"{% endif %}>
|
|
||||||
<script src="{{ url }}.js{% if file %}?file={{file}}{% endif %}"></script>
|
|
||||||
</div>
|
|
||||||
@ -1,3 +0,0 @@
|
|||||||
<div {% if class %}class="{{class}}"{% endif %}>
|
|
||||||
<iframe src="https://www.streamable.com/e/{{id}}" scrolling="no" frameborder="0" allowfullscreen mozallowfullscreen webkitallowfullscreen></iframe>
|
|
||||||
</div>
|
|
||||||
@ -1,3 +0,0 @@
|
|||||||
<div {% if class %}class="{{class}}"{% endif %}>
|
|
||||||
<iframe src="//player.vimeo.com/video/{{id}}" webkitallowfullscreen mozallowfullscreen allowfullscreen></iframe>
|
|
||||||
</div>
|
|
||||||
@ -23,16 +23,6 @@ pub static ZOLA_TERA: Lazy<Tera> = Lazy::new(|| {
|
|||||||
include_str!("builtins/split_sitemap_index.xml"),
|
include_str!("builtins/split_sitemap_index.xml"),
|
||||||
),
|
),
|
||||||
("__zola_builtins/anchor-link.html", include_str!("builtins/anchor-link.html")),
|
("__zola_builtins/anchor-link.html", include_str!("builtins/anchor-link.html")),
|
||||||
(
|
|
||||||
"__zola_builtins/shortcodes/youtube.html",
|
|
||||||
include_str!("builtins/shortcodes/youtube.html"),
|
|
||||||
),
|
|
||||||
("__zola_builtins/shortcodes/vimeo.html", include_str!("builtins/shortcodes/vimeo.html")),
|
|
||||||
("__zola_builtins/shortcodes/gist.html", include_str!("builtins/shortcodes/gist.html")),
|
|
||||||
(
|
|
||||||
"__zola_builtins/shortcodes/streamable.html",
|
|
||||||
include_str!("builtins/shortcodes/streamable.html"),
|
|
||||||
),
|
|
||||||
("internal/alias.html", include_str!("builtins/internal/alias.html")),
|
("internal/alias.html", include_str!("builtins/internal/alias.html")),
|
||||||
])
|
])
|
||||||
.unwrap();
|
.unwrap();
|
||||||
|
|||||||
@ -93,8 +93,7 @@ should not be used as argument names in shortcodes.
|
|||||||
|
|
||||||
### Shortcodes without body
|
### Shortcodes without body
|
||||||
|
|
||||||
Simply call the shortcode as if it was a Tera function in a variable block. All the examples below are valid
|
Simply call the shortcode as if it was a Tera function in a variable block.
|
||||||
calls of the YouTube shortcode.
|
|
||||||
|
|
||||||
```md
|
```md
|
||||||
Here is a YouTube video:
|
Here is a YouTube video:
|
||||||
@ -198,13 +197,12 @@ Every shortcode can access the current language in the `lang` variable in the co
|
|||||||
|
|
||||||
You can then use it in your Markdown like so: `{{/* bookcover() */}}`
|
You can then use it in your Markdown like so: `{{/* bookcover() */}}`
|
||||||
|
|
||||||
## Built-in shortcodes
|
## Examples
|
||||||
|
|
||||||
Zola comes with a few built-in shortcodes. If you want to override a default shortcode template,
|
Here are some shortcodes for inspiration.
|
||||||
simply place a `{shortcode_name}.html` file in the `templates/shortcodes` directory and Zola will
|
|
||||||
use that instead.
|
|
||||||
|
|
||||||
### YouTube
|
### YouTube
|
||||||
|
|
||||||
Embed a responsive player for a YouTube video.
|
Embed a responsive player for a YouTube video.
|
||||||
|
|
||||||
The arguments are:
|
The arguments are:
|
||||||
@ -214,79 +212,26 @@ The arguments are:
|
|||||||
- `class`: a class to add to the `<div>` surrounding the iframe
|
- `class`: a class to add to the `<div>` surrounding the iframe
|
||||||
- `autoplay`: when set to "true", the video autoplays on load
|
- `autoplay`: when set to "true", the video autoplays on load
|
||||||
|
|
||||||
Usage example:
|
Code:
|
||||||
|
|
||||||
```md
|
|
||||||
{{/* youtube(id="dQw4w9WgXcQ") */}}
|
|
||||||
|
|
||||||
{{/* youtube(id="dQw4w9WgXcQ", playlist="RDdQw4w9WgXcQ") */}}
|
|
||||||
|
|
||||||
{{/* youtube(id="dQw4w9WgXcQ", autoplay=true) */}}
|
|
||||||
|
|
||||||
{{/* youtube(id="dQw4w9WgXcQ", autoplay=true, class="youtube") */}}
|
|
||||||
```
|
```
|
||||||
|
<div {% if class %}class="{{class}}"{% endif %}>
|
||||||
Result example:
|
<iframe src="https://www.youtube-nocookie.com/embed/{{id}}{% if playlist %}?list={{playlist}}{% endif %}{% if autoplay %}?autoplay=1{% endif %}" webkitallowfullscreen mozallowfullscreen allowfullscreen></iframe>
|
||||||
|
</div>
|
||||||
{{ youtube(id="dQw4w9WgXcQ") }}
|
```
|
||||||
|
|
||||||
### Vimeo
|
|
||||||
Embed a player for a Vimeo video.
|
|
||||||
|
|
||||||
The arguments are:
|
|
||||||
|
|
||||||
- `id`: the video id (mandatory)
|
|
||||||
- `class`: a class to add to the `<div>` surrounding the iframe
|
|
||||||
|
|
||||||
Usage example:
|
Usage example:
|
||||||
|
|
||||||
```md
|
```md
|
||||||
{{/* vimeo(id="124313553") */}}
|
{{/* youtube(id="dCKeXuVHl1o") */}}
|
||||||
|
|
||||||
{{/* vimeo(id="124313553", class="vimeo") */}}
|
{{/* youtube(id="dCKeXuVHl1o", playlist="RDdQw4w9WgXcQ") */}}
|
||||||
|
|
||||||
|
{{/* youtube(id="dCKeXuVHl1o", autoplay=true) */}}
|
||||||
|
|
||||||
|
{{/* youtube(id="dCKeXuVHl1o", autoplay=true, class="youtube") */}}
|
||||||
```
|
```
|
||||||
|
|
||||||
Result example:
|
### Image Gallery
|
||||||
|
|
||||||
{{ vimeo(id="124313553") }}
|
See [content processing page](@/documentation/content/image-processing/index.md#creating-picture-galleries) for code and example.
|
||||||
|
|
||||||
### Streamable
|
|
||||||
Embed a player for a Streamable video.
|
|
||||||
|
|
||||||
The arguments are:
|
|
||||||
|
|
||||||
- `id`: the video id (mandatory)
|
|
||||||
- `class`: a class to add to the `<div>` surrounding the iframe
|
|
||||||
|
|
||||||
Usage example:
|
|
||||||
|
|
||||||
```md
|
|
||||||
{{/* streamable(id="92ok4") */}}
|
|
||||||
|
|
||||||
{{/* streamable(id="92ok4", class="streamble") */}}
|
|
||||||
```
|
|
||||||
|
|
||||||
Result example:
|
|
||||||
|
|
||||||
{{ streamable(id="92ok4") }}
|
|
||||||
|
|
||||||
### Gist
|
|
||||||
Embed a [Github gist](https://gist.github.com).
|
|
||||||
|
|
||||||
The arguments are:
|
|
||||||
|
|
||||||
- `url`: the url to the gist (mandatory)
|
|
||||||
- `file`: by default, the shortcode will pull every file from the URL unless a specific filename is requested
|
|
||||||
- `class`: a class to add to the `<div>` surrounding the iframe
|
|
||||||
|
|
||||||
Usage example:
|
|
||||||
|
|
||||||
```md
|
|
||||||
{{/* gist(url="https://gist.github.com/Keats/e5fb6aad409f28721c0ba14161644c57") */}}
|
|
||||||
|
|
||||||
{{/* gist(url="https://gist.github.com/Keats/e5fb6aad409f28721c0ba14161644c57", class="gist") */}}
|
|
||||||
```
|
|
||||||
|
|
||||||
Result example:
|
|
||||||
|
|
||||||
{{ gist(url="https://gist.github.com/Keats/e5fb6aad409f28721c0ba14161644c57") }}
|
|
||||||
|
|||||||
@ -8,9 +8,3 @@ A simple page
|
|||||||
|
|
||||||
{{ youtube(id="e1C9kpMV2e8") }}
|
{{ youtube(id="e1C9kpMV2e8") }}
|
||||||
{{ youtube(id="e1C9kpMV2e8", autoplay=true) }}
|
{{ youtube(id="e1C9kpMV2e8", autoplay=true) }}
|
||||||
|
|
||||||
{{ vimeo(id="210073083") }}
|
|
||||||
|
|
||||||
{{ streamable(id="c0ic") }}
|
|
||||||
|
|
||||||
{{ gist(url="https://gist.github.com/Keats/32d26f699dcc13ebd41b") }}
|
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user