Merge branch 'main' of https://github.com/processing/p5.js-website into feedbackExample

Author: aceslowman

.gitattributes

@@ -0,0 +1,24 @@
+# Set default behaviour to automatically normalize line endings.
+* text=auto
+
+# prevents git from converting LF to CRLF, which causes issues
+# when assembling example pages on Windows
+data/examples/**/*.js eol=lf
+
+# Denote all files that are truly binary and should not be modified.
+*.ai binary
+*.gif binary
+*.ico binary
+*.jpg binary
+*.mov binary
+*.mp3 binary
+*.mp4 binary
+*.ogg binary
+*.ogv binary
+*.otf binary
+*.pdf binary
+*.png binary
+*.ttf binary
+*.wav binary
+*.webm binary
+*.zip binary

.github/ISSUE_TEMPLATE/discussion.yml

@@ -1,10 +1,10 @@
 name: 💭 Discussion
 description: This template is for starting a discussion.
-labels: [discussion]
+labels: [ Discussion ]
 body:
-- type: textarea
-  attributes:
-    label: Topic
-    description: What do you want to discuss with the group?
-  validations:
-    required: true
+  - type: textarea
+    attributes:
+      label: Topic
+      description: What do you want to discuss with the group?
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/feature-request.yml

@@ -1,6 +1,6 @@
 name: 🌱 New Feature Request
 description: Request a new feature be added.
-labels: [feature request]
+labels: [ Feature Request ]
 body:
   - type: textarea
     attributes:
@@ -27,7 +27,7 @@ body:
         - Showcase
         - Other (specify if possible)
     validations:
-        required: true
+      required: true
 
   - type: textarea
     attributes:

.github/ISSUE_TEMPLATE/found-a-bug.yml

@@ -1,6 +1,6 @@
 name: "🐛 Found a Bug"
 description: Report p5.js website bugs (broken or incorrect behaviour).
-labels: [ bug ]
+labels: [ Bug ]
 body:
   - type: markdown
     attributes:

.github/ISSUE_TEMPLATE/improve-translation.yml

@@ -1,6 +1,6 @@
 name: "🌐 Improve Translation"
 description: Make a suggestion or report a problem about the translation of p5.js website.
-labels: [ translation ]
+labels: [ Translation ]
 body:
   - type: markdown
     attributes:

.github/workflows/update-documentation.yml

@@ -10,7 +10,7 @@ env:
 
 jobs:
   build:
-    name: Update p5.js documentation
+    name: Update p5.js documentation and library files
     runs-on: ubuntu-latest
 
     steps:
@@ -20,28 +20,18 @@ jobs:
         uses: actions/setup-node@v1
         with:
           node-version: 12.x
-      - name: Extract documentation from the p5.js repo
+      - name: Extract documentation and library files from the p5.js repo
         run: |
           npm install
-          npm run grunt update-enJSON
+          npm run grunt update-enJSON --target="${{ steps.p5js.outputs.VERSION }}"
       - name: Get p5.js release info
         id: p5js
         run: |
           echo ::set-output name=VERSION::${P5JS_REF/refs\/tags\//}
           echo ::set-output name=SHA::${P5JS_SHA}
-      - name: Get latest p5.min.js build
-        uses: suisei-cn/actions-download-file@v1
-        with:
-          url: https://github.com/processing/p5.js/releases/download/${{github.event.client_payload.ref}}/p5.min.js
-          target: src/assets/js/
-      - name: Get latest p5.sound.min.js build
-        uses: suisei-cn/actions-download-file@v1
-        with:
-          url: https://github.com/processing/p5.js/releases/download/${{github.event.client_payload.ref}}/p5.sound.min.js
-          target: src/assets/js/
       - name: Commit changes
         uses: EndBug/add-and-commit@v4
         with:
-          message: 'Update Reference files for p5.js ${{ steps.p5js.outputs.VERSION }} release (${{ steps.p5js.outputs.SHA }})'
+          message: 'Update files for p5.js ${{ steps.p5js.outputs.VERSION }} release (${{ steps.p5js.outputs.SHA }})'
         env:
           GITHUB_TOKEN: ${{ secrets.DOCS_COMMIT_TOKEN }}

Gruntfile.js

@@ -342,8 +342,22 @@ module.exports = function(grunt) {
         dest: 'p5-reference/'
       }
     },
