150 lines
3.9 KiB
ReStructuredText
150 lines
3.9 KiB
ReStructuredText
.. _primitivus-documentation:
|
||
|
||
==========
|
||
Primitivus
|
||
==========
|
||
|
||
``Primitivus`` is the TUI (Terminal User Interface) frontend of Salut à Toi
|
||
|
||
Overview
|
||
========
|
||
|
||
``Primitivus`` is a text based frontend. It is specially adapted for systems without
|
||
graphical environments (e.g. servers), for low bandwidth remote shells (e.g. ssh) or for
|
||
people who like straightforward interfaces without distracting images or animations.
|
||
|
||
For the moment, Primitivus implements one 2 one chat, group chat (also called *MUC* for
|
||
Multi-Users Chat), and some related features (end 2 end encryption, bookmarks, gateways
|
||
interaction, file sending, etc.).
|
||
|
||
Usage
|
||
=====
|
||
|
||
Primitivus is modal (vi-like), one can switch from one mode to another
|
||
in the same way as in vi/vim:
|
||
|
||
- From any mode, press ``[Esc]`` to switch to normal mode.
|
||
- From normal mode, press ``:`` to switch to command mode.
|
||
- From normal mode, press ``i`` to switch to insert mode – the one you
|
||
use to write messages to your contacts.
|
||
|
||
Primitivus can be handled either with the mouse, in a very intuitive way, or with the
|
||
keyboard. Below, the keyboard shortcuts are explained.
|
||
|
||
Keyboard handling
|
||
-----------------
|
||
|
||
- ``C`` stands for ``Ctrl``
|
||
- ``M`` means *Meta*, on a PC it is usually the ``Alt`` key
|
||
- ``S`` stands for ``Shift``
|
||
|
||
Main keys
|
||
~~~~~~~~~
|
||
|
||
``[tab]`` and/or ``C-up/down arrows``
|
||
change focus
|
||
``C-x``
|
||
quit Primitivus
|
||
``C-f 1`` or ``C-f m``
|
||
focus on the menu
|
||
``C-f 2`` or ``C-f b``
|
||
focus on the roster or the chat window
|
||
``C-f 3`` or ``C-f e``
|
||
focus on the edition line
|
||
``M-m``
|
||
display/hide the menu
|
||
``C-n``
|
||
show the next notification
|
||
``C-s``
|
||
hide/redisplay a pop-up window temporarily
|
||
``C-d``
|
||
enter debug mode (development versions only)
|
||
``F2``
|
||
hide/display the roster
|
||
``C-l``
|
||
refresh the screen
|
||
|
||
Chat rooms
|
||
~~~~~~~~~~
|
||
|
||
To use those keyboard shortcuts, your cursor must be in a chat room.
|
||
|
||
``M-j``
|
||
join a chat room
|
||
``M-p``
|
||
hide/display the list of participants
|
||
``M-t``
|
||
hide/display timestamps
|
||
``M-n``
|
||
use/don't use short nicks
|
||
``M-l``
|
||
hide/display frame decorations
|
||
``M-s``
|
||
change the room's topic appearance by switching between:
|
||
- one single line (the topic is cut if it's too long)
|
||
- the full topic
|
||
- topic hidden
|
||
``G``
|
||
go to the end (bottom) of your history (note that this is UPPERCASE ``G``)
|
||
|
||
|
||
Edition line
|
||
~~~~~~~~~~~~
|
||
|
||
``C-a`` or ``[home]``
|
||
move the cursor at the beginning of the line
|
||
``C-e`` or ``[end]``
|
||
move the cursor at the end of the line
|
||
``C-k``
|
||
erase the line, starting at the cursor's position
|
||
``C-w``
|
||
erase the last word
|
||
``S-[tab]``
|
||
invoke completion (dependent on the context)
|
||
``up/down arrows``
|
||
browse sent messages history
|
||
|
||
Contacts
|
||
~~~~~~~~
|
||
|
||
``M-d``
|
||
hide/display offline contacts
|
||
``M-s``
|
||
hide/display contacts' status messages
|
||
|
||
Card game
|
||
~~~~~~~~~
|
||
|
||
``space``
|
||
select a card
|
||
|
||
Commands
|
||
~~~~~~~~
|
||
|
||
The following commands must be typed in command mode (type ``[Esc]`` to switch to normal
|
||
mode, then the ``:`` at the beginning of the command will switch to command mode).
|
||
|
||
``:quit``
|
||
quit Primitivus
|
||
``:messages``
|
||
display log messages (see also the logging configuration)
|
||
|
||
..
|
||
FIXME: :presence and :status are currently disabled in Primitivus
|
||
``:presence [status]``
|
||
set your presence status. Invoked without argument, a pop-up will allow you to choose your presence status; otherwise, you can use the following arguments:
|
||
- ``online``
|
||
- ``chat`` (free to chat)
|
||
- ``away`` (away from keyboard)
|
||
- ``dnd`` (do not disturb)
|
||
- ``xa`` (extended away)
|
||
``:status [message]``
|
||
set your status message. Invoked without argument, a pop-up will allow you to enter a message.
|
||
|
||
``:history <size>``
|
||
set the number of lines of history to display in the chat window (``:history 0`` to clear the window)
|
||
``:search <filter>``
|
||
do a full text search in this conversation/room. The room will be cleared an only
|
||
messages corresponding to ``<filter>`` will be show. Use ``:history <size>`` to
|
||
restore normal history
|
||
|