From 01c17c68277ff88fab812920732d9bbe9e6bb571 Mon Sep 17 00:00:00 2001 From: murilo ijanc Date: Tue, 24 Mar 2026 21:45:05 -0300 Subject: Simplify website to single-page Remove old Zola-generated content, keep only the essential landing page with about, contact, and license sections. --- book/en/commands/create.html | 329 ---------------------------------------- book/en/commands/create.html.gz | Bin 7137 -> 0 bytes book/en/commands/export.html | 307 ------------------------------------- book/en/commands/export.html.gz | Bin 7007 -> 0 bytes book/en/commands/init.html | 288 ----------------------------------- book/en/commands/init.html.gz | Bin 6556 -> 0 bytes book/en/commands/list.html | 283 ---------------------------------- book/en/commands/list.html.gz | Bin 6400 -> 0 bytes book/en/commands/verify.html | 307 ------------------------------------- book/en/commands/verify.html.gz | Bin 6697 -> 0 bytes 10 files changed, 1514 deletions(-) delete mode 100644 book/en/commands/create.html delete mode 100644 book/en/commands/create.html.gz delete mode 100644 book/en/commands/export.html delete mode 100644 book/en/commands/export.html.gz delete mode 100644 book/en/commands/init.html delete mode 100644 book/en/commands/init.html.gz delete mode 100644 book/en/commands/list.html delete mode 100644 book/en/commands/list.html.gz delete mode 100644 book/en/commands/verify.html delete mode 100644 book/en/commands/verify.html.gz (limited to 'book/en/commands') diff --git a/book/en/commands/create.html b/book/en/commands/create.html deleted file mode 100644 index 66db6a5..0000000 --- a/book/en/commands/create.html +++ /dev/null @@ -1,329 +0,0 @@ - - - - - - create - Tesseras User Guide - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-

Keyboard shortcuts

-
-

Press ← or → to navigate between chapters

-

Press S or / to search in the book

-

Press ? to show this help

-

Press Esc to hide this help

-
-
-
-
- - - - - - - - - - - - - -
- -
-
- - - - - - - -
-
-

tes create

-

Create a tessera from a directory of files.

-

Usage

-
tes create <PATH> [OPTIONS]
-
-

Arguments

-
- - - - - - - -
ArgumentDescription
<PATH>Directory containing files to include
-
-

Options

-
- - - - - - - - - - - - - -
OptionDescriptionDefault
-n, --non-interactiveSkip promptsoff
--dry-runPreview what would be includedoff
--visibility <VALUE>Visibility level: public, private, circlepublic
--language <CODE>Language code (e.g., en, pt-BR)en
--tags <LIST>Comma-separated tagsnone
--location <DESC>Location descriptionnone
--data-dir <PATH>Base directory for data storage~/.tesseras
-
-

Supported file formats

-
- - - - - - - - - - - -
ExtensionTypeMemory type
.jpg, .jpegImage (JPEG)Moment
.pngImage (PNG)Moment
.wavAudio (WAV PCM)Moment
.webmVideo (WebM)Moment
.txtPlain text (UTF-8)Reflection
-
-

Files with other extensions are ignored.

-

Memory type inference

-

The command automatically assigns a memory type based on the file format:

-
    -
  • Text files (.txt) are classified as Reflection — thoughts, beliefs, or opinions
    • -
  • All other formats are classified as Moment — a photo, recording, or video of something happening
    • -
-

Examples

-

Preview before creating

-
tes create ./my-photos --dry-run
-
-

Create with metadata

-
tes create ./vacation-2026 \
-    --tags "vacation,summer,beach" \
-    --location "Florianópolis, Brazil" \
-    --language pt-BR \
-    --visibility public
-
-

Non-interactive mode

-
tes create ./daily-log --non-interactive --tags "daily"
-
-

Visibility levels

-
- - - - - - - - - -
LevelWho can access
publicAnyone (default)
privateOnly you (and designated heirs)
circleExplicitly chosen people
-
-

What happens under the hood

-
    -
  1. Scans the directory for supported files
    2. -
  2. Computes a BLAKE3 hash for each file
    3. -
  3. Assigns a memory type based on file extension
    4. -
  4. Generates a MANIFEST listing all files with their checksums
    5. -
  5. Signs the MANIFEST with your Ed25519 private key
    6. -
  6. Stores the files and metadata in the local database
    7. -
  7. Outputs the content hash that uniquely identifies this tessera
    8. -
- -
- - -
-
- - - -
- - - - - - - - - - - - - - - - - - - - - - - - -
- - diff --git a/book/en/commands/create.html.gz b/book/en/commands/create.html.gz deleted file mode 100644 index db49670..0000000 Binary files a/book/en/commands/create.html.gz and /dev/null differ diff --git a/book/en/commands/export.html b/book/en/commands/export.html deleted file mode 100644 index e6ba75b..0000000 --- a/book/en/commands/export.html +++ /dev/null @@ -1,307 +0,0 @@ - - - - - - export - Tesseras User Guide - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-

