diff --git a/build/article/future/index.html b/build/article/future/index.html index 18ccdf6..0fb1acc 100644 --- a/build/article/future/index.html +++ b/build/article/future/index.html @@ -19,9 +19,6 @@
- -
- - -
-
@@ -63,15 +57,6 @@
  • Usage options
  • -
  • - Gotchas -
  • -
  • - Gulp -
  • -
  • - Future publication -
  • @@ -92,8 +77,6 @@
    - \ No newline at end of file diff --git a/build/article/gotchas/index.html b/build/article/gotchas/index.html index cc64cce..6ef3ab1 100644 --- a/build/article/gotchas/index.html +++ b/build/article/gotchas/index.html @@ -19,9 +19,6 @@
    - -
    - - -
    -
    @@ -63,15 +57,6 @@
  • Usage options
  • -
  • - Gotchas -
  • -
  • - Gulp -
  • -
  • - Future publication -
  • @@ -99,11 +84,7 @@ @@ -111,19 +92,19 @@ +
    - \ No newline at end of file diff --git a/build/article/gulp/index.html b/build/article/gulp/index.html index 2d47fad..b16eb0a 100644 --- a/build/article/gulp/index.html +++ b/build/article/gulp/index.html @@ -19,9 +19,6 @@
    - -
    - - -
    -
    @@ -63,15 +57,6 @@
  • Usage options
  • -
  • - Gotchas -
  • -
  • - Gulp -
  • -
  • - Future publication -
  • @@ -116,11 +101,7 @@ gulp.task('html', function() { @@ -128,19 +109,19 @@ gulp.task('html', function() { +
    - \ No newline at end of file diff --git a/build/article/index.html b/build/article/index.html index 918037c..f4faf94 100644 --- a/build/article/index.html +++ b/build/article/index.html @@ -19,9 +19,6 @@
    - -
    - - -
    -
    @@ -63,15 +57,6 @@
  • Usage options
  • -
  • - Gotchas -
  • -
  • - Gulp -
  • -
  • - Future publication -
  • @@ -97,52 +82,25 @@

    What type of project could benefit from Metalsmith?

    -
  • - - -

    Gotchas

    - - -

    Issues and workarounds when using Metalsmith.

    -
    -
  • -
  • - - -

    Gulp

    - - -

    Do you need Gulp? Can it be integrated with Metalsmith?

    -
    -
  • -
  • - - -

    Future publication

    - - -

    This article will be published after 1 March, 2016.

    -
    -
  • +
    - \ No newline at end of file diff --git a/build/article/usage/index.html b/build/article/usage/index.html index d2349ed..e4cf1a3 100644 --- a/build/article/usage/index.html +++ b/build/article/usage/index.html @@ -19,9 +19,6 @@
    - -
    - - -
    -
    @@ -63,15 +57,6 @@
  • Usage options
  • -
  • - Gotchas -
  • -
  • - Gulp -
  • -
  • - Future publication -
  • @@ -103,7 +88,7 @@
  • « back: Articles
  • -
  • +
  • @@ -112,19 +97,19 @@ +
    - \ No newline at end of file diff --git a/build/boxes/index.html b/build/boxes/index.html index 8de75b9..fe3148c 100644 --- a/build/boxes/index.html +++ b/build/boxes/index.html @@ -19,9 +19,6 @@
    - -
    - - -
    -
    diff --git a/build/contact/index.html b/build/contact/index.html index 1387c71..692f2c2 100644 --- a/build/contact/index.html +++ b/build/contact/index.html @@ -19,9 +19,6 @@
    - -
    - - -
    -
    diff --git a/build/css/styles.css b/build/css/styles.css index 8bff457..ca4d4cc 100644 --- a/build/css/styles.css +++ b/build/css/styles.css @@ -15,30 +15,19 @@ *, *:before, *:after { - box-sizing: border-box; + box-sizing: inherit; padding: 0; margin: 0; } body { - /* font-family: georgia, cambria, "times new roman", times, serif; */ font-family: 'Open Sans', sans-serif; font-size: 1.05em; - /* only with position static text will auto-format when making window smaller */ - /* position: relative; */ - /* margin-top: 60px; */ - /* margin-left: 310px; */ - /* TODO: not sure this is clean solution */ - /* set background-color for all parts default, specially below content */ - /* background-color: #f7f2ea; */ - /* color: #111833; */ line-height: 1.5; - /* TODO: put footer at bottom - https://stackoverflow.com/questions/643879/css-to-make-html-page-footer-stay-at-bottom-of-the-page-with-a-minimum-height-b */ - /* min-height: 100%; */ - /* TODO: repair, only scrolling in body possible */ - overflow: auto; - /* padding-top: 30px; */ + box-sizing: border-box; + min-height: 100vh; + display: flex; + flex-direction: column; } article, @@ -185,20 +174,18 @@ p.articleinfo { color: #111833; } - /* layout */ main { /* for page and article template */ clear: both; background-color: #fff; - margin-top: 60px; - /* margin-bottom: 0; */ background-color: #f7f2ea; - /* min-height: 100%; */ - /* min-width: 100%; */ overflow: auto; min-height: 100%; + display: flex; + flex-direction: column; + flex-grow: 1; } .content { @@ -217,9 +204,10 @@ article { /* this only applys to
    while .content is also applied */ /* for page and article template */ /* Distance left, right 4em */ - padding: 0 4em; + padding: 0 1em; /* Distance top 2em for content */ padding-top: 2em; + flex-grow: 1; } article a:link, @@ -233,31 +221,19 @@ article a:hover { } header { - /* header global */ - clear: both; - width: 100%; - /* eg can overwrite value for "if desktop" below */ - height: 60px; - overflow: auto; background-color: #111833; border-bottom: solid; color: #66fcf1; + display: flex; + flex-direction: column; + padding: 7px 1em 0; } footer { /* footer global */ - /* TODO: move footer bottom when article not end of page */ clear: both; - /* width: 100%; */ - margin-left: 310px; - height: 70px; - /* margin-top: -70px; */ - /* overflow: auto; */ background-color: #f7f2ea; -} - -footer { - /* font-family: 'Open Sans', sans-serif; */ + margin-top: 2em; font-size: 0.90em; padding: 1em; text-align: center; @@ -336,39 +312,52 @@ footer a:hover { border-bottom: 1px solid #ccc; } +.subpages .nav.sub { + background-color: #111833; + color: #fff; +} + @media (min-width: 16em) { .nav li { flex: 1 1 50%; } } -@media (min-width: 32em) { +main > .content { + display: flex; + flex-direction: column; + flex-grow: 1; + padding-top: 0; +} + +/* styles.css | http://localhost:3000/css/styles.css */ + +@media (min-width: 50em) { header { /* header global */ position: fixed; - /* defined global above */ - /* height: 60px; */ + flex-direction: row; + align-items: center; + width: 100%; + height: 60px; top: 0; - } - .logo { - float: left; - margin-left: 20px; + padding: 0 1em; } .nav.main { - float: right; + margin-left: auto; margin-right: 20px; } .nav li { flex: 1 1 auto; } .nav.main li { - width: 6em; + padding: 0 0.5em; } main { /* global template */ /* position: static; */ - /* margin-top: 60px; */ - /* min-height: 100%; */ + padding-top: 60px; + min-height: 100%; /* margin: 0px 0px 0px 0px; */ /* padding: 3em 0em 2em 0em; */ /* overflow: auto; */ @@ -389,18 +378,15 @@ footer a:hover { } .subpages .nav.sub { /* article template */ - height: 100%; width: 310px; position: fixed; /* z-index: 1; */ - top: 0; + top: 60px; left: 0; - background-color: #111833; + bottom: 0; overflow-x: hidden; overflow-y: scroll; - padding-top: 40px; - margin-top: 60px; - color: #fff; + padding-top: 20px; } .nav.sub ul { /* margin-top: 1em; */ @@ -427,4 +413,8 @@ footer a:hover { .nav.page a.next { text-align: right; } -} \ No newline at end of file + article { + padding-left: 4em; + padding-right: 4em; + } +} diff --git a/build/docs/build/index.html b/build/docs/build/index.html index 88da906..fb4ac83 100644 --- a/build/docs/build/index.html +++ b/build/docs/build/index.html @@ -19,9 +19,6 @@
    - -
    - - -
    -
    @@ -85,7 +79,7 @@

    Build

    - +

    To build and launch the site in a test server using Browsersync:

    @@ -102,7 +96,7 @@
  • « back: Installation
  • -
  • +
  • @@ -111,19 +105,19 @@ +
    - \ No newline at end of file diff --git a/build/docs/index.html b/build/docs/index.html index 3056d71..aa77d64 100644 --- a/build/docs/index.html +++ b/build/docs/index.html @@ -19,9 +19,6 @@
    - -
    - - -
    -
    @@ -95,7 +89,7 @@

    Installation

    - +

    How to install this demonstration code.

    @@ -104,7 +98,7 @@

    Build

    - +

    How to build the static site using Metalsmith.

    @@ -113,7 +107,7 @@

    Site files

    - +

    A description of the source files used to build a website

    @@ -122,7 +116,7 @@

    Page definitions

    - +

    How pages are defined in the source folder.

    @@ -131,7 +125,7 @@

    Custom plugins

    - +

    The custom plugins used to create this website.

    @@ -142,19 +136,19 @@ +
    - \ No newline at end of file diff --git a/build/docs/installation/index.html b/build/docs/installation/index.html index cdb09dc..c77299f 100644 --- a/build/docs/installation/index.html +++ b/build/docs/installation/index.html @@ -19,9 +19,6 @@
    - -
    - - -
    -
    @@ -85,7 +79,7 @@

    Installation

    - +

    Please ensure Node.js and Git are installed on your system.

    @@ -102,7 +96,7 @@
  • « back: docs
  • -
  • +
  • @@ -111,19 +105,19 @@ +
    - \ No newline at end of file diff --git a/build/docs/page-definitions/index.html b/build/docs/page-definitions/index.html index f391ea5..c74bfca 100644 --- a/build/docs/page-definitions/index.html +++ b/build/docs/page-definitions/index.html @@ -19,9 +19,6 @@
    - -
    - - -
    -
    @@ -85,7 +79,7 @@

    Page definitions

    - +

    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.

    @@ -116,7 +110,7 @@ date: 2016-06-01
  • « back: Site files
  • -
  • +
  • @@ -125,19 +119,19 @@ date: 2016-06-01 +
    - \ No newline at end of file diff --git a/build/docs/plugins/index.html b/build/docs/plugins/index.html index fdd97b3..010ad76 100644 --- a/build/docs/plugins/index.html +++ b/build/docs/plugins/index.html @@ -19,9 +19,6 @@
    - -
    - - -
    -
    @@ -85,7 +79,7 @@

    Custom plugins

    - +

    The build.js file defines how the site is built using Metalsmith and various plugins.

    @@ -104,6 +98,8 @@
  • « back: Page definitions
  • +
  • +

    @@ -111,19 +107,19 @@ +
    - \ No newline at end of file diff --git a/build/docs/site-files/index.html b/build/docs/site-files/index.html index 39e7fad..18cb08e 100644 --- a/build/docs/site-files/index.html +++ b/build/docs/site-files/index.html @@ -19,9 +19,6 @@
    - -
    - - -
    -
    @@ -85,7 +79,7 @@

    Site files

    - +

    All files in the src folder can be edited:

    @@ -104,7 +98,7 @@
  • « back: Build
  • -
  • +
  • @@ -113,19 +107,19 @@ +
    - \ No newline at end of file diff --git a/build/index.html b/build/index.html index 0baf25a..e10d181 100644 --- a/build/index.html +++ b/build/index.html @@ -19,9 +19,6 @@
    - -
    - - -
    -
    diff --git a/build/rss.xml b/build/rss.xml index 709f831..8a26d2b 100644 --- a/build/rss.xml +++ b/build/rss.xml @@ -1,4 +1,1606 @@ -<![CDATA[dashdevs-suite]]>http://127.0.0.1metalsmith-feedFri, 06 Mar 2020 18:42:28 GMT<![CDATA[Articles]]> +<![CDATA[dashdevs-suite]]>http://127.0.0.1metalsmith-feedSun, 08 Mar 2020 19:51:19 GMT<![CDATA[Articles]]> + + + + + Articles - dashdevs-suite + + + + + + + + + + + + + + +
    + + + +
    + +
    + +
    + + + + + + + + + +
    + +
    + + + +]]>
    http://127.0.0.1/articlehttp://127.0.0.1/articleSun, 08 Mar 2020 18:53:40 GMT
    <![CDATA[Articles]]> + + + + + Articles - dashdevs-suite + + + + + + + + + + + + + + +
    + + + +
    + +
    + +
    + + + + + + + + + +
    + +
    + + + +]]>
    http://127.0.0.1/articlehttp://127.0.0.1/articleSun, 08 Mar 2020 18:53:40 GMT
    <![CDATA[Articles]]> + + + + + Articles - dashdevs-suite + + + + + + + + + + + + + + +
    + + + +
    + +
    + +
    + + + + + + + + + +
    + +
    + + + +]]>
    http://127.0.0.1/articlehttp://127.0.0.1/articleSun, 08 Mar 2020 18:53:40 GMT
    <![CDATA[Articles]]> + + + + + Articles - dashdevs-suite + + + + + + + + + + + + + + +
    + + + +
    + +
    + +
    + + + + + + + + + +
    + +
    + + + +]]>
    http://127.0.0.1/articlehttp://127.0.0.1/articleSun, 08 Mar 2020 18:53:40 GMT
    <![CDATA[Articles]]> + + + + + Articles - dashdevs-suite + + + + + + + + + + + + + + +
    + + + +
    + +
    + +
    + + + + + + + + + +
    + +
    + + + +]]>
    http://127.0.0.1/articlehttp://127.0.0.1/articleSun, 08 Mar 2020 18:53:40 GMT
    <![CDATA[Articles]]> + + + + + Articles - dashdevs-suite + + + + + + + + + + + + + + +
    + + + +
    + +
    + +
    + + + + + + + + + +
    + +
    + + + +]]>
    http://127.0.0.1/articlehttp://127.0.0.1/articleSun, 08 Mar 2020 18:53:40 GMT
    <![CDATA[Articles]]> + + + + + Articles - dashdevs-suite + + + + + + + + + + + + + + +
    + + + +
    + +
    + +
    + + + + + + + + + +
    + +
    + + + +]]>
    http://127.0.0.1/articlehttp://127.0.0.1/articleSun, 08 Mar 2020 18:53:40 GMT
    <![CDATA[Articles]]> + + + + + Articles - dashdevs-suite + + + + + + + + + + + + + + +
    + + + +
    + +
    + +
    + + + + + + + + + +
    + +
    + + + +]]>
    http://127.0.0.1/articlehttp://127.0.0.1/articleSun, 08 Mar 2020 18:53:40 GMT
    <![CDATA[Articles]]> + + + + + Articles - dashdevs-suite + + + + + + + + + + + + + + +
    + +
    + + + + + +
    + +
    + +
    + +
    + + + + + + + + + +
    + +
    + + + +]]>
    http://127.0.0.1/articlehttp://127.0.0.1/articleSun, 08 Mar 2020 18:53:40 GMT
    <![CDATA[Articles]]> + + + + + Articles - dashdevs-suite + + + + + + + + + + + + + + +
    + +
    + + + + + +
    + +
    + +
    + +
    + + + + + + + + + +
    + +
    + + + +]]>
    http://127.0.0.1/articlehttp://127.0.0.1/articleSun, 08 Mar 2020 18:53:40 GMT
    <![CDATA[Articles]]> + + + + + Articles - dashdevs-suite + + + + + + + + + + + + + + +
    + +
    + + + + + +
    + +
    + +
    + +
    + + + + + + + + + +
    + +
    + + + +]]>
    http://127.0.0.1/articlehttp://127.0.0.1/articleSun, 08 Mar 2020 18:53:40 GMT
    <![CDATA[Articles]]> + + + + + Articles - dashdevs-suite + + + + + + + + + + + + + + +
    + +
    + + + + + +
    + +
    + +
    + +
    + + + + + + + + + +
    + +
    + + + +]]>
    http://127.0.0.1/articlehttp://127.0.0.1/articleSun, 08 Mar 2020 18:53:40 GMT
    <![CDATA[Articles]]> + + + + + Articles - dashdevs-suite + + + + + + + + + + + + + + +
    + +
    + + + + + +
    + +
    + +
    + +
    + + + + + + + + + +
    + +
    + + + +]]>
    http://127.0.0.1/articlehttp://127.0.0.1/articleSun, 08 Mar 2020 18:53:40 GMT
    <![CDATA[Articles]]> + + + + + Articles - dashdevs-suite + + + + + + + + + + + + + + +
    + +
    + + + + + +
    + +
    + +
    + + + +
    + + + + +]]>
    http://127.0.0.1/articlehttp://127.0.0.1/articleSun, 08 Mar 2020 18:53:40 GMT
    <![CDATA[Articles]]> @@ -145,13 +1747,13 @@ -]]>http://127.0.0.1/articlehttp://127.0.0.1/articleWed, 26 Feb 2020 15:41:33 GMT<![CDATA[Usage options]]> +]]>http://127.0.0.1/articlehttp://127.0.0.1/articleSun, 08 Mar 2020 18:53:40 GMT<![CDATA[Articles]]> - Usage options - dashdevs-suite - + Articles - dashdevs-suite + @@ -160,7 +1762,7 @@ - + @@ -169,27 +1771,27 @@
    - + @@ -208,16 +1810,16 @@ @@ -226,35 +1828,53 @@
    -

    Usage options

    +

    Articles

    - - - -

    Metalsmith could be used to create any number of resources, including:

    -
      -
    • a fast static website with minimal server-side requirements
    • -
    • technical documentation
    • -
    • an eBook
    • -
    • application prototypes
    • -
    • build tools or project scaffolding
    • -
    -

    The markdown files can be converted to other files types using plugins such as metalsmith-pandoc or metalsmith-pdf.

    +

    A selection of articles is available in this section.

    -
    @@ -274,13 +1894,13 @@ -]]>http://127.0.0.1/article/usagehttp://127.0.0.1/article/usageMon, 14 Mar 2016 00:00:00 GMT<![CDATA[Gotchas]]> +]]>http://127.0.0.1/articlehttp://127.0.0.1/articleSun, 08 Mar 2020 18:53:40 GMT<![CDATA[Articles]]> - Gotchas - dashdevs-suite - + Articles - dashdevs-suite + @@ -289,7 +1909,7 @@ - + @@ -298,27 +1918,27 @@
    - + @@ -337,16 +1957,16 @@ @@ -355,34 +1975,53 @@
    -

    Gotchas

    +

    Articles

    - - - -

    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.

    +

    A selection of articles is available in this section.

    -
    @@ -402,13 +2041,13 @@ -]]>http://127.0.0.1/article/gotchashttp://127.0.0.1/article/gotchasThu, 10 Mar 2016 00:00:00 GMT<![CDATA[Gulp]]> +]]>http://127.0.0.1/articlehttp://127.0.0.1/articleSun, 08 Mar 2020 18:53:40 GMT<![CDATA[Articles]]> - Gulp - dashdevs-suite - + Articles - dashdevs-suite + @@ -417,7 +2056,7 @@ - + @@ -426,27 +2065,27 @@
    - + @@ -465,16 +2104,16 @@ @@ -483,51 +2122,53 @@
    -

    Gulp

    +

    Articles

    - - - -

    Metalsmith has plugins for CSS pre-processing with Sass, image minification, file concatenation, uglification and more. The build code will be familiar to anyone with Gulp experience.

    -

    Do you still need Gulp?

    -

    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 can be used within any Gulp task, e.g.

    -
    var
    -    gulp       = require('gulp'),
    -    metalsmith = require('metalsmith'),
    -    publish    = require('metalsmith-publish'),
    -    markdown   = require('metalsmith-markdown');
    -
    -// build HTML files using Metalsmith
    -gulp.task('html', function() {
    -
    -    var ms = metalsmith(dir.base)
    -        .clean(false)
    -        .source('src/html/')
    -        .destination('build')
    -        .use(publish())
    -        .use(markdown())
    -        .build(function(err) {
    -            if (err) throw err;
    -        });
    -
    -});

    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.

    +

    A selection of articles is available in this section.

    -
    @@ -547,13 +2188,13 @@ gulp.task('html', function() { -]]>http://127.0.0.1/article/gulphttp://127.0.0.1/article/gulpWed, 02 Mar 2016 00:00:00 GMT<![CDATA[Future publication]]> +]]>http://127.0.0.1/articlehttp://127.0.0.1/articleSun, 08 Mar 2020 18:53:40 GMT<![CDATA[Articles]]> - Future publication - dashdevs-suite - + Articles - dashdevs-suite + @@ -562,7 +2203,7 @@ gulp.task('html', function() { - + @@ -571,27 +2212,27 @@ gulp.task('html', function() {
    - + @@ -610,16 +2251,16 @@ gulp.task('html', function() { @@ -628,25 +2269,53 @@ gulp.task('html', function() {
    -

    Future publication

    +

    Articles

    - - - -

    This article will only appear if the site is built is run after 1 March, 2016.

    +

    A selection of articles is available in this section.

    -
    @@ -666,4 +2335,151 @@ gulp.task('html', function() { -]]>http://127.0.0.1/article/futurehttp://127.0.0.1/article/futureTue, 01 Mar 2016 00:00:00 GMT \ No newline at end of file +]]>http://127.0.0.1/articlehttp://127.0.0.1/articleSun, 08 Mar 2020 18:53:40 GMT<![CDATA[Articles]]> + + + + + Articles - dashdevs-suite + + + + + + + + + + + + + + +
    + +
    + + + + + +
    + +
    + +
    + + + +
    + + + + +]]>
    http://127.0.0.1/articlehttp://127.0.0.1/articleSun, 08 Mar 2020 18:53:40 GMT
    \ No newline at end of file diff --git a/build/sitemap.xml b/build/sitemap.xml index fd9e60c..df19c0a 100644 --- a/build/sitemap.xml +++ b/build/sitemap.xml @@ -3,9 +3,9 @@ http://127.0.0.1/ 1.0 http://127.0.0.1/article/future/ http://127.0.0.1/article/gotchas/ - http://127.0.0.1/article/gulp/ http://127.0.0.1/article/ 0.8 http://127.0.0.1/article/usage/ + http://127.0.0.1/article/gulp/ http://127.0.0.1/boxes/ 0.6 http://127.0.0.1/contact/ 0.5 http://127.0.0.1/docs/build/ 0.5 diff --git a/build/tutorials/index.html b/build/tutorials/index.html index eef9e19..35bab5c 100644 --- a/build/tutorials/index.html +++ b/build/tutorials/index.html @@ -19,9 +19,6 @@
    - -
    - - -
    -