Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/BharatKalluri/gardener

A command line tool to help you manage your Knowledge management system / Digital Garden ᵃˡᵖʰᵃ
https://github.com/BharatKalluri/gardener

knowledge-base knowledge-management note-taking

Last synced: 5 days ago
JSON representation

A command line tool to help you manage your Knowledge management system / Digital Garden ᵃˡᵖʰᵃ

Awesome Lists containing this project

README

        


Gardener 🌱


A simple command line tool to maintain your digital garden.








Report a problem!

> Note: This is still an alpha product

Gardener is a command line tool meant to organize your digital garden.

The aim of this tool is to **get out of the way and make managing a digital garden editor/service independent.**

## Installation

You will need to install python and pip on your system.

```
pip install --user https://github.com/BharatKalluri/gardener/releases/download/0.1/gardener-0.1.0.tar.gz
```

[Will publish to pypi soon](https://github.com/BharatKalluri/gardener/issues/14)

## What can it do?

Create a `readme.md`. This will serve as an entry point for your notes. Write notes in markdown, use wiki-links (`[[file-name]]`) to link between notes.

- `gardener link` : Converts all wiki links to markdown links (so that github pages can pick these up as normal web links)
- `gardener rename `: Will rename a note and also the corresponding wiki links
- `gardener tend`: Will scan all your notes and find out which notes are not linked and will automatically create wiki links for you (coming soon in release 0.2!)

Push the updated files and switch on github pages if you please. You will have a great looking website ready for you! ([example](https://notes.bharatkalluri.in))

> Pro tip: Setup a pre-commit hook so that all your will have up to date backlinks/wikilinks. I use [lefthook](https://github.com/Arkweid/lefthook/)
personally, The config is [very simple!](https://github.com/BharatKalluri/notes/blob/master/lefthook.yml)

### What is planned?

- A graph view between all your wiki links.

### Limitations
- Although gardener handles files in nested folders, it cannot handle files having the same name.

Please do let me know if you have any other interesting ideas over at github issues!