Merge pull request sass#33 from oddbird/sass-implementations

Add 404 page, sass implementation pages, robots.txt, and humans.txt.

LICENSE

@@ -1,5 +1,5 @@
-Copyright (c) 2006-2023 Hampton Catlin, Natalie Weizenbaum, Chris Eppstein, and
-Jina Anne
+Copyright (c) 2006-2023 Hampton Lintorn-Catlin, Natalie Weizenbaum, Chris
+Eppstein, and Jina Anne
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of
 this software and associated documentation files (the "Software"), to deal in

eleventy.config.js

@@ -23,6 +23,10 @@ module.exports = (eleventyConfig) => {
   eleventyConfig.addPassthroughCopy('source/assets/img');
   eleventyConfig.addPassthroughCopy('source/favicon.ico');
   eleventyConfig.addPassthroughCopy('source/_redirects');
+  eleventyConfig.addPassthroughCopy('source/browserconfig.xml');
+  eleventyConfig.addPassthroughCopy('source/tile.png');
+  eleventyConfig.addPassthroughCopy('source/tile-wide.png');
+  eleventyConfig.addPassthroughCopy('source/robots.txt');
 
   eleventyConfig.setUseGitIgnore(false);
   eleventyConfig.watchIgnores.add('source/_data/versionCache.json');

source/404.md

@@ -0,0 +1,9 @@
+---
+layout: has_no_sidebars
+title: Page Not Found
+permalink: '/404.html'
+eleventyExcludeFromCollections: true
+introduction: >
+  Sorry, but the page you were trying to view does not exist.
+center_introduction: true
+---

source/_data/humans.yml

@@ -0,0 +1,52 @@
+# Website Credits
+team:
+  - name: Jina
+    role: design lead, code, content
+    twitter: jina
+  - name: Natalie Weizenbaum
+    role: code, content
+    twitter: nex3
+
+contributors:
+  - name: Chris Eppstein
+    role: code, content
+    twitter: chriseppstein
+  - name: Hampton Lintorn-Catlin
+    role: code, content
+    twitter: HamptonMakes
+  - name: Michael Lintorn-Catlin
+    role: content
+    twitter: malrase
+  - name: Bermon Painter
+    role: design, code, content
+    twitter: bermonpainter
+  - name: Michael Parenteau
+    role: design, code, content
+    twitter: parenteau
+
+thanks:
+  - name: All the people at SassConf that came to help with DNS and server-related issues.
+  - name: To everyone who has contributed through pull requests.
+
+markup:
+  - name: HTML5
+  - name: LiquidJS
+  - name: Markdown
+
+style:
+  - name: CSS3
+  - name: Sass
+  - name: Normalize
+  - name: Sanitize
+
+behavior:
+  - name: Modernizr
+  - name: jQuery
+
+misc:
+  - name: Eleventy
+  - name: HTML5 Boilerplate
+  - name: GitHub
+  - name: Netlify
+  - name: Visual Studio Code
+  - name: iTerm

source/_includes/navigation.liquid

@@ -0,0 +1,3 @@
+<nav class="sl-l-medium-holy-grail__navigation" role="navigation" aria-label="Content navigation">
+  {{ contents | markdown }}
+</nav>

source/_layouts/has_both_sidebars.liquid

@@ -0,0 +1,30 @@
+---
+layout: base
+---
+
+<div class="sl-l-medium-holy-grail">
+  <div class="sl-l-medium-holy-grail__body">
+    {% render 'navigation', contents: navigation %}
+
+    <div class="sl-l-medium-holy-grail__main">
+      <div class="sl-l-medium-holy-grail">
+        <div class="sl-l-medium-holy-grail__body">
+          {% if complementary_content %}
+            <div class="sl-l-large-holy-grail__complementary{% if table_of_contents %} sl-l-large-holy-grail__complementary--contents{% endif %}">
+              {{ complementary_content | markdown }}
+            </div>
+          {% endif %}
+
+          <div class="sl-l-large-holy-grail__main docSearch-content">
+            {% assign is_typedoc = page | isTypedoc %}
+            <div {% unless no_container or is_typedoc %}class="sl-l-container sl-l-container--small"{% endunless %}>
+              {% render 'intro', before_introduction: before_introduction, introduction: introduction, center_introduction: center_introduction %}
+
+              {{ content }}
+            </div>
+          </div>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>

source/_layouts/has_navigation.liquid

@@ -4,9 +4,8 @@ layout: base
 
 <div class="sl-l-medium-holy-grail">
   <div class="sl-l-medium-holy-grail__body">
-    <nav class="sl-l-medium-holy-grail__navigation" role="navigation">
-      {{ navigation | markdown }}
-    </nav>
+    {% render 'navigation', contents: navigation %}
+
     <div class="sl-l-medium-holy-grail__main">
       <div {% unless no_container %}class="sl-l-container sl-l-container--small"{% endunless %}>
         {% render 'intro', before_introduction: before_introduction, introduction: introduction, center_introduction: center_introduction %}

source/_redirects

@@ -1,4 +1,5 @@
 /feed                 /feed.xml                                     200
+/sitemap              /sitemap.xml                                  200
 /tutorial             /guide
 /download             /install
 /try                  https://www.sassmeister.com

source/assets/sass/components/_callouts.scss

@@ -51,16 +51,6 @@
   }
 }
 
