Improve page title handling and side menu templates
This commit is contained in:
Alex Shpak
parent
0dec1cd3a8
commit
561659ed53
6 changed files with 50 additions and 40 deletions
12
README.md
12
README.md
|
|
@ -97,12 +97,12 @@ bookShowToC: false
|
|||
### Partials
|
||||
There are few empty partials you can override in `layouts/partials/`
|
||||
|
||||
| Partial | Placement |
|
||||
| -- | -- |
|
||||
| `layouts/partials/docs/inject/head.html` | Before closing `<head>` tag |
|
||||
| `layouts/partials/docs/inject/body.html` | Before closing `<body>` tag |
|
||||
| `layouts/partials/docs/inject/nav-before.html` | Before `<nav>` menu block |
|
||||
| `layouts/partials/docs/inject/nav-after.html` | After `<nav>` menu block |
|
||||
| Partial | Placement |
|
||||
| -- | -- |
|
||||
| `layouts/partials/docs/inject/head.html` | Before closing `<head>` tag |
|
||||
| `layouts/partials/docs/inject/body.html` | Before closing `<body>` tag |
|
||||
| `layouts/partials/docs/inject/nav-before.html` | At the beginning of `<nav>` menu block |
|
||||
| `layouts/partials/docs/inject/nav-after.html` | At the end of `<nav>` menu block |
|
||||
|
||||
|
||||
## Contributing
|
||||
|
|
|
|||
|
|
@ -28,7 +28,6 @@ a {
|
|||
font-weight: 400;
|
||||
|
||||
a {
|
||||
padding: 0 $padding-16;
|
||||
color: $body-font-color;
|
||||
}
|
||||
}
|
||||
|
|
@ -52,12 +51,16 @@ a {
|
|||
|
||||
ul {
|
||||
list-style: none;
|
||||
margin: 0;
|
||||
padding-left: $padding-16;
|
||||
|
||||
li {
|
||||
line-height: $padding-16 * 2;
|
||||
}
|
||||
|
||||
a {
|
||||
display: block;
|
||||
color: $nav-link-color;
|
||||
padding: $padding-4 $padding-16;
|
||||
text-transform: capitalize;
|
||||
|
||||
&[href]:hover {
|
||||
|
|
|
|||
|
|
@ -1,9 +1,9 @@
|
|||
<!DOCTYPE html>
|
||||
<!-- {{ partial "docs/shared" }} -->
|
||||
<html>
|
||||
<head>
|
||||
{{ partial "docs/html-head" . }}
|
||||
{{ partial "docs/inject/head" . }}
|
||||
<title>{{ block "title" . }} {{- .Site.Title -}} {{ end }}</title>
|
||||
</head>
|
||||
|
||||
<body>
|
||||
|
|
@ -27,7 +27,7 @@
|
|||
<div class="pure-g">
|
||||
|
||||
<div class="pure-u book-page markdown">
|
||||
{{ block "main" . }} {{- .Content -}} {{ end }}
|
||||
{{- .Content -}}
|
||||
</div>
|
||||
{{ $showToC := default (default true .Site.Params.BookShowToC) .Params.bookshowtoc }}
|
||||
{{ if and ($showToC) (.Page.TableOfContents) }}
|
||||
|
|
|
|||
|
|
@ -1,5 +1,6 @@
|
|||
<meta charset="UTF-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
<title>{{- template "title" . }} | {{ .Site.Title -}}</title>
|
||||
|
||||
<link href="https://fonts.googleapis.com/css?family=Roboto+Mono|Roboto:300,400,700" rel="stylesheet">
|
||||
<link href="/css/pure-min.css" rel="stylesheet">
|
||||
|
|
|
|||
|
|
@ -1,15 +1,5 @@
|
|||
{{ $bookSection := default "docs" .Site.Params.BookSection }}
|
||||
{{ if eq $bookSection "*" }}
|
||||
{{ .Scratch.Set "BookSections" .Site.Sections }}
|
||||
{{ else }}
|
||||
{{ $bookSections := where .Site.Sections "Section" $bookSection }}
|
||||
{{ .Scratch.Set "BookSections" $bookSections }}
|
||||
|
||||
{{ if eq (len $bookSections) 1 }}
|
||||
{{ $singleSection := index $bookSections 0 }}
|
||||
{{ .Scratch.Set "BookSections" $singleSection.Sections }}
|
||||
{{ end }}
|
||||
{{ end }}
|
||||
<!-- Put configured sections list to .Scratch -->
|
||||
{{ template "book-get-root-section" . }}
|
||||
|
||||
<ul>
|
||||
{{ range .Scratch.Get "BookSections" }}
|
||||
|
|
@ -20,7 +10,15 @@
|
|||
<!-- Single section of menu (recursive) -->
|
||||
{{ define "book-section" }}
|
||||
<li {{ if .Section.Params.booktopsection }}class="book-nav-section"{{ end }}>
|
||||
{{ template "book-heading" .Section }}
|
||||
|
||||
{{ with .Section}}
|
||||
{{- if .Content -}}
|
||||
<a href="{{ .RelPermalink }}">{{- template "title" . -}}</a>
|
||||
{{- else -}}
|
||||
{{- template "title" . -}}
|
||||
{{- end -}}
|
||||
{{ end }}
|
||||
|
||||
<ul>
|
||||
{{ range .Section.Sections }}
|
||||
{{ template "book-section" (dict "Section" . "CurrentPage" $.CurrentPage) }}
|
||||
|
|
@ -28,7 +26,7 @@
|
|||
{{ range .Section.Pages }}
|
||||
<li>
|
||||
<a href="{{ .RelPermalink }}" class="{{ if eq $.CurrentPage .Permalink }}active{{ end }}">
|
||||
{{ default .Title (.File | humanize | title) }}
|
||||
{{- template "title" . -}}
|
||||
</a>
|
||||
</li>
|
||||
{{ end }}
|
||||
|
|
@ -36,21 +34,18 @@
|
|||
</li>
|
||||
{{ end }}
|
||||
|
||||
<!-- Menu Heading -->
|
||||
{{ define "book-heading" }}
|
||||
|
||||
{{ $sections := split (trim .Dir "/") "/" }}
|
||||
{{ $title := index ($sections | last 1) 0 | humanize | title }}
|
||||
{{ $title := default .Title $title }}
|
||||
|
||||
{{ if .Content }}
|
||||
<a href="{{ .RelPermalink }}">
|
||||
{{- $title -}}
|
||||
</a>
|
||||
{{ define "book-get-root-section" }}
|
||||
<!-- Complex logic to guess page title without .Title specified -->
|
||||
{{ $bookSection := default "docs" .Site.Params.BookSection }}
|
||||
{{ if eq $bookSection "*" }}
|
||||
{{ .Scratch.Set "BookSections" .Site.Sections }}
|
||||
{{ else }}
|
||||
<a>
|
||||
{{- $title -}}
|
||||
</a>
|
||||
{{ end }}
|
||||
{{ $bookSections := where .Site.Sections "Section" $bookSection }}
|
||||
{{ .Scratch.Set "BookSections" $bookSections }}
|
||||
|
||||
{{ end }}
|
||||
{{ if eq (len $bookSections) 1 }}
|
||||
{{ $singleSection := index $bookSections 0 }}
|
||||
{{ .Scratch.Set "BookSections" $singleSection.Sections }}
|
||||
{{ end }}
|
||||
{{ end }}
|
||||
{{ end }}
|
||||
11
layouts/partials/docs/shared.html
Normal file
11
layouts/partials/docs/shared.html
Normal file
|
|
@ -0,0 +1,11 @@
|
|||
<!-- These templates contains some more complex logic and shared between partials-->
|
||||
{{ define "title" }}
|
||||
{{- if .Pages -}}
|
||||
{{ $sections := split (trim .Dir "/") "/" }}
|
||||
{{ $title := index ($sections | last 1) 0 | humanize | title }}
|
||||
{{- default .Title $title -}}
|
||||
{{- else -}}
|
||||
{{ $title := .File | humanize | title }}
|
||||
{{- default .Title $title -}}
|
||||
{{- end -}}
|
||||
{{ end }}
|
||||
Loading…
Reference in a new issue