mirror of
https://github.com/seigler/dashdev-website
synced 2025-07-27 06:46:09 +00:00
initial commit
This commit is contained in:
readme
commit
9169024ff0
60 changed files with 8596 additions and 0 deletions
113
build/article/draft/index.html
Normal file
113
build/article/draft/index.html
Normal file
|
|
@ -0,0 +1,113 @@
|
|||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<title>Draft article - dashdev-website</title>
|
||||
<meta name="description" content="An unpublished article." />
|
||||
|
||||
<meta name="HandheldFriendly" content="true">
|
||||
<meta name="MobileOptimized" content="320">
|
||||
<meta name="viewport" content="width=device-width,shrink-to-fit=no,user-scalable=no,initial-scale=1,minimum-scale=1,minimal-ui">
|
||||
<meta name="apple-mobile-web-app-capable" content="yes">
|
||||
<meta name="apple-mobile-web-app-status-bar-style" content="black">
|
||||
<meta name="mobile-web-app-capable" content="yes">
|
||||
|
||||
<link rel="stylesheet" media="all" href="../../css/styles.css" />
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<header>
|
||||
|
||||
<div class="content">
|
||||
|
||||
<p class="logo"><a href="../../">dashdev-website</a></p>
|
||||
<!-- main navigation -->
|
||||
<nav class="nav main">
|
||||
<ul>
|
||||
<li>
|
||||
<a href="../../">Home</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/">Start</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/" class="active">Articles</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../contact/">Contact</a>
|
||||
</li>
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
</header>
|
||||
|
||||
<main class="subpages">
|
||||
|
||||
<div class="content">
|
||||
|
||||
<article>
|
||||
|
||||
<h1>Draft article</h1>
|
||||
|
||||
|
||||
<p class="articleinfo">Published , words, -minute read</p>
|
||||
|
||||
|
||||
<p>This is a draft article.</p>
|
||||
<p>It will never appear in the site unless the <code>publish</code> front-matter is set to <code>published</code> or a date which has passed.</p>
|
||||
|
||||
|
||||
|
||||
<nav class="nav page">
|
||||
<ul>
|
||||
|
||||
<li><a href="../../article/future/" class="back">« back: Future publication</a></li></p>
|
||||
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
|
||||
</article>
|
||||
|
||||
|
||||
<!-- sub navigation -->
|
||||
<nav class="nav sub">
|
||||
<ul>
|
||||
|
||||
<li>
|
||||
<a href="../../article/usage/">Usage options</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/gotchas/">Gotchas</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/gulp/">Gulp</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/future/">Future publication</a>
|
||||
</li>
|
||||
<li>
|
||||
<strong>Draft article</strong>
|
||||
</li>
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
</main>
|
||||
|
||||
<footer>
|
||||
|
||||
<p>By <a href="https://chat.dashdevs.org">dashdevs</a> and featured on <a href="http://www.dashdevs.org/">DashDevs.org</a></p>
|
||||
|
||||
<p class="siteinfo">Development build, version 1.0.0, article template</p>
|
||||
|
||||
</footer>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
113
build/article/future/index.html
Normal file
113
build/article/future/index.html
Normal file
|
|
@ -0,0 +1,113 @@
|
|||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<title>Future publication - dashdev-website</title>
|
||||
<meta name="description" content="This article will be published after 1 March, 2016." />
|
||||
|
||||
<meta name="HandheldFriendly" content="true">
|
||||
<meta name="MobileOptimized" content="320">
|
||||
<meta name="viewport" content="width=device-width,shrink-to-fit=no,user-scalable=no,initial-scale=1,minimum-scale=1,minimal-ui">
|
||||
<meta name="apple-mobile-web-app-capable" content="yes">
|
||||
<meta name="apple-mobile-web-app-status-bar-style" content="black">
|
||||
<meta name="mobile-web-app-capable" content="yes">
|
||||
|
||||
<link rel="stylesheet" media="all" href="../../css/styles.css" />
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<header>
|
||||
|
||||
<div class="content">
|
||||
|
||||
<p class="logo"><a href="../../">dashdev-website</a></p>
|
||||
<!-- main navigation -->
|
||||
<nav class="nav main">
|
||||
<ul>
|
||||
<li>
|
||||
<a href="../../">Home</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/">Start</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/" class="active">Articles</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../contact/">Contact</a>
|
||||
</li>
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
</header>
|
||||
|
||||
<main class="subpages">
|
||||
|
||||
<div class="content">
|
||||
|
||||
<article>
|
||||
|
||||
<h1>Future publication</h1>
|
||||
|
||||
|
||||
<p class="articleinfo">Published , words, -minute read</p>
|
||||
|
||||
|
||||
<p>This article will only appear if the site is built is run after 1 March, 2016.</p>
|
||||
|
||||
|
||||
|
||||
<nav class="nav page">
|
||||
<ul>
|
||||
|
||||
<li><a href="../../article/gulp/" class="back">« back: Gulp</a></li></p>
|
||||
|
||||
<li><a href="../../article/draft/" class="next">next: Draft article »</a></li></p>
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
|
||||
</article>
|
||||
|
||||
|
||||
<!-- sub navigation -->
|
||||
<nav class="nav sub">
|
||||
<ul>
|
||||
|
||||
<li>
|
||||
<a href="../../article/usage/">Usage options</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/gotchas/">Gotchas</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/gulp/">Gulp</a>
|
||||
</li>
|
||||
<li>
|
||||
<strong>Future publication</strong>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/draft/">Draft article</a>
|
||||
</li>
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
</main>
|
||||
|
||||
<footer>
|
||||
|
||||
<p>By <a href="https://chat.dashdevs.org">dashdevs</a> and featured on <a href="http://www.dashdevs.org/">DashDevs.org</a></p>
|
||||
|
||||
<p class="siteinfo">Development build, version 1.0.0, article template</p>
|
||||
|
||||
</footer>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
120
build/article/gotchas/index.html
Normal file
120
build/article/gotchas/index.html
Normal file
|
|
@ -0,0 +1,120 @@
|
|||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<title>Gotchas - dashdev-website</title>
|
||||
<meta name="description" content="Issues and workarounds when using Metalsmith." />
|
||||
|
||||
<meta name="HandheldFriendly" content="true">
|
||||
<meta name="MobileOptimized" content="320">
|
||||
<meta name="viewport" content="width=device-width,shrink-to-fit=no,user-scalable=no,initial-scale=1,minimum-scale=1,minimal-ui">
|
||||
<meta name="apple-mobile-web-app-capable" content="yes">
|
||||
<meta name="apple-mobile-web-app-status-bar-style" content="black">
|
||||
<meta name="mobile-web-app-capable" content="yes">
|
||||
|
||||
<link rel="stylesheet" media="all" href="../../css/styles.css" />
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<header>
|
||||
|
||||
<div class="content">
|
||||
|
||||
<p class="logo"><a href="../../">dashdev-website</a></p>
|
||||
<!-- main navigation -->
|
||||
<nav class="nav main">
|
||||
<ul>
|
||||
<li>
|
||||
<a href="../../">Home</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/">Start</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/" class="active">Articles</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../contact/">Contact</a>
|
||||
</li>
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
</header>
|
||||
|
||||
<main class="subpages">
|
||||
|
||||
<div class="content">
|
||||
|
||||
<article>
|
||||
|
||||
<h1>Gotchas</h1>
|
||||
|
||||
|
||||
<p class="articleinfo">Published , words, -minute read</p>
|
||||
|
||||
|
||||
<p>Not everything is necessarily straight-forward in the Metalsmith world…</p>
|
||||
<h2 id="incompatible-plugins">Incompatible plugins</h2>
|
||||
<p>Some plugins clash with another. For example, <a href="https://github.com/radiovisual/metalsmith-rootpath">metalsmith-rootpath</a> which calculates relative roots does not play nicely with <a href="https://github.com/segmentio/metalsmith-permalinks">metalsmith-permalinks</a> which creates custom folder structures.</p>
|
||||
<p><em>Note: <code>lib/metalsmith-moremeta</code> in this project sets a correct <code>root</code> variable whether permalinks are used or not.</em></p>
|
||||
<h2 id="plugin-order-can-be-critical">Plugin order can be critical</h2>
|
||||
<p>One plugins may depend on another or conflict if placed the wrong way around. For example, the RSS-generating <a href="https://github.com/hurrymaplelad/metalsmith-feed">metalsmith-feed</a> plugin must be called after <a href="https://github.com/superwolff/metalsmith-layouts">metalsmith-layouts</a> to ensure <code>rss.xml</code> is not generated within a page template.</p>
|
||||
<h2 id="browsersync-build-issues">Browsersync build issues</h2>
|
||||
<p>When <a href="https://www.browsersync.io/">Browsersync</a> 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.</p>
|
||||
|
||||
|
||||
|
||||
<nav class="nav page">
|
||||
<ul>
|
||||
|
||||
<li><a href="../../article/usage/" class="back">« back: Usage options</a></li></p>
|
||||
|
||||
<li><a href="../../article/" class="next">next: Articles »</a></li></p>
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
|
||||
</article>
|
||||
|
||||
|
||||
<!-- sub navigation -->
|
||||
<nav class="nav sub">
|
||||
<ul>
|
||||
|
||||
<li>
|
||||
<a href="../../article/usage/">Usage options</a>
|
||||
</li>
|
||||
<li>
|
||||
<strong>Gotchas</strong>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/gulp/">Gulp</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/future/">Future publication</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/draft/">Draft article</a>
|
||||
</li>
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
</main>
|
||||
|
||||
<footer>
|
||||
|
||||
<p>By <a href="https://chat.dashdevs.org">dashdevs</a> and featured on <a href="http://www.dashdevs.org/">DashDevs.org</a></p>
|
||||
|
||||
<p class="siteinfo">Development build, version 1.0.0, article template</p>
|
||||
|
||||
</footer>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
137
build/article/gulp/index.html
Normal file
137
build/article/gulp/index.html
Normal file
|
|
@ -0,0 +1,137 @@
|
|||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<title>Gulp - dashdev-website</title>
|
||||
<meta name="description" content="Do you need Gulp? Can it be integrated with Metalsmith?" />
|
||||
|
||||
<meta name="HandheldFriendly" content="true">
|
||||
<meta name="MobileOptimized" content="320">
|
||||
<meta name="viewport" content="width=device-width,shrink-to-fit=no,user-scalable=no,initial-scale=1,minimum-scale=1,minimal-ui">
|
||||
<meta name="apple-mobile-web-app-capable" content="yes">
|
||||
<meta name="apple-mobile-web-app-status-bar-style" content="black">
|
||||
<meta name="mobile-web-app-capable" content="yes">
|
||||
|
||||
<link rel="stylesheet" media="all" href="../../css/styles.css" />
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<header>
|
||||
|
||||
<div class="content">
|
||||
|
||||
<p class="logo"><a href="../../">dashdev-website</a></p>
|
||||
<!-- main navigation -->
|
||||
<nav class="nav main">
|
||||
<ul>
|
||||
<li>
|
||||
<a href="../../">Home</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/">Start</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/" class="active">Articles</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../contact/">Contact</a>
|
||||
</li>
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
</header>
|
||||
|
||||
<main class="subpages">
|
||||
|
||||
<div class="content">
|
||||
|
||||
<article>
|
||||
|
||||
<h1>Gulp</h1>
|
||||
|
||||
|
||||
<p class="articleinfo">Published , words, -minute read</p>
|
||||
|
||||
|
||||
<p>Metalsmith has plugins for <a href="https://github.com/stevenschobert/metalsmith-sass">CSS pre-processing with Sass</a>, <a href="https://github.com/ahmadnassri/metalsmith-imagemin">image minification</a>, <a href="https://github.com/aymericbeaumet/metalsmith-concat">file concatenation</a>, <a href="https://github.com/ksmithut/metalsmith-uglify">uglification</a> and more. The build code will be familiar to anyone with <a href="http://gulpjs.com/">Gulp</a> experience.</p>
|
||||
<h2 id="do-you-still-need-gulp">Do you still need Gulp?</h2>
|
||||
<p>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 <a href="http://postcss.org/">PostCSS</a> processing with <a href="https://github.com/postcss/autoprefixer">auto-prefixer</a>.</p>
|
||||
<p>Metalsmith can be used within any Gulp task, e.g.</p>
|
||||
<pre><code>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;
|
||||
});
|
||||
|
||||
});</code></pre><p>Further Gulp tasks can then be added. Note <code>.clean(false)</code> ensures Metalsmith never wipes the build folder when other tasks are active.</p>
|
||||
<p>There are a number of Gulp/Metalsmith integration plugins although they are rarely necessary.</p>
|
||||
|
||||
|
||||
|
||||
<nav class="nav page">
|
||||
<ul>
|
||||
|
||||
<li><a href="../../article/" class="back">« back: Articles</a></li></p>
|
||||
|
||||
<li><a href="../../article/future/" class="next">next: Future publication »</a></li></p>
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
|
||||
</article>
|
||||
|
||||
|
||||
<!-- sub navigation -->
|
||||
<nav class="nav sub">
|
||||
<ul>
|
||||
|
||||
<li>
|
||||
<a href="../../article/usage/">Usage options</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/gotchas/">Gotchas</a>
|
||||
</li>
|
||||
<li>
|
||||
<strong>Gulp</strong>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/future/">Future publication</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/draft/">Draft article</a>
|
||||
</li>
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
</main>
|
||||
|
||||
<footer>
|
||||
|
||||
<p>By <a href="https://chat.dashdevs.org">dashdevs</a> and featured on <a href="http://www.dashdevs.org/">DashDevs.org</a></p>
|
||||
|
||||
<p class="siteinfo">Development build, version 1.0.0, article template</p>
|
||||
|
||||
</footer>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
150
build/article/index.html
Normal file
150
build/article/index.html
Normal file
|
|
@ -0,0 +1,150 @@
|
|||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<title>Articles - dashdev-website</title>
|
||||
<meta name="description" content="A set of articles published on this site." />
|
||||
|
||||
<meta name="HandheldFriendly" content="true">
|
||||
<meta name="MobileOptimized" content="320">
|
||||
<meta name="viewport" content="width=device-width,shrink-to-fit=no,user-scalable=no,initial-scale=1,minimum-scale=1,minimal-ui">
|
||||
<meta name="apple-mobile-web-app-capable" content="yes">
|
||||
<meta name="apple-mobile-web-app-status-bar-style" content="black">
|
||||
<meta name="mobile-web-app-capable" content="yes">
|
||||
|
||||
<link rel="stylesheet" media="all" href="../css/styles.css" />
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<header>
|
||||
|
||||
<div class="content">
|
||||
|
||||
<p class="logo"><a href="../">dashdev-website</a></p>
|
||||
<!-- main navigation -->
|
||||
<nav class="nav main">
|
||||
<ul>
|
||||
<li>
|
||||
<a href="../">Home</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../start/">Start</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../article/" class="active">Articles</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../contact/">Contact</a>
|
||||
</li>
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
</header>
|
||||
|
||||
<main class="subpages">
|
||||
|
||||
<div class="content">
|
||||
|
||||
<article>
|
||||
|
||||
<h1>Articles</h1>
|
||||
|
||||
|
||||
<p>A selection of articles is available in this section.</p>
|
||||
|
||||
|
||||
|
||||
<ul class="pagelist">
|
||||
|
||||
<li>
|
||||
<a href="../article/usage/">
|
||||
|
||||
<h2>Usage options</h2>
|
||||
<p class="articleinfo"></p>
|
||||
|
||||
<p>What type of project could benefit from Metalsmith?</p>
|
||||
</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../article/gotchas/">
|
||||
|
||||
<h2>Gotchas</h2>
|
||||
<p class="articleinfo"></p>
|
||||
|
||||
<p>Issues and workarounds when using Metalsmith.</p>
|
||||
</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../article/gulp/">
|
||||
|
||||
<h2>Gulp</h2>
|
||||
<p class="articleinfo"></p>
|
||||
|
||||
<p>Do you need Gulp? Can it be integrated with Metalsmith?</p>
|
||||
</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../article/future/">
|
||||
|
||||
<h2>Future publication</h2>
|
||||
<p class="articleinfo"></p>
|
||||
|
||||
<p>This article will be published after 1 March, 2016.</p>
|
||||
</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../article/draft/">
|
||||
|
||||
<h2>Draft article</h2>
|
||||
<p class="articleinfo"></p>
|
||||
|
||||
<p>An unpublished article.</p>
|
||||
</a>
|
||||
</li>
|
||||
|
||||
</ul>
|
||||
|
||||
|
||||
</article>
|
||||
|
||||
|
||||
<!-- sub navigation -->
|
||||
<nav class="nav sub">
|
||||
<ul>
|
||||
|
||||
<li>
|
||||
<a href="../article/usage/">Usage options</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../article/gotchas/">Gotchas</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../article/gulp/">Gulp</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../article/future/">Future publication</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../article/draft/">Draft article</a>
|
||||
</li>
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
</main>
|
||||
|
||||
<footer>
|
||||
|
||||
<p>By <a href="https://chat.dashdevs.org">dashdevs</a> and featured on <a href="http://www.dashdevs.org/">DashDevs.org</a></p>
|
||||
|
||||
<p class="siteinfo">Development build, version 1.0.0, article template</p>
|
||||
|
||||
</footer>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
120
build/article/usage/index.html
Normal file
120
build/article/usage/index.html
Normal file
|
|
@ -0,0 +1,120 @@
|
|||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<title>Usage options - dashdev-website</title>
|
||||
<meta name="description" content="What type of project could benefit from Metalsmith?" />
|
||||
|
||||
<meta name="HandheldFriendly" content="true">
|
||||
<meta name="MobileOptimized" content="320">
|
||||
<meta name="viewport" content="width=device-width,shrink-to-fit=no,user-scalable=no,initial-scale=1,minimum-scale=1,minimal-ui">
|
||||
<meta name="apple-mobile-web-app-capable" content="yes">
|
||||
<meta name="apple-mobile-web-app-status-bar-style" content="black">
|
||||
<meta name="mobile-web-app-capable" content="yes">
|
||||
|
||||
<link rel="stylesheet" media="all" href="../../css/styles.css" />
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<header>
|
||||
|
||||
<div class="content">
|
||||
|
||||
<p class="logo"><a href="../../">dashdev-website</a></p>
|
||||
<!-- main navigation -->
|
||||
<nav class="nav main">
|
||||
<ul>
|
||||
<li>
|
||||
<a href="../../">Home</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/">Start</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/" class="active">Articles</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../contact/">Contact</a>
|
||||
</li>
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
</header>
|
||||
|
||||
<main class="subpages">
|
||||
|
||||
<div class="content">
|
||||
|
||||
<article>
|
||||
|
||||
<h1>Usage options</h1>
|
||||
|
||||
|
||||
<p class="articleinfo">Published , words, -minute read</p>
|
||||
|
||||
|
||||
<p>Metalsmith could be used to create any number of resources, including:</p>
|
||||
<ul>
|
||||
<li>a fast static website with minimal server-side requirements</li>
|
||||
<li>technical documentation</li>
|
||||
<li>an eBook</li>
|
||||
<li>application prototypes</li>
|
||||
<li>build tools or project scaffolding</li>
|
||||
</ul>
|
||||
<p>The markdown files can be converted to other files types using plugins such as <a href="https://github.com/arve0/metalsmith-pandoc">metalsmith-pandoc</a> or <a href="https://github.com/jjclark1982/metalsmith-pdf">metalsmith-pdf</a>.</p>
|
||||
|
||||
|
||||
|
||||
<nav class="nav page">
|
||||
<ul>
|
||||
|
||||
|
||||
<li><a href="../../article/gotchas/" class="next">next: Gotchas »</a></li></p>
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
|
||||
</article>
|
||||
|
||||
|
||||
<!-- sub navigation -->
|
||||
<nav class="nav sub">
|
||||
<ul>
|
||||
|
||||
<li>
|
||||
<strong>Usage options</strong>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/gotchas/">Gotchas</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/gulp/">Gulp</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/future/">Future publication</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/draft/">Draft article</a>
|
||||
</li>
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
</main>
|
||||
|
||||
<footer>
|
||||
|
||||
<p>By <a href="https://chat.dashdevs.org">dashdevs</a> and featured on <a href="http://www.dashdevs.org/">DashDevs.org</a></p>
|
||||
|
||||
<p class="siteinfo">Development build, version 1.0.0, article template</p>
|
||||
|
||||
</footer>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
74
build/contact/index.html
Normal file
74
build/contact/index.html
Normal file
|
|
@ -0,0 +1,74 @@
|
|||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<title>Contact - dashdev-website</title>
|
||||
|
||||
|
||||
<meta name="HandheldFriendly" content="true">
|
||||
<meta name="MobileOptimized" content="320">
|
||||
<meta name="viewport" content="width=device-width,shrink-to-fit=no,user-scalable=no,initial-scale=1,minimum-scale=1,minimal-ui">
|
||||
<meta name="apple-mobile-web-app-capable" content="yes">
|
||||
<meta name="apple-mobile-web-app-status-bar-style" content="black">
|
||||
<meta name="mobile-web-app-capable" content="yes">
|
||||
|
||||
<link rel="stylesheet" media="all" href="../css/styles.css" />
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<header>
|
||||
|
||||
<div class="content">
|
||||
|
||||
<p class="logo"><a href="../">dashdev-website</a></p>
|
||||
<!-- main navigation -->
|
||||
<nav class="nav main">
|
||||
<ul>
|
||||
<li>
|
||||
<a href="../">Home</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../start/">Start</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../article/">Articles</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../contact/" class="active">Contact</a>
|
||||
</li>
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
</header>
|
||||
|
||||
<main>
|
||||
|
||||
<div class="content">
|
||||
|
||||
<article>
|
||||
|
||||
<h1>Contact</h1>
|
||||
|
||||
<p>Any questions?</p>
|
||||
<p>Contact us at <a href="">Dash DApp Developers Discord</a></p>
|
||||
|
||||
|
||||
</article>
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
</main>
|
||||
|
||||
<footer>
|
||||
|
||||
<p>By <a href="https://chat.dashdevs.org">dashdevs</a> and featured on <a href="http://www.dashdevs.org/">DashDevs.org</a></p>
|
||||
|
||||
<p class="siteinfo">Development build, version 1.0.0, page template</p>
|
||||
|
||||
</footer>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
277
build/css/styles.css
Normal file
277
build/css/styles.css
Normal file
|
|
@ -0,0 +1,277 @@
|
|||
/* basic page styles */
|
||||
*, *:before, *:after {
|
||||
box-sizing: border-box;
|
||||
padding: 0;
|
||||
margin: 0;
|
||||
}
|
||||
|
||||
body {
|
||||
font-family: georgia, cambria, "times new roman", times, serif;
|
||||
font-size: 1em;
|
||||
color: #555;
|
||||
background-color: #eee;
|
||||
line-height: 1.5;
|
||||
}
|
||||
|
||||
article, aside, details, figcaption, figure, footer, header, main, nav, section, summary {
|
||||
display: block;
|
||||
}
|
||||
|
||||
h1, h2, .logo {
|
||||
font-family: arial, helvetica, free-sans, sans-serif;
|
||||
font-weight: normal;
|
||||
}
|
||||
|
||||
h1 {
|
||||
font-size: 1.6em;
|
||||
}
|
||||
|
||||
h2 {
|
||||
font-size: 1.4em;
|
||||
margin: 2rem 0 0 0;
|
||||
}
|
||||
|
||||
p {
|
||||
margin: 0 0 1em 0;
|
||||
}
|
||||
|
||||
ul, ol {
|
||||
margin: 1em 0 1.5em 3em;
|
||||
}
|
||||
|
||||
li {
|
||||
margin: 0 0 0.75em 0;
|
||||
}
|
||||
|
||||
img {
|
||||
float: right;
|
||||
width: auto;
|
||||
height: auto;
|
||||
max-width: 50%;
|
||||
margin: 0 0 1em 1em;
|
||||
border: 0 none;
|
||||
}
|
||||
|
||||
pre {
|
||||
font-size: 0.8rem;
|
||||
padding: 0.2em 0.4em;
|
||||
margin: 1em 0 1.5em 3em;
|
||||
background-color: #eff5ef;
|
||||
border-radius: 3px;
|
||||
overflow: auto;
|
||||
}
|
||||
|
||||
code {
|
||||
font-family: Consolas, Menlo, "DejaVu Mono", monospace;
|
||||
color: #363;
|
||||
background-color: #eff5ef;
|
||||
border-radius: 3px;
|
||||
padding: 0 0.2em;
|
||||
}
|
||||
|
||||
pre code {
|
||||
padding: 0;
|
||||
}
|
||||
|
||||
a:link, a:visited {
|
||||
text-decoration: none;
|
||||
color: #66c;
|
||||
}
|
||||
|
||||
a:hover, a:active {
|
||||
color: #c66;
|
||||
}
|
||||
|
||||
.pagelist {
|
||||
list-style-type: none;
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
margin: 0;
|
||||
line-height: 1.3;
|
||||
}
|
||||
|
||||
.pagelist li {
|
||||
flex: 1 1 45%;
|
||||
margin: 0 1em 1em 0;
|
||||
}
|
||||
|
||||
.pagelist a {
|
||||
display: block;
|
||||
height: 100%;
|
||||
padding: 5px 10px;
|
||||
border: 1px solid #ccc;
|
||||
outline: 0 none;
|
||||
overflow: hidden;
|
||||
}
|
||||
|
||||
.pagelist a:hover, .pagelist a:focus {
|
||||
background-color: #f9f9f9;
|
||||
border-color: #999;
|
||||
}
|
||||
|
||||
.pagelist h2, .pagelist p {
|
||||
margin: 0;
|
||||
}
|
||||
|
||||
.pagelist p {
|
||||
color: #333;
|
||||
}
|
||||
|
||||
p.articleinfo {
|
||||
font-size: 0.8em;
|
||||
color: #777;
|
||||
}
|
||||
|
||||
/* layout */
|
||||
.content {
|
||||
max-width: 50em;
|
||||
padding: 0 0.5em;
|
||||
margin: 0 auto;
|
||||
}
|
||||
|
||||
main {
|
||||
clear: both;
|
||||
background-color: #fff;
|
||||
overflow: auto;
|
||||
}
|
||||
|
||||
article {
|
||||
padding: 1rem 0;
|
||||
}
|
||||
|
||||
header, footer {
|
||||
clear: both;
|
||||
width: 100%;
|
||||
overflow: auto;
|
||||
background-color: #eee;
|
||||
}
|
||||
|
||||
footer {
|
||||
font-size: 0.85em;
|
||||
padding: 1em;
|
||||
text-align: center;
|
||||
}
|
||||
|
||||
footer p {
|
||||
margin: 0;
|
||||
}
|
||||
|
||||
.logo {
|
||||
font-size: 1.5em;
|
||||
margin: 0.2em 0 0 0;
|
||||
}
|
||||
|
||||
.logo a {
|
||||
padding: 0.2em 0;
|
||||
color: #999;
|
||||
}
|
||||
|
||||
/* navigation */
|
||||
.nav ul {
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
list-style-type: none;
|
||||
margin: 0;
|
||||
}
|
||||
|
||||
.nav li {
|
||||
flex: 1 1 100%;
|
||||
margin: 0;
|
||||
}
|
||||
|
||||
.nav a, .nav strong {
|
||||
display: block;
|
||||
text-align: center;
|
||||
white-space: nowrap;
|
||||
padding: 0.6em 0;
|
||||
}
|
||||
|
||||
.nav.main a {
|
||||
color: #222;
|
||||
}
|
||||
|
||||
.nav a.active, .nav strong {
|
||||
background-color: #fff;
|
||||
}
|
||||
|
||||
.nav.page {
|
||||
margin-top: 1.5em;
|
||||
border-top: 1px solid #ccc;
|
||||
border-bottom: 1px solid #ccc;
|
||||
}
|
||||
|
||||
@media (min-width: 16em) {
|
||||
|
||||
.nav li {
|
||||
flex: 1 1 50%;
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
@media (min-width: 32em) {
|
||||
|
||||
header {
|
||||
position: fixed;
|
||||
top: 0;
|
||||
}
|
||||
|
||||
.logo {
|
||||
float: left;
|
||||
}
|
||||
|
||||
.nav.main {
|
||||
float: right;
|
||||
}
|
||||
|
||||
.nav li {
|
||||
flex: 1 1 auto;
|
||||
}
|
||||
|
||||
.nav.main li {
|
||||
width: 6em;
|
||||
}
|
||||
|
||||
main {
|
||||
padding: 3em 0 2em 0;
|
||||
}
|
||||
|
||||
.subpages .content {
|
||||
display: flex;
|
||||
}
|
||||
|
||||
.subpages article {
|
||||
flex: 1 1 70%;
|
||||
min-width: 0;
|
||||
}
|
||||
|
||||
.subpages .nav.sub {
|
||||
flex: 1 1 30%;
|
||||
margin: 0 0 0 2rem;
|
||||
}
|
||||
|
||||
.nav.sub ul {
|
||||
margin-top: 1em;
|
||||
flex-direction: column;
|
||||
border-top: 1px dotted #ccc;
|
||||
}
|
||||
|
||||
.nav.sub li {
|
||||
border-bottom: 1px dotted #ccc;
|
||||
}
|
||||
|
||||
.nav.sub a, .nav.sub strong {
|
||||
text-align: left;
|
||||
padding-left: 0.75em;
|
||||
}
|
||||
|
||||
.nav.page a {
|
||||
text-align: left;
|
||||
padding-left: 0.5em;
|
||||
padding-right: 0.5em;
|
||||
}
|
||||
|
||||
.nav.page a.next {
|
||||
text-align: right;
|
||||
}
|
||||
|
||||
}
|
||||
BIN
build/images/Dash-D-white_on_blue_circle.png
Normal file
BIN
build/images/Dash-D-white_on_blue_circle.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 32 KiB |
BIN
build/images/dash-D-blue.png
Normal file
BIN
build/images/dash-D-blue.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 9 KiB |
BIN
build/images/dash_logo_2018_black.png
Normal file
BIN
build/images/dash_logo_2018_black.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 42 KiB |
BIN
build/images/dash_logo_2018_rgb_for_screens.png
Normal file
BIN
build/images/dash_logo_2018_rgb_for_screens.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 42 KiB |
BIN
build/images/dash_logo_2018_white.png
Normal file
BIN
build/images/dash_logo_2018_white.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 39 KiB |
BIN
build/images/nodejs.png
Normal file
BIN
build/images/nodejs.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 5.5 KiB |
84
build/index.html
Normal file
84
build/index.html
Normal file
|
|
@ -0,0 +1,84 @@
|
|||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<title>dashdev-website</title>
|
||||
<meta name="description" content="A static HTML-only website generated using Metalsmith.io." />
|
||||
|
||||
<meta name="HandheldFriendly" content="true">
|
||||
<meta name="MobileOptimized" content="320">
|
||||
<meta name="viewport" content="width=device-width,shrink-to-fit=no,user-scalable=no,initial-scale=1,minimum-scale=1,minimal-ui">
|
||||
<meta name="apple-mobile-web-app-capable" content="yes">
|
||||
<meta name="apple-mobile-web-app-status-bar-style" content="black">
|
||||
<meta name="mobile-web-app-capable" content="yes">
|
||||
|
||||
<link rel="stylesheet" media="all" href="css/styles.css" />
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<header>
|
||||
|
||||
<div class="content">
|
||||
|
||||
<p class="logo"><a href="">dashdev-website</a></p>
|
||||
<!-- main navigation -->
|
||||
<nav class="nav main">
|
||||
<ul>
|
||||
<li>
|
||||
<a href="" class="active">Home</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="start/">Start</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="article/">Articles</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="contact/">Contact</a>
|
||||
</li>
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
</header>
|
||||
|
||||
<main>
|
||||
|
||||
<div class="content">
|
||||
|
||||
<article>
|
||||
|
||||
|
||||
<p><a href="http://dash.org/"><img src="/images/nodejs.png" alt="Node.js"></a></p>
|
||||
<p>This is a static website generated using the Node.js-powered <strong><a href="http://metalsmith.io">Metalsmith</a></strong> and various published and custom plugins.</p>
|
||||
<p>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.</p>
|
||||
<h2 id="where-could-you-use-metalsmith">Where could you use Metalsmith?</h2>
|
||||
<p>Metalsmith could be used to create:</p>
|
||||
<ul>
|
||||
<li>a fast static website with minimal server-side requirements</li>
|
||||
<li>technical documentation</li>
|
||||
<li>an eBook</li>
|
||||
<li>application prototypes</li>
|
||||
<li>build tools or project scaffolding</li>
|
||||
</ul>
|
||||
<p><a href="start/">Get started…</a></p>
|
||||
|
||||
|
||||
</article>
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
</main>
|
||||
|
||||
<footer>
|
||||
|
||||
<p>By <a href="https://chat.dashdevs.org">dashdevs</a> and featured on <a href="http://www.dashdevs.org/">DashDevs.org</a></p>
|
||||
|
||||
<p class="siteinfo">Development build, version 1.0.0, page template</p>
|
||||
|
||||
</footer>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
17
build/sitemap.xml
Normal file
17
build/sitemap.xml
Normal file
|
|
@ -0,0 +1,17 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:news="http://www.google.com/schemas/sitemap-news/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml" xmlns:mobile="http://www.google.com/schemas/sitemap-mobile/1.0" xmlns:image="http://www.google.com/schemas/sitemap-image/1.1" xmlns:video="http://www.google.com/schemas/sitemap-video/1.1">
|
||||
<url> <loc>http://127.0.0.1/</loc> <priority>1.0</priority> </url>
|
||||
<url> <loc>http://127.0.0.1/article/draft/</loc> </url>
|
||||
<url> <loc>http://127.0.0.1/article/future/</loc> </url>
|
||||
<url> <loc>http://127.0.0.1/article/gotchas/</loc> </url>
|
||||
<url> <loc>http://127.0.0.1/article/gulp/</loc> </url>
|
||||
<url> <loc>http://127.0.0.1/article/</loc> <priority>0.8</priority> </url>
|
||||
<url> <loc>http://127.0.0.1/article/usage/</loc> </url>
|
||||
<url> <loc>http://127.0.0.1/contact/</loc> <priority>0.7</priority> </url>
|
||||
<url> <loc>http://127.0.0.1/start/build/</loc> <priority>0.5</priority> </url>
|
||||
<url> <loc>http://127.0.0.1/start/</loc> <priority>0.9</priority> </url>
|
||||
<url> <loc>http://127.0.0.1/start/installation/</loc> <priority>0.5</priority> </url>
|
||||
<url> <loc>http://127.0.0.1/start/page-definitions/</loc> <priority>0.3</priority> </url>
|
||||
<url> <loc>http://127.0.0.1/start/plugins/</loc> <priority>0.3</priority> </url>
|
||||
<url> <loc>http://127.0.0.1/start/site-files/</loc> <priority>0.4</priority> </url>
|
||||
</urlset>
|
||||
117
build/start/build/index.html
Normal file
117
build/start/build/index.html
Normal file
|
|
@ -0,0 +1,117 @@
|
|||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<title>Build - dashdev-website</title>
|
||||
<meta name="description" content="How to build the static site using Metalsmith." />
|
||||
|
||||
<meta name="HandheldFriendly" content="true">
|
||||
<meta name="MobileOptimized" content="320">
|
||||
<meta name="viewport" content="width=device-width,shrink-to-fit=no,user-scalable=no,initial-scale=1,minimum-scale=1,minimal-ui">
|
||||
<meta name="apple-mobile-web-app-capable" content="yes">
|
||||
<meta name="apple-mobile-web-app-status-bar-style" content="black">
|
||||
<meta name="mobile-web-app-capable" content="yes">
|
||||
|
||||
<link rel="stylesheet" media="all" href="../../css/styles.css" />
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<header>
|
||||
|
||||
<div class="content">
|
||||
|
||||
<p class="logo"><a href="../../">dashdev-website</a></p>
|
||||
<!-- main navigation -->
|
||||
<nav class="nav main">
|
||||
<ul>
|
||||
<li>
|
||||
<a href="../../">Home</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/" class="active">Start</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/">Articles</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../contact/">Contact</a>
|
||||
</li>
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
</header>
|
||||
|
||||
<main class="subpages">
|
||||
|
||||
<div class="content">
|
||||
|
||||
<article>
|
||||
|
||||
<h1>Build</h1>
|
||||
|
||||
|
||||
<p class="articleinfo">Published , words, -minute read</p>
|
||||
|
||||
|
||||
<p>To build and launch the site in a test server using <a href="https://www.browsersync.io/">Browsersync</a>:</p>
|
||||
<pre><code>npm start</code></pre><p>(Stop the server with <code>Ctrl+C</code>.)</p>
|
||||
<p>To build the site for production and compress HTML files:</p>
|
||||
<pre><code>npm run production</code></pre><p>The site is built in the <code>/build</code> folder.</p>
|
||||
<p>Note you may want to change the <code>siteMeta.domain</code> and <code>siteMeta.rootpath</code> on lines 52 and 53 of <code>./build.js</code>.</p>
|
||||
|
||||
|
||||
|
||||
<nav class="nav page">
|
||||
<ul>
|
||||
|
||||
<li><a href="../../start/installation/" class="back">« back: Installation</a></li></p>
|
||||
|
||||
<li><a href="../../start/site-files/" class="next">next: Site files »</a></li></p>
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
|
||||
</article>
|
||||
|
||||
|
||||
<!-- sub navigation -->
|
||||
<nav class="nav sub">
|
||||
<ul>
|
||||
|
||||
<li>
|
||||
<a href="../../start/installation/">Installation</a>
|
||||
</li>
|
||||
<li>
|
||||
<strong>Build</strong>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/site-files/">Site files</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/page-definitions/">Page definitions</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/plugins/">Custom plugins</a>
|
||||
</li>
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
</main>
|
||||
|
||||
<footer>
|
||||
|
||||
<p>By <a href="https://chat.dashdevs.org">dashdevs</a> and featured on <a href="http://www.dashdevs.org/">DashDevs.org</a></p>
|
||||
|
||||
<p class="siteinfo">Development build, version 1.0.0, article template</p>
|
||||
|
||||
</footer>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
150
build/start/index.html
Normal file
150
build/start/index.html
Normal file
|
|
@ -0,0 +1,150 @@
|
|||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<title>Start - dashdev-website</title>
|
||||
|
||||
|
||||
<meta name="HandheldFriendly" content="true">
|
||||
<meta name="MobileOptimized" content="320">
|
||||
<meta name="viewport" content="width=device-width,shrink-to-fit=no,user-scalable=no,initial-scale=1,minimum-scale=1,minimal-ui">
|
||||
<meta name="apple-mobile-web-app-capable" content="yes">
|
||||
<meta name="apple-mobile-web-app-status-bar-style" content="black">
|
||||
<meta name="mobile-web-app-capable" content="yes">
|
||||
|
||||
<link rel="stylesheet" media="all" href="../css/styles.css" />
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<header>
|
||||
|
||||
<div class="content">
|
||||
|
||||
<p class="logo"><a href="../">dashdev-website</a></p>
|
||||
<!-- main navigation -->
|
||||
<nav class="nav main">
|
||||
<ul>
|
||||
<li>
|
||||
<a href="../">Home</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../start/" class="active">Start</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../article/">Articles</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../contact/">Contact</a>
|
||||
</li>
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
</header>
|
||||
|
||||
<main class="subpages">
|
||||
|
||||
<div class="content">
|
||||
|
||||
<article>
|
||||
|
||||
<h1>Start</h1>
|
||||
|
||||
|
||||
<p>This section provides an overview of core code and concepts.</p>
|
||||
|
||||
|
||||
|
||||
<ul class="pagelist">
|
||||
|
||||
<li>
|
||||
<a href="../start/installation/">
|
||||
|
||||
<h2>Installation</h2>
|
||||
<p class="articleinfo"></p>
|
||||
|
||||
<p>How to install this demonstration code.</p>
|
||||
</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../start/build/">
|
||||
|
||||
<h2>Build</h2>
|
||||
<p class="articleinfo"></p>
|
||||
|
||||
<p>How to build the static site using Metalsmith.</p>
|
||||
</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../start/site-files/">
|
||||
|
||||
<h2>Site files</h2>
|
||||
<p class="articleinfo"></p>
|
||||
|
||||
<p>A description of the source files used to build a website</p>
|
||||
</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../start/page-definitions/">
|
||||
|
||||
<h2>Page definitions</h2>
|
||||
<p class="articleinfo"></p>
|
||||
|
||||
<p>How pages are defined in the source folder.</p>
|
||||
</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../start/plugins/">
|
||||
|
||||
<h2>Custom plugins</h2>
|
||||
<p class="articleinfo"></p>
|
||||
|
||||
<p>The custom plugins used to create this website.</p>
|
||||
</a>
|
||||
</li>
|
||||
|
||||
</ul>
|
||||
|
||||
|
||||
</article>
|
||||
|
||||
|
||||
<!-- sub navigation -->
|
||||
<nav class="nav sub">
|
||||
<ul>
|
||||
|
||||
<li>
|
||||
<a href="../start/installation/">Installation</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../start/build/">Build</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../start/site-files/">Site files</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../start/page-definitions/">Page definitions</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../start/plugins/">Custom plugins</a>
|
||||
</li>
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
</main>
|
||||
|
||||
<footer>
|
||||
|
||||
<p>By <a href="https://chat.dashdevs.org">dashdevs</a> and featured on <a href="http://www.dashdevs.org/">DashDevs.org</a></p>
|
||||
|
||||
<p class="siteinfo">Development build, version 1.0.0, article template</p>
|
||||
|
||||
</footer>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
117
build/start/installation/index.html
Normal file
117
build/start/installation/index.html
Normal file
|
|
@ -0,0 +1,117 @@
|
|||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<title>Installation - dashdev-website</title>
|
||||
<meta name="description" content="How to install this demonstration code." />
|
||||
|
||||
<meta name="HandheldFriendly" content="true">
|
||||
<meta name="MobileOptimized" content="320">
|
||||
<meta name="viewport" content="width=device-width,shrink-to-fit=no,user-scalable=no,initial-scale=1,minimum-scale=1,minimal-ui">
|
||||
<meta name="apple-mobile-web-app-capable" content="yes">
|
||||
<meta name="apple-mobile-web-app-status-bar-style" content="black">
|
||||
<meta name="mobile-web-app-capable" content="yes">
|
||||
|
||||
<link rel="stylesheet" media="all" href="../../css/styles.css" />
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<header>
|
||||
|
||||
<div class="content">
|
||||
|
||||
<p class="logo"><a href="../../">dashdev-website</a></p>
|
||||
<!-- main navigation -->
|
||||
<nav class="nav main">
|
||||
<ul>
|
||||
<li>
|
||||
<a href="../../">Home</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/" class="active">Start</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/">Articles</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../contact/">Contact</a>
|
||||
</li>
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
</header>
|
||||
|
||||
<main class="subpages">
|
||||
|
||||
<div class="content">
|
||||
|
||||
<article>
|
||||
|
||||
<h1>Installation</h1>
|
||||
|
||||
|
||||
<p class="articleinfo">Published , words, -minute read</p>
|
||||
|
||||
|
||||
<p>Please ensure <a href="https://nodejs.org/">Node.js</a> and <a href="https://git-scm.com/">Git</a> are installed on your system.</p>
|
||||
<p>Download the demonstration code and switch to directory:</p>
|
||||
<p> git clone <a href="mailto:git@github.com">git@github.com</a>:dashdev-suite/dashdev-website.git
|
||||
cd metalsmith-demo</p>
|
||||
<p>Install dependencies:</p>
|
||||
<pre><code>npm install</code></pre>
|
||||
|
||||
|
||||
<nav class="nav page">
|
||||
<ul>
|
||||
|
||||
<li><a href="../../start/" class="back">« back: Start</a></li></p>
|
||||
|
||||
<li><a href="../../start/build/" class="next">next: Build »</a></li></p>
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
|
||||
</article>
|
||||
|
||||
|
||||
<!-- sub navigation -->
|
||||
<nav class="nav sub">
|
||||
<ul>
|
||||
|
||||
<li>
|
||||
<strong>Installation</strong>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/build/">Build</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/site-files/">Site files</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/page-definitions/">Page definitions</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/plugins/">Custom plugins</a>
|
||||
</li>
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
</main>
|
||||
|
||||
<footer>
|
||||
|
||||
<p>By <a href="https://chat.dashdevs.org">dashdevs</a> and featured on <a href="http://www.dashdevs.org/">DashDevs.org</a></p>
|
||||
|
||||
<p class="siteinfo">Development build, version 1.0.0, article template</p>
|
||||
|
||||
</footer>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
131
build/start/page-definitions/index.html
Normal file
131
build/start/page-definitions/index.html
Normal file
|
|
@ -0,0 +1,131 @@
|
|||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<title>Page definitions - dashdev-website</title>
|
||||
<meta name="description" content="How pages are defined in the source folder." />
|
||||
|
||||
<meta name="HandheldFriendly" content="true">
|
||||
<meta name="MobileOptimized" content="320">
|
||||
<meta name="viewport" content="width=device-width,shrink-to-fit=no,user-scalable=no,initial-scale=1,minimum-scale=1,minimal-ui">
|
||||
<meta name="apple-mobile-web-app-capable" content="yes">
|
||||
<meta name="apple-mobile-web-app-status-bar-style" content="black">
|
||||
<meta name="mobile-web-app-capable" content="yes">
|
||||
|
||||
<link rel="stylesheet" media="all" href="../../css/styles.css" />
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<header>
|
||||
|
||||
<div class="content">
|
||||
|
||||
<p class="logo"><a href="../../">dashdev-website</a></p>
|
||||
<!-- main navigation -->
|
||||
<nav class="nav main">
|
||||
<ul>
|
||||
<li>
|
||||
<a href="../../">Home</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/" class="active">Start</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/">Articles</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../contact/">Contact</a>
|
||||
</li>
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
</header>
|
||||
|
||||
<main class="subpages">
|
||||
|
||||
<div class="content">
|
||||
|
||||
<article>
|
||||
|
||||
<h1>Page definitions</h1>
|
||||
|
||||
|
||||
<p class="articleinfo">Published , words, -minute read</p>
|
||||
|
||||
|
||||
<p>Each sub-folder in <code>src/html</code> is a website section. Pages named <code>index.md</code> are the default page in section. File paths are translated to permalinks, e.g.</p>
|
||||
<pre><code>src/html/article/mypage.md</code></pre><p>is rendered to:</p>
|
||||
<pre><code>build/article/mypage/index.html</code></pre><p>Pages use YAML front-matter defined at the top. This can be referenced in templates or during the build process, e.g.</p>
|
||||
<pre><code>---
|
||||
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
|
||||
---</code></pre><p>All items are optional. Note:</p>
|
||||
<ul>
|
||||
<li><code>layout</code> defaults to <code>page.html</code> unless <code>metadata.layout</code> is defined for the page collection (see the <code>use(collections({ ... })</code> code in <code>build.js</code>).</li>
|
||||
<li><code>priority</code> is a number between 0 (low) and 1 (high) which is used to order menus and define XML sitemaps.</li>
|
||||
<li><code>publish</code> can be set <code>draft</code>, <code>private</code> or a future date to ensure it is not published until required.</li>
|
||||
<li><code>date</code> is the date of the article. If not set, a future <code>publish</code> date or the file creation date is used.</li>
|
||||
</ul>
|
||||
<p>The page content is defined in markdown, HTML syntax or both below the front-matter section. The content can include <a href="http://handlebarsjs.com/">Handlebars</a> partials from the <code>src/partials</code> folder, e.g.</p>
|
||||
<pre><code>{{> partialname }}</code></pre><p>where <code>partialname</code> is the partial filename without its <code>.html</code> extension.</p>
|
||||
|
||||
|
||||
|
||||
<nav class="nav page">
|
||||
<ul>
|
||||
|
||||
<li><a href="../../start/site-files/" class="back">« back: Site files</a></li></p>
|
||||
|
||||
<li><a href="../../start/plugins/" class="next">next: Custom plugins »</a></li></p>
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
|
||||
</article>
|
||||
|
||||
|
||||
<!-- sub navigation -->
|
||||
<nav class="nav sub">
|
||||
<ul>
|
||||
|
||||
<li>
|
||||
<a href="../../start/installation/">Installation</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/build/">Build</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/site-files/">Site files</a>
|
||||
</li>
|
||||
<li>
|
||||
<strong>Page definitions</strong>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/plugins/">Custom plugins</a>
|
||||
</li>
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
</main>
|
||||
|
||||
<footer>
|
||||
|
||||
<p>By <a href="https://chat.dashdevs.org">dashdevs</a> and featured on <a href="http://www.dashdevs.org/">DashDevs.org</a></p>
|
||||
|
||||
<p class="siteinfo">Development build, version 1.0.0, article template</p>
|
||||
|
||||
</footer>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
118
build/start/plugins/index.html
Normal file
118
build/start/plugins/index.html
Normal file
|
|
@ -0,0 +1,118 @@
|
|||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<title>Custom plugins - dashdev-website</title>
|
||||
<meta name="description" content="The custom plugins used to create this website." />
|
||||
|
||||
<meta name="HandheldFriendly" content="true">
|
||||
<meta name="MobileOptimized" content="320">
|
||||
<meta name="viewport" content="width=device-width,shrink-to-fit=no,user-scalable=no,initial-scale=1,minimum-scale=1,minimal-ui">
|
||||
<meta name="apple-mobile-web-app-capable" content="yes">
|
||||
<meta name="apple-mobile-web-app-status-bar-style" content="black">
|
||||
<meta name="mobile-web-app-capable" content="yes">
|
||||
|
||||
<link rel="stylesheet" media="all" href="../../css/styles.css" />
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<header>
|
||||
|
||||
<div class="content">
|
||||
|
||||
<p class="logo"><a href="../../">dashdev-website</a></p>
|
||||
<!-- main navigation -->
|
||||
<nav class="nav main">
|
||||
<ul>
|
||||
<li>
|
||||
<a href="../../">Home</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/" class="active">Start</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/">Articles</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../contact/">Contact</a>
|
||||
</li>
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
</header>
|
||||
|
||||
<main class="subpages">
|
||||
|
||||
<div class="content">
|
||||
|
||||
<article>
|
||||
|
||||
<h1>Custom plugins</h1>
|
||||
|
||||
|
||||
<p class="articleinfo">Published , words, -minute read</p>
|
||||
|
||||
|
||||
<p>The <code>build.js</code> file defines how the site is built using Metalsmith and various plugins.</p>
|
||||
<p>Several custom plugins have been created specifically for this site:</p>
|
||||
<ul>
|
||||
<li><code>lib/metalsmith-debug.js</code>: output debugging information to the console.</li>
|
||||
<li><code>lib/metalsmith-setdate.js</code>: ensure each page has a date. If a <code>date</code> is not defined in the page's front-matter, it is presumed to be the publish or file creation date.</li>
|
||||
<li><code>lib/metalsmith-moremeta.js</code>: applies further metadata to each page including the root folder, a default layout, primary and secondary navigation.</li>
|
||||
</ul>
|
||||
|
||||
|
||||
|
||||
<nav class="nav page">
|
||||
<ul>
|
||||
|
||||
<li><a href="../../start/page-definitions/" class="back">« back: Page definitions</a></li></p>
|
||||
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
|
||||
</article>
|
||||
|
||||
|
||||
<!-- sub navigation -->
|
||||
<nav class="nav sub">
|
||||
<ul>
|
||||
|
||||
<li>
|
||||
<a href="../../start/installation/">Installation</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/build/">Build</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/site-files/">Site files</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/page-definitions/">Page definitions</a>
|
||||
</li>
|
||||
<li>
|
||||
<strong>Custom plugins</strong>
|
||||
</li>
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
</main>
|
||||
|
||||
<footer>
|
||||
|
||||
<p>By <a href="https://chat.dashdevs.org">dashdevs</a> and featured on <a href="http://www.dashdevs.org/">DashDevs.org</a></p>
|
||||
|
||||
<p class="siteinfo">Development build, version 1.0.0, article template</p>
|
||||
|
||||
</footer>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
119
build/start/site-files/index.html
Normal file
119
build/start/site-files/index.html
Normal file
|
|
@ -0,0 +1,119 @@
|
|||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<title>Site files - dashdev-website</title>
|
||||
<meta name="description" content="A description of the source files used to build a website" />
|
||||
|
||||
<meta name="HandheldFriendly" content="true">
|
||||
<meta name="MobileOptimized" content="320">
|
||||
<meta name="viewport" content="width=device-width,shrink-to-fit=no,user-scalable=no,initial-scale=1,minimum-scale=1,minimal-ui">
|
||||
<meta name="apple-mobile-web-app-capable" content="yes">
|
||||
<meta name="apple-mobile-web-app-status-bar-style" content="black">
|
||||
<meta name="mobile-web-app-capable" content="yes">
|
||||
|
||||
<link rel="stylesheet" media="all" href="../../css/styles.css" />
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<header>
|
||||
|
||||
<div class="content">
|
||||
|
||||
<p class="logo"><a href="../../">dashdev-website</a></p>
|
||||
<!-- main navigation -->
|
||||
<nav class="nav main">
|
||||
<ul>
|
||||
<li>
|
||||
<a href="../../">Home</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/" class="active">Start</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../article/">Articles</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../contact/">Contact</a>
|
||||
</li>
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
</header>
|
||||
|
||||
<main class="subpages">
|
||||
|
||||
<div class="content">
|
||||
|
||||
<article>
|
||||
|
||||
<h1>Site files</h1>
|
||||
|
||||
|
||||
<p class="articleinfo">Published , words, -minute read</p>
|
||||
|
||||
|
||||
<p>All files in the <code>src</code> folder can be edited:</p>
|
||||
<ul>
|
||||
<li>pages are created as markdown files in the <code>src/html</code> folder and sub-folders.</li>
|
||||
<li>static assets such as CSS, JavaScript and image files are created in <code>src/assets</code>. These are copied without modification to <code>build/</code>.</li>
|
||||
<li>page templates are defined in <code>src/template</code>.</li>
|
||||
<li>reusable partials (chunks of HTML code) are declared in <code>src/partials</code>.</li>
|
||||
</ul>
|
||||
|
||||
|
||||
|
||||
<nav class="nav page">
|
||||
<ul>
|
||||
|
||||
<li><a href="../../start/build/" class="back">« back: Build</a></li></p>
|
||||
|
||||
<li><a href="../../start/page-definitions/" class="next">next: Page definitions »</a></li></p>
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
|
||||
</article>
|
||||
|
||||
|
||||
<!-- sub navigation -->
|
||||
<nav class="nav sub">
|
||||
<ul>
|
||||
|
||||
<li>
|
||||
<a href="../../start/installation/">Installation</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/build/">Build</a>
|
||||
</li>
|
||||
<li>
|
||||
<strong>Site files</strong>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/page-definitions/">Page definitions</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="../../start/plugins/">Custom plugins</a>
|
||||
</li>
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
</main>
|
||||
|
||||
<footer>
|
||||
|
||||
<p>By <a href="https://chat.dashdevs.org">dashdevs</a> and featured on <a href="http://www.dashdevs.org/">DashDevs.org</a></p>
|
||||
|
||||
<p class="siteinfo">Development build, version 1.0.0, article template</p>
|
||||
|
||||
</footer>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
Loading…
Add table
Add a link
Reference in a new issue