New
To create new text files, use “txt new”. For example:
$ txt new "Hello world"
It’s important to enclose the title with quotation marks if it contains spaces. 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.
Text files will be stored in either: 1. The directory pointed at by TXTDIR if defined 2. $HOME/.local/share/texts, if directory exists 3. The current working directory, if all else fails
The simplest approach is to put all texts in the local-share directory and override that on occasion with $TXTDIR. For example:
$ env TXTDIR=. txt new "Hello world"
txt.conf keys
- Id: A random, unique, alphanumeric string for distinguishing the repository (at least 6 characters of Crockford’s Base32 recommended)
- Title: a human-friendly title
- Authors: comma seperated list of names and, optionally, addresses
- Topics: topics the repository aims to cover
- Locations: list of URIs the repositories can be accessed
- Peers: list of peer URIs
HTML
There are some special settings for HTML publication:
- HTM-style: path to a CSS style. It will be inserted in every .htm file. To link to a single CSS consider using
@import - HTM-header: path to a file, inserted in every .htm file, right after the
<body>tag - HTM-footer: path to a file, inserted in every .htm file, right before the
</body>tag - HTM-index: if defined, determines the filename for the index files. Left undefined, defaults to
index.html - HTM-feed: if defined, this will overrite the feed URI used in HTML files. If left undefined the default
feed.atomis used
Gemtext
Likewise, there are settings for publishing on the Gemini protocol:
- Gemini-index: same as
HTM-index - Gemini-feed: same as
HTM-feed, exceptgmi.atomis used
