first real commit

Author: greggman

.gitattributes

@@ -0,0 +1,14 @@
+* text eol=lf
+
+*.md text
+*.css text
+*.js text
+*.html text
+
+*.png binary
+*.jpg binary
+*.gif binary
+*.bin binary
+*.dds binary
+*.wasm binary
+

.gitignore

@@ -0,0 +1,5 @@
+*.pyc
+.DS_Store
+node_modules
+out
+

.travis.yml

@@ -0,0 +1,18 @@
+language: node_js
+node_js:
+  - "8.4"
+script:
+  - npm run build
+env:
+  global:
+    - COMMIT_AUTHOR_EMAIL: "[email protected]"
+
+deploy:
+  provider: pages
+  skip-cleanup: true
+  github-token: $GITHUB_TOKEN  # Set in the settings page of your repository, as a secure variable
+  keep-history: true
+  local-dir: out
+  on:
+    branch: master
+

3rdparty/jquery-3.3.1.slim.min.js

@@ -0,0 +1,70 @@
+"use strict";
+
+const path = require('path');
+const fs = require('fs');
+
+module.exports = function(grunt) {
+
+  require('load-grunt-tasks')(grunt);
+
+  const s_ignoreRE = /\.(md|py|sh|enc)$/i;
+  function noMds(filename) {
+    return !s_ignoreRE.test(filename);
+  }
+
+  function notFolder(filename) {
+    return !fs.statSync(filename).isDirectory();
+  }
+
+  function noMdsNoFolders(filename) {
+    return noMds(filename) && notFolder(filename);
+  }
+
+  grunt.initConfig({
+    eslint: {
+      lib: {
+        src: [
+          'threejs/resources/*.js',
+        ],
+        options: {
+          config: 'build/conf/eslint.json',
+          //rulesdir: ['build/rules'],
+        },
+      },
+      examples: {
+        src: [
+          'threejs/*.html',
+        ],
+        options: {
+          configFile: 'build/conf/eslint-examples.json',
+        },
+      },
+    },
+    copy: {
+      main: {
+        files: [
+          { expand: false, src: '*', dest: 'out/', filter: noMdsNoFolders, },
+          { expand: true, src: 'threejs/**', dest: 'out/', filter: noMds, },
+          { expand: true, src: 'monaco-editor/**', dest: 'out/', },
+          { expand: true, src: '3rdparty/**', dest: 'out/', },
+        ],
+      },
+    },
+    clean: [
+      'out/**/*',
+    ],
+  });
+
+  grunt.registerTask('buildlessons', function() {
+    var buildStuff = require('./build/js/build');
+    var finish = this.async();
+    buildStuff().then(function() {
+        finish();
+    }).done();
+  });
+
+  grunt.registerTask('build', ['clean', 'copy', 'buildlessons']);
+
+  grunt.registerTask('default', ['eslint', 'build']);
+};
+

Gruntfile.js

@@ -0,0 +1,31 @@
+# Copyright 2018, Google Inc.
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+#       notice, this list of conditions and the following disclaimer.
+#
+#     * Redistributions in binary form must reproduce the above
+#       copyright notice, this list of conditions and the following disclaimer
+#       in the documentation and/or other materials provided with the
+#       distribution.
+#
+#     * Neither the name of Google Inc. nor the names of their
+#       contributors may be used to endorse or promote products derived from
+#       this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+

LICENSE

