1.1.1 ā¢ Published 2 years ago
pageterm v1.1.1
PageTerm displays file content in a terminal
Installation
npm install pageterm -g
Demo
Usage
CLI
$> pageterm [options] <filepath>
--
Programmatically CommonJs
const {showHelp} = require("pageterm");
--
Programmatically ESM
import {showHelp} from "pageterm";
Examples
const displayHelpFile = async function ()
{
const content = fs.readFileSync("./my-help-file", "utf-8");
await showHelp(content, {
windowTitle: "My Application Name - Help ā",
topText: "Press CTRL + C or Q to Quit | Page Down or Any key to scroll down",
topTextBg: "",
topTextReversed: true,
colorify: true
});
};
filepath File path to content to show
Arguments
$> pageterm <filepath>
filepath File path to content to show
Options:
Options | Description | Default |
---|---|---|
-v, --version | output the current version | |
-m, --markdown | Display file content with partial Markdown support | true |
-c, --colorify | Display file content with colors | false |
-c, --colorify | Display file content with colors | false |
-p, --progress | Show progress bar | true |
-s, --smooth | Enable smooth scrolling | true |
-s, --latencyScroll | Smooth scrolling latency | 10 |
-t, --windowTitle | Set text in Terminal title bar | |
--topText | Change the top menu text | |
-h, --help | display help for command |
Package
š package
ā
āāāāš cjs
ā ā š index.cjs ā½ CJS version - Node (9.6kB unminified)
āāāāš dist
ā ā š index.mjs ā½ ESM version - Node (9.7kB unminified)
Changelog
current:
- Display entire help without interruption when TTY is not available
1.1.0:
- Display help with PageTerm
- Update code for the ESM file
1.0.5:
- Restore the initial color on quitting
- Display content left on quitting
- Fix lines wrapped incorrectly
1.0.4:
- Don't display the top text when the console display is wide enough.