rebuilding site Sat Mar 29 22:26:14 EDT 2014

2014-03-29 22:26:14 -04:00
parent 33dff19264
commit d17bdbeea7
28 changed files with 476 additions and 205 deletions
@@ -1,12 +1,22 @@
-{{ $baseurl := .Site.BaseUrl }}
+<!--
+  This file defines how a summary of a specifc post should be presented in a
+  list (hence the file name li.html for "list item"). This is used in the
+  template /layouts/indexes/posts.html

+  The lines of the displayed list item are as follows:
+  (1) The name of the post
+  (2) The date the post was written as left-justified text and a
+      right-justified horizontal list of categories for that post.
+  (3) The contents of the description field in the metadata of the actual
+      markdown source of the post.
+-->
 <li>
  <span><h2><a href='{{ .Permalink }}'> {{ .Title }}</a> </h2></span>
  <span class="left">{{ .Date.Format "Mon, Jan 2, 2006" }}</span>
  <span class="right">
    <ul class="catlist">
      {{ range .Params.categories }}
-        <li><a href="{{ $baseurl }}/categories/{{ . | urlize }}">{{ . }}</a> </li>
+        <li><a href="/categories/{{ . | urlize }}">{{ . }}</a> </li>
      {{ end }}
    </ul>
  </span>
@@ -1,8 +1,13 @@
+<!--
+  This file is responsible for rendering a single blog post.
+-->
+
 {{ template "chrome/header.html" . }}

 <body class="theme-base-08">
  {{ template "chrome/sidebar.html" . }}

+  <!-- See /layouts/indexes/category.html for explanation of this section -->
  <div class="wrap">
    <div class="masthead">
      <div class="container">
@@ -12,12 +17,23 @@
      </div>
    </div>

+    <!--
+      This is where the actual post is displayed.
+
+      We first access the title metadata field from the markdown source and
+      display it as a heading.
+
+      We then access the date the post was written (also in the markdown
+      metadata) and display a formated version of it
+
+      Finally we include the actual content of the post.
+    -->
    <div class="container content">
      <h1 class="post-title">{{ .Title }}</h1>
        <section id="main">
          <h5 id="date"> {{ .Date.Format "Mon Jan 2, 2006" }} </h5>
+          {{ .Content }}
        </section>
-      {{ .Content }}
    </div>
  </div>

@@ -1,3 +1,16 @@
+<!--
+  This file defines how a summary of a specifc post should be presented. This
+  is similar to the file /layouts/posts/li.html, but is meant have a bit longer
+  of a representation than the one in that file.
+
+  This template does the following:
+  (1) Shows the name of the post
+  (2) Shows the date the post was created (from metadata in post markdown
+      source)
+  (3) Displays a Hugo-generated summary of the post
+  (4) Provides a link with text Read More that points to the post
+-->
+
 <article class="post">
    <header>
      <h2><a href='{{ .Permalink }}'> {{ .Title }}</a> </h2>