From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: "Paul W. Rankin via Emacs-humanities" Newsgroups: gmane.emacs.humanities,gmane.emacs.help Subject: New Maintainer callout: Binder Date: Wed, 11 Sep 2024 15:07:17 +1000 Message-ID: Reply-To: "Paul W. Rankin" Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3776.700.51\)) Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="29112"; mail-complaints-to="usenet@ciao.gmane.io" To: help-gnu-emacs@gnu.org, emacs-humanities@gnu.org Original-X-From: emacs-humanities-bounces+geh-emacs-humanities=m.gmane-mx.org@gnu.org Wed Sep 11 13:06:27 2024 Return-path: Envelope-to: geh-emacs-humanities@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1soLB5-0007OK-4H for geh-emacs-humanities@m.gmane-mx.org; Wed, 11 Sep 2024 13:06:27 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1soLAt-000313-MP; Wed, 11 Sep 2024 07:06:15 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1soFaM-0007Bo-25 for emacs-humanities@gnu.org; Wed, 11 Sep 2024 01:08:10 -0400 Original-Received: from mr85p00im-hyfv06021301.me.com ([17.58.23.188]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1soFaH-0002XK-Oa for emacs-humanities@gnu.org; Wed, 11 Sep 2024 01:08:09 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=rnkn.xyz; s=sig1; t=1726031271; bh=igozMFjK7e9g9v3Lj9cL8ZIt/MRRGImU+DKJq0TNUi4=; h=From:Content-Type:Mime-Version:Subject:Message-Id:Date:To; b=WxjoAk+zJbmXiSoqa7gssvRN1g6pnv8z4Gc/Mvs89Y9WezzqWFxQtJa+HbsRXcFMz dUp8W6tmebkt3obZ8T1U2Zg/m6wHL/1oMeeEm2nSLK6p+O/vGZYyyAuLw8By5TRZ5C CFYfJFVN+tY2vMBIHa0uxRq60/yySkmb9DFun0arNk4AIBWhjfCoW6DRkW9RPDT/RL JPF4WNiSz/PMbkMmRhcf8HF+RE/pbWFknY3vUPb5Z6LXUQcUosUXmwFLDtHlHPYtaS u4YPZlcqlzOcf/Xy/FZNFswsGT5RN7oewKyLGZlu1etlPl58SghjzUsn40LmK35MPN ngn3yTVT4vwvw== Original-Received: from smtpclient.apple (mr38p00im-dlb-asmtp-mailmevip.me.com [17.57.152.18]) by mr85p00im-hyfv06021301.me.com (Postfix) with ESMTPSA id B66DE2150D98; Wed, 11 Sep 2024 05:07:50 +0000 (UTC) X-Mailer: Apple Mail (2.3776.700.51) X-Proofpoint-ORIG-GUID: FUNqdszrDIEv0ECAsW6aSqEY_vhCF4Db X-Proofpoint-GUID: FUNqdszrDIEv0ECAsW6aSqEY_vhCF4Db X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.272,Aquarius:18.0.1039,Hydra:6.0.680,FMLib:17.12.60.29 definitions=2024-09-10_12,2024-09-09_02,2024-09-02_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 mlxscore=0 suspectscore=0 spamscore=0 clxscore=1030 mlxlogscore=999 bulkscore=0 malwarescore=0 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.19.0-2308100000 definitions=main-2409110037 Received-SPF: pass client-ip=17.58.23.188; envelope-from=rnkn@rnkn.xyz; helo=mr85p00im-hyfv06021301.me.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=unavailable autolearn_force=no X-Spam_action: no action X-Mailman-Approved-At: Wed, 11 Sep 2024 07:06:14 -0400 X-BeenThere: emacs-humanities@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Discussions about using Emacs in the Humanities and related fields List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-humanities-bounces+geh-emacs-humanities=m.gmane-mx.org@gnu.org Original-Sender: emacs-humanities-bounces+geh-emacs-humanities=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.humanities:368 gmane.emacs.help:147952 Archived-At: Hi folks, Would anyone like to take over maintaining Binder? I created it a while=20= back but have not used it in years. I still believe it=E2=80=99s a = worthwhile=20 project, but I can=E2=80=99t foresee me furthering its development. = Thanks :) https://github.com/rnkn/binder MELPA downloads: 1,449 (all versions), percentile: 39.93 README: Binder =3D=3D=3D=3D=3D=3D Binder is global minor mode to facilitate working on a writing project in multiple files. It is heavily inspired by the binder feature in the [macOS writing app Scrivener][3]. The rationale behind working this way is to split a large writing project into smaller pieces. Features -------- Primarily, Binder provides a global minor mode `binder-mode`. This allows working with files in the current `binder-project-directory`. Data concerning these files is saved in a `.binder.el` file in the project directory. A project can be thought of an ordered list of files with associated notes and tags. Navigation ---------- At the most basic level, you can navigate back and forth through the files in a project: - `binder-next (C-c ])` visits the next file in the project - `binder-previous (C-c [)` visits the previous Calling these commands activates a transient map so that each command can be repeated without the prefix key. Sidebar ------- You'll mostly interact with the project structure via the sidebar. - `binder-toggle-sidebar (C-c ')` toggles the visibility of the binder sidebar - `binder-reveal-in-sidebar (C-c ;)` finds the current file in the sidebar Each project item is a file reference relative to the project directory. Project items are displayed in a linear ordered list. Calling `binder-sidebar-find-file (RET)` or = `binder-sidebar-find-file-other-window (o)` will visit the corresponding file. Each item in the sidebar displays the following information: 1. `*` denotes that this item has some notes (see **Notes** below), or... 2. `?` denotes that the item's corresponding file cannot be found 3. either the file relative to the project directory, or an arbitrary display name 4. `#tag1 #tag2 ...` arbitrary item tags (see **Tags** below) An item's display name can be changed with `binder-sidebar-rename (r)`. If a file cannot be found, relocate with `binder-sidebar-relocate (R)`. Calling `binder-sidebar-find-file (RET)` will visit the corresponding file. To add an existing file, call `binder-sidebar-add-file (a)` or add all files in directory with `binder-sidebar-add-all-files (A)`. Add a new file with `binder-sidebar-new-file (M-RET)`. This prompts for = a file-name and adds this (possibly non-existent) file to the project after the current file's index. If no file-name extension is provided, use `binder-default-file-extension`. > Hint: you can use an alternate default file extension for different > projects by setting a directory local variable. Files can also be added to a project from outside the sidebar with `binder-add-file (C-c :)`. Items can be reordered with `binder-sidebar-shift-up (M-p | M-up)` and `binder-sidebar-shift-down (M-n | M-down)`. Remove items with `binder-sidebar-remove (d)` -- this *does not delete the files*, only removes them from the project, but it *does* delete the corresponding notes and tags. Hide item file extensions by setting the = `binder-sidebar-hide-file-extensions` option. This can be toggled with `binder-sidebar-toggle-file-extensions = (E)`. The sidebar can be resized with `binder-sidebar-shrink-window ({)` and `binder-sidebar-enlarge-window (})`. The window size is changed by the number of columns specified in option = `binder-sidebar-resize-window-step`. You can customize how the sidebar window is displayed by setting `binder-sidebar-display-alist` option. Notes ----- To open the notes buffer from the sidebar, call either `binder-sidebar-open-notes (z)` to open and select the notes window, or `binder-sidebar-toggle-notes (i)` to toggle the window. To open a project file's notes from outside the sidebar, call `binder-toggle-notes (C-c ")`. You need to call either `binder-notes-save (C-x C-s)` or `binder-notes-save-and-quit-window (C-c C-c)` to save notes to the project file. Calling `quit-window (C-c C-q | C-c C-k)` or `binder-toggle-sidebar` does not save notes. You can embiggen the notes window, to pop it out from the sidebar and edit like a regular buffer window, with `binder-notes-expand-window (C-c C-l)`. You can customize how the notes window is displayed by setting `binder-notes-display-alist` option. Tags ---- Tags can help organize a project. An item can have any number of tags. Add a tag to an item with `binder-sidebar-add-tag (t)`. Remove a tag from an item with `binder-sidebar-remove-tag (T)`. You can tag/untag multiple items at once by using marks (see **Marking** below). Items in the sidebar can be narrowed to only show items with a certain tag with `binder-sidebar-narrow-by-tag (/)` and/or only show items without a certain tag with `binder-sidebar-exclude-by-tag (\)`. Each of these commands can be called multiple times with additional tags. Clear the sidebar filters with `binder-sidebar-clear-filters (|)`. Marking ------- Multiple items can be marked to add tags, toggle include state or delete. Call `binder-sidebar-mark (m)` to mark an item or `binder-sidebar-unmark (u)` to unmark an item. To unmark all sidebar items, call `binder-sidebar-unmark-all (U)`. Requirements ------------ - Emacs 24.4 - seq 2.20 (part of Emacs 25 and later) -- Paul W. Rankin https://rnkn.xyz