Mercurial > piecrust2

annotate docs/docs/03_content/07_assets.md @ 849:8f8bbb2e70e1

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
templating: Template engines can now load extensions directly from plugins.
author Ludovic Chabant <ludovic@chabant.com>
date Thu, 27 Apr 2017 20:55:07 -0700
parents 33903b1705a7
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
292
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
1 ---
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
2 title: Assets
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
3 ---
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
4
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
5 Writing text is all good, but sometimes you need to add some pictures in your
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
6 pages. You could easily handle this yourself by having an images folder at the
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
7 root of your website with all your pictures in it:
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
8
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
9 ![my picture](/images/path/to/my/picture.png)
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
10
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
11 However, your images folder could easily get cluttered and difficult to
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
12 organize, especially if you use pictures a lot in your blog posts. And it's not
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
13 super friendly to write.
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
14
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
15 To solve some of these problems, PieCrust has a "_page assets_" mechanism for
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
16 any kind of file you want to somehow be related to a page (pictures, audio
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
17 files, etc.).
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
18
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
19 You put all the assets for a page in a sub-directory that has the same name as
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
20 the page file, with a `-assets` suffix. For instance, if you have a page at
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
21 `pages/about/where-to-find-us.md`, you can create a
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
22 `pages/about/where-to-find-us-assets` directory with stuff in it:
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
23
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
24 pages
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
25 |- about
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
26 |- where-to-find-us.html
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
27 |- where-to-find-us-assets
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
28 |- map.jpg
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
29 |- street-view.jpg
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
30
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
31 Then, on the page, you can access those assets with the assets variable and the
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
32 name of the asset (without the extension):
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
33
295
33903b1705a7 docs: Documentation for iterators and filtering.
Ludovic Chabant <ludovic@chabant.com>
parents: 292
diff changeset
34 {%raw%}
292
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
35 ![map to our place]({{ assets.map }})
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
36 ![our place]({{ assets['street-view'] }})
295
33903b1705a7 docs: Documentation for iterators and filtering.
Ludovic Chabant <ludovic@chabant.com>
parents: 292
diff changeset
37 {%endraw%}
292
c8a6c92b1867 docs: Pagination and assets' documentation.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
38
295
33903b1705a7 docs: Documentation for iterators and filtering.
Ludovic Chabant <ludovic@chabant.com>
parents: 292
diff changeset
39 You can also loop over a page's assets:
33903b1705a7 docs: Documentation for iterators and filtering.
Ludovic Chabant <ludovic@chabant.com>
parents: 292
diff changeset
40
33903b1705a7 docs: Documentation for iterators and filtering.
Ludovic Chabant <ludovic@chabant.com>
parents: 292
diff changeset
41 {%raw%}
33903b1705a7 docs: Documentation for iterators and filtering.
Ludovic Chabant <ludovic@chabant.com>
parents: 292
diff changeset
42 {% for a in assets %}
33903b1705a7 docs: Documentation for iterators and filtering.
Ludovic Chabant <ludovic@chabant.com>
parents: 292
diff changeset
43 <img src="{{a}}" alt="" />
33903b1705a7 docs: Documentation for iterators and filtering.
Ludovic Chabant <ludovic@chabant.com>
parents: 292
diff changeset
44 {% endfor %}
33903b1705a7 docs: Documentation for iterators and filtering.
Ludovic Chabant <ludovic@chabant.com>
parents: 292
diff changeset
45 {%endraw%}
33903b1705a7 docs: Documentation for iterators and filtering.
Ludovic Chabant <ludovic@chabant.com>
parents: 292
diff changeset
46