Add comments to build script, make command line relative to current path and require resume/ in --source path.

build/build.php

@@ -22,41 +22,41 @@ include_once APPLICATION_BASE_PATH . '/vendor/markdown-extra/markdown.php';
 include_once APPLICATION_BASE_PATH . '/vendor/lessphp/lessc.inc.php';
 include_once APPLICATION_BASE_PATH . '/vendor/simpledom/simple_html_dom.php';
 
-
 use Assetic\Asset\AssetCollection;
 use Assetic\Asset\FileAsset;
 use Assetic\Asset\GlobAsset;
 use Assetic\Filter;
 
-$shortopts  = "";
-$shortopts .= "s:";
-$shortopts .= "rp";
+// Setup the command line options
+$shortopts
+  = "s:" // source
+  . "r"  // refresh
+  . "p"; // pdf output
 
 $longopts  = array(
     "source:",
     "refresh",
     "pdf"
 );
+
 $options = getopt($shortopts, $longopts);
 
 // Combine the options to their shorter names
 if (empty($options['s']) && !empty($options['source'])) {
     $options['s'] = $options['source'];
 }
+$refresh_dev = isset($options['r']) || isset($options['refresh']);
 
 if (!isset($options['s'])) {
-    exit('Please specify a source document  build.php -s resume.pdf');
+    exit("Please specify a source document: build.php -s resume/resume.pdf\n");
 }
 
 $basename     = pathinfo($options['s'], PATHINFO_FILENAME);
-$source       = './resume/' . $options['s'];
+$source       = './' . $options['s'];
 $pdf_source   = './output/' . $basename . '-pdf.html';
 $output       = './output/' . $basename . '.html';
 $pdf_output   = './output/' . $basename . '.pdf';
 
-
-$refresh_dev = isset($options['r']) || isset($options['refresh']);
-
 $css = new AssetCollection(
     array(
         new GlobAsset(APPLICATION_BASE_PATH . '/assets/css/*.css')
@@ -70,16 +70,18 @@ $style = $css->dump();
 $template = file_get_contents(APPLICATION_BASE_PATH . '/assets/templates/default.html');
 $resume   = file_get_contents($source);
 
-$resume = Markdown($resume);
-$resume = SmartyPants($resume);
+// Process with Markdown, and then use SmartyPants to clean up punctuation.
+$resume = SmartyPants(Markdown($resume));
 
+// We'll construct the title for the html document from the h1 and h2 tags
 $html = str_get_html($resume);
 $title = sprintf(
     '%s | %s',
     $html->find('h1', 0)->innertext,
     $html->find('h2', 0)->innertext
 );
-    
+
+// We'll now render the Markdown into an html file with Mustache Templates
 $m = new Mustache;
 $rendered = $m->render(
     $template,
@@ -91,36 +93,41 @@ $rendered = $m->render(
     )
 );
 
+// Save the fully rendered html to the final destination
 file_put_contents(
     $output,
     $rendered
 );
 echo "Wrote html to $output\n";
 
-
-$pdf_classed = str_replace(
-    'body class=""',
-    'body class="pdf"',
-    $rendered
-);
-
+// If the user wants to make a pdf file, we'll use wkhtmltopdf to convert
+// the html document into a nice looking pdf.
 if (isset($options['pdf'])) {
+
+    // The pdf needs some extra css rules, and so we'll add them here
+    // to our html document
+    $pdf_classed = str_replace(
+        'body class=""',
+        'body class="pdf"',
+        $rendered
+    );
+
+    // Save the new pdf-ready html to a temp destination
     file_put_contents(
         $pdf_source,
         $pdf_classed
     );
 
+    // Process the document with wkhtmltopdf
     exec(
         'wkhtmltopdf '
         . $pdf_source .' '
         . $pdf_output
-        . ' && open ' . $pdf_output
     );
-    
+
+    // Unlink the temporary file
     unlink($pdf_source);
     echo "Wrote pdf to $pdf_output\n";
 }
 
-
-
-/* End of file build.php */
+/* End of file build.php */