https://github.com/devinhalladay/oikos-garden

This digital garden is the personal wiki of Devin Halladay, a designer and writer based in Manhattan
https://github.com/devinhalladay/oikos-garden

digital-garden gatsby roamcult roamresearch wiki

Last synced: about 2 months ago
JSON representation

This digital garden is the personal wiki of Devin Halladay, a designer and writer based in Manhattan

• Host: GitHub
• URL: https://github.com/devinhalladay/oikos-garden
• Owner: devinhalladay
• License: gpl-3.0
• Created: 2021-09-22T16:23:28.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2022-11-30T23:40:46.000Z (about 2 years ago)
• Last Synced: 2024-08-08T18:21:10.831Z (5 months ago)
• Topics: digital-garden, gatsby, roamcult, roamresearch, wiki
• Language: TypeScript
• Homepage: oikos-garden.vercel.app
• Size: 525 MB
• Stars: 4
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-starred - devinhalladay/oikos-garden - This digital garden is the personal wiki of Devin Halladay, a designer and writer based in Manhattan (others)

README

        
# Infinite Caesura — Personal Wiki

This is the personal wiki of Devin Halladay, a designer and writer based in Manhattan. The code is open source and licensed under GPL; I would only ask that, as a courtesy, you let me know if you borrow or remix any of my code.

[![GPL Logo](https://www.gnu.org/graphics/gplv3-127x51.png)](https://img.shields.io/github/license/devinhalladay/oikos-garden?label=LICENSE)

## Tech Stack

- **Gatsby** to generate the site

- **MDX** to embed JSX in Markdown files

- **Vercel** for hosting

- **Tailwind** and SCSS for styling

- [Custom MDX footnote transformer plugin](https://github.com/devinhalladay/oikos-garden/blob/main/plugins/footnotes.js)

  - Inspired by [Maggie's footnote component](https://github.com/MaggieAppleton/maggieappleton.com/blob/f4dbc08f3702725073680f25dd6ca197b27721d3/src/components/mdx/Footnote.js) and [gatsby-remark-reference-footnotes](https://github.com/signalwerk/gatsby-remark-reference-footnotes)

  - Transforms MDX footnotes[^1] into a configurable JSX element (eg. a react component)

- **[gatsby-theme-brain](https://github.com/aengusmcmillin/gatsby-theme-brain)** provides bi-directional links and other niceties

- **Roam** for taking notes and writing entries

[^1]: Like this one!

## Installation

1. You'll need to install Node and Yarn, if you haven't already.

2. Clone this repo

3. `cd` into the repo and run `yarn install` to install project dependencies

4. Run `yarn dev` to start the development server

## Production

- Run `yarrn build` to build the site for production.

## Thanks to:

- Maggie Appleton for [their exemplary digital garden](https://github.com/MaggieAppleton/maggieappleton.com) which helped me get my head around Gatsby.

- Aengus McMillin for their powerful [digital garden theme and plugins](https://github.com/aengusmcmillin/gatsby-theme-brain)