Only build site previews for PRs (#306)

Author: stefanv

Makefile

@@ -31,7 +31,7 @@ doc-serve: doc/content/shortcodes.md
 # The following is for use on netlify
 # -----------------------------------
 
-netlify: theme scipy main blog learn
+netlify-preview: theme scipy main blog learn
 	mv scipy/public doc/public/scipy
 	mv main/public doc/public/main
 	mv blog/public doc/public/blog

README.md

@@ -7,3 +7,18 @@ The **Scientific Python Hugo Theme** is a theme for the
 Please see the [theme
 documentation](https://theme.scientific-python.org), especially the
 [get started](https://theme.scientific-python.org/getstarted/) page.
+
+## Theme development
+
+When making PRs against this repository, a site preview of the theme
+documentation will be rendered. From there, you can browse preview
+builds of a few other community websites: `scipy`, `main`
+(scientific-python.org), `blog`, and `learn`.  E.g., if the preview link is
+
+https://deploy-preview-301--scientific-python-hugo-theme.netlify.app/
+
+browse to
+
+https://deploy-preview-301--scientific-python-hugo-theme.netlify.app/blog
+
+to see how the blog rendered.

doc/netlify.toml

@@ -4,6 +4,15 @@
   DART_SASS_VERSION = "1.69.4"
   DART_SASS_URL = "https://github.com/sass/dart-sass/releases/download/"
 
+[context.production.environment]
+  BUILD_TARGET = "theme"
+
+[context.deploy-preview.environment]
+  BUILD_TARGET = "netlify-preview"
+
+[context.deploy-preview]
+  ignore = "false"
+
 [build]
   base = "doc"
   publish = "public"
@@ -14,11 +23,8 @@
     rm ${DART_SASS_TARBALL} && \
     export PATH=/opt/build/repo/doc/dart-sass:$PATH && \
     (cd ../.. ; ln -s repo scientific-python-hugo-theme) && \
-    (cd .. ; make theme) \
+    (cd .. ; make ${BUILD_TARGET}) \
     """
 
-[context.deploy-preview]
-  ignore = "false"
-
 [[plugins]]
   package = "netlify-plugin-checklinks"