blob: 9fc9dd2f0f42833e09a20c6d932e887b129032ee (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
|
* Introduction
~bibli-paris~ is a Spacemacs layer that adds functionnalities to ~org-mode~ so
as to enable the management of reading lists of documents from Paris' network of
libraries.
* Setup
** Enabling the layer
Clone this repository in your ~.emacs.d/private/layers~ folder and enable the
layer in your ~.spacemacs~ file.
** Creating a reading list file
First, go to https://bibliotheques.paris.fr/ and look up documents you're
interested in. Select them and export your selection as a CSV file ~Export.csv~.
Next, create your reading list file =my_reading_list.org= and open it in Emacs.
Finally, call the =bibli-paris/import-from-csv= function with argument the path
to =Export.csv=.
** Using with Orgzly
To use the Orgzly mobile app with a reading list, the following searches may be useful.
| Name | Query |
|--------------------------------+---------------------------------------------------------------------------|
| To borrow | =b.my_reading_list .i.DONE s.None .o.st= |
| To book | =b.my_reading_list (i.TODO OR i.NEXT) s.ge.-100y .o.st= |
| To book at the central reserve | =b.my_reading_list (i.TODO OR i.NONE) t.RéserveCentrale s.ge.-100y .o.st= |
| Booked | =b.my_reading_list i.BOOKED .o.st= |
* Commands
The following commands are available.
| Command | Shortcut | Description |
|---------------------------------+-----------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| =bibli-paris/mode= | =SPC mb= | Enable the shortcuts described in this table. |
| =bibli-paris/import-from-csv= | =SPC mi= | Import entries from the CSV file downloaded on https://bibliotheques.paris.fr/. The first argument is the path to the CSV file, and the second and third (optional) arguments are the tags and state to set the imported entries to. |
| =bibli-paris/sort= | =SPC ms= | Sort the entries by their quotes. |
| =bibli-paris/update-entry= | =SPC mu= | Asynchronously update the availability status and quote of the entry at point. |
| =bibli-paris/update-region= | =SPC mur= | Asynchronously update the availability status and quotes of the entries in the current region. |
| =bibli-paris/update-buffer= | =SPC mub= | Asynchronously update the availability status and quotes of the entries in the current buffer. |
| =bibli-paris/archive-all-read= | =SPC mA= | Archive all entries in the =DONE= state. |
| =bibli-paris/number-of-entries= | =SPC m?= | Display the number of entries in the current buffer. |
| =bibli-paris/previous-entry= | =SPC mk= | Move the cursor to and put forward the previous entry. |
| =bibli-paris/next-entry= | =SPC mj= | Move the cursor to and put forward the next entry. |
* Customization
The following variables may be customized.
| Variable name | Type | Default value | Description |
|------------------------------------------+---------+--------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| =bibli-paris/default-library= | string | =75013 - Jean-Pierre Melville= | The library from which to fetch updates. |
| =bibli-paris/max-asynchronous-processes= | integer | =500= | The maximum number of asynchronous requests that should be launched in parallel. The default value was determined experimentally to be the maximum allowed by Emacs. |
| =bibli-paris/default-path-to-csv= | string | =~/Downloads/Export.csv= | The default path of a CSV file to import. |
|
