zek

KO | EN

gitlite — search

#javascript #hacktoberfest #react #typescript #llm #golang #deep-learning #docker #macos #java #awesome-list #vue #pytorch #ios

(★ 99)

No description available.

파일 탐색기

최종 버전 다운로드 (.zip)

- 01|23|22.md
- amphibians.md
- archean eon.md
- birds.md
- cambrian period.md
- carboniferous period.md
- cenozoic era.md
- devonian period.md
- fish.md
- geological timescales.md
- mesozoic era.md
- ordovician period.md
- paleozoic era.md
- permian period.md
- phanerozoic eon.md
- proterozoic eon.md
- reptiles.md
- silurian period.md
- vertebrates.md
- time.zig
- todo_experimental.zig
- util.zig
- validator.zig
- zek.zig
.gitignore
build-crossplatform.sh
build.zig
help todo.mdx
help.md
README.md
zek.exe.obj
zek.o
zek_debian
zek_linux
zek_macos_M1
zek_macos_x86
zek_pi_zero_1
zek_windows.exe

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ZEK: Take Roam-like Notes in a Line Editor, Written in Zig

https://www.youtube.com/watch?v=4W_m176PIdU

"ZEK" stands for "Zig Editor of Knowledge". It is written in ziglang for maximum performance. It is based on the Zettelkasten system, also called a PKMS, or a "roam-like" editor. It lets you create notes that are deeply linked, without hierarchies. It supports:
- Backlinks
- Support for outlines in each page
- All database files are accessible as text files
- An "overview" generator for the database
- Automated syncronization to a git repository, allowing for multi-device usage of a database

Zek was created by Conrad Barski (The author of "Land of Lisp" as well as other books.) Follow Conrad on twitter at: www.twitter.com/lisperati

# Installing ZEK

ZEK IS STILL ALPHA-QUALITY SOFTWARE, PLEASE BE KIND IF YOU RUN INTO ANY BUGS!

To use ZEK, simply put the ZEK executable on the path for your OS. The repository contains four pre-built x86 executable files (`zek_linux`, `zek_macos_x86`, `zek_macos_M1`, or `zek_windows.exe`) which you should rename to 'zek'. Then, set up a new directory on your PC that will contain your database files. Place the file `help.md` in this directory, for easy access to help information, via the 'h' key. (The help file is just another file in the database.)

# Building ZEK

If you have another OS or CPU, install the zig programming language on your computer (last tested with zig version 0.10.0) and then run `zig build` to generate an executable for your purpose in the `zig-out/bin` directory.

# Running ZEK

Simply execture `zek` from the directory where you want your database files to live. Now follow the youtube video above for basic usage. Hit 'h' for a full list of commands.

# Validating the Database

ZEK will ensure that every linked page has a matching backlink, and will also maintain other database properties. If you ever edit database files by hand, it is therefore recommended that you have ZEK validate the database again to make sure there are no errors in the structure of the database. To do this, run ZEK with the '-validate' flag, i.e. `zek -validate`.

# FAQ

Q: What part of the database is loaded into RAM when the app runs?

A: Only the current page, and the previously-used page (so you can quickly go 'back'). This makes the app extremely fast and light weight. Edits to the current page are saved back to the disk at the moment when another page is visited or when you press [enter] from the prompt (which does nothing aside from saving your work). When a page is saved and it has new links to other pages, the backlinks to those pages are updated on disk at that time as well. However, those other pages are not loaded into RAM to do this.

Q: What is the command for creating a page?

A: To create a page, simply link to the page in square brackets from another page. The only pages that can exist without a link from another page are the calendar pages (which have a date in the title) so you can always just mention on today's calendar day that you are creating a new page, and this automatically creates the page.

Q: Why do the files for date pages have pipe symbols in them?

A: Most OSes don't like file names with slashes. However, when referencing date pages from within zek you can just use reference dates with the usual slashes.

Q: How do I rename a page?

A:You do this by editing the root node of the page outline, which contains the name of the page. To do this, simply perform the edit command `e` without any path (the empty path is the path for the root node).

Q: Why is the command for deleting a page called "yeet"?

A: All commands in ZEK are single letter commands, and I ran out of letters in the alphabet, aside from 'y'.

# License

ZEK is licensed with the Eclipse Public License 1.0 http://opensource.org/licenses/eclipse-1.0.php

zek

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

zek

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README