gitbot/hugo-book
1
0
Fork 1
mirror of https://github.com/alex-shpak/hugo-book.git synced 2024-11-22 03:19:25 +00:00
Code Issues Projects Releases Wiki Activity

Improve page title handling and side menu templates

Browse Source
This commit is contained in:
Alex Shpak 2018-09-17 18:29:36 +02:00
parent 0dec1cd3a8
commit 561659ed53
6 changed files with 50 additions and 40 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
README.md
View File

@ -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

7
assets/styles.scss
View File

@ -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 {

4
layouts/docs/baseof.html
View File

@ -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
layouts/partials/docs/html-head.html
View File

@ -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">

55
layouts/partials/docs/nav-filetree.html
View File

@ -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
View 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 }}