Skip to content

Latest commit

 

History

History
138 lines (112 loc) · 8.87 KB

features.md

File metadata and controls

138 lines (112 loc) · 8.87 KB

Features in pictures

Screenshots of Truce's main screens and of each new feature, newest first. They show sample documents only.

Home, cards and wide windows

Home now has two parts: Pinned (every pinned file) and Recently edited. Settings sets how many recently edited files show and, if you like, how old they can be. A Clear chip drops all picks in its row. A card's title starts with its type's icon; a long place is cut in the middle, so the folder and the last subfolder stay readable, and the whole place shows when you hover over it. Long press a card, or right click it with a mouse, to open, pin or color it. Settings and forms stay in one readable column on wide windows, and Esc closes any page or form.

Home: Pinned on top, then Recently edited, each card's title starting with its type icon

A right click on a card: Open, Pin, Color with its colors, and where the other actions are

A long press on a card on a phone: its title and place, Open, Pin, colors

Settings on a wide window, in one centered column

Filters, folder order and type icons

Pick as many folder and type chips as you like; tap one again to drop it, or Clear to drop them all. Each file shows its type's icon. In Manage folders, drag a folder by its handle to change its place; the chips and All files follow that order.

Home showing only Markdown files, its chip picked, a Clear chip before it

Manage folders: each folder with a drag handle

Adding folders

Add folder first asks how the folder is synced: by Syncthing, or not at all (a local folder). For Syncthing, pick any folder inside a Syncthing folder: the app finds the Syncthing folder and shows its folders, to tick each one to add. Each ticked one becomes a folder of its own, with a name and a color.

Add folder: Syncthing or Local folder

The folders of a Syncthing folder, two of them ticked

A new folder's name and color

Calendars

Calendars are .ics files, the format other calendar apps use. New file offers a calendar or a health calendar; it opens at once, and its name is typed right in its title, now or any time later. A calendar's card shows its next events. Its page shows a month, a week, a day or a schedule, the one you picked last. Tap a free time to add an event there, a day in the month for an all-day event, or drag over a few hours; + adds one too. Drag an event to move it, or its edge to make it longer (for an event that repeats, that moves just this one). Tap an event to edit or delete it, just this time or every time. An event can have its own color; otherwise it shows in its calendar's color (the file's color, else its folder's). Start and end can each have their own time zone, e.g. for a flight: tap the zone under a time to pick one. An event from another zone also shows its own times when you tap it. Import events in a calendar's menu brings in the events of another .ics file, e.g. an invite: new ones are added, ones the calendar has already take the file's version, and one Undo takes it all back. A health calendar shows in the same views: + lists its kinds of entry (medication, symptom, measure, note, period), each with its own form and color. Once a period is written, the month shades period days and fertile days, shades the likely next period lighter with faint stripes, and the line below tells the day of the cycle. Today always has a blue outline. With a mouse, Shift and the wheel page to the next or previous month, week or day. Once your folders hold a calendar, the Calendars tab shows the events of all of them in the same views. A chip turns a calendar's events on or off; a long press or right click on it hides the calendar from the tab, and Hidden brings it back. Tap an event there to see it and its calendar, then open the calendar or edit the event on its page. To add or change events, open one calendar with the calendar button; a tap on a free day in the tab reminds you. When two devices changed the same calendar, the compare view offers Merge both: events merge one by one, and where both changed the same event, the newer change is kept.

A calendar's page in the month view

The same calendar in the week view, events by hour

The schedule view on a phone: events listed by date

A health calendar on a phone: period days shaded, the likely next period lighter with faint stripes, today outlined, the cycle line below

The Calendars tab: two calendars as chips above one month, the open calendar button at the bottom

The calendar button on a phone: pick which calendar to open, each with its color

An event tapped in the Calendars tab: its calendar, its details and its own times in two zones, with Open calendar and Edit

The event form of a flight: start and end each with its own time zone

Home, All and search

Home shows your pinned files, then your recently edited documents from every folder. The view button at the top switches to All files: every document, newest first or by name (by name, under each subfolder), as cards or a list. When Recently edited hides some, Switch to all files below it does the same, and Back returns to Home. Search looks through every folder, by title, text, file and folder names.

The view menu: Home or All files, the order and cards or list

All documents by name, as cards under each subfolder

All documents by name, as a list

Search for lake finds two documents

Plain text files

Text files (.txt) show next to Markdown documents. A card shows the first line as the title and the next lines below it. A text file opens in the same page and is edited as written, with no styling: a # is just a character. Undo, backups, compare and conflict copies work as for Markdown.

A text file's card next to a Markdown document's card

A text file open, edited as written

Undo, redo and a document's backups

Undo and redo take back and redo your edits while a document is open, with the buttons at the top or Ctrl+Z and Ctrl+Y. When there is nothing more to undo, one more Undo says why and leads to the document's backups. The menu's Backups lists only this document's backups: open one to compare it, then restore it (Undo takes that back too) or delete it. Deleting a file keeps a backup of it too. Restore as new file, in each backup's menu, writes it as a new file where and under what name you pick, next to the file it came from.

The backups of one document, newest first

A note at the bottom: nothing more to undo since you opened the file, with a Backups button

Editing a document

The same document in each mode: Visual edit (lists, checkboxes, styles, with the format bar), Markdown edit (every character, highlighted once typing pauses) and Read, on the desktop and on a phone.

Visual edit on the desktop, with the format bar

Visual edit on a phone

Markdown edit, showing the Markdown marks

Read, the document rendered