# blog-1

**Repository Path**: bgoonz/blog-1

## Basic Information

- **Project Name**: blog-1
- **Description**: My blog. Powered by Gatsby.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-08-25
- **Last Updated**: 2021-08-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# janosh.dev

The code for my personal blog. I use it to write about physics, machine learning, sustainability and web development.

The site is fully responsive, built with [Gatsby](https://gatsbyjs.org), has [fluid typography](https://css-tricks.com/snippets/css/fluid-typography), relies heavily on [React Hooks](https://reactjs.org/docs/hooks-intro) for stateful function components and CSS grid for layout. It uses the following libraries:

- [**MDX**](https://mdxjs.com) for interactive content
- [**styled-components**](https://styled-components.com) for appearance
- [**KaTeX**](https://katex.org) for typesetting math
- [**gatsby-remark-vscode**](https://gatsbyjs.org/packages/gatsby-remark-vscode) for syntax highlighting
- [**Disqus**](https://disqus.com) for blog post comments
- [**Algolia**](https://algolia.com) for custom search
- [**react-spring**](https://react-spring.io) for animations

Feel free to reuse the whole or any part of this repo to create your own Gatsby site.

## Installation

To get this site running locally, you need to have installed [`git`](https://git-scm.com), [`gatsby-cli`](https://gatsbyjs.org/docs/gatsby-cli) and [`yarn`](https://yarnpkg.com) (or [`npm`](https://npmjs.com)). Then follow these steps:

1. Clone the repo to your machine and change into its directory.

   ```sh
   git clone https://github.com/janosh/blog \
   && cd blog
   ```

2. Optionally setup `git` hooks (recommended if you intend to open a PR).

   ```sh
   git config core.hooksPath src/utils/gitHooks \
   && chmod -R u+x src/utils/gitHooks
   ```

3. Install dependencies.

   ```sh
   yarn
   ```

4. Start the dev server. This may take a while on initial compilation since the site uses quite a lot of images which Gatsby creates thumbnails of and then caches.

   ```sh
   gatsby develop
   ```

## Deployment

The easiest way to get this site published is as follows:

1. Create an account with [netlify](https://netlify.com).

2. Install the [`netlify-cli`](https://netlify.com/docs/cli).

3. Login to your account.

   ```sh
   netlify login
   ```

4. Connect your GitHub repo with your netlify account for [continuous deployment](https://docs.netlify.com/cli/get-started/#usage-data-collection).

   ```sh
   netlify init
   ```

5. Finally deploy the site with

   ```sh
   netlify deploy
   ```