ethereumlocalism.xyz

How to Contribute

About

Our knowledge garden is a markdown-based wiki, built using Quartz. We generally use Obsidian to create and curate documents for our knowledge garden.

To contribute to this knowledge garden, you have two options: share resources with existing curators, or become a curator yourself. Once you’ve reached out we may ask for additional information or respond with some editorial comments, or we may post directly.


Option 1: Share Resources

If you have a resource you’d like to submit but don’t want to join the GitHub repo, you can share a Google Doc or markdown file (please include the required metadata, noted in the “Authoring Content” section below) with one of the curators - email:


Option 2: Join the Repo

  1. Download Obsidian, a Markdown editor we use for authoring.
  2. Clone the repo: https://github.com/Clinamenic/GFEL
  3. Open the /content folder in Obsidian as a vault.
  4. Request GitHub access to push updates.
  5. Create a pull request from your-branch-name to main.
  6. Once accepted, your content will go live on the site.

Authoring Content

Licensing

Knowledge Garden publications by default will be licensed under CC BY-SA 4.0. Alternative licensing can be specified via metadata (see below). About CC Licenses

Metadata (Frontmatter)

Each Markdown file should begin with a metadata section that includes at least the minimum required information shared below. This helps categorize and sort content throughout the site. Additional metadata can be included at the submitter’s discretion, examples below.

Here’s a full example:

---
title: "Community Currencies in Chiapas"
date: 2024-11-12
author: "Sofia Martínez"
tags:  - format/case-study  - place/rural  - theme/community-currency
---

Metadata Field Reference

Required

  • title: The title of your piece
  • date: Submission or publication date (YYYY-MM-DD)
  • author: Your name or author name(s)
  • tags: A list of lowercase keywords to help with categorization

Optional

  • authorURL: URL of the author
  • source: Original source of the publication
  • language: Language of the publication
  • license: License of the publication

Markdown Cheatsheet

Use standard Markdown formatting to write your content. Obsidian provides helpful shortcuts, but any text editor will work.


Content Architecture

Content lives in two main sections of the Knowledge Garden:

Library

Add or edit Markdown notes related to relevant resources, experiments, and ideas. These live in the Library/ folder.

Resources

Add full Markdown versions of longer articles, papers, and essays. These go in the Resources/ folder.

Feel free to propose new sections as the garden grows.