2024-02-17 18:09:50 +00:00
|
|
|
|
## What is XeNote?
|
|
|
|
|
XeNote is a free open-source alternative solution to [Obsidian Publish](https://obsidian.md/publish)
|
2020-12-01 03:54:55 +00:00
|
|
|
|
|
2024-02-17 18:09:50 +00:00
|
|
|
|
Here's how it looks once published, checkout demo here: [demo](https://tristonarmstrong.com/notes)
|
2022-04-20 02:35:44 +00:00
|
|
|
|
|
2024-02-17 18:09:50 +00:00
|
|
|
|
This website includes a published version of default Obsidian Help vault, See it in action here
|
2022-04-20 02:35:44 +00:00
|
|
|
|
|
|
|
|
|
**MindStone features:**
|
|
|
|
|
|
2024-02-17 18:09:50 +00:00
|
|
|
|
- ✅ **Drop-in** support for (default) **Obsidian Vault**
|
2022-04-20 02:35:44 +00:00
|
|
|
|
- ✅ `[[Wiki Link]]` built-in support
|
|
|
|
|
- ✅ **Folder-base** navigation side bar
|
|
|
|
|
- ✅ Backlink support out of the box
|
2024-02-17 18:09:50 +00:00
|
|
|
|
- ✅ Interactive Graph view
|
2022-04-20 02:35:44 +00:00
|
|
|
|
- ✅ **Easy to deploy** to Netlify, Vercel...
|
|
|
|
|
|
|
|
|
|
## 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)
|
2024-02-17 18:09:50 +00:00
|
|
|
|
2. Install [yarn](https://classic.yarnpkg.com/lang/en/docs/install/#mac-stable) package manager
|
2022-04-20 02:35:44 +00:00
|
|
|
|
3. Copy all of your **markdown** file (`.md` only) and folder to `/posts/` **except** `/posts/index.md` file
|
2024-02-17 18:09:50 +00:00
|
|
|
|
4. Copy all of your images from your Obsidian Vault to `/public/images/` folder
|
2022-05-17 00:35:39 +00:00
|
|
|
|
5. Go to root folder of your project, run `yarn && yarn run dev`
|
2024-02-17 18:09:50 +00:00
|
|
|
|
6. Open this link in your browser http://localhost:3000/
|
2022-04-20 02:35:44 +00:00
|
|
|
|
|
2022-04-20 04:14:21 +00:00
|
|
|
|
If you prefer video content have a look at my 📺 [walk through video](https://youtu.be/7_SmWA-_Wx8)
|
2022-04-20 02:35:44 +00:00
|
|
|
|
|
|
|
|
|
### Publish to the internet
|
|
|
|
|
|
|
|
|
|
Setup environment (with Netlify)
|
|
|
|
|
1. Create your Github account and clone [my repository](https://github.com/TuanManhCao/digital-garden)
|
2024-02-17 18:09:50 +00:00
|
|
|
|
2. Create Netlify account and follow [this instruction](https://www.netlify.com/blog/2020/11/30/how-to-deploy-next.js-sites-to-netlify/)
|
2022-04-20 02:35:44 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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
|
|
|
|
|
|
2024-02-17 18:09:50 +00:00
|
|
|
|
If you prefer video content, watch my 📺 [walk through video](https://youtu.be/n8QDO6l64aw) here
|
2022-04-20 02:35:44 +00:00
|
|
|
|
|
2024-02-17 18:09:50 +00:00
|
|
|
|
## Future development
|
2022-04-20 02:35:44 +00:00
|
|
|
|
|
|
|
|
|
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):
|
2024-02-17 18:09:50 +00:00
|
|
|
|
- 🎯 Obsidian, Notion, VSCode Plugin
|
2022-04-20 02:35:44 +00:00
|
|
|
|
- 🎯 Page Preview (like Obsidian Core plugin)
|
|
|
|
|
- 🎯 Andy Sliding pane
|
|
|
|
|
- 🎯 Full text search with `Cmd + K`
|
|
|
|
|
- 🎯 Infinite canvas for browsing through notes and connections
|
|
|
|
|
|
|
|
|
|
### 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.
|
2024-02-17 18:09:50 +00:00
|
|
|
|
- Transclusion is not working yet.
|