This repo contains the official source code for the Delta Lake website.

This site requires Node 16, which you can install with brew install node@16.

This site requires a development YOUTUBE_API_KEY which populates the YouTube videos in the learn > videos, learn > tutorials, and community pages. That is, ensure you have created a .env.development file in the root folder; the file should look like:

//.env.development

YOUTUBE_API_KEY = $API_KEY$

• To generate an API key, refer to How to Get a YouTube API Key [Tutorial Examples]
• For more information on Gatsby environment files, please refer to How to implement '.env' variables in Gatsby and React

Simply check out this repo, run npm install --legacy-peer-deps, then run npm run develop.

To open a localhost version of the site, run npm run start.

If you use Visual Studio Code, install the Prettier and ESLint extensions to automatically format your code as you make changes.

Alternatively, you may run npm run lint or npm run lint:fix to both check for and fix lint issues, respectively. All changes are automatically linted (and will attempt to auto-fix) on the git pre-commit hook.

This repo runs automated checks on PRs, like the lint check above. Sometimes this process can hang. If you see the process hang, try running an empty commit and push the commit to rerun the checks. You can do this by running the following git command git commit --allow-empty -m "Empty commit" then pushing the commit to origin.

All PRs require linters to pass in order to deploy to production.

All changes are proposed as a pull request. Simply create a pull request and request a review and we'll get on it.

You can add a blog by adding a directory with some files to src/blog. Here's an example:

src/
  blog/
    2022-09-23-convert-parquet-to-delta/
      index.mdx
      thumbnail.png

All of the images that correspond to the blog post should be saved in the respective folder.

The top of the index.mdx file should contain the following metadata:

---
title: Converting from Parquet to Delta Lake
description: This post shows how to convert a Parquet table to a Delta Lake.
thumbnail: ./thumbnail.png
author: Matthew Powers
---

You can also add the new blog post to the homepage by updating the src/components/pages/index/LatestUpdateSection/index.jsx file.

This commit is a good example of how to add a blog post.