-@include breakpoints.sl-breakpoint--medium {
-  .sl-l-container--overview {
-    font-size: var(--sl-font-size--large);
-
-    .sl-c-callout {
-      font-size: var(--sl-font-size--small);
-    }
-  }
-}
-
 @include breakpoints.sl-breakpoint--large {
   .sl-c-callout--function {
     padding-left: 2.25rem;

source/blog/001-how-extend-works.md

@@ -7,7 +7,7 @@ date: 2013-11-22 16:57:00 -8
 _This was originally published as [a gist](https://gist.github.com/nex3/7609394)_.
 
 [Aaron Leung](https://github.com/akhleung) is working on
-[hcatlin/libsass](http://github.com/hcatlin/libsass) and was wondering how
+[libsass](https://github.com/sass/libsass) and was wondering how
 `@extend` is implemented in the Ruby implementation of Sass. Rather than just
 tell him, I thought I'd write up a public document about it so anyone who's
 porting Sass or is just curious about how it works can see.

source/blog/009-announcing-dart-sass.md

@@ -28,7 +28,7 @@ high-level and easy to hack on, so it's where we iterate on new features and
 where they first get released. Then there's
 [LibSass](https://github.com/sass/libsass), the C++ implementation, originally
 created by [Aaron](https://github.com/akhleung) and
-[Hampton](https://github.com/hcatlin) and now maintained by
+[Hampton](https://github.com/hamptonmakes) and now maintained by
 [Marcel](https://github.com/mgreter) and [Michael](https://github.com/xzyfer).
 It's low-level, which makes it very fast and easy to install and embed in other
 languages. In particular, its [Node.js

source/blog/014-dart-sass-100-is-released.md

@@ -20,7 +20,7 @@ The 1.0.0 stable release indicates that Dart Sass is fully compatible with the
 Sass language as defined by [the sass-spec test
 suite](http://github.com/sass/sass-spec), and that its npm package is compatible
 with the [Node Sass
-API](https://github.com/sass/node-sass/blob/master/README.md#usage), with the
+API](https://github.com/sass/node-sass#usage), with the
 exception of source map support which is [coming
 soon](https://github.com/sass/dart-sass/issues/2).
 

source/browserconfig.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Please read: http://msdn.microsoft.com/en-us/library/ie/dn455106.aspx -->
+<browserconfig>
+  <msapplication>
+    <tile>
+      <square70x70logo src="tile.png"/>
+      <square150x150logo src="tile.png"/>
+      <wide310x150logo src="tile-wide.png"/>
+      <square310x310logo src="tile.png"/>
+    </tile>
+  </msapplication>
+</browserconfig>

source/community.md

@@ -14,7 +14,7 @@ complementary_content: |
     by Kitty Giraudel and Miriam Suzanne
 
     ### [Pragmatic Guide to Sass 3: Tame the Modern Style Sheet](https://amzn.to/2LEwXiZ)
-    by Hampton Lintorn Catlin and Michael Lintorn Catlin
+    by Hampton Lintorn-Catlin and Michael Lintorn-Catlin
 
     ### [Sass for Web Designers](https://amzn.to/2RkIVU3)
     by Dan Cederholm

source/dart-sass.md

@@ -0,0 +1,143 @@
+---
+layout: has_no_sidebars
+title: Dart Sass
+no_container: true
+introduction: >
+  Dart Sass is the primary implementation of Sass, which means it gets new
+  features before any other implementation. It's fast, easy to install, and it
+  compiles to pure JavaScript which makes it easy to integrate into modern web
+  development workflows. Find out more or help out with its development on
+  [GitHub](https://github.com/sass/dart-sass).
+---
+
+<div class="sl-l-grid sl-l-grid--full sl-l-large-grid--fit sl-l-large-grid--gutters-large">
+  <div class="sl-l-grid__column">
+
+## Command Line
+
+Dart Sass's stand-alone command-line executable uses the blazing-fast Dart VM to
+compile your stylesheets. To install Dart Sass on the command line, check out
+the [installation instructions](/install). Once you've got it running, you can
+use it compile files:
+
+```shell
+sass source/index.scss css/index.css
+```
+
+See `sass --help` for additional information on the command-line interface.
+
+### Dart Library
+
+You can also use Dart Sass as a Dart library to get the speed of the Dart VM
+plus the ability to define your own functions and importers. To add it to an
+existing project:
+
+1. [Install the Dart SDK][install]. Make sure its `bin` directory is [on your
+   `PATH`][path].
+
+   [install]: https://dart.dev/get-dart
+   [path]: https://katiek2.github.io/path-doc/
+
+2. Create a `pubspec.yaml` file like this:
+
+```yaml
+name: my_project
+dev_dependencies:
+  sass: ^{{ releases['dart-sass'].version }}
+```
+
+3. Run `dart pub get`.
+
+4. Create a `compile-sass.dart` file like this:
+
+```dart
+import 'dart:io';
+import 'package:sass/sass.dart' as sass;
+
+void main(List<String> arguments) {
+  var result = sass.compile(arguments[0]);
+  new File(arguments[1]).writeAsStringSync(result);
+}
+```
+
+5. You can now use this to compile files:
+
+```shell
+dart compile-sass.dart styles.scss styles.css
+```
+
+6. Learn more about [writing Dart code][dart] (it's easy!) and about [Sass's
+   Dart API][sass].
+
+   [dart]: https://www.dartlang.org/guides/language/language-tour
+   [sass]: https://pub.dev/documentation/sass/latest/sass/compileToResult.html
+
+</div>
+<div class="sl-l-grid__column">
+
+## JavaScript Library
+
+Dart Sass is also distributed as the pure JavaScript [`sass`
+package](https://www.npmjs.com/package/sass) on npm. The pure JS version is
+slower than the stand-alone executable, but it's easy to integrate into existing
+workflows and it allows you to define custom functions and importers in
+JavaScript. You can add it to your project using `npm install --save-dev sass`
+and `require()` it as a library:
+
+```js
+var sass = require('sass');
+
+sass.render(
+  {
+    file: scss_filename,
+  },
+  function (err, result) {
+    /* ... */
+  },
+);
+
+// OR
+
+var result = sass.renderSync({
+  file: scss_filename,
+});
+```
+
+When installed via npm, Dart Sass supports a JavaScript API that aims to be
+compatible with [Node Sass](https://github.com/sass/node-sass#usage). Full
+compatibility is a work in progress, but Dart Sass currently supports the
+`render()` and `renderSync()` functions. Note however that by default,
+**`renderSync()` is more than twice as fast as `render()`**, due to the overhead
+of asynchronous callbacks.
+
+To avoid this performance hit, `render()` can use the [`fibers`][fibers] package
+to call asynchronous importers from the synchronous code path. To enable this,
+pass the `Fiber` class to the `fiber` option:
+
+[fibers]: https://www.npmjs.com/package/fibers
+
+```js
+var sass = require('sass');
+var Fiber = require('fibers');
+
+sass.render(
+  {
+    file: 'input.scss',
+    importer: function (url, prev, done) {
+      // ...
+    },
+    fiber: Fiber,
+  },
+  function (err, result) {
+    // ...
+  },
+);
+```
+
+See [Dart Sass's documentation][js api] for more information about its
+JavaScript API.
+
+[js api]: https://github.com/sass/dart-sass#legacy-javascript-api
+
+  </div>
+</div>

source/feed.liquid

@@ -1,5 +1,5 @@
 ---
-permalink: 'feed.xml'
+permalink: '/feed.xml'
 eleventyExcludeFromCollections: true
 ---
 <?xml version="1.0" encoding="utf-8"?>

source/humans.liquid

@@ -0,0 +1,26 @@
+---
+permalink: '/humans.txt'
+eleventyExcludeFromCollections: true
+---
+# humanstxt.org/
+# The humans responsible & technology colophon
+
+# TEAM
+{% for person in humans.team %}
+    {{ person.name }} -- {{ person.role }} -- @{{ person.twitter }}
+{%- endfor %}
+
+# THANKS
+{% for person in humans.contributors %}
+    {{ person.name }} -- {{ person.role }} -- @{{ person.twitter }}
+{%- endfor %}
+{%- for person in humans.thanks %}
+    {{ person.name }}
+{%- endfor %}
+
+# TECHNOLOGY COLOPHON
+
+    {% for tech in humans.markup %}{{ tech.name }}{% unless forloop.last %}, {% endunless %}{% endfor %}
+    {% for tech in humans.style %}{{ tech.name }}{% unless forloop.last %}, {% endunless %}{% endfor %}
+    {% for tech in humans.behavior %}{{ tech.name }}{% unless forloop.last %}, {% endunless %}{% endfor %}
+    {% for tech in humans.misc %}{{ tech.name }}{% unless forloop.last %}, {% endunless %}{% endfor %}