This page describes how to upload a file to the wiki using Gemini and Titan. All uploads require a “token”. Currently, the token is “hello”. It might change in the future.

If you're a developer and would like to learn more about the Titan protocol used to edit pages on this wiki, there's more information on the Titan page.

Titan

Using Lagrange

How does it work on this wiki?

• Visit a page (possibly clicking on “New page” and providing a name like "my_picture.jpg")
• Click “Upload Page with Titan” in the context menu
• Switch to the “File” tab
• Drag and drop a file into the form
• Verify that the file size is 100’000 bytes or less (see suggestions below)
• Type upload token
• Click “Upload” button

To add this file in a page

• Visit a page (possibly clicking on “New page” and providing a name)
• Click “Upload Page with Titan” in the context menu
• add a link "=> ../file/my_picture.jpg This is my picture" somewhere in the page
• Type upload token
• Click “Upload” button

Note that providing an extension is optional. Some clients (such as Lagrange) determine the inlining of images based on their file extension instead of on their MIME type, however.

Get Lagrange from skyjake's page:

Lagrange

WebDAV

If you have access to a command line client like cadaver, connect to “https://transjovian.org:1965/test”. You will be asked for credentials if you try to make changes in the “/raw” or “/file” folders. Provide any username you want (it is ignored) and the token “hello” as the password.

If you are using Gnome Files, your first URL must already authenticate you. Use “davs://transjovian.org:1965/test/login”. Provide any username you want (it is ignored) and the token “hello” as the password.

Every wiki space comes with the same folders:

• /login is empty – use it if you need an authenticated connection to the server
• /page is a read-only copy of the generated HTML for each page
• /raw is an editable copy of every page (this is also where to create new pages)
• /file is an editable copy of ever file (and this is also where to upload new files)

At the top level, you also have a link to all the wiki spaces.

Perl

Get the titan (upload) script from the Phoebe repository and install them in your PATH somewhere, such as ~/.local/bin. It is written using Perl 5.

titan

App::phoebe on CPAN

Upload a file:

titan titan://transjovian.org/test/raw/ --token=hello profile.png

Remember the size and MIME type constraints!

OpenSSL

Upload a file. Note that now we need to specify the name on the server using the URL (“Station”).

echo -en "titan://transjovian.org/test/raw/Station;mime=image/png;size="`wc --bytes < station.png`";token=hello\r\n"
  | cat - station.png
  | openssl s_client --quiet --connect transjovian.org:1965 2>/dev/null

In short, the URL must contain three parameters, and it must must end in the name of the resource.

• “mime” is the MIME type; use text/plain for now
• “size” is the size in bytes; use wc --bytes to do that
• “token” is one the of access tokens or passwords for the wiki

File Size

Images

If you’re uploading images, here are ways to reduce their size.

Resize them. Using ImageMagick: “convert -resize 50% …” There are many web pages out there telling you how to resize files effectively.

Strip metadata. Using ImageMagick: “convert -strip …”

Or optimize JPG files using “jpegoptim”. Optimize PNG files using “pngcrush”.

Reduce the quality of JPG file. Using ImageMagick: “convert -quality 60% …”

Efficient Image Resizing With ImageMagick, by Dave Newton, for Smashing Magazine

Audio Files

If you’re uploading MP3 files, here are ways to reduce their size.

Use a preset. Using Lame: “lame --preset medium” or “lame --preset voice” where appropriate.

Use lower quality. Using Lame: “lame -q 7 …”

MIME Types

This particular wiki only allows the upload of these three file types:

PNG files (“image/png”).

JPG files (“image/jpeg”).

MP3 files (“audio/mpeg”).