Package: tools4zettelkasten
This project provides tools to setup a digital Zettelkasten System based on
simple interlinked markdown files.What is a Zettelkasten?A Zettelkasten is a structured collection of notes. The Zettelkasten is a tool
to approach complex ideas and concepts. It serves to support and structure
one’s thinking about essential topics. Thus the note box can help to formulate
and publish own thoughts.Zettel is the German word for a small piece of paper, and Kasten means box. So
a Zettelkasten is a box full of small pieces of paper. Therefore a Zettelkasten
is often referred to as a slip box.The idea of a slip box goes back to Niklas Luhmann (1927-1998) [1]. An
exceptionally productive sociologist measured by his publications. Söhnke
Ahrens explained Luhmann’s approach in his book “Das Zettelkasten-Prinzip” [2]
and contributed significantly to popularizing the concept. The book was
translated into English under “How to take smart notes.“ Through this title,
one can find numerous explanations of the methodology on the Internet.How to set up a digital Zettelkasten?To use the system, you don’t need any special software. Any Editor (e.g.
VSCode, Atom, Vim, etc.) capable of editing Markdown can be used.Every slip (zettel)  is a simple markdown file. These markdown files might
contain images or mathematical formulas.Using the Zettelkasten is 95% about how to write notes and how to name them.
Just 5% is about organizing these notes withtools4zettelkasten. Please
refer to my “step by step guide” on how to setup a Zettelkasten.https://www.mycelium-of-knowledge.org/step-by-step-instructions-for-setup-and-use-of-the-zettelkasten/How to usetools4zettelkasten?Starttools4zettelkastenThe Zettelkasten tools provide a set of tools to manipulate the markdown files
to significantly improve the handling of a big number of zettel / markdown
files. With Zettelkasten you can effortlessly change the hierachy as well as
the interlinks of your Zettelkasten.python-mtools4zettelkastenWill open a help page with all available commands. You can get further
information about a command (e.g. for the commandstage) by typing:python-mtools4zettelkastenstage--helpThe Zettelkasten shows the zettel files as html and provides a simple
webeserver to do so. It uses flask, a markdown to html converter and bootstrap
to do so in a responsive GUI.Features oftools4zettelkastentools4zettelkastenprovides a set of tools to manipulate the markdown files
to significantly improve the handling of a big number of zettel / markdown
files. With Zettelkasten you can effortlessly change the hierachy as well as
the interlinks of your Zettelkasten.With thestagecommand you can rename all Zettel / Markdown files in the
input directory, so that they conform to the naming convention. (have a look at
myhttps://www.mycelium-of-knowledge.org/step-by-step-instructions-for-setup-and-use-of-the-zettelkasten/for more information on how and why (!) you should name the files accodring to
the naming convention). The name will be formed from the title in the markdown
file (e.g.titlein# title).With thereorganizecommand you can change the alphanumeric numbering of
the Zettel / Markdown files in your Zettelkasten directory.Suppose you have a Zettelkasten with the following files:...01_12_Quality_of_notes_eccb21483.md01_12a_How_to_integrate_notes_into_the_note_box_e0d27e3ad.md01_12a_1_Integration_of_fleeting_notes_97a19382a.md01_12a_2_Integration_of_literature_notes_ec83f31a2.md01_12b_Working_with_alphanumeric_Ordering_en036a6bd.md01_13_How_to_revisit_notes_a161a7e7c.md...The after using thereorganizecommand, the files will be renamed as
follows:...01_12_Quality_of_notes_eccb21483.md01_13_How_to_integrate_notes_into_the_fleeting_box_e0d27e3ad.md01_13_1_Integration_of_fleeting_notes_97a19382a.md01_13_2_Integration_of_literature_notes_ec83f31a2.md01_14_Working_with_alphanumeric_Ordering_en036a6bd.md01_15_How_to_revisit_notes_a161a7e7c.md...This way you will always have a clean alphanumeric numbering of the Zettel /
Markdown files.How to setup the tools4zettelkasten?Right nowtools4zettelkastenis still in alpha mode. You need to download
or clone the repo. You can start the scripts via the command line:python-mtools4zettelkastenYou will have to install the missing dependencies via pip. So you may want to
use a virtual environment. Seehttps://rreben.github.io/tools4zettelkasten/for
further information.I am planning to publishtools4zettelkastenas a package on PyPI. So you
can install it via pip.First of all you have to telltools4zettelkastenwhere to find the
directory of your zettelkasten.You could use the following directory structure: We store the Markdown files in
a simple folder with the following directory structure:├──input/│└──images/└──mycelium/└──images/Any other directory structure is possible, but you need to have the images in
theimages/directory, if you want to use the flask server.First of all use theshowcommand to show the current configuration:python-mtools4zettelkastenshowIn MacOS you can use the following command to set the environment variables:exportZETTELKASTEN=/Users/me/Documents/zettelkasten/mycelium/exportZETTELKASTEN_INPUT=/Users/me/Documents/zettelkasten/input/Where/Users/me/Documents/zettelkasten/mycelium/is the directory of your
zettelkasten and/Users/me/Documents/zettelkasten/input/is the directory
of your input folder.How to contribute?Seehttps://rreben.github.io/tools4zettelkasten/for more information on how to
build and use this project.Seehttps://www.mycelium-of-knowledge.org/for a discussion of the project.The documentation can also be found athttps://tools4zettelkasten.readthedocs.io/en/latest/