Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/srid/emanote.obelisk
Incremental fast build engine cum unique navigation UI (with search) for plain-text notes, optimized for private notebooks.
https://github.com/srid/emanote.obelisk
markdown plaintext zettelkasten
Last synced: about 2 months ago
JSON representation
Incremental fast build engine cum unique navigation UI (with search) for plain-text notes, optimized for private notebooks.
- Host: GitHub
- URL: https://github.com/srid/emanote.obelisk
- Owner: srid
- License: agpl-3.0
- Created: 2021-01-27T02:25:32.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2021-05-18T22:55:24.000Z (over 3 years ago)
- Last Synced: 2024-10-11T23:49:18.424Z (2 months ago)
- Topics: markdown, plaintext, zettelkasten
- Language: Haskell
- Homepage: https://www.srid.ca/emanote-obelisk
- Size: 706 KB
- Stars: 11
- Watchers: 6
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-starred - srid/emanote.obelisk - Incremental fast build engine cum unique navigation UI (with search) for plain-text notes, optimized for private notebooks. (markdown)
README
# emanote (legacy Obelisk app)
[](https://nixos.org) [](https://github.com/obsidiansystems/obelisk)
[](https://app.element.io/#/room/#neuron:matrix.org)
Write plain-text notes, but do complex things with it - such as to eman**a**te a smart notebook.
> *emanate*: (of something abstract but perceptible) issue or spread out from (a source).
NOTE: This is the old Obelisk app, as distinct from [emanote](https://github.com/srid/emanote) the neuron successor.
## Purpose
Goals: large **private** Zettelkastens, **dynamic** navigation, simplicity, performance.
Non-goals: static site publishing, theming.
Maybe-goals: use `emanote-core` as a core library in neuron.
## Give it a test-drive
Clone the source, and read `./doc/Development.md`
## Self-host it in production
If you use NixOS, [obelisk-systemd](https://github.com/obsidiansystems/obelisk-systemd) can be used to automate self-hosting. Otherwise, on other Linux, follow the instructions below.
1. Install Nix
1. Set up nix cache by following [instructions here](https://github.com/obsidiansystems/obelisk#installing-obelisk)
2. Build it (might take a while):
```
nix-build -A exe -j auto -o ./result
```
3. Prepare runtime files:
```
mkdir ~/my-emanote
cp -r ./result/* ~/my-emanote
cp -r config ~/my-emanote/
```
4. Tell emanote where your Zettelkasten (directory of Markdown files) lives:
```
vim ~/emanote/config/backend/notesDir
```
5. Run it! (on http://localhost:8000)
```
cd ~/my-emanote
./backend -p 8000 #
```
6. NOTE: When self-hosting and exposing under a different address, say www.example.com, you must edit `~/my-emanote/config/common/route` to contain the corresponding URL, i.e., `https://www.example.com`.
## Editing notes
Emanote does not provide a editor. However, if you use [Syncthing](https://syncthing.net/) - and edit your notes locally, Emanote's view will update automatically without refresh. This mimicks the "live preview" feature (have your text editor open on side, and the web browser with emanote on another side).
## Talk about it
Join us in Matrix: https://app.element.io/#/room/#neuron:matrix.org