-    htmllint: {
-      all: {
+
+    htmlhint: {
+      html1: {
+        options: {
+          'attr-value-double-quotes': false,
+          'alt-require': true,
+          'doctype-first': true,
+          'title-require': true,
+          'attr-no-duplication': true,
+          'input-requires-label': true,
+          'tags-check': true,
+          'tagname-lowercase': true,
+          'tagname-specialchars': true,
+          'empty-tag-not-self-closed': true,
+          'id-unique': true
+        },
         src: [
           '<%= config.dist %>/**/*.html',
           '!<%= config.dist %>/**/CHANGES.html',
@@ -352,20 +366,13 @@ module.exports = function(grunt) {
           '!<%= config.dist %>/**/learn/*.html',
           '!<%= config.dist %>/**/examples/*.html',
           '!<%= config.dist %>/**/reference/assets/index.html'
-        ],
-        options: {
-          ignore: [
-            /^This document appears to be written in English/,
-            /^Bad value “https:/,
-            /^Consider adding a “lang” attribute to the “html”/,
-            /^Attribute “paypalexpress” not allowed on element “script” at this point./
-          ]
-        }
+        ]
       }
     },
+
     shell: {
       generate_dataJSON: {
-        command: 'npm ci && npm run grunt yui',
+        command: `git checkout ${grunt.option('target')} && npm ci && npm run grunt yui build`,
         options: {
           execOptions: {
             cwd: 'tmp/p5.js'
@@ -378,7 +385,7 @@ module.exports = function(grunt) {
   grunt.registerTask('update-version', function() {
     const done = this.async();
 
-    const version = require('./src/templates/pages/reference/data.json').project.version;
+    const version = grunt.option('target').substring(1);
 
     fs.readFile('./src/data/data.yml')
       .then(str => {
@@ -402,7 +409,7 @@ module.exports = function(grunt) {
   grunt.loadNpmTasks('grunt-file-append');
   grunt.loadNpmTasks('grunt-contrib-compress');
   grunt.loadNpmTasks('grunt-contrib-requirejs');
-  grunt.loadNpmTasks('grunt-html');
+  grunt.loadNpmTasks('grunt-htmlhint');
 
   // i18n tracking task
   grunt.registerTask('i18n', function() {
@@ -436,6 +443,14 @@ module.exports = function(grunt) {
     // move the data.json files from the cloned p5.js repository to the p5.js-website repository
     fse.moveSync(dataJSON_p5js, dataJSON_p5jswebsite, { overwrite: true });
     fse.moveSync(dataJSONmin_p5js, dataJSONmin_p5jswebsite, { overwrite: true });
+
+    const p5min_src = 'tmp/p5.js/lib/p5.min.js';
+    const p5min_dest = 'src/assets/js/p5.min.js';
+    const p5Soundmin_src = 'tmp/p5.js/lib/addons/p5.sound.min.js';
+    const p5Soundmin_dest = 'src/assets/js/p5.sound.min.js';
+    fse.moveSync(p5min_src, p5min_dest, { overwrite: true });
+    fse.moveSync(p5Soundmin_src, p5Soundmin_dest, { overwrite: true });
+
     // delete the tmp folder that contained the p5.js repository
     fse.removeSync('tmp/');
   });
@@ -451,8 +466,8 @@ module.exports = function(grunt) {
     'clone_p5js_repo',
     'generate_dataJSON',
     'move_dataJSON',
-    'generate_enJSON',
-    // 'json-to-fluent'
+    'update-version',
+    'generate_enJSON'
   ]);
 
   // multi-tasks: collections of other tasks
@@ -476,19 +491,18 @@ module.exports = function(grunt) {
 
   // runs tasks in order
   grunt.registerTask('build', [
-    'update-version',
+    // 'update-version',
     'exec',
     'clean',
     'requirejs:yuidoc_theme',
     'requirejs',
-    // 'fluent-to-json',
     'copy',
     'optimize',
     'assemble',
     'file_append',
     'compress',
     'i18n',
-    'htmllint'
+    'htmlhint'
   ]);
 
   // runs with just grunt command

README.md

@@ -24,7 +24,7 @@ Once added, a steward's username will remain in the [stewards section of the rea
 | Overall                      | [@Qianqianye](https://github.com/Qianqianye), [@limzykenneth](https://github.com/limzykenneth) |
 | Reference                    |  [@Divyansh013](https://github.com/Divyansh013)                      |
 | Example                      | GSoC 2022: [@Malayvasa](https://github.com/Malayvasa) (Contributor), [@tyler-yin](https://github.com/tyler-yin)(Mentor); [@3ru](https://github.com/3ru) |
-| Teach                        | GSoC 2022: [@Gracia-zhang](https://github.com/Gracia-zhang) (Contributor), [@yinhwa](https://github.com/yinhwa)(Mentor) |
+| Teach                        | GSoC 2022: [@Gracia-zhang](https://github.com/Gracia-zhang) (Contributor), [@yinhwa](https://github.com/yinhwa)(Mentor); [@SarveshLimaye](https://github.com/SarveshLimaye)|
 | Showcase                     | GSoC 2022:  [@anniezhengg](https://github.com/anniezhengg) (Contributor), [@raclim](https://github.com/raclim)(Mentor) |
 | Learn                        | [@nickmcintyre](https://github.com/nickmcintyre)                                  |
 | Libraries                    | [@Qianqianye](https://github.com/Qianqianye)                                           |
@@ -36,17 +36,16 @@ Once added, a steward's username will remain in the [stewards section of the rea
 | Language | Steward(s)                |
 | -------- | ------------------------- |
 | Overall  |[@Qianqianye](https://github.com/Qianqianye), [@limzykenneth](https://github.com/limzykenneth) |
-| Spanish  |[@Guirdo](https://github.com/Guirdo), [@Andreu-G](https://github.com/Andreu-G)                |
+| Spanish  |[@Guirdo](https://github.com/Guirdo), [@Andreu-G](https://github.com/Andreu-G), [@dnd-alv](https://github.com/dnd-alv)                  |
 | Chinese  | [@unicar9](https://github.com/unicar9), [@Gracia-zhang](https://github.com/Gracia-zhang), [@pentalei](https://github.com/pentalei)              |
-| Korean   | [@yinhwa](https://github.com/yinhwa), [@almchung](https://github.com/almchung), [@jhongover9000](https://github.com/jhongover9000), [@sssueing](https://github.com/sssueing), [@GeryGeryGery](https://github.com/GeryGeryGery) |
+| Korean   | [@yinhwa](https://github.com/yinhwa), [@almchung](https://github.com/almchung), [@jhongover9000](https://github.com/jhongover9000), [@sssueing](https://github.com/sssueing), [@GeryGeryGery](https://github.com/GeryGeryGery), [@sosunnyproject](https://github.com/sosunnyproject) |
 | Hindi    | [@adarrssh](https://github.com/adarrssh), [@Divyansh013](https://github.com/Divyansh013), [@deepchauhan](https://github.com/deepchauhan), [@SarveshLimaye](https://github.com/SarveshLimaye)|
 
 Other Language Steward(s):
 * Portuguese: [@raphaelavelar](https://github.com/raphaelavelar)
 
 ## Setup
 
-0. Ensure Java is installed. Not installed?  Head over to [Java](https://www.oracle.com/java/technologies/downloads/) for installation.
 1. Install [node.js](https://nodejs.org/en/download/).
 2. Clone this repo by typing ```git clone https://github.com/processing/p5.js-website/``` in terminal.
 3. Navigate to the `p5.js-website` directory in the terminal and type `npm install`.

contributor_docs/i18n_contribution.md

@@ -211,7 +211,7 @@ The en.json is made up of three sections:
   - p5.js documentation, also extracted from the data.json file. This section contains a key for each p5.js Class (i.e., "p5.Color"), which holds information about the Class itself and its Methods and Fields.
   In this section, you might find HTML Anchor elements. You only need to translate the text between the two tags. For example, in `<a href=\"#/p5.Color\">p5.Color</a>`, you need to translate the second 'p5.Color' and leave the rest as is.
 
-All the translation swaps of the Reference pages happen is [this function](https://github.com/processing/p5.js-website/blob/main/src/templates/pages/reference/index.hbs#L61).
+All the translation swaps of the Reference pages happen in [this function](https://github.com/processing/p5.js-website/blob/main/src/templates/pages/reference/index.hbs#L61).
 Any entries in the JSON object which are not filled in will be left in English when the page is loaded.
 
 The translated versions of the JSON file need to be manually created and updated.