mirror of
https://github.com/getzola/zola
synced 2024-11-10 14:24:27 +00:00
Some more improvements to documentation (#1508)
* Docs: resize_image is a Zola built-in Tera function * Fix highlight languages
This commit is contained in:
parent
9f88d7539f
commit
8258305117
5 changed files with 8 additions and 7 deletions
|
@ -121,7 +121,7 @@ The source for all examples is this 300 pixel × 380 pixel image:
|
|||
|
||||
## Using `resize_image` in markdown via shortcodes
|
||||
|
||||
`resize_image` is a built-in Tera global function (see the [templates](@/documentation/templates/_index.md) chapter),
|
||||
`resize_image` is a Zola built-in Tera function (see the [templates](@/documentation/templates/_index.md) chapter),
|
||||
but it can be used in Markdown using [shortcodes](@/documentation/content/shortcodes.md).
|
||||
|
||||
The examples above were generated using a shortcode file named `resize_image.html` with this content:
|
||||
|
|
|
@ -131,7 +131,7 @@ In a similar manner to how section and pages calculate their output path:
|
|||
|
||||
The taxonomy pages are then available at the following paths:
|
||||
|
||||
```
|
||||
```txt
|
||||
$BASE_URL/$NAME/ (taxonomy)
|
||||
$BASE_URL/$NAME/$SLUG (taxonomy entry)
|
||||
```
|
||||
|
|
|
@ -18,7 +18,7 @@ We can use any continuous integration (CI) server to build and deploy our site.
|
|||
|
||||
In either case, it seems to work best if you use `git submodule` to include your theme, e.g.:
|
||||
|
||||
```shell
|
||||
```sh
|
||||
git submodule add https://github.com/getzola/after-dark.git themes/after-dark
|
||||
```
|
||||
|
||||
|
@ -110,7 +110,7 @@ Depending on how you added your theme, Travis may not know how to access
|
|||
it. The best way to ensure that it will have full access to the theme is to use git
|
||||
submodules. When doing this, ensure that you are using the `https` version of the URL.
|
||||
|
||||
```shell
|
||||
```sh
|
||||
$ git submodule add {THEME_URL} themes/{THEME_NAME}
|
||||
```
|
||||
|
||||
|
|
|
@ -21,12 +21,13 @@ This guide assumes that your Zola project is located in the root of your reposit
|
|||
Depending on how you added your theme, your repository may not contain it. The best way to ensure that the theme will
|
||||
be added is to use submodules. When doing this, ensure that you are using the `https` version of the URL.
|
||||
|
||||
```shell
|
||||
```sh
|
||||
$ git submodule add {THEME_URL} themes/{THEME_NAME}
|
||||
```
|
||||
|
||||
For example, this could look like:
|
||||
```shell
|
||||
|
||||
```sh
|
||||
$ git submodule add https://github.com/getzola/hyde.git themes/hyde
|
||||
```
|
||||
|
||||
|
|
|
@ -35,7 +35,7 @@ in the configuration file is `simple-blog`. Also make sure to place the variable
|
|||
Any file from the theme can be overridden by creating a file with the same path and name in your `templates` or `static`
|
||||
directory. Here are a few examples of that, assuming that the theme name is `simple-blog`:
|
||||
|
||||
```plain
|
||||
```txt
|
||||
templates/pages/post.html -> replace themes/simple-blog/templates/pages/post.html
|
||||
templates/macros.html -> replace themes/simple-blog/templates/macros.html
|
||||
static/js/site.js -> replace themes/simple-blog/static/js/site.js
|
||||
|
|
Loading…
Reference in a new issue