$ cats nobody@supertxt.net:00-intro.s.txt

# SuperTXT, Simple Text, and More

TXT
It's just a small set of conventions, built with established technologies, that unleashes a new world of interaction.

Simple text files, such as this one, have a number of really great properties:

Recent advancements have made things even better. The standardization of the line terminators eliminates entire classes of interoperability problems. Introduction of Unicode UTF-8 encoding opens the format to a vast number of symbols in a largely transparent way. Lightweight markup languages demonstrated that conventions can be used to create beautiful representations without sacrificing the legibility of the source code.

SuperTXT builds on this foundation with new principles:

Do you want to learn more? A good place to start is the [:@getting started] guide.

## News

## Articles

Here are some places to immerse yourself in this realm.

→ (getting started) start.s.txt
→ browsing.s.txt
→ semantics.s.txt
→ hosting.s.txt
→ whats-sshla.s.txt
→ (site-specific command) intro-to-ssc.s.txt
→ web-interop.s.txt
→ (Options, Arguments, and Tables) options-arguments-tables.s.txt
→ (WA-Nine) articles/2023-11-22-announcing-wanine.s.txt

Check out our log of articles here:

→ articles/index.s.txt

## Site Usage

If you're reading this site using your web browser, that's great. All of the web functions and more are also available via Secure SHell (SSH). You can browse this site in high fidelity over SSH with a little help from two tools: brsh, and [:@cats]. You'll need to generator yourself an encryption key first.

.sh
ssh-keygen # The defaults are usually fine and the passphrase can be empty

An easy way to get started is to use [:@homebrew] with the [:@homebrew tap] hosted here to install these tools.

.sh
brew tap supertxt/tap ssh://nobody@supertxt.net/git/st-brew
brew install supertxt/tap/cats supertxt/tap/brsh

From the browsing shell (brsh) you can navigate here using cats like this.

.sh
cats nobody@supertxt.net:
→ (homebrew) https://brew.sh

If you have the Go language tools installed here is another way to install commands.

.sh
go install supertxt.net/git/cats/cmd/cats@latest
go install supertxt.net/git/st-int/cmd/brsh@latest

This site doesn't require any special tools. You can use ssh from any shell (bash, zsh, brsh, or other Unix shell) like this:

.sh
ssh nobody@supertxt.net cat whats-sshla.s.txt # .s.txt

If you use [:@cats] the command is much simpler with a single pathname2 for the document, like what you would expect from other SSH tools.

.sh
cats nobody@supertxt.net:whats-sshla.s.txt

There are also git repositories here that can be cloned.

.sh
git clone nobody@supertxt.net:git/cats

Site search is available with the "srch" command.

.sh
ssh nobody@supertxt.net srch <<EOF
inline link
EOF

You can learn more about this site's built-in commands in the manual. Check out ccmnt (conventional comments) command for leaving feedback.

.sh
ssh nobody@supertxt.net man # Show list of available commands
ssh nobody@supertxt.net man git # Show available git commands
note: The "nobody" user is optional for this site, but recommended to prevent leaking of your user name.

## Specifications

This site contains a number of specifications used here, and can be used elsewhere too.

→ specs/index.s.txt

## Repositories

The following git repos are available here.

→ (cats) git/cats.s.txt
→ (SuperTXT Integrations) git/st-int.s.txt
→ (homebrew tap) git/st-brew.s.txt

## Other SSH Sites

→ (known-hosts) .ssh/known_hosts

## Trust

Some content on this site is signed, such as git commits. Here's the list of allowed signers.

→ (allowed-signers) .ssh/allowed_signers

## Legal

→ (license) LICENSE.txt

## Contact Us

## Feedback

HAVE SOME FEEDBACK FOR US?

You can give us [:@conventional comments] on these documents. Here's how you can give this document some praise.

.sh
ssh nobody@supertxt.net ccmnt 00-intro.s.txt <<EOF
praise: Looks good
EOF
→ (conventional comments) https://conventionalcomments.org