To file and exchange texts,
txt uses plain-text headers on the top of
text files. The basic headers include an
identifier, topics, authors and a date. It also needs to know basic repository information.
txt init will initialise a text repository in the current directory.
.logarion directory is created, containing a configuration file, which is
editable with a text editor.
That's where you can name the text repository and declare the archivists'
names, which will also function as the default author name for new texts.
To create new text files with the header fields to populate, use
txt new "title", replacing
title with the text's title.
The command will return the filename of the new text.
The filename starts with a part of the ID and the title of the text.
Use the file name to open it with your text editor.
New texts can be filed in different subdirectories to create sub-repositories
of finished texts.
One use of that is to separate some of the texts to share with others.
txt file .., replacing the dots with text file names and directories,
and txt will file (hard-link) each text into every directory specified.
Note, this is different from using the Topics header field to declare the text's subjects.
Generate web sites and Gemini capsuled of a text collection using
txt file some texts in a subdirectory
txt file a.txt b.txt .. some/) then call
txt convert somedir.
It will scan all text files in there and convert them to other formats.
It will also produce index files for those formats and also generate an
This index pack is a feed for other people using
index.pck and the text files of the subdirectory to a host of
If the host provides HTTP or Gemini access, upload
txt to clone remote repositories, add the URLs of the repositories in
Both files must be created first.
Once the files are populated with the URLs, run
txt pull and it will clone
all of the text files shared in those repositories in a local
As the name suggests,
peers.priv.conf is private and the URLs contained in it will not be copied into
On the other hand, URLs in
peers.pub.conf will be included in the
index.pck, providing a way to discover other text repositories.