zinricky
/
tilde.team
forked from team/site
1
0
Fork 0
Code Pull Requests Activity

Corrects a marking typo

This commit is contained in:
zinricky 2023-02-10 12:16:29 +01:00
parent c2e344cea9
commit e2e0003fc2
1 changed files with 40 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

63
wiki/pages/logarion.md
View File

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