Add Saving, History and Version Control

Miguel Jacq 2025-12-12 17:52:57 -06:00
parent 2bef3054a3
commit 574323b0c2

@ -0,0 +1,27 @@
## Saving, History and version control
### History and version control
Bouquin supports versioning. Every time you save a page/date, it stores a new version of that page. The previous version remains in the database.
You can click on 'View History' from the toolbar, or via the **File -> History** navigation, or via `Ctrl+Shift+H`, to open the History dialog.
This will display a list of versions for the page, with the version number, timestamp and a 'note' about the change.
On the right will be a preview pane that shows that version of the page.
There is also a 'Diff' tab which will show all the differences between the current version and the version you have selected in the left pane.
You can click on 'Revert to Selected' to revert to an older or newer version of the page.
Reverting is a bit like git: it simply moves a 'pointer' to point at the relevant version, without overwriting your current version. **Your current version will still be in the database**, so you can always revert 'back to the future' if you change your mind :)
If you wish, you can also select one or more revisions and click Delete to delete them (you cannot delete the latest revision).
### Autosave vs explicit save
Every 5 seconds or so, Bouquin will autosave the page if there were any unsaved changes. This will be given the note 'autosave' in the version history.
If you explicitly press `Ctrl+S` or via the **File -> Save** navigation, you will be prompted to optionally set a version note. You can either accept the default which has a reasonably meaningful message, or give it a meaningful note of your own.