diff --git a/README.md b/README.md
index b2715a7..a61e29a 100644
--- a/README.md
+++ b/README.md
@@ -35,6 +35,12 @@ To build the site for production and compress HTML files:
npm run production
```
+on windows command line (not powershell, not vscode terminal):
+
+```bash
+npm run production-win
+```
+
The site is built in the `/build` folder.
## Further information
diff --git a/build.js b/build.js
index 094ac83..6f86aa5 100644
--- a/build.js
+++ b/build.js
@@ -21,7 +21,7 @@ siteMeta = {
author: 'dashdevs',
contact: 'https://chat.dashdevs.org',
domain: devBuild ? 'http://127.0.0.1' : 'https://rawgit.com', // set domain
- rootpath: devBuild ? null : '/dashdev-suite/dashdev-website/master/build/' // set absolute path (null for relative)
+ rootpath: devBuild ? null : '/dashdev-website/build/' // set absolute path (null for relative)
};
templateConfig = {
diff --git a/build/article/draft/index.html b/build/article/draft/index.html
index 653d9eb..638a615 100644
--- a/build/article/draft/index.html
+++ b/build/article/draft/index.html
@@ -1 +1 @@
-Draft article - dashdev-website
This article will only appear if the site is built is run after 1 March, 2016.
\ No newline at end of file
diff --git a/build/article/gotchas/index.html b/build/article/gotchas/index.html
index 2490b16..cc1f097 100644
--- a/build/article/gotchas/index.html
+++ b/build/article/gotchas/index.html
@@ -1 +1 @@
-Gotchas - dashdev-website
Not everything is necessarily straight-forward in the Metalsmith world…
Incompatible plugins
Some plugins clash with another. For example, metalsmith-rootpath which calculates relative roots does not play nicely with metalsmith-permalinks which creates custom folder structures.
Note: lib/metalsmith-moremeta in this project sets a correct root variable whether permalinks are used or not.
Plugin order can be critical
One plugins may depend on another or conflict if placed the wrong way around. For example, the RSS-generating metalsmith-feed plugin must be called after metalsmith-layouts to ensure rss.xml is not generated within a page template.
Browsersync build issues
When Browsersync is running and files are edited, collections are re-parsed but the old data remains. This can cause menus and next/back links to be incorrect. To fix this, stop and restart the build.
\ No newline at end of file
+Gotchas - dashdev-website
Not everything is necessarily straight-forward in the Metalsmith world…
Incompatible plugins
Some plugins clash with another. For example, metalsmith-rootpath which calculates relative roots does not play nicely with metalsmith-permalinks which creates custom folder structures.
Note: lib/metalsmith-moremeta in this project sets a correct root variable whether permalinks are used or not.
Plugin order can be critical
One plugins may depend on another or conflict if placed the wrong way around. For example, the RSS-generating metalsmith-feed plugin must be called after metalsmith-layouts to ensure rss.xml is not generated within a page template.
Browsersync build issues
When Browsersync is running and files are edited, collections are re-parsed but the old data remains. This can cause menus and next/back links to be incorrect. To fix this, stop and restart the build.
\ No newline at end of file
diff --git a/build/article/gulp/index.html b/build/article/gulp/index.html
index df19709..3c93989 100644
--- a/build/article/gulp/index.html
+++ b/build/article/gulp/index.html
@@ -1,4 +1,4 @@
-Gulp - dashdev-website
Metalsmith is often enough for simpler workflows. However, Gulp has a more extensive range of plugins and permits complex build activities such as linting and PostCSS processing with auto-prefixer.
Metalsmith is often enough for simpler workflows. However, Gulp has a more extensive range of plugins and permits complex build activities such as linting and PostCSS processing with auto-prefixer.
Further Gulp tasks can then be added. Note .clean(false) ensures Metalsmith never wipes the build folder when other tasks are active.
There are a number of Gulp/Metalsmith integration plugins although they are rarely necessary.
\ No newline at end of file
+});
Further Gulp tasks can then be added. Note .clean(false) ensures Metalsmith never wipes the build folder when other tasks are active.
There are a number of Gulp/Metalsmith integration plugins although they are rarely necessary.
\ No newline at end of file
diff --git a/build/article/index.html b/build/article/index.html
index 6e69407..6325213 100644
--- a/build/article/index.html
+++ b/build/article/index.html
@@ -1 +1 @@
-Articles - dashdev-website
\ No newline at end of file
diff --git a/build/contact/index.html b/build/contact/index.html
index 4dc9171..2baf08c 100644
--- a/build/contact/index.html
+++ b/build/contact/index.html
@@ -1 +1 @@
-Contact - dashdev-website
\ No newline at end of file
diff --git a/build/index.html b/build/index.html
index c3fedea..231ed8a 100644
--- a/build/index.html
+++ b/build/index.html
@@ -1 +1 @@
-dashdev-website
This is a static website generated using the Node.js-powered Metalsmith and various published and custom plugins.
This is a demonstration rather than a recommended way to build a static site. Your requirements will be different. Please use any part of the code as you wish.
Where could you use Metalsmith?
Metalsmith could be used to create:
a fast static website with minimal server-side requirements
This is a static website generated using the Node.js-powered Metalsmith and various published and custom plugins.
This is a demonstration rather than a recommended way to build a static site. Your requirements will be different. Please use any part of the code as you wish.
Where could you use Metalsmith?
Metalsmith could be used to create:
a fast static website with minimal server-side requirements
Published 26 February 2020, 55 words, 1-minute read
To build and launch the site in a test server using Browsersync:
npm start
(Stop the server with Ctrl+C.)
To build the site for production and compress HTML files:
npm run production
The site is built in the /build folder.
Note you may want to change the siteMeta.domain and siteMeta.rootpath on lines 52 and 53 of ./build.js.
\ No newline at end of file
diff --git a/build/start/index.html b/build/start/index.html
index 648f39f..e084c1b 100644
--- a/build/start/index.html
+++ b/build/start/index.html
@@ -1 +1 @@
-Start - dashdev-website
\ No newline at end of file
diff --git a/build/start/installation/index.html b/build/start/installation/index.html
index b97afae..06632f8 100644
--- a/build/start/installation/index.html
+++ b/build/start/installation/index.html
@@ -1 +1 @@
-Installation - dashdev-website
Published 26 February 2020, 194 words, 1-minute read
Each sub-folder in src/html is a website section. Pages named index.md are the default page in section. File paths are translated to permalinks, e.g.
src/html/article/mypage.md
is rendered to:
build/article/mypage/index.html
Pages use YAML front-matter defined at the top. This can be referenced in templates or during the build process, e.g.
---
title: My page title
description: A description of this page for meta tags and page lists.
layout: page.html
priority: 0.9
publish: 2016-06-01
date: 2016-06-01
----
All items are optional. Note:
layout defaults to page.html unless metadata.layout is defined for the page collection (see the use(collections({ ... }) code in build.js).
priority is a number between 0 (low) and 1 (high) which is used to order menus and define XML sitemaps.
publish can be set draft, private or a future date to ensure it is not published until required.
date is the date of the article. If not set, a future publish date or the file creation date is used.
The page content is defined in markdown, HTML syntax or both below the front-matter section. The content can include Handlebars partials from the src/partials folder, e.g.
{{> partialname }}
where partialname is the partial filename without its .html extension.
\ No newline at end of file
+---
All items are optional. Note:
layout defaults to page.html unless metadata.layout is defined for the page collection (see the use(collections({ ... }) code in build.js).
priority is a number between 0 (low) and 1 (high) which is used to order menus and define XML sitemaps.
publish can be set draft, private or a future date to ensure it is not published until required.
date is the date of the article. If not set, a future publish date or the file creation date is used.
The page content is defined in markdown, HTML syntax or both below the front-matter section. The content can include Handlebars partials from the src/partials folder, e.g.
{{> partialname }}
where partialname is the partial filename without its .html extension.
\ No newline at end of file
diff --git a/build/start/plugins/index.html b/build/start/plugins/index.html
index fdbd23f..89fa054 100644
--- a/build/start/plugins/index.html
+++ b/build/start/plugins/index.html
@@ -1 +1 @@
-Custom plugins - dashdev-website
The build.js file defines how the site is built using Metalsmith and various plugins.
Several custom plugins have been created specifically for this site:
lib/metalsmith-debug.js: output debugging information to the console.
lib/metalsmith-setdate.js: ensure each page has a date. If a date is not defined in the page's front-matter, it is presumed to be the publish or file creation date.
lib/metalsmith-moremeta.js: applies further metadata to each page including the root folder, a default layout, primary and secondary navigation.
\ No newline at end of file
+Custom plugins - dashdev-website
The build.js file defines how the site is built using Metalsmith and various plugins.
Several custom plugins have been created specifically for this site:
lib/metalsmith-debug.js: output debugging information to the console.
lib/metalsmith-setdate.js: ensure each page has a date. If a date is not defined in the page's front-matter, it is presumed to be the publish or file creation date.
lib/metalsmith-moremeta.js: applies further metadata to each page including the root folder, a default layout, primary and secondary navigation.
\ No newline at end of file
diff --git a/build/start/site-files/index.html b/build/start/site-files/index.html
index 7b3bc37..d4771d8 100644
--- a/build/start/site-files/index.html
+++ b/build/start/site-files/index.html
@@ -1 +1 @@
-Site files - dashdev-website
