Initial commit from gatsby: (https://github.com/btholt/gatsby-course-starter.git)

Author: btholt

.editorconfig

@@ -0,0 +1,8 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+charset = utf-8
+indent_style = space
+indent_size = 2

.eslintrc.json

@@ -0,0 +1,34 @@
+{
+  "extends": [
+    "eslint:recommended",
+    "plugin:import/errors",
+    "plugin:react/recommended",
+    "plugin:jsx-a11y/recommended",
+    "prettier",
+    "prettier/react"
+  ],
+  "rules": {
+    "react/prop-types": 0,
+    "jsx-a11y/label-has-for": 0,
+    "no-console": 1
+  },
+  "plugins": ["react", "import", "jsx-a11y"],
+  "parser": "babel-eslint",
+  "parserOptions": {
+    "ecmaVersion": 2018,
+    "sourceType": "module",
+    "ecmaFeatures": {
+      "jsx": true
+    }
+  },
+  "env": {
+    "es6": true,
+    "browser": true,
+    "node": true
+  },
+  "settings": {
+    "react": {
+      "version": "16.5.2"
+    }
+  }
+}

.github/workflows/gatsby.yml

@@ -0,0 +1,22 @@
+name: Deploy Gatsby Site to GitHub Pages
+
+on:
+  push:
+    branches:
+      - master
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@master
+      - name: npm install, build, and csv
+        run: |
+          npm install
+          npm run build
+          npm run csv
+      - name: Deploy site to gh-pages branch
+        uses: alex-page/[email protected]
+        with:
+          repo-token: ${{ secrets.ACCESS_TOKEN }}
+          site-directory: public

.gitignore

@@ -0,0 +1,8 @@
+# Project dependencies
+# https://www.npmjs.org/doc/misc/npm-faq.html#should-i-check-my-node_modules-folder-into-git
+node_modules
+.cache/
+# Build directory
+public/
+.DS_Store
+yarn-error.log

.prettierrc

@@ -0,0 +1 @@
+{}

LICENSE

@@ -0,0 +1,62 @@
+<h1 align="center">gatsby-course-starter</h1> <br>
+
+<p align="center">
+  A Gatsby starter to get you started creating educational materials using Markdown
+</p>
+
+## Get Started
+
+1. `npm install --global gatsby-cli` - make sure you're on Gatsby v2+
+   - See [docs here](https://next.gatsbyjs.org/docs/) if you need help
+1. `gatsby new course-website https://github.com/btholt/gatsby-course-starter`
+1. `cd course-website`
+1. `npm run dev`
+1. Open http://localhost:8000 in your browser
+
+## Lessons
+
+The crux of this site is are the lessons. Provided are two examples. Each lesson needs a [frontmattter](https://github.com/gatsbyjs/gatsby/blob/master/docs/docs/adding-markdown-pages.md#note-on-creating-markdown-files) `path`, `order`, and `title`. Generally you should make the `path` and the file name match for ease of finding it.
+
+- `path` - needs a leading slash. This will be slug of the lesson
+- `title` - will be the title displayed on the Table of Contents and on the page itself
+- `order` - the order of which the item should appear in the table of contents. should in `<number><capital letter>` format where the number corresponds to the section it's and the letter corresponds to the order of the lesson inside the section, e.g. `3B`
+- `section` - the title of the section that the article is in. Only the first lesson for each section will be used.
+- `description` – a one-to-three sentence summary of the lesson. used for the meta tag for social shares and SEO. if no description is given, the `siteMetadata.description` for the site is used
+
+## Config
+
+Inside of `gatsby-config.js` be sure to fill out the `siteMetadata` fields, including `title`, `subtitle`, `description`, and `keywords`.
+
+## GitHub Pages
+
+If you do want to deploy to GitHub pages, make sure you add the name of the repo to the `pathPrefix` property in `gatsby-config.js` so that it will correctly make all the links.
+
+## GitHub Actions
+
+This site is ready to deployed to GitHub Pages out of the box with GitHub Actions. If you do not want to deploy this to GitHub Pages, delete the `.github` directory.
+
+If you do want to deploy this to GitHub Pages with GitHub Actions, you need to do a few things.
+
+1. Create a [personal access token](https://help.github.com/en/articles/creating-a-personal-access-token-for-the-command-line) with rights to read and write to repos.
+1. Put that token in your repos secrets. Click the Settings tab and paste your access token in the Secrets tab with the key `ACCESS_TOKEN`.
+1. Now once you commit your code, it should automatically deploy your GitHub Pages site should deploy automatically!
+
+## Example Sites
+
+- [This repo itself](https://btholt.github.io/gatsby-course-starter/)
+- [Complete Intro to Containers](https://btholt.github.io/complete-intro-to-containers/)
+- [Complete Intro to React v5](https://btholt.github.io/complete-intro-to-react-v5/)
+- [Complete Intro to Web Dev v2](https://btholt.github.io/intro-to-web-dev-v2/)
+- [Four Semesters of Computer Science in Five Hours Part II](https://btholt.github.io/four-semesters-of-cs-part-two/)
+
+## CSV
+
+If you run `npm run csv`, a CSV will be generated with all the various lessons' frontmatter outputted to `public/lessons.csv`. You can change the path by changing the `OUTPUT_CSV_PATH` environment variable.
+
+Another CSV will be output to `public/links.csv` where it pull all the links out of each lesson and put them into a CSV. This path can be modified by setting the `LINKS_CSV_PATH` environment variable.
+
+## License
+
+The **code** is this repo is licensed under the Apache 2.0 license.
+
+I include the CC-BY-NC-4.0 license for the content; this is what I recommend you license your **content** under: anyone can use and share the content but they cannot sell it; only you can.

README.md

@@ -0,0 +1,93 @@
+const fs = require("fs").promises;
+const path = require("path");
+const fm = require("front-matter");
+const isUrl = require("is-url-superb");
+const parseLinks = require("parse-markdown-links");
+const { sorter } = require("./src/util/helpers");
+const mdDir = process.env.MARKDOWN_DIR || path.join(__dirname, "lessons/");
+const outputPath =
+  process.env.OUTPUT_CSV_PATH || path.join(__dirname, "public/lessons.csv");
+const linksOutputPath =
+  process.env.LINKS_CSV_PATH || path.join(__dirname, "public/links.csv");
+
+async function createCsv() {
+  console.log(`making the markdown files into a CSV from ${mdDir}`);
+
+  // get paths
+  const allFiles = await fs.readdir(mdDir);
+  const files = allFiles.filter(filePath => filePath.endsWith(".md"));
+
+  // read paths, get buffers
+  const buffers = await Promise.all(
+    files.map(filePath => fs.readFile(path.join(mdDir, filePath)))
+  );
+
+  // make buffers strings
+  const contents = buffers.map(content => content.toString());
+
+  // make strings objects
+  let frontmatters = contents.map(fm);
+
+  // find all attribute keys
+  const seenAttributes = new Set();
+  frontmatters.forEach(item => {
+    Object.keys(item.attributes).forEach(attr => seenAttributes.add(attr));
+  });
+  const attributes = Array.from(seenAttributes.values());
+
+  if (attributes.includes("order")) {
+    frontmatters = frontmatters.sort(sorter);
+  }
+
+  // get all data into an array
+  let rows = frontmatters.map(item => {
+    const row = attributes.map(attr =>
+      item.attributes[attr] ? JSON.stringify(item.attributes[attr]) : ""
+    );
+    return row;
+  });
+
+  // header row must be first row
+  rows.unshift(attributes);
+
+  // join into CSV string
+  const csv = rows.map(row => row.join(",")).join("\n");
+
+  // write file out
+  await fs.writeFile(outputPath, csv);
+
+  console.log(`Wrote ${rows.length} rows to ${outputPath}`);
+
+  // make links csv
+  let longestLength = 0;
+  let linksArray = frontmatters.map(row => {
+    const links = parseLinks(row.body).filter(isUrl);
+    longestLength = longestLength > links.length ? longestLength : links.length;
+    const newRow = [row.attributes.order, row.attributes.title, ...links];
+    return newRow;
+  });
+
+  if (longestLength) {
+    // add title row
+    linksArray = linksArray.map(array => {
+      const lengthToFill = longestLength + 2 - array.length;
+      return array.concat(Array.from({ length: lengthToFill }).fill(""));
+    });
+
+    linksArray.unshift(
+      ["order", "title"].concat(
+        Array.from({ length: longestLength }).map((_, index) => `link${index}`)
+      )
+    );
+
+    // join into CSV string
+    const linksCsv = linksArray.map(row => row.join(",")).join("\n");
+
+    // write file out
+    await fs.writeFile(linksOutputPath, linksCsv);
+
+    console.log(`Wrote ${linksArray.length} rows to ${linksOutputPath}`);
+  }
+}
+
+createCsv();

csv.js

@@ -0,0 +1,44 @@
+module.exports = {
+  siteMetadata: {
+    title: "Gatsby Starter Course",
+    subtitle: "For making great content",
+    description:
+      "This is the description that will show up when people share as well as on search engines",
+    keywords: [
+      "this is",
+      "a list of keywords and phrase",
+      "that search engines",
+      "will index your page for"
+    ]
+  },
+  //pathPrefix: "/my-repo-name", // if you're using GitHub Pages, put the name of the repo here with a leading slash
+  plugins: [
+    `gatsby-plugin-layout`,
+    {
+      resolve: `gatsby-source-filesystem`,
+      options: {
+        path: `${__dirname}/lessons`,
+        name: "markdown-pages"
+      }
+    },
+    `gatsby-plugin-react-helmet`,
+    {
+      resolve: `gatsby-transformer-remark`,
+      options: {
+        plugins: [
+          `gatsby-remark-autolink-headers`,
+          `gatsby-remark-copy-linked-files`,
+          `gatsby-remark-prismjs`,
+          {
+            resolve: `gatsby-remark-images`,
+            options: {
+              maxWidth: 800,
+              linkImagesToOriginal: true,
+              sizeByPixelDensity: false
+            }
+          }
+        ]
+      }
+    }
+  ]
+};

gatsby-config.js

@@ -0,0 +1,40 @@
+const path = require("path");
+
+exports.createPages = ({ actions, graphql }) => {
+  const { createPage } = actions;
+
+  const lessonTemplate = path.resolve(`src/templates/lessonTemplate.js`);
+
+  return graphql(`
+    {
+      allMarkdownRemark(
+        sort: { order: DESC, fields: [frontmatter___order] }
+        limit: 1000
+      ) {
+        edges {
+          node {
+            excerpt(pruneLength: 250)
+            html
+            id
+            frontmatter {
+              order
+              path
+              title
+            }
+          }
+        }
+      }
+    }
+  `).then(result => {
+    if (result.errors) {
+      return Promise.reject(result.errors);
+    }
+
+    result.data.allMarkdownRemark.edges.forEach(({ node }) => {
+      createPage({
+        path: node.frontmatter.path,
+        component: lessonTemplate
+      });
+    });
+  });
+};

gatsby-node.js

@@ -0,0 +1,26 @@
+---
+path: "/intro"
+title: "Introduction"
+order: "1A"
+section: "The First Section"
+description: "this is the description that will show up in social shares"
+---
+
+This is page one.
+
+## Check out this image
+
+![Gatsby Logo](./images/logo.svg)
+
+## Check out a code sample
+
+```js
+const x = 2 + 2;
+```
+
+- This is a link to [Frontend Masters][fem].
+- This another link to [Brian Holt's Twitter](https://twitter.com/holtbt).
+- Here's another link to a [site built with this starter][containers].
+
+[fem]: https://www.frontendmasters.com
+[containers]: https://btholt.github.io/complete-intro-to-containers/

lessons/images/logo.svg

@@ -0,0 +1,9 @@
+---
+path: "/page-2"
+title: "Page 2"
+order: "2A"
+description: "The second page"
+section: "The Second Section"
+---
+
+This is page [two](https://en.wikipedia.org/wiki/2).

lessons/intro.md

@@ -0,0 +1,11 @@
+---
+path: "/page-3"
+title: "Page 3"
+order: "2B"
+description: "The third page"
+section: "The Second Section"
+---
+
+This is page three.
+
+I think it is a good page.