@@ -0,0 +1,96 @@
+Three.js Fundamentals
+=====================
+
+This is [a series of lessons or tutorials about three.js](http://threejsfundamentals.org/).
+
+This is work in progress. Feel free to contribute, especially localizations
+
+## Contributing
+
+Of course bug fixes are always welcome.
+
+If you'd like to write a new article please try to always take
+one step at a time. Don't do 2 or more things in a single step.
+Explain any new math in the simplest terms possible. Ideally
+with diagrams where possible. Also it's probably best to
+ask to make sure someone else isn't already working on a similar
+article.
+
+### Translating
+
+Each translation goes in a folder under `threejs/lessons/<country-code>`.
+
+Required files are
+
+    langinfo.hanson
+    index.md
+    toc.html
+
+#### `langinfo.hanson`
+
+Defines various language specific options.
+[Hanson](https://github.com/timjansen/hanson) is a JSON like format but allows comments.
+
+Current fields are
+
+    {
+      // The language (will show up in the language selection menu)
+      language: 'English',
+
+      // Phrase that appears under examples
+      defaultExampleCaption: "click here to open in a separate window",
+
+      // Title that appears on each page
+      title: 'Three Fundamentals',
+
+      // Basic description that appears on each page
+      description: 'Learn Three.js',
+
+      // Link to the language root.
+      link: 'http://threejsfundamentals.org/threejs/lessons/ja',  // replace `ja` with country code
+
+      // html that appears after the article and before the comments
+      commentSectionHeader: '<div>Questions? <a href="http://stackoverflow.com/questions/tagged/three.js">Ask on stackoverflow</a>.</div>\n        <div>Issue/Bug? <a href="http://github.com/greggman/threefundamentals/issues">Create an issue on github</a>.</div>',
+
+      // markdown that appears for untranslated articles
+      missing: "Sorry this article has not been translated yet. [Translations Welcome](https://github.com/greggman/threejsfundamentals)! 😄\n\n[Here's the original English article for now]({{{origLink}}}).",
+
+      // the phrase "Table of Contents"
+      toc: "Table of Contents",
+    }
+
+#### `index.md`
+
+This is the template for the main page for each language
+
+#### `toc.html`
+
+This is the table of contents for the language. It is included on both the index
+and on each article. It's up to if you want to link to English articles for non-translated articles.
+The build system will create a placeholder for every English article for which there is no
+corresponding article in that langauge. It will be filled the `missing` message from above.
+
+#### Translation notes
+
+The build process will make a placeholder html file for each article has an english .md file in
+`threejs/lessons` but no corresponding .md file for the language. This is to make it easy to include
+links in one article that links to another article but that other article has not yet been translated.
+This way you don't have to go back and fix already translated articles. Just translate one article
+at a time and leave the links as is. They'll link to placeholders until someone translates the missing
+articles.
+
+### To build
+
+The site is built into the `out` folder
+
+Steps
+
+    git clone https://github.com/greggman/threejsfundamentals.git
+    npm install
+    npm run build
+    npm start
+
+now open your browser to `http://localhost:8080`
+
+
+

README.md

@@ -0,0 +1,85 @@
+{
+  "env": {
+    "browser": true,
+    "es6": true
+  },
+  "plugins": [
+    "eslint-plugin-html",
+    "eslint-plugin-optional-comma-spacing",
+    "eslint-plugin-one-variable-per-var",
+    "eslint-plugin-require-trailing-comma"
+  ],
+  "extends": "eslint:recommended",
+  "rules": {
+    "no-alert": 2,
+    "no-array-constructor": 2,
+    "no-caller": 2,
+    "no-catch-shadow": 2,
+    "no-const-assign": 2,
+    "no-eval": 2,
+    "no-extend-native": 2,
+    "no-extra-bind": 2,
+    "no-implied-eval": 2,
+    "no-iterator": 2,
+    "no-label-var": 2,
+    "no-labels": 2,
+    "no-lone-blocks": 0,
+    "no-loop-func": 2,
+    "no-multi-str": 2,
+    "no-native-reassign": 2,
+    "no-new": 2,
+    "no-new-func": 2,
+    "no-new-object": 2,
+    "no-new-wrappers": 2,
+    "no-octal-escape": 2,
+    "no-process-exit": 2,
+    "no-proto": 2,
+    "no-return-assign": 2,
+    "no-script-url": 2,
+    "no-sequences": 2,
+    "no-shadow-restricted-names": 2,
+    "no-spaced-func": 2,
+    "no-trailing-spaces": 2,
+    "no-undef-init": 2,
+    "no-underscore-dangle": 2,
+    "no-unused-expressions": 2,
+    "no-use-before-define": 0,
+    "no-with": 2,
+    "consistent-return": 2,
+    "curly": [2, "all"],
+    "no-extra-parens": [2, "functions"],
+    "eqeqeq": 2,
+    "new-cap": 2,
+    "new-parens": 2,
+    "semi-spacing": [2, {"before": false, "after": true}],
+    "space-infix-ops": 2,
+    "space-unary-ops": [2, { "words": true, "nonwords": false }],
+    "yoda": [2, "never"],
+
+    "brace-style": [2, "1tbs", { "allowSingleLine": false }],
+    "camelcase": [0],
+    "comma-spacing": 0,
+    "comma-dangle": 0,
+    "comma-style": [2, "last"],
+    "optional-comma-spacing/optional-comma-spacing": [2, {"after": true}],
+    "dot-notation": 0,
+    "eol-last": [0],
+    "global-strict": [0],
+    "key-spacing": [0],
+    "no-comma-dangle": [0],
+    "no-irregular-whitespace": 2,
+    "no-multi-spaces": [0],
+    "no-obj-calls": 2,
+    "no-redeclare": [0],
+    "no-shadow": [0],
+    "no-undef": [0],
+    "no-unreachable": 2,
+    "one-variable-per-var/one-variable-per-var": [2],
+    "quotes": [2, "single"],
+    "require-trailing-comma/require-trailing-comma": [2],
+    "semi": [2, "always"],
+    "strict": [2, "global"],
+    "space-before-function-paren": [2, "never"],
+    "keyword-spacing": [1, {"before": true, "after": true, "overrides": {}} ]
+  }
+}