diff options
author | Thanos Apollo <[email protected]> | 2024-10-06 08:35:08 +0300 |
---|---|---|
committer | Thanos Apollo <[email protected]> | 2024-10-06 08:36:24 +0300 |
commit | 4f437a3b23090d2591eb36a26c146ff3595a6256 (patch) | |
tree | 417e875c5e38e3dec5b039e5b28525884e96e40b /doc/gnosis.texi | |
parent | ab33f0564fb0fe189664e4fafc869975f9a65941 (diff) | |
parent | fd1315830e3aedf5d7cedc8410ec4f4bc2b781f0 (diff) |
Release version 0.4.4.0.4.4
* Add clear-history functions
* Refactor review actions to use read-char-choice. This now allows
for users to switch buffers during review sessions.
Diffstat (limited to 'doc/gnosis.texi')
-rw-r--r-- | doc/gnosis.texi | 94 |
1 files changed, 62 insertions, 32 deletions
diff --git a/doc/gnosis.texi b/doc/gnosis.texi index e5cc81f..4816566 100644 --- a/doc/gnosis.texi +++ b/doc/gnosis.texi @@ -35,16 +35,22 @@ This manual is written for Gnosis version 0.4.2, released on 2024-09-5. @itemize @item -Official manual: +Manual: @itemize @item @uref{https://elpa.nongnu.org/nongnu/doc/gnosis.html} +@item +@uref{https://thanosapollo.org/projects/gnosis/} (Mirror) @end itemize @item Git repositories: @itemize @item @uref{https://git.thanosapollo.org/gnosis} +@item +@uref{https://codeberg.org/thanosapollo/emacs-gnosis} (Mirror) +@item +@uref{https://git.savannah.gnu.org/cgit/emacs/nongnu.git/?h=elpa/gnosis} (Mirror) @end itemize @end itemize @@ -59,8 +65,9 @@ Git repositories: * Customization:: * Gnosis Algorithm:: * Editing notes:: -* Sync between devices:: * Configuring Note Types:: +* Sync between devices:: +* Interactions with other software:: @detailmenu --- The Detailed Node Listing --- @@ -89,6 +96,10 @@ Configuring Note Types * Custom Note Types:: * Development:: +Interactions with other software + +* emacs-no-littering:: + @end detailmenu @end menu @@ -350,36 +361,6 @@ Open @samp{gnosis-dashboard} with @samp{M-x gnosis-dashboard}, find the note you @end itemize @end itemize -@node Sync between devices -@chapter Sync between devices - -Gnosis uses git to maintain data integrity and facilitate -synchronization across devices. - -You will need to configure your remote manually. - -Example: - -@example -cd ~/.emacs.d/gnosis # default location for gnosis -git init # After completing your first review session, a git repo should have been initialized automatically. -git remote add origin <remote_url> -git push --set-upstream origin master -@end example - - -You can interactively use @samp{gnosis-vc-push} & @samp{gnosis-vc-pull}. As the -name suggests, they rely on @samp{vc} to work properly. - -Depending on your setup, @samp{vc} might require an external package for -the ssh passphrase dialog, such as @code{x11-ssh-askpass}. - -To automatically push changes after a review session, add this to your configuration: -@lisp -(setf gnosis-vc-auto-push t) -(gnosis-vc-pull) ;; Run vc-pull for gnosis on startup -@end lisp - @node Configuring Note Types @chapter Configuring Note Types @@ -425,4 +406,53 @@ testing. To exit the testing environment, rerun @samp{M-x gnosis-test-start} and then enter @samp{n} (no) at the prompt ``Start development env?'' +@node Sync between devices +@chapter Sync between devices + +Gnosis uses git to maintain data integrity and facilitate +synchronization across devices. + +You will need to configure your remote manually. + +Example: + +@example +cd ~/.emacs.d/gnosis # default location for gnosis, no-littering is ~/.emacs.d/var/gnosis +git init # After completing your first review session, a git repo should have been initialized automatically. +git remote add origin <remote_url> +git push --set-upstream origin master +@end example + + +You can interactively use @samp{gnosis-vc-push} & @samp{gnosis-vc-pull}. As the +name suggests, they rely on @samp{vc} to work properly. + +Depending on your setup, @samp{vc} might require an external package for +the ssh passphrase dialog, such as @code{x11-ssh-askpass}. + +To automatically push changes after a review session, add this to your configuration: +@lisp +(setf gnosis-vc-auto-push t) +(gnosis-vc-pull) ;; Run vc-pull for gnosis on startup +@end lisp + +@node Interactions with other software +@chapter Interactions with other software + +@menu +* emacs-no-littering:: +@end menu + +@node emacs-no-littering +@section emacs-no-littering + +If you are a user of @uref{https://github.com/emacscollective/no-littering, emacs-no-littering}, you can theme Gnosis to fit +its standards by adding the following snippet to your configuration: + +@lisp +(setq gnosis-dir (no-littering-expand-var-file-name "gnosis/")) +@end lisp + +This sets @samp{gnosis-dir} to @samp{~/.emacs.d/var/gnosis}, in line with the folders of other packages. + @bye |