Keyboard shortcuts

-
-

Press ← or → to navigate between chapters

-

Press S or / to search in the book

-

Press ? to show this help

-

Press Esc to hide this help

-
-
-
-
- - - - - - - - - - - - - -
- -
-
- - - - - - - -
-
-

tes export

-

Export a tessera as a self-contained directory.

-

Usage

-
tes export <HASH> <DEST>
-
-

Arguments

-
- - - - - - - - -
ArgumentDescription
<HASH>Tessera content hash (64 hex characters)
<DEST>Destination directory
-
-

Options

-
- - - - - - - -
OptionDescription
--data-dir <PATH>Base directory for data storage (default: ~/.tesseras)
-
-

Output structure

-

The export creates a directory named tessera-<hash> inside the destination:

-
tessera-9f2c4a1b.../
-├── MANIFEST                    # Plain text index with checksums
-├── README.decode               # Human-readable decoding instructions
-├── identity/
-│   ├── creator.pub.ed25519     # Creator's public key
-│   └── signature.ed25519.sig   # Signature of the MANIFEST
-├── memories/
-│   ├── <content-hash>/
-│   │   ├── media.jpg           # Primary media file
-│   │   ├── context.txt         # Human context in plain UTF-8
-│   │   └── meta.json           # Structured metadata
-│   └── .../
-├── schema/
-│   └── v1.json                 # JSON schema for metadata validation
-└── decode/
-    ├── formats.txt             # Explanation of all formats used
-    ├── jpeg.txt                # How to decode JPEG
-    ├── wav.txt                 # How to decode WAV
-    └── json.txt                # How to decode JSON
-
-

Example

-
tes export 9f2c4a1b3e7d8f0cabc123def4567890... ./backup
-
-
Exported to ./backup/tessera-9f2c4a1b3e7d8f0cabc123def4567890...
-
-

Key feature: self-contained

-

The exported directory is designed to be readable without Tesseras software. It includes:

-
    -
  • MANIFEST — a plain-text file listing every file with its BLAKE3 checksum, readable by any text editor
    • -
  • README.decode — human-readable instructions for understanding the contents
    • -
  • decode/ — detailed explanations of every file format used (JPEG, WAV, JSON, UTF-8)
    • -
-

This means someone thousands of years from now, with no knowledge of Tesseras, can still understand and access the memories.

-

Use cases

-
    -
  • Backup — export to an external drive, USB stick, or cloud storage
    • -
  • Sharing — give someone a complete copy of a tessera
    • -
  • Archival — store on write-once media (DVD, Blu-ray, tape)
    • -
  • Migration — move tesseras between machines without needing the database
    • -
- -
- - -
-
- - - -
- - - - - - - - - - - - - - - - - - - - - - - - -
- - diff --git a/book/en/commands/export.html.gz b/book/en/commands/export.html.gz deleted file mode 100644 index 32ccd9e..0000000 Binary files a/book/en/commands/export.html.gz and /dev/null differ diff --git a/book/en/commands/init.html b/book/en/commands/init.html deleted file mode 100644 index 0c1db91..0000000 --- a/book/en/commands/init.html +++ /dev/null @@ -1,288 +0,0 @@ - - - - - - init - Tesseras User Guide - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-

Keyboard shortcuts

-
-

Press ← or → to navigate between chapters

-

Press S or / to search in the book

-

Press ? to show this help

-

Press Esc to hide this help

-
-
-
-
- - - - - - - - - - - - - -
- -
-
- - - - - - - -
-
-

tes init

-

Initialize identity and local database.

-

Usage

-
tes init
-
-

Description

-

Sets up your local Tesseras environment. This is the first command you should run after installing Tesseras.

-

The command creates:

-
- - - - - - - - - - -
PathContents
~/.tesseras/identity/Ed25519 keypair for signing tesseras
~/.tesseras/db/SQLite database for indexing
~/.tesseras/blobs/Blob storage for memory files
~/.tesseras/config.tomlConfiguration file
-
-

Options

-
- - - - - - - -
OptionDescription
--data-dir <PATH>Base directory for data storage (default: ~/.tesseras)
-
-

Idempotent

-

Running init again is safe. If an identity already exists, it is preserved:

-
tes init
-
-
Ed25519 identity already exists
-Database initialized
-Tesseras initialized at /home/user/.tesseras
-
-

Custom data directory

-
tes --data-dir /mnt/usb/tesseras init
-
-

This creates the full directory structure under /mnt/usb/tesseras/ instead of the default location.

-

What happens under the hood

-
    -
  1. Creates the directory structure (identity/, db/, blobs/)
    2. -
  2. Generates an Ed25519 keypair (private key stays local, public key identifies you)
    3. -
  3. Runs SQLite migrations to set up the database schema
    4. -
  4. Writes a default config.toml
    5. -
