forked from TuanManhCao/digital-garden
-
-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* build: replace package manager * chore(deps): add typescript * chore: ignore graph-data.json * fix: replace some javascript files to typescript file I also fixed Tree expansion bug. * fix: infinite loop issue * chore: replace branding and README.md
- Loading branch information
Showing
16 changed files
with
5,710 additions
and
4,663 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -30,3 +30,5 @@ yarn-debug.log* | |
yarn-error.log* | ||
|
||
.vercel | ||
|
||
/graph-data.json |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,58 +1,23 @@ | ||
## What is MindStone? | ||
MindStone is a free open-source alternative solution to [Obsidian Publish](https://obsidian.md/publish) | ||
## Volglass | ||
Volglass is a fork of [MindStone(digital-garden)](https://github.com/TuanManhCao/digital-garden) but many codes replaced to typescript. | ||
|
||
Here how it look like once published, checkout [demo version](https://mindstone.tuancao.me/) here: | ||
|
||
![](public/images/CleanShot%202022-04-20%20at%2008.34.17@2x.png) | ||
|
||
This website include a published version of default Obsidian Help vault, See it in action here | ||
|
||
**MindStone features:** | ||
|
||
- ✅ **Drop-in** support for (default) **Obsidian Vault** | ||
- ✅ `[[Wiki Link]]` built-in support | ||
- ✅ **Folder-base** navigation side bar | ||
- ✅ Backlink support out of the box | ||
- ✅ Interactive Graph view | ||
- ✅ **Easy to deploy** to Netlify, Vercel... | ||
It is this project's goal to be a free open-source alternative solution to [Obsidian Publish](https://obsidian.md/publish) | ||
|
||
## Getting started | ||
### Run on your local machine | ||
|
||
Steps to run it on your local machine: | ||
1. Clone this [Github repo](https://github.com/TuanManhCao/digital-garden) | ||
2. Install [yarn](https://classic.yarnpkg.com/lang/en/docs/install/#mac-stable) package manager | ||
1. Clone this [Github repo](https://github.com/turtton/volglass) | ||
2. Install [pnpm](https://pnpm.io/installation) package manager | ||
3. Copy all of your **markdown** file (`.md` only) and folder to `/posts/` **except** `/posts/index.md` file | ||
4. Copy all of your images from your Obsidian Vault to `/public/images/` folder | ||
5. Go to root folder of your project, run `yarn && yarn run dev` | ||
5. Go to root folder of your project, run `pnpm i && pnpm run dev` | ||
6. Open this link in your browser http://localhost:3000/ | ||
|
||
If you prefer video content have a look at my 📺 [walk through video](https://youtu.be/7_SmWA-_Wx8) | ||
|
||
### Publish to the internet | ||
|
||
Setup environment (with Netlify) | ||
1. Create your Github account and clone [my repository](https://github.com/TuanManhCao/digital-garden) | ||
2. Create Netlify account and follow [this instruction](https://www.netlify.com/blog/2020/11/30/how-to-deploy-next.js-sites-to-netlify/) | ||
|
||
|
||
Your normal workflow for publishing content, after initial setup is: | ||
1. Simply writing your content in Obisidian (or your favourite Markdown editor) | ||
2. Commit your changes and Push it to your Github repo | ||
|
||
If you prefer video content, watch my 📺 [walk through video](https://youtu.be/n8QDO6l64aw) here | ||
|
||
## Future development | ||
|
||
These are just some basic features for MindStone v1, many more are coming (if I find enough of interest and this will probably a premium/paid option): | ||
- 🎯 Obsidian, Notion, VSCode Plugin | ||
- 🎯 Page Preview (like Obsidian Core plugin) | ||
- 🎯 Andy Sliding pane | ||
- 🎯 Full text search with `Cmd + K` | ||
- 🎯 Infinite canvas for browsing through notes and connections | ||
- Embed markdown/image rendering | ||
- Text search | ||
- Tag list view | ||
|
||
### Some know issues | ||
This an early version of MindStone, which mean there are bugs and issues. Below are some known issues, that I plan to work on: | ||
- Graphview does not load when clicking on side-bar or click node on graphview, browser reload will refresh it state | ||
- Graph view layout and interaction is still very rough. More UI/UX improvements are needed. | ||
- Transclusion is not working yet. | ||
I also plan to create a CLI application for easy environment building and updating. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.