explanatory comments in config and screenshots

exampleSite/config.toml

@@ -5,12 +5,22 @@ title = "docter"
 theme = "docter"
 
 [params]
- name = "docter"
+ # the name of your project and a link back to the home page
+ home = "docter"
+ # A small snippet of text above the sidebar:
+ # subtitle = ""
+
  author = "org name"
  author_url= "https://github.com/edavidaja"
+
+ # Point readers to your repo and invite them to edit pages 
  repo_host = "Gitlab"
  repo = "https://gitlab.com/edavidaja/docter"
- logourl= ""
- logoalt= ""
- hosted_on= "netlify"
- hosted_on_url= "https://www.netlify.com"
+
+ # Add a reference to a logo, which will appear in the top right
+ # logourl = ""
+ # logoalt = ""
+
+ # Mention your hosting provider 
+ hosted_on = "hosting provider"
+ hosted_on_url= "#"

layouts/partials/footer.html

@@ -13,10 +13,11 @@
  </p>
 
  <p>
- <a href="{{ .Site.Params.repo }}/edit/master/content/{{.File.Path}}"
- >Edit this page</a
- >
- or <a href="{{.Site.Params.repo}}/issues">file an issue</a> on
+ <a
+ href="{{ .Site.Params.repo }}/edit/master/content/
+ {{ with.File }}{{ .Path }}{{ end }}"
+ >Edit this page</a> or <a href="{{.Site.Params.repo}}/issues">
+ file an issue</a> on
  {{.Site.Params.repo_host}}.
  </p>
  </div>

layouts/partials/header.html

@@ -1,8 +1,8 @@
 <header role="banner">
  <div class="wrap">
  {{ if isset .Site.Params "logourl" }}
- <img class="logo" src="{{.Site.BaseURL}}{{ .Site.Params.logourl }}" alt="{{ .Site.Params.logoalt }}">
+ <img class="logo" src="{{ .Site.BaseURL}}{{ .Site.Params.logourl }}" alt="{{ .Site.Params.logoalt }}">
  {{ end }}
- <h1 class="site-title"><a class="title-link" href="{{ .Site.BaseURL }}">{{ .Site.Params.name }}</a></h1>
+ <h1 class="site-title"><a class="title-link" href="{{ .Site.BaseURL }}">{{ .Site.Params.home }}</a></h1>
  </div>
 </header>

layouts/partials/sidebar.html

@@ -1,5 +1,7 @@
 <aside>
- <p class="intro">{{ .Params.subtitle }}</p>
+ {{ if isset .Site.Params "subtitle"}}
+ <p class="intro">{{ .Site.Params.subtitle }}</p>
+ {{ end }}
  <a class="skip-link visuallyhidden focusable" href="#main">Skip to Main Content</a>
  <nav class="sidebar-nav" role="navigation">
  <ul>