Go to file
Soren I. Bjornstad 1f56f68448 stop using <<privateperson>> macro
Since we have to do raw links anyway in many cases, it doesn't really
make sense to use two different formats. This also gets around an edge
case where replacement produces invalid syntax if the person to be
replaced is linked within a macro, since the >> of privateperson then
terminates the outside macro -- given my increasing use of footnotes,
this isn't all that uncommon.
2022-08-19 17:09:20 -05:00
cli_docs pull ZK updates and bump version 2022-03-27 15:19:41 -05:00
docs pull ZK updates and bump version 2022-03-27 15:19:41 -05:00
tzk stop using <<privateperson>> macro 2022-08-19 17:09:20 -05:00
.gitignore check in editions directory 2021-09-21 12:27:23 -05:00
LICENSE update copyright notice 2022-03-14 20:59:57 -05:00
MANIFEST.in set up publish to pypi 2021-09-21 11:54:05 -05:00
publish.sh activate venv before trying publish 2021-09-22 11:29:05 -05:00
README.md add walkthrough video to README 2021-09-22 11:28:36 -05:00
RELEASING.md bump version 2021-09-21 20:45:44 -05:00
requirements.txt work around ReadTheDocs bug 2022-03-27 15:22:31 -05:00
setup.py pull ZK updates and bump version 2022-03-27 15:19:41 -05:00

Documentation Status

tzk (TiddlyZettelKasten) is a TiddlyWiki edition and associated CLI for maintaining personal notes in something approaching the Zettelkasten method. Its updated periodically from whatever tooling Im currently using in my own Zettelkasten. As such, its currently considered alpha-quality; while it ought to be very stable and theres no meaningful risk of data loss, updating to a newer version might be difficult and Im unlikely to accept patches unless theyre something I want in my own Zettelkasten. This is intended primarily as a nice starting platform on which to build your own tooling.

Some basic knowledge of TiddlyWiki is necessary and assumed.

Documentation / Installation

Find a live version of the edition on the web with further instructions at https://sobjornstad.github.io/tzk/. You can find the documentation for the CLI (which handles creating the wiki, versioning with Git, and creating public and other derivative versions of the wiki) at https://tzk.readthedocs.io/en/latest/.

Video walkthrough

Since tzk is still in an alpha state, general instructions on how to use it are somewhat lacking at the moment. To fill in the gap in the meantime, I recorded an hour-long walkthrough showing how you might take notes using tzk; you can select individual sections to watch if that's longer than you want. Watch the video on YouTube.