https://github.com/purcell/page-break-lines
Emacs: display ugly ^L page breaks as tidy horizontal lines
https://github.com/purcell/page-break-lines
Last synced: 24 days ago
JSON representation
Emacs: display ugly ^L page breaks as tidy horizontal lines
- Host: GitHub
- URL: https://github.com/purcell/page-break-lines
- Owner: purcell
- Created: 2012-11-13T11:32:44.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2025-02-18T16:07:28.000Z (2 months ago)
- Last Synced: 2025-04-09T23:14:08.804Z (24 days ago)
- Language: Emacs Lisp
- Size: 147 KB
- Stars: 234
- Watchers: 9
- Forks: 32
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
[](https://melpa.org/#/page-break-lines)
[](https://stable.melpa.org/#/page-break-lines)
[](https://github.com/purcell/page-break-lines/actions/workflows/test.yml)
page-break-lines.el
===================
This Emacs library provides a global mode which displays ugly form feed
characters as tidy horizontal rules.
Screenshot
==========
Installation
=============
If you choose not to use one of the convenient
packages in [MELPA](https://melpa.org), you'll need to
add the directory containing `page-break-lines.el` to your `load-path`, and
then `(require 'page-break-lines)`.
Usage
=====
Enable `page-break-lines-mode` in an individual buffer like this:
```elisp
(page-break-lines-mode)
```
Alternatively, customize `page-break-lines-modes` and enable the mode globally with
`global-page-break-lines-mode`.
Note that Emacs already supports [“Pages”](https://www.gnu.org/software/emacs/manual/html_node/emacs/Pages.html)
and jumping around between page breaks with `C-x [` (`backward-page`)
and `C-x ]` (`forward-page`).
Issues and limitations
======================
If `page-break-lines-char` is displayed at a different width to
regular characters, the rule may be either too short or too long:
rules may then wrap if `truncate-lines` is nil. On some systems,
Emacs may erroneously choose a different font for the page break
symbol, which choice can be overridden using code such as:
```elisp
(set-fontset-font "fontset-default"
(cons page-break-lines-char page-break-lines-char)
(face-attribute 'default :family))
```
Use `describe-char` on a page break char to determine whether this
is the case.
Also see Vasilij Schneidermann's
[form-feed package](https://github.com/wasamasa/form-feed), which
works using font-lock instead of glyph composition, and therefore has
different display trade-offs.
[💝 Support this project and my other Open Source work](https://www.patreon.com/sanityinc)
[💼 LinkedIn profile](https://uk.linkedin.com/in/stevepurcell)
[✍ sanityinc.com](http://www.sanityinc.com/)