Merge branch 'master' of github.com:adamhrv/megapixels_dev

1 files changed, 20 insertions, 2 deletions

diff --git a/megapixels/app/site/builder.py b/megapixels/app/site/builder.py
index 42e25768..ff1a0c83 100644
--- a/megapixels/app/site/builder.py
+++ b/megapixels/app/site/builder.py
@@ -15,6 +15,12 @@ env = Environment(
 )
 
 def build_page(fn, research_posts):
+  """
+  build a single page from markdown into the appropriate template
+  - writes it to site/public/
+  - syncs any assets with s3
+  - handles certain index pages...
+  """
   metadata, sections = parser.read_metadata(fn)
 
   if metadata is None:
@@ -60,9 +66,10 @@ def build_page(fn, research_posts):
   with open(output_fn, "w") as file:
     file.write(html)
 
-  print("______")
-
 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'])
@@ -79,7 +86,18 @@ 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)
   build_research_index(research_posts)
+
+def build_file(fn):
+  """
+  build just one page from a filename! =^)
+  """
+  research_posts = parser.read_research_post_index()
+  fn = os.path.join(cfg.DIR_SITE_CONTENT, fn)
+  build_page(fn, research_posts)