- -
- - -
-
- - - -
- - - - - - - - - - - - - - - - - - - - - - - - -
- - diff --git a/book/en/commands/init.html.gz b/book/en/commands/init.html.gz deleted file mode 100644 index c3b534c..0000000 Binary files a/book/en/commands/init.html.gz and /dev/null differ diff --git a/book/en/commands/list.html b/book/en/commands/list.html deleted file mode 100644 index c8f0a2b..0000000 --- a/book/en/commands/list.html +++ /dev/null @@ -1,283 +0,0 @@ - - - - - - list - Tesseras User Guide - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-

Keyboard shortcuts

-
-

Press ← or → to navigate between chapters

-

Press S or / to search in the book

-

Press ? to show this help

-

Press Esc to hide this help

-
-
-
-
- - - - - - - - - - - - - -
- -
-
- - - - - - - -
-
-

tes list

-

List all local tesseras.

-

Usage

-
tes list
-
-

Options

-
- - - - - - - -
OptionDescription
--data-dir <PATH>Base directory for data storage (default: ~/.tesseras)
-
-

Output

-

Displays a table with the following columns:

-
- - - - - - - - - - - -
ColumnDescription
HashFirst 16 characters of the content hash
CreatedCreation date (YYYY-MM-DD)
MemoriesNumber of memories in the tessera
SizeTotal size (B, KB, MB, or GB)
VisibilityVisibility level (public, private, or circle)
-
-

Example

-
tes list
-
-
Hash             Created     Memories  Size    Visibility
-9f2c4a1b3e7d8f0c 2026-02-14         3  284 KB  public
-a3b7c2d9e4f01823 2026-02-10         1   12 KB  private
-f8e7d6c5b4a39201 2026-01-28        12    4 MB  public
-
-

Empty database

-

If no tesseras have been created yet:

-
tes list
-
-
No tesseras found.
-
- -
- - -
-
- - - -
- - - - - - - - - - - - - - - - - - - - - - - - -
- - diff --git a/book/en/commands/list.html.gz b/book/en/commands/list.html.gz deleted file mode 100644 index 82e48b1..0000000 Binary files a/book/en/commands/list.html.gz and /dev/null differ diff --git a/book/en/commands/verify.html b/book/en/commands/verify.html deleted file mode 100644 index d28d57c..0000000 --- a/book/en/commands/verify.html +++ /dev/null @@ -1,307 +0,0 @@ - - - - - - verify - Tesseras User Guide - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-

Keyboard shortcuts

-
-

Press ← or → to navigate between chapters

-

Press S or / to search in the book

-

Press ? to show this help

-

Press Esc to hide this help

-
-
-
-
- - - - - - - - - - - - - -
- -
-
- - - - - - - -
-
-

tes verify

-

Verify integrity of a stored tessera.

-

Usage

-
tes verify <HASH>
-
-

Arguments

-
- - - - - - - -
ArgumentDescription
<HASH>Tessera content hash (64 hex characters)
-
-

Options

-
- - - - - - - -
OptionDescription
--data-dir <PATH>Base directory for data storage (default: ~/.tesseras)
-
-

What it checks

-
    -
  1. Signature validity — verifies the Ed25519 signature over the MANIFEST
    2. -
  2. File integrity — recomputes the BLAKE3 hash of every file and compares it against the MANIFEST
    3. -
-

Exit codes

-
- - - - - - - - -
CodeMeaning
0Verification passed — all files intact, signature valid
1Verification failed — corrupted files or invalid signature
-
-

Examples

-

Successful verification

-
tes verify 9f2c4a1b3e7d8f0cabc123def456789012345678abcdef0123456789abcdef01
-
-
Tessera: 9f2c4a1b3e7d8f0cabc123def456789012345678abcdef0123456789abcdef01
-Signature: VALID
-  [OK] memories/a1b2c3d4/media.jpg
-  [OK] memories/e5f6a7b8/media.txt
-  [OK] memories/c9d0e1f2/media.wav
-Verification: PASSED
-
-

Failed verification

-

If a file has been modified or corrupted:

-
Tessera: 9f2c4a1b3e7d8f0cabc123def456789012345678abcdef0123456789abcdef01
-Signature: VALID
-  [OK] memories/a1b2c3d4/media.jpg
-  [FAILED] memories/e5f6a7b8/media.txt
-  [OK] memories/c9d0e1f2/media.wav
-Verification: FAILED
-
-

Use cases

-
    -
  • Routine integrity checks — periodically verify that your stored tesseras haven’t been corrupted
    • -
  • After transfer — verify after copying tesseras to a new device or storage medium
    • -
  • Trust verification — confirm that a tessera received from someone else hasn’t been tampered with
    • -
- -
- - -
-
- - - -
- - - - - - - - - - - - - - - - - - - - - - - - -
- - diff --git a/book/en/commands/verify.html.gz b/book/en/commands/verify.html.gz deleted file mode 100644 index 301946c..0000000 Binary files a/book/en/commands/verify.html.gz and /dev/null differ -- cgit v1.2.3