tabulator

1 files changed, 10 insertions, 0 deletions

diff --git a/megapixels/app/site/builder.py b/megapixels/app/site/builder.py
index 91df54c2..895f265b 100644
--- a/megapixels/app/site/builder.py
+++ b/megapixels/app/site/builder.py
@@ -15,6 +15,10 @@ env = Environment(
 )
 
 def build_page(fn, research_posts):
+  """
+  build a single page from markdown into the appropriate template
+  - writes it to site/public/
+  """
   metadata, sections = parser.read_metadata(fn)
 
   if metadata is None:
@@ -61,6 +65,9 @@ def build_page(fn, research_posts):
     file.write(html)
 
 def build_research_index(research_posts):
+  """
+  build the index of research (blog) posts
+  """
   metadata, sections = parser.read_metadata('../site/content/research/index.md')
   template = env.get_template("page.html")
   s3_path = s3.make_s3_path(cfg.S3_SITE_PATH, metadata['path'])
@@ -77,6 +84,9 @@ def build_research_index(research_posts):
     file.write(html)
 
 def build_site():
+  """
+  build the site! =^)
+  """
   research_posts = parser.read_research_post_index()
   for fn in glob.iglob(os.path.join(cfg.DIR_SITE_CONTENT, "**/*.md"), recursive=True):
     build_page(fn, research_posts)