summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README.md12
-rw-r--r--assets/styles.scss7
-rw-r--r--layouts/docs/baseof.html4
-rw-r--r--layouts/partials/docs/html-head.html1
-rw-r--r--layouts/partials/docs/nav-filetree.html55
-rw-r--r--layouts/partials/docs/shared.html11
6 files changed, 50 insertions, 40 deletions
diff --git a/README.md b/README.md
index 4ac177b..5bb44fe 100644
--- a/README.md
+++ b/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
diff --git a/assets/styles.scss b/assets/styles.scss
index d53fd23..670eb76 100644
--- a/assets/styles.scss
+++ b/assets/styles.scss
@@ -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 {
diff --git a/layouts/docs/baseof.html b/layouts/docs/baseof.html
index a71bd59..4119888 100644
--- a/layouts/docs/baseof.html
+++ b/layouts/docs/baseof.html
@@ -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) }}
diff --git a/layouts/partials/docs/html-head.html b/layouts/partials/docs/html-head.html
index ecf8a4c..e77c218 100644
--- a/layouts/partials/docs/html-head.html
+++ b/layouts/partials/docs/html-head.html
@@ -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">
diff --git a/layouts/partials/docs/nav-filetree.html b/layouts/partials/docs/nav-filetree.html
index c5ecfc8..7c80ae2 100644
--- a/layouts/partials/docs/nav-filetree.html
+++ b/layouts/partials/docs/nav-filetree.html
@@ -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 }} \ No newline at end of file
diff --git a/layouts/partials/docs/shared.html b/layouts/partials/docs/shared.html
new file mode 100644
index 0000000..f7ba182
--- /dev/null
+++ b/layouts/partials/docs/shared.html
@@ -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 }}