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/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/next-entry	SPC mj	Move the cursor to and put forward the next entry.
bibli-paris/previous-entry	SPC mk	Move the cursor to and put forward the previous entry.
bibli-paris/sort	SPC ms	Sort the entries by their quotes.
bibli-paris/set-to-todo	SPC mtt	Switch the entry at point to the TODO state.
bibli-paris/set-to-next	SPC mtn	Switch the entry at point to the NEXT state.
bibli-paris/set-to-booked	SPC mtb	Switch the entry at point to the BOOKED state.
bibli-paris/set-to-done	SPC mtd	Switch the entry at point to the DONE state.
bibli-paris/update-buffer	SPC mub	Asynchronously update the availability status and quotes of the entries in the current buffer, and sort it afterwards.
bibli-paris/update-entry	SPC mue	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/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.

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.