From 281f77b84fc0121e1327671c3f9bb4fe7ed5faea Mon Sep 17 00:00:00 2001 From: Sunaina Pai Date: Sun, 12 Aug 2018 19:12:51 +0530 Subject: Explain content rendering in README.md --- README.md | 32 +++++++++++++++++++++++++++----- 1 file changed, 27 insertions(+), 5 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 540667b..da0f411 100755 --- a/README.md +++ b/README.md @@ -66,7 +66,7 @@ With [makesite.py](makesite.py): - The code is the configuration. Everything is laid out as plain and simple Python code for you to read -and enhance. It is less than 120 lines of code (excluding comments, +and enhance. It is less than 130 lines of code (excluding comments, docstrings, and blank lines). It gets you off the ground pretty quickly. You only need to execute `makesite.py`. @@ -364,15 +364,37 @@ It looks for the headers at the top of every content file. As soon as some non-header text is encountered, the rest of the content from that point is not checked for headers. +By default, placeholders in content files are not populated during +rendering. This behaviour is chosen so that you can write content freely +without having to worry about makesite interfering with the content, +i.e., you can write something like `{{ title }}` in the content and +makesite would leave it intact by default. + +However if you do want to populate the placeholders in a content file, +you need to specify a parameter named `render` with value of `yes`. This +can be done in two ways: + + - Specify the parameter in a header in the content file in the + following manner: + + + + - Specify the parameter as a keyword argument in `make_pages` call. + For example: + + blog_posts = make_pages('content/blog/*.md', + '_site/blog/{{ slug }}/index.html', + post_layout, blog='blog', render='yes', + **params) Credits ------- Thanks to: -- [Susam](https://github.com/susam) for the documentation and the unit - tests. -- [Keith Gaughan](https://github.com/kgaughan) for an improved - single-pass rendering of templates. + - [Susam Pal](https://github.com/susam) for the initial documentation + and the initial unit tests. + - [Keith Gaughan](https://github.com/kgaughan) for an improved + single-pass rendering of templates. License -- cgit v1.2.3