I changed the way I create links to use references to a data YML file instead of relying on the capture tag and including reference to the file with the captions. Using the capture tag was highly susceptible to broken links and way too manual. See the Links topic for more detail about the new method.

doc_build_arguments.md

@@ -5,7 +5,7 @@ keywords: building, serving, serve, build
 last_updated: August 12, 2015
 summary: "When you have a single sourcing project, you use more advanced arguments when you're building or serving your Jekyll sites. These arguments specify a particular configuration file and may build on other configuration files."
 ---
-{% include linkrefs.html %} 
+
 
 ## How to build Jekyll sites
 
@@ -33,7 +33,7 @@ Here the `configs/config_writers.yml` file is used instead of `_config.yml`. The
 
 If you don't want to enter the long Jekyll argument every time, with all your configuration details, you can create a shell script and then just run the script. This theme shows an example with the doc_multibuild_web.sh file in the root directory.
 
-My preference is to add the scripts to profiles in iTerm. See {{doc_iterm_profiles}} for more details.
+My preference is to add the scripts to profiles in iTerm. See {{site.data.urls.doc_iterm_profiles}} for more details.
 
 ## Stop a server