Layout inheritance #112

ror3d · 2021-12-05T23:05:21Z

ror3d
Dec 5, 2021

Some static generator templating engines include support for inheriting layouts. Basically, you would have files such as:

base.cshtml:

<html>
...
  @RenderBody()
...
</html>

post.cshtml:

---
Layout: base.cshtml
---
... some layout specialization ...
@RenderBody()

But it doesn't seem to work. Is there some way I haven't found just because of different naming or is it just not possible?

Thanks!

Answered by daveaglick

Dec 6, 2021

It's definitely possible - nested layouts are built into the Razor engine and work the same way in Statiq as they do in ASPNET. So then the question becomes why they aren't working in your case.

You can see an example of nested layouts in the Statiq web site here: https://github.com/statiqdev/statiqdev.github.io/tree/develop/input/news

Notice how there's a _ViewStart.cshtml file that tells every page under the "news" folder to use the /news/_layout.cshtml layout. In turn, the /news/_layout.cshtml contains this block at the top:

@{
    Layout = @"/_layout.cshtml";
}

That instructs the /news/_layout.cshtml to nest inside the /_layout.cshtml layout.

I wonder if part of the confusion here mi…

View full answer

daveaglick · 2021-12-06T14:53:52Z

daveaglick
Dec 6, 2021
Maintainer

It's definitely possible - nested layouts are built into the Razor engine and work the same way in Statiq as they do in ASPNET. So then the question becomes why they aren't working in your case.

You can see an example of nested layouts in the Statiq web site here: https://github.com/statiqdev/statiqdev.github.io/tree/develop/input/news

Notice how there's a _ViewStart.cshtml file that tells every page under the "news" folder to use the /news/_layout.cshtml layout. In turn, the /news/_layout.cshtml contains this block at the top:

@{
    Layout = @"/_layout.cshtml";
}

That instructs the /news/_layout.cshtml to nest inside the /_layout.cshtml layout.

I wonder if part of the confusion here might be how the Layout front matter works inside a layout - the short answer is that it doesn't, which is why the nesting in the example above is done using the @{ ... } Razor syntax. The longer explanation is that front matter is only processed for pages being directly rendered by Statiq. Since a layout is something that Statiq doesn't normally process directly, any front matter in a layout file won't have an impact (nor should Statiq deal with layouts - layouts for any given rendering engine are going to be a function of that engine and shouldn't be rendered or treated as renderable content otherwise).

Does that make sense?

1 reply

ror3d Dec 6, 2021
Author

Ah indeed! yes, the issue here was the front-matter syntax. In content cshtml files I have the yml style working, but in this case it just got rendered as normal text. When using the @{ ... } syntax for it instead it works perfectly. Thank you!

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Statiq

Layout inheritance #112

{{title}}

Replies: 1 comment 1 reply

{{title}}

{{title}}

Select a reply

Statiq

Layout inheritance #112

ror3d Dec 5, 2021

Replies: 1 comment · 1 reply

daveaglick Dec 6, 2021 Maintainer

ror3d Dec 6, 2021 Author

ror3d
Dec 5, 2021

Replies: 1 comment 1 reply

daveaglick
Dec 6, 2021
Maintainer

ror3d Dec 6, 